# bb.org-overlays

**Repository Path**: beagleboard/bb-org-overlays

## Basic Information

- **Project Name**: bb.org-overlays
- **Description**: Device Tree Overlays for bb.org boards
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2017-06-23
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Users:
------------

Install or Update bb-cape-overlays debian package (pre installed on: Debian Jessie & Ubuntu Xenial images)

    sudo apt update ; sudo apt install bb-cape-overlays

Support Kernels:
------------

Kernel with CONFIG_BONE_CAPEMGR support:

    zcat /proc/config.gz | grep CONFIG_BONE_CAPEMGR
    CONFIG_BONE_CAPEMGR=y

Pre-built kernels: (there are multiple options avaiable)

    cd /opt/scripts/tools
    git pull

v4.4.x-ti:

    sudo ./update_kernel.sh --lts-4_4 --ti-channel

v4.4.x-ti + Real Time:

    sudo ./update_kernel.sh --lts-4_4 --ti-rt-channel

v4.4.x mainline:

    sudo ./update_kernel.sh --lts-4_4 --bone-channel

v4.4.x mainline + Real Time:

    sudo ./update_kernel.sh --lts-4_4 --bone-rt-channel

v4.9.x-ti:

    sudo ./update_kernel.sh --lts-4_9 --ti-channel

v4.9.x-ti + Real Time:

    sudo ./update_kernel.sh --lts-4_9 --ti-rt-channel

v4.9.x mainline:

    sudo ./update_kernel.sh --lts-4_9 --bone-channel

v4.9.x mainline + Real Time:

    sudo ./update_kernel.sh --lts-4_9 --bone-rt-channel

Developers:
------------

Step 1: Clone this repo:

    git clone https://github.com/beagleboard/bb.org-overlays
    cd ./bb.org-overlays

Step 2: Verify you have the latest (patched) dtc version: (this is only for v4.4.x+ for v3.8.x dtbo's use the older version)

    dtc --version
    Version: DTC 1.4.1-gXYZXYZXYZ

Upgrade dtc: (pre installed on: Debian Jessie & Ubuntu Xenial images)

    ./dtc-overlay.sh

Step 3: Install *.dtbo:

    ./install.sh

capemgr: enable/disable capes on kernel cmdline:
------------

Comma delimited list of PART-NUMBER[:REV] of [enabled/disabled] capes

    bone_capemgr.enable_partno=
    bone_capemgr.disable_partno=


capemgr: enable/disable capes with slots:
------------

Slots:

    debian@beaglebone:~$ cat /sys/devices/platform/bone_capemgr/slots
     0: PF----  -1
     1: PF----  -1
     2: PF----  -1
     3: PF----  -1

Add Device:

    sudo sh -c "echo 'BB-UART1' > /sys/devices/platform/bone_capemgr/slots"
    
    [  255.828371] bone_capemgr bone_capemgr: part_number 'BB-UART1', version 'N/A'
    [  255.828436] bone_capemgr bone_capemgr: slot #4: override
    [  255.828468] bone_capemgr bone_capemgr: Using override eeprom data at slot 4
    [  255.828501] bone_capemgr bone_capemgr: slot #4: 'Override Board Name,00A0,Override Manuf,BB-UART1'
    [  255.855687] 48022000.serial: ttyS1 at MMIO 0x48022000 (irq = 181, base_baud = 3000000) is a 8250
    [  255.856691] bone_capemgr bone_capemgr: slot #4: dtbo 'BB-UART1-00A0.dtbo' loaded; overlay id #0
    
    debian@beaglebone:~$ cat /sys/devices/platform/bone_capemgr/slots
     0: PF----  -1
     1: PF----  -1
     2: PF----  -1
     3: PF----  -1
     4: P-O-L-   0 Override Board Name,00A0,Override Manuf,BB-UART1

Remove Device:

    sudo sh -c "echo '-4' > /sys/devices/platform/bone_capemgr/slots"
    
    [  787.808035] bone_capemgr bone_capemgr: Removed slot #4
    
    debian@beaglebone:~$ cat /sys/devices/platform/bone_capemgr/slots
     0: PF----  -1
     1: PF----  -1
     2: PF----  -1
     3: PF----  -1

.config requirements:
------------

BeagleBone DVI-D CAPE (tilcd_tfp410):

    # CONFIG_OMAP2_DSS is not set

led:

    CONFIG_LEDS_GPIO=m

PWM Backlight:

    CONFIG_DRM_TILCDC=m
    CONFIG_BACKLIGHT_PWM=m

SPI:

    CONFIG_SPI_OMAP24XX=m

BBB compatibility issues:
------------

You can override dtb=x in /boot/uEnv.txt...

BeagleBone Black: HDMI (Audio/Video) disabled:

    dtb=am335x-boneblack-emmc-overlay.dtb

BeagleBone Black: eMMC disabled:

    dtb=am335x-boneblack-hdmi-overlay.dtb

BeagleBone Black: HDMI Audio/eMMC disabled:

    dtb=am335x-boneblack-nhdmi-overlay.dtb

BeagleBone Black: HDMI (Audio/Video)/eMMC disabled:

    dtb=am335x-boneblack-overlay.dtb

BB-BONE-DVID-01-00A3.dts

    Disable: HDMI & eMMC

BB-BONE-LCD3-01-00A2.dts

    Disable: HDMI

BB-BONE-LCD4-01-00A1.dts

    Disable: HDMI

BB-BONE-LCD7-01-00A3.dts

    Disable: HDMI

BB-UART5-00A0.dts:

    Disable: HDMI

Manually Loading Capes:
------------

example: BB-RTC-01-00A0.dts

    bone_capemgr.enable_partno=BB-RTC-01

example: BB-BONE-LCD7-01-00A3.dts

    bone_capemgr.enable_partno=BB-BONE-LCD7-01:00A3