Serial Debugging

Via a serial communication tool, you can obtain debugging information, which is useful for determining device status. This document describes serial debugging of Edge 2 on Windows, MacOS, and Ubuntu.

Preparations

• A USB to TTL converter
• A PC: Windows, MacOS, or Ubuntu
• A serial debugging tool

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.

On Windows

Step 1. Connect hardware

1. Connect the GND, TXD, and RXD pins of the USB to TTL converter to the GND, RXD and TXD pins of Mixtile Edge 2, respectively. 

2. Connect the USB to TTL converter to your PC.

Step 2. Download and install a driver

1. Download a driver according to the USB to TTL converter that you’re using.
2. Unzip the driver zip file and select the corresponding file (.exe) to install based on the PC architecture (32-bit or 64-bit). If only one installation file (.exe) is available, select it to install.

On your PC, open Device Manager and check your Mixtile Edge 2’s serial port.

Step 3. Install and configure a serial debugging tool

PuTTY is one of the serial debugging tools generally used on Windows, and is used for illustration in this document.

1. Select the PuTTY file (.msi) to install according to the PC architecture (32-bit or 64-bit).
2. Open PuTTY and configure the serial debugging tool. Specifically, on the PuTTY Configuration page, complete the settings as shown in the following figure. Then click Open.

You’ll see the following output.

On Ubuntu

Step 1. Connect hardware

1. Connect the GND, TXD, and RXD pins of the USB to TTL converter to the GND, RXD, and TXD pins of Mixtile Edge 2.

2. Connect the USB to TTL converter to your PC.

Step 2. Install a serial debugging tool.

Picocom is one of many serial debugging tool generally used on Ubuntu, and is used for illustration here.

sudo apt-get update

sudo apt-get install picocom

Step 3. Operate the serial debugging tool

sudo picocom -b 1500000 /dev/ttyUSB0

The command output is as follows:

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

Step 4. Exit Picocom.

1. Press CTRL+A.

2. Keep pressing CTRL and press Q.

On Mac

Serial Debug on macOS

Except for the difference in the installation method, the usage is the same as in the Serial Debug on Ubuntu.

Install serial debug tool

$ brew install picocom

Note: You need to install the brew tool before running the preceding command. Run the following command to install brew.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"