added GPIO_n as comments

[hackapet/Adafruit_Blinka.git] / src / adafruit_blinka / board / beaglebone_black.py

diff --git a/src/adafruit_blinka/board/beaglebone_black.py b/src/adafruit_blinka/board/beaglebone_black.py
index f8699640bc83a8b49fb0c26fc6129b994de205c1..4bd10cd8e36dff3623d215338674adaf4f8261b0 100644 (file)
--- a/src/adafruit_blinka/board/beaglebone_black.py
+++ b/src/adafruit_blinka/board/beaglebone_black.py
@@ -1,74 +1,103 @@
+"""Pin definitions for the Beaglebone Black."""

 from adafruit_blinka.microcontroller.am335x import pin
 
 # initial pins, to mimic bonescript demo
 from adafruit_blinka.microcontroller.am335x import pin
 
 # initial pins, to mimic bonescript demo

-P8_3 = pin.P8_3
-P8_4 = pin.P8_4
-P8_5 = pin.P8_5
-P8_6 = pin.P8_6
-P8_7 = pin.P8_7
-P8_8 = pin.P8_8
-P8_9 = pin.P8_9
-P8_10 = pin.P8_10
-P8_11 = pin.P8_11
-P8_12 = pin.P8_12
-P8_13 = pin.P8_13
-P8_14 = pin.P8_14
-P8_15 = pin.P8_15
-P8_16 = pin.P8_16
-P8_17 = pin.P8_17
-P8_18 = pin.P8_18
-P8_19 = pin.P8_19
-P8_20 = pin.P8_20
-P8_21 = pin.P8_21
-P8_22 = pin.P8_22
-P8_23 = pin.P8_23
-P8_24 = pin.P8_24
-P8_25 = pin.P8_25
-P8_26 = pin.P8_26
-P8_27 = pin.P8_27
-P8_28 = pin.P8_28
-P8_29 = pin.P8_29
-P8_30 = pin.P8_30
-P8_31 = pin.P8_31
-P8_32 = pin.P8_32
-P8_33 = pin.P8_33
-P8_34 = pin.P8_34
-P8_35 = pin.P8_35
-P8_36 = pin.P8_36
-P8_37 = pin.P8_37
-P8_38 = pin.P8_38
-P8_39 = pin.P8_39
-P8_40 = pin.P8_40
-P8_41 = pin.P8_41
-P8_42 = pin.P8_42
-P8_43 = pin.P8_43
-P8_44 = pin.P8_44
-P8_45 = pin.P8_45
-P8_46 = pin.P8_46
-P9_11 = pin.P9_11
-P9_12 = pin.P9_12
-P9_13 = pin.P9_13
-P9_14 = pin.P9_14
-P9_15 = pin.P9_15
-P9_16 = pin.P9_16
-P9_17 = pin.P9_17
-P9_18 = pin.P9_18
-P9_19 = pin.P9_19
-P9_20 = pin.P9_20
-P9_21 = pin.P9_21
-P9_22 = pin.P9_22
-P9_23 = pin.P9_23
-P9_24 = pin.P9_24
-P9_25 = pin.P9_25
-P9_26 = pin.P9_26
-P9_27 = pin.P9_27
-P9_28 = pin.P9_28
-P9_29 = pin.P9_29
-P9_30 = pin.P9_30
-P9_31 = pin.P9_31
-P9_41 = pin.P9_41
-P9_42 = pin.P9_42
+# BeagleBone Black
+# P8_1 = DGND
+# P8_2 = DGND
+P8_3 = pin.P8_3  # GPIO_38
+P8_4 = pin.P8_4  # GPIO_39
+P8_5 = pin.P8_5  # GPIO_34
+P8_6 = pin.P8_6  # GPIO_35
+P8_7 = pin.P8_7  # GPIO_66
+P8_8 = pin.P8_8  # GPIO_67
+P8_9 = pin.P8_9  # GPIO_69
+P8_10 = pin.P8_10  # GPIO_68
+P8_11 = pin.P8_11  # GPIO_45
+P8_12 = pin.P8_12  # GPIO_44
+P8_13 = pin.P8_13  # GPIO_23
+P8_14 = pin.P8_14  # GPIO_26
+P8_15 = pin.P8_15  # GPIO_47
+P8_16 = pin.P8_16  # GPIO_46
+P8_17 = pin.P8_17  # GPIO_27
+P8_18 = pin.P8_18  # GPIO_65
+P8_19 = pin.P8_19  # GPIO_22
+P8_20 = pin.P8_20  # GPIO_63
+P8_21 = pin.P8_21  # GPIO_62
+P8_22 = pin.P8_22  # GPIO_37
+P8_23 = pin.P8_23  # GPIO_36
+P8_24 = pin.P8_24  # GPIO_33
+P8_25 = pin.P8_25  # GPIO_32
+P8_26 = pin.P8_26  # GPIO_61
+P8_27 = pin.P8_27  # GPIO_86
+P8_28 = pin.P8_28  # GPIO_88
+P8_29 = pin.P8_29  # GPIO_87
+P8_30 = pin.P8_30  # GPIO_89
+P8_31 = pin.P8_31  # GPIO_10
+P8_32 = pin.P8_32  # GPIO_11
+P8_33 = pin.P8_33  # GPIO_9
+P8_34 = pin.P8_34  # GPIO_81
+P8_35 = pin.P8_35  # GPIO_8
+P8_36 = pin.P8_36  # GPIO_80
+P8_37 = pin.P8_37  # GPIO_78
+P8_38 = pin.P8_38  # GPIO_79
+P8_39 = pin.P8_39  # GPIO_76
+P8_40 = pin.P8_40  # GPIO_77
+P8_41 = pin.P8_41  # GPIO_74
+P8_42 = pin.P8_42  # GPIO_75
+P8_43 = pin.P8_43  # GPIO_72
+P8_44 = pin.P8_44  # GPIO_73
+P8_45 = pin.P8_45  # GPIO_70
+P8_46 = pin.P8_46  # GPIO_71

 
 

