src/adafruit_blinka/microcontroller/am335x/pin.py

   1 """AM335x pin names"""
   2 import Adafruit_BBIO.GPIO as GPIO
   3
   4
   5 class Pin:
   6     """Pins dont exist in CPython so...lets make our own!"""
   7
   8     IN = 0
   9     OUT = 1
  10     LOW = 0
  11     HIGH = 1
  12     PULL_NONE = 0
  13     PULL_UP = 1
  14     PULL_DOWN = 2
  15
  16     id = None
  17     _value = LOW
  18     _mode = IN
  19
  20     def __init__(self, pin_name):
  21         self.id = pin_name
  22
  23     def __repr__(self):
  24         return str(self.id)
  25
  26     def __eq__(self, other):
  27         return self.id == other
  28
  29     def init(self, mode=IN, pull=None):
  30         """Initialize the Pin"""
  31         if mode is not None:
  32             if mode == self.IN:
  33                 self._mode = self.IN
  34                 GPIO.setup(self.id, GPIO.IN)
  35             elif mode == self.OUT:
  36                 self._mode = self.OUT
  37                 GPIO.setup(self.id, GPIO.OUT)
  38             else:
  39                 raise RuntimeError("Invalid mode for pin: %s" % self.id)
  40         if pull is not None:
  41             if self._mode != self.IN:
  42                 raise RuntimeError("Cannot set pull resistor on output")
  43             if pull == self.PULL_UP:
  44                 GPIO.setup(self.id, GPIO.IN, pull_up_down=GPIO.PUD_UP)
  45             elif pull == self.PULL_DOWN:
  46                 GPIO.setup(self.id, GPIO.IN, pull_up_down=GPIO.PUD_DOWN)
  47             else:
  48                 raise RuntimeError("Invalid pull for pin: %s" % self.id)
  49
  50     def value(self, val=None):
  51         """Set or return the Pin Value"""
  52         if val is not None:
  53             if val == self.LOW:
  54                 self._value = val
  55                 GPIO.output(self.id, val)
  56             elif val == self.HIGH:
  57                 self._value = val
  58                 GPIO.output(self.id, val)
  59             else:
  60                 raise RuntimeError("Invalid value for pin")
  61             return None
  62         return GPIO.input(self.id)
  63
  64
  65 # names in comments copied from
  66 # https://github.com/adafruit/adafruit-beaglebone-io-python/blob/master/source/common.c#L73
  67
  68 # PocketBeagle
  69 # P1_1 = SYS VIN        # VIN_AC
  70 P1_2 = Pin("P1_2")  # GPIO2_23 - GPIO_87
  71 P1_3 = Pin("P1_3")  # USB1_VBUS_OUT - (silkscreen: USB1 V_EN)
  72 P1_4 = Pin("P1_4")  # GPIO2_25 - GPIO_89
  73 # P1_5 = USB VBUS       # USB1_VBUS_IN
  74 P1_6 = Pin("P1_6")  # SPI0_CS0 - GPIO_5
  75 # P1_7 = USB VIN        # VIN-USB
  76 P1_8 = Pin("P1_8")  # SPI0_SCLK - GPIO_2
  77 # P1_9 = USB1 DN        # USB1-DN
  78 P1_10 = Pin("P1_10")  # SPI0_D0 - GPIO_3
  79 # P1_11 = USB1 DP       # USB1-DP
  80 P1_12 = Pin("P1_12")  # SPI0_D1 - GPIO_4
  81 # P1_13 = USB1 ID       # USB1-ID
  82 # P1_14 = SYS 3.3V      # VOUT-3.3V
  83 # P1_15 = SYS GND       # GND
  84 # P1_16 = SYS GND       # GND
  85 # P1_17 = AIN 1.8V REF- # VREFN
  86 # P1_18 = AIN 1.8V REF+ # VREFP
  87 P1_19 = Pin("P1_19")  # AIN0
  88 P1_20 = Pin("P1_20")  # GPIO0_20 - GPIO_20
  89 P1_21 = Pin("P1_21")  # AIN1
  90 # P1_22 = SYS GND       # GND
  91 P1_23 = Pin("P1_23")  # AIN2
  92 # P1_22 = SYS VOUT      # VOUT-5V
  93 P1_25 = Pin("P1_25")  # AIN3
  94 P1_26 = Pin("P1_26")  # I2C2_SDA - GPIO_12
  95 P1_27 = Pin("P1_27")  # AIN4
  96 P1_28 = Pin("P1_28")  # I2C2_SCL - GPIO_13
  97 P1_29 = Pin("P1_29")  # GPIO3_21 - GPIO_117
  98 P1_30 = Pin("P1_30")  # UART0_TXD - GPIO_43
  99 P1_31 = Pin("P1_31")  # GPIO3_18 - GPIO_114
 100 P1_32 = Pin("P1_32")  # UART0_RXD - GPIO_42
 101 P1_33 = Pin("P1_33")  # GPIO3_15 - GPIO_111
 102 P1_34 = Pin("P1_34")  # GPIO0_26 - GPIO_26
 103 P1_35 = Pin("P1_35")  # GPIO2_24 - GPIO_88
 104 P1_36 = Pin("P1_36")  # EHRPWM0A - GPIO_110
 105
 106
 107 P2_1 = Pin("P2_1")  # EHRPWM1A - GPIO_50
 108 P2_2 = Pin("P2_2")  # GPIO1_27 - GPIO_59
 109 P2_3 = Pin("P2_3")  # GPIO0_23 - GPIO_23
 110 P2_4 = Pin("P2_4")  # GPIO1_26 - GPIO_58
 111 P2_5 = Pin("P2_5")  # UART4_RXD - GPIO_30
 112 P2_6 = Pin("P2_6")  # GPIO1_25 - GPIO_57
 113 P2_7 = Pin("P2_7")  # UART4_TXD - GPIO_31
 114 P2_8 = Pin("P2_8")  # GPIO1_28 - GPIO_60
 115 P2_9 = Pin("P2_9")  # I2C1_SCL - GPIO_15
 116 P2_10 = Pin("P2_10")  # GPIO1_20 - GPIO_52
 117 P2_11 = Pin("P2_11")  # I2C1_SDA - GPIO_14
 118 # P2_12 = SYS  PWR BTN  # POWER_BUTTON
 119 # P2_13 = SYS VOUT      # VOUT-5V
 120 # P2_14 = BAT VIN       # BAT-VIN
 121 # P2_15 = SYS GND       # GND
 122 # P2_16 = BAT TEMP      # BAT-TEMP
 123 P2_17 = Pin("P2_17")  # GPIO2_1 - GPIO_65
 124 P2_18 = Pin("P2_18")  # GPIO1_15 - GPIO_47
 125 P2_19 = Pin("P2_19")  # GPIO0_27 - GPIO_27
 126 P2_20 = Pin("P2_20")  # GPIO2_0 - GPIO_64
 127 # P2_21 = SYS GND       # GND
 128 P2_22 = Pin("P2_22")  # GPIO1_14 - GPIO_46
 129 # P2_23 = SYS 3.3V      # VOUT-3.3V
 130 P2_24 = Pin("P2_24")  # GPIO1_12 - GPIO_44
 131 P2_25 = Pin("P2_25")  # SPI1_D1 - GPIO_41
 132 # P2_26 = SYS NRST      # RESET#
 133 P2_27 = Pin("P2_27")  # SPI1_D0 - GPIO_40
 134 P2_28 = Pin("P2_28")  # GPIO3_20 - GPIO_116
 135 P2_29 = Pin("P2_29")  # SPI1_SCLK - GPIO_7
 136 P2_30 = Pin("P2_30")  # GPIO3_17 - GPIO_113
 137 P2_31 = Pin("P2_31")  # SPI1_CS1 - GPIO_19
 138 P2_32 = Pin("P2_32")  # GPIO3_16 - GPIO_112
 139 P2_33 = Pin("P2_33")  # GPIO1_13 - GPIO_45
 140 P2_34 = Pin("P2_34")  # GPIO3_19 - GPIO_115
 141 P2_35 = Pin("P2_35")  # GPIO2_22 - GPIO_86
 142 P2_36 = Pin("P2_36")  # AIN7
 143
 144
 145 # BeagleBone Black
 146 # P8_1 = DGND           # DGND - GPIO_0
 147 # P8_2 = DGND           # DGND - GPIO_0
 148 P8_3 = Pin("P8_3")  # GPIO1_6 - GPIO_38
 149 P8_4 = Pin("P8_4")  # GPIO1_7 - GPIO_39
 150 P8_5 = Pin("P8_5")  # GPIO1_2 - GPIO_34
 151 P8_6 = Pin("P8_6")  # GPIO1_3 - GPIO_35
 152 P8_7 = Pin("P8_7")  # TIMER4 - GPIO_66
 153 P8_8 = Pin("P8_8")  # TIMER7 - GPIO_67
 154 P8_9 = Pin("P8_9")  # TIMER5 - GPIO_69
 155 P8_10 = Pin("P8_10")  # TIMER6 - GPIO_68
 156 P8_11 = Pin("P8_11")  # GPIO1_13 - GPIO_45
 157 P8_12 = Pin("P8_12")  # GPIO1_12 - GPIO_44
 158 P8_13 = Pin("P8_13")  # EHRPWM2B - GPIO_23
 159 P8_14 = Pin("P8_14")  # GPIO0_26 - GPIO_26
 160 P8_15 = Pin("P8_15")  # GPIO1_15 - GPIO_47
 161 P8_16 = Pin("P8_16")  # GPIO1_14 - GPIO_46
 162 P8_17 = Pin("P8_17")  # GPIO0_27 - GPIO_27
 163 P8_18 = Pin("P8_18")  # GPIO2_1 - GPIO_65
 164 P8_19 = Pin("P8_19")  # EHRPWM2A - GPIO_22
 165 P8_20 = Pin("P8_20")  # GPIO1_31 - GPIO_63
 166 P8_21 = Pin("P8_21")  # GPIO1_30 - GPIO_62
 167 P8_22 = Pin("P8_22")  # GPIO1_5 - GPIO_37
 168 P8_23 = Pin("P8_23")  # GPIO1_4 - GPIO_36
 169 P8_24 = Pin("P8_24")  # GPIO1_1 - GPIO_33
 170 P8_25 = Pin("P8_25")  # GPIO1_0 - GPIO_32
 171 P8_26 = Pin("P8_26")  # GPIO1_29 - GPIO_61
 172 P8_27 = Pin("P8_27")  # GPIO2_22 - GPIO_86
 173 P8_28 = Pin("P8_28")  # GPIO2_24 - GPIO_88
 174 P8_29 = Pin("P8_29")  # GPIO2_23 - GPIO_87
 175 P8_30 = Pin("P8_30")  # GPIO2_25 - GPIO_89
 176 P8_31 = Pin("P8_31")  # UART5_CTSN - GPIO_10
 177 P8_32 = Pin("P8_32")  # UART5_RTSN - GPIO_11
 178 P8_33 = Pin("P8_33")  # UART4_RTSN - GPIO_9
 179 P8_34 = Pin("P8_34")  # UART3_RTSN - GPIO_81
 180 P8_35 = Pin("P8_35")  # UART4_CTSN - GPIO_8
 181 P8_36 = Pin("P8_36")  # UART3_CTSN - GPIO_80
 182 P8_37 = Pin("P8_37")  # UART5_TXD - GPIO_78
 183 P8_38 = Pin("P8_38")  # UART5_RXD - GPIO_79
 184 P8_39 = Pin("P8_39")  # GPIO2_12 - GPIO_76
 185 P8_40 = Pin("P8_40")  # GPIO2_13 - GPIO_77
 186 P8_41 = Pin("P8_41")  # GPIO2_10 - GPIO_74
 187 P8_42 = Pin("P8_42")  # GPIO2_11 - GPIO_75
 188 P8_43 = Pin("P8_43")  # GPIO2_8 - GPIO_72
 189 P8_44 = Pin("P8_44")  # GPIO2_9 - GPIO_73
 190 P8_45 = Pin("P8_45")  # GPIO2_6 - GPIO_70
 191 P8_46 = Pin("P8_46")  # GPIO2_7 - GPIO_71
 192
 193 # P9_1 = DGND           # DGND - GPIO_0
 194 # P9_2 = DGND           # DGND - GPIO_0
 195 # P9_3 = VDD_3V3        # VDD_3V3 - GPIO_0
 196 # P9_4 = VDD_3V3        # VDD_3V3 - GPIO_0
 197 # P9_5 = VDD_5V         # VDD_5V - GPIO_0
 198 # P9_6 = VDD_5V         # VDD_5V - GPIO_0
 199 # P9_7 = SYS_5V         # SYS_5V - GPIO_0
 200 # P9_8 = SYS_5V         # SYS_5V - GPIO_0
 201 # P9_9 = PWR_BUT        # PWR_BUT - GPIO_0
 202 # P9_10 = SYS_RESETN    # SYS_RESETn - GPIO_0
 203 P9_11 = Pin("P9_11")  # UART4_RXD - GPIO_30
 204 P9_12 = Pin("P9_12")  # GPIO1_28 - GPIO_60
 205 P9_13 = Pin("P9_13")  # UART4_TXD - GPIO_31
 206 P9_14 = Pin("P9_14")  # EHRPWM1A - GPIO_50
 207 P9_15 = Pin("P9_15")  # GPIO1_16 - GPIO_48
 208 P9_16 = Pin("P9_16")  # EHRPWM1B - GPIO_51
 209 P9_17 = Pin("P9_17")  # I2C1_SCL - GPIO_5
 210 P9_18 = Pin("P9_18")  # I2C1_SDA - GPIO_4
 211 P9_19 = Pin("P9_19")  # I2C2_SCL - GPIO_13
 212 P9_20 = Pin("P9_20")  # I2C2_SDA - GPIO_12
 213 P9_21 = Pin("P9_21")  # UART2_TXD - GPIO_3
 214 P9_22 = Pin("P9_22")  # UART2_RXD - GPIO_2
 215 P9_23 = Pin("P9_23")  # GPIO1_17 - GPIO_49
 216 P9_24 = Pin("P9_24")  # UART1_TXD - GPIO_15
 217 P9_25 = Pin("P9_25")  # GPIO3_21 - GPIO_117
 218 P9_26 = Pin("P9_26")  # UART1_RXD - GPIO_14
 219 P9_27 = Pin("P9_27")  # GPIO3_19 - GPIO_115
 220 P9_28 = Pin("P9_28")  # SPI1_CS0 - GPIO_113
 221 P9_29 = Pin("P9_29")  # SPI1_D0 - GPIO_111
 222 P9_30 = Pin("P9_30")  # SPI1_D1 - GPIO_112
 223 P9_31 = Pin("P9_31")  # SPI1_SCLK - GPIO_110
 224 # P9_32 = VDD_ADC       # VDD_ADC - GPIO_0
 225 # P9_33 = AIN4          # AIN4 - GPIO_0
 226 # P9_34 = GNDA_ADC      # GNDA_ADC - GPIO_0
 227 # P9_35 = AIN6          # AIN6 - GPIO_0
 228 # P9_36 = AIN5          # AIN5 - GPIO_0
 229 # P9_37 = AIN2          # AIN2 - GPIO_0
 230 # P9_38 = AIN3          # AIN3 - GPIO_0
 231 # P9_39 = AIN0          # AIN0 - GPIO_0
 232 # P9_40 = AIN1          # AIN1 - GPIO_0
 233 P9_41 = Pin("P9_41")  # CLKOUT2 - GPIO_20
 234 P9_42 = Pin("P9_42")  # GPIO0_7 - GPIO_7
 235 # P9_43 = DGND          # DGND - GPIO_0
 236 # P9_44 = DGND          # DGND - GPIO_0
 237 # P9_45 = DGND          # DGND - GPIO_0
 238 # P9_46 = DGND          # DGND - GPIO_0
 239
 240
 241 ##########################################
 242 # common to all beagles
 243 USR0 = Pin("USR0")  # USR0 - GPIO_53
 244 USR1 = Pin("USR1")  # USR1 - GPIO_54
 245 USR2 = Pin("USR2")  # USR2 - GPIO_55
 246 USR3 = Pin("USR3")  # USR3 - GPIO_56
 247
 248
 249 ##########################################
 250 # specials
 251
 252 # analog input
 253 AIN0 = Pin("AIN0")
 254 AIN1 = Pin("AIN1")
 255 AIN2 = Pin("AIN2")
 256 AIN3 = Pin("AIN3")
 257 AIN4 = Pin("AIN4")
 258 AIN5 = Pin("AIN5")
 259 AIN6 = Pin("AIN6")
 260 AIN7 = Pin("AIN7")
 261
 262 # PWM
 263 EHRPWM0A = Pin("EHRPWM0A")
 264 EHRPWM0B = Pin("EHRPWM0B")
 265 EHRPWM1A = Pin("EHRPWM1A")
 266 EHRPWM1B = Pin("EHRPWM1B")
 267 EHRPWM2A = Pin("EHRPWM2A")
 268 EHRPWM2B = Pin("EHRPWM2B")
 269 ECAPPWM0 = Pin("ECAPPWM0")
 270 ECAPPWM2 = Pin("ECAPPWM2")
 271 TIMER4 = Pin("TIMER4")
 272 TIMER5 = Pin("TIMER5")
 273 TIMER6 = Pin("TIMER6")
 274 TIMER7 = Pin("TIMER7")
 275
 276
 277 # I2C1
 278 I2C1_SDA = Pin("I2C1_SDA")
 279 I2C1_SCL = Pin("I2C1_SCL")
 280
 281 # I2C2
 282 I2C2_SDA = Pin("I2C2_SDA")
 283 I2C2_SCL = Pin("I2C2_SCL")
 284
 285 # SPI0
 286 SPI0_CS0 = Pin("SPI0_CS0")
 287 SPI0_SCLK = Pin("SPI0_SCLK")
 288 SPI0_D1 = Pin("SPI0_D1")
 289 SPI0_D0 = Pin("SPI0_D0")
 290
 291 # SPI1
 292 SPI1_CS0 = Pin("SPI1_CS0")
 293 SPI1_CS1 = Pin("SPI1_CS1")
 294 SPI1_SCLK = Pin("SPI1_SCLK")
 295 SPI1_D1 = Pin("SPI1_D1")
 296 SPI1_D0 = Pin("SPI1_D0")
 297
 298 # UART0
 299 UART0_TXD = Pin("UART0_TXD")
 300 UART0_RXD = Pin("UART0_RXD")
 301
 302 # UART1
 303 UART1_TXD = Pin("UART1_TXD")
 304 UART1_RXD = Pin("UART1_RXD")
 305 UART1_RTSn = Pin("UART1_RTSn")
 306 UART1_CTSn = Pin("UART1_CTSn")
 307
 308 # UART2
 309 UART2_TXD = Pin("UART2_TXD")
 310 UART2_RXD = Pin("UART2_RXD")
 311
 312 # UART3
 313 UART3_TXD = Pin("UART3_TXD")
 314 UART3_RXD = Pin("UART3_RXD")
 315 UART3_RTSn = Pin("UART3_RTSn")
 316 UART3_CTSn = Pin("UART3_CTSn")
 317
 318 # UART4
 319 UART4_TXD = Pin("UART4_TXD")
 320 UART4_RXD = Pin("UART4_RXD")
 321 UART4_RTSn = Pin("UART4_RTSn")
 322 UART4_CTSn = Pin("UART4_CTSn")
 323
 324 # UART5
 325 UART5_TXD = Pin("UART5_TXD")
 326 UART5_RXD = Pin("UART5_RXD")
 327 UART5_RTSn = Pin("UART5_RTSn")
 328 UART5_CTSn = Pin("UART5_CTSn")
 329
 330
 331 # ordered as spiId, sckId, mosiId, misoId
 332 spiPorts = (
 333     (1, SPI0_SCLK, SPI0_D1, SPI0_D0),
 334     (2, SPI1_SCLK, SPI1_D1, SPI1_D0),
 335 )
 336
 337 # ordered as uartId, txId, rxId
 338 uartPorts = (
 339     # (0, UART0_TXD, UART0_RXD),
 340     # (1, UART1_TXD, UART1_RXD),
 341     # (2, UART2_TXD, UART2_RXD),
 342     # (4, UART4_TXD, UART4_RXD),
 343     # (5, UART5_TXD, UART5_RXD),
 344 )
 345
 346 # ordered as i2cId, SCL, SDA
 347 i2cPorts = (
 348     (1, I2C1_SCL, I2C1_SDA),
 349     (2, I2C2_SCL, I2C2_SDA),
 350 )
 351
 352 PWM1 = P1_36
 353 PWM2 = P1_33
 354 PWM3 = P2_1
 355 PWM4 = P2_3
 356
 357 pwmOuts = (((0, 0), PWM1), ((0, 1), PWM2), ((2, 0), PWM3), ((4, 1), PWM4))