summaryrefslogtreecommitdiffstats
path: root/external/meta-updater-raspberrypi/README.md
diff options
context:
space:
mode:
authortakeshi_hoshina <takeshi_hoshina@mail.toyota.co.jp>2020-10-22 14:58:56 +0900
committertakeshi_hoshina <takeshi_hoshina@mail.toyota.co.jp>2020-10-22 14:58:56 +0900
commit4204309872da5cb401cbb2729d9e2d4869a87f42 (patch)
treec7415e8600205e40ff7e91e8e5f4c411f30329f2 /external/meta-updater-raspberrypi/README.md
parent5b80bfd7bffd4c20d80b7c70a7130529e9a755dd (diff)
Diffstat (limited to 'external/meta-updater-raspberrypi/README.md')
-rw-r--r--external/meta-updater-raspberrypi/README.md24
1 files changed, 21 insertions, 3 deletions
diff --git a/external/meta-updater-raspberrypi/README.md b/external/meta-updater-raspberrypi/README.md
index 3623a212..29ea2989 100644
--- a/external/meta-updater-raspberrypi/README.md
+++ b/external/meta-updater-raspberrypi/README.md
@@ -1,7 +1,25 @@
-# BSP layer for updating Raspberrypi with OSTree
+# BSP layer for updating Raspberry Pi with OSTree
-* OSTree bootloader integration for Raspberry Pi. Add it to BBLAYERS when using [meta-updater](https://github.com/advancedtelematic/meta-updater) with [Raspberry Pi](https://github.com/agherzan/meta-raspberrypi).
-* Wi-Fi enablement for Raspberry Pi
+OSTree bootloader integration for Raspberry Pi. Add it to BBLAYERS when using [meta-updater](https://github.com/advancedtelematic/meta-updater) with [Raspberry Pi](https://github.com/agherzan/meta-raspberrypi).
+
+For more documentation on using this layer and [HERE OTA Connect](https://connect.ota.here.com/), please see the [OTA Connect documentation portal](https://docs.ota.here.com/), in particular the guide on [building a Raspberry Pi image](https://docs.ota.here.com/ota-client/latest/build-raspberry.html).
+
+## Device tree configuration
+
+The Raspberry Pi firmware allows customization of the device tree with special entries in `/boot/config.txt`:
+<https://www.raspberrypi.org/documentation/configuration/device-tree.md>.
+
+This is not supported in this form when using meta-updater, as the device tree and eventual overlays are managed separately via u-boot and ostree.
+
+Thus, you will have to make the necessary changes directly in yocto and either:
+
+- patch the kernel sources to modify source dts
+- patch the kernel sources to add overlay sources and add the corresponding binaries in `KERNEL_DEVICETREE`
+- use a customized complete dtb and declare it with `EXTERNAL_KERNEL_DEVICETREE`
+
+You can see examples of the first two approaches in [the linux-raspberrypi bbappend](recipes-kernel/linux/linux-raspberrypi_%.bbappend).
+
+## Wi-Fi enablement for Raspberry Pi
| Name | Default | Description |
|---|---|---|