Serial Console Debugging
Prerequisites
To perform serial debugging, you need to connect the board's UART0 interface to your PC's USB port using a USB-to-TTL serial cable.
When using a USB-to-TTL serial cable for debugging, ensure the pins are connected correctly. Incorrect connections may damage the board hardware.
It is not recommended to connect the VCC pin (red wire) of the USB-to-TTL serial cable to avoid potential damage to the board.
| Radxa CM4 IO Board Pin Functions | Connection Method |
|---|---|
| Radxa CM4 IO Board: GND (Pin6) | Connect to GND pin (black wire) of USB-to-TTL cable |
| Radxa CM4 IO Board: UART0_TXD (Pin8) | Connect to RXD pin (white wire) of USB-to-TTL cable |
| Radxa CM4 IO Board: UART0_RXD (Pin10) | Connect to TXD pin (green wire) of USB-to-TTL cable |
Serial Login
Baud Rate: 1500000
Data Bits: 8
Stop Bits: 1
Parity: None
Flow Control: None
Using Tabby
We recommend using Tabby software for serial port login. Tabby is a powerful and user-friendly serial debugging tool that supports various protocols including serial and SSH. It is compatible with major operating systems such as Windows, macOS, and Linux.
Download Tabby
Visit the Tabby official website to download and install the Tabby software.
Install Tabby
- Windows
Select the appropriate .exe file for your system architecture.
- Linux
Choose the .deb file that matches your system architecture.
- MacOS
Download the .dmg file for your system architecture.
Using Tabby
Double-click the Tabby icon to launch the application.
Serial Port Configuration
① → Settings: Click the settings option
② → Profiles & connections: Click to configure connection options
③ → New profile: Click to add a new configuration
Select Serial Port Template
Choose a base configuration as a template: Select any Serial template. You can modify parameters such as device name, serial port device number, and baud rate in the subsequent configuration interface.
Modify Serial Port Parameters
After selecting the Serial template, modify the following parameters:
① → Name: Set the connection name (recommended to use the product name)
② → Device: Set the serial port device number (typically /dev/ttyUSB0 if only one serial device is connected)
③ → Baud rate: Set the baud rate to 1500000
④ → Save: Save the configuration
Login to Serial Port
Click the run button to connect to the serial port device.
After a successful connection, press Enter to see the login prompt. Then use the system's username and password to log in (the password won't be displayed as you type; press Enter after entering it).
Serial Port Debugging
Once you've successfully logged in via the serial port, you can view system logs and run commands to test system functionality through the serial console.