How to change the primary UART of a Raspberry Pi

Ouverte
#3,938 1 commentaire 0 réactions 1 personne assignée Voir sur GitHub

@katshann-raspberry y travaille déjà.

Depuis le 11/8/2026.

  • #4335 par @gudiri1 — fermée sans fusion

Évaluation

Cette issue n'a pas encore été évaluée.

Description

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.

Langage dominant
Python
Étoiles
5.6k
Forks
2.1k
Métriques de merge des PR
Aucune PR mergée en 30 j

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de raspberrypi/documentation

Toutes les issues de raspberrypi/documentation

Issues similaires

Plus d'issues Python

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.