如何快速实现Android串口通信：Android-Serialport完整指南 🚀

Android-Serialport 是一个基于谷歌官方串口库移植的增强版Android串口通信工具，支持串口名称、波特率、校验位、数据位、停止位和流控等完整配置项，让开发者轻松实现工业设备、智能家居等场景的串口数据交互。

📌 项目核心优势

✅ 功能全面的串口配置

相比传统串口库仅支持波特率设置，Android-Serialport提供全参数配置能力：

• 支持5-8位数据位调整
• 包含奇校验/偶校验等5种校验模式
• 硬件/软件流控自由切换
• 1/2位停止位可选

✅ 开箱即用的粘包处理

内置4种数据包解析策略，轻松应对各种通信协议：

• 固定长度解析：StaticLenStickPackageHelper
• 指定分隔符解析：SpecifiedStickPackageHelper
• 可变长度解析：VariableLenStickPackageHelper

✅ 简洁API设计

通过SerialHelper封装类，3行代码即可完成串口通信初始化：

SerialHelper serialHelper = new SerialHelper();
serialHelper.setPort("/dev/ttyS1");
serialHelper.setBaudRate(115200);
serialHelper.open(); // 打开串口

📸 应用场景展示

Android-Serialport配套示例App运行界面，支持串口参数实时配置与数据收发监控

该库广泛应用于：

• 工业自动化控制系统 🤖
• 智能家居设备通信 🏠
• 车载信息终端交互 🚗
• 嵌入式设备调试工具 ⚙️

📦 极速集成指南

一键添加依赖

在Module级build.gradle中添加：

dependencies {
    implementation 'io.github.xmaihh:serialport:2.1.1'
}

核心参数配置表

参数	可选值范围	默认值
波特率	9600/19200/115200等标准速率	115200
数据位	5/6/7/8	8
校验位	NONE/ODD/EVEN/SPACE/MARK	NONE
停止位	1/2	1
流控	NONE/RTSCTS/XONXOFF	NONE

💻 关键功能实现

1. 串口设备扫描

SerialPortFinder finder = new SerialPortFinder();
String[] devices = finder.getAllDevicesPath(); // 获取所有可用串口号

2. 全参数初始化

serialHelper.setPort("/dev/ttyUSB0");      // 设置串口号
serialHelper.setBaudRate(9600);            // 设置波特率
serialHelper.setDataBits(8);               // 8位数据位
serialHelper.setParity(SerialPort.PARITY_NONE); // 无校验
serialHelper.setStopBits(1);               // 1位停止位
serialHelper.setFlowCon(SerialPort.FLOWCON_NONE); // 无流控

3. 数据收发操作

// 发送数据
serialHelper.sendHex("A1 B2 C3");          // 发送十六进制数据
serialHelper.sendTxt("Hello SerialPort");  // 发送文本数据

// 接收数据（通过回调）
serialHelper.setOnDataReceivedListener((ComBean comBean) -> {
    String hexData = ByteUtil.byteArrToHex(comBean.bRec); // 字节转十六进制
    String txtData = new String(comBean.bRec);            // 直接转文本
});

🔧 开发环境配置

Android-Serialport支持Android Studio 3.0+及Gradle 4.1+环境

权限配置

在AndroidManifest.xml添加：

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

📚 进阶使用技巧

自定义粘包解析

继承AbsStickPackageHelper实现私有协议解析：

public class CustomStickHelper extends AbsStickPackageHelper {
    @Override
    public byte[] execute(InputStream is) throws IOException {
        // 实现自定义协议解析逻辑
    }
}

串口状态监控

serialHelper.setOnOpenListener(isSuccess -> {
    if (isSuccess) {
        Log.d("SerialPort", "串口打开成功");
    }
});

📄 许可证信息

本项目采用Apache-2.0开源许可证，详细条款见LICENSE文件。

通过Android-Serialport库，开发者可以告别繁琐的JNI开发，快速构建稳定可靠的串口通信功能。无论是工业控制还是智能硬件开发，这个轻量级库都能满足你的需求！