<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"> <head> <meta http-equiv="Content-Type" content="text/html; charset=Windows-1252"> <meta name="Generator" content="Microsoft Word 15 (filtered medium)"> <style></style> </head> <body lang="EN-US" link="blue" vlink="#954F72"> <div class="WordSection1"> Hi UEFI community,<o:p></o:p> <o:p> </o:p> I�d like to introduce the CdePkg to edk2-staging.<o:p></o:p> <o:p> </o:p> Some time ago I decided to write my own ANSI C Library for UEFI Shell and POST.<o:p></o:p> <o:p> </o:p> The UEFI Shell library (�Torito C Library�) has been production-ready for more than one year.<o:p></o:p> The POST version of the library (�CdeLib�) is not yet fully tested.<o:p></o:p> <o:p> </o:p> I will be demonstrating my verification procedure in the upcoming weeks on EDK2 STAGING <a href="https://github.com/tianocore/edk2-staging/tree/CdePkg">https://github.com/tianocore/edk2-staging/tree/CdePkg</a> <o:p> </o:p> Currently there are 3 examples implemented: <ol style="margin-top:0in" start="1" type="1"> <li class="xmsonormal" style="color:black;mso-list:l2 level1 lfo5">argvc: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/HOSTED_ENV/argcv/main.c#L57">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/HOSTED_ENV/argcv/main.c#L57</a><o:p></o:p></li></ol> argc/argv handling according to <a href="https://msdn.microsoft.com/en-us/library/a1y7w461.aspx"> https://msdn.microsoft.com/en-us/library/a1y7w461.aspx</a><o:p></o:p> <ol style="margin-top:0in" start="2" type="1"> <li class="xmsonormal" style="color:black;mso-list:l2 level1 lfo5">systeminterfacePEI: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfacePEI/main.c#L57"> https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfacePEI/main.c#L57</a><o:p></o:p></li></ol> demonstration, how PeiServices and FileHandle are passed into main()<o:p></o:p> <ol style="margin-top:0in" start="3" type="1"> <li class="xmsonormal" style="color:black;mso-list:l2 level1 lfo5">systeminterfaceDXE: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfaceDXE/main.c#L57"> https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/SYSTEM_IF/systeminterfaceDXE/main.c#L57</a><o:p></o:p></li></ol> demonstration, how SystemTable and ImageHandle are passed into main()<o:p></o:p> <o:p> </o:p> Upcoming next demonstration will be the clock() function end of this week<o:p></o:p> <o:p> </o:p> The idea is to bring the ANSI C Library interface into POST drivers.<o:p></o:p> This will:<o:p></o:p> <ol style="margin-top:0in" start="1" type="1"> <li class="xmsonormal" style="color:black;mso-list:l4 level1 lfo1">ease porting tasks<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l4 level1 lfo1">allow cross development<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l4 level1 lfo1">allow developers to focus on their aims, because they aren�t forced to keep in mind a lot of additional info (e.g. RShiftU64)<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l4 level1 lfo1">provide all intrisics to allow the compiler to be a �C compiler�<o:p></o:p></li></ol> (e.g. char buffer[256] = { 1 };)<o:p></o:p> <o:p> </o:p> What is CdePkg and Torito C Library?<o:p></o:p> <ul style="margin-top:0in" type="disc"> <li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo2">CdePkg and Torito C Library are a one man show / after work party, that is owned and written solely by myself<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo2">CdePkg is a reference implementation only for Microsoft C compiler<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo2">CdePkg is a feasibility study<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo2">CdePkg is the successor of Torito C, based on the same source code<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo2">CdePkg C Development Environment is similar to MdePkg Module Development Environment<o:p></o:p></li></ul> but guarantees that the C compiler is always fully usable (all intrinsics available) and the C90/C95 standard library is always available<o:p></o:p> <o:p> </o:p> What are the design goals?<o:p></o:p> <ul style="margin-top:0in" type="disc"> <li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo2"> to rewrite the whole thing from scratch, without using any public source code from GNU, BSD, Watcom<o:p></o:p></li><li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo2"> completeness: full blown C90 + C95 support, as lowest common denominator<o:p></o:p></li><li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo2"> tailored for UEFI: small code size, for UEFI-POST-driver uses a C-Library-Driver, that contains core/worker functions for realloc() == malloc() and free(), <o:p></o:p></li></ul> entire printf()-family, entire scanf()-family.<o:p></o:p> UEFI-POST-driver just uses small wrapper functions to run the C-Library-Driver code.<o:p></o:p> <ul style="margin-top:0in" type="disc"> <li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo2">stable, exact, chipset independent TSC based clock() with CLOCKS_PER_SEC == 1000 <o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l0 level1 lfo2">complete set of the Microsoft C-compiler intrinsic functions <o:p></o:p></li><li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo2"> ROM-able! Runs with stack but w/o any static storage duration in .data segment, e.g. for rand(), strtok(), tmpfile()<o:p></o:p></li></ul> This is required for early PEI before memory sizing, when PEI-images run directly out of flash<o:p></o:p> <ul style="margin-top:0in" type="disc"> <li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo2"> Microsoft (bug) compatible (as far as possible)<o:p></o:p></li></ul> <ol style="margin-top:0in" start="5" type="1"> <ol style="margin-top:0in" start="1" type="a"> <li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l3 level2 lfo3"> use original Microsoft header files for UEFI Shell Apps created in VS2019 <o:p></o:p></li><li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l3 level2 lfo3"> allow expensive debugging tasks of ANSI C .EFI applications in Visual Studio in its Windows NT counter part<o:p></o:p></li><li class="xmsolistparagraph" style="color:black;margin-left:0in;mso-list:l3 level2 lfo3"> to save my lifetime writing a documentation <a href="https://github.com/tianocore/edk2-staging/tree/CdePkg/implemented.md#validation-status"> https://github.com/tianocore/edk2-staging/tree/CdePkg/implemented.md#validation-status</a><o:p></o:p></li></ol> </ol> <ul style="margin-top:0in" type="disc"> <li class="MsoListParagraph" style="color:black;margin-left:0in;mso-list:l0 level1 lfo2"> all the above in one single C-Library CdeLib.lib<o:p></o:p></li></ul> <o:p> </o:p> CdePkg shall be adjusted to other compilers/tool chains too, once it is feature-complete and accepted by the UEFI community.<o:p></o:p> As long as it is for Microsoft VS2019 only.<o:p></o:p> <o:p> </o:p> CdePkg README.md is here: <a href="https://github.com/MinnowWare/CdePkg#cdepkg" title="https://github.com/MinnowWare/CdePkg#cdepkg STRG + Klicken, um Verkn�pfung zu folgen"> </a> <a href="https://github.com/tianocore/edk2-staging/tree/CdePkg#cdepkg">https://github.com/tianocore/edk2-staging/tree/CdePkg#cdepkg</a> CdePkg HOWTO is here: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/README.md#howto">https://github.com/tianocore/edk2-staging/blob/CdePkg/README.md#howto</a> CdeValidationPkg README.md is here: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/README.md#cdevalidationpkg">https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/README.md</a> CdeValidationPkg HOWTO is here: <a href="https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/README.md#howto"> https://github.com/tianocore/edk2-staging/blob/CdePkg/CdeValidationPkg/README.md</a> <o:p> </o:p> HOWTO:<o:p></o:p> <ol style="margin-top:0in" start="1" type="1"> <li class="xmsonormal" style="color:black;mso-list:l1 level1 lfo4">clone the edk2-staging repository<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l1 level1 lfo4">checkout CdePkg<o:p></o:p></li><li class="xmsonormal" style="color:black;mso-list:l1 level1 lfo4">run LAUNCH.BAT<o:p></o:p></li><li class="xmsonormal" style="mso-list:l1 level1 lfo4">run <code>build -p EmulatorPkg\EmulatorPkg.dsc -t VS2015x86 -a IA32</code><code><o:p></o:p></code></li><li class="xmsonormal" style="mso-list:l1 level1 lfo4"><code>run DBGEMU.BAT to start emulation (EmulatorPkg)</code><code><o:p></o:p></code></li><li class="xmsonormal" style="mso-list:l1 level1 lfo4"><code>run build -a IA32 -a X64 -n 5 -t VS2015x86 -b DEBUG -p Vlv2TbltDevicePkg\PlatformPkgX64.dsc<o:p></o:p></code></li><li class="xmsonormal" style="mso-list:l1 level1 lfo4"><code>update MinnowBoard with Build/Vlv2TbltDevicePkgX64\DEBUG_VS2015x86\FV\VLV.fd</code><code><o:p></o:p></code></li></ol> <code><o:p> </o:p></code> <code>Best regards,<o:p></o:p></code> <code>Kilian Kegel</code> <o:p> </o:p> <o:p> </o:p> </div> </body> </html> <div width="1" style="color:white;clear:both">_._,_._,_</div> <hr> Groups.io Links: You receive all messages sent to this group. <a target="_blank" href="https://edk2.groups.io/g/devel/message/49403">View/Reply Online (#49403)</a> | | <a target="_blank" href="https://groups.io/mt/36778747/1813853">Mute This Topic</a> | <a href="https://edk2.groups.io/g/devel/post">New Topic</a> <a href="https://edk2.groups.io/g/devel/editsub/1813853">Your Subscription</a> | <a href="mailto:devel+owner@edk2.groups.io">Contact Group Owner</a> | <a href="https://edk2.groups.io/g/devel/unsub">Unsubscribe</a> [edk2-devel-archive@redhat.com] <div width="1" style="color:white;clear:both">_._,_._,_</div>