Re: [U-Boot] [PATCH 5/5] doc: Add documentation for how to build U-Boot host tools
Hi Tom, On Thu, Oct 17, 2019 at 11:12 PM Tom Rini wrote: > > On Thu, Oct 17, 2019 at 11:02:47PM +0800, Bin Meng wrote: > > Hi Tom, > > > > On Thu, Oct 17, 2019 at 10:10 PM Tom Rini wrote: > > > > > > On Thu, Oct 17, 2019 at 09:50:57AM +0800, Bin Meng wrote: > > > > Hi Tom, > > > > > > > > On Thu, Oct 17, 2019 at 2:20 AM Tom Rini wrote: > > > > > > > > > > On Wed, Oct 16, 2019 at 09:27:25AM -0700, Bin Meng wrote: > > > > > > > > > > > This adds a reST document for how to build U-Boot host tools, > > > > > > including information for both Linux and Windows. > > > > > > > > > > > > Signed-off-by: Bin Meng > > > > > > > > > > So here's where I think things get interesting. Off the top of my > > > > > head, > > > > > I think we can use the free GitLab.com-provided hosts of which there > > > > > are > > > > > Windows-based ones (we would need to do some labeling of jobs so that > > > > > most things only run on our Linux hosts but one job runs on the > > > > > Windows > > > > > infra). I'm less sure we can do such a matrix with Travis. But is > > > > > there some way we could get this Windows tool build into CI and thus > > > > > keep it from breaking in the future? Thanks! > > > > > > > > Yes, I would like to have GitLab CI to do the Windows build for us. > > > > However I did not find the free GitLab.com-provided hosts. Any hints? > > > > > > Yeah, OK, I was wrong. You have to be on gitlab.com and they don't have > > > Windows. And I don't know enough Windows to figure out how to automate > > > going from a Microsoft-provided free VirtualBox image to having that > > > have GitLab Runner also installed. > > > > Ah that's bad we can't find a GitLab hosted free Windows VM. > > > > So I looked at Microsoft Azure pipeline and it looks we can set up a > > free account for U-Boot. > > See > > https://azure.microsoft.com/en-us/blog/announcing-azure-pipelines-with-unlimited-ci-cd-minutes-for-open-source/ > > That's interesting. Would you mind trying to get something going with > that? Maybe long term we can use that as an alternative to travis too. Sure, I will give a try. Regards, Bin ___ U-Boot mailing list U-Boot@lists.denx.de https://lists.denx.de/listinfo/u-boot
Re: [U-Boot] [PATCH 5/5] doc: Add documentation for how to build U-Boot host tools
On Thu, Oct 17, 2019 at 11:02:47PM +0800, Bin Meng wrote: > Hi Tom, > > On Thu, Oct 17, 2019 at 10:10 PM Tom Rini wrote: > > > > On Thu, Oct 17, 2019 at 09:50:57AM +0800, Bin Meng wrote: > > > Hi Tom, > > > > > > On Thu, Oct 17, 2019 at 2:20 AM Tom Rini wrote: > > > > > > > > On Wed, Oct 16, 2019 at 09:27:25AM -0700, Bin Meng wrote: > > > > > > > > > This adds a reST document for how to build U-Boot host tools, > > > > > including information for both Linux and Windows. > > > > > > > > > > Signed-off-by: Bin Meng > > > > > > > > So here's where I think things get interesting. Off the top of my head, > > > > I think we can use the free GitLab.com-provided hosts of which there are > > > > Windows-based ones (we would need to do some labeling of jobs so that > > > > most things only run on our Linux hosts but one job runs on the Windows > > > > infra). I'm less sure we can do such a matrix with Travis. But is > > > > there some way we could get this Windows tool build into CI and thus > > > > keep it from breaking in the future? Thanks! > > > > > > Yes, I would like to have GitLab CI to do the Windows build for us. > > > However I did not find the free GitLab.com-provided hosts. Any hints? > > > > Yeah, OK, I was wrong. You have to be on gitlab.com and they don't have > > Windows. And I don't know enough Windows to figure out how to automate > > going from a Microsoft-provided free VirtualBox image to having that > > have GitLab Runner also installed. > > Ah that's bad we can't find a GitLab hosted free Windows VM. > > So I looked at Microsoft Azure pipeline and it looks we can set up a > free account for U-Boot. > See > https://azure.microsoft.com/en-us/blog/announcing-azure-pipelines-with-unlimited-ci-cd-minutes-for-open-source/ That's interesting. Would you mind trying to get something going with that? Maybe long term we can use that as an alternative to travis too. -- Tom signature.asc Description: PGP signature ___ U-Boot mailing list U-Boot@lists.denx.de https://lists.denx.de/listinfo/u-boot
Re: [U-Boot] [PATCH 5/5] doc: Add documentation for how to build U-Boot host tools
Hi Tom, On Thu, Oct 17, 2019 at 10:10 PM Tom Rini wrote: > > On Thu, Oct 17, 2019 at 09:50:57AM +0800, Bin Meng wrote: > > Hi Tom, > > > > On Thu, Oct 17, 2019 at 2:20 AM Tom Rini wrote: > > > > > > On Wed, Oct 16, 2019 at 09:27:25AM -0700, Bin Meng wrote: > > > > > > > This adds a reST document for how to build U-Boot host tools, > > > > including information for both Linux and Windows. > > > > > > > > Signed-off-by: Bin Meng > > > > > > So here's where I think things get interesting. Off the top of my head, > > > I think we can use the free GitLab.com-provided hosts of which there are > > > Windows-based ones (we would need to do some labeling of jobs so that > > > most things only run on our Linux hosts but one job runs on the Windows > > > infra). I'm less sure we can do such a matrix with Travis. But is > > > there some way we could get this Windows tool build into CI and thus > > > keep it from breaking in the future? Thanks! > > > > Yes, I would like to have GitLab CI to do the Windows build for us. > > However I did not find the free GitLab.com-provided hosts. Any hints? > > Yeah, OK, I was wrong. You have to be on gitlab.com and they don't have > Windows. And I don't know enough Windows to figure out how to automate > going from a Microsoft-provided free VirtualBox image to having that > have GitLab Runner also installed. Ah that's bad we can't find a GitLab hosted free Windows VM. So I looked at Microsoft Azure pipeline and it looks we can set up a free account for U-Boot. See https://azure.microsoft.com/en-us/blog/announcing-azure-pipelines-with-unlimited-ci-cd-minutes-for-open-source/ Regards, Bin ___ U-Boot mailing list U-Boot@lists.denx.de https://lists.denx.de/listinfo/u-boot
Re: [U-Boot] [PATCH 5/5] doc: Add documentation for how to build U-Boot host tools
On Thu, Oct 17, 2019 at 09:50:57AM +0800, Bin Meng wrote: > Hi Tom, > > On Thu, Oct 17, 2019 at 2:20 AM Tom Rini wrote: > > > > On Wed, Oct 16, 2019 at 09:27:25AM -0700, Bin Meng wrote: > > > > > This adds a reST document for how to build U-Boot host tools, > > > including information for both Linux and Windows. > > > > > > Signed-off-by: Bin Meng > > > > So here's where I think things get interesting. Off the top of my head, > > I think we can use the free GitLab.com-provided hosts of which there are > > Windows-based ones (we would need to do some labeling of jobs so that > > most things only run on our Linux hosts but one job runs on the Windows > > infra). I'm less sure we can do such a matrix with Travis. But is > > there some way we could get this Windows tool build into CI and thus > > keep it from breaking in the future? Thanks! > > Yes, I would like to have GitLab CI to do the Windows build for us. > However I did not find the free GitLab.com-provided hosts. Any hints? Yeah, OK, I was wrong. You have to be on gitlab.com and they don't have Windows. And I don't know enough Windows to figure out how to automate going from a Microsoft-provided free VirtualBox image to having that have GitLab Runner also installed. -- Tom signature.asc Description: PGP signature ___ U-Boot mailing list U-Boot@lists.denx.de https://lists.denx.de/listinfo/u-boot
Re: [U-Boot] [PATCH 5/5] doc: Add documentation for how to build U-Boot host tools
Hi Tom, On Thu, Oct 17, 2019 at 2:20 AM Tom Rini wrote: > > On Wed, Oct 16, 2019 at 09:27:25AM -0700, Bin Meng wrote: > > > This adds a reST document for how to build U-Boot host tools, > > including information for both Linux and Windows. > > > > Signed-off-by: Bin Meng > > So here's where I think things get interesting. Off the top of my head, > I think we can use the free GitLab.com-provided hosts of which there are > Windows-based ones (we would need to do some labeling of jobs so that > most things only run on our Linux hosts but one job runs on the Windows > infra). I'm less sure we can do such a matrix with Travis. But is > there some way we could get this Windows tool build into CI and thus > keep it from breaking in the future? Thanks! Yes, I would like to have GitLab CI to do the Windows build for us. However I did not find the free GitLab.com-provided hosts. Any hints? Regards, Bin ___ U-Boot mailing list U-Boot@lists.denx.de https://lists.denx.de/listinfo/u-boot
Re: [U-Boot] [PATCH 5/5] doc: Add documentation for how to build U-Boot host tools
On Wed, Oct 16, 2019 at 09:27:25AM -0700, Bin Meng wrote: > This adds a reST document for how to build U-Boot host tools, > including information for both Linux and Windows. > > Signed-off-by: Bin Meng So here's where I think things get interesting. Off the top of my head, I think we can use the free GitLab.com-provided hosts of which there are Windows-based ones (we would need to do some labeling of jobs so that most things only run on our Linux hosts but one job runs on the Windows infra). I'm less sure we can do such a matrix with Travis. But is there some way we could get this Windows tool build into CI and thus keep it from breaking in the future? Thanks! -- Tom signature.asc Description: PGP signature ___ U-Boot mailing list U-Boot@lists.denx.de https://lists.denx.de/listinfo/u-boot
[U-Boot] [PATCH 5/5] doc: Add documentation for how to build U-Boot host tools
This adds a reST document for how to build U-Boot host tools, including information for both Linux and Windows. Signed-off-by: Bin Meng --- doc/build/index.rst | 9 + doc/build/tools.rst | 47 +++ doc/index.rst | 11 +++ 3 files changed, 67 insertions(+) create mode 100644 doc/build/index.rst create mode 100644 doc/build/tools.rst diff --git a/doc/build/index.rst b/doc/build/index.rst new file mode 100644 index 000..e4e3411 --- /dev/null +++ b/doc/build/index.rst @@ -0,0 +1,9 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +Build U-Boot + + +.. toctree:: + :maxdepth: 2 + + tools diff --git a/doc/build/tools.rst b/doc/build/tools.rst new file mode 100644 index 000..c06f915 --- /dev/null +++ b/doc/build/tools.rst @@ -0,0 +1,47 @@ +.. SPDX-License-Identifier: GPL-2.0+ +.. sectionauthor:: Bin Meng + +Host tools +== + +Building tools for Linux + + +To allow distributions to distribute all possible tools in a generic way, +avoiding the need of specific tools building for each machine, a tools only +defconfig file is provided. + +Using this, we can build the tools by doing:: + + $ make tools-only_defconfig + $ make tools-only + +Building tools for Windows +-- +If you wish to generate Windows versions of the utilities in the tools directory +you can use MSYS2, a software distro and building platform for Windows. + +Download the MSYS2 installer from https://www.msys2.org. Make sure you have +installed all required packages below in order to build these host tools:: + + * gcc (9.1.0) + * make (4.2.1) + * bison (3.4.2) + * diffutils (3.7) + * openssl-devel (1.1.1.d) + +Note the version numbers in these parentheses above are the package versions +at the time being when writing this document. The MSYS2 installer tested is +http://repo.msys2.org/distrib/x86_64/msys2-x86_64-20190524.exe. + +There are 3 MSYS subsystems installed: MSYS2, MinGW32 and MinGW64. Each +subsystem provides an environment to build Windows applications. The MSYS2 +environment is for building POSIX compliant software on Windows using an +emulation layer. The MinGW32/64 subsystems are for building native Windows +applications using a linux toolchain (gcc, bash, etc), targeting respectively +32 and 64 bit Windows. + +Launch the MSYS2 shell of the MSYS2 environment, and do the following:: + + $ make tools-only_defconfig + $ make tools-only NO_SDL=1 diff --git a/doc/index.rst b/doc/index.rst index 458f0d2..206a045 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -15,6 +15,17 @@ if you want to help out. .. toctree:: :maxdepth: 2 +User-oriented documentation +--- + +The following manuals are written for *users* of the U-Boot - those who are +trying to get it to work optimally on a given system. + +.. toctree:: + :maxdepth: 2 + + build/index + Unified Extensible Firmware (UEFI) -- -- 2.7.4 ___ U-Boot mailing list U-Boot@lists.denx.de https://lists.denx.de/listinfo/u-boot
