QUERY · ISSUE

docs: No instructions for REPL over UART on RP2

openby MarcelloTheArcaneopened 2026-02-26updated 2026-03-04

docs

Documentation URL

https://docs.micropython.org/en/latest/rp2/quickref.html

Description

On the UART documentation page, there is a note:

REPL over UART is disabled by default. You can see the Getting started with MicroPython on the RP2xxx for details on how to enable REPL over UART.

If you follow the link to the "getting started" page (https://docs.micropython.org/en/latest/rp2/tutorial/intro.html#rp2-intro), it just says:

Getting started with MicroPython on the RP2xxx
Let’s get started!

Factory reset

Programmable IO

I can't seem to find any instructions for accessing the REPL over UART (i.e. which UART pins, and how to configure Micropython).

Code of Conduct

Yes, I agree

CANDIDATE · PULL REQUEST

Rp2 general

closedby NitiKauropened 2021-06-25updated 2021-07-10

docsport-rp2

(no description)

Assessment

S Sonnet · medium

PR #7461 modifies exactly the two files the issue identifies as problematic — docs/rp2/quickref.rst and docs/rp2/tutorial/intro.rst — and adds 242 lines to intro.rst. However, issue #18875 has a much higher number than the PR, meaning the issue was filed after the PR existed. If the PR had been merged and included specific UART REPL instructions (which pins to use, how to configure MicroPython), the issue would not have been raised. The PR's empty description and generic title "Rp2 general" suggest it is a broad documentation expansion, not a targeted fix for the missing UART REPL instructions. The quickref.rst change shown ("See :ref:machine.UART <machine.UART>. ::") is just a cross-reference, not UART REPL setup content. The PR works in the same documentation area and may provide partial context, but does not appear to resolve the specific gap the issue reports.

Suggested action

Review whether PR #7461 was merged and whether its intro.rst additions include UART REPL pin configuration and setup instructions. If the PR is still open, it should be updated to explicitly include the missing UART REPL content that issue #18875 identifies. If the PR was merged without that content, the issue remains open and needs a separate fix adding UART REPL instructions to the getting-started guide.