+# P9_1 = DGND
+# P9_2 = DGND
+# P9_3 = VDD_3V3
+# P9_4 = VDD_3V3
+# P9_5 = VDD_5V
+# P9_6 = VDD_5V
+# P9_7 = SYS_5V
+# P9_8 = SYS_5V
+# P9_9 = PWR_BUT
+# P9_10 = SYS_RESETN
+P9_11 = pin.P9_11  # GPIO_30
+P9_12 = pin.P9_12  # GPIO_60
+P9_13 = pin.P9_13  # GPIO_31
+P9_14 = pin.P9_14  # GPIO_40
+P9_15 = pin.P9_15  # GPIO_48
+P9_16 = pin.P9_16  # GPIO_51
+P9_17 = pin.P9_17  # GPIO_4
+P9_18 = pin.P9_18  # GPIO_5
+P9_19 = pin.P9_19  # I2C2_SCL
+P9_20 = pin.P9_20  # I2C2_SDA
+P9_21 = pin.P9_21  # GPIO_3
+P9_22 = pin.P9_22  # GPIO_2
+P9_23 = pin.P9_23  # GPIO_49
+P9_24 = pin.P9_24  # GPIO_15
+P9_25 = pin.P9_25  # GPIO_117
+P9_26 = pin.P9_26  # GPIO_14
+P9_27 = pin.P9_27  # GPIO_125
+P9_28 = pin.P9_28  # GPIO_123
+P9_29 = pin.P9_29  # GPIO_121
+P9_30 = pin.P9_30  # GPIO_122
+P9_31 = pin.P9_31  # GPIO_120
+# P9_32 = VDD_ADC
+# P9_33 = AIN4
+# P9_34 = GNDA_ADC
+# P9_35 = AIN6
+# P9_36 = AIN5
+# P9_37 = AIN2
+# P9_38 = AIN3
+# P9_39 = AIN0
+# P9_40 = AIN1
+P9_41 = pin.P9_41  # GPIO_20
+P9_42 = pin.P9_42  # GPIO_7
+# P9_43 = DGND
+# P9_44 = DGND
+# P9_45 = DGND
+# P9_46 = DGND
+
+# common to all beagles

 LED_USR0 = pin.USR0
 LED_USR1 = pin.USR1
 LED_USR2 = pin.USR2
 LED_USR0 = pin.USR0
 LED_USR1 = pin.USR1
 LED_USR2 = pin.USR2


