alif: Support more fine-grained pin alternate function selection.

Now raises an exception if the pin doesn't support the alternate function
unit number and line type, eg UART0_TX (previously it only checked the
peripheral).

Signed-off-by: Damien George <damien@micropython.org>
This commit is contained in:
Damien George
2025-03-20 14:28:57 +11:00
parent 29a873ec07
commit 737acef5cb
8 changed files with 371 additions and 185 deletions

View File

@@ -92,34 +92,183 @@ extern ringbuf_t stdin_ringbuf;
#define mp_hal_pin_obj_t const machine_pin_obj_t *
#define MP_HAL_PIN_ALT(function, unit) (MP_HAL_PIN_ALT_MAKE((MP_HAL_PIN_ALT_##function), (unit)))
#define MP_HAL_PIN_ALT_MAKE(function, unit) ((function) | ((unit) << 8))
#define MP_HAL_PIN_ALT_GET_FUNC(alt) ((alt) & 0xff)
#define MP_HAL_PIN_ALT_GET_UNIT(alt) ((alt) >> 8)
enum {
MP_HAL_PIN_ALT_NONE = 0,
MP_HAL_PIN_ALT_GPIO,
MP_HAL_PIN_ALT_ANA,
MP_HAL_PIN_ALT_AUDIO,
MP_HAL_PIN_ALT_CAM,
MP_HAL_PIN_ALT_CDC,
MP_HAL_PIN_ALT_CMP,
MP_HAL_PIN_ALT_ETH,
MP_HAL_PIN_ALT_FAULT,
MP_HAL_PIN_ALT_HFXO,
MP_HAL_PIN_ALT_I2C,
MP_HAL_PIN_ALT_I2S,
MP_HAL_PIN_ALT_I3C,
MP_HAL_PIN_ALT_JTAG,
MP_HAL_PIN_ALT_LPCAM,
MP_HAL_PIN_ALT_LPI2C,
MP_HAL_PIN_ALT_LPI2S,
MP_HAL_PIN_ALT_LPPDM,
MP_HAL_PIN_ALT_LPSPI,
MP_HAL_PIN_ALT_LPTMR,
MP_HAL_PIN_ALT_LPUART,
MP_HAL_PIN_ALT_OSPI,
MP_HAL_PIN_ALT_PDM,
MP_HAL_PIN_ALT_QEC,
MP_HAL_PIN_ALT_SD,
MP_HAL_PIN_ALT_SPI,
MP_HAL_PIN_ALT_UART,
MP_HAL_PIN_ALT_UT,
MP_HAL_PIN_ALT_AUDIO_CLK,
MP_HAL_PIN_ALT_CAM_D0,
MP_HAL_PIN_ALT_CAM_D1,
MP_HAL_PIN_ALT_CAM_D2,
MP_HAL_PIN_ALT_CAM_D3,
MP_HAL_PIN_ALT_CAM_D4,
MP_HAL_PIN_ALT_CAM_D5,
MP_HAL_PIN_ALT_CAM_D6,
MP_HAL_PIN_ALT_CAM_D7,
MP_HAL_PIN_ALT_CAM_D8,
MP_HAL_PIN_ALT_CAM_D9,
MP_HAL_PIN_ALT_CAM_D10,
MP_HAL_PIN_ALT_CAM_D11,
MP_HAL_PIN_ALT_CAM_D12,
MP_HAL_PIN_ALT_CAM_D13,
MP_HAL_PIN_ALT_CAM_D14,
MP_HAL_PIN_ALT_CAM_D15,
MP_HAL_PIN_ALT_CAM_HSYNC,
MP_HAL_PIN_ALT_CAM_PCLK,
MP_HAL_PIN_ALT_CAM_VSYNC,
MP_HAL_PIN_ALT_CAM_XVCLK,
MP_HAL_PIN_ALT_CDC_D0,
MP_HAL_PIN_ALT_CDC_D1,
MP_HAL_PIN_ALT_CDC_D2,
MP_HAL_PIN_ALT_CDC_D3,
MP_HAL_PIN_ALT_CDC_D4,
MP_HAL_PIN_ALT_CDC_D5,
MP_HAL_PIN_ALT_CDC_D6,
MP_HAL_PIN_ALT_CDC_D7,
MP_HAL_PIN_ALT_CDC_D8,
MP_HAL_PIN_ALT_CDC_D9,
MP_HAL_PIN_ALT_CDC_D10,
MP_HAL_PIN_ALT_CDC_D11,
MP_HAL_PIN_ALT_CDC_D12,
MP_HAL_PIN_ALT_CDC_D13,
MP_HAL_PIN_ALT_CDC_D14,
MP_HAL_PIN_ALT_CDC_D15,
MP_HAL_PIN_ALT_CDC_D16,
MP_HAL_PIN_ALT_CDC_D17,
MP_HAL_PIN_ALT_CDC_D18,
MP_HAL_PIN_ALT_CDC_D19,
MP_HAL_PIN_ALT_CDC_D20,
MP_HAL_PIN_ALT_CDC_D21,
MP_HAL_PIN_ALT_CDC_D22,
MP_HAL_PIN_ALT_CDC_D23,
MP_HAL_PIN_ALT_CDC_DE,
MP_HAL_PIN_ALT_CDC_HSYNC,
MP_HAL_PIN_ALT_CDC_PCLK,
MP_HAL_PIN_ALT_CDC_VSYNC,
MP_HAL_PIN_ALT_CMP_OUT,
MP_HAL_PIN_ALT_ETH_CRS_DV_A,
MP_HAL_PIN_ALT_ETH_CRS_DV_B,
MP_HAL_PIN_ALT_ETH_CRS_DV_C,
MP_HAL_PIN_ALT_ETH_IRQ,
MP_HAL_PIN_ALT_ETH_MDC,
MP_HAL_PIN_ALT_ETH_MDIO,
MP_HAL_PIN_ALT_ETH_REFCLK,
MP_HAL_PIN_ALT_ETH_RST,
MP_HAL_PIN_ALT_ETH_RXD0,
MP_HAL_PIN_ALT_ETH_RXD1,
MP_HAL_PIN_ALT_ETH_TXD0,
MP_HAL_PIN_ALT_ETH_TXD1,
MP_HAL_PIN_ALT_ETH_TXEN,
MP_HAL_PIN_ALT_FAULT_A,
MP_HAL_PIN_ALT_FAULT_B,
MP_HAL_PIN_ALT_FAULT_C,
MP_HAL_PIN_ALT_HFXO_OUT,
MP_HAL_PIN_ALT_I2C_SCL,
MP_HAL_PIN_ALT_I2C_SDA,
MP_HAL_PIN_ALT_I2S_SCLK,
MP_HAL_PIN_ALT_I2S_SDI,
MP_HAL_PIN_ALT_I2S_SDO,
MP_HAL_PIN_ALT_I2S_WS,
MP_HAL_PIN_ALT_I3C_SCL,
MP_HAL_PIN_ALT_I3C_SDA,
MP_HAL_PIN_ALT_JTAG_TCK,
MP_HAL_PIN_ALT_JTAG_TDATA0,
MP_HAL_PIN_ALT_JTAG_TDATA1,
MP_HAL_PIN_ALT_JTAG_TDATA2,
MP_HAL_PIN_ALT_JTAG_TDATA3,
MP_HAL_PIN_ALT_JTAG_TDI,
MP_HAL_PIN_ALT_JTAG_TDO,
MP_HAL_PIN_ALT_JTAG_TMS,
MP_HAL_PIN_ALT_JTAG_TRACECLK,
MP_HAL_PIN_ALT_LPCAM_D0,
MP_HAL_PIN_ALT_LPCAM_D1,
MP_HAL_PIN_ALT_LPCAM_D2,
MP_HAL_PIN_ALT_LPCAM_D3,
MP_HAL_PIN_ALT_LPCAM_D4,
MP_HAL_PIN_ALT_LPCAM_D5,
MP_HAL_PIN_ALT_LPCAM_D6,
MP_HAL_PIN_ALT_LPCAM_D7,
MP_HAL_PIN_ALT_LPCAM_HSYNC,
MP_HAL_PIN_ALT_LPCAM_PCLK,
MP_HAL_PIN_ALT_LPCAM_VSYNC,
MP_HAL_PIN_ALT_LPCAM_XVCLK,
MP_HAL_PIN_ALT_LPI2C_SCL,
MP_HAL_PIN_ALT_LPI2C_SDA,
MP_HAL_PIN_ALT_LPI2S_SCLK,
MP_HAL_PIN_ALT_LPI2S_SDI,
MP_HAL_PIN_ALT_LPI2S_SDO,
MP_HAL_PIN_ALT_LPI2S_WS,
MP_HAL_PIN_ALT_LPPDM_C0,
MP_HAL_PIN_ALT_LPPDM_C1,
MP_HAL_PIN_ALT_LPPDM_C2,
MP_HAL_PIN_ALT_LPPDM_C3,
MP_HAL_PIN_ALT_LPPDM_D0,
MP_HAL_PIN_ALT_LPPDM_D1,
MP_HAL_PIN_ALT_LPPDM_D2,
MP_HAL_PIN_ALT_LPPDM_D3,
MP_HAL_PIN_ALT_LPSPI_MISO,
MP_HAL_PIN_ALT_LPSPI_MOSI,
MP_HAL_PIN_ALT_LPSPI_SCLK,
MP_HAL_PIN_ALT_LPSPI_SS,
MP_HAL_PIN_ALT_LPTMR_CLK,
MP_HAL_PIN_ALT_LPUART_CTS,
MP_HAL_PIN_ALT_LPUART_RTS,
MP_HAL_PIN_ALT_LPUART_RX,
MP_HAL_PIN_ALT_LPUART_TX,
MP_HAL_PIN_ALT_OSPI_D0,
MP_HAL_PIN_ALT_OSPI_D1,
MP_HAL_PIN_ALT_OSPI_D2,
MP_HAL_PIN_ALT_OSPI_D3,
MP_HAL_PIN_ALT_OSPI_D4,
MP_HAL_PIN_ALT_OSPI_D5,
MP_HAL_PIN_ALT_OSPI_D6,
MP_HAL_PIN_ALT_OSPI_D7,
MP_HAL_PIN_ALT_OSPI_RXDS,
MP_HAL_PIN_ALT_OSPI_SCLK,
MP_HAL_PIN_ALT_OSPI_SCLKN,
MP_HAL_PIN_ALT_OSPI_SS0,
MP_HAL_PIN_ALT_OSPI_SS1,
MP_HAL_PIN_ALT_PDM_C0,
MP_HAL_PIN_ALT_PDM_C1,
MP_HAL_PIN_ALT_PDM_C2,
MP_HAL_PIN_ALT_PDM_C3,
MP_HAL_PIN_ALT_PDM_D0,
MP_HAL_PIN_ALT_PDM_D1,
MP_HAL_PIN_ALT_PDM_D2,
MP_HAL_PIN_ALT_PDM_D3,
MP_HAL_PIN_ALT_QEC_X,
MP_HAL_PIN_ALT_QEC_Y,
MP_HAL_PIN_ALT_QEC_Z,
MP_HAL_PIN_ALT_SD_CLK,
MP_HAL_PIN_ALT_SD_CMD,
MP_HAL_PIN_ALT_SD_D0,
MP_HAL_PIN_ALT_SD_D1,
MP_HAL_PIN_ALT_SD_D2,
MP_HAL_PIN_ALT_SD_D3,
MP_HAL_PIN_ALT_SD_D4,
MP_HAL_PIN_ALT_SD_D5,
MP_HAL_PIN_ALT_SD_D6,
MP_HAL_PIN_ALT_SD_D7,
MP_HAL_PIN_ALT_SD_RST,
MP_HAL_PIN_ALT_SPI_MISO,
MP_HAL_PIN_ALT_SPI_MOSI,
MP_HAL_PIN_ALT_SPI_SCLK,
MP_HAL_PIN_ALT_SPI_SS0,
MP_HAL_PIN_ALT_SPI_SS1,
MP_HAL_PIN_ALT_SPI_SS2,
MP_HAL_PIN_ALT_SPI_SS3,
MP_HAL_PIN_ALT_UART_CTS,
MP_HAL_PIN_ALT_UART_DE,
MP_HAL_PIN_ALT_UART_RTS,
MP_HAL_PIN_ALT_UART_RX,
MP_HAL_PIN_ALT_UART_TX,
MP_HAL_PIN_ALT_UT_T0,
MP_HAL_PIN_ALT_UT_T1,
};
typedef struct _machine_pin_obj_t {
@@ -130,7 +279,7 @@ typedef struct _machine_pin_obj_t {
uint8_t adc12_periph : 2;
uint8_t adc12_channel : 3;
qstr name;
const uint8_t alt[8];
const uint16_t alt[8]; // holds result of MP_HAL_PIN_ALT_MAKE(function, unit)
} machine_pin_obj_t;
mp_hal_pin_obj_t mp_hal_get_pin_obj(mp_obj_t pin_in);