Serial Login
Prerequisites
Serial login is a core method for embedded development to interact with the board through serial communication interfaces (UART). Through serial tools, you can view system logs and perform command-line interactions.
When using a USB serial data cable for serial debugging with the board, ensure the pin connections are correct. Incorrect pin connections may cause damage to the board hardware.
It is not recommended to connect the VCC interface (red wire) of the USB serial data cable to avoid damage caused by incorrect connection.
Connect the USB serial data cable to the UART2 interface of the Radxa NX5 Development Kit, and the other end to the PC's USB port.
Note: Please make connections according to the USB serial cable pin definitions provided by the manufacturer. The example in the diagram shows common USB serial cable pin definitions.
| Radxa NX5 Development Kit | Connection Method |
|---|---|
| GND (Pin6) | Connect the GND pin of the Radxa NX5 Development Kit to the GND pin of the USB serial cable (black Dupont wire) |
| UART2_TXD (Pin8) | Connect the UART2_TXD pin of the Radxa NX5 Development Kit to the RXD pin of the USB serial cable (white Dupont wire) |
| UART2_RXD (Pin10) | Connect the UART2_RXD pin of the Radxa NX5 Development Kit to the TXD pin of the USB serial cable (green Dupont wire) |
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.