@@ -91,27 +120,73 @@ LED_USR3 = pin.USR3
 # SCLK_1 = pin.D21
 # SCK_1 = pin.D21
 
 # SCLK_1 = pin.D21
 # SCK_1 = pin.D21
 

-SDA = pin.SDA
-SCL = pin.SCL
+SDA = pin.P9_19
+SCL = pin.P9_20

 
 # Refer to header default pin modes
 # http://beagleboard.org/static/images/cape-headers.png
 
 # Refer to header default pin modes
 # http://beagleboard.org/static/images/cape-headers.png

+#

 # P9_17 (SPI0_CSO => CE0) enables peripheral device
 # P9_18 (SPI0_D1 => MOSI) outputs data to peripheral device
 # P9_21 (SPIO_DO => MISO) receives data from peripheral device
 # P9_22 (SPI0_SCLK => SCLK) outputs clock signal
 # P9_17 (SPI0_CSO => CE0) enables peripheral device
 # P9_18 (SPI0_D1 => MOSI) outputs data to peripheral device
 # P9_21 (SPIO_DO => MISO) receives data from peripheral device
 # P9_22 (SPI0_SCLK => SCLK) outputs clock signal

-CE0 = pin.CE0
-MOSI = pin.MOSI
-MISO = pin.MISO
-SCLK = pin.SCLK
-#CircuitPython naming convention for SPI Clock
-SCK = pin.SCK
+#
+# Use config-pin to set pin mode for SPI pins
+# https://github.com/beagleboard/bb.org-overlays/tree/master/tools/beaglebone-universal-io
+# config-pin p9.17 spi_cs
+# config-pin p9.18 spi
+# config-pin p9.21 spi
+# config-pin p9.22 spi_sclk
+#
+CE0 = pin.P9_17
+MOSI = pin.P9_18
+MISO = pin.P9_21
+SCLK = pin.P9_22
+# CircuitPython naming convention for SPI Clock
+SCK = SCLK

 
 

-# SPI1 pins
+# Pins for SPI1
+# refer to:

 # http://beagleboard.org/static/images/cape-headers-spi.png
 # http://beagleboard.org/static/images/cape-headers-spi.png

-CE1 = pin.CE1
-MOSI_1 = pin.MOSI_1
-MISO_1 = pin.MISO_1
-SCLK_1 = pin.SCLK_1
-#CircuitPython naming convention for SPI Clock
-SCK_1 = pin.SCK_1
+#
+# CE1 P9.28 SPI1_CS0
+# MISO_1 P9.29 SPI1_D0
+# MOSI_1 P9.30 SPI1_D1
+# SCLK_1 P9.31 SPI_SCLK
+#
+# SPI1 conflicts with HDMI Audio (McASP)
+#
+# Refer to:
+# https://elinux.org/Beagleboard:BeagleBoneBlack_Debian#U-Boot_Overlays
+#
+# To Disable HDMI AUDIO, uncomment this line in /boot/uEnv.txt:
+# disable_uboot_overlay_audio=1
+#
+# Set pin modes for SPI1 with:
+#
+# config-pin p9.28 spi1_cs
+# config-pin p9.29 spi1
+# config-pin p9.30 spi1
+# config-pin p9.31 spi_sclk
+CE1 = pin.P9_28
+MOSI_1 = pin.P9_29
+MISO_1 = pin.P9_30
+SCLK_1 = pin.P9_31
+# CircuitPython naming convention for SPI Clock
+SCK_1 = SCLK_1
+
+
+# ordered as spiId, sckId, mosiId, misoId
+spiPorts = (
+    (0, SCLK, MOSI, MISO),
+    (1, SCLK_1, MOSI_1, MISO_1)
+)
+
+# ordered as uartId, txId, rxId
+uartPorts = (
+    (),
+)
+
+i2cPorts = (
+    (2, SCL, SDA),
+)