Apollo Lake CRB Boards

Note

Intel Atom® Processor E3900 is formally known as Apollo Lake platform.

Supported Boards

SBL supports Leaf Hill, Juniper Hill and Oxbow Hill board variations of Apollo Lake platform.

Building

To build SBL for Apollo Lake platform platform:

python BuildLoader.py build apl

The output images are generated under Outputs directory.

Stitching

  1. Download Apollo Lake platform firmware image.
This image contains additional firmware ingredients that are required to boot on Apollo Lake platform.

Note

StitchLoader.py currently only supports stitching with boot guard feature disabled. Unzip the firmware images that contains two Apollo Lake platform firmware images, one is Debug version and one is Release version, both of them can be used for stitch SBL IFWI.

  1. Stitch SBL images into downloaded BIOS image:

    python Platform/ApollolakeBoardPkg/Script/StitchLoader.py -i <BIOS_IMAGE_NAME> -s Outputs/apl/Stitch_Components.zip -o <SBL_IFWI_IMAGE_NAME>

where -i = Input file, -o = Output file.

For example, stitching SBL IFWI image sbl_lfh_ifwi.bin from Apollo Lake platform firmware images downloaded:

python Platform/ApollolakeBoardPkg/Script/StitchLoader.py -i LEAFHILD.X64.0070.R01.1805070352.bin -s Outputs/apl/Stitch_Components.zip -o sbl_lfh_ifwi.bin

For more details on stitch tool, see Stitch Tool on how to stitch the IFWI image with SBL.

Flashing

Flash the generated sbl_lfh_ifwi.bin to the target board using DediProg SF100 or SF600 programmer.

Note

Please check the alignment/polarity when connecting Dediprog to the board. Please power off the board before connecting the Dediprog.

Note

The connector labelled SPI TPM - J5D1 on the target board is for DediProg.

Note

Please disconnect Deidprog before powering up the board again.

Debug UART

For Apollo Lake platform, LPSS UART Port 2 is the debug UART configured in SBL.

The Apollo Lake platform have a FTDI chip for serial to USB connection. Please connect the micro USB connector next to the power button on the target board to a host and a terminal software to enable debug console from SBL.

Booting Yocto Linux

See Booting Yocto Linux from USB for more details.

You may need to change boot options to boot from USB. See Change Boot Options.

Board ID Assignments

Each Apollo Lake platform CRB board is assigned a unique platform ID by reading a set of GPIO pins (25, 26 and 30).

Board Platform ID
Oxbow Hill 6
Leaf Hill 7
Juniper Hill 8

See Dynamic Platform ID Detection for more details.

To customize board configurations in *.dlt file, make sure to specify PlatformId to the corresponding values for the board.

See Configuration Editor for more details.