SSCom是专为Linux/macOS设计的跨平台串口调试工具，支持AppImage一键运行或源码编译安装，需配置dialout权限（Linux）及正确串口号（Linux为/dev/ttyUSB0，macOS为/dev/tty.usbserial-*），设置波特率115200等参数后即可完成设备连接与数据交互。
要在Linux或macOS系统上完成串口设备连接与数据交互，必须先获取并正确运行SSCom这款跨平台串口调试工具，它不依赖Windows环境，也不需要安装复杂驱动，但若跳过权限配置或选错串口号，连设备都识别不到。
下载与安装SSCom
方法一：AppImage一键运行（推荐新手）
在终端中执行以下命令下载并赋予执行权限：wget https://gitcode.com/gh_mirrors/ss/sscom/-/releases/download/latest/sscom-*.AppImage && chmod +x sscom-*.AppImage
这一步操作起来很简单，直接把文件拖进去就行。运行时只需输入 ./sscom-*.AppImage 即可启动，无需root权限，也不会污染系统环境。
方法二：源码编译（适合需定制功能的用户）
Linux系统先安装依赖：sudo apt-get install qtcreator libqt5serialport5-dev libudev-dev qt5-default
然后拉取代码并编译：git clone https://gitcode.com/gh_mirrors/ss/sscom && cd sscom && qmake && make
编译完成后生成的 sscom 可执行文件就在当前目录，直接运行即可。
【注意：macOS用户需先执行 brew install qt5 并设置PATH，否则qmake会报错】
首次运行前的关键配置
第一步：解决Linux串口访问权限问题
在终端中执行：sudo usermod -aG dialout $USER
这行命令将当前用户加入dialout组，是访问/dev/ttyUSB*设备的前提。不执行这步，后续点击“打开串口”一定会提示“Permission denied”。
第二步：注销并重新登录系统
新用户组权限不会热加载，必须完全退出当前桌面会话再重新登录，否则配置不生效。
第三步：确认串口设备路径
插入USB转串口设备后，在终端运行 ls /dev/ttyUSB*（Linux）或 ls /dev/tty.usbserial*（macOS），看到类似 /dev/ttyUSB0 的输出，说明硬件已被系统识别。
SSCom界面参数设置与连接
启动SSCom后，主界面分为三大部分：顶部接收区、中部控制区、底部发送区。
在控制区依次完成以下设置：
① 从“串口号”下拉菜单中选择你刚确认的设备路径，如 ttyUSB0 或 tty.usbserial-1420；
② 波特率设为 115200（绝大多数ESP32、STM32开发板默认值）；
③ 数据位选 8、停止位选 1、校验位选 None、流控选 None；
④ 点击“打开串口”按钮——状态栏显示紫色指示灯且文字变为“串口已打开”，即表示连接成功。
发送与接收数据实操
在底部发送框中输入 AT+GMR，勾选“附加换行符”，点击“发送”按钮。
如果设备支持AT指令，顶部接收区会立即返回模块版本信息，例如 OK\r\nAT version:2.2.0.0。
若只看到乱码或无响应，立刻检查波特率是否与设备一致——【9600和115200混用是导致乱码的最常见原因】。
要保存本次通信记录，点击“保存窗口”按钮，选择路径即可导出为文本文件。
调试失败的快速排查
现象：下拉菜单中看不到任何串口号。
原因：USB转串口芯片驱动未加载，或设备未真正插入。
处理：拔插设备后运行 dmesg | tail -10（Linux）或 system_profiler SPUSBDataType | grep -A 5 -B 5 "USB Serial"（macOS），查看内核是否识别到设备。
现象：点击“打开串口”后状态栏变红并提示“Can't open port”。
原因：串口号被其他程序占用，或权限未生效。
处理：关闭可能占用串口的IDE（如Arduino IDE）、串口监控软件，再执行一次重新登录操作。
现象：能打开串口，但发送无响应、接收无数据。
原因：TX/RX线接反，或设备未上电。
处理：用万用表测设备端VCC与GND电压是否正常，确认杜邦线TX→RX、RX→TX交叉连接。
