From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id E7B9421A08D63 for ; Thu, 1 Jun 2017 09:48:24 -0700 (PDT) Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 01 Jun 2017 09:49:26 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.39,280,1493708400"; d="scan'208";a="109259947" Received: from orsmsx107.amr.corp.intel.com ([10.22.240.5]) by fmsmga005.fm.intel.com with ESMTP; 01 Jun 2017 09:49:25 -0700 Received: from orsmsx113.amr.corp.intel.com ([169.254.9.128]) by ORSMSX107.amr.corp.intel.com ([169.254.1.201]) with mapi id 14.03.0319.002; Thu, 1 Jun 2017 09:49:25 -0700 From: "Kinney, Michael D" To: Leif Lindholm , "Yao, Jiewen" , "Kinney, Michael D" CC: "edk2-devel@lists.01.org" , "Richardson, Brian" , Ard Biesheuvel , Chenhui Sun , Andrew Fish , Alan Ott , Ryan Harkin , "Duran, Leo" , "haojian.zhuang@linaro.org" , Linaro UEFI , Heyi Guo Thread-Topic: [edk2] [RFC] migration of OpenPlatformPkg to tianocore Thread-Index: AQHSxGBoIftOZn2lrUSePM4Ws3w6M6HmOGmAgAAE/oCAKofxgP//mwSw Date: Thu, 1 Jun 2017 16:49:25 +0000 Message-ID: References: <20170503225539.GQ1657@bivouac.eciton.net> <74D8A39837DF1E4DA445A8C0B3885C503A939E61@shsmsx102.ccr.corp.intel.com> <74D8A39837DF1E4DA445A8C0B3885C503A939EA0@shsmsx102.ccr.corp.intel.com> <20170601153311.GN7556@bivouac.eciton.net> In-Reply-To: <20170601153311.GN7556@bivouac.eciton.net> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ctpclassification: CTP_IC x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiM2QwYmM5NGItOTk3Yy00MmJiLWFlNjEtNTMzNDRmZTgxOGZhIiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX0lDIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE1LjkuNi42IiwiVHJ1c3RlZExhYmVsSGFzaCI6IjFnVngwelNIRXFsaldmdlwvYkhvaWpjOVRSZUVpanc1QlZLWG01bytwdUt3PSJ9 dlp-product: dlpe-windows dlp-version: 10.0.102.7 dlp-reaction: no-action x-originating-ip: [10.22.254.139] MIME-Version: 1.0 Subject: Re: [RFC] migration of OpenPlatformPkg to tianocore X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Jun 2017 16:48:25 -0000 Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Hi Leif, For directory name convention, I do recommend if a directory contains a pac= kage DEC file, then the directory should end in "Pkg". I would not recommend a change to the behavior of PACKAGES_PATH at this tim= e. Let's attempt to work through the detailed proposal with current PACKAGES_P= ATH behavior and see if additional features or tools are really required. One of the key learnings I had in working in the directory structure propos= al for the edk2 repo is to minimize the number of directory levels added so th= e PACKAGE_PATH setting does not get too long. For the edk2-platforms layout, we can choose to have the default setting fo= r=20 PACKAGES_PATH to contain paths to all packages in edk2-platforms repo. Thi= s would allow all platforms to be built with a single PACKAGES_PATH setting. This is what we would also do if we moved forward with adding directory layout to edk2 repo. This does imply that the PACKAGES_PATH could be fairl= y long (depending on depth of directories added to these repos). If a developer wants to pull a subset of the content from the edk2 related repositories using the git sparse checkout feature to limit the content to exactly what they need for a specific platform, then it would make sense=20 to reduce the number of paths in PACKAGES_PATH to match the spare checkout. We may need some tool(s) to help manage multiple repos and PACKAGES_PATH. For example, you could have a tool that searches a repo for .dec files and update PACKAGES_PATH to make all packages in that repo available to the bui= ld. IMHO, adding directory structure to the repos is to help put packages into Different categories (e.g. core, silicon, platform, vendor specific). The side effect of adding these categories in the directory structure is increa= sed complexity in the build configuration and build tools. Best regards, Mike -----Original Message----- From: Leif Lindholm [mailto:leif.lindholm@linaro.org]=20 Sent: Thursday, June 1, 2017 8:33 AM To: Yao, Jiewen Cc: edk2-devel@lists.01.org; Richardson, Brian = ; Ard Biesheuvel ; Chenhui Sun ; Andrew Fish ; Alan Ott ; Rya= n Harkin ; Duran, Leo ; haojian.= zhuang@linaro.org; Linaro UEFI ; Kinney, Mich= ael D ; Heyi Guo Subject: Re: [edk2] [RFC] migration of OpenPlatformPkg to tianocore Hi Jiewen, Apologies for ridicilously slow response - I caught a bad cold and am only now getting back on track with this. Many thanks for having a look, and your comments. On Fri, May 05, 2017 at 02:03:43PM +0000, Yao, Jiewen wrote: > Some comments for the build failure. >=20 > I think we might have different understanding on PACKAGES_PATH. >=20 > We are using below structure: > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D > Platform\ > Intel\ > PlatformAPkg > PlatformBPkg > Silicon\ > Intel\ > SiliconAPkg > SiliconBPkg >=20 > We set PACKAGES_PATH to "Platform\Intel:Silicon\Intel". > As such Build.DSC can include PlatformAPkg/DriverA/DriverA.inf. > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D >=20 >=20 > My suggestion for your case is below: We can use > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D > Platform\ > Arm\ > JunoPkg > VExpressPkg Yes, so this is probably a good point. I tried to model this repository on Mike's proposal for updated directory structure, and is was not entirely clear to me whether the *Pkg naming convention was intended to be retained at lower levels when it disappeared at the top level. /* BEGIN sidetrack */ My understanding from before was that the "package" convention stemmed from a situation where each top-level directory was treated as an "IP silo". Since that aspect disappeared with the proposed layout changes, and the edk2-* repositories can now be seen much more (if not entirely) as cohesive structures, I had simply assumed the Pkg suffix convention would disappear. I do not actually have a strong opinion on the matter. /* END sidetrack */ In the specific cases of JunoPkg and VExpressPkg, these are not technically "packages" in this tree, since their .dec files are still in edk2. However, these should move, and if the Pkg naming convention remains, they should indeed be renamed. >=20 > We set PACKAGES_PATH to "Platform\Arm". > ArmJunoPkg.dsc can just use "VExpressPkg\ArmVExpress.dsc.inc" and "JunoPk= g\Library\JunoPciHostBridgeLib\ JunoPciHostBridgeLib.dsc" > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D >=20 > The benefit of adding "Pkg" is that people can have a clear picture on wh= ere the path starts from. :) OK, so I think we have a situation where I have misunderstood the intended purpose of the PACKAGES_PATH mechanism. But, I would like to discuss the possibility of extending it to cover the use-case that I thought it provided - or potentially adding new functionality to provide the same. Since my goal is to have many platforms (for scope, let's call it hundreds) in the edk2-platforms master branch, needing to specify for each platform all directories that contains packages used by that platform becomes quite tedious. Especially when that stretches across multiple packages in multiple repositories. As an example, take the SoftIron 1000 platform. If the PACKAGES_PATH needs to contain all directories holding packages used outside of edk2, I would need to add: - edk2-non-osi/Platform/SoftIron/ - edk2-non-osi/Silicon/AMD/Styx/ - edk2-platforms/Platform/SoftIron/ - edk2-platforms/Silicon/AMD/Styx/ And for each other platform, I would need to specify a similar (unique for that platform) PACKAGES_PATH. And I can see more complex splits than that appearing. Now, if everything I want to build resides across the master branch of edk2, the master branch of edk2-platforms and the master branch of edk2-non-osi, then I just need a way for the build command to search in all three repositories. At that point, the only platform-specific information I need in order to build is the path to the .dsc. So, what I was hoping for was a way to simply extend the path resolution in .dsc/.fdf files to multiple repositories. I had hoped PACKAGES_PATH could do this, but since this was never its design goal I understand why it does not. Do you think the PACKAGES_PATH functionality could/should be extended to support this, or do I need a new feature (WORKSPACES_PATH?)? Best Regards, Leif > Thank you > Yao Jiewen >=20 >=20 >=20 > From: edk2-devel [mailto:edk2-devel-bounces@lists.01.org] On Behalf Of Ya= o, Jiewen > Sent: Friday, May 5, 2017 9:46 PM > To: Leif Lindholm ; edk2-devel@lists.01.org > Cc: Richardson, Brian ; Ard Biesheuvel ; Chenhui Sun ; Andrew Fish ; Alan Ott ; Ryan Harkin ; Duran, Leo ; haojian.zhuang@linaro.org; Lina= ro UEFI ; Kinney, Michael D ; Heyi Guo > Subject: Re: [edk2] [RFC] migration of OpenPlatformPkg to tianocore >=20 > HI Leif > It is great that you are adding more platform to edk2-platforms. >=20 > We (Intel) also have plan to add more boards there. In general, we are ve= ry close on having silicon and platform folder. >=20 > I have a quick look. One minor suggestions here: > Take Arm folder as example. (I assume Juno is one package, and VExpress i= s the other package.) > Can we name Juno to be JunoPkg, and VExpress to be VExpressPkg ? > We do not add "Pkg" to a folder. And we usually add "Pkg" suffix to a pac= kage. >=20 > In general, I think it is a very good start. > I may review the content in more detail and provide more feedback. >=20 >=20 > Thank you > Yao Jiewen >=20 >=20 > From: edk2-devel [mailto:edk2-devel-bounces@lists.01.org] On Behalf Of Le= if Lindholm > Sent: Thursday, May 4, 2017 6:56 AM > To: edk2-devel@lists.01.org > Cc: Ryan Harkin >; = Ard Biesheuvel = >; Chenhui Sun >; And= rew Fish >; Alan Ott >; Richardson, Brian >; Duran, Leo >; haojian.zhuang@linaro.org; Linaro UEFI >; Kinney, Michael D >; Heyi Guo > > Subject: [edk2] [RFC] migration of OpenPlatformPkg to tianocore >=20 > Hi all, >=20 > As some of you may be aware, I have been working around the lack of > a clear upstreaming strategy for platform support by keeping such code > in a dedicated repository I set up at Linaro for that purpose: > https://git.linaro.org/uefi/OpenPlatformPkg.git >=20 > During discussions at the last Seattle plugfest we finally agreed on > the (theoretical) details of how to use the edk2-platforms repository. > After that I promised to migrate OpenPlatformPkg across to the > edk2-platforms and edk2-non-osi structure, with the explicit end goal > from my side that this should become the master branch for each. >=20 > And now, before the release of HURD 1.0, I have. >=20 > Current limitations (that I can remember): > - A few references to OpenPlatformPkg remain, in ways that do not > appear to break any of the platform builds. Most likely this affects > dead code, but in case it's been accidentally orphaned, I thought it > best to > - I have simply nuked all references to Ebl (used in _addition_ to the > UEFI shell, which was never the intent) and the efi-toolkit > ramdisk driver. > - The Marvell Yukon driver that I sent out for review last week has > not migrated anywhere, and so has been temporarily disabled > Mike suggested I should > - USB support on the LeMaker Cello board depends on the patch > "OptionRomPkg: add firmware loader driver for Renesas PD72020x" > sent out by Ard on 18th of April. > - I have dropped some of the binary-only modules from OpenPlatformPkg, > and contacted the platform owners with requests for modifications. > - The git history is quite messy and will be cleaned up, but I wanted > to keep the transition quite visible in the RFC. > - I haven't filled anything into the Maintainers.txt files - I am in > favour of moving to a fully machine-readable format with wildcards > as Laszlo has proposed in the past, and think this would be an > excellent point to have that discussion (which can be had separately > for edk2-platforms and edk2-non-osi from edk2). > - Few of the platforms complete the FV generation stage, and I've > inserted a couple of silly hacks to get them to get as far as they > do. I think that either I am missing some points of how > PACKAGES_PATH is intended to work, or I'm simply hitting corner > cases no one has come across before. I could really use some help > debugging these issues. (examples below). >=20 > The below depends on the 3-part series I sent out today for importing > DwEmmcDxe and EfiTimeBaseLib from OpenPlatformPkg. But apart from > that, I have uploaded branches called devel-OpenPlatformPkg to: >=20 > https://github.com/tianocore/edk2-platforms/tree/devel-OpenPlatformPkg > https://github.com/tianocore/edk2-non-osi/tree/devel-OpenPlatformPkg >=20 > These branches _will_ be rebased occasionally until they get to a > point where they can move out of devel- stage (and hopefully onto > master). >=20 >=20 > Build issue description > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > So, one of the hopefully easier ones is what I'm seeing when trying to > build the Juno platform: >=20 > $ PACKAGES_PATH=3D"/work/maint/edk2-platforms:/work/maint/edk2-non-osi" G= CC5_AARCH64_PREFIX=3Daarch64-linux-gnu- build -a AARCH64 -t GCC5 -p Platfor= m/ARM/Juno/ArmJuno.dsc -b RELEASE -n 9 >=20 > results in: >=20 > <<< > GenFds.py... > : error F003: Output file for RAW section could not be found for > Platform/ARM/Juno/AcpiTables/AcpiTables.inf >=20 > ### >=20 >=20 > build.py... > : error 7000: Failed to execute command > GenFds -f /work/maint/edk2-platforms/Platform/ARM/Juno/ArmJuno.f= df --conf=3D/work/maint/edk2/Conf -o /work/maint/edk2/Build/ArmJuno/RELEASE= _GCC5 -t GCC5 -b RELEASE -p /work/maint/edk2-platforms/Platform/ARM/Juno/Ar= mJuno.dsc -a AARCH64 -D "EFI_SOURCE=3D/work/maint/edk2/EdkCompatibilityPkg"= -D "EDK_SOURCE=3D/work/maint/edk2/EdkCompatibilityPkg" -D "TOOL_CHAIN_TAG= =3DGCC5" -D "TOOLCHAIN=3DGCC5" -D "TARGET=3DRELEASE" -D "FAMILY=3DGCC" -D "= WORKSPACE=3D/work/maint/edk2" -D "EDK_TOOLS_PATH=3D/work/maint/edk2/BaseToo= ls" -D "ARCH=3DAARCH64" -D "ECP_SOURCE=3D/work/maint/edk2/EdkCompatibilityP= kg" > [/work/maint/edk2] >=20 > - Failed - > >>> >=20 > And when I copy and paste the above command manually, I get: >=20 > <<< > GenFds.py... > /work/maint/edk2-platforms/Platform/ARM/Juno/ArmJuno.dsc(34): error > 000E: File/directory not found in workspace > /work/maint/edk2-platforms/Platform/ARM/Juno/Platform/ARM/VExpres= s/ArmVExpress.dsc.inc > /work/maint/edk2/Platform/ARM/VExpress/ArmVExpress.dsc.inc > >>> >=20 > So, to an uniformed observer, it seems the portion > !include Platform/ARM/VExpress/ArmVExpress.dsc.inc > from ArmJuno.dsc > gets expanded to "directory ArmJuno.dsc is in" + "Platform/ARM/VExpress/A= rmVExpress.dsc.inc" > whereas I was hoping for it to try to find a match for > "Platform/ARM/VExpress/ArmVExpress.dsc.inc" along PACKAGES_PATH (and > find one in edk2-platforms). >=20 > I also have the impression that something similar is happening in > ArmJuno.fdf for the line > INF RuleOverride=3DACPITABLE Platform/ARM/Juno/AcpiTables/AcpiTables.in= f > generating the error message from the original build command. >=20 > But I'm not quite sure how to debug these issues (short of fully > figuring out the innards of MultipleWorkspace.py, MetaFileParser.py > and a few others). > Any ideas of where to look, or even what is going on? > Would these cases be expected to work? >=20 > / > Leif > _______________________________________________ > edk2-devel mailing list > edk2-devel@lists.01.org> > https://lists.01.org/mailman/listinfo/edk2-devel > _______________________________________________ > edk2-devel mailing list > edk2-devel@lists.01.org > https://lists.01.org/mailman/listinfo/edk2-devel