getcom/beaglebone-ibb-cape
2
0
Fork 0
forked from vincent.schweiger/beaglebone-ibb-cape
Code Pull Requests Activity

Update README.md

Browse Source
This commit is contained in:
Vincent Schweiger
2026-06-15 20:41:09 +00:00
parent 6a574f1f0f
commit 01c7d2f55f
1 changed files with 26 additions and 67 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+26 -67
View File
@@ -5,94 +5,53 @@
## Building ## Building
Steps: Steps:
* Clone this repository: https://github.com/beagleboard/BeagleBoard-DeviceTrees * Clone this repository: `https://github.com/beagleboard/BeagleBoard-DeviceTrees`
* Copy the .dtso source file into src/arm/overlays/ * Copy the `.dtso` source file into `src/arm/overlays/`
* Run `make -j4 all_arm` * Run `make -j4 all_arm`
## Installation ## Installation
Steps: Steps:
* Grab the .dtbo file built earlier from src/arm/overlays/ * Grab the `.dtbo` file built earlier from `src/arm/overlays/`
* Copy it to /lib/firwmare * Copy it to `/lib/firmware/`
<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
These were needed to get it to load correctly. ### Required uEnv.txt Adjustments
<br> To get the overlay to load correctly, the following options must be configured in your boot environment:
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. * `uboot_overlay_addr4=/lib/firmware/cape-bone-ibb-00A0.dtbo`
<br> * `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 #Docs: http://elinux.org/Beagleboard:U-boot_partitioning_layout_2.0
uname_r=6.18.8-bone18 uname_r=6.18.8-bone18
#uuid=
#dtb=
###U-Boot Overlays### ###U-Boot Overlays###
###Documentation: http://elinux.org/Beagleboard:BeagleBoneBlack_Debian#U-Boot_Overlays
###Master Enable ###Master Enable
enable_uboot_overlays=1 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 ###Additional custom capes
uboot_overlay_addr4=/lib/firmware/cape-bone-ibb-00A0.dtbo 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 ###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 uboot_overlay_pru=AM335X-PRU-UIO-00A0.dtbo
###
###Cape Universal Enable ###Cape Universal Enable
enable_uboot_cape_universal=0 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### ###U-Boot Overlays###
console=ttyS0,115200n8 console=ttyS0,115200n8
cmdline=fsck.repair=yes earlycon coherent_pool=1M net.ifnames=0 lpj=1990656 rng_core.default_quality=100 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
```