Raptor Lake Platforms
13th Generation Intel® Core™ Processor, formally known as Raptor Lake family. [RPL]-S Refresh is also supported.
SBL supports various platforms corresponding to Raptor Lake-S Processors.
Each Raptor Lake board is assigned with a unique platform ID.
RPL-S DDR5 (UDIMM S14)
RPL-S DDR5 (SODIMM S17)
For Raptor Lake platforms, serial port connector location can be found from the above table for each supported target board.
Configure host PuTTY or minicom to 115200bps, 8N1, no hardware flow control.
To build SBL for any Raptor Lake platform:
python BuildLoader.py build <PLAT> <PLAT> = rpls
The output images are generated under
Gather Raptor Lake IFWI firmware image
Users can either download the full IFWI image if the IFWI image release is available or read the existing IFWI image on the board using SPI programmer. This image contains additional firmware ingredients that are required boot on Raptor Lake.
StitchLoader.py currently does not support stitching with boot guard feature enabled.
To stitch with Boot Guard enabled, please use
Stitch SBL images into downloaded BIOS image:
python Platform/RaptorlakeBoardPkg/Script/StitchLoader.py -i <BIOS_IMAGE_NAME> -s Outputs/<plat>/SlimBootloader.bin -o <SBL_IFWI_IMAGE_NAME>
where -i = Input file, -o = Output file, plat = rpls
For example, to stitch SBL IFWI image
sbl_rpls_ifwi.bin from RPL-S downloaded firmware images:
python Platform/RaptorlakeBoardPkg/Script/StitchLoader.py -i xxxx.bin -s Outputs/rpls/SlimBootloader.bin -o sbl_rpls_ifwi.bin
For more details on stitch tool, see Stitch Tool on how to stitch the IFWI image with SBL.
Flash the generated
sbl_rpls_ifwi.bin to the target board using a DediProg SF100 or SF600 programmer.
Refer the table above to identify the connector on the target board for SPI flash programmer. When using such device, please ensure: #. The alignment/polarity when connecting Dediprog to the board. #. The power to the board is turned off while the programmer is connected (even when not in use). #. The programmer is set to update the flash from offset 0x0.
Capsule image for Raptor Lake
SBL binary for capsule image could be extracted from SBL IFWI image generated in above steps.
bios.bin from SBL IFWI image:
python BootloaderCorePkg/Tools/IfwiUtility.py extract -i sbl_rpls_ifwi.bin -p IFWI/BIOS -o bios.bin
Generate capsule update image
python BootloaderCorePkg/Tools/GenCapsuleFirmware.py -p BIOS bios.bin -k <Keys> -o FwuImage.bin
BootGuard would not work if directly using Outputs/<plat>/SlimBootloader.bin for capsule image.
For more details on generating capsule image, please refer Generating capsule.
Triggering Firmware Update
SBL for Raptor Lake uses BIT16 of PMC I/O register (Over-Clocking WDT Control (OC_WDT_CTL) - Offset 54h) to trigger firmware update. When BIT16 is set, SBL will set the boot mode to FLASH_UPDATE. Please refer to Firmware Update on how to trigger firmware update flow. Below is an example:
To trigger firmware update in SBL shell:
FwuImage.bininto root directory on FAT partition of a USB key
Boot and press any key to enter SBL shell
SBL will reset the platform and initiate firmware update flow. The platform will reset multiple times to complete the update process.
A sample boot messages from console:
Shell> fwupdate ... ============= Intel Slim Bootloader STAGE1A ============= ... ============= Intel Slim Bootloader STAGE1B ============= ... BOOT: BP0 MODE: 18 ... ============= Intel Slim Bootloader STAGE2 ============= ... Jump to payload ... Starting Firmware Update ... =================Read Capsule Image============== ... ................ Finished 1% ... Finished 99% ... ... Reset required to proceed with the firmware update. ============= Intel Slim Bootloader STAGE1A ============= ... ============= Intel Slim Bootloader STAGE1B ============= ... BOOT: BP1 MODE: 18 ... ============= Intel Slim Bootloader STAGE2 ============= ... =================Read Capsule Image============== ... ................ Finished 1% ... Finished 99% Updating 0x002B1000, Size:0x0A000 ............... Finished 100% Set next FWU state: 0x7C Firmware Update status updated to reserved region Set next FWU state: 0x77 Reset required to proceed with the firmware update. ... ==================== OS Loader ==================== Starting Kernel ...
Booting Yocto Linux
You may need to change boot options to boot from USB. See Change Boot Options.
Download Yocto Linux
Create bootable USB key. For example: In Windows, Rufus can be used. In Linux, etcher app can be used.
Boot the bootable OS image from USB key on the board.
See Platform ID Detection using GPIOs for more details.
To customize board configurations in
*.dlt file, make sure to specify
PlatformId to the corresponding values for the board.
See Configuration Tools for more details.