# 串口调试 (/docs/products/motherboard/ROC-RK3328-CC/debug) # 串口调试 如果正在进行 U-Boot 或内核开发，USB串口适配器（USB 转串口TTL 适配器的简称）对于检查系统启动日志非常有用，特别是在没有图形桌面显示的情况下。 ## 准备 USB 串口适配器 ### 选择 USB 串口适配器 [ROC-RK3328-CC] 的 UART 调试口默认使用**1,500,000**波特率和 TTL 电平。 一些串口适配器不能支持如此高的波特率。因此在购买之前，请确保它符合要求并有可用的驱动。参考[在线商城]上带 `CP2104` 芯片的 [USB 转串口适配器]。 ### 连接适配器和调试口 用三根线将 TX/RX/GND 引脚分别连接在一起： ![](/wiki-api/assets/objects/9d89d578cbf5d508d9c23e3bb22eeae99f1eb6943d4032ac02bfe5dcae483a3a/debug_con.png) 如果在使用某些适配器时串口控制台没有输出，可以尝试将适配器的 TX 引脚连接到开发板的 RX 引脚，适配器的 RX 引脚连接到开发板的 TX 引脚，即交换一下 TX、RX 引脚。 ### 串口参数配置 [ROC-RK3328-CC] 使用如下配置: - 波特率：1,500,000 - 数据位：8 - 停止位：1 - 奇偶检查：无 - 流控：无 接下来，根据操作系统的不同，为你介绍详细的操作说明。 ## Windows 下的串口调试 ### 安装驱动 安装卖家推荐的 USB 串口适配器驱动。如果没有，可以检查芯片组并尝试以下驱动 - [CH340](http://www.wch.cn/downloads.php?name=pro&proid=5) - [PL2303](http://www.prolific.com.tw/US/ShowProduct.aspx?pcid=41) - [CP210X](http://www.silabs.com/products/mcu/pages/usbtouartbridgevcpdrivers.aspx) > 提示：如果 PL2303 在 Win8 下无法工作，则可以尝试将驱动程序降级到版本 3.3.5.122 或之前。 安装驱动后，将适配器连接到主机的 USB 端口。操作系统将提示检测到新硬件。完成后，可以在设备管理器中找到新的COM端口： ![](/wiki-api/assets/objects/2b383cf651206cd11cef33c34efac8cdc19309d58af6b2befaaf9a5c85c720b6/debug_devicemanager_com.png) ### 安装工具 Windows 中有很多串口终端工具，例如 putty 和 SecureCRT。以下介绍Putty这款流行的开源软件的使用。 > [Putty 下载地址](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) 下载 `putty.zip`，解压并运行 `PUTTY.exe`： 1. 选择 "Connection type" 为 "Serial"。 2. 将 "Serial line" 修改为在设备管理器中找到的 COM 端口。 3. 设置 "Speed" 为 1500000 。 4. 点击 "Open" 按钮。 ![](/wiki-api/assets/objects/78bebc58cef8b479e379f6d4d7596dc1b4b16d9af2658d914403f61410ec4188/debug_putty_serial.png) ## Linux 下的串口调试 如果 USB 串口适配器的芯片组受 Linux 内核支持，驱动程序将自动加载。 连接串口适配器，并通过如下命令检查相应的串口设备文件： $ ls -l /dev/ttyUSB* crw-rw---- 1 root uucp 188, 0 Apr 10 16:44 /dev/ttyUSB0 将你的 Linux 用户添加到 `uucp` 组中，以便获得访问此设备的权限（否则每次需要在命令前加`sudo`来运行相应命令）: sudo gpasswd -a $(whoami) uucp 用户组的更改将在注销并重新登录 Linux 后生效，或使用 `newgrp` 命令进入带有新组的 shell: newgrp uucp 然后根据偏好，使用自己喜欢的串口控制台工具。以下介绍 picocom 和 minicom 。 ### picocom `picocom` 轻便小巧， 容易使用。 安装 `picocom` 命令: sudo apt-get install picocom 启动 `picocom`: ```text $ picocom -b 1500000 /dev/ttyUSB0 picocom v3.1 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 hangup is : no nolock is : no send_cmd is : sz -vv receive_cmd is : rz -vv -E imap is : omap is : emap is : crcrlf,delbs, logfile is : none initstring : none exit_after is : not set exit is : no Type [C-q] [C-h] to see available commands Terminal ready ``` 上面的信息显示 `Ctrl-a` 是转义键。 按下 `Ctrl-a Ctrl-q` 将退出 `picocom` 并返回到 shell 。 ### minicom 安装 `minicom` 命令： > sudo apt-get install minicom 启动 `minicom`： ```text $ minicom Welcome to minicom 2.7 OPTIONS: I18n Compiled on Jan 1 2014, 17:13:19. Port /dev/ttyUSB0, 15:57:00 Press CTRL-A Z for help on special keys ``` 根据以上提示: 按 `Ctrl-a`，然后按 `z`（而不是 `Ctrl-z` ）调出帮助菜单： ```text +-------------------------------------------------------------------+ | Minicom Command Summary | | | | Commands can be called by CTRL-A | | | | Main Functions Other Functions | | | | Dialing directory..D run script (Go)....G | Clear Screen.......C | | Send files.........S Receive files......R | cOnfigure Minicom..O | | comm Parameters....P Add linefeed.......A | Suspend minicom....J | | Capture on/off.....L Hangup.............H | eXit and reset.....X | | send break.........F initialize Modem...M | Quit with no reset.Q | | Terminal settings..T run Kermit.........K | Cursor key mode....I | | lineWrap on/off....W local Echo on/off..E | Help screen........Z | | Paste file.........Y Timestamp toggle...N | scroll Back........B | | Add Carriage Ret...U | | | | Select function or press Enter for none. | +-------------------------------------------------------------------+ ``` 按提示按 `O` 进入设置屏幕: ```text +-----[configuration]------+ | Filenames and paths | | File transfer protocols | | Serial port setup | | Modem and dialing | | Screen and keyboard | | Save setup as dfl | | Save setup as.. | | Exit | +--------------------------+ ``` 选择 `Serial port setup`，然后按选项前面的大写字母并设置为如下所示的值: ```text +-----------------------------------------------------------------------+ | A - Serial Device : /dev/ttyUSB0 | | B - Lockfile Location : /var/lock | | C - Callin Program : | | D - Callout Program : | | E - Bps/Par/Bits : 1500000 8N1 | | F - Hardware Flow Control : No | | G - Software Flow Control : No | | | | Change which setting? | +-----------------------------------------------------------------------+ ``` **注意**: - `Hardware Flow Control` 和 `Software Flow Control` 应该设置为 No 。 - 结束设置之后， 按 `ESC` 键回到之前的菜单， 选择 `Save setup as dfl` 保存覆盖掉默认配置。 [《上手指南》]: getting_started.md [《常见问题解答》]: faqs.md [《串口调试》]: debug.md [《编译 Linux 根文件系统》]: linux_build_ubuntu_rootfs.md [联系方式]: resource.md#社区 [原始固件]: getting_started.md#raw-firmware-format [RK 固件]: getting_started.md#rk-firmware-format [分区映像]: getting_started.md#partition-image [SDCard Installer]: flash_sd.md#sdcard-installer [Etcher]: flash_sd.md#etcher [dd]: flash_sd.md#dd [SD Firmware Tool]: flash_sd.md#sd-firmware-tool [AndroidTool]: flash_emmc.md#androidtool [upgrade_tool]: flash_emmc.md#upgrade-tool [rkdeveloptool]: flash_emmc.md#rkdeveloptool [Rockusb 模式]: flash_emmc.md#rockusb-mode [Maskrom 模式]: flash_emmc.md#maskrom-mode [Rockusb 驱动]: flash_emmc.md#rockusb-driver [ROC-RK3328-CC]: http://www.t-firefly.com/product/rocrk3328cc.html "ROC-RK3328-CC 官网" [下载页面]: http://www.t-firefly.com/doc/download/page/id/34.html [论坛]: http://bbs.t-firefly.com [脸书]: https://www.facebook.com/TeeFirefly [Google+]: https://plus.google.com/u/0/communities/115232561394327947761 [油管]: https://www.youtube.com/channel/UCk7odZvUrTG0on8HXnBT7gA [推特]: https://twitter.com/TeeFirefly [在线商城]: http://store.t-firefly.com [USB 转串口适配器]: https://store.t-firefly.com/goods.php?id=24 [5V2A 电源适配器]: https://store.t-firefly.com/goods.php?id=69 [eMMC 闪存]: https://store.t-firefly.com/goods.php?id=71 [《存储映射》]: http://opensource.rock-chips.com/wiki_Partitions#Default_storage_map