src/spec/i_class.py

   1 #!/usr/bin/env python
   2
   3 from spec.base import PinSpec
   4
   5 from spec.ifaceprint import display, display_fns, check_functions
   6 from spec.ifaceprint import display_fixed
   7
   8
   9 def pinspec():
  10     pinbanks = {
  11         'A': 28,
  12     }
  13     fixedpins = {
  14         'CTRL_SYS': [
  15             'TEST',
  16             'JTAG_SEL',
  17             'UBOOT_SEL',
  18             'NMI#',
  19             'RESET#',
  20             'CLK24M_IN',
  21             'CLK24M_OUT',
  22             'PLLTEST',
  23             'PLLREGIO',
  24             'PLLVP25',
  25             'PLLDV',
  26             'PLLVREG',
  27             'PLLGND',
  28         ],
  29         'POWER_GPIO': [
  30             'VDD_GPIOB',
  31             'GND_GPIOB',
  32         ]}
  33     function_names = {'EINT': 'External Interrupt',
  34                       'FB': 'MC68k FlexBus',
  35                       'IIS': 'I2S Audio',
  36                       'JTAG': 'JTAG (JTAG_SEL=HI/LO)',
  37                       'LCD': '24-pin RGB/TTL LCD',
  38                       'RG': 'RGMII Ethernet',
  39                       'MMC': 'eMMC 1/2/4/8 pin',
  40                       'PWM': 'PWM (pulse-width modulation)',
  41                       'SD0': 'SD/MMC 0',
  42                       'SD1': 'SD/MMC 1',
  43                       'SD2': 'SD/MMC 2',
  44                       'MSPI0': 'SPI (Serial Peripheral Interface) Master 0',
  45                       'MSPI1': 'SPI (Serial Peripheral Interface) Master 1',
  46                       'MQSPI': 'Quad SPI Master 0',
  47                       'TWI0': 'I2C 0',
  48                       'TWI1': 'I2C 1',
  49                       'TWI2': 'I2C 2',
  50                       'QUART0': 'UART (TX/RX/CTS/RTS) 0',
  51                       'QUART1': 'UART (TX/RX/CTS/RTS) 1',
  52                       'UART0': 'UART (TX/RX) 0',
  53                       'UART1': 'UART (TX/RX) 1',
  54                       'UART2': 'UART (TX/RX) 2',
  55                       'ULPI0': 'ULPI (USB Low Pin-count) 0',
  56                       'ULPI1': 'ULPI (USB Low Pin-count) 1',
  57                       'ULPI2': 'ULPI (USB Low Pin-count) 2',
  58                       }
  59
  60     ps = PinSpec(pinbanks, fixedpins, function_names,
  61                  ['lcd', 'jtag'])
  62
  63     # Bank A, 0-27
  64     ps.gpio("", ('A', 0), 0, 0, 28)
  65     ps.rgbttl("", ('A', 0), 1, limit=22)
  66     ps.mspi("0", ('A', 10), 2)
  67     ps.mquadspi("", ('A', 4), 2)
  68     ps.uart("0", ('A', 16), 2)
  69     ps.i2c("1", ('A', 18), 2)
  70     ps.pwm("", ('A', 21), 2, 0, 3)
  71     ps.sdmmc("0", ('A', 22), 3)
  72     ps.eint("", ('A', 0), 3, 0, 4)
  73     ps.eint("", ('A', 20), 2, 4, 1)
  74     ps.eint("", ('A', 23), 1, 5, 1)
  75     ps.sdmmc("1", ('A', 4), 3)
  76     ps.jtag("", ('A', 10), 3)
  77     ps.uartfull("0", ('A', 14), 3)
  78     ps.uartfull("1", ('A', 18), 3)
  79     ps.jtag("", ('A', 24), 2)
  80     ps.mspi("1", ('A', 24), 1)
  81     ps.i2c("0", ('A', 0), 2)
  82     ps.uart("1", ('A', 2), 2)
  83     ps.uart("2", ('A', 14), 2)
  84
  85     # Scenarios below can be spec'd out as either "find first interface"
  86     # by name/number e.g. SPI1, or as "find in bank/mux" which must be
  87     # spec'd as "BM:Name" where B is bank (A-F), M is Mux (0-3)
  88     # EINT and PWM are grouped together, specially, but may still be spec'd
  89     # using "BM:Name".  Pins are removed in-order as listed from
  90     # lists (interfaces, EINTs, PWMs) from available pins.
  91
  92     i_class = ['ULPI0/8', 'ULPI1', 'MMC', 'SD0', 'UART0',
  93                'TWI0', 'MSPI0', 'B3:SD1', ]
  94     i_class_eint = ['EINT_0', 'EINT_1', 'EINT_2', 'EINT_3', 'EINT_4']
  95     i_class_pwm = ['B2:PWM_0']
  96     descriptions = {
  97         'MMC': 'internal (on Card)',
  98         'SD0': 'user-facing: internal (on Card), multiplexed with JTAG\n'
  99         'and UART2, for debug purposes',
 100         'TWI2': 'I2C.\n',
 101         'E2:SD1': '',
 102         'MSPI1': '',
 103         'UART0': '',
 104         'B1:LCD/22': '18-bit RGB/TTL LCD',
 105         'ULPI0/8': 'user-facing: internal (on Card), USB-OTG ULPI PHY',
 106         'ULPI1': 'dual USB2 Host ULPI PHY'
 107     }
 108
 109     ps.add_scenario("I-Class", i_class, i_class_eint, i_class_pwm,
 110                     descriptions)
 111
 112     return ps