QUERY · ISSUE

stm32: Support pins with multiple AFs for the same peripheral.

openby jimmoopened 2021-11-17updated 2026-03-24

port-stm32

For example, on WB55, pin PD3 can be SPI2_SCK on AF3 and SPI2_MISO on AF5.

PortD,PD3,,,,SPI2_SCK,,SPI2_MISO,,,,,QUADSPI_BK1_NCS,,,,,EVENTOUT,

When we configure a default pin in mpconfigboard.h, it is unable (via pin_find_af and the generated code from make-pins.py) to resolve this because the AF_FN_SPI enum assumes that a given peripheral will always use the same AF number on all pins.

// This will fail, and make D3 be SPI2_SCK instead.
#define MICROPY_HW_SPI2_MISO        (pin_D3)

Here are some other AF CSV files and peripherals where different AFs share the same peripheral. Other than the WB55 SPI2 example I didn't see any that are accessible from Python. (i.e. the I2C4 are conflicting with I2C_SMBA).

boards/stm32f091_af.csv
    TIM15, USART7
boards/stm32f405_af.csv
    OTG
boards/stm32f429_af.csv
    LCD, OTG
boards/stm32f439_af.csv
    LCD, OTG
boards/stm32f722_af.csv
    OTG
boards/stm32f746_af.csv
    LCD, OTG
boards/stm32f767_af.csv
    OTG, DFSDM1, LCD, I2C4
boards/stm32h743_af.csv
    DFSDM, TIM8, SDMMC1, LCD, SAI1, TIM1, I2C4, OTG, SAI4
boards/stm32h7b3_af.csv
    OCTOSPIM, DFSDM1, PSSI, FMC, TIM8, LTDC, SDMMC1, SAI1, TIM1, I2C4
boards/stm32l072_af.csv
    TIM2, LPUART1
boards/stm32l432_af.csv
    TIM1, TIM2, COMP2, COMP1
boards/stm32l452_af.csv
    TIM1, TIM2, COMP2, COMP1
boards/stm32l476_af.csv
    TIM5, TIM2, TIM1, TIM8
boards/stm32l496_af.csv
    TIM2, SPI2, TIM8, TIM5, TIM1, QUADSPI
boards/stm32wb55_af.csv
    TIM2, TIM1, SAI1, SPI2

CANDIDATE · PULL REQUEST

stm32/boards: Fix returning incorrect af_list() with NUCLEO-F446RE.

closedby yn386opened 2022-09-02updated 2022-09-06

port-stm32

This PR fixes following problem.

How to reproduce

Some pins returns incorrect result by af_list().
For example, PB2 has two alternate function (Timer2, SPI3) but I got empty list.

>>> pb2 = machine.Pin('PB2')
>>> pb2.af_list()
[]

MicroPython Version

v1.19.1

Environment

NUCLEO-F446RE

Detail of changes

boards/NUCLEO_F446RE uses stm32f429_af.csv but some alternate functions of STM32F411 are different with STM32F429.
To fix this problem, I made stm32f446_af.csv based on stm32f429.csv.

After using stm32f446_af.csv, af_list() correctly returns alternate functions.

>>> pb2 = machine.Pin('PB2')
>>> pb2.af_list()
[Pin.AF1_TIM2, Pin.AF7_SPI3]