Serial Login
Prerequisites
Serial login is a core method for interacting with the board via serial communication interface (UART) in embedded development. Through serial tools, you can view system logs and perform command-line interactions.
When using a USB serial data cable to connect to the board for serial debugging, please ensure the pin connections are correct. Connecting pins incorrectly may cause hardware damage to the board.
Do not connect the USB serial data cable's VCC interface (red wire). Connecting it incorrectly may damage the board.
Connect the USB serial data cable to the UART2 interface on the Radxa NX5 Development Kit, and the other end to the PC's USB port.
Note: Please follow the USB serial cable manufacturer's pin definitions for connection. The diagram shows common USB serial cable pin definitions.
| Radxa NX5 Development Kit | Connection Method |
|---|---|
| GND (Pin 6) | Connect the GND pin of the Radxa NX5 Development Kit to the GND pin of the USB serial cable (black Dupont wire) |
| UART2_TXD (Pin 8) | 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 (Pin 10) | 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 for serial port login. Tabby is a powerful and user-friendly serial debugging tool that supports multiple protocols including serial port and SSH, and is compatible with mainstream operating systems such as Windows, macOS, and Linux.
Download Tabby
Visit the Tabby official website to download and install the Tabby software.
Install Tabby
Select the appropriate installation package for your operating system and hardware architecture (Windows: tabby-<version>.exe, Linux: tabby-<version>.deb, macOS: tabby-<version>.dmg) to install the Tabby software.
Using Tabby
After installation, 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 (default is /dev/ttyUSB0 if only one serial device is connected to a Linux system)
③ --> Baud rate : Set the baud rate to 1500000
④ --> Save : Save the configuration
For different platforms or when multiple serial devices are connected, you can safely unplug the USB serial cable connected to the board and observe the device number changes to identify the correct device.
Login via Serial Port
Click the run button to log in to the serial port device.
After a successful connection, press Enter to display the command line interface.
Using the Serial Port
Once successfully logged in via the serial port, you can view system logs and run commands to test system functionality through the serial port.