SerialPlot 常见问题解决方案

项目基础介绍

SerialPlot 是一个用于实时绘制串口数据的小型且简单的软件。该项目的主要功能包括从串口读取数据、支持二进制数据格式（如 (u)int8, (u)int16, (u)int32, float）、用户定义的帧格式、ASCII 输入（逗号分隔值）、多通道同步绘图、定义和发送命令到设备、以及保存当前波形快照到 CSV 文件。

该项目的主要编程语言是 C++，并且依赖于 Qt 5 和 Qwt 6.1 库。

新手使用注意事项及解决方案

1. 依赖库安装问题

问题描述：新手在尝试编译和运行 SerialPlot 时，可能会遇到依赖库未安装或版本不匹配的问题。

解决步骤：

1. 安装 Qt 5 和 Qwt 6.1：

   • 在 Ubuntu/Debian 系统上，使用以下命令安装：

     sudo apt install qtbase5-dev libqt5serialport5-dev cmake mercurial
     

   • 在 OpenSUSE 系统上，使用以下命令安装：

     sudo zypper in libqt5-qtbase-devel libqt5-qtserialbus-devel libqt5-qtserialport-devel cmake mercurial
     

2. 下载和安装 Qwt：

   • 可以选择让 SerialPlot 的构建脚本自动下载和构建 Qwt，或者手动下载 Qwt 6.1 并按照官方文档进行安装。

2. 编译过程中的 CMake 配置问题

问题描述：在编译过程中，可能会遇到 CMake 配置错误，导致无法正确生成 Makefile。

解决步骤：

1. 检查 CMake 版本：

   • 确保系统上安装的 CMake 版本是最新的，建议使用 3.0 或更高版本。

2. 手动配置 CMake：

   • 进入项目目录，创建一个 build 目录并进入：

     mkdir build && cd build
     

   • 运行 CMake 进行配置：

     cmake ..
     

   • 如果需要指定 Qwt 的安装路径，可以使用以下命令：

     cmake -DBUILD_QWT=false -DQWT_INCLUDE_DIR=/path/to/qwt/include -DQWT_LIBRARY=/path/to/qwt/lib ..
     

3. 运行时 USB 串口设备移除问题

问题描述：在 Ubuntu 16.04 或 Linux Mint 18 系统上，移除 USB 串口设备时，SerialPlot 可能会进入死循环并最终崩溃。

解决步骤：

1. 使用补丁版本：

   • 开发者已经上传了一个修复了此问题的 libqt5serialport5 包到 Launchpad PPA。可以通过以下命令安装：

     sudo add-apt-repository ppa:hyozd/serialplot
     sudo apt update
     sudo apt install libqt5serialport5
     

2. 使用 AppImage 版本：

   • 如果不想修改系统库，可以直接使用 SerialPlot 的 AppImage 版本，该版本已经包含了修复。

通过以上步骤，新手用户可以更好地理解和解决在使用 SerialPlot 过程中可能遇到的问题。