201 lines
9.0 KiB
HTML
201 lines
9.0 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<title>SoC</title>
|
|
</head>
|
|
<body>
|
|
|
|
<h1>x86 System on a Chip (SoC) Development</h1>
|
|
<p>
|
|
SoC development is best done in parallel with development for a specific
|
|
board. The combined steps are listed
|
|
<a target="_blank" href="../development.html">here</a>.
|
|
The development steps for the SoC are listed below:
|
|
</p>
|
|
<ol>
|
|
<li><a target="_blank" href="../fsp1_1.html#RequiredFiles">FSP 1.1</a> required files</li>
|
|
<li>SoC <a href="#RequiredFiles">Required Files</a></li>
|
|
<li><a href="#Descriptor">Start Booting</a></li>
|
|
<li><a href="#EarlyDebug">Early Debug</a></li>
|
|
<li><a href="#Bootblock">Bootblock</a></li>
|
|
</ol>
|
|
|
|
|
|
<hr>
|
|
<h1><a name="RequiredFiles">Required Files</a></h1>
|
|
<p>
|
|
Create the directory as src/soc/<Vendor>/<Chip Family>.
|
|
</p>
|
|
|
|
<p>
|
|
The following files are required to build a new SoC:
|
|
</p>
|
|
<ul>
|
|
<li>Include files
|
|
<ul>
|
|
<li>include/soc/pei_data.h</li>
|
|
<li>include/soc/pm.h</li>
|
|
</ul>
|
|
</li>
|
|
<li>Kconfig - Defines the Kconfig value for the SoC and selects the tool
|
|
chains for the various stages:
|
|
<ul>
|
|
<li>select ARCH_BOOTBLOCK_<Tool Chain></li>
|
|
<li>select ARCH_RAMSTAGE_<Tool Chain></li>
|
|
<li>select ARCH_ROMSTAGE_<Tool Chain></li>
|
|
<li>select ARCH_VERSTAGE_<Tool Chain></li>
|
|
</ul>
|
|
</li>
|
|
<li>Makefile.inc - Specify the include paths</li>
|
|
<li>memmap.c - Top of usable RAM</li>
|
|
</ul>
|
|
|
|
|
|
<hr>
|
|
<h1><a name="Descriptor">Start Booting</a></h1>
|
|
<p>
|
|
Some SoC parts require additional firmware components in the flash.
|
|
This section describes how to add those pieces.
|
|
</p>
|
|
|
|
<h2>Intel Firmware Descriptor</h2>
|
|
<p>
|
|
The Intel Firmware Descriptor (IFD) is located at the base of the flash part.
|
|
The following command overwrites the base of the flash image with the Intel
|
|
Firmware Descriptor:
|
|
</p>
|
|
<pre><code>dd if=descriptor.bin of=build/coreboot.rom conv=notrunc >/dev/null 2>&1</code></pre>
|
|
|
|
|
|
<h2><a name="MEB">Management Engine Binary</a></h2>
|
|
<p>
|
|
Some SoC parts contain and require that the Management Engine (ME) be running
|
|
before it is possible to bring the x86 processor out of reset. A binary file
|
|
containing the management engine code must be added to the firmware using the
|
|
ifdtool. The following commands add this binary blob:
|
|
</p>
|
|
<pre><code>util/ifdtool/ifdtool -i ME:me.bin build/coreboot.rom
|
|
mv build/coreboot.rom.new build/coreboot.rom
|
|
</code></pre>
|
|
|
|
|
|
<h2><a name="EarlyDebug">Early Debug</a></h2>
|
|
<p>
|
|
Early debugging between the reset vector and the time the serial port is enabled
|
|
is most easily done by writing values to port 0x80.
|
|
</p>
|
|
|
|
|
|
<h2>Success</h2>
|
|
<p>
|
|
When the reset vector is successfully invoked, port 0x80 will output the following value:
|
|
</p>
|
|
<ul>
|
|
<li>0x01: <a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/include/console/post_codes.h;hb=HEAD#l45">POST_RESET_VECTOR_CORRECT</a>
|
|
- Bootblock successfully executed the
|
|
<a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/x86/16bit/reset16.inc;hb=HEAD#l4">reset vector</a>
|
|
and entered the 16-bit code at
|
|
<a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/x86/16bit/entry16.inc;hb=HEAD#l35">_start</a>
|
|
</li>
|
|
</ul>
|
|
|
|
|
|
<hr>
|
|
<h1><a name="Bootblock">Bootblock</a></h1>
|
|
<p>
|
|
Implement the bootblock using the following steps:
|
|
</p>
|
|
<ol>
|
|
<li>Create the directory as src/soc/<Vendor>/<Chip Family>/bootblock</li>
|
|
<li>Add the timestamp.inc file which initializes the floating point registers and saves
|
|
the initial timestamp.
|
|
</li>
|
|
<li>Add the bootblock.c file which:
|
|
<ol type="A">
|
|
<li>Enables memory-mapped PCI config access</li>
|
|
<li>Updates the microcode by calling intel_update_microcode_from_cbfs</li>
|
|
<li>Enable ROM caching</li>
|
|
</ol>
|
|
</li>
|
|
<li>Edit the src/soc/<Vendor>/<Chip Family>/Kconfig file
|
|
<ol type="A">
|
|
<li>Add the BOOTBLOCK_CPU_INIT value to point to the bootblock.c file</li>
|
|
<li>Add the CHIPSET_BOOTBLOCK_INCLUDE value to point to the timestamp.inc file</li>
|
|
</ol>
|
|
</li>
|
|
<li>Edit the src/soc/<Vendor>/<Chip Family>/Makefile.inc file
|
|
<ol type="A">
|
|
<li>Add the bootblock subdirectory</li>
|
|
</ol>
|
|
</li>
|
|
<li>Edit the src/soc/<Vendor>/<Chip Family>/memmap.c file
|
|
<ol type="A">
|
|
<li>Add the fsp/memmap.h include file</li>
|
|
<li>Add the mmap_region_granularity routine</li>
|
|
</ol>
|
|
</li>
|
|
<li>Add the necessary .h files to define the necessary values and structures</li>
|
|
<li>When successful port 0x80 will output the following values:
|
|
<ol type="A">
|
|
<li>0x01: <a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/include/console/post_codes.h;hb=HEAD#l45">POST_RESET_VECTOR_CORRECT</a>
|
|
- Bootblock successfully executed the
|
|
<a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/x86/16bit/reset16.inc;hb=HEAD#l4">reset vector</a>
|
|
and entered the 16-bit code at
|
|
<a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/x86/16bit/entry16.inc;hb=HEAD#l35">_start</a>
|
|
</li>
|
|
<li>0x10: <a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/include/console/post_codes.h;hb=HEAD#l53">POST_ENTER_PROTECTED_MODE</a>
|
|
- Bootblock executing in
|
|
<a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/x86/32bit/entry32.inc;hb=HEAD#l55">32-bit mode</a>
|
|
</li>
|
|
<li>0x10 - Verstage/romstage reached 32-bit mode</li>
|
|
</ol>
|
|
</li>
|
|
</ol>
|
|
|
|
<p>
|
|
<b>Build Note:</b> The following files are included into the default bootblock image:
|
|
</p>
|
|
<ul>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/arch/x86/bootblock_romcc.S;hb=HEAD">src/arch/x86/bootblock_romcc.S</a>
|
|
added by <a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/arch/x86/Makefile.inc;hb=HEAD#l133">src/arch/x86/Makefile.inc</a>
|
|
and includes the following files:
|
|
<ul>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/arch/x86/prologue.inc">src/arch/x86/prologue.inc</a></li>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/x86/16bit/reset16.inc">src/cpu/x86/16bit/reset16.inc</a></li>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/x86/16bit/entry16.inc">src/cpu/x86/16bit/entry16.inc</a></li>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/x86/32bit/entry32.inc">src/cpu/x86/32bit/entry32.inc</a></li>
|
|
<li>The code in
|
|
<a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/arch/x86/bootblock_romcc.S">src/arch/x86/bootblock_romcc.S</a>
|
|
includes src/soc/<Vendor>/<Chip Family>/bootblock/timestamp.inc using the
|
|
CONFIG_CHIPSET_BOOTBLOCK_INCLUDE value set above
|
|
</li>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/x86/sse_enable.inc">src/cpu/x86/sse_enable.inc</a></li>
|
|
<li>The code in
|
|
<a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/arch/x86/Makefile.inc;hb=HEAD#l156">src/arch/x86/Makefile.inc</a>
|
|
invokes the ROMCC tool to convert the following "C" code into assembler as bootblock.inc:
|
|
<ul>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/arch/x86/include/arch/bootblock_romcc.h">src/arch/x86/include/arch/bootblock_romcc.h</a></li>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/x86/lapic/boot_cpu.c">src/cpu/x86/lapic/boot_cpu.c</a></li>
|
|
<li>The CONFIG_BOOTBLOCK_CPU_INIT value set above typically points to the code in
|
|
src/soc/<Vendor>/<Chip Family>/bootblock/bootblock.c
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/arch/x86/id.S">src/arch/x86/id.S</a>
|
|
added by <a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/arch/x86/Makefile.inc;hb=HEAD#l110">src/arch/x86/Makefile.inc</a>
|
|
</li>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/intel/fit/fit.S">src/cpu/intel/fit/fit.S</a>
|
|
added by <a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/cpu/intel/fit/Makefile.inc;hb=HEAD">src/cpu/intel/fit/Makefile.inc</a>
|
|
</li>
|
|
<li><a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/arch/x86/walkcbfs.S">src/arch/x86/walkcbfs.S</a>
|
|
added by <a target="_blank" href="http://review.coreboot.org/gitweb?p=coreboot.git;a=blob;f=src/arch/x86/Makefile.inc;hb=HEAD#l137">src/arch/x86/Makefile.inc</a>
|
|
</li>
|
|
</ul>
|
|
|
|
|
|
<hr>
|
|
<p>Modified: 31 January 2016</p>
|
|
</body>
|
|
</html> |