summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDamien Le Moal <damien.lemoal@wdc.com>2019-01-18 09:49:37 +0300
committerAnup Patel <anup@brainfault.org>2019-01-21 07:28:33 +0300
commit0df82694776d4497ca3bcfb662a68fd817698e89 (patch)
treea0524cf1d8c2df483adb241c53bb3885c2503230 /docs
parentf4373731e386a3b410f3e8acf6620111fb339abc (diff)
downloadopensbi-0df82694776d4497ca3bcfb662a68fd817698e89.tar.xz
Makefile: Add support for device tree compilation
Add rules to compile dts files into dtb files using the device tree compiler (dtc). A platform can specify the DTS file to compile using the platform-dtb-y variable. The flattened device tree binary file to be used for building the final polatform firmware can be specified using the new FW_PAYLOAD_FDT firmware configuration option to point to the automatically compiled FDT file. Using the existing FW_PAYLOAD_FDT_PATH configuration option is still possible and will take precedence over the FW_PAYLOAD_FDT definition. Signed-off-by: Damien Le Moal <damien.lemoal@wdc.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/firmware/fw_payload.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/firmware/fw_payload.md b/docs/firmware/fw_payload.md
index 0e705a2..3a8a14d 100644
--- a/docs/firmware/fw_payload.md
+++ b/docs/firmware/fw_payload.md
@@ -57,6 +57,14 @@ device tree file is specified by the platform (c.f. *FW_PAYLOAD_FDT*),
then the firmware will expect the FDT to be passed as an argument by
the prior booting stage.
+* **FW_PAYLOAD_FDT** - Path to an internal flattened device tree
+binary file defined by the platform code. The file name must match the
+DTB file name specified in the platform *objects.mk* file with the
+*platform-dtb-y* entry. This option results in *FW_PAYLOAD_FDT_PATH* to
+be automatically set. Specifying *FW_PAYLOAD_FDT_PATH* on the `make`
+command line disables *FW_PAYLOAD_FDT* and the command line specified
+device tree binary file is used for building the final firmware.
+
* **FW_PAYLOAD_FDT_ADDR** - Address where the FDT passed by the prior
booting stage or specified by the *FW_PAYLOAD_FDT_PATH* parameter and
embedded in the *.text* section will be placed before executing the