AMD openSIL open source firmware proof of concept

About the project:

The AMD open Silicon Initialization Library (openSIL) is a collection of C libraries which can be integrated into an x86 host firmware, by directly compiling source or by linking with static libraries.

AMD openSIL consists of three statically linked libraries; xSIM (x86 Silicon Initialization Libraries), xPRF (x86 Platform Reference Library), and xUSL (x86 Utilities & Services Library). These libraries can be statically linked to a host firmware during compile/link time.

Source for the libraries resides under xSIM, xPRF, and xUSL.

AMD openSIL open-source projected roadmap:

Evaluation Only Phases (no support for production implementations):

1. Phase I – Internal POC (complete).
2. Phase II – AMD openSIL POC open-sourced for evaluation on AMD 4th Gen EPYC™ based CRB (complete: this source).
3. Phase III – POC openSIL POC open-sourced, trending Q4 2024.

Production Phase:

4. Phase IV: – AMD openSIL POR with UEFI Host FW trending 2026.

Getting Started:

1. Clone Repository:

   1. Establish your GitHub user account and your SSH keys (details are beyond this doc)
   2. Open a command/terminal window
   3. Run git to obtain the project:
      > git clone git@github.com:openSIL/openSIL.git

2. Establish the project environment variables.

   • You will find a shell/cmd file (SetSilEnv) in the ‘util’ directory for this purpose.

3. Configure your project

   • This release of the AMD openSIL libraries supports AMD 4th Gen EPYC™ on the Onyx CRB only.

   • The openSIL project uses the python version of the Kconfig tool for this purpose. (See GitHub Kconfiglib).

   • Run the interactive configuration UI:
     > python %PYTHONPATH%menuconfig.py Kconfig

4. Build openSIL Libraries:

   • The AMD openSIL library build is performed using ‘Meson build’, an open source python tool (see GitHub). Several targets allow a focused build for xUSL, xSIM, xPRF or openSIL(xUSL + xSIM + XPRF) static libraries. AMD openSIL specific Meson build documentation is not yet available.
   • The project can be built for 32bit and/or 64bit compilation and static libraries.
   • The project supports both the GNU/GCC or LLVM/clang tool chain and the Microsoft Visual C tool chain. Generally it is recommended to use the latest versions of these tool chains.
     
     
     Specific versions being used today (June 2023) are:
     • GCC – v10.2.0
     • llvm/clang – v10.0
     • MSVC v19.00.24210 (Visual Studio 2015)
       
       

5. Integrate with Host Firmware:

   • AMD has a separate repository (“opensil-uefi-interface” ) for helping customers integrate openSIL with previous UEFI-AGESA installations. Please contact your AMD representative for more information.

6. Test Host Firmware on reference platform

   • All AMD openSIL testing has been performed on AMD an AMD reference platform (Onyx CRB).

   • Present list of supported reference platforms is shown in the following table.

     Market Segment	AMD Processor Family Model	Firmware	Reference Platform Name
     Server	F19M10	UEFI	Onyx

Forthcoming items:

• Formal documentation to be published to this repository.
• Continuous integration (CI) tools will be implemented as a pre-requisite to merging pull requests.

License:

The MIT License (MIT): https://opensource.org/license/mit/