Skip to content

Commit ebd43e1

Browse files
authored
Merge pull request #2692 from arduino/mcmchris/uno-q/debugging-console
[PXCT-1502] UNO Q - Update User Manual (USB/TTL FTDI)
2 parents 5531f8d + f8b561c commit ebd43e1

File tree

3 files changed

+27
-0
lines changed

3 files changed

+27
-0
lines changed
32 KB
Loading
2.25 MB
Loading

content/hardware/02.uno/boards/uno-q/tutorials/01.user-manual/content.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -404,6 +404,33 @@ The LED color segments are defined as follows:
404404

405405
***The RGB LEDs are active low, this means they turn ON with logic '0'.***
406406

407+
### Hardware Debug UART Interface
408+
409+
The UNO Q provides a dedicated low-level UART interface for debugging and system diagnostics. This interface connects directly to the SoC’s main console (TTY), allowing you to observe boot and kernel logs, troubleshoot system issues, or access a shell environment before network services like SSH or ADB are available.
410+
411+
![UNO Q Debug UART](assets/debug-shell.gif)
412+
413+
This interface is available through the JCTL connector on the UNO Q. Refer to the [pinout](#pinout) section for details, and follow the wiring example above to access it.
414+
415+
***<strong>WARNING:</strong> This interface operates at __1.8 V logic__ levels and must be used with a compatible USB-to-TTL converter to avoid hardware damage.***
416+
417+
#### Prerequisites
418+
419+
- 1.8V USB to TTL converter (e.g., DSD Tech SH-U09C5)
420+
- USB-C cable to power the UNO Q
421+
- Serial Terminal (e.g., [Tera Term](https://teratermproject.github.io/index-en.html))
422+
423+
#### UART Parameters:
424+
425+
- **Baud rate:** 115200 bps
426+
- **Logic level:** 1.8 V
427+
428+
This console provides access to low-level system messages printed by the bootloaders (e.g., SPL and U-Boot), which are not visible through SSH or other high-level interfaces. For example, it allows capturing logs related to power delivery negotiation or hardware initialization during early boot stages, providing information that is otherwise inaccessible.
429+
430+
It can be used to log in to the board and interact with the system through the shell. Use the **Linux credentials** configured during the board setup process to authenticate.
431+
432+
![Shell Log in](assets/debug-shell-2.png)
433+
407434
### Power Button
408435

409436
The UNO Q features a power button that can be used to reboot the board.

0 commit comments

Comments
 (0)