1. 为什么你需要一个趁手的串口工具?
如果你正在捣鼓树莓派、Arduino,或者调试一些嵌入式开发板、路由器、工控设备,那你肯定绕不开一个东西:串口。这东西就像是你和硬件设备之间的一座老桥,虽然速度不快,但胜在简单、可靠、历史悠久。在Linux世界里,和串口打交道,命令行工具有minicom、screen,图形界面工具里,cutecom绝对算得上是一位“老伙计”了。
我最早接触cutecom,是因为受不了minicom那套略显繁琐的配置流程。每次换设备、换波特率,都得进菜单找半天。cutecom不一样,它是个纯粹的图形化工具,界面清爽,点几下鼠标就能连上,发送接收数据一目了然,特别适合我这种喜欢“所见即所得”的懒人。尤其是在Ubuntu这种桌面环境友好的系统里,有个图形化工具,调试起来心情都会好不少。
不过,在Ubuntu的软件仓库里,直接apt install cutecom装上的版本,有时候会比较旧,可能缺少一些新功能,或者遇到一些奇怪的兼容性问题。所以,很多老鸟会选择从源码自己编译安装,这样能确保用到最新版,而且整个过程本身也是对Linux开发环境的一次很好的熟悉。今天,我就以Ubuntu 20.04 LTS这个依然非常流行的版本为例,带你从零开始,把cutecom稳稳当当地装好、配置好,顺便把路上可能遇到的“坑”都给你填平了。
2. 安装前的准备工作:搭建编译环境
在Linux下从源码编译软件,就像在家自己组装家具,你得先把螺丝刀、扳手这些工具准备好。编译cutecom,我们需要两套工具:一套是通用的编译构建工具链,另一套是cutecom本身依赖的特定库,主要是Qt5的串口模块。
2.1 更新系统与安装基础编译工具
第一步,咱们先把系统更新到最新状态,并安装那些最基础的编译工具。打开你的终端(快捷键Ctrl+Alt+T),然后依次执行下面的命令。别怕,我会解释每一行是干嘛的。
sudo apt update
sudo apt upgrade -y
sudo apt update是刷新软件包列表,获取最新的软件源信息;sudo apt upgrade -y则是升级所有可以升级的已安装软件包。-y参数表示自动回答“yes”,省去我们手动确认的麻烦。这一步确保我们的系统环境是新的,避免因为一些旧的库文件导致编译失败。
接下来,安装编译软件的核心工具集:
sudo apt install -y build-essential cmake git
- build-essential:这是一个元软件包,它包含了
gcc、g++、make、libc-dev等一整套编译C/C++程序所必需的工具。没有它,源码就是一堆文本,变不成可执行文件。 - cmake:
cutecom使用CMake作为构建系统。你可以把CMake想象成一个高级的项目构建“向导”或“生成器”。它读入一个叫CMakeLists.txt的配置文件,然后根据你当前系统的环境,生成对应的Makefile文件。我们后面会用到它。 - git:版本控制工具。因为我们要从
cutecom的官方代码仓库(GitLab)把源代码“克隆”到本地。
2.2 安装Qt5开发环境与串口库
cutecom是一个基于Qt5框架开发的图形界面程序。Qt是一个强大的跨平台C++应用程序框架,用它写的程序界面好看,而且在Linux、Windows、macOS上都能运行。我们需要安装Qt5的开发库和专门的串口支持库。
sudo apt install -y qt5-default libqt5serialport5-dev
- qt5-default:这个包会安装Qt5的核心开发文件、头文件以及一些基本的Qt模块。它确保了我们有合适的Qt版本和
qmake等工具。 - libqt5serialport5-dev:这是最关键的依赖包。
cutecom的核心功能——串口通信,就是通过Qt5的QtSerialPort模块实现的。这个-dev包(开发包)包含了编译时需要的头文件(.h)和链接库。如果只安装运行库(libqt5serialport5),编译时会因为找不到头文件而失败。
这里有个我踩过的坑:早期一些教程会让你安装一堆像libssl-dev、qt5keychain-dev这样的包。其实对于cutecom的基本编译来说,这些并不是必须的,除非你需要一些特定的加密或密钥链功能。为了简化,我们先安装最必需的。如果后续编译报错缺少某个库,我们再根据错误提示单独安装即可,这样环境更干净。
3. 获取源码与编译安装
工具备齐,现在可以开始动手“组装”我们的cutecom了。
3.1 克隆源代码仓库
我们直接从官方GitLab仓库获取最新版本的源代码。这比下载某个特定版本的压缩包要好,因为代码是最新的,可能包含了最新的功能改进和Bug修复。
git clone https://gitlab.com/cutecom/cutecom.git
这条命令会在你当前所在的终端目录下,创建一个名为cutecom的文件夹,并把所有的源代码下载到里面。这个过程取决于你的网络速度,通常很快。
完成后,用cd命令进入这个目录:
cd cutecom
3.2 使用CMake配置项目
进入源码目录后,我们首先要运行CMake来配置项目。它会检查你的系统环境,比如编译器在哪里、Qt5的库在哪里、串口库是否找到等等,然后生成适合你系统的构建脚本(Makefile)。
cmake .
命令末尾的那个点.代表当前目录,意思是告诉CMake,配置文件CMakeLists.txt就在当前目录下。执行这条命令后,终端会输出一大堆检查信息。你需要注意看最后几行,有没有出现Configuring done和Generating done。如果出现了,并且中间没有红色的ERROR字样,那就说明配置成功。
常见问题与解决:
如果在这里报错,最常见的原因是没有找到Qt5。错误信息可能类似于 Could NOT find Qt5 (missing: Qt5Core Qt5Gui Qt5Widgets)。遇到这种情况,请确认:
- 你是否正确执行了上一步的
sudo apt install qt5-default? - 你可以尝试手动指定Qt5的安装路径(但通常不需要):
不过,在标准的Ubuntu安装后,CMake应该能自动找到。cmake . -DCMAKE_PREFIX_PATH=/usr/lib/x86_64-linux-gnu/cmake/Qt5
3.3 编译源代码
配置成功后,目录下就会生成一个Makefile文件。接下来,我们使用make命令开始编译。这个过程就是把成千上万行C++源代码,转换成你的电脑能执行的机器码。
make
静静地等待它完成。屏幕上会滚动很多编译信息。这个过程的时间取决于你的电脑CPU性能,一般在一两分钟内完成。最关键的是看最后有没有出现编译错误。 如果一切顺利,最终会在cutecom目录下生成一个名为cutecom的可执行文件。
你可以用ls -lh cutecom命令查看一下这个文件,它应该是一个绿色的可执行文件。
3.4 “安装”到系统(可选但推荐)
编译生成的cutecom可执行文件就在当前目录下,你直接运行./cutecom就可以启动它。但这有个问题:每次你都得先打开终端,cd到这个目录才能运行,很不方便。
我们通常希望像其他系统命令一样,在任何地方打开终端,输入cutecom就能启动。这就需要把它“安装”到系统路径下。标准的做法是使用sudo make install。但很多从源码编译的软件,其install规则可能会尝试安装到/usr/local/bin等位置。
一个更简单直接、也是我个人常用的“土办法”是:把它复制到系统已有的应用程序目录。比如/usr/local/bin/,这个目录通常就在系统的可执行文件搜索路径(PATH)里。
sudo cp cutecom /usr/local/bin/
现在,你打开一个新的终端窗口,直接输入cutecom,应该就能启动程序了。你可以用which cutecom命令来验证系统找到的是哪个cutecom,它会显示可执行文件的完整路径。
4. 配置与使用cutecom
好了,最激动人心的时刻到了,让我们启动cutecom,并连接上你的硬件设备。
4.1 启动程序与权限问题
第一次启动,我建议在终端里用sudo来运行:
sudo cutecom
为什么要用sudo?因为在Linux系统下,串口设备(比如/dev/ttyUSB0, /dev/ttyACM0)的访问权限默认只属于root用户和dialout用户组。直接以普通用户身份运行,可能会因为权限不足而无法打开串口设备。
如果你不想每次都输入sudo密码,更安全的做法是将你的普通用户加入到dialout用户组:
sudo usermod -a -G dialout $USER
执行这条命令后,务必注销当前用户并重新登录,或者重启电脑,这个组权限变更才会生效。之后,你就可以直接输入cutecom(不加sudo)来运行了。
4.2 查找你的串口设备
启动cutecom后,你会看到一个简洁的图形界面。首先要做的就是选择正确的串口设备。
你的硬件设备(比如Arduino、USB转TTL模块)通过USB线连接到电脑后,系统会自动识别它并创建一个设备文件。最常见的名字是/dev/ttyUSB0或/dev/ttyACM0。
如何确认呢?有两个方法:
- 在终端里查看:连接设备前后,分别执行一次
ls /dev/ttyUSB*和ls /dev/ttyACM*。连接后多出来的那个设备就是你的串口。更专业的命令是dmesg | grep tty,它会显示内核日志中关于串口设备的插拔信息,你能看到类似cp210x converter now attached to ttyUSB0这样的记录。 - 在cutecom界面里查看:点击
Device下拉菜单,里面会列出当前系统检测到的所有串口设备,通常你的设备就在其中。
4.3 关键参数设置与连接
选好设备后,接下来设置通信参数。这些参数必须和你的硬件设备端设置完全一致,否则通信会失败,或者收到乱码。
- Baud rate (波特率):这是最重要的参数,表示每秒传输的符号数。常见的有9600, 115200等。你的设备程序里设的是多少,这里就选多少。115200是很多现代开发板的默认速率。
- Data bits (数据位):通常是8。
- Parity (奇偶校验):通常是None。
- Stop bits (停止位):通常是1。
- Flow control (流控制):通常是None。
设置好所有参数后,点击界面上的 Open 按钮。如果一切正常,按钮会变成 Close,并且下方的接收区(那个大的文本框)可能会保持空白,或者根据你的设备,开始接收数据。
4.4 发送与接收数据
- 发送数据:在界面底部的单行输入框(通常标着
Input)里,输入你想发送的字符或命令。比如,对于很多设备,发送一个换行符\n很重要。你可以勾选Append旁边的LF(换行)或CR(回车)。输入完成后,直接按键盘上的回车键,或者点击旁边的Send按钮,数据就发出去了。 - 接收数据:所有从串口设备发来的数据,都会实时显示在中间的大文本区域。你可以在这里看到设备的启动信息、调试日志、或者对你发送命令的回复。
- 一个小技巧:你可以勾选
Hex(十六进制)显示和发送。这在调试二进制协议时非常有用,你可以看到每个字节的十六进制值,而不是尝试转换成可能乱码的字符。
5. 进阶技巧与故障排除
用熟了基本功能,咱们再来点进阶的,顺便把一些常见的“坑”提前列出来。
5.1 保存与加载会话配置
如果你经常调试同一个设备,每次打开都要重新选设备、设波特率,太麻烦了。cutecom支持保存会话配置。
- 设置好所有参数(设备、波特率等)。
- 点击菜单栏的
Settings->Save Settings。 - 给它起个名字保存,比如
MyArduino.cfg。 - 下次使用时,点击
Settings->Load Settings,选择这个配置文件,所有参数就自动恢复了。
5.2 常见问题与解决方案
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
点击Open无反应,或提示Could not open device | 1. 设备未连接或驱动未安装。 2. 权限不足。 3. 设备被其他程序占用。 | 1. 检查设备连接,用ls /dev/tty*确认设备存在。对于PL2303、CH340等常见USB转串口芯片,Ubuntu通常自带驱动,如果没有,需要手动安装。2. 使用 sudo运行,或将用户加入dialout组。3. 关闭可能占用串口的其他软件(如Arduino IDE、另一个 cutecom窗口等)。 |
| 能打开设备,但接收区全是乱码 | 波特率等通信参数设置错误。 | 确保cutecom中的波特率、数据位、停止位、校验位与设备端程序设置完全一致。 这是最常见的原因。 |
| 发送数据,设备无反应 | 1. 接线错误(RX/TX接反)。 2. 设备未处于接收模式。 3. 需要发送特定结束符(如换行)。 | 1. 检查USB转TTL模块与设备板的连接,RX接TX,TX接RX。 2. 确认设备已上电且程序在运行。 3. 在 cutecom发送时,勾选Append LF或CR。 |
编译时make失败,提示Qt相关错误 | Qt开发环境未安装完整,或CMake配置时未找到Qt。 | 重新确认是否安装了qt5-default和libqt5serialport5-dev。尝试删除cutecom目录下的CMakeCache.txt文件,然后重新执行cmake .和make。 |
5.3 与minicom的简单对比
你可能也听说过minicom,它是个非常强大的命令行串口工具。这里简单对比一下,帮你按需选择:
- cutecom:图形界面,上手极其简单,参数设置直观,发送接收数据可视化好。适合快速调试、交互式发送命令、初学者。缺点是需要桌面环境,功能相对基础。
- minicom:纯命令行,功能强大,支持脚本、日志记录、更复杂的调制解调器命令等。适合无图形界面的服务器环境、自动化测试、高级用户。缺点是配置稍复杂,需要记住一些快捷键。
对于绝大多数在Ubuntu桌面环境下进行嵌入式开发、创客项目调试的朋友来说,cutecom的简单直观更能提升效率。它让你专注于和硬件对话,而不是和工具搏斗。
最后,关于从源码安装,我想说,这个过程本身的价值有时超过了安装这个工具。它让你理解了Linux软件从源码到可执行文件的完整流程,下次遇到其他开源软件,你也能举一反三。如果中途遇到问题,别慌,仔细阅读终端的错误信息,它们十有八九会告诉你哪里不对。搜索引擎和相关的技术社区是你最好的朋友。
4601



被折叠的 条评论
为什么被折叠?



