From 8c986ab26358b40863f7404c97e8afbb118789f1 Mon Sep 17 00:00:00 2001 From: Patrick Rudolph Date: Mon, 18 Jun 2018 13:23:27 +0200 Subject: Documentation: Add cavium SoC and mainboard * Add documentation for CN81XX SoC * Add documentation for CN81XX EVB SFF mainboard * Add documentation for BDK * Add documentation for BOOTROM and BOOTBLOCK behaviour * Alphabetically sort vendors Change-Id: Ibfcd42788e31f684baed658dc3c4dfe1b8e4f354 Signed-off-by: Patrick Rudolph Reviewed-on: https://review.coreboot.org/27150 Tested-by: build bot (Jenkins) Reviewed-by: David Hendricks Reviewed-by: Philipp Deppenwiese --- Documentation/vendorcode/cavium/bdk.md | 30 ++++++++++++++++++++++++++++++ Documentation/vendorcode/cavium/index.md | 8 ++++++++ 2 files changed, 38 insertions(+) create mode 100644 Documentation/vendorcode/cavium/bdk.md create mode 100644 Documentation/vendorcode/cavium/index.md (limited to 'Documentation/vendorcode/cavium') diff --git a/Documentation/vendorcode/cavium/bdk.md b/Documentation/vendorcode/cavium/bdk.md new file mode 100644 index 0000000000..5763ece254 --- /dev/null +++ b/Documentation/vendorcode/cavium/bdk.md @@ -0,0 +1,30 @@ +# Cavium's BDK + +## BDK +A part of Cavium's BDK can be found in '''src/vendorcode/cavium/bdk'''. +It does the **DRAM init** in romstage and the **PCIe**, **QLM**, **SLI**, +**PHY**, **BGX**, **SATA** init in ramstage. + +## Devicetree +The BDK does use it's own devicetree, as coreboot's devicetree isn't +compatible. The devicetree stores key-value pairs (see **bdk-devicetree.h** +for implementation details), where the key and the value are stored as strings. + +The key-value pairs must be advertised in romstage and ramstage using the +'''bdk_config_set_fdt()''' method. + +The tool '''util/cavium/devicetree_convert.py''' can be used to convert a +devicetree to a key-value array. + +## Modifications + +* The BDK has been modified to compile under coreboot's toolchain. +* Removed FDT devicetree support. +* Dropped files that aren't required for SoC bringup +* Added Kconfig values for verbose console output + +## Debugging + +You can enable verbose console output in *menuconfig*: + +Go to **Chipset**, **BDK** and enable one or multiple stages. diff --git a/Documentation/vendorcode/cavium/index.md b/Documentation/vendorcode/cavium/index.md new file mode 100644 index 0000000000..e06e2ba009 --- /dev/null +++ b/Documentation/vendorcode/cavium/index.md @@ -0,0 +1,8 @@ +# Cavium vendorcode-specific documentation + +This section contains documentation about coreboot on Cavium specific +vendorcode. + +## Sections + +- [BDK](bdk.md) -- cgit v1.2.3