Difference between revisions of "Beagleboard:BeagleBone cape interface spec"
(→/dev/bone/adc) |
m |
||
(102 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | + | ''See the blog post on BeagleBoard.org for an introduction.<ref>[https://beagleboard.org/blog/2022-03-31-device-tree-supporting-similar-boards-the-beaglebone-example Device Tree: Supporting Similar Boards - The BeagleBone Example]</ref>'' | |
− | = | + | This is a list of symlink interfaces based on BeagleBone Cape header pins.<ref>[https://docs.google.com/spreadsheets/d/1fE-AsDZvJ-bBwzNBj1_sPDrutvEvsmARqFwvbw_HkrE/edit?usp=sharing Google drive with summary of expansion signals on various BeagleBoard.org designs]</ref><ref>[https://dev.ti.com/pinmux TI Pinmux Helper]</ref><ref>[[Beagleboard:Cape Expansion Headers]]</ref> |
− | === / | + | |
− | + | = Overall = | |
− | + | ||
− | + | {| class="wikitable" style="text-align: center;" | |
+ | |+ BeagleBone Cape header definition | ||
+ | |- | ||
+ | ! colspan="4" style="text-align: center;" |P9 !! | ||
+ | ! colspan="4" style="text-align: center;" |P8 | ||
+ | |- | ||
+ | ! Functions !! odd !! even !! Functions !! !! Functions !! odd !! even !! Functions | ||
+ | |- | ||
+ | | USB D+ || E1 || E2 || USB D- || || - || - || - || - | ||
+ | |- | ||
+ | | 5V OUT || E3 || E4 || GND || || - || - || - || - | ||
+ | |- | ||
+ | | GND || 1 || 2 || GND || || GND || 1 || 2 || GND | ||
+ | |- | ||
+ | | 3V3 OUT || 3 || 4 || 3V3 OUT || || D M || 3 || 4 || D M | ||
+ | |- | ||
+ | | 5V IN || 5 || 6 || 5V IN || || D M || 5 || 6 || D M | ||
+ | |- | ||
+ | | 5V OUT || 7 || 8 || 5V OUT || || D || 7 || 8 || D | ||
+ | |- | ||
+ | | PWR BUT || 9 || 10 || RESET || || D || 9 || 10 || D | ||
+ | |- | ||
+ | | D U4 || 11 || 12 || D || || D || 11 || 12 || D | ||
+ | |- | ||
+ | | D U4 || 13 || 14 || D E || || D E || 13 || 14 || D | ||
+ | |- | ||
+ | | D || 15 || 16 || D E || || D || 15 || 16 || D | ||
+ | |- | ||
+ | | D I1 S0 || 17 || 18 || D I1 S0 || || D || 17 || 18 || D | ||
+ | |- | ||
+ | | D I2 || 19 || 20 || D I2 || || D E || 19 || 20 || D M P1 | ||
+ | |- | ||
+ | | D E S0 U2 || 21 || 22 || D E S0 U2 || || D M P1 || 21 || 22 || D M | ||
+ | |- | ||
+ | | D || 23 || 24 || D I U1 || || D M || 23 || 24 || D M | ||
+ | |- | ||
+ | | D P0 || 25 || 26 || D I U1 || || D M || 25 || 26 || D | ||
+ | |- | ||
+ | | D P0 || 27 || 28 || D P0 S1 || || D L P1 || 27 || 28 || D L P1 | ||
+ | |- | ||
+ | | D E S1 P0 || 29 || 30 || D P0 S1 || || D L P1 || 29 || 30 || D L P1 | ||
+ | |- | ||
+ | | D E S1 P0 || 31 || 32 || ADC VDD || || D L || 31 || 32 || D L | ||
+ | |- | ||
+ | | A || 33 || 34 || ADC GND || || D L || 33 || 34 || D E L | ||
+ | |- | ||
+ | | A || 35 || 36 || A || || D L || 35 || 36 || D E L | ||
+ | |- | ||
+ | | A || 37 || 38 || A || || D L U5 || 37 || 38 || D L U5 | ||
+ | |- | ||
+ | | A || 39 || 40 || A || || D L P1 || 39 || 40 || D L P1 | ||
+ | |- | ||
+ | | D || 41 || 42 || D || || D L P1 || 41 || 42 || D L P1 | ||
+ | |- | ||
+ | | GND || 43 || 44 || GND || || D L P1 || 43 || 44 || D L P1 | ||
+ | |- | ||
+ | | GND || 45 || 46 || GND || || D E L P1 || 45 || 46 || D E L P1 | ||
+ | |} | ||
+ | |||
+ | * A: ADC | ||
+ | * C: CAN | ||
+ | * D: Digital GPIO | ||
+ | * E: EHRPWM | ||
+ | * I: I2C | ||
+ | * L: LCD | ||
+ | * M: MMC/SDIO | ||
+ | * P: PRU | ||
+ | * Q: eQEP | ||
+ | * S: SPI | ||
+ | * U: UART | ||
+ | |||
+ | = LEDs = | ||
+ | |||
+ | The compatibility layer comes with simple reference nodes for attaching LEDs to any gpio pin. The format followed for these nodes is '''led_P8_## / led_P9_##'''. The '''gpio-leds''' driver is used by these reference nodes internally and allows users to easily create compatible led nodes in overlays for BBBWL, BBB, and BBAI. For the definitions, you can see [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbai-bone-buses.dtsi#L16 bbai-bone-buses.dtsi#L16] & [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbb-bone-buses.dtsi#L16 bbb-bone-buses.dtsi#L16]. | ||
+ | |||
+ | == Example overlays == | ||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ Bone LEDs Overlays | ||
+ | |- | ||
+ | ! Header !! Pin !! Overlay | ||
+ | |- | ||
+ | | P8 || 03 | ||
+ | | [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BONE-LED_P8_03.dts BONE-LED_P8_03.dts] | ||
+ | |- | ||
+ | |||
+ | |- | ||
+ | | P9 || 11 | ||
+ | | [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BONE-LED_P9_11.dts BONE-LED_P9_11.dts] | ||
+ | |- | ||
+ | |||
+ | |} | ||
+ | |||
+ | == Definitions == | ||
− | == | + | {| class="wikitable" style="text-align: center;" |
− | + | |+ Bone LEDs | |
− | + | |- | |
− | + | ! LED !! Header pin !! BBBWL/BBB !! BBAI !! BBAI64 | |
− | + | |- | |
− | + | ! /sys/class/leds/led_P8_03 | |
+ | | P8_03 || gpio1_6 || gpio1_24 || gpio0_20 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_04 | ||
+ | | P8_04 || gpio1_7 || gpio1_25 || gpio0_48 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_05 | ||
+ | | P8_05 || gpio1_2 || gpio7_1 || gpio0_33 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_06 | ||
+ | | P8_06 || gpio1_3 || gpio7_2 || gpio0_34 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_07 | ||
+ | | P8_07 || gpio2_2 || gpio6_5 || gpio0_15 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_08 | ||
+ | | P8_08 || gpio2_3 || gpio6_6 || gpio0_14 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_09 | ||
+ | | P8_09 || gpio2_5 || gpio6_18 || gpio0_17 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_10 | ||
+ | | P8_10 || gpio2_4 || gpio6_4 || gpio0_16 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_11 | ||
+ | | P8_11 || gpio1_13 || gpio3_11 || gpio0_60 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_12 | ||
+ | | P8_12 || gpio1_12 || gpio3_10 || gpio0_59 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_13 | ||
+ | | P8_13 || gpio0_23 || gpio4_11 || gpio0_89 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_14 | ||
+ | | P8_14 || gpio0_26 || gpio4_13 || gpio0_75 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_15 | ||
+ | | P8_15 || gpio1_15 || gpio4_3 || gpio0_61 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_16 | ||
+ | | P8_16 || gpio1_14 || gpio4_29 || gpio0_62 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_17 | ||
+ | | P8_17 || gpio0_27 || gpio8_18 || gpio0_3 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_18 | ||
+ | | P8_18 || gpio2_1 || gpio4_9 || gpio0_4 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_19 | ||
+ | | P8_19 || gpio0_22 || gpio4_10 || gpio0_88 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_20 | ||
+ | | P8_20 || gpio1_31 || gpio6_30 || gpio0_76 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_21 | ||
+ | | P8_21 || gpio1_30 || gpio6_29 || gpio0_30 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_22 | ||
+ | | P8_22 || gpio1_5 || gpio1_23 || gpio0_5 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_23 | ||
+ | | P8_23 || gpio1_4 || gpio1_22 || gpio0_31 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_24 | ||
+ | | P8_24 || gpio1_1 || gpio7_0 || gpio0_6 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_25 | ||
+ | | P8_25 || gpio1_0 || gpio6_31 || gpio0_35 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_26 | ||
+ | | P8_26 || gpio1_29 || gpio4_28 || gpio0_51 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_27 | ||
+ | | P8_27 || gpio2_22 || gpio4_23 || gpio0_71 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_28 | ||
+ | | P8_28 || gpio2_24 || gpio4_19 || gpio0_72 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_29 | ||
+ | | P8_29 || gpio2_23 || gpio4_22 || gpio0_73 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_30 | ||
+ | | P8_30 || gpio2_25 || gpio4_20 || gpio0_74 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_31 | ||
+ | | P8_31 || gpio0_10 || gpio8_14 || gpio0_32 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_32 | ||
+ | | P8_32 || gpio0_11 || gpio8_15 || gpio0_26 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_33 | ||
+ | | P8_33 || gpio0_9 || gpio8_13 || gpio0_25 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_34 | ||
+ | | P8_34 || gpio2_17 || gpio8_11 || gpio0_7 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_35 | ||
+ | | P8_35 || gpio0_8 || gpio8_12 || gpio0_24 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_36 | ||
+ | | P8_36 || gpio2_16 || gpio8_10 || gpio0_8 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_37 | ||
+ | | P8_37 || gpio2_14 || gpio8_8 || gpio0_106 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_38 | ||
+ | | P8_38 || gpio2_15 || gpio8_9 || gpio0_105 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_39 | ||
+ | | P8_39 || gpio2_12 || gpio8_6 || gpio0_69 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_40 | ||
+ | | P8_40 || gpio2_13 || gpio8_7 || gpio0_70 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_41 | ||
+ | | P8_41 || gpio2_10 || gpio8_4 || gpio0_67 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_42 | ||
+ | | P8_42 || gpio2_11 || gpio8_5 || gpio0_68 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_43 | ||
+ | | P8_43 || gpio2_8 || gpio8_2 || gpio0_65 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_44 | ||
+ | | P8_44 || gpio2_9 || gpio8_3 || gpio0_66 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_45 | ||
+ | | P8_45 || gpio2_6 || gpio8_0 || gpio0_79 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P8_46 | ||
+ | | P8_46 || gpio2_7 || gpio8_1 || gpio0_80 | ||
− | + | |- | |
− | + | ! /sys/class/leds/led_P9_11 | |
− | + | | P9_11 || gpio0_30 || gpio8_17 || gpio0_1 | |
− | + | |- | |
− | + | ! /sys/class/leds/led_P9_12 | |
− | + | | P9_12 || gpio1_28 || gpio5_0 || gpio0_45 | |
+ | |- | ||
+ | ! /sys/class/leds/led_P9_13 | ||
+ | | P9_13 || gpio0_31 || gpio6_12 || gpio0_2 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_14 | ||
+ | | P9_14 || gpio1_18 || gpio4_25 || gpio0_93 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_15 | ||
+ | | P9_15 || gpio1_16 || gpio3_12 || gpio0_47 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_16 | ||
+ | | P9_16 || gpio1_19 || gpio4_26 || gpio0_94 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_17 | ||
+ | | P9_17 || gpio0_5 || gpio7_17 || gpio0_28 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_18 | ||
+ | | P9_18 || gpio0_4 || gpio7_16 || gpio0_40 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_19 | ||
+ | | P9_19 || gpio0_13 || gpio7_3 || gpio0_78 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_20 | ||
+ | | P9_20 || gpio0_12 || gpio7_4 || gpio0_77 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_21 | ||
+ | | P9_21 || gpio0_3 || gpio3_3 || gpio0_39 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_22 | ||
+ | | P9_22 || gpio0_2 || gpio6_19 || gpio0_38 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_23 | ||
+ | | P9_23 || gpio1_17 || gpio7_11 || gpio0_10 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_24 | ||
+ | | P9_24 || gpio0_15 || gpio6_15 || gpio0_13 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_25 | ||
+ | | P9_25 || gpio3_21 || gpio6_17 || gpio0_127 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_26 | ||
+ | | P9_26 || gpio0_14 || gpio6_14 || gpio0_12 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_27 | ||
+ | | P9_27 || gpio3_19 || gpio4_15 || gpio0_46 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_28 | ||
+ | | P9_28 || gpio3_17 || gpio4_17 || gpio1_11 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_29 | ||
+ | | P9_29 || gpio3_15 || gpio5_11 || gpio0_53 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_30 | ||
+ | | P9_30 || gpio3_16 || gpio5_12 || gpio0_44 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_31 | ||
+ | | P9_31 || gpio3_14 || gpio5_10 || gpio0_52 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_33 | ||
+ | | P9_33 || ⌠|| ⌠|| gpio0_50 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_35 | ||
+ | | P9_35 || ⌠|| ⌠|| gpio0_55 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_36 | ||
+ | | P9_36 || ⌠|| ⌠|| gpio0_56 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_37 | ||
+ | | P9_37 || ⌠|| ⌠|| gpio0_57 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_38 | ||
+ | | P9_38 || ⌠|| ⌠|| gpio0_58 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_39 | ||
+ | | P9_39 || ⌠|| ⌠|| gpio0_54 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_40 | ||
+ | | P9_40 || ⌠|| ⌠|| gpio0_81 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_41 | ||
+ | | P9_41 || gpio0_20 || gpio6_20 || gpio1_0 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_91 | ||
+ | | P9_91 || gpio3_20 || ⌠|| ⌠| ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_42 | ||
+ | | P9_42 || gpio0_7 || gpio4_18 || gpio0_123 | ||
+ | |- | ||
+ | ! /sys/class/leds/led_P9_92 | ||
+ | | P9_92 || gpio3_18 || ⌠|| ⌠| ||
+ | |- | ||
+ | ! /sys/class/leds/led_A15 | ||
+ | | A15 || gpio0_19 || ⌠|| ⌠| ||
+ | |- | ||
− | + | |} | |
− | |||
− | |||
− | |||
− | |||
− | + | = I2C = | |
− | == | ||
− | |||
− | |||
− | |||
− | |||
− | + | Compatibility layer provides simple I2C bone bus nodes for creating compatible overlays for BBBWL, BBB, & BBAI. The format followed for these nodes is '''bone_i2c_#'''. For the definitions, you can see [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbai-bone-buses.dtsi#L388 bbai-bone-buses.dtsi#L388] & [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbb-bone-buses.dtsi#L403 bbb-bone-buses.dtsi#L403]. | |
− | |||
− | |||
− | |||
− | |||
− | == | + | {| class="wikitable" style="text-align: center;" |
− | + | |+ Bone bus I2C | |
− | + | |- | |
− | + | ! SYSFS !! DT symbol !! BBBWL/BBB !! BBAI !! BBAI64 !! SCL !! SDA !! Overlay | |
− | + | |- | |
+ | ! /dev/bone/i2c/0 !! bone_i2c_0 | ||
+ | | I2C0 || I2C1 || TBD | ||
+ | | colspan="3" style="text-align: center;" |⌠(On-board) | ||
+ | |- | ||
+ | |- | ||
+ | !/dev/bone/i2c/1 !! bone_i2c_1 | ||
+ | | I2C1 || I2C5 || MAIN_I2C6 || P9.17 || P9.18 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_i2c/src/arm/BONE-I2C1.dts BONE-I2C1.dts] | ||
+ | |- | ||
+ | |- | ||
+ | !/dev/bone/i2c/2 !! bone_i2c_2 | ||
+ | | I2C2 || I2C4 || MAIN_I2C3 || P9.19 || P9.20 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_i2c/src/arm/BONE-I2C2.dts BONE-I2C2.dts] | ||
+ | |- | ||
+ | |- | ||
+ | !/dev/bone/i2c/2a !! bone_i2c_2a | ||
+ | | I2C2 || N/A || TBD || P9.21 || P9.22 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_i2c/src/arm/BONE-I2C2A.dts BONE-I2C2A.dts] | ||
+ | |- | ||
+ | |- | ||
+ | !/dev/bone/i2c/3 !! bone_i2c_3 | ||
+ | | I2C1 || I2C3 || MAIN_I2C4 || P9.24 || P9.26 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_i2c/src/arm/BONE-I2C3.dts BONE-I2C3.dts] | ||
+ | |- | ||
+ | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
= SPI = | = SPI = | ||
− | + | SPI bone bus nodes allow creating compatible overlays for BBBWl, BBB, & BBAI. For the definitions, you can see [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbai-bone-buses.dtsi#L406 bbai-bone-buses.dtsi#L406] & [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbb-bone-buses.dtsi#L423 bbb-bone-buses.dtsi#L423]. | |
− | == /dev/bone/spi/0.''x'' | + | {| class="wikitable" style="text-align: center;" |
− | https://github.com/ | + | |+ Bone bus SPI |
− | + | |- | |
− | + | ! Bone bus !! DT symbol !! BBBWL/BBB !! BBAI !! BBAI64 !! MOSI !! MISO !! CLK !! CS !! Overlay | |
− | * P9. | + | |- |
− | * P9. | + | !/dev/bone/spi/0.''x'' |
− | * | + | !bone_spi_0 |
+ | | SPI0 || SPI2 || MAIN_SPI6 || P9.18 || P9.21 || P9.22 | ||
+ | | | ||
+ | * P9.17 (CS0) | ||
+ | * P9.23 (CS1 - BBAI and BBAI64 only) | ||
+ | | | ||
+ | * [https://github.com/lorforlinux/bb.org-overlays/blob/bone_spi/src/arm/BONE-SPI0_0.dts BONE-SPI0_0.dts] | ||
+ | * [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BBAI-SPI0_1.dts BBAI-SPI0_1.dts] | ||
+ | |- | ||
+ | |- | ||
+ | !/dev/bone/spi/1.''x'' | ||
+ | !bone_spi_1 | ||
+ | | SPI1 || SPI3 || TBD || P9.30 || P9.29 || P9.31 | ||
+ | | | ||
+ | * P9.28 (CS0) | ||
+ | * P9.42 (CS1) | ||
+ | | | ||
+ | * [https://github.com/lorforlinux/bb.org-overlays/blob/bone_spi/src/arm/BONE-SPI1_0.dts BONE-SPI1_0.dts] | ||
+ | * [https://github.com/lorforlinux/bb.org-overlays/blob/bone_spi/src/arm/BONE-SPI1_1.dts BONE-SPI1_1.dts] | ||
+ | |- | ||
+ | |} | ||
− | |||
− | |||
− | |||
− | |||
− | == /dev/bone/ | + | = UART = |
− | https://github.com/ | + | UART bone bus nodes allow creating compatible overlays for BBBWl, BBB, & BBAI. For the definitions, you can see [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbai-bone-buses.dtsi#L367 bbai-bone-buses.dtsi#L367] & [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbb-bone-buses.dtsi#L382 bbb-bone-buses.dtsi#L382]. |
− | + | {| class="wikitable" style="text-align: center;" | |
− | + | |+ Bone bus UART | |
− | + | |- | |
− | + | ! Bone bus !! BBBWL/BBB !! BBAI !! BBAI64 !! TX !! RX !! RTSn !! CTSn !! Overlays | |
− | + | |- | |
+ | ! /dev/bone/uart/0 | ||
+ | | UART0 || UART1 || MAIN_UART0 | ||
+ | | colspan="5" style="text-align: center;" | ⌠(console debug header pins) | ||
+ | |- | ||
+ | ! /dev/bone/uart/1 | ||
+ | | UART1 || UART10 || MAIN_UART2 || P9.24 || P9.26 | ||
+ | | | ||
+ | * P9.19 | ||
+ | * P8.4 (''N/A'' on AM3358) | ||
+ | | | ||
+ | * P9.20 | ||
+ | * P8.3 (''N/A'' on AM3358) | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_uart/src/arm/BONE-UART1.dts BONE-UART1.dts] | ||
+ | |- | ||
− | + | |- | |
− | + | ! /dev/bone/uart/2 | |
− | AM5729 | + | | UART2 || UART3 || TBD || P9.21 || P9.22 |
− | * | + | | |
+ | * P8.38 (N/A on AM5729) | ||
+ | | | ||
+ | * P8.37 (N/A on AM5729) | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_uart/src/arm/BONE-UART2.dts BONE-UART2.dts] | ||
+ | |- | ||
− | + | |- | |
− | + | ! /dev/bone/uart/3 | |
− | + | | UART3 || ⌠|| TBD || P9.42 || ⌠| |
− | + | | ⌠| |
+ | | ⌠| ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_uart/src/arm/BONE-UART3.dts BONE-UART3.dts] | ||
+ | |- | ||
− | + | |- | |
− | AM3358 | + | ! /dev/bone/uart/4 |
− | AM5729 | + | | UART4 || UART5 || TBD || P9.13 || P9.11 |
− | * | + | | |
+ | * P8.33 (N/A on AM5729) | ||
+ | * P8.6 (N/A on AM3358) | ||
+ | | | ||
+ | * P8.35 (N/A on AM5729) | ||
+ | * P8.5 (N/A on AM3358) | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_uart/src/arm/BONE-UART4.dts BONE-UART4.dts] | ||
+ | |- | ||
− | + | |- | |
− | + | ! /dev/bone/uart/5 | |
− | + | | UART5 || UART8 || MAIN_UART5 || P8.37 || P8.38 | |
− | + | | P8.32 | |
− | + | | P8.31 | |
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_uart/src/arm/BONE-UART5.dts BONE-UART5.dts] | ||
+ | |- | ||
+ | |} | ||
− | == | + | = CAN = |
− | https://github.com/ | + | CAN bone bus nodes allow creating compatible overlays for BBBWl, BBB, & BBAI. For the definitions, you can see [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbai-bone-buses.dtsi#L440 bbai-bone-buses.dtsi#L440] & [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbb-bone-buses.dtsi#L457 bbb-bone-buses.dtsi#L457]. |
− | https://github.com/ | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == | + | {| class="wikitable" style="text-align: center;" |
− | + | |+ Bone bus CAN | |
− | https://github.com/ | + | |- |
− | + | <!-- ! Bone bus! --> | |
− | + | ! BBBWL/BBB !! BBAI !! TX !! RX !! Overlays | |
− | + | |- | |
− | + | <!-- !/dev/bone/can/0 --> | |
− | + | | CAN0 || ⌠|| P9.20 || P9.19 | |
− | + | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_can/src/arm/BONE-CAN0.dts BONE-CAN0.dts] | |
+ | |- | ||
− | + | |- | |
− | https://github.com/ | + | <!-- !/dev/bone/can/1 --> |
− | + | | CAN1 || CAN2 || P9.26 || P9.24 | |
− | + | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_can/src/arm/BONE-CAN1.dts BONE-CAN1.dts] | |
− | + | |- | |
− | + | |- | |
− | + | <!-- !/dev/bone/can/2 --> | |
− | + | | ⌠|| CAN1 (rev A2 and later) || P8.8 || P8.7 | |
− | + | | TODO | |
− | + | |- | |
− | |||
− | |||
− | |||
− | |||
− | + | |} | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | <!-- | |
=== /dev/bone/can/0 === | === /dev/bone/can/0 === | ||
+ | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/BB-CAN0-00A0.dts <br> | ||
AM3358 CAN0<br> | AM3358 CAN0<br> | ||
− | AM5729 N/A | + | AM5729 ''N/A'' |
* P9.19 - RX | * P9.19 - RX | ||
* P9.20 - TX | * P9.20 - TX | ||
=== /dev/bone/can/1 === | === /dev/bone/can/1 === | ||
+ | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/BB-CAN1-00A0.dts <br> | ||
AM3358 CAN1<br> | AM3358 CAN1<br> | ||
AM5729 CAN2 | AM5729 CAN2 | ||
* P9.24 - RX | * P9.24 - RX | ||
* P9.26 - TX | * P9.26 - TX | ||
+ | |||
+ | === /dev/bone/can/2 === | ||
+ | TODO <br> | ||
+ | AM3358 ''N/A''<br> | ||
+ | AM5729 CAN1 (AI rev A2 and later) | ||
+ | * P8.7 - proposed | ||
+ | * P8.8 - proposed | ||
+ | --> | ||
= ADC = | = ADC = | ||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ Bone ADC | ||
+ | |- | ||
+ | ! BBBWL/BBB !! BBAI !! overlay | ||
+ | |- | ||
+ | | Internal || External (STMPE811) | ||
+ | | [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BONE-ADC.dts BONE-ADC.dts] | ||
+ | |} | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |- | ||
+ | ! Index !! Header pin !! BBBWL/BBB !! BBAI | ||
+ | |- | ||
+ | ! 0 | ||
+ | | P9_39 || in_voltage0_raw || in_voltage0_raw | ||
+ | |- | ||
+ | ! 1 | ||
+ | | P9_40 || in_voltage1_raw || in_voltage1_raw | ||
+ | |- | ||
+ | ! 2 | ||
+ | | P9_37 || in_voltage2_raw || in_voltage3_raw | ||
+ | |- | ||
+ | ! 3 | ||
+ | | P9_38 || in_voltage3_raw || in_voltage2_raw | ||
+ | |- | ||
+ | ! 4 | ||
+ | | P9_33 || in_voltage4_raw || in_voltage7_raw | ||
+ | |- | ||
+ | ! 5 | ||
+ | | P9_36 || in_voltage5_raw || in_voltage6_raw | ||
+ | |- | ||
+ | ! 6 | ||
+ | | P9_35 || in_voltage6_raw || in_voltage4_raw | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | <!-- | ||
Work needs to be done to create these symlinks as well as handle major differences in the driver used for the ADC. Maybe just have the "okay" in here and more in the base tree? | Work needs to be done to create these symlinks as well as handle major differences in the driver used for the ADC. Maybe just have the "okay" in here and more in the base tree? | ||
=== /dev/bone/adc/''n'' === | === /dev/bone/adc/''n'' === | ||
− | https:// | + | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/BB-ADC-00A0.dts <br> |
* 0 - AM3358 in_voltage0_raw, AM5729 in_voltage0_raw | * 0 - AM3358 in_voltage0_raw, AM5729 in_voltage0_raw | ||
* 1 - AM3358 in_voltage1_raw, AM5729 in_voltage1_raw | * 1 - AM3358 in_voltage1_raw, AM5729 in_voltage1_raw | ||
Line 169: | Line 568: | ||
* 5 - AM3358 in_voltage5_raw, AM5729 in_voltage6_raw | * 5 - AM3358 in_voltage5_raw, AM5729 in_voltage6_raw | ||
* 6 - AM3358 in_voltage6_raw, AM5729 in_voltage4_raw | * 6 - AM3358 in_voltage6_raw, AM5729 in_voltage4_raw | ||
+ | --> | ||
+ | |||
+ | = PWM = | ||
+ | PWM bone bus nodes allow creating compatible overlays for BBBWl, BBB, & BBAI. For the definitions, you can see [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbai-bone-buses.dtsi#L415 bbai-bone-buses.dtsi#L415] & [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbb-bone-buses.dtsi#L432 bbb-bone-buses.dtsi#L432] | ||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ Bone bus PWM | ||
+ | |- | ||
+ | ! Bone bus !! BBBWL/BBB !! BBAI !! A !! B !! Overlay | ||
+ | |- | ||
+ | !/dev/bone/pwm/0 | ||
+ | | PWM0 || ⌠|| P9.22 || P9.21 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_pwm/src/arm/BONE-PWM0.dts BONE-PWM0.dts] | ||
+ | |- | ||
+ | |||
+ | |- | ||
+ | !/dev/bone/pwm/1 | ||
+ | | PWM1 || PWM3 || P9.14 || P9.16 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_pwm/src/arm/BONE-PWM1.dts BONE-PWM1.dts] | ||
+ | |- | ||
+ | |||
+ | |- | ||
+ | !/dev/bone/pwm/2 | ||
+ | | PWM2 || PWM2 || P8.19 || P8.13 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_pwm/src/arm/BONE-PWM2.dts BONE-PWM2.dts] | ||
+ | |- | ||
+ | |||
+ | |} | ||
+ | |||
+ | = TIMER PWM= | ||
+ | TIMER PWM bone bus uses ti,omap-dmtimer-pwm driver, and timer nodes that allow creating compatible overlays for BBBWl, BBB, & BBAI. For the timer node definitions, you can see [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbai-bone-buses.dtsi#L449 bbai-bone-buses.dtsi#L449] & [https://github.com/lorforlinux/BeagleBoard-DeviceTrees/blob/97a6f0daa9eab09633a2064f68a53b107d6e3968/src/arm/bbb-bone-buses.dtsi#L466 bbb-bone-buses.dtsi#L466]. | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ Bone TIMER PWMs | ||
+ | |- | ||
+ | ! Bone bus !! Header pin !! BBBWL/BBB !! BBAI !! overlay | ||
+ | |- | ||
+ | ! /sys/bus/platform/devices/bone_timer_pwm_0/ | ||
+ | | P8.10 || timer6 || timer10 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_timer/src/arm/BONE-TIMER_PWM_0.dts BONE-TIMER_PWM_0.dts] | ||
+ | |- | ||
+ | ! /sys/bus/platform/devices/bone_timer_pwm_1/ | ||
+ | | P8.07 || timer4 || timer11 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_timer/src/arm/BONE-TIMER_PWM_1.dts BONE-TIMER_PWM_1.dts] | ||
+ | |- | ||
+ | ! /sys/bus/platform/devices/bone_timer_pwm_2/ | ||
+ | | P8.08 || timer7 || timer12 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_timer/src/arm/BONE-TIMER_PWM_2.dts BONE-TIMER_PWM_2.dts] | ||
+ | |- | ||
+ | ! /sys/bus/platform/devices/bone_timer_pwm_3/ | ||
+ | | P9.21 || ⌠|| timer13 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_timer/src/arm/BONE-TIMER_PWM_3.dts BONE-TIMER_PWM_3.dts] | ||
+ | |- | ||
+ | ! /sys/bus/platform/devices/bone_timer_pwm_4/ | ||
+ | | P8.09 || timer5 || timer14 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_timer/src/arm/BONE-TIMER_PWM_4.dts BONE-TIMER_PWM_4.dts] | ||
+ | |- | ||
+ | ! /sys/bus/platform/devices/bone_timer_pwm_5/ | ||
+ | | P9.22 || ⌠|| timer15 | ||
+ | | [https://github.com/lorforlinux/bb.org-overlays/blob/bone_timer/src/arm/BONE-TIMER_PWM_5.dts BONE-TIMER_PWM_5.dts] | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | = eCAP = | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ BBBWL/BBB eCAP PWMs | ||
+ | |- | ||
+ | ! Bone bus !! Header pin !! peripheral !! overlay | ||
+ | |- | ||
+ | ! /sys/bus/platform/drivers/ecap/48302100.ecap | ||
+ | | P9.42 || eCAP0_in_PWM0_out | ||
+ | | [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BBB-ECAP0.dts BBB-ECAP0.dts] | ||
+ | |- | ||
+ | ! /sys/bus/platform/drivers/ecap/48304100.ecap | ||
+ | | P9.28 || eCAP2_in_PWM2_out | ||
+ | | [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BBB-ECAP2.dts BBB-ECAP2.dts] | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ BBAI eCAP PWMs | ||
+ | |- | ||
+ | ! Bone bus !! Header pin !! peripheral !! overlay | ||
+ | |- | ||
+ | ! /sys/bus/platform/drivers/ecap/4843e100.ecap | ||
+ | | P8.15 || eCAP1_in_PWM1_out | ||
+ | | [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BBAI-ECAP1.dts BBAI-ECAP1.dts] | ||
+ | |- | ||
+ | ! /sys/bus/platform/drivers/ecap/48440100.ecap | ||
+ | | P8.14 || eCAP2_in_PWM2_out | ||
+ | | [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BBAI-ECAP2.dts BBAI-ECAP2.dts] | ||
+ | |- | ||
+ | ! /sys/bus/platform/drivers/ecap/48440100.ecap | ||
+ | | P8.20 || eCAP2_in_PWM2_out | ||
+ | | [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BBAI-ECAP2A.dts BBAI-ECAP2A.dts] | ||
+ | |- | ||
+ | ! /sys/bus/platform/drivers/ecap/48442100.ecap | ||
+ | | P8.04 || eCAP3_in_PWM3_out | ||
+ | | [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BBAI-ECAP3.dts BBAI-ECAP3.dts] | ||
+ | |- | ||
+ | ! /sys/bus/platform/drivers/ecap/48442100.ecap | ||
+ | | P8.26 || eCAP3_in_PWM3_out | ||
+ | | [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BBAI-ECAP3A.dts BBAI-ECAP3A.dts] | ||
+ | |- | ||
+ | |} | ||
− | + | <!-- | |
=== /dev/bone/pwm/0 === | === /dev/bone/pwm/0 === | ||
− | https:// | + | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/BB-PWM0-00A0.dts <br> |
AM3358 PWM0<br> | AM3358 PWM0<br> | ||
AM5729 TIMER13/TIMER15 | AM5729 TIMER13/TIMER15 | ||
Line 179: | Line 683: | ||
=== /dev/bone/pwm/1 === | === /dev/bone/pwm/1 === | ||
− | https:// | + | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/BB-PWM1-00A0.dts <br> |
AM3358 PWM1<br> | AM3358 PWM1<br> | ||
AM5279 PWM3 | AM5279 PWM3 | ||
Line 186: | Line 690: | ||
=== /dev/bone/pwm/2 === | === /dev/bone/pwm/2 === | ||
− | https:// | + | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/BB-PWM2-00A0.dts <br> |
AM3358 PWM2<br> | AM3358 PWM2<br> | ||
AM5729 PWM2 | AM5729 PWM2 | ||
* P8.19 - A | * P8.19 - A | ||
* P8.13 - B | * P8.13 - B | ||
+ | |||
=== /dev/bone/timer/4 === | === /dev/bone/timer/4 === | ||
− | https:// | + | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/BB-PWM-TIMER-P8.07.dts <br> |
AM3358 TIMER4<br> | AM3358 TIMER4<br> | ||
AM5729 TIMER11 | AM5729 TIMER11 | ||
Line 199: | Line 704: | ||
=== /dev/bone/timer/5 === | === /dev/bone/timer/5 === | ||
− | https:// | + | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/BB-PWM-TIMER-P8.09.dts <br> |
AM3358 TIMER5<br> | AM3358 TIMER5<br> | ||
AM5729 TIMER14 | AM5729 TIMER14 | ||
Line 205: | Line 710: | ||
=== /dev/bone/timer/6 === | === /dev/bone/timer/6 === | ||
− | https:// | + | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/BB-PWM-TIMER-P8.10.dts <br> |
AM3358 TIMER6<br> | AM3358 TIMER6<br> | ||
AM5729 TIMER10 | AM5729 TIMER10 | ||
Line 211: | Line 716: | ||
=== /dev/bone/timer/7 === | === /dev/bone/timer/7 === | ||
− | https:// | + | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/BB-PWM-TIMER-P8.08.dts <br> |
AM3358 TIMER7<br> | AM3358 TIMER7<br> | ||
AM5729 TIMER12 | AM5729 TIMER12 | ||
* P8.8 | * P8.8 | ||
− | = | + | |
+ | === /dev/bone/ecap/1 === | ||
+ | TODO<br> | ||
+ | AM3358 ''N/A''<br> | ||
+ | AM5729 eCAP1_in_PWM1_out | ||
+ | * P8.15 | ||
+ | |||
+ | === /dev/bone/ecap/2 === | ||
+ | TODO<br> | ||
+ | AM3358 ''N/A''<br> | ||
+ | AM5729 eCAP2_in_PWM2_out | ||
+ | * P8.14 | ||
+ | |||
+ | === /dev/bone/ecap/3 === | ||
+ | TODO<br> | ||
+ | AM3358 ''N/A''<br> | ||
+ | AM5729 eCAP3_in_PWM3_out | ||
+ | * P8.04 | ||
+ | --> | ||
+ | |||
+ | = eMMC = | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ Bone eMMC | ||
+ | |- | ||
+ | ! BBBWL/BBB !! BBAI !! overlay | ||
+ | |- | ||
+ | | MMC2 || MMC3 || [https://git.beagleboard.org/beagleboard/BeagleBoard-DeviceTrees/blob/v4.19.x-ti-overlays/src/arm/overlays/BONE-eMMC.dts BONE-eMMC.dts] | ||
+ | |} | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |- | ||
+ | ! Header pin !! Description | ||
+ | |- | ||
+ | | P8.3 || DAT6 | ||
+ | |- | ||
+ | | P8.4 || DAT7 | ||
+ | |- | ||
+ | | P8.5 || DAT2 | ||
+ | |- | ||
+ | | P8.6 || DAT3 | ||
+ | |- | ||
+ | | P8.20 || CMD | ||
+ | |- | ||
+ | | P8.21 || CLK | ||
+ | |- | ||
+ | | P8.22 || DAT5 | ||
+ | |- | ||
+ | | P8.23 || DAT4 | ||
+ | |- | ||
+ | | P8.24 || DAT1 | ||
+ | |- | ||
+ | | P8.25 || DAT0 | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | <!-- | ||
=== /dev/bone/mmc/2 === | === /dev/bone/mmc/2 === | ||
TODO: need overlay. Note: On Black, this is used by the on-board eMMC. On AI, these pins are available.<br> | TODO: need overlay. Note: On Black, this is used by the on-board eMMC. On AI, these pins are available.<br> | ||
Line 231: | Line 792: | ||
* P8.4 - DAT7 | * P8.4 - DAT7 | ||
* P8.3 - DAT6 | * P8.3 - DAT6 | ||
+ | --> | ||
= LCD = | = LCD = | ||
− | + | {| class="wikitable" style="text-align: center;" | |
+ | |+ 16bit LCD interface | ||
+ | |- | ||
+ | ! BBBWL/BBB !! BBAI !! overlay | ||
+ | |- | ||
+ | | lcdc || dss || | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |- | ||
+ | ! Header pin !! Description | ||
+ | |- | ||
+ | |P8_45 || lcd_data0 | ||
+ | |- | ||
+ | |P8_46 || lcd_data1 | ||
+ | |- | ||
+ | |P8_43 || lcd_data2 | ||
+ | |- | ||
+ | |P8_44 || lcd_data3 | ||
+ | |- | ||
+ | |P8_41 || lcd_data4 | ||
+ | |- | ||
+ | |P8_42 || lcd_data5 | ||
+ | |- | ||
+ | |P8_39 || lcd_data6 | ||
+ | |- | ||
+ | |P8_40 || lcd_data7 | ||
+ | |- | ||
+ | |P8_37 || lcd_data8 | ||
+ | |- | ||
+ | |P8_38 || lcd_data9 | ||
+ | |- | ||
+ | |P8_36 || lcd_data10 | ||
+ | |- | ||
+ | |P8_34 || lcd_data11 | ||
+ | |- | ||
+ | |P8_35 || lcd_data12 | ||
+ | |- | ||
+ | |P8_33 || lcd_data13 | ||
+ | |- | ||
+ | |P8_31 || lcd_data14 | ||
+ | |- | ||
+ | |P8_32 || lcd_data15 | ||
+ | |- | ||
+ | |P8_27 || lcd_vsync | ||
+ | |- | ||
+ | |P8_29 || lcd_hsync | ||
+ | |- | ||
+ | |P8_28 || lcd_pclk | ||
+ | |- | ||
+ | |P8_30 || lcd_ac_bias_en | ||
+ | |- | ||
+ | |} | ||
= eQEP = | = eQEP = | ||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ Bone eQEP | ||
+ | |- | ||
+ | ! Bone bus !! BBBWL/BBB !! BBAI !! A !! B !! strobe !! index !! overlay | ||
+ | |- | ||
+ | ! /bone/eQEP0 | ||
+ | | eQEP0 || eQEP2 || P9.42 || P9.27 | ||
+ | || | ||
+ | * BBB: P9.25 | ||
+ | * BBAI: P8.06 | ||
+ | || | ||
+ | * BBB: P9.41 | ||
+ | * BBAI: P8.05 | ||
+ | | | ||
+ | |- | ||
+ | |||
+ | |- | ||
+ | ! /bone/eQEP1 | ||
+ | | eQEP1 || eQEP0 || P8.35 || P8.33 | ||
+ | || | ||
+ | * BBB: P8.32 | ||
+ | * BBAI: P9.21 | ||
+ | || | ||
+ | * BBB: P8.31 | ||
+ | * BBAI: ⌠| ||
+ | | | ||
+ | |- | ||
+ | |||
+ | |- | ||
+ | ! /bone/eQEP2 | ||
+ | | eQEP2 || eQEP1 || P8.12 || P8.22 | ||
+ | || | ||
+ | * BBB: P8.15 | ||
+ | * BBAI: P8.18 | ||
+ | || | ||
+ | * BBB: P8.16 | ||
+ | * BBAI: P9.15 | ||
+ | | | ||
+ | |- | ||
+ | |||
+ | |- | ||
+ | ! /bone/eQEP2A | ||
+ | | eQEP2 || ⌠|| P8.41 || P8.42 || P8.40 || P8.39 | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | <!-- | ||
=== /dev/bone/eqep/0 === | === /dev/bone/eqep/0 === | ||
− | https:// | + | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/bone_eqep0-00A0.dts <br> |
AM3358 eQEP0<br> | AM3358 eQEP0<br> | ||
AM5729 eQEP3 | AM5729 eQEP3 | ||
Line 243: | Line 905: | ||
* P9.27 - B | * P9.27 - B | ||
* P9.25 - STROBE (''N/A'' on AI) | * P9.25 - STROBE (''N/A'' on AI) | ||
− | * P9.41 - | + | * P9.41 - INDEX (''N/A'' on AI) |
+ | * P8.6 - STROBE (''N/A'' on AM3358) | ||
+ | * P8.5 - INDEX (''N/A'' on AM3358) | ||
=== /dev/bone/eqep/1 === | === /dev/bone/eqep/1 === | ||
+ | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/bone_eqep1-00A0.dts <br> | ||
AM3358 eQEP1<br> | AM3358 eQEP1<br> | ||
AM5729 eQEP1 | AM5729 eQEP1 | ||
* P8.34 - A | * P8.34 - A | ||
* P8.36 - B | * P8.36 - B | ||
+ | * P9.21 - STROBE (''N/A'' on AM3358) | ||
=== /dev/bone/eqep/2 === | === /dev/bone/eqep/2 === | ||
+ | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/bone_eqep2b-00A0.dts <br> | ||
AM3358 eQEP2<br> | AM3358 eQEP2<br> | ||
AM5729 eQEP2 | AM5729 eQEP2 | ||
* P8.12 - A | * P8.12 - A | ||
* P8.11 - B | * P8.11 - B | ||
+ | * P8.15 - STROBE on AM3358 only | ||
+ | * P8.18 - STROBE on AM5729 only | ||
+ | * P8.16 - INDEX on AM3358 only | ||
+ | * P9.15 - INDEX on AM5729 only | ||
+ | |||
+ | === /dev/bone/eqep/2a === | ||
+ | https://git.beagleboard.org/beagleboard/bb.org-overlays/blob/master/src/arm/bone_eqep2-00A0.dts <br> | ||
+ | AM3358 eQEP2<br> | ||
+ | AM5729 ''N/A' | ||
+ | * P8.41 - A | ||
+ | * P8.42 - B | ||
+ | * P8.40 - STROBE | ||
+ | * P8.39 - INDEX | ||
+ | --> | ||
= McASP = | = McASP = | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ Bone McASP0 | ||
+ | |- | ||
+ | ! BBBWL/BBB !! BBAI !! overlay | ||
+ | |- | ||
+ | | McASP0 || McASP1 || | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |- | ||
+ | ! Header pin !! Description | ||
+ | |- | ||
+ | | P9.12 || aclkr | ||
+ | |- | ||
+ | | P9.25 || ahclkx | ||
+ | |- | ||
+ | | P9.27 || fsr | ||
+ | |- | ||
+ | | P9.28 || | ||
+ | * BBB: axr2 | ||
+ | * BBAI: axr9 | ||
+ | |- | ||
+ | | P9.29 || fsx | ||
+ | |- | ||
+ | | P9.30 || | ||
+ | * BBB: axr0 | ||
+ | * BBAI: axr10 | ||
+ | |- | ||
+ | | P9.31 || aclkx | ||
+ | |- | ||
+ | |} | ||
= PRU = | = PRU = | ||
+ | The overlay situation for PRUs is a bit more complex than with other peripherals. The mechanism for loading, starting and stopping the PRUs can go through either [https://www.kernel.org/doc/html/latest/driver-api/uio-howto.html UIO] or [https://software-dl.ti.com/processor-sdk-linux/esd/docs/latest/linux/Foundational_Components/PRU-ICSS/Linux_Drivers/RemoteProc_and_RPMsg.html RemoteProc]. | ||
+ | |||
+ | * /dev/remoteproc/prussX-coreY (AM3358 X = "", other x = "1|2") | ||
+ | |||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ Bone PRU eCAP | ||
+ | |- | ||
+ | ! Header Pin !! BBBWL/BBB !! BBAI | ||
+ | |- | ||
+ | | P8.15 || pr1_ecap0 || pr1_ecap0 | ||
+ | |- | ||
+ | | P8.32 || ⌠|| pr2_ecap0 | ||
+ | |- | ||
+ | | P9.42 || pr1_ecap0 || ⌠| ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ BBAI PRU UART | ||
+ | |- | ||
+ | ! UART || TX !! RX !! RTSn !! CTSn !! Overlays | ||
+ | |- | ||
+ | ! PRU1 UART0 | ||
+ | | P8_31 || P8_33 || P8_34 || P8_35 | ||
+ | | | ||
+ | |- | ||
+ | |||
+ | |- | ||
+ | ! PRU2 UART0 | ||
+ | | P8_43 || P8_44 || P8_45 || P8_46 | ||
+ | | | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | {| class="wikitable" style="text-align: center;" | ||
+ | |+ Bone PRU | ||
+ | |- | ||
+ | ! Header Pin !! BBBWL/BBB !! BBAI | ||
+ | |- | ||
+ | | P8.03 || ⌠|| pr2_pru0 10 | ||
+ | |- | ||
+ | | P8.04 || ⌠|| pr2_pru0 11 | ||
+ | |- | ||
+ | | P8.05 || ⌠|| pr2_pru0 06 | ||
+ | |- | ||
+ | | P8.06 || ⌠|| pr2_pru0 07 | ||
+ | |- | ||
+ | | P8.07 || ⌠|| pr2_pru1 16 | ||
+ | |- | ||
+ | | P8.08 || ⌠|| pr2_pru0 20 | ||
+ | |- | ||
+ | | P8.09 || ⌠|| pr2_pru1 06 | ||
+ | |- | ||
+ | | P8.10 || ⌠|| pr2_pru1 15 | ||
+ | |- | ||
+ | | P8.11 || pr1_pru0 15 (Out) || pr1_pru0 04 | ||
+ | |- | ||
+ | | P8.12 || pr1_pru0 14 (Out) || pr1_pru0 03 | ||
+ | |- | ||
+ | | P8.13 || ⌠|| pr1_pru1 07 | ||
+ | |- | ||
+ | | P8.14 || ⌠|| pr1_pru1 09 | ||
+ | |- | ||
+ | | P8.15 || pr1_pru0 15 (In) || pr1_pru1 16 | ||
+ | |- | ||
+ | | P8.16 || pr1_pru0 14 (In) || pr1_pru1 18 | ||
+ | |- | ||
+ | | P8.17 || ⌠|| pr2_pru0 15 | ||
+ | |- | ||
+ | | P8.18 || ⌠|| pr1_pru1 05 | ||
+ | |- | ||
+ | | P8.19 || ⌠|| pr1_pru1 06 | ||
+ | |- | ||
+ | | P8.20 || ⌠|| pr2_pru0 03 | ||
+ | |- | ||
+ | | P8.21 || ⌠|| pr2_pru0 02 | ||
+ | |- | ||
+ | | P8.22 || ⌠|| pr2_pru0 09 | ||
+ | |- | ||
+ | | P8.23 || ⌠|| pr2_pru0 08 | ||
+ | |- | ||
+ | | P8.24 || ⌠|| pr2_pru0 05 | ||
+ | |- | ||
+ | | P8.25 || ⌠|| pr2_pru0 04 | ||
+ | |- | ||
+ | | P8.26 || ⌠|| pr1_pru1 17 | ||
+ | |- | ||
+ | | P8.27 || ⌠|| pr2_pru1 17 | ||
+ | |- | ||
+ | | P8.28 || ⌠|| pr2_pru0 17 | ||
+ | |- | ||
+ | | P8.29 || ⌠|| pr2_pru0 18 | ||
+ | |- | ||
+ | | P8.30 || ⌠|| pr2_pru0 19 | ||
+ | |- | ||
+ | | P8.31 || ⌠|| pr2_pru0 11 | ||
+ | |- | ||
+ | | P8.32 || ⌠|| pr2_pru1 00 | ||
+ | |- | ||
+ | | P8.33 || ⌠|| pr2_pru0 10 | ||
+ | |- | ||
+ | | P8.34 || ⌠|| pr2_pru0 08 | ||
+ | |- | ||
+ | | P8.35 || ⌠|| pr2_pru0 09 | ||
+ | |- | ||
+ | | P8.36 || ⌠|| pr2_pru0 07 | ||
+ | |- | ||
+ | | P8.37 || ⌠|| pr2_pru0 05 | ||
+ | |- | ||
+ | | P8.38 || ⌠|| pr2_pru0 06 | ||
+ | |- | ||
+ | | P8.39 || ⌠|| pr2_pru0 03 | ||
+ | |- | ||
+ | | P8.40 || ⌠|| pr2_pru0 04 | ||
+ | |- | ||
+ | | P8.41 || ⌠|| pr2_pru0 01 | ||
+ | |- | ||
+ | | P8.42 || ⌠|| pr2_pru0 02 | ||
+ | |- | ||
+ | | P8.43 || ⌠|| pr2_pru1 20 | ||
+ | |- | ||
+ | | P8.44 || ⌠|| pr2_pru0 00 | ||
+ | |- | ||
+ | | P8.45 || ⌠|| pr2_pru1 18 | ||
+ | |- | ||
+ | | P8.46 || ⌠|| pr2_pru1 19 | ||
+ | |- | ||
+ | | P9.11 || ⌠|| pr2_pru0 14 | ||
+ | |- | ||
+ | | P9.13 || ⌠|| pr2_pru0 15 | ||
+ | |- | ||
+ | | P9.14 || ⌠|| pr1_pru1 14 | ||
+ | |- | ||
+ | | P9.15 || ⌠|| pr1_pru0 5 | ||
+ | |- | ||
+ | | P9.16 || ⌠|| pr1_pru1 15 | ||
+ | |- | ||
+ | | P9.17 || ⌠|| pr2_pru1 09 | ||
+ | |- | ||
+ | | P9.18 || ⌠|| pr2_pru1 08 | ||
+ | |- | ||
+ | | P9.19 || ⌠|| pr1_pru1 02 | ||
+ | |- | ||
+ | | P9.20 || ⌠|| pr1_pru1 01 | ||
+ | |- | ||
+ | | P9.24 || pr1_pru0 16 (In) || ⌠| ||
+ | |- | ||
+ | | P9.25 || pr1_pru0 07 || pr2_pru1 05 | ||
+ | |- | ||
+ | | P9.26 || pr1_pru1 16 (In) || pr1_pru0 17 | ||
+ | |- | ||
+ | | P9.27 || pr1_pru0 05 || pr1_pru1 11 | ||
+ | |- | ||
+ | | P9.28 || pr1_pru0 03 || pr2_pru1 13 | ||
+ | |- | ||
+ | | P9.29 || pr1_pru0 01 || pr2_pru1 11 | ||
+ | |- | ||
+ | | P9.30 || pr1_pru0 02 || pr2_pru1 12 | ||
+ | |- | ||
+ | | P9.31 || pr1_pru0 00 || pr2_pru1 10 | ||
+ | |- | ||
+ | | P9.41 || pr1_pru0 06 || pr1_pru1 03 | ||
+ | |- | ||
+ | | P9.42 || pr1_pru0 04 || pr1_pru1 10 | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | <!-- | ||
=== /dev/bone/pru/0.0 === | === /dev/bone/pru/0.0 === | ||
+ | TODO<br> | ||
AM3358 PRU0<br> | AM3358 PRU0<br> | ||
AM5729 PRUSS1, PRU0 | AM5729 PRUSS1, PRU0 | ||
− | + | {| class="wikitable" | |
− | + | |- | |
− | + | ! PIN !! AM3358 !! AM5729 | |
− | + | |- | |
− | + | | P8.11 || out 15 || I/O 4 | |
− | + | |- | |
− | + | | P8.12 || out 14 || I/O 3 | |
− | + | |- | |
− | + | | P8.15 || in 15 || see [[#/dev/bone/pru/0.1|pru/0.1]] | |
− | + | |- | |
− | + | | P8.16 || in 14 || see [[#/dev/bone/pru/0.1|pru/0.1]] | |
+ | |- | ||
+ | | P8.17 || - || I/O 15 | ||
+ | |- | ||
+ | | P9.15 || - || I/O 5 | ||
+ | |- | ||
+ | | P9.24 || in 16 || - | ||
+ | |- | ||
+ | | P9.25 || I/O 7 || see [[#/dev/bone/pru/1.1|pru/1.1]] | ||
+ | |- | ||
+ | | P9.26 || see [[#/dev/bone/pru/0.1|pru0.1]] || I/O 17 | ||
+ | |- | ||
+ | | P9.27 || I/O 5 || see [[#/dev/bone/pru/0.1|pru/0.1]] | ||
+ | |- | ||
+ | | P9.28 || I/O 3 || see [[#/dev/bone/pru/1.1|pru/1.1]] | ||
+ | |- | ||
+ | | P9.29 || I/O 1 || see [[#/dev/bone/pru/1.1|pru/1.1]] | ||
+ | |- | ||
+ | | P9.30 || I/O 2 || see [[#/dev/bone/pru/1.1|pru/1.1]] | ||
+ | |- | ||
+ | | P9.31 || I/O 0 || see [[#/dev/bone/pru/1.1|pru/1.1]] | ||
+ | |- | ||
+ | | P9.41 || I/O 6 || see [[#/dev/bone/pru/0.1|pru/0.1]] | ||
+ | |- | ||
+ | | P9.42 || I/O 4 || see [[#/dev/bone/pru/1.1|pru/1.1]] or [[#/deb/bone/pru/2.0|pru/2.0]] | ||
+ | |- | ||
+ | | USR0 || - || I/O 10 | ||
+ | |- | ||
+ | | USR2 || - || I/O 8 | ||
+ | |- | ||
+ | | USR3 || - || I/O 7 | ||
+ | |- | ||
+ | | USR4 || - || I/O 0 | ||
+ | |} | ||
=== /dev/bone/pru/0.1 === | === /dev/bone/pru/0.1 === | ||
+ | TODO<br> | ||
AM3358 PRU1<br> | AM3358 PRU1<br> | ||
AM5279 PRUSS1, PRU1 | AM5279 PRUSS1, PRU1 | ||
− | + | {| class="wikitable" | |
+ | |- | ||
+ | ! PIN !! AM3358 !! AM5729 | ||
+ | |- | ||
+ | | P8.13 || - || I/O 7 | ||
+ | |- | ||
+ | | P8.14 || - || I/O 9 | ||
+ | |- | ||
+ | | P8.15 || - || I/O 16 | ||
+ | |- | ||
+ | | P8.16 || - || I/O 18 | ||
+ | |} | ||
=== /dev/bone/pru/1.0 === | === /dev/bone/pru/1.0 === | ||
+ | TODO<br> | ||
AM3358 ''N/A''<br> | AM3358 ''N/A''<br> | ||
AM5729 PRUSS2, PRU0 | AM5729 PRUSS2, PRU0 | ||
− | * | + | * P8.3 - I/O 10 (''N/A'' on AM3358) |
+ | * P8.4 - I/O 11 (''N/A'' on AM3358) | ||
+ | * P8.5 - I/O 5 (''N/A'' on AM3358) | ||
+ | * P8.6 - I/O 7 (''N/A'' on AM3358) | ||
+ | * P8.8 - I/O 20 (''N/A'' on AM3358) | ||
=== /dev/bone/pru/1.1 === | === /dev/bone/pru/1.1 === | ||
+ | TODO<br> | ||
AM3358 ''N/A''<br> | AM3358 ''N/A''<br> | ||
AM5729 PRUSS2, PRU1 | AM5729 PRUSS2, PRU1 | ||
− | * | + | * P8.7 - I/O 16 (''N/A'' on AM3358) |
+ | * P8.9 - I/O 6 (''N/A'' on AM3358) | ||
+ | * P8.10 - I/O 15 (''N/A'' on AM3358) | ||
+ | --> | ||
= GPIO = | = GPIO = | ||
+ | TODO<br> | ||
+ | For each of the pins with a GPIO, there should be a symlink that comes from the names | ||
* | * | ||
= Methodology = | = Methodology = | ||
+ | The methodology for applied in the kernel and software images to expose the software interfaces is to be documented here. The most fundamental elements are the device tree entries, including overlays, and udev rules. | ||
+ | |||
+ | == Device Trees == | ||
− | == udev rules <ref>[https:// | + | == udev rules <ref>[https://git.beagleboard.org/beagleboard/customizations/tree/master/etc/udev/rules.d BeagleBoard customizations udev rules]</ref>== |
===10-of-symlink.rules<ref>[https://github.com/rcn-ee/repos/blob/master/bb-customizations/suite/stretch/debian/10-of-symlink.rules 10-of-symlink.rules]</ref>=== | ===10-of-symlink.rules<ref>[https://github.com/rcn-ee/repos/blob/master/bb-customizations/suite/stretch/debian/10-of-symlink.rules 10-of-symlink.rules]</ref>=== | ||
Line 314: | Line 1,257: | ||
# create symlinks for gpios exported to sysfs by DT | # create symlinks for gpios exported to sysfs by DT | ||
SUBSYSTEM=="gpio", ACTION=="add", TEST=="value", ATTR{label}!="sysfs", \ | SUBSYSTEM=="gpio", ACTION=="add", TEST=="value", ATTR{label}!="sysfs", \ | ||
− | RUN+="/bin/mkdir -p /dev/gpio", \ | + | RUN+="/bin/mkdir -p /dev/bone/gpio", \ |
− | RUN+="/bin/ln -sT '/sys/class/gpio/%k' /dev/gpio/%s{label}" | + | RUN+="/bin/ln -sT '/sys/class/gpio/%k' /dev/bone/gpio/%s{label}" |
</pre> | </pre> | ||
+ | |||
+ | = Verification = | ||
+ | TODO: The steps used to verify all of these configurations is to be documented here. It will serve to document what has been tested, how to reproduce the configurations, and how to verify each major triannual release. All faults will be documented in the issue tracker. | ||
= References = | = References = | ||
<references /> | <references /> |
Latest revision as of 19:51, 13 June 2022
See the blog post on BeagleBoard.org for an introduction.[1]
This is a list of symlink interfaces based on BeagleBone Cape header pins.[2][3][4]
Contents
Overall
P9 | P8 | |||||||
---|---|---|---|---|---|---|---|---|
Functions | odd | even | Functions | Functions | odd | even | Functions | |
USB D+ | E1 | E2 | USB D- | - | - | - | - | |
5V OUT | E3 | E4 | GND | - | - | - | - | |
GND | 1 | 2 | GND | GND | 1 | 2 | GND | |
3V3 OUT | 3 | 4 | 3V3 OUT | D M | 3 | 4 | D M | |
5V IN | 5 | 6 | 5V IN | D M | 5 | 6 | D M | |
5V OUT | 7 | 8 | 5V OUT | D | 7 | 8 | D | |
PWR BUT | 9 | 10 | RESET | D | 9 | 10 | D | |
D U4 | 11 | 12 | D | D | 11 | 12 | D | |
D U4 | 13 | 14 | D E | D E | 13 | 14 | D | |
D | 15 | 16 | D E | D | 15 | 16 | D | |
D I1 S0 | 17 | 18 | D I1 S0 | D | 17 | 18 | D | |
D I2 | 19 | 20 | D I2 | D E | 19 | 20 | D M P1 | |
D E S0 U2 | 21 | 22 | D E S0 U2 | D M P1 | 21 | 22 | D M | |
D | 23 | 24 | D I U1 | D M | 23 | 24 | D M | |
D P0 | 25 | 26 | D I U1 | D M | 25 | 26 | D | |
D P0 | 27 | 28 | D P0 S1 | D L P1 | 27 | 28 | D L P1 | |
D E S1 P0 | 29 | 30 | D P0 S1 | D L P1 | 29 | 30 | D L P1 | |
D E S1 P0 | 31 | 32 | ADC VDD | D L | 31 | 32 | D L | |
A | 33 | 34 | ADC GND | D L | 33 | 34 | D E L | |
A | 35 | 36 | A | D L | 35 | 36 | D E L | |
A | 37 | 38 | A | D L U5 | 37 | 38 | D L U5 | |
A | 39 | 40 | A | D L P1 | 39 | 40 | D L P1 | |
D | 41 | 42 | D | D L P1 | 41 | 42 | D L P1 | |
GND | 43 | 44 | GND | D L P1 | 43 | 44 | D L P1 | |
GND | 45 | 46 | GND | D E L P1 | 45 | 46 | D E L P1 |
- A: ADC
- C: CAN
- D: Digital GPIO
- E: EHRPWM
- I: I2C
- L: LCD
- M: MMC/SDIO
- P: PRU
- Q: eQEP
- S: SPI
- U: UART
LEDs
The compatibility layer comes with simple reference nodes for attaching LEDs to any gpio pin. The format followed for these nodes is led_P8_## / led_P9_##. The gpio-leds driver is used by these reference nodes internally and allows users to easily create compatible led nodes in overlays for BBBWL, BBB, and BBAI. For the definitions, you can see bbai-bone-buses.dtsi#L16 & bbb-bone-buses.dtsi#L16.
Example overlays
Header | Pin | Overlay |
---|---|---|
P8 | 03 | BONE-LED_P8_03.dts |
P9 | 11 | BONE-LED_P9_11.dts |
Definitions
LED | Header pin | BBBWL/BBB | BBAI | BBAI64 |
---|---|---|---|---|
/sys/class/leds/led_P8_03 | P8_03 | gpio1_6 | gpio1_24 | gpio0_20 |
/sys/class/leds/led_P8_04 | P8_04 | gpio1_7 | gpio1_25 | gpio0_48 |
/sys/class/leds/led_P8_05 | P8_05 | gpio1_2 | gpio7_1 | gpio0_33 |
/sys/class/leds/led_P8_06 | P8_06 | gpio1_3 | gpio7_2 | gpio0_34 |
/sys/class/leds/led_P8_07 | P8_07 | gpio2_2 | gpio6_5 | gpio0_15 |
/sys/class/leds/led_P8_08 | P8_08 | gpio2_3 | gpio6_6 | gpio0_14 |
/sys/class/leds/led_P8_09 | P8_09 | gpio2_5 | gpio6_18 | gpio0_17 |
/sys/class/leds/led_P8_10 | P8_10 | gpio2_4 | gpio6_4 | gpio0_16 |
/sys/class/leds/led_P8_11 | P8_11 | gpio1_13 | gpio3_11 | gpio0_60 |
/sys/class/leds/led_P8_12 | P8_12 | gpio1_12 | gpio3_10 | gpio0_59 |
/sys/class/leds/led_P8_13 | P8_13 | gpio0_23 | gpio4_11 | gpio0_89 |
/sys/class/leds/led_P8_14 | P8_14 | gpio0_26 | gpio4_13 | gpio0_75 |
/sys/class/leds/led_P8_15 | P8_15 | gpio1_15 | gpio4_3 | gpio0_61 |
/sys/class/leds/led_P8_16 | P8_16 | gpio1_14 | gpio4_29 | gpio0_62 |
/sys/class/leds/led_P8_17 | P8_17 | gpio0_27 | gpio8_18 | gpio0_3 |
/sys/class/leds/led_P8_18 | P8_18 | gpio2_1 | gpio4_9 | gpio0_4 |
/sys/class/leds/led_P8_19 | P8_19 | gpio0_22 | gpio4_10 | gpio0_88 |
/sys/class/leds/led_P8_20 | P8_20 | gpio1_31 | gpio6_30 | gpio0_76 |
/sys/class/leds/led_P8_21 | P8_21 | gpio1_30 | gpio6_29 | gpio0_30 |
/sys/class/leds/led_P8_22 | P8_22 | gpio1_5 | gpio1_23 | gpio0_5 |
/sys/class/leds/led_P8_23 | P8_23 | gpio1_4 | gpio1_22 | gpio0_31 |
/sys/class/leds/led_P8_24 | P8_24 | gpio1_1 | gpio7_0 | gpio0_6 |
/sys/class/leds/led_P8_25 | P8_25 | gpio1_0 | gpio6_31 | gpio0_35 |
/sys/class/leds/led_P8_26 | P8_26 | gpio1_29 | gpio4_28 | gpio0_51 |
/sys/class/leds/led_P8_27 | P8_27 | gpio2_22 | gpio4_23 | gpio0_71 |
/sys/class/leds/led_P8_28 | P8_28 | gpio2_24 | gpio4_19 | gpio0_72 |
/sys/class/leds/led_P8_29 | P8_29 | gpio2_23 | gpio4_22 | gpio0_73 |
/sys/class/leds/led_P8_30 | P8_30 | gpio2_25 | gpio4_20 | gpio0_74 |
/sys/class/leds/led_P8_31 | P8_31 | gpio0_10 | gpio8_14 | gpio0_32 |
/sys/class/leds/led_P8_32 | P8_32 | gpio0_11 | gpio8_15 | gpio0_26 |
/sys/class/leds/led_P8_33 | P8_33 | gpio0_9 | gpio8_13 | gpio0_25 |
/sys/class/leds/led_P8_34 | P8_34 | gpio2_17 | gpio8_11 | gpio0_7 |
/sys/class/leds/led_P8_35 | P8_35 | gpio0_8 | gpio8_12 | gpio0_24 |
/sys/class/leds/led_P8_36 | P8_36 | gpio2_16 | gpio8_10 | gpio0_8 |
/sys/class/leds/led_P8_37 | P8_37 | gpio2_14 | gpio8_8 | gpio0_106 |
/sys/class/leds/led_P8_38 | P8_38 | gpio2_15 | gpio8_9 | gpio0_105 |
/sys/class/leds/led_P8_39 | P8_39 | gpio2_12 | gpio8_6 | gpio0_69 |
/sys/class/leds/led_P8_40 | P8_40 | gpio2_13 | gpio8_7 | gpio0_70 |
/sys/class/leds/led_P8_41 | P8_41 | gpio2_10 | gpio8_4 | gpio0_67 |
/sys/class/leds/led_P8_42 | P8_42 | gpio2_11 | gpio8_5 | gpio0_68 |
/sys/class/leds/led_P8_43 | P8_43 | gpio2_8 | gpio8_2 | gpio0_65 |
/sys/class/leds/led_P8_44 | P8_44 | gpio2_9 | gpio8_3 | gpio0_66 |
/sys/class/leds/led_P8_45 | P8_45 | gpio2_6 | gpio8_0 | gpio0_79 |
/sys/class/leds/led_P8_46 | P8_46 | gpio2_7 | gpio8_1 | gpio0_80 |
/sys/class/leds/led_P9_11 | P9_11 | gpio0_30 | gpio8_17 | gpio0_1 |
/sys/class/leds/led_P9_12 | P9_12 | gpio1_28 | gpio5_0 | gpio0_45 |
/sys/class/leds/led_P9_13 | P9_13 | gpio0_31 | gpio6_12 | gpio0_2 |
/sys/class/leds/led_P9_14 | P9_14 | gpio1_18 | gpio4_25 | gpio0_93 |
/sys/class/leds/led_P9_15 | P9_15 | gpio1_16 | gpio3_12 | gpio0_47 |
/sys/class/leds/led_P9_16 | P9_16 | gpio1_19 | gpio4_26 | gpio0_94 |
/sys/class/leds/led_P9_17 | P9_17 | gpio0_5 | gpio7_17 | gpio0_28 |
/sys/class/leds/led_P9_18 | P9_18 | gpio0_4 | gpio7_16 | gpio0_40 |
/sys/class/leds/led_P9_19 | P9_19 | gpio0_13 | gpio7_3 | gpio0_78 |
/sys/class/leds/led_P9_20 | P9_20 | gpio0_12 | gpio7_4 | gpio0_77 |
/sys/class/leds/led_P9_21 | P9_21 | gpio0_3 | gpio3_3 | gpio0_39 |
/sys/class/leds/led_P9_22 | P9_22 | gpio0_2 | gpio6_19 | gpio0_38 |
/sys/class/leds/led_P9_23 | P9_23 | gpio1_17 | gpio7_11 | gpio0_10 |
/sys/class/leds/led_P9_24 | P9_24 | gpio0_15 | gpio6_15 | gpio0_13 |
/sys/class/leds/led_P9_25 | P9_25 | gpio3_21 | gpio6_17 | gpio0_127 |
/sys/class/leds/led_P9_26 | P9_26 | gpio0_14 | gpio6_14 | gpio0_12 |
/sys/class/leds/led_P9_27 | P9_27 | gpio3_19 | gpio4_15 | gpio0_46 |
/sys/class/leds/led_P9_28 | P9_28 | gpio3_17 | gpio4_17 | gpio1_11 |
/sys/class/leds/led_P9_29 | P9_29 | gpio3_15 | gpio5_11 | gpio0_53 |
/sys/class/leds/led_P9_30 | P9_30 | gpio3_16 | gpio5_12 | gpio0_44 |
/sys/class/leds/led_P9_31 | P9_31 | gpio3_14 | gpio5_10 | gpio0_52 |
/sys/class/leds/led_P9_33 | P9_33 | ⌠| ⌠| gpio0_50 |
/sys/class/leds/led_P9_35 | P9_35 | ⌠| ⌠| gpio0_55 |
/sys/class/leds/led_P9_36 | P9_36 | ⌠| ⌠| gpio0_56 |
/sys/class/leds/led_P9_37 | P9_37 | ⌠| ⌠| gpio0_57 |
/sys/class/leds/led_P9_38 | P9_38 | ⌠| ⌠| gpio0_58 |
/sys/class/leds/led_P9_39 | P9_39 | ⌠| ⌠| gpio0_54 |
/sys/class/leds/led_P9_40 | P9_40 | ⌠| ⌠| gpio0_81 |
/sys/class/leds/led_P9_41 | P9_41 | gpio0_20 | gpio6_20 | gpio1_0 |
/sys/class/leds/led_P9_91 | P9_91 | gpio3_20 | ⌠| ⌠|
/sys/class/leds/led_P9_42 | P9_42 | gpio0_7 | gpio4_18 | gpio0_123 |
/sys/class/leds/led_P9_92 | P9_92 | gpio3_18 | ⌠| ⌠|
/sys/class/leds/led_A15 | A15 | gpio0_19 | ⌠| ⌠|
I2C
Compatibility layer provides simple I2C bone bus nodes for creating compatible overlays for BBBWL, BBB, & BBAI. The format followed for these nodes is bone_i2c_#. For the definitions, you can see bbai-bone-buses.dtsi#L388 & bbb-bone-buses.dtsi#L403.
SYSFS | DT symbol | BBBWL/BBB | BBAI | BBAI64 | SCL | SDA | Overlay |
---|---|---|---|---|---|---|---|
/dev/bone/i2c/0 | bone_i2c_0 | I2C0 | I2C1 | TBD | ⌠(On-board) | ||
/dev/bone/i2c/1 | bone_i2c_1 | I2C1 | I2C5 | MAIN_I2C6 | P9.17 | P9.18 | BONE-I2C1.dts |
/dev/bone/i2c/2 | bone_i2c_2 | I2C2 | I2C4 | MAIN_I2C3 | P9.19 | P9.20 | BONE-I2C2.dts |
/dev/bone/i2c/2a | bone_i2c_2a | I2C2 | N/A | TBD | P9.21 | P9.22 | BONE-I2C2A.dts |
/dev/bone/i2c/3 | bone_i2c_3 | I2C1 | I2C3 | MAIN_I2C4 | P9.24 | P9.26 | BONE-I2C3.dts |
SPI
SPI bone bus nodes allow creating compatible overlays for BBBWl, BBB, & BBAI. For the definitions, you can see bbai-bone-buses.dtsi#L406 & bbb-bone-buses.dtsi#L423.
Bone bus | DT symbol | BBBWL/BBB | BBAI | BBAI64 | MOSI | MISO | CLK | CS | Overlay |
---|---|---|---|---|---|---|---|---|---|
/dev/bone/spi/0.x | bone_spi_0 | SPI0 | SPI2 | MAIN_SPI6 | P9.18 | P9.21 | P9.22 |
|
|
/dev/bone/spi/1.x | bone_spi_1 | SPI1 | SPI3 | TBD | P9.30 | P9.29 | P9.31 |
|
UART
UART bone bus nodes allow creating compatible overlays for BBBWl, BBB, & BBAI. For the definitions, you can see bbai-bone-buses.dtsi#L367 & bbb-bone-buses.dtsi#L382.
Bone bus | BBBWL/BBB | BBAI | BBAI64 | TX | RX | RTSn | CTSn | Overlays |
---|---|---|---|---|---|---|---|---|
/dev/bone/uart/0 | UART0 | UART1 | MAIN_UART0 | ⌠(console debug header pins) | ||||
/dev/bone/uart/1 | UART1 | UART10 | MAIN_UART2 | P9.24 | P9.26 |
|
|
BONE-UART1.dts |
/dev/bone/uart/2 | UART2 | UART3 | TBD | P9.21 | P9.22 |
|
|
BONE-UART2.dts |
/dev/bone/uart/3 | UART3 | ⌠| TBD | P9.42 | ⌠| ⌠| ⌠| BONE-UART3.dts |
/dev/bone/uart/4 | UART4 | UART5 | TBD | P9.13 | P9.11 |
|
|
BONE-UART4.dts |
/dev/bone/uart/5 | UART5 | UART8 | MAIN_UART5 | P8.37 | P8.38 | P8.32 | P8.31 | BONE-UART5.dts |
CAN
CAN bone bus nodes allow creating compatible overlays for BBBWl, BBB, & BBAI. For the definitions, you can see bbai-bone-buses.dtsi#L440 & bbb-bone-buses.dtsi#L457.
BBBWL/BBB | BBAI | TX | RX | Overlays |
---|---|---|---|---|
CAN0 | ⌠| P9.20 | P9.19 | BONE-CAN0.dts |
CAN1 | CAN2 | P9.26 | P9.24 | BONE-CAN1.dts |
⌠| CAN1 (rev A2 and later) | P8.8 | P8.7 | TODO |
ADC
BBBWL/BBB | BBAI | overlay |
---|---|---|
Internal | External (STMPE811) | BONE-ADC.dts |
Index | Header pin | BBBWL/BBB | BBAI |
---|---|---|---|
0 | P9_39 | in_voltage0_raw | in_voltage0_raw |
1 | P9_40 | in_voltage1_raw | in_voltage1_raw |
2 | P9_37 | in_voltage2_raw | in_voltage3_raw |
3 | P9_38 | in_voltage3_raw | in_voltage2_raw |
4 | P9_33 | in_voltage4_raw | in_voltage7_raw |
5 | P9_36 | in_voltage5_raw | in_voltage6_raw |
6 | P9_35 | in_voltage6_raw | in_voltage4_raw |
PWM
PWM bone bus nodes allow creating compatible overlays for BBBWl, BBB, & BBAI. For the definitions, you can see bbai-bone-buses.dtsi#L415 & bbb-bone-buses.dtsi#L432
Bone bus | BBBWL/BBB | BBAI | A | B | Overlay |
---|---|---|---|---|---|
/dev/bone/pwm/0 | PWM0 | ⌠| P9.22 | P9.21 | BONE-PWM0.dts |
/dev/bone/pwm/1 | PWM1 | PWM3 | P9.14 | P9.16 | BONE-PWM1.dts |
/dev/bone/pwm/2 | PWM2 | PWM2 | P8.19 | P8.13 | BONE-PWM2.dts |
TIMER PWM
TIMER PWM bone bus uses ti,omap-dmtimer-pwm driver, and timer nodes that allow creating compatible overlays for BBBWl, BBB, & BBAI. For the timer node definitions, you can see bbai-bone-buses.dtsi#L449 & bbb-bone-buses.dtsi#L466.
Bone bus | Header pin | BBBWL/BBB | BBAI | overlay |
---|---|---|---|---|
/sys/bus/platform/devices/bone_timer_pwm_0/ | P8.10 | timer6 | timer10 | BONE-TIMER_PWM_0.dts |
/sys/bus/platform/devices/bone_timer_pwm_1/ | P8.07 | timer4 | timer11 | BONE-TIMER_PWM_1.dts |
/sys/bus/platform/devices/bone_timer_pwm_2/ | P8.08 | timer7 | timer12 | BONE-TIMER_PWM_2.dts |
/sys/bus/platform/devices/bone_timer_pwm_3/ | P9.21 | ⌠| timer13 | BONE-TIMER_PWM_3.dts |
/sys/bus/platform/devices/bone_timer_pwm_4/ | P8.09 | timer5 | timer14 | BONE-TIMER_PWM_4.dts |
/sys/bus/platform/devices/bone_timer_pwm_5/ | P9.22 | ⌠| timer15 | BONE-TIMER_PWM_5.dts |
eCAP
Bone bus | Header pin | peripheral | overlay |
---|---|---|---|
/sys/bus/platform/drivers/ecap/48302100.ecap | P9.42 | eCAP0_in_PWM0_out | BBB-ECAP0.dts |
/sys/bus/platform/drivers/ecap/48304100.ecap | P9.28 | eCAP2_in_PWM2_out | BBB-ECAP2.dts |
Bone bus | Header pin | peripheral | overlay |
---|---|---|---|
/sys/bus/platform/drivers/ecap/4843e100.ecap | P8.15 | eCAP1_in_PWM1_out | BBAI-ECAP1.dts |
/sys/bus/platform/drivers/ecap/48440100.ecap | P8.14 | eCAP2_in_PWM2_out | BBAI-ECAP2.dts |
/sys/bus/platform/drivers/ecap/48440100.ecap | P8.20 | eCAP2_in_PWM2_out | BBAI-ECAP2A.dts |
/sys/bus/platform/drivers/ecap/48442100.ecap | P8.04 | eCAP3_in_PWM3_out | BBAI-ECAP3.dts |
/sys/bus/platform/drivers/ecap/48442100.ecap | P8.26 | eCAP3_in_PWM3_out | BBAI-ECAP3A.dts |
eMMC
BBBWL/BBB | BBAI | overlay |
---|---|---|
MMC2 | MMC3 | BONE-eMMC.dts |
Header pin | Description |
---|---|
P8.3 | DAT6 |
P8.4 | DAT7 |
P8.5 | DAT2 |
P8.6 | DAT3 |
P8.20 | CMD |
P8.21 | CLK |
P8.22 | DAT5 |
P8.23 | DAT4 |
P8.24 | DAT1 |
P8.25 | DAT0 |
LCD
BBBWL/BBB | BBAI | overlay |
---|---|---|
lcdc | dss |
Header pin | Description |
---|---|
P8_45 | lcd_data0 |
P8_46 | lcd_data1 |
P8_43 | lcd_data2 |
P8_44 | lcd_data3 |
P8_41 | lcd_data4 |
P8_42 | lcd_data5 |
P8_39 | lcd_data6 |
P8_40 | lcd_data7 |
P8_37 | lcd_data8 |
P8_38 | lcd_data9 |
P8_36 | lcd_data10 |
P8_34 | lcd_data11 |
P8_35 | lcd_data12 |
P8_33 | lcd_data13 |
P8_31 | lcd_data14 |
P8_32 | lcd_data15 |
P8_27 | lcd_vsync |
P8_29 | lcd_hsync |
P8_28 | lcd_pclk |
P8_30 | lcd_ac_bias_en |
eQEP
Bone bus | BBBWL/BBB | BBAI | A | B | strobe | index | overlay |
---|---|---|---|---|---|---|---|
/bone/eQEP0 | eQEP0 | eQEP2 | P9.42 | P9.27 |
|
|
|
/bone/eQEP1 | eQEP1 | eQEP0 | P8.35 | P8.33 |
|
|
|
/bone/eQEP2 | eQEP2 | eQEP1 | P8.12 | P8.22 |
|
|
|
/bone/eQEP2A | eQEP2 | ⌠| P8.41 | P8.42 | P8.40 | P8.39 |
McASP
BBBWL/BBB | BBAI | overlay |
---|---|---|
McASP0 | McASP1 |
Header pin | Description |
---|---|
P9.12 | aclkr |
P9.25 | ahclkx |
P9.27 | fsr |
P9.28 |
|
P9.29 | fsx |
P9.30 |
|
P9.31 | aclkx |
PRU
The overlay situation for PRUs is a bit more complex than with other peripherals. The mechanism for loading, starting and stopping the PRUs can go through either UIO or RemoteProc.
- /dev/remoteproc/prussX-coreY (AM3358 X = "", other x = "1|2")
Header Pin | BBBWL/BBB | BBAI |
---|---|---|
P8.15 | pr1_ecap0 | pr1_ecap0 |
P8.32 | ⌠| pr2_ecap0 |
P9.42 | pr1_ecap0 | ⌠|
UART | TX | RX | RTSn | CTSn | Overlays |
---|---|---|---|---|---|
PRU1 UART0 | P8_31 | P8_33 | P8_34 | P8_35 | |
PRU2 UART0 | P8_43 | P8_44 | P8_45 | P8_46 |
Header Pin | BBBWL/BBB | BBAI |
---|---|---|
P8.03 | ⌠| pr2_pru0 10 |
P8.04 | ⌠| pr2_pru0 11 |
P8.05 | ⌠| pr2_pru0 06 |
P8.06 | ⌠| pr2_pru0 07 |
P8.07 | ⌠| pr2_pru1 16 |
P8.08 | ⌠| pr2_pru0 20 |
P8.09 | ⌠| pr2_pru1 06 |
P8.10 | ⌠| pr2_pru1 15 |
P8.11 | pr1_pru0 15 (Out) | pr1_pru0 04 |
P8.12 | pr1_pru0 14 (Out) | pr1_pru0 03 |
P8.13 | ⌠| pr1_pru1 07 |
P8.14 | ⌠| pr1_pru1 09 |
P8.15 | pr1_pru0 15 (In) | pr1_pru1 16 |
P8.16 | pr1_pru0 14 (In) | pr1_pru1 18 |
P8.17 | ⌠| pr2_pru0 15 |
P8.18 | ⌠| pr1_pru1 05 |
P8.19 | ⌠| pr1_pru1 06 |
P8.20 | ⌠| pr2_pru0 03 |
P8.21 | ⌠| pr2_pru0 02 |
P8.22 | ⌠| pr2_pru0 09 |
P8.23 | ⌠| pr2_pru0 08 |
P8.24 | ⌠| pr2_pru0 05 |
P8.25 | ⌠| pr2_pru0 04 |
P8.26 | ⌠| pr1_pru1 17 |
P8.27 | ⌠| pr2_pru1 17 |
P8.28 | ⌠| pr2_pru0 17 |
P8.29 | ⌠| pr2_pru0 18 |
P8.30 | ⌠| pr2_pru0 19 |
P8.31 | ⌠| pr2_pru0 11 |
P8.32 | ⌠| pr2_pru1 00 |
P8.33 | ⌠| pr2_pru0 10 |
P8.34 | ⌠| pr2_pru0 08 |
P8.35 | ⌠| pr2_pru0 09 |
P8.36 | ⌠| pr2_pru0 07 |
P8.37 | ⌠| pr2_pru0 05 |
P8.38 | ⌠| pr2_pru0 06 |
P8.39 | ⌠| pr2_pru0 03 |
P8.40 | ⌠| pr2_pru0 04 |
P8.41 | ⌠| pr2_pru0 01 |
P8.42 | ⌠| pr2_pru0 02 |
P8.43 | ⌠| pr2_pru1 20 |
P8.44 | ⌠| pr2_pru0 00 |
P8.45 | ⌠| pr2_pru1 18 |
P8.46 | ⌠| pr2_pru1 19 |
P9.11 | ⌠| pr2_pru0 14 |
P9.13 | ⌠| pr2_pru0 15 |
P9.14 | ⌠| pr1_pru1 14 |
P9.15 | ⌠| pr1_pru0 5 |
P9.16 | ⌠| pr1_pru1 15 |
P9.17 | ⌠| pr2_pru1 09 |
P9.18 | ⌠| pr2_pru1 08 |
P9.19 | ⌠| pr1_pru1 02 |
P9.20 | ⌠| pr1_pru1 01 |
P9.24 | pr1_pru0 16 (In) | ⌠|
P9.25 | pr1_pru0 07 | pr2_pru1 05 |
P9.26 | pr1_pru1 16 (In) | pr1_pru0 17 |
P9.27 | pr1_pru0 05 | pr1_pru1 11 |
P9.28 | pr1_pru0 03 | pr2_pru1 13 |
P9.29 | pr1_pru0 01 | pr2_pru1 11 |
P9.30 | pr1_pru0 02 | pr2_pru1 12 |
P9.31 | pr1_pru0 00 | pr2_pru1 10 |
P9.41 | pr1_pru0 06 | pr1_pru1 03 |
P9.42 | pr1_pru0 04 | pr1_pru1 10 |
GPIO
TODO
For each of the pins with a GPIO, there should be a symlink that comes from the names
Methodology
The methodology for applied in the kernel and software images to expose the software interfaces is to be documented here. The most fundamental elements are the device tree entries, including overlays, and udev rules.
Device Trees
udev rules [5]
10-of-symlink.rules[6]
#From: https://github.com/mvduin/py-uio/blob/master/etc/udev/rules.d/10-of-symlink.rules # allow declaring a symlink for a device in DT ATTR{device/of_node/symlink}!="", \ ENV{OF_SYMLINK}="%s{device/of_node/symlink}" ENV{OF_SYMLINK}!="", ENV{DEVNAME}!="", \ SYMLINK+="%E{OF_SYMLINK}", \ TAG+="systemd", ENV{SYSTEMD_ALIAS}+="/dev/%E{OF_SYMLINK}"
TBD
#Also courtesy of mvduin # create symlinks for gpios exported to sysfs by DT SUBSYSTEM=="gpio", ACTION=="add", TEST=="value", ATTR{label}!="sysfs", \ RUN+="/bin/mkdir -p /dev/bone/gpio", \ RUN+="/bin/ln -sT '/sys/class/gpio/%k' /dev/bone/gpio/%s{label}"
Verification
TODO: The steps used to verify all of these configurations is to be documented here. It will serve to document what has been tested, how to reproduce the configurations, and how to verify each major triannual release. All faults will be documented in the issue tracker.