Console on Serial

Connect Edge 2 DEBUG (TTL) to PC with USB to TTL converter. Developers need to install serial port tools on the PC to obtain debugging information.

Preparing USB to TTL Converter

There are many USB to TTL Converters, divided by chip, there are the following:

  • FT232
  • CP210X
  • PL2303
  • CH340

Note: The default baud rate of Edge 2 DEBUG is 1500000bps. Some converter chips baud rate cannot reach 1500000bps. Please confirm whether it meets the requirements of Edge2 baud rate before purchasing.

Hardware Connection

By connecting the PC and Edge 2 DEBUG, developers can obtain the debugging information. The USB to TTL Converter may have multiple pins. Connect Edge 2 DEBUG to the following three pins.

  • GND,Ground, connect to GND pin of the board.
  • TXD,Transmit,connect to RX pin of the board.
  • RXD,Receive, connect to TX pin of the board.

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

The connection of Edge 2 DEBUG and USB to TTL converter, FT232, is as follows:

serial-connection

Parameter Setting

Edge 2 DEBUG serial parameters:

  • Baud rate: 1500000
  • Data bit: 8
  • Stop bit: 1
  • Parity check: none
  • Flow control: none

Serial Debug on Windows

Follow the steps below to obtain serial debugging information on Windows.

Hardware Connection

Refer to [Hardware Connection](###Hardware Connection)

Install Driver

Download

Install

Unzip the zip file and select the corresponding file (exe) to install according to the PC architecture (32-bit, 64-bit). If only one installation file (exe) can be installed, select the default installation file (exe) to install.

After the USB to TTL converter is plugged into the PC, the Windows system prompts for new hardware, and then you can find the corresponding COM port in the device manager:

serial-devmanager-windows.png

Install Serial Debug tool

In order to obtain the serial debugging information, you need to install the serial debug tool on Windows.

Download

Putty or SecureCRT is generally used on Windows. See SecureCRT to download.

Install

Select the corresponding file (exe, msi) to install according to the PC architecture (32-bit, 64-bit).

Configure

  1. Open SecureCRT

  2. The first time you use SecureCRT, it will jump out of the Quick Connect configuration directory

  3. Select protocol to serial

  4. Select Port as the COM port found in the device manager (COM3 USB Serial Port)

  5. Manually select the baud rate as 1500000

  6. Turn off XON/XOFF

  7. Click Connect

SecureCRT-quickconnect.png SecureCRT-open

Serial Debug on Ubuntu

To obtain the serial debugging information, you need to install the serial debug tool on Ubuntu. There are a variety of serial debug tools on Ubuntu, such as minicom, picocom and so on.

The following examples illustrate the steps to use picocom under Ubuntu.

Hardware Connection

Refer to [Hardware Connection](###Hardware Connection)

Install serial debug tool

sudo apt-get update
sudo apt-get install picocom

View serial device number

After the USB-to-TTL converter is connected to the PC (Ubuntu), the device number of the serial is displayed in the /dev directory as ttyUSB[0, 1, 2....], taking ttyUSB0 as an example:

username@ubuntu:~$ ls /dev/ttyUSB0
/dev/ttyUSB0

Operate serial debug tool

-b is to set the baud rate

sudo picocom -b 1500000 /dev/ttyUSB0
picocom v2.2

port is        : /dev/ttyUSB0
flowcontrol    : none
baudrate is    : 1500000
parity is      : none
databits are   : 8
stopbits are   : 1
escape is      : C-a
local echo is  : no
noinit is      : no
noreset is     : no
nolock is      : no
send_cmd is    : sz -vv
receive_cmd is : rz -vv -E
imap is        :
omap is        : 
emap is        : crcrlf,delbs,

Type [C-a] [C-h] to see available commands

Terminal ready
console:/ $ 
console:/ $ 
console:/ $ 
console:/ $

Exit picocom

To exit picocom, you need to follow the steps below.

  1. Press the key combination CTRL+A

  2. Don’t release CTRL, release A

  3. Do not release CTRL, press Q

Serial Debug on macOS

Except for the difference in the installation method, the usage is the same as in the [serial debug on Ubuntu](##Serial Debug on Ubuntu).

Install serial debug tool

$ brew install picocom

Note: There may be a long wait time or no response when installing this software with brew. You may need to may need to manually execute CTRL+C once to continue the installation.