/serialPort

Android通用的串口通信库

Primary LanguageJava

说明

串口通信是软件和硬件通信经常用到的东西，我在这里开源一个我自己平常也在用的串口库，大家在使用遇到问题了欢迎指出，我会第一时间修复，强烈建议以依赖的方式导入，这样避免代码同步。

效果图

演示

下载体验


因为图方便，用手机浏览器扫码可下载

版本更新历史：

  • v3.1.3：(2023年02月21日)

    • 支持多串口接收和发送(目前sdk支持6路串口)
    • 避免分包接收，支持大量数据一次性接收
    • 建议所有都升级到V3.1.3,使用上和V3.0.0有一点区别，V3.1.3使用更加简单

  • v3.0.0：(2021年10月20日)

    • 基于现有的串口框架增加调试助手，方便测试
    • 框架新增打开方法，支持直接修改串口
    • 代码优化

  • v2.0.0：(2021年9月10日)

    • 解决数据包接收不完整bug
    • 增加参数构建
    • 代码优化

  • v1.0.0

    • 第一代版本sdk提交

项目依赖

allprojects {
           repositories {
			...
			maven { url 'https://jitpack.io' }
             }
	}

Step 2. Add the dependency

dependencies {
    implementation 'com.github.cl-6666:serialPort:V3.1.3'
}

框架初始化，在Application里面

  • 参数：上下文，是否打开日志，日志标签
   public class App extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化串口框架
        SerialUtils.getInstance().init(this,true,"TAG");
    }
}

数据监听状态以及打开状况

        SerialUtils.getInstance().setmSerialPortDirectorListens(new SerialPortDirectorListens() {
            /**
             *  接收回调
             * @param bytes 接收到的数据
             * @param serialPortEnum  串口类型
             */
            @Override
            public void onDataReceived(byte[] bytes, SerialPortEnum serialPortEnum) {
                Log.i(TAG, "当前接收串口类型：" + serialPortEnum.name());
                Log.i(TAG, "onDataReceived [ byte[] ]: " + Arrays.toString(bytes));
                Log.i(TAG, "onDataReceived [ String ]: " + new String(bytes));
            }

            /**
             *  发送回调
             * @param bytes 发送的数据
             * @param serialPortEnum  串口类型
             */
            @Override
            public void onDataSent(byte[] bytes, SerialPortEnum serialPortEnum) {
                Log.i(TAG, "当前发送串口类型：" + serialPortEnum.name());
                Log.i(TAG, "onDataSent [ byte[] ]: " + Arrays.toString(bytes));
                Log.i(TAG, "onDataSent [ String ]: " + new String(bytes));
            }

            /**
             * 串口打开回调
             * @param serialPortEnum  串口类型
             * @param device  串口号
             * @param status 打开状态
             */
            @Override
            public void openState(SerialPortEnum serialPortEnum, File device, SerialStatus status) {
                XLog.i("串口打开状态："+device.getName()+"---打开状态："+status.name());
                switch (serialPortEnum) {
                    case SERIAL_ONE:
                        switch (status) {
                            case SUCCESS_OPENED:
                                ToastUtils.show("串口打开成功");
                                break;
                            case NO_READ_WRITE_PERMISSION:
                                ToastUtils.show("没有读写权限");
                                break;
                            case OPEN_FAIL:
                                ToastUtils.show("串口打开失败");
                                break;
                        }
                        break;
                    case SERIAL_TWO:
                        XLog.i("根据实际多串口场景演示");
                        break;
                }
            }
        });
	
	//多路串口打开逻辑.....

打开多路串口，目前支持6路串口，使用的时候请在回调方法之后执行

        //多串口演示
        List<Driver> list2=new ArrayList<>();
        //串口ttyS4
        list2.add(new Driver("/dev/ttyUSB0", "115200"));
        list2.add(new Driver("/dev/ttyUSB1", "115200"));
        list2.add(new Driver("/dev/ttyS4", "115200"));
        SerialUtils.getInstance().manyOpenSerialPort(list2);

发送数据

  • 参数：发送哪路串口，发送数据 byte[]
  • 返回：发送是否成功
//todo 这里默认发送一路串口，根据用户自定义
boolean sendBytes = SerialUtils.getInstance().sendData(SerialPortEnum.SERIAL_ONE, sendContentBytes);

关闭串口

SerialUtils.getInstance().serialPortClose();

PS：传输协议需自行封装

通用疑问解答

1.假如正常打开串口，但是收不到消息的话，请检查你的波特率
2.假如提示没有权限的话，请通过运行SelectSerialPortActivity起来看一下是否有读写权限
3.有好的建议或者问题欢迎提出

感谢

作者博客地址

博客地址：https://blog.csdn.net/a214024475/article/details/113735085