summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSubrata Banik <subrata.banik@intel.com>2018-11-23 13:34:05 +0530
committerPatrick Georgi <pgeorgi@google.com>2018-11-27 08:56:05 +0000
commit92d7017a045bbc1ba20d5615bd35e0d70aa151b7 (patch)
tree528c7ed6a414f629b3cfca63204e78c184f911fc
parente547bfc0afbab20f98272fb44ea0e1d0e4ae3a39 (diff)
downloadcoreboot-92d7017a045bbc1ba20d5615bd35e0d70aa151b7.tar.xz
Documentation/../../icelake: Add Ice Lake coreboot development documentation
Add documentation for Ice Lake processor family coreboot development. Documented so far: * What is Ice Lake * Development Strategy * Create coreboot Image * Flashing coreboot Change-Id: Ief4df6ca11f95b75ecddeb560f7887bfadced086 Signed-off-by: Subrata Banik <subrata.banik@intel.com> Reviewed-on: https://review.coreboot.org/c/29805 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Patrick Georgi <pgeorgi@google.com>
-rw-r--r--Documentation/soc/intel/icelake/iceLake_coreboot_development.md72
-rw-r--r--Documentation/soc/intel/icelake/index.md4
2 files changed, 76 insertions, 0 deletions
diff --git a/Documentation/soc/intel/icelake/iceLake_coreboot_development.md b/Documentation/soc/intel/icelake/iceLake_coreboot_development.md
new file mode 100644
index 0000000000..59b013dc03
--- /dev/null
+++ b/Documentation/soc/intel/icelake/iceLake_coreboot_development.md
@@ -0,0 +1,72 @@
+# Intel Ice Lake coreboot development
+
+## Introduction
+
+This document captures the coreboot development strategy for Intel SoC named Ice lake.
+
+The Ice Lake processor family is the next generation IntelĀ® Core processor family.
+These processors are built using Intel's 10 nm+ process.
+
+* [What is Ice Lake?](https://www.intel.in/content/www/in/en/design/products-and-solutions/processors-and-chipsets/ice-lake/overview.html)
+
+## Development Strategy
+
+Like any other Intel SoC, Ice Lake coreboot development is also based on "Intel common code development model".
+
+1. Intel develops initial Firmware code for Ice Lake SoC.
+
+2. Additionally provides Firmware code support for Intel Reference Platform (RVP), known as Ice lake RVP with same SoC.
+ ```eval_rst
+ :doc:`../../../mainboard/intel/icelake_rvp.md`
+ ```
+
+3. OEMs to design based on reference platform and make use of mainboard sample code. Dragonegg is Ice Lake based mainboard developed by Google
+ ```eval_rst
+ :doc:`../../../mainboard/google/dragonegg.md`
+ ```
+
+### Summary:
+* SoC is Ice Lake.
+* Reference platform is icelake_rvp.
+* OEM board is Dragonegg.
+
+## Create coreboot Image
+
+1. Clone latest coreboot code as below
+```bash
+$ git clone https://review.coreboot.org/coreboot.git
+```
+
+2. Place blobs (ucode, me.bin and FSP packages) in appropriate locations
+
+Note:
+Consider the fact that ucode and ME kit for Ice Lake SoC will be available from Intel VIP site.
+After product launch, FSP binary will be available externally as any other program.
+
+3. Create coreboot .config
+
+4. Build toolchain
+```bash
+CPUS=$(nproc--ignore=1) make crossgcc-i386 iasl
+```
+
+5. Build image
+```bash
+$ make # the image is generated as build/coreboot.rom
+```
+
+## Flashing coreboot
+
+Flashing mechanism might be different between Intel RVP (Reference Validation Platform) and Chromebooks:
+
+* Make use of dediprog while flashing coreboot image on Intel-RVP
+* For Chromebook related platform like dragonegg, one can flash via servo:
+
+```bash
+ $ dut-control spi2_vref:pp3300 spi2_buf_en:on spi2_buf_on_flex_en:on warm_reset:on
+ $ sudo flashrom -n -p ft2232_spi:type=servo-v2 -w <bios_image>
+ $ dut-control spi2_vref:off spi2_buf_en:off spi2_buf_on_flex_en:off warm_reset:off
+```
+### References
+* [flashrom](https://flashrom.org/Flashrom)
+* [Servo](https://www.chromium.org/chromium-os/servo)
diff --git a/Documentation/soc/intel/icelake/index.md b/Documentation/soc/intel/icelake/index.md
index b4f512ca05..450ab0f758 100644
--- a/Documentation/soc/intel/icelake/index.md
+++ b/Documentation/soc/intel/icelake/index.md
@@ -2,6 +2,10 @@
This section contains documentation about coreboot on specific Intel "Ice Lake" SOCs.
+## Ice Lake coreboot development
+
+- [Ice Lake coreboot development](iceLake_coreboot_development.md)
+
## Multiprocessor Init
- [Multiprocessor Init](MultiProcessorInit.md)