rp2: Fix RP2350 and RP2350B pin alt functions. by Gadgetoid · Pull Request #17692 · micropython/micropython

Gadgetoid · 2025-07-16T17:09:34Z

RP2350 builds were using the incomplete rp2_af.csv alt function table which broke pins > 31 in RP2350B (48-pin QFN-80) builds:

>>> machine.Pin(31)
Pin(GPIO31, mode=IN, pull=PULL_DOWN)

>>> machine.Pin(32)
Pin(GPIO32, mode=ALT, pull=PULL_DOWN, alt=31)

UART_AUX (alt function 11) and PIO2 (alt function 8, directly conflicting the RP2040 function GPIO_FUNC_GPCK) were also missing.

Changes

boards/*._af.csv: Add separate alt-functions tables for RP2040,
RP2350 and RP2350B.

CMakeLists.txt: Pick correct _af.csv to pass into make-pins.py.

boards/make-pins.py: handle CORESIGHT and XIP_CS1 alt functions.

machine_pin.c: Add PIO2, CORESIGHT and XIP_CS1 alt functions.

Testing

UART_AUX

I tested UART_AUX on an RP2350B board with the following code and a Raspberry Pi Debug Probe:

from machine import Pin, UART

uart = UART(0, 115200, tx=34, rx=35)

print(Pin(34), Pin(35))

The pins are correctly configured as UART_AUX (presumably this always worked?) thanks to the use of UART_FUNCSEL_NUM, but configuring as UART AUX is now enabled in machine.Pin too.

To be totally sure this worked, I set up UART 0 on pins 0 and 1, then changed them with machine.Pin():

from machine import Pin, UART

uart = UART(0, 115200, tx=0, rx=1)

Pin(0, mode=Pin.IN)
Pin(1, mode=Pin.IN)

TX = Pin(34, mode=Pin.ALT, alt=Pin.ALT_UART_AUX)
RX = Pin(35, mode=Pin.ALT, alt=Pin.ALT_UART_AUX)

B-variant Build

I set up a generic B-variant for testing, built against the vanilla RPI_PICO2 board with:

make BOARD=RPI_PICO2 BOARD_VARIANT=B

And the following config:

ports/rp2/boards/RPI_PICO2/mpconfigvariant_B.cmake

set(PICO_BOARD "pico2b")
set(PICO_BOARD_HEADER_DIRS ${CMAKE_CURRENT_LIST_DIR})
set(PICO_NUM_GPIOS 48)
set(MICROPY_BOARD_PINS "${MICROPY_BOARD_DIR}/pins_b.csv")

ports/rp2/boards/RPI_PICO2/pico2b.h:

#include "boards/pico2.h"

// Required to enable 48-pin B variant
#undef PICO_RP2350A

ports/rp2/boards/RPI_PICO2/pins_b.csv:

GP0,GPIO0
GP1,GPIO1
GP2,GPIO2
GP3,GPIO3
GP4,GPIO4
GP5,GPIO5
GP6,GPIO6
GP7,GPIO7
GP8,GPIO8
GP9,GPIO9
GP10,GPIO10
GP11,GPIO11
GP12,GPIO12
GP13,GPIO13
GP14,GPIO14
GP15,GPIO15
GP16,GPIO16
GP17,GPIO17
GP18,GPIO18
GP19,GPIO19
GP20,GPIO20
GP21,GPIO21
GP22,GPIO22
GP25,GPIO25
GP26,GPIO26
GP27,GPIO27
GP28,GPIO28
GP29,GPIO29
GP30,GPIO30
GP31,GPIO31
GP32,GPIO32
GP33,GPIO33
GP34,GPIO34
GP35,GPIO35
GP36,GPIO36
GP37,GPIO37
GP38,GPIO38
GP39,GPIO39
GP40,GPIO40
GP41,GPIO41
GP42,GPIO42
GP43,GPIO43
GP44,GPIO44
GP45,GPIO45
GP46,GPIO46
GP47,GPIO47
LED,GPIO25

Trade-offs and Alternatives

I'm not sure we need CORESIGHT and XIP_CS1 alt functions but they are included for completeness. They needed fixups in make-pins.py because it naively chops the first portion of the signal name off and tries to use that as the GPIO function.

UART_AUX is more interesting, it gives some more UART options on alt-function 11, but also needs special casing to ensure GPIO_FUNC_UART_AUX is used in place of GPIO_FUNC_UART. eg:

const machine_pin_af_obj_t pin_GPIO14_af[] = {
    AF(1, SPI , 1), // SPI1_SCK
    AF(2, UART, 0), // UART0_CTS
    AF(3, I2C , 1), // I2C1_SDA
    AF(4, PWM , 7), // PWM7_A
    AF(5, SIO , 0), // SIO
    AF(6, PIO0, 0), // PIO0
    AF(7, PIO1, 1), // PIO1
    AF(8, PIO2, 2), // PIO2
    AF(9, GPCK, 0), // GPCK_GPIN1
    AF(10, USB , 0), // USB_VBUS_EN
    AF(11, UART_AUX, 0), // UART0_TX
};

The addition of a PIO2 alt function constant might be a separate and important fix for RP2350 variants in general (and may conflict, I need to check that but I've run out of day). Edit: I checked. I don't think anyone has caught this, though there are other outstanding issues with PIO2.

Gadgetoid · 2025-07-16T17:25:27Z

Would it be reasonable to include a new GENERIC board for RP2 which mirrors the Pico build, but includes a B variant- or would it be acceptable to hang this B variant off RPI_PICO2 as I've detailed above?

I feel a readily available, generic B variant would make it much easier to test for issues/regressions in this bringup. While I say this with two B-variant boards on my desk that could be added here, a vendor custom board might introduce unknowns.

There is not, and (afaik) will never be, a B-variant RPI_PICO2 so it might be the wrongest place to hang this, but it's very tidy 😆

github-actions · 2025-07-16T17:26:44Z

Code size report:

   bare-arm:    +0 +0.000% 
minimal x86:    +0 +0.000% 
   unix x64:    +0 +0.000% standard
      stm32:    +0 +0.000% PYBV10
     mimxrt:    +0 +0.000% TEENSY40
        rp2:    +0 +0.000% RPI_PICO_W
       samd:    +0 +0.000% ADAFRUIT_ITSYBITSY_M4_EXPRESS
  qemu rv32:    +0 +0.000% VIRT_RV32

Gadgetoid · 2025-07-16T21:32:55Z

I've also completely overlooked RP2350's Alt Function 0 here, which is used for HSTX.

Right now make-pins.py assumes alt-functions start at 1. I'm not quite sure how to reconcile this.

RP2350 builds were using the incomplete rp2_af.csv alt function table which broke pins > 31 in RP2350B (48-pin QFN-80) builds: >>> machine.Pin(31) Pin(GPIO31, mode=IN, pull=PULL_DOWN) >>> machine.Pin(32) Pin(GPIO32, mode=ALT, pull=PULL_DOWN, alt=31) boards/*._af.csv: Add separate alt-functions tables for RP2040, RP2350 and RP2350B. CMakeLists.txt: Pick correct _af.csv to pass into make-pins.py. boards/make-pins.py: handle CORESIGHT and XIP_CS1 alt functions. machine_pin.c: Add PIO2, CORESIGHT and XIP_CS1 alt functions. Signed-off-by: Phil Howard <[email protected]>

Gadgetoid · 2025-07-17T10:01:36Z

Actually running the test build on an RP2350B doesn't seem to fix the problem I was seeing, but rather makes it worse:

>>> machine.Pin.board.GP3
Pin(GPIO3, mode=ALT, pull=PULL_DOWN, alt=31)

Looks like all pins now default to alt=31 which is GPIO_FUNC_NULL whereas before the first 29 would report as, presumably, SIO... I'm not actually sure which condition is the bug.

Edit: Okay I have fired up vanilla MicroPython on an o.g. Pico and, indeed, alt=31 (GPIO_FUNC_NULL) is the correct reset condition. I'm not sure why what I've changed has fixed that for the lower pins, but it's clear this issue affects RP2350 (non-B variant) boards (such as Pico 2 and Pico 2 W) in myriad ways.

dpgeorge

@Gadgetoid thanks for this PR. Apart from the minor comments it looks all correct to me, it seems quite an "obvious" fix.

I checked RPI_PICO firmware and it's unchanged with this PR (binary equivalent except for the embedded git hash). So that's good, nothing to worry about with the RP2040.

For RP2350 based boards, it looks correct (as I say above). Any strangeness you see with default alt=31 doesn't look related to this PR, and we should tackle that separately (if it needs tackling at all).

dpgeorge · 2025-10-27T02:09:38Z

+    else()
+        set(GEN_PINS_AF_CSV "${MICROPY_PORT_DIR}/boards/rp2350_af.csv")
+    endif()
+endif()


Maybe the default PICO_NUM_GPIOS bits of code below should come before this section, just to be clear what the default is? Ie:

if(NOT PICO_NUM_GPIOS) set(PICO_NUM_GPIOS 30) endif() if(NOT PICO_NUM_EXT_GPIOS) set(PICO_NUM_EXT_GPIOS 10) endif() if(PICO_RP2040) set(GEN_PINS_AF_CSV "${MICROPY_PORT_DIR}/boards/rp2040_af.csv") elseif(PICO_RP2350) if(PICO_NUM_GPIOS EQUAL 48) set(GEN_PINS_AF_CSV "${MICROPY_PORT_DIR}/boards/rp2350b_af.csv") else() set(GEN_PINS_AF_CSV "${MICROPY_PORT_DIR}/boards/rp2350_af.csv") endif() endif()

I made this change.

dpgeorge · 2025-10-27T02:10:32Z

        af_unit = int(m.group(3)) if m.group(3) is not None else 0
+        if af_idx == 10:
+            # AF11 uses UART_AUX in lieu of UART
+            af_fn = "UART_AUX"


Instead of this special case, could just name the pins in the af.csv file like UART_AUX0_TX etc. That won't match the datasheet exactly but could be a little clearer? Not sure.

I left this as-is, it was too tricky to change the af.csv file due to the way the regex works here.

Could possibly be cleaned up in the future.

dpgeorge · 2025-10-27T02:10:56Z

+            af_fn = "UART_AUX"
+        if af_fn.startswith("QMI"):
+            # The full func name is GPIO_FUNC_XIP_CS1
+            af_fn = "XIP_CS1"


As above, could rename the pins in the af.csv files so this bit isn't needed.

Left as-is.

dpgeorge · 2025-10-27T02:11:04Z

+            af_fn = "XIP_CS1"
+        if af_fn.startswith("TRACE"):
+            # The various TRACE functions all belong under CORESIGHT_TRACE
+            af_fn = "CORESIGHT_TRACE"


As above, could rename pins.

Left as-is.

dpgeorge · 2025-10-27T02:16:02Z

    { MP_ROM_QSTR(MP_QSTR_ALT_USB), MP_ROM_INT(GPIO_FUNC_USB) },
+    #if PICO_RP2350
+    { MP_ROM_QSTR(MP_QSTR_ALT_XIP_CS1), MP_ROM_INT(GPIO_FUNC_XIP_CS1) },
+    { MP_ROM_QSTR(MP_QSTR_ALT_CORESIGHT), MP_ROM_INT(GPIO_FUNC_CORESIGHT_TRACE) },


Should this be MP_QSTR_ALT_CORESIGHT_TRACE to match both the C-level enum GPIO_FUNC_CORESIGHT_TRACE and the af_fn name?

Looks like there are 3 options for naming this alt func: TRACE, CORESIGHT and CORESIGHT_TRACE. All 3 seem reasonable to me (the C enum is GPIO_FUNC_CORESIGHT_TRACE and the pin alt func names all start with TRACE). But which ever one is chosen, the QSTR here should match it.

I renamed the QSTR to ALT_CORESIGHT_TRACE.

sfe-SparkFro · 2025-10-27T21:58:10Z

I've also completely overlooked RP2350's Alt Function 0 here, which is used for HSTX.

Right now make-pins.py assumes alt-functions start at 1. I'm not quite sure how to reconcile this.

FYI I'm taking a crack at an implementation for #17111, so will a way to set alt function 0 for HSTX.

sfe-SparkFro · 2025-10-27T23:07:46Z

Actually, just tinkered around with this on my end. It's fairly trivial to fix the alt functions starting at 1:

micropython/ports/rp2/boards/make-pins.py

Line 68 in 6773051

self._afs.append((af_idx + 1, af_fn, af_unit, af))

Change to self._afs.append((af_idx, af_fn, af_unit, af))

Then in the .csv files, add an extra column for AF0:

Pin,AF0,AF1,AF2,AF3,AF4,AF5,AF6,AF7,AF8,AF9,AF10,AF11
GPIO0,,SPI0_RX,UART0_TX,I2C0_SDA,PWM0_A,SIO,PIO0,PIO1,PIO2,QMI_CS1,USB_OVCUR_DET,
...
GPIO12,HSTX,SPI1_RX,UART0_TX,I2C0_SDA,PWM6_A,SIO,PIO0,PIO1,PIO2,GPCK_GPIN0,USB_OVCUR_DET,
...

Also need to add the ALT_HSTX QSTR:

micropython/ports/rp2/machine_pin.c

Lines 510 to 511 in 6773051

    
           // Pins alternate functions 
        
           { MP_ROM_QSTR(MP_QSTR_ALT_SPI), MP_ROM_INT(GPIO_FUNC_SPI) },

Add { MP_ROM_QSTR(MP_QSTR_ALT_HSTX), MP_ROM_INT(GPIO_FUNC_HSTX) }, within an #ifdef RP2350 (or whatever the exact macro is).

dpgeorge · 2025-10-27T23:17:30Z

Then in the .csv files, add an extra column for AF0:

That would be needed for RP2040 as well.

It looks quite straightforward, but I think best for a follow-up PR, so we can get this one through.

sfe-SparkFro · 2025-10-29T22:34:22Z

I've also completely overlooked RP2350's Alt Function 0 here, which is used for HSTX.
Right now make-pins.py assumes alt-functions start at 1. I'm not quite sure how to reconcile this.

FYI I'm taking a crack at an implementation for #17111, so will a way to set alt function 0 for HSTX.

See #18345!

dpgeorge · 2025-11-20T12:29:08Z

@Gadgetoid I'm happy to make the changes I suggested above, so we can get this fix in ASAP for the upcoming 1.27.0 release.

Gadgetoid · 2025-11-20T13:11:39Z

@Gadgetoid I'm happy to make the changes I suggested above, so we can get this fix in ASAP for the upcoming 1.27.0 release.

Please go ahead if you can, I'm buried at the moment! Sorry!

I can't remember if I addressed it here, but the alt functions of RP2040 and RP2350 don't quite match up such that a pin configured as CS1 or for coresight trace (alt9 on RP2350, non existent on RP2040) will read as USB_something (alt10 on RP2350, alt9 on RP2040).

I noticed this when using the OTP fuses for setting CS1_GPIO.

dpgeorge · 2025-11-21T03:34:33Z

Merged in 40df953 with minor changes as mentioned above.

I can't remember if I addressed it here, but the alt functions of RP2040 and RP2350 don't quite match up such that a pin configured as CS1 or for coresight trace (alt9 on RP2350, non existent on RP2040) will read as USB_something (alt10 on RP2350, alt9 on RP2040).

Not sure if that's still an issue, but can be addressed later if needed.

sfe-SparkFro · 2025-11-21T17:35:18Z

Merged in 40df953 with minor changes as mentioned above.

🎉

Then in the .csv files, add an extra column for AF0:

That would be needed for RP2040 as well.

It looks quite straightforward, but I think best for a follow-up PR, so we can get this one through.

See #18458

sfe-SparkFro · 2025-11-21T17:50:13Z

I can't remember if I addressed it here, but the alt functions of RP2040 and RP2350 don't quite match up such that a pin configured as CS1 or for coresight trace (alt9 on RP2350, non existent on RP2040) will read as USB_something (alt10 on RP2350, alt9 on RP2040).

Not sure if that's still an issue, but can be addressed later if needed.

Not sure if I understand the concern correctly, but here's some testing that seems to have good behavior with an RP2350 board:

>>> from machine import Pin
>>> Pin(0, mode=Pin.ALT, alt=Pin.ALT_XIP_CS1) # Correct and expected behavior
Pin(GPIO0, mode=ALT, alt=XIP_CS1)
>>> Pin(0, mode=Pin.ALT, alt=Pin.ALT_USB) # Correct and expected behavior
Pin(GPIO0, mode=ALT, alt=USB)
>>> Pin(0, mode=Pin.ALT, alt=Pin.ALT_UART_AUX) # Correct and expected behavior
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: invalid pin af: 11
>>> Pin(0, mode=Pin.ALT, alt=Pin.ALT_CORESIGHT_TRACE) # Slightly quirky, but results in the correct thing
Pin(GPIO0, mode=ALT, alt=XIP_CS1)

Alt functions from the datasheet for reference:

Follow up from micropython#17692. Signed-off-by: Dryw Wade <[email protected]>

dpgeorge · 2025-11-23T12:45:47Z

Thanks @sfe-SparkFro for testing. Those results above look correct to me.

A follow up to 40df953 / PR #17692, this commit adds the HSTX alternate pin function for GPIO12-19 on the RP2350. Signed-off-by: Dryw Wade <[email protected]>

A follow up to cb2d7a4 / PR micropython#17692, this commit adds the HSTX alternate pin function for GPIO12-19 on the RP2350. Signed-off-by: Dryw Wade <[email protected]>

Gadgetoid force-pushed the patch-rpi-make-pins branch 3 times, most recently from 8b872c3 to 3848965 Compare July 16, 2025 17:17

dpgeorge added the port-rp2 label Jul 17, 2025

Gadgetoid force-pushed the patch-rpi-make-pins branch from 3848965 to 25c09fa Compare July 17, 2025 09:54

Gadgetoid mentioned this pull request Jul 23, 2025

RP2350: PIO scripts fail, despite running on RP2040 #17047

Closed

dpgeorge added this to the release-1.27.0 milestone Aug 1, 2025

dpgeorge mentioned this pull request Aug 1, 2025

RP2350: PIO2 State Machines do not work #17509

Closed

dpgeorge reviewed Oct 27, 2025

View reviewed changes

sfe-SparkFro mentioned this pull request Oct 29, 2025

rp2: Add HSTX support. #18345

Open

dpgeorge closed this Nov 21, 2025

sfe-SparkFro mentioned this pull request Nov 21, 2025

rp2: Add HSTX ALT function. #18458

Closed

sfe-SparkFro added a commit to sparkfun/micropython that referenced this pull request Nov 21, 2025

rp2: Add HSTX ALT function.

7a554db

Follow up from micropython#17692. Signed-off-by: Dryw Wade <[email protected]>

dpgeorge pushed a commit that referenced this pull request Dec 1, 2025

rp2: Add HSTX alternate function.

1ef76c7

A follow up to 40df953 / PR #17692, this commit adds the HSTX alternate pin function for GPIO12-19 on the RP2350. Signed-off-by: Dryw Wade <[email protected]>

Conversation

Gadgetoid commented Jul 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Testing

UART_AUX

B-variant Build

Trade-offs and Alternatives

Uh oh!

Gadgetoid commented Jul 16, 2025

Uh oh!

github-actions Bot commented Jul 16, 2025

Uh oh!

Gadgetoid commented Jul 16, 2025

Uh oh!

Gadgetoid commented Jul 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dpgeorge left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sfe-SparkFro commented Oct 27, 2025

Uh oh!

sfe-SparkFro commented Oct 27, 2025

Uh oh!

dpgeorge commented Oct 27, 2025

Uh oh!

sfe-SparkFro commented Oct 29, 2025

Uh oh!

dpgeorge commented Nov 20, 2025

Uh oh!

Gadgetoid commented Nov 20, 2025

Uh oh!

dpgeorge commented Nov 21, 2025

Uh oh!

sfe-SparkFro commented Nov 21, 2025

Uh oh!

sfe-SparkFro commented Nov 21, 2025

Uh oh!

dpgeorge commented Nov 23, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Gadgetoid commented Jul 16, 2025 •

edited

Loading

Gadgetoid commented Jul 17, 2025 •

edited

Loading