From 01c7d2f55fc2bf05aff95f921b5b57287235d465 Mon Sep 17 00:00:00 2001
From: Vincent Schweiger <vincent.schweiger@getcom.de>
Date: Mon, 15 Jun 2026 20:41:09 +0000
Subject: [PATCH] Update README.md

---
 README.md | 93 ++++++++++++++++---------------------------------------
 1 file changed, 26 insertions(+), 67 deletions(-)

diff --git a/README.md b/README.md
index 62c41a2..86e6edb 100644
--- a/README.md
+++ b/README.md
@@ -5,94 +5,53 @@
 ## Building
 
 Steps:
-* Clone this repository: https://github.com/beagleboard/BeagleBoard-DeviceTrees
-* Copy the .dtso source file into src/arm/overlays/
+* Clone this repository: `https://github.com/beagleboard/BeagleBoard-DeviceTrees`
+* Copy the `.dtso` source file into `src/arm/overlays/`
 * Run `make -j4 all_arm`
 
 ## Installation
+
 Steps:
-* Grab the .dtbo file built earlier from src/arm/overlays/
-* Copy it to /lib/firwmare
-<br>
-Notice the following options: 
-* uboot_overlay_addr4=/lib/firmware/cape-bone-ibb-00A0.dtbo
-* enable_uboot_overlays=1
-* enable_uboot_cape_universal=0
-* cmdline=fsck.repair=yes earlycon coherent_pool=1M net.ifnames=0 lpj=1990656 rng_core.default_quality=100
+* Grab the `.dtbo` file built earlier from `src/arm/overlays/`
+* Copy it to `/lib/firmware/`
 
-These were needed to get it to load correctly.
+### Required uEnv.txt Adjustments
 
-<br>
-Disable and/or remove all options and cmdline entries referencing cape manager, universal capes or other capes that are incompatible. You can check if the cape overlay was applied successfully by looking in `/proc/device-tree/chosen/overlays/`. Run `beagle-version` to get any pinmux issue logs.
-<br>
+To get the overlay to load correctly, the following options must be configured in your boot environment:
+* `uboot_overlay_addr4=/lib/firmware/cape-bone-ibb-00A0.dtbo`
+* `enable_uboot_overlays=1`
+* `enable_uboot_cape_universal=0`
+* `cmdline=fsck.repair=yes earlycon coherent_pool=1M net.ifnames=0 lpj=1990656 rng_core.default_quality=100`
 
-A minimal working /boot/uEnv.txt (**DO NOT** copy and paste):
-```
+**Important:** Disable and/or remove all options and cmdline entries referencing cape manager, universal capes, or other capes that are incompatible with this setup.
+
+### Verification
+* Check if the cape overlay was applied successfully by looking in: `/proc/device-tree/chosen/overlays/`
+* Run `beagle-version` to inspect any pinmux issue logs.
+
+---
+
+### Reference /boot/uEnv.txt
+Below is a minimal working example for reference. **DO NOT** blindly copy and paste this entire block into your system; use it strictly to verify your own parameters.
+
+```text
 #Docs: http://elinux.org/Beagleboard:U-boot_partitioning_layout_2.0
 
 uname_r=6.18.8-bone18
-#uuid=
-#dtb=
 
 ###U-Boot Overlays###
-###Documentation: http://elinux.org/Beagleboard:BeagleBoneBlack_Debian#U-Boot_Overlays
 ###Master Enable
 enable_uboot_overlays=1
-###
-###Overide capes with eeprom
-#uboot_overlay_addr0=/lib/firmware/cape-bone-ibb-00A0.dtbo
-#uboot_overlay_addr1=<file1>.dtbo
-#uboot_overlay_addr2=<file2>.dtbo
-#uboot_overlay_addr3=<file3>.dtbo
-###
+
 ###Additional custom capes
 uboot_overlay_addr4=/lib/firmware/cape-bone-ibb-00A0.dtbo
-#uboot_overlay_addr4=<file4>.dtbo
-#uboot_overlay_addr5=<file5>.dtbo
-#uboot_overlay_addr6=<file6>.dtbo
-#uboot_overlay_addr7=<file7>.dtbo
-###
-###Custom Cape
-#dtb_overlay=<file8>.dtbo
-###
-###Disable auto loading of virtual capes (emmc/video/wireless/adc)
-#disable_uboot_overlay_emmc=1
-#disable_uboot_overlay_video=1
-#disable_uboot_overlay_audio=1
-#disable_uboot_overlay_wireless=1
-#disable_uboot_overlay_adc=1
-###
+
 ###PRUSS OPTIONS
-###pru_rproc (4.14.x-ti kernel)
-#uboot_overlay_pru=AM335X-PRU-RPROC-4-14-TI-00A0.dtbo
-###pru_rproc (4.19.x-ti kernel)
-#uboot_overlay_pru=AM335X-PRU-RPROC-4-19-TI-00A0.dtbo
-###pru_uio (4.14.x-ti, 4.19.x-ti & mainline/bone kernel)
 uboot_overlay_pru=AM335X-PRU-UIO-00A0.dtbo
-###
+
 ###Cape Universal Enable
 enable_uboot_cape_universal=0
-###
-###Debug: disable uboot autoload of Cape
-#disable_uboot_overlay_addr0=1
-#disable_uboot_overlay_addr1=1
-#disable_uboot_overlay_addr2=1
-#disable_uboot_overlay_addr3=1
-###
-###U-Boot fdt tweaks... (60000 = 384KB)
-#uboot_fdt_buffer=0x60000
 ###U-Boot Overlays###
 
 console=ttyS0,115200n8
 cmdline=fsck.repair=yes earlycon coherent_pool=1M net.ifnames=0 lpj=1990656 rng_core.default_quality=100
-#cape_universal=enable
-
-#In the event of edid real failures, uncomment this next line:
-#cmdline=fsck.repair=yes earlycon coherent_pool=1M net.ifnames=0 lpj=1990656 rng_core.default_quality=100 video=HDMI-A-1:1024x768@60e
-
-#Use an overlayfs on top of a read-only root filesystem:
-#cmdline=fsck.repair=yes earlycon coherent_pool=1M net.ifnames=0 lpj=1990656 rng_core.default_quality=100 overlayroot=tmpfs
-
-##enable Generic eMMC Flasher:
-#cmdline=init=/usr/sbin/init-beagle-flasher
-```