[S] Change in coreboot[master]: doc/mb/ocp/deltalake: add section on how to work on coreboot

[Jonathan Zhang (Code Review)]

Jonathan Zhang has uploaded this change for review. ( https://review.coreboot.org/c/coreboot/+/69169 )

Change subject: doc/mb/ocp/deltalake: add section on how to work on coreboot
......................................................................

doc/mb/ocp/deltalake: add section on how to work on coreboot

Update Delta Lake documentation to add some clarification.

Add a section on how to work on coreboot for the Delta Lake server.

Change-Id: Id756ee0a09cdcd1200752a03e980441db1537ad1
Signed-off-by: Jonzhang Zhang 
---
M Documentation/mainboard/ocp/deltalake.md
1 file changed, 37 insertions(+), 5 deletions(-)

git pull ssh://review.coreboot.org:29418/coreboot refs/changes/69/69169/1

diff --git a/Documentation/mainboard/ocp/deltalake.md b/Documentation/mainboard/ocp/deltalake.md
index 3f80538..b172b3b 100644
--- a/Documentation/mainboard/ocp/deltalake.md
+++ b/Documentation/mainboard/ocp/deltalake.md
@@ -26,12 +26,12 @@

The Yosemite-V3 system is in mass production. Meta, Intel and partners
 jointly develop Open System Firmware (OSF) solution on Delta Lake as an alternative
-solution. The OSF solution is based on FSP/coreboot/LinuxBoot stack. The
-OSF solution reached production quality for some use cases in July, 2021.
+solution. The OSF solution reached production quality for some use cases
+in July, 2021.

## How to build

-OSF code base is public at
+OSF code base is publicly available at
 https://github.com/opencomputeproject/OpenSystemFirmware

Run following commands to build Delta Lake OSF image from scratch:
@@ -42,7 +42,7 @@
 Linux kernel and u-root code from their upstream repo, and sync down needed
 binary blobs. [osf-builder] also provides the top level build system.

-Delta Lake server OSF solution requires following binary blobs:
+Besides coreboot, the Delta Lake OSF solution includes following components:
 - FSP blob: The blob (Intel Cooper Lake Scalable Processor Firmware Support Package)
   can be downloaded from https://github.com/intel/FSP/tree/master/CedarIslandFspBinPkg.
 - Microcode: Available through github.com/intel/Intel-Linux-Processor-Microcode-Data-Files.
@@ -54,7 +54,10 @@
   U-root as initramfs, is used in the joint development. It can be built
   following [All about u-root].

-## Flashing coreboot
+The Delta Lake OSF solution is updated periodically to newer versions of
+upstream coreboot code base and other components.
+
+## How to verify Delta Lake OSF image

To do in-band FW image update, use [flashrom]:
     flashrom -p internal:ich_spi_mode=hwseq -c "Opaque flash chip" --ifd \
@@ -70,6 +73,21 @@
 To connect to console through SOL (Serial Over Lan):
     sol-util slotx

+## How to work on coreboot for Delta Lake
+After the OSF image for Delta Lake is built and verified, under
+OpenSystemFirmware/Wiwynn/deltalake directory:
+    cd src/osf-builder/projects/craterlake/coreboot
+
+Run "git remote -v" to confirm the origin is from coreboot upstream repo.
+
+Run "git branch -v" to know the confirmed working coreboot commit ID for the
+Delta Lake OSF solution.
+
+Fetch down the tip of coreboot upstream repo, run "make" to build a new OSF
+image for Delta Lake, verify that it works.
+
+Now you are in a familiar coreboot environment, happy coding!
+
 ## Firmware configurations
 [ChromeOS VPD] is used to store most of the firmware configurations.
 RO_VPD region holds default values, while RW_VPD region holds customized