1. Android Studio 里接串口:为什么 FileInputStream 这条路走不通
在 Android Studio 这套代码开发工具里给工业平板接一路串口,最容易上头的一步不是写协议,而是发现 Java 层连 /dev/ttyS0 都打不开。很多人的第一反应是用 FileInputStream 硬读设备节点,结果要么抛权限异常,要么读出来一串乱码——波特率根本没对上。这就是 Android 串口通讯和桌面 Linux 串口最大的差别:设备节点是现成的,但权限和 termios 配置都不在 SDK 的舒适区里。这篇面向已经能在 Android Studio 里跑起原生工程、又需要把 JNI 和 termios 接进串口收发链路的开发者,讲清楚三件事:为什么不能直接开文件、JNI 侧 termios 怎么配、权限和 SELinux 的坑怎么提前绕开。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 三条技术路线的取舍:JNI、现成串口库与 stty 该选谁
2.1 三条路的对照
Android 内核本身就是 Linux,串口设备在系统里就是 /dev/ttyS0、/dev/ttyUSB0、/dev/ttyACM0 这类字符设备节点。理论上 Java 的 FileInputStream 能打开它,但实际项目里几乎没人这么干。原因集中在两处:一是权限,普通 App 跑在沙箱里,没有访问 /dev 下设备节点的权限;二是配置,波特率、数据位、停止位、校验位、流控这些参数得通过 termios 结构体去设,而 Android SDK 并没有把这套 API 暴露出来。围绕这个缺口,工程上实际只有三条路,取舍差别很大。
| 维度 | JNI + termios | 现成串口库 | Runtime.exec() 调 stty |
|---|---|---|---|
| 接入成本 | 需要 NDK 与 C 代码 | 依赖引入即可 | 不用 NDK,写命令字符串 |
| 配置能力 | 完整,termios 全部字段可控 | 取决于库封装程度 | 受 stty 参数表达能力限制 |
| 时序控制 | 精确到每次系统调用 | 一般 | 每次起进程,时序难保证 |
| 排错难度 | 能拿到 errno 和底层返回值 | 封装层容易挡住细节 | 错误码和输出解析都麻烦 |
| 适用场景 | 长期运行、参数要求明确的设备 | 快速验证、参数简单的场景 | 临时调试或一次性配置 |
先看 Runtime.exec() 调 stty。它最大的优点是绕开 NDK,直接在命令行里改波特率、数据位这些参数,适合临时验证。但每改一次配置就起一个进程,打开设备、配置、读写之间的时序很难卡准;参数里带空格或特殊字符还要转义;命令失败时拿到的是进程退出码,和真正的串口错误隔了一层,排错时基本靠猜。
再看现成串口库。接入快,文档友好,短期做个 Demo 很舒服。问题在于封装层往往把 termios 的细节藏起来了,库里默认开不开流控、VMIN 和 VTIME 怎么设、校验位支持到什么程度,都得翻源码才能确认。一旦现场出现丢字节或乱码,你很难判断是库的默认配置不合适,还是自己的协议解析写错了。
2.2 我为什么选 JNI + termios
真正落到长期运行的设备上,我一般会选 JNI + termios。理由不是它更高级,而是它把控制权完整交还给你:open 的 flags、termios 的每一个字段、每次 read 的阻塞行为,全都在自己手里。出问题时能拿到 errno,能打印实际生效的 termios 结构,能确定是权限、配置还是时序的问题。
代价也要说清楚。引入 NDK 之后,工程里多了一层 C 代码和 CMakeLists.txt,.so 要按 ABI 打进包里,Java 层和 native 层的接口得自己维护。如果团队里没人愿意碰 C,这条路的前期成本确实比引个库高。但如果你的设备要 7×24 跑,参数又必须和硬件手册逐项对齐,这点成本迟早要付——早付比在现场付便宜。
还有一个容易被忽略的点:三种方式并不是互斥的。我常见的做法是先用 stty 快速确认设备和波特率能通,再把这套参数搬进 JNI 的 termios 配置里。stty 负责验证硬件链路,JNI 负责长期运行,分工清楚,排查时也少走弯路。
3. 从零搭 JNI 串口工程:native 方法、CMake 与 termios 配置
3.1 工程骨架与 native 方法声明
先把 Java 侧的壳搭起来。类里静态加载 .so,把打开、读、写、关闭四个动作声明成 native 方法。返回值统一用 int,失败时返回负的 errno,这样 Java 层不用额外抛异常就能判断错误类型。
java复制package com.example.serialport;
public class SerialPort {
static {
System.loadLibrary("serialport"); // 对应 CMake 里的库名
}
// 返回 fd,负数表示打开失败,值为 -errno
public native int open(String path, int baud);
public native int read(byte[] buffer, int len);
public native int write(byte[] data, int len);
public native void close();
}
System.loadLibrary 的名字必须和 CMakeLists.txt 里 add_library 的目标名一致,少了前缀 lib、多了后缀 .so 都会加载失败。native 方法的包名和类名要和 C 侧的函数名严格对应,JNI 靠 Java_包名_类名_方法名 这串符号找函数,改包名忘了改 C 函数名,运行时会直接报 UnsatisfiedLinkError。
C 侧用一个静态 fd 保存设备句柄,整个生命周期里只打开一次。CMakeLists.txt 保持最小:
cmake复制# 版本号按 Android Studio 自带的 CMake 实际版本填写
cmake_minimum_required(VERSION 3.10)
project(serialport)
add_library(serialport SHARED SerialPort.c)
find_library(log-lib log)
target_link_libraries(serialport ${log-lib})
find_library 把系统的 log 库找出来,后面打日志用。整个文件没有额外依赖,串口操作全部靠 POSIX 的 open、read、write、close 和 termios 这套接口完成。
3.2 termios 配置:波特率、数据位、停止位、校验位、流控
这是整条链路里最容易配错的一段。核心顺序是:先 open,再 tcgetattr 取当前配置,然后逐项改,最后 tcsetattr 写回。跳过 tcgetattr 直接构造一个空结构体,很容易把默认值覆盖成 0,表现就是能打开但读不到数据。
c复制#include <jni.h>
#include <fcntl.h>
#include <unistd.h>
#include <termios.h>
#include <errno.h>
static int fd = -1;
JNIEXPORT jint JNICALL
Java_com_example_serialport_SerialPort_open(JNIEnv *env, jobject thiz,
jstring path, jint baud) {
const char *dev = (*env)->GetStringUTFChars(env, path, NULL);
// O_NOCTTY 不让串口成为控制终端;O_NDELAY 非阻塞打开,避免卡死
fd = open(dev, O_RDWR | O_NOCTTY | O_NDELAY);
(*env)->ReleaseStringUTFChars(env, path, dev);
if (fd < 0) return -errno;
struct termios tio;
if (tcgetattr(fd, &tio) != 0) { // 先取默认配置再改,别凭空构造
close(fd); fd = -1; return -errno;
}
cfmakeraw(&tio); // 原始模式,不做回显和字符转换
tio.c_cflag &= ~CSIZE;
tio.c_cflag |= CS8; // 数据位 8
tio.c_cflag &= ~CSTOPB; // 停止位 1,要 2 位改成 |=
tio.c_cflag &= ~PARENB; // 无校验,偶校验改成 |=
tio.c_cflag &= ~CRTSCTS; // 关硬件流控,需要时改成 |=
tio.c_cflag |= CREAD | CLOCAL; // 允许接收,忽略调制解调器控制线
cfsetispeed(&tio, B115200); // 输入波特率
cfsetospeed(&tio, B115200); // 输出波特率
tio.c_cc[VMIN] = 1; // 至少读到 1 字节才返回
tio.c_cc[VTIME] = 0; // 不设超时
tcflush(fd, TCIFLUSH); // 清掉打开前残留的输入
if (tcsetattr(fd, TCSANOW, &tio) != 0) { // TCSANOW 立即生效
close(fd); fd = -1; return -errno;
}
return fd;
}
几个参数的关系值得单独说清楚。cfmakeraw 会把字符大小、校验、流控以外的终端行为重置成原始模式,包括关掉回显和行缓冲,串口通讯里基本都要它。CS8 是数据位,改数据位时先 & ~CSIZE 清掉旧值,否则新旧位会叠在一起。CSTOPB 置位是 2 位停止位,清掉是 1 位。PARENB 置位开校验,具体是奇还是偶由 PARODD 决定。CRTSCTS 控制硬件流控,软流控则是 IXON | IXOFF,两套别混用。
波特率用 cfsetispeed 和 cfsetospeed 分别设输入输出,值用 B115200 这类常量,不是直接写数字。常见参数和 termios 对应关系如下:
| 参数 | termios 字段/宏 | 常见设置 |
|---|---|---|
| 波特率 | cfsetispeed/cfsetospeed + Bxxx |
B115200,按设备手册改 |
| 数据位 | c_cflag 清 CSIZE 后置 CS8 |
8 位 |
| 停止位 | CSTOPB |
清为 1 位,置为 2 位 |
| 校验位 | PARENB / PARODD |
无校验清 PARENB |
| 流控 | CRTSCTS 或 IXON/IXOFF |
默认关,按接线决定 |
VMIN 和 VTIME 决定读的行为。VMIN=1、VTIME=0 表示阻塞到至少读到 1 字节;想按时间超时返回,就把 VTIME 设成具体的十分之一秒数。这两个值配错,表现是 read 一直不返回或者频繁返回 0,现场很折磨人。
3.3 打开、读写与关闭的时序
open 的 flags 里,O_NOCTTY 防止串口被当成控制终端,O_NDELAY 让打开动作不被硬件握手卡住。打开成功后先把配置写回去,再开始收发,顺序不能反。
c复制JNIEXPORT jint JNICALL
Java_com_example_serialport_SerialPort_read(JNIEnv *env, jobject thiz,
jbyteArray buffer, jint len) {
if (fd < 0) return -1;
jbyte *buf = (*env)->GetByteArrayElements(env, buffer, NULL);
int n = read(fd, buf, len); // VMIN=1 时阻塞到至少 1 字节
(*env)->ReleaseByteArrayElements(env, buffer, buf, 0);
return n; // 返回实际读到的字节数
}
JNIEXPORT jint JNICALL
Java_com_example_serialport_SerialPort_write(JNIEnv *env, jobject thiz,
jbyteArray data, jint len) {
if (fd < 0) return -1;
jbyte *buf = (*env)->GetByteArrayElements(env, data, NULL);
int n = write(fd, buf, len);
(*env)->ReleaseByteArrayElements(env, data, buf, 0);
return n;
}
read 返回实际字节数,可能小于请求长度,这是正常的,调用方要按返回值处理,不能假设一次读满。write 同样可能只写一部分,协议层要处理半包。关闭时先 close(fd) 再把 fd 置回 -1,避免重复关闭。
Java 侧调用时别在主线程里做阻塞读,起一个专用线程循环读,读到的字节丢进队列,再由协议层解析。这个结构看着朴素,但它把 IO 和业务解耦了,后面加超时、重连、日志都方便。
4. 串口避坑:权限、SELinux 与 termios 配置顺序的四个翻车点
4.1 现象:open 返回 EACCES,日志里是 Permission denied
原因很直接:普通 App 跑在沙箱里,没有访问 /dev 下设备节点的权限,在 AndroidManifest.xml 里声明 READ_EXTERNAL_STORAGE 完全不管用,那管的是存储不是设备文件。解决要看设备形态:要么设备已 root,通过 su 提权;要么厂商在系统层给应用放行,常见做法是把特定包名加进 ueventd.rc 的权限规则,或者调整 SELinux 策略给这个域开放设备节点。没有系统层配合,纯应用侧绕不过去,早点找设备方确认比反复试权限靠谱。
4.2 现象:设备能打开,但读出来全是乱码
原因通常不是权限,而是 termios 参数和硬件对不上。波特率最常错,数据位、校验位、停止位次之。排查时先把参数按设备手册逐项核对,再做一个回环:把 TX 和 RX 短接,发什么应该收到什么,收发一致说明配置链路通了,不一致就继续查参数。另外注意 cfmakeraw 有没有调用,没调的话终端可能还在做字符转换,收到的数据看着就像乱码。
4.3 现象:改了 termios 但配置不生效
原因是改了结构体却没写回,或者写回用的时机不对。tcsetattr 的第三个参数决定生效方式:TCSANOW 立即生效,TCSAFLUSH 会等输出缓冲清空。如果前面少了 tcgetattr,结构体里的默认值可能是错的,改完再写回反而把错误配置固化下来。稳妥的顺序永远是先取、再改、再写回,写完可以再 tcgetattr 读一次确认实际生效的值。
4.4 现象:设备拔插后,原来能读的节点读不到了
原因是 USB 转串口的节点编号会随枚举顺序变化,今天 /dev/ttyUSB0,明天可能变成 /dev/ttyUSB1。把路径写死在代码里,拔插一次就翻车。解决是尽量用 by-id 或 by-path 这类稳定路径,或者在打开前枚举 /dev 下可用的 ttyUSB、ttyACM 节点逐个试探,找到能打开且配置成功的那个。这个习惯在多设备现场特别值钱。
5. 验证与进阶:用回环和日志把收发钉死
串口调通之后,我最常做的一件事是先把回环跑一遍。TX 和 RX 短接,发一组固定字节,比如 0x01 0x02 0x03 0x04,看读回来的内容是否完全一致。这一步能一次性排除波特率、数据位、校验位、流控四个方向的配置错误,比盯着业务日志猜快得多。回环通了,再接真实设备,问题范围就缩到协议层。
第二件事是把每次打开和配置的结果打出来。open 的返回值、tcgetattr 拿到的原始结构、tcsetattr 之后的返回值,都按十六进制打到 logcat 里。现场出问题时,这几行日志就是黑匣子,能直接看出是权限失败、配置失败还是读写超时。我自己吃过亏:早期只打业务数据不打配置结果,现场丢包查了两天才发现是 VMIN 设成了 0,read 一直非阻塞返回 0,被上层当成了空包丢掉。
第三件事是给读写接口加上边界处理。read 返回 0 不一定是没数据,也可能是对端关闭;返回 -1 要看 errno 是 EINTR 还是真错误;write 半包要循环补齐。这些细节写进封装层,上层业务就不用到处判空。
最后分享一个习惯:新设备到手,我会先用 stty 在命令行确认参数能通,再把同一组参数原样搬进 JNI 的 termios 配置,两边对齐之后才写业务代码。这样配置问题和业务问题从一开始就分开了,少了很多来回。希望帮到你。
