Android-EasySerialPort 一个使用很方便的Android串口调用库

项目更新内容:

v1.1:
(还未更新远程依赖,需要用的下载下来自用,抽时间我更新上去,不要忘了start)

  1. 升级至androidx
  2. 去除不必要的依赖
  3. 支持链式调用配置监听事件、设置端口号、设置波特率
  4. 修改串口接收数据时格式化时间,现在改为时间戳

项目地址:https://github.com/maybesix/Android-EasySerialPort
(最新文档看github上的项目文档)

背景

之前在一个项目中,需要使用Android开发板来做项目,其中的一个需求是使用串口。最开始是用厂家提供的串口示例程序,但是配置异常麻烦。需要so文件,gradle需要配置,需要导入libs等等。
在第二个项目中,恰好又有串口的需求,但是开发版换了,使用之前的厂家的so文件,竟然出错没法运行。由于之前的厂家未提供相应的源码,所以无法查看是什么导致的so文件出错。所以借鉴网上的项目和谷歌的开源项目https://github.com/cepr/android-serialport-api来实现串口的调用。由于很多第三方库质量参差不齐,出了问题也不知道是什么原因。因此自己基于官方公布.so来封装串口库,最终用了很长的时间,才实现串口的功能。同样的问题,由于使用NDK去调用串口的程序,配置异常麻烦。
所以,我抽时间把之前的程序梳理了一遍,方便后来者使用。

优点

1.使用方便

在需要实现Activity或者Service中这样写:

SerialPortHelper serialPort;
//串口程序初始化
serialPort = new SerialPortHelper();
//设置端口
serialPort.setPort("/dev/ttyHSL1");
//设置波特率
serialPort.setBaudRate("9600");
//设置接收消息监听
serialPort.setSerialPortReceivedListener(this);
//打开串口
serialPort.open();

串口发送:

//发送十六进制
 serialPort.sendHex("A55A0010002096");
//发送文本
 serialPort.sendTxtString("hello world");

串口接收:实现SerialPortHelper.OnSerialPortReceivedListener接口

public class MainActivity extends AppCompatActivity implements SerialPortHelper.OnSerialPortReceivedListener {
...
 @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
...
    }
...
@Override
    public void onSerialPortDataReceived(ComPortData comPortData) {
        //处理接收的串口消息
        String s = HexStringUtils.byteArray2HexString(comPortData.getRecData());
        Log.i(TAG, "onReceived: " + s);
    }
}

至此,串口的打开、发送、接收就全部完成了。

2.适配性强

在视美泰的3288全系列、使用未知名开发板、智洋核心板等都通过实际测试。可以用于实际的生产。

相关方法介绍

串口相关

串口操作类 → SerialPortHelper

isOpen                        : 是否开启串口
getBaudRate                   : 获取波特率
setBaudRate                   : 设置波特率
getPort                       :  获取串口名称 
setPort                       :  设置串口名称
open                          :  打开串口
close                         :  关闭串口
sendHex                       :  以16进制发送
sendTxtString                 :  以文本发送
getLoopData                   :  获取循环发送的数据
setLoopData                   :  设置循环发送的数据
getDelay                      :  获取延迟
setDelay                      :  设置延时(毫秒)
startSend                     :  开启循环发送
stopSend                      :  停止循环发送
OnSerialPortReceivedListener  :  串口数据接收回调

串口数据基类 → ComPortData

getRecData   :  获取串口数据
setRecData   :  设置串口数据
getRecTime   :  获取接收时间
setRecTime   :  设置接受时间
getComPort   :  获取串口名称
setComPort   :  设置串口名称

串口数据处理相关

十六进制转换 → HexStringUtils

isOdd                  : 判断是否为奇数
hexString2Int          : 16进制字符串转int
hexString2Byte         : 16进制字符串转byte
byte2HexString         : byte转16进制字符串
byteArray2HexString    : byte数组转16进制字符串
hexString2ByteArray    : 16进制字符串转byte数组

CRC校验 → CrcUtils

isPassCRC     : 返回是否通过验证
getCrcString  : 获取16进制的crc字符串
toHexString   : int转16进制字符串
getCrc        : 传入bytes,计算得到CRC验证码
hexToByte     : 16进制字符串转byte数组

如果帮助了你,请点个赞,收个藏!
欢迎加入AndroidXH技术群,群聊号码:755520968
群没人解散了

你可能感兴趣的:(Android-EasySerialPort 一个使用很方便的Android串口调用库)