From 92d7017a045bbc1ba20d5615bd35e0d70aa151b7 Mon Sep 17 00:00:00 2001 From: Subrata Banik Date: Fri, 23 Nov 2018 13:34:05 +0530 Subject: 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 Reviewed-on: https://review.coreboot.org/c/29805 Tested-by: build bot (Jenkins) Reviewed-by: Patrick Georgi --- .../intel/icelake/iceLake_coreboot_development.md | 72 ++++++++++++++++++++++ Documentation/soc/intel/icelake/index.md | 4 ++ 2 files changed, 76 insertions(+) create mode 100644 Documentation/soc/intel/icelake/iceLake_coreboot_development.md (limited to 'Documentation/soc') 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 + $ 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) -- cgit v1.2.3