How to change the primary UART of a Raspberry Pi

Aperta
#3,938 1 commento 0 reazioni 1 assegnatario Vedi su GitHub

@katshann-raspberry ci sta già lavorando.

Dal 11/8/2026.

  • #4335 di @gudiri1 — chiusa senza merge

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

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.

Lingua principale
Python
Stelle
5.6k
Fork
2.1k
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di raspberrypi/documentation

Tutte le issue di raspberrypi/documentation

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.