Welcome to Firefly
English
Firefly Docsss
Last Updated: 2026-11-20 11:00:39

Debug Usage

AIO-1688JD4 provides one serial port with two connection methods, corresponding to the same debug serial port: via the Type-C serial port or via the DEBUG port (TTL level):

Debug InterfaceLevelConnectionWindows ToolLinux ToolSerial Parameters
Type-C serial portDirect USBType-C data cableMobaXterm (recommended)/PuTTY/SecureCRTminicom/picocom/kermit115200 8N1, no flow control
DEBUG portTTL levelUSB-to-TTL serial adapterSame as above (driver required)Same as above (driver-free)115200

The AIO-1688JD4 can be connected to a PC using a Type-C cable for serial port debugging:

Please note that if you need to enable the Type-C debug port function, you must set the corresponding dip switch to the specified position:

  • ON: Indicates that the Type-C serial port is enabled
  • 1: Indicates that it is used as a standard USB2.0 (Host only) interface

Serial Port Parameter Configuration

The AIO-1688JD4 uses the following serial port parameters:

  • Baud rate: 115200
  • Data bits: 8
  • Stop bits: 1
  • Parity: None
  • Flow control: None

Using Serial Port Debugging

On Windows, PuTTY or SecureCRT are commonly used. We recommend the free MobaXterm terminal software:

  1. Download the free version of MobaXterm from the official website.
  2. Select Serial as the session.
  3. Change the Serial port to the COM port found in Device Manager.
  4. Set Speed (bsp) to 115200.
  5. Click the OK button.

If you want to perform U-Boot or kernel development, you need to use the DEBUG port for debugging. The operation is consistent with Type-C debugging, but attention should be paid to the adapter and its driver issues.

Choosing an Adapter

There are many USB to serial port adapters available online, categorized by chip type as follows:

Serial portMaximum baud rateRecommended?ReviewPurchase link
CP21042MbpsRecommendationSupports high baud rate communication, good stability and durabilityClick to purchase
CH3402MbpsNot recommendedIn actual use, it has been found that many CH340 adapters on the market do not achieve a baud rate of 1.5 Mbps
PL23031.2MbpsNot recommendedMaximum baud rate does not reach 1.5 Mbps

Generally speaking, adapters using the CH340 chip have relatively stable performance, but are a bit more expensive.

Note

The default baud rate for AIO-1688JD4 is 115200.

Hardware Connection

USB to Serial Adapter, with four pins.

  • 3.3V Power (NC), no connection needed
  • GND, the ground line of the serial port, connect to the GND pin of the development board
  • TXD, the output line of the serial port, connect to the TX pin of the serial port of the development board
  • RXD, the input line of the serial port, connect to the RX pin of the serial port of the development board

Note

If you encounter the problem that TX and RX cannot be input and output when using other serial adapters, you can try to swap the TX and RX connections.

AIO-1688JD4 DEBUG port:

Driver Installation

Windows systems need to install the adapter driver (Linux does not):

Download the driver and install it.

After plugging in the adapter, the system will prompt that new hardware is found and initialised, after which you can find the corresponding COM port in Device Manager:

On this page