Debugging Tools

1 USB-to-serial driver installation

This section describes how to install the USB-to-serial driver for the development board's serial port. The driver applies to USB-to-serial chips such as CH340 and CH341.

Supported installation environments: Windows 7 64-bit, Windows 10 64-bit.

Extract "Software Materials\Tools\Windows\CH341SER.zip" from the product documentation, navigate to the directory matching your system, and run SETUP.EXE.

Click Install.

After the installation succeeds, you can view the USB-to-serial driver in the PC's Device Manager, as shown below.

If it still cannot install properly, you may use third-party software such as Driver Genius or Driver Booster to install the USB-to-serial driver online. If the driver is normal but the connection still fails, check whether the USB cable is working.

2 Installing the SecureCRT system debugging tool

SecureCRT is a terminal-emulation program that supports the SSH protocol. It lets you inspect the board's system information and debug the system over a serial or network port.

2.1 Installation procedure

Supported installation environments: Windows 7 64-bit, Windows 10 64-bit.

Extract the "Software Materials\Tools\Windows\VanDyke SecureCRT and SecureFX 9.4.0.3072 x64+x32.rar" archive from the product documentation.

For 64-bit computers, double-click scrt-sfx-x64-bsafe.9.4.0.3072.exe in the extracted directory.

For 32-bit computers, double-click scrt-sfx-x86-bsafe.9.4.0.3072.exe in the extracted directory.

After completing the installation, you must enter a license serial number to use it. Please purchase your own license.

2.2 Serial connection settings

Open SecureCRT, click "File -> Quick Connect…" to enter the connection configuration screen. Or click the "Quick Connect" shortcut button directly, as shown below.

In the pop-up dialog, configure the serial connection. Select Serial for Protocol, choose the corresponding COM port for Port, manually enter the baud rate as 1500000, leave the other parameters at their defaults, and finally click Connect, as shown below.

2.3 Character encoding settings

To ensure the debugging tool displays Chinese correctly and avoid garbled text, configure the character encoding as follows. Click "Options -> Session Options… -> Appearance" in turn, select UTF-8 for Character encoding, and click OK to save.

2.4 Saving system boot logs

During debugging, you often need to save the system boot log.

After the debugging tool connection is configured, click "File -> Log Session" to open the log-save configuration screen, choose a path to save the log, and click "Save", as shown below.

When the system finishes booting, the log is automatically saved to the corresponding log file. The content looks similar to the figure below.

3 CAN debugging tool installation

This CAN debugging tool is the software for the Chuangxin Technology CAN analyzer hardware. It runs on a computer equipped with the CAN analyzer hardware and can handle CAN frames in both 11-bit identifier mode (CAN2.0A protocol) and 29-bit identifier mode (CAN2.0B protocol).

Navigate to "Software Materials\Tools\Windows\CAN_TOOL" and read "2.USB-CAN Tool debugging software installation and user manual.pdf" to install it.

The software interface looks like this:

Tips

Default account: linarro, password: linaro

First ensure that your computer and the device can reach each other over the network (i.e. are on the same LAN). Plug the Ethernet cable into the device's ETH1 or ETH2 port, and use the ifconfig command to check the device's IP address — enter the command on the command line via an attached display, or run the command after connecting over serial.

Using MobaXterm as an example:

Enter the password to log in:

Note

For root privileges, you can use sudo <command> or sudo -i to switch to the root user.

Alternatively, use the linaro account to set a root password: run sudo passwd root in the terminal and define your own password.