2016-01-07 20:24:24 +01:00
<!DOCTYPE html>
< html >
< head >
< title > Development< / title >
< / head >
< body >
2016-02-03 16:28:22 +01:00
< h1 > Intel® x86 coreboot/FSP Development Process< / h1 >
2016-01-07 20:24:24 +01:00
< p >
The x86 development process for coreboot is broken into the following components:
< / p >
< ul >
2016-02-03 16:28:22 +01:00
< li > coreboot < a target = "_blank" href = "SoC/soc.html" > SoC< / a > development< / li >
< li > coreboot < a target = "_blank" href = "Board/board.html" > mainboard< / a > development< / li >
2016-01-07 20:24:24 +01:00
< li > < a target = "_blank" href = "fsp1_1.html" > FSP 1.1< / a > integration< / li >
< / ul >
< p >
The development process has two main phases:
< / p >
< ol >
< li > Minimal coreboot; This phase is single threaded< / li >
< li > Adding coreboot features< / li >
< / ol >
2016-02-03 16:28:22 +01:00
< h2 > Minimal coreboot< / h2 >
2016-01-07 20:24:24 +01:00
< p >
The combined steps below describe how to bring up a minimal coreboot for a
system-on-a-chip (SoC) and a development board:
< / p >
< table >
< tr bgcolor = "#ffffc0" >
< td > The initial coreboot steps are single threaded!
The initial minimal FSP development is also single threaded.
Progress can speed up by adding more developers after the minimal coreboot/FSP
implementation reaches the payload.
< / td >
< / tr >
< / table >
< ol >
< li > Get the necessary tools:
< ul >
< li > Linux: Use your package manager to install m4 bison flex and the libcurses development
package.
< ul >
< li > Ubuntu or other Linux distribution that use apt, run:
< pre > < code > sudo apt-get install m4 bison flex libncurses5-dev
< / code > < / pre >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li > Build the cross tools for i386:
< ul >
< li > Linux:
< pre > < code > make crossgcc-i386< / code > < / pre >
To use multiple processors for the toolchain build (which takes a long time), use:
< pre > < code > make crossgcc-i386 CPUS=N< / code > < / pre >
where N is the number of cores to use for the build.
< / li >
< / ul >
< / li >
< li > Get something to build:
< ol type = "A" >
< li > < a target = "_blank" href = "fsp1_1.html#RequiredFiles" > FSP 1.1< / a > required files< / li >
< li > < a target = "_blank" href = "SoC/soc.html#RequiredFiles" > SoC< / a > required files< / li >
< li > < a target = "_blank" href = "Board/board.html#RequiredFiles" > Board< / a > required files< / li >
< / ol >
< / li >
< li > Get result to start < a target = "_blank" href = "SoC/soc.html#Descriptor" > booting< / a > < / li >
< li > < a target = "_blank" href = "SoC/soc.html#EarlyDebug" > Early Debug< / a > < / li >
2016-01-31 19:49:35 +01:00
< li > Implement and debug the < a target = "_blank" href = "SoC/soc.html#Bootblock" > bootblock< / a > code< / li >
2016-01-31 20:48:15 +01:00
< li > Implement and debug the call to < a target = "_blank" href = "SoC/soc.html#TempRamInit" > TempRamInit< / a > < / li >
2016-02-04 20:21:33 +01:00
< li > Enable the serial port
< ol type = "A" >
< li > Power on, enable and configure GPIOs for the
< a target = "_blank" href = "Board/board.html#SerialOutput" > debug serial UART< / a >
< / li >
< li > Add the < a target = "_blank" href = "SoC/soc.html#SerialOutput" > serial outupt< / a >
support to romstage
< / li >
< / ol >
< / li >
< li > Enable < a target = "_blank" href = "fsp1_1.html#corebootFspDebugging" > coreboot/FSP< / a > debugging< / li >
2016-02-04 20:23:36 +01:00
< li > Determine the < a target = "_blank" href = "SoC/soc.html#PreviousSleepState" > Previous Sleep State< / a > < / li >
< li > Enable DRAM:
< ol type = "A" >
< li > Implement the SoC
< a target = "_blank" href = "SoC/soc.html#MemoryInit" > MemoryInit< / a >
Support
< / li >
< li > Implement the board support to read the
< a target = "_blank" href = "Board/board.html#SpdData" > Memory Timing Data< / a >
< / li >
< / ol >
< / li >
2016-02-14 23:55:29 +01:00
< li >
Implement the .init routine for the
< a target = "_blank" href = "SoC/soc.html#ChipOperations" > chip operations< / a >
structure which calls FSP SiliconInit
< / li >
< li >
Start ramstage's
< a target = "_blank" href = "SoC/soc.html#DeviceTree" > device tree processing< / a >
to display the PCI vendor and device IDs
< / li >
< li >
Disable the
< a target = "_blank" href = "Board/board.html#DisablePciDevices" > PCI devices< / a >
< / li >
< li >
Implement the
< a target = "_blank" href = "SoC/soc.html#MemoryMap" > memory map< / a >
< / li >
2016-01-07 20:24:24 +01:00
< / ol >
2016-01-31 20:48:15 +01:00
< hr >
< table border = "1" >
< tr bgcolor = "#c0ffc0" >
< th colspan = 3 > < h1 > Features< / h1 > < / th >
< / tr >
< tr bgcolor = "#c0ffc0" >
< th > SoC< / th >
< th > Where< / th >
< th > Testing< / th >
< / tr >
< tr >
< td > Cache-as-RAM< / td >
< td >
< a target = "_blank" href = "SoC/soc.html#TempRamInit" > Find< / a >
FSP binary:
< a target = "_blank" href = "https://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/drivers/intel/fsp1_1/cache_as_ram.inc;hb=HEAD#l38" > cache_as_ram.inc< / a > < br >
Enable: FSP 1.1 < a target = "_blank" href = "SoC/soc.html#TempRamInit" > TempRamInit< / a >
called from
< a target = "_blank" href = "https://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/drivers/intel/fsp1_1/cache_as_ram.inc;hb=HEAD#l73" > cache_as_ram.inc< / a > < br >
Disable: FSP 1.1 TempRamExit called from
< a target = "_blank" href = "https://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/drivers/intel/fsp1_1/after_raminit.S;hb=HEAD#l41" > after_raminit.S< / a > < br >
< / td >
< td > FindFSP: POST code 0x90
(< a target = "_blank" href = "http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/include/console/post_codes.h;hb=HEAD#l205" > POST_FSP_TEMP_RAM_INIT< / a > )
is displayed< br >
Enable: POST code
< a target = "_blank" href = "https://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/drivers/intel/fsp1_1/cache_as_ram.inc;hb=HEAD#l151" > 0x2A< / a >
is displayed< br >
Disable: CONFIG_DISPLAY_MTRRS=y, MTRRs displayed after call to TempRamExit
< / td >
< / tr >
2016-02-14 23:55:29 +01:00
< tr >
< td > Memory Map< / td >
< td >
Implement a device driver for the
< a target = "_blank" href = "SoC/soc.html#MemoryMap" > north cluster< / a >
< / td >
< td > coreboot displays the memory map correctly during the BS_WRITE_TABLES state< / td >
< / tr >
< tr >
< td > PCI Device Support< / td >
< td > Implement a PCI < a target = "_blank" href = "SoC/soc.html#DeviceDrivers" > device driver< / a > < / td >
< td > The device is detected by coreboot and usable by the payload< / td >
< / tr >
< tr >
< td > Ramstage state machine< / td >
< td >
Implement the chip and domain operations to start the
< a target = "_blank" href = "SoC/soc.html#DeviceTree" > device tree< / a >
processing
< / td >
< td >
During the BS_DEV_ENUMERATE state, ramstage now display the device IDs
for the PCI devices on the bus.
< / td >
< / tr >
2016-02-04 20:21:33 +01:00
< tr bgcolor = "#c0ffc0" >
< th > Board< / th >
< th > Where< / th >
< th > Testing< / th >
< / tr >
2016-02-14 23:55:29 +01:00
< tr >
< td > Device Tree< / td >
< td >
< a target = "_blank" href = "SoC/soc.html#DeviceTree" > List< / a > PCI vendor and device IDs by starting
the device tree processing< br >
< a target = "_blank" href = "Board/board.html#DisablePciDevices" > Disable< / a > PCI devices< br >
Enable: Implement a PCI < a target = "_blank" href = "SoC/soc.html#DeviceDrivers" > device driver< / a >
< td >
List: BS_DEV_ENUMERATE state displays PCI vendor and device IDs< br >
Disable: BS_DEV_ENUMERATE state shows the devices as disabled< br >
Enable: BS_DEV_ENUMERATE state shows the device as on and the device works for the payload
< / td >
< / tr >
2016-02-04 20:23:36 +01:00
< tr >
< td > DRAM< / td >
< td >
Load SPD data: src/soc/mainboard/< Vendor> /< Board> /spd/< a target = "_blank" href = "Board/board.html#SpdData" > spd.c< / a > < br >
UPD Setup:
< ul >
< li > src/soc< Vendor> //< Chip Family> /romstage/< a target = "_blank" href = "SoC/soc.html#MemoryInit" > romstage.c< / a > < / li >
< li > src/mainboard/< Vendor> /< Board> /< a target = "_blank" href = "Board/board.html#SpdData" > romstage.c< / a > < / li >
< / ul >
FSP 1.1 MemoryInit called from src/drivers/intel/fsp1_1/< a target = "_blank" href = "https://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/drivers/intel/fsp1_1/raminit.c;hb=HEAD#l126" > raminit.c< / a >
< / td >
< td > Select the following Kconfig values
< ul >
< li > DISPLAY_HOBS< / li >
< li > DISPLAY_UPD_DATA< / li >
< / ul >
Testing successful if:
< ul >
< li > MemoryInit UPD values are correct< / li >
< li > MemoryInit returns 0 (success) and< / li >
< li > The the message "ERROR - coreboot's requirements not met by FSP binary!"
is not displayed
< / li >
< / ul >
< / td >
< / tr >
2016-02-04 20:21:33 +01:00
< tr >
< td > Serial Port< / td >
< td >
SoC < a target = "_blank" href = "SoC/soc.html#SerialOutput" > Support< / a > < br >
Enable: src/soc/mainboard/< Board> /com_init.c/< a target = "_blank" href = "Board/board.html#SerialOutput" > car_mainboard_pre_console_init< / a >
< / td >
< td > Debug serial output works< / td >
< / tr >
2016-01-31 20:48:15 +01:00
< tr bgcolor = "#c0ffc0" >
< th > FSP< / th >
< th > Where< / th >
< th > Testing< / th >
< / tr >
< tr >
< td > TempRamInit< / td >
< td > FSP < a target = "_blank" href = "SoC/soc.html#TempRamInit" > TempRamInit< / a > < / td >
< td > FSP binary found: POST code 0x90
(< a target = "_blank" href = "http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/include/console/post_codes.h;hb=HEAD#l205" > POST_FSP_TEMP_RAM_INIT< / a > )
is displayed< br >
TempRamInit successful: POST code
< a target = "_blank" href = "https://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/drivers/intel/fsp1_1/cache_as_ram.inc;hb=HEAD#l151" > 0x2A< / a >
is displayed< br >
< / td >
< / tr >
2016-02-04 20:23:36 +01:00
< tr >
< td > MemoryInit< / td >
< td > < a target = "_blank" href = "SoC/soc.html#MemoryInit" > SoC< / a > support< br >
< a target = "_blank" href = "Board/board.html#SpdData" > Board< / a > support< br >
< / td >
< td > Select the following Kconfig values
< ul >
< li > DISPLAY_HOBS< / li >
< li > DISPLAY_UPD_DATA< / li >
< / ul >
Testing successful if:
< ul >
< li > MemoryInit UPD values are correct< / li >
< li > MemoryInit returns 0 (success) and< / li >
< li > The the message "ERROR - coreboot's requirements not met by FSP binary!"
is not displayed
< / li >
< / ul >
< / td >
< / tr >
2016-02-14 23:55:29 +01:00
< tr >
< td > SiliconInit< / td >
< td >
Implement the .init routine for the
< a target = "_blank" href = "SoC/soc.html#ChipOperations" > chip operations< / a > structure
< / td >
< td > During BS_DEV_INIT_CHIPS state, SiliconInit gets called and returns 0x00000000< / td >
< / tr >
< tr >
< td > FspNotify< / td >
< td >
The code which calls FspNotify is located in
src/drivers/intel/fsp1_1/< a target = "_blank" href = "http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/drivers/intel/fsp1_1/fsp_util.c;hb=HEAD#l182" > fsp_util.c< / a > .
The fsp_notify_boot_state_callback routine is called three times as specified
by the BOOT_STATE_INIT_ENTRY macros below the routine.
< / td >
< td >
The FspNotify routines are called during:
< ul >
< li > BS_DEV_RESOURCES - on exit< / li >
< li > BS_PAYLOAD_LOAD - on exit< / li >
< li > BS_OS_RESUME - on entry (S3 resume)< / li >
< / ul >
< / td >
< / tr >
2016-01-31 20:48:15 +01:00
< / table >
2016-01-07 20:24:24 +01:00
< hr >
2016-02-14 23:55:29 +01:00
< p > Modified: 15 February 2016< / p >
2016-01-07 20:24:24 +01:00
< / body >
< / html >