Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

How to change the primary UART of a Raspberry Pi #3938

Open
nllho opened this issue Nov 25, 2024 · 0 comments
Open

How to change the primary UART of a Raspberry Pi #3938

nllho opened this issue Nov 25, 2024 · 0 comments
Labels
backlog We'll be getting to it eventually documentation troubleshooting

Comments

@nllho
Copy link

nllho commented Nov 25, 2024

Related to #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.

@nllho nllho added documentation backlog We'll be getting to it eventually troubleshooting labels Nov 25, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backlog We'll be getting to it eventually documentation troubleshooting
Projects
None yet
Development

No branches or pull requests

1 participant