How to change the primary UART of a Raspberry Pi

Offen
#3,938 1 Kommentar 0 Reaktionen 1 zugewiesene Person Auf GitHub ansehen

@katshann-raspberry arbeitet bereits daran.

Seit 11.8.2026.

  • #4335 von @gudiri1 — ohne Merge geschlossen

Bewertung

Dieses Issue wurde noch nicht bewertet.

Beschreibung

backlog documentation troubleshooting

Related to https://github.com/raspberrypi/documentation/issues/3239.

Context:

  • The primary UART is where the Linux console appears.
  • On most Raspberry Pis, the primary UART appears on the GPIO header.
  • For Raspberry Pi 5, the primary UART appears on the Debug header.

Use case:
When switching to Pi 5 from older versions, people get confused because the primary UART has changed, and they do not see the console as expected. This confusion may persist into the future with new Pi models and as people upgrade their hardware.

Current state:
The bullet points above already exist in the documentation. However, we do not currently document how to change the primary UART of a Raspberry Pi.

Possible docs solutions:

  1. Create a troubleshooting section for "the console does not appear" somewhere under initial configuration or UART configuration. This troubleshooting section could be expanded with multiple solutions, including the information here about using the correct primary UART for a given Raspberry Pi model.

  2. Add "Changing the primary UART" to https://www.raspberrypi.com/documentation/computers/configuration.html#configure-uarts. This comment by Phil explains how to change the primary UART of the Pi 5 to the GPIO header. If we create this section, we would need to confirm instructions for all Pi models.

Vorherrschende Sprache
Python
Sterne
5.6k
Forks
2.1k
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus raspberrypi/documentation

Alle Issues in raspberrypi/documentation

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.