Note that because this branch in this codebase is a proof-of-concept and is NOT for use in production firmware it is not eligible for bug bounty programs from AMD.

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.

The AMD blog "Empowering The Industry with Open System Firmware - AMD openSIL" provides a starting point to grasp the openSIL design goals.

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 - AMD openSIL POCs open-sourced for additional AMD platforms (complete).

1. Phase IV - AMD openSIL POR with UEFI Host FW trending 2026.

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. Configure toolchains

   • 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 2019)

5. 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.

6. 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.

7. Test Host Firmware on reference platform

   • All AMD openSIL testing has been performed on 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

All code in this codebase is Copyright Advanced Micro Devices unless otherwise noted.

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