Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools

Home / products / sbc / edge-2l / development / setup-serial-tool
products:sbc:edge-2l:development:setup-serial-tool

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

products:sbc:edge-2l:development:setup-serial-tool [2025/11/26 02:12]
gray created 		products:sbc:edge-2l:development:setup-serial-tool [2026/02/01 22:48] (current)
gray update by using AI
Line 3: Line 3:
 ===== Introduction ===== ===== Introduction =====
  
-This page will introduce the serial debugging tools. You will learn how to connect Khadas SBC to PC and install debugging software on different PCs.+This page introduces the serial debugging tools. You will learn how to connect a Khadas SBC to a PC and install debugging software on different operating systems.
  
 ===== Preparation ===== ===== Preparation =====
  
-Take a serial tool, which is also known as an USB to TTL Converter like [[https://www.amazon.com/Adaptor-Download-Adapter-Converter-LinkMore/dp/B08VGRRJ67/ref=sr_1_4?dchild=1&keywords=USB+to+TTL+ch340&qid=1629184609&sr=8-4|CH340 USB to TTL Converter]].+You will need a serial tool, also known as a USB-to-TTL Converter, such as the [[https://www.amazon.com/Adaptor-Download-Adapter-Converter-LinkMore/dp/B08VGRRJ67/ref=sr_1_4?dchild=1&keywords=USB+to+TTL+ch340&qid=1629184609&sr=8-4|CH340 USB to TTL Converter]].
  
-An [[/products/sbc/edge-2l/applications/gpio/40pin-header|Edge-2L IO board]] is needed to work with the serial tool.+An [[/products/sbc/edge-2l/applications/gpio/40pin-header|Edge-2L IO board]] is required to interface with the serial tool.
  
  
Line 49: Line 49:
 $ sudo apt install minicom $ sudo apt install minicom
 ``` ```
-Add permissions to access+Add permissions to access the serial port:
 ```shell ```shell
 $ sudo usermod -a -G dialout $(whoami) $ sudo usermod -a -G dialout $(whoami)
 ``` ```
 <WRAP info > <WRAP info >
-You may need to logout or reboot your system to take effect.+You may need to log out or reboot your system for this change to take effect.
 </WRAP> </WRAP>
  
 2. **Setup** 2. **Setup**
  
-Connect your SBC to the computer via the USB to TTL Converter tool before setting up ''minicom''.+Connect your SBC to the computer via the USB-to-TTL converter before setting up ''minicom''.
  
 ```shell ```shell
Line 65: Line 65:
 ``` ```
  
-Enter the ''minicom'' setup mode:+You will enter the ''minicom'' setup mode:
 ``` ```
 +-----[configuration]------+ +-----[configuration]------+
Line 79: Line 79:
 +--------------------------+ +--------------------------+
 ``` ```
-Use the up/down arrow keys to shift to ''Serial port setup'', and hit Enter to enter the ''Serial port setup menu''.+Use the up/down arrow keys to navigate to ''Serial port setup'', and press Enter to enter the ''Serial port setup menu''.
  
-  * You can use ''Shift'' + ''A'' to setup the serial device, hit Enter to confirm. +  * Press ''A'' to set the serial device, then press Enter to confirm. 
-  * You can use ''Shift'' + ''E'' to setup the baudrate, choose ''115200'' and hit Enter to confirm. +  * Press ''E'' to set the baudrate, select ''1500000'' and press Enter to confirm. 
-  * You can use ''Shift'' + ''F'' to disable the hardware flow control, set to ''NO''.+  * Press ''F'' to disable hardware flow control, and set it to ''NO''.
  
-After completing the setup, hit Enter to exit, then choose Save setup as dfl, then Exit from Minicom.+After completing the setup, press Enter to exit the menu, then select ''Save setup as dfl'', and finally ''Exit from Minicom''.
 <WRAP info > <WRAP info >
-The serial device node must correspond to Ubuntu’s serial device node.+The serial device node must correspond to the correct serial device node in Ubuntu.
 </WRAP> </WRAP>
  
 3. **Launch** 3. **Launch**
  
-Type ''minicom'' into the Ubuntu Terminal:+Type ''minicom'' into the Ubuntu terminal:
  
-```+```shell
 $ minicom $ minicom
-elcome to minicom 2.7.1+``` 
 +Output example: 
 + 
 +```txt 
 +welcome to minicom 2.7.1
  
 OPTIONS: I18n  OPTIONS: I18n 
Line 111: Line 115:
 4. **Exit** 4. **Exit**
  
-You can use ''Ctrl''+''A''+''Z'' to open the menu:+Press ''Ctrl''+''A'', then ''Z'' to open the help menu:
 ``` ```
 +-------------------------------------------------------------------+ +-------------------------------------------------------------------+
Line 133: Line 137:
 +-------------------------------------------------------------------+ +-------------------------------------------------------------------+
 ``` ```
-Use ''Shift''+''Q'' to exit ''minicom''.+Press ''Q'' to exit ''minicom''.
  
 ``` ```
Line 145: Line 149:
  
 <WRAP info > <WRAP info >
-  * If the Terminal output contains this line, you need to use ''sudo minicom''.\\ ```sh+  * If the terminal output contains the following line, you need to use ''sudo minicom'':  
 + 
 +```sh
 /dev/ttyUSB0: Permission denied /dev/ttyUSB0: Permission denied
 ``` ```
-  * To access U-Boot, leave your USB-Serial-Debug tool connected, then press the reset button on your device once. You should see some print-out on your Terminal, then quickly press the ''space'' or ''control-c'' to stop auto-boot. You will see the prompt ''kvim#'' when you've entered U-boot. +  * To access U-Boot, keep the USB-Serial-Debug tool connected, press the reset button on your device once. You should see output in your terminal, then quickly press the ''Spacebar'' or ''Ctrl+C'' to stop auto-boot. You will see the ''kvim#'' prompt when you have entered U-Boot. 
-  * Standard “help” commands are listed in U-Boot Usage Guide, you’ll need to first have a version of Android or Ubuntu installed in your VIM device, from our [[https://dl.khadas.com/Firmware/Krescue/images|official OOWOW]] images.+  * Standard “help” commands are listed in the U-Boot Usage Guide. You will need to have a version of Android or Ubuntu installed on your device, available from our [[https://dl.khadas.com/Firmware/Krescue/images|official OOWOW]] images. 
 </WRAP> </WRAP>
  
Line 168: Line 174:
 3. Setup SecureCRT 3. Setup SecureCRT
  
-Before starting SecureCRT, you’ll need to connect the USB to TTL Converter tool to your SBC and computer.+Before starting SecureCRT, connect the USB-to-TTL converter tool to your SBC and computer.
  
-Launch SecureCRT and navigate to ''File''->''Quick Connect'':+Launch SecureCRT and navigate to ''File'' -> ''Quick Connect'':
  
 {{/products/sbc/common/development/securecrt1.png|securecrt1}} {{/products/sbc/common/development/securecrt1.png|securecrt1}}
  
-Select the ''Serial'' protocol, select the correct device node, set the baudrate to ''115200'', unselect ''XON/XOFF''.+Select the ''Serial'' protocol, choose the correct COM port (device node), set the baudrate to ''1500000'', and ensure ''XON/XOFF'' is not selected.
  
 {{/products/sbc/common/development/securecrt2.png|securecrt2}} {{/products/sbc/common/development/securecrt2.png|securecrt2}}
Line 186: Line 192:
 1. Setup Meta key 1. Setup Meta key
  
-minicom needs a Meta key. Use Terminal to create a Meta key. +Minicom requires a Meta key. To create one, open the Terminal application and go to ''Terminal''->''Preferences''->''Keyboard'', select Use Option as Meta key.
-Go to ''Terminal''->''Preferences''->''Keyboard'', select Use Option as Meta key.+
  
 {{/products/sbc/common/development/minicom1_en.png|minicom1_en}} \\ {{/products/sbc/common/development/minicom1_en.png|minicom1_en}} \\
Line 196: Line 201:
  
 ```shell ```shell
-$ sudo apt update +$ brew install minicom
-$ sudo apt install minicom+
 ``` ```
 Add access permissions Add access permissions
Line 204: Line 208:
 ``` ```
 <WRAP info > <WRAP info >
-You may need to logout or reboot your system for changes to take effect.+You may need to log out or reboot your system for changes to take effect.
 </WRAP> </WRAP>
  
 3. Setup 3. Setup
  
-Connect the USB to TTL Converter tool to your SBC and computer before setting up ''minicom''.+Connect the USB-to-TTL converter tool to your SBC and computer before setting up ''minicom''.
 ```shell ```shell
 $ sudo minicom -s $ sudo minicom -s
 ``` ```
-Enter the minicom setup mode:+You will enter the minicom setup mode:
 ``` ```
 +-----[configuration]------+ +-----[configuration]------+
Line 227: Line 231:
 +--------------------------+ +--------------------------+
 ``` ```
-Use the up/down arrows to shift to ''Serial port setup'', and hit Enter to enter the ''Serial port setup menu''.+Use the up/down arrow keys to navigate to ''Serial port setup'', and press Enter to enter the ''Serial port setup menu''.
  
-  * You can use ''Shift'' + ''A'' to setup the serial device, hit Enter to confirm. +  * Press ''A'' to set the serial device, then press Enter to confirm. 
-  * You can use ''Shift'' + ''E'' to setup the baudrate, choose ''115200'' and hit Enter to confirm. +  * Press ''E'' to set the baudrate, select ''1500000'' and press Enter to confirm. 
-  * You can use ''Shift'' + ''F'' to disable the hardware flow control, set to ''NO''.+  * Press ''F'' to disable hardware flow control, and set it to ''NO''.
  
-After completing the setup, hit Enter to exit, then choose Save setup as dfl, then Exit from Minicom.+ 
 +After completing the setup, press Enter to exit the menu, then select ''Save setup as dfl'', and finally ''Exit from Minicom''.
  
 <WRAP info > <WRAP info >
-The serial device node must correspond to the Mac OS’ serial device node.+The serial device node must correspond to the correct serial device node in macOS.
 </WRAP> </WRAP>
  
 4. Launch 4. Launch
  
-Type ''minicom'' into the Ubuntu Terminal:+Type ''minicom'' in the terminal:
  
 ``` ```
 $ minicom $ minicom
 +```
 +Output example:
 +```
 elcome to minicom 2.7.1 elcome to minicom 2.7.1
  
Line 260: Line 268:
 5. Exit 5. Exit
  
-You can use ''Ctrl''+''A''+''Z'' to open the menu:+Press ''Ctrl''+''A'', then ''Z'' to open the help menu:
 ``` ```
 +-------------------------------------------------------------------+ +-------------------------------------------------------------------+
Line 282: Line 290:
 +-------------------------------------------------------------------+ +-------------------------------------------------------------------+
 ``` ```
-Use ''Shift''+''Q'' to exit ''minicom''.+Press ''Q'' to exit ''minicom''. 
 + 
 +You will see:
  
 ``` ```
Line 290: Line 300:
 +----------------------+ +----------------------+
 ``` ```
-Choose ''Yes'' and hit Enter to exit ''minicom''.+Select ''Yes'' and press Enter to exit ''minicom''. 
 </tabbox> </tabbox>
  
  
Last modified: 2026/02/01 22:48 by gray

Page Tools

Khadas Site

Khadas Community

Khadas GitHub

Khadas Downloads