src/adafruit_blinka/microcontroller/am335x/pin.py

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