AndroidSerialPort: Android串口通信SDK，由 Google 串口通信库进行封装，可同时打开多个串口，快速接入。并扩展支持设置 su 路径、串口路径、波特率、校验位、数据位、停止位

## 安卓串口通信工具
由 Google 官方串口通信库迁移而来，并在此基础上做了扩展。提供封装后的API，可在一分钟搞定串口通信。可设置停止位、数据位、奇偶校验、流控。
- [English](https://github.com/Acccord/AndroidSerialPort/blob/master/README-en.md)

## 目录
 - [配置](#配置)
 - [混淆](#混淆)
 - [快速使用](#快速使用)
    - 第1步：打开串口
    - 第2步：往串口发数据
    - 第3步：串口返回的数据接收
 - [打开多个串口](#打开多个串口)
    - 第1步：打开串口
    - 第2步：往串口发数据
    - 第3步：串口返回的数据接收
 - [自定义使用](#自定义使用)
    - 第1步：创建实类
    - 第2步：参数配置
    - 第3步：打开串口
    - 第4步：向串口发送数据
    - 详细API
 - [GOOGLE串口通信API](#GOOGLE串口通信API)
    - 设置su路径
    - 查看设备串口列表
 - [更新记录](#更新记录)

## 配置
在项目的build.gradle添加
```
allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}
```
在模块的build.gradle添加
```
dependencies {
    implementation 'com.github.Acccord:AndroidSerialPort:1.5.0'
}
```

## 混淆
```
-keepclasseswithmembernames class * {
    native <methods>;
}
-keep class android.serialport.* {*;}

```

## 快速使用
针对没有特殊串口通信设置需求，使用默认串口配置

### 第1步：打开串口
``` java
/**
 * 打开串口
 * @param portStr   串口号
 * @param ibaudRate 波特率
 *
 * @return 0：打开串口成功
 *        -1：无法打开串口：没有串口读/写权限！
 *        -2：无法打开串口：未知错误！
 *        -3：无法打开串口：参数错误！
 */
NormalSerial.instance().open(String portStr, int ibaudRate);
```

### 第2步：往串口发数据
``` java
/**
 * 注意发送的数据类型为hex，字符串需要转成hex在发送
 * 转换方法：SerialDataUtils.stringToHexString(String s)
 * @param hexData 发送的数据
 */
NormalSerial.instance().sendHex(String hexData)
```

### 第3步：串口返回的数据接收
``` java
//dataListener为串口的接收数据回调，默认接收的类型为hex
NormalSerial.instance().addDataListener(OnNormalDataListener dataListener)
```
总结：快速使用只需要的open成功后，就可以调用sendHex往串口发送数据，同时addDataListener来监听串口数据返回。如需使用其他功能使用，可参考下面的**自定义使用**。

## 打开多个串口
同时打开多个串口，可以针对每一个串口进行数据收发

### 第1步：打开串口
``` java
/**
 * 打开串口，该方法可以多次调用，用来打开多个串口
 * @param portStr   串口号
 * @param ibaudRate 波特率
 *
 * @return 0：打开串口成功
 *        -1：无法打开串口：没有串口读/写权限！
 *        -2：无法打开串口：未知错误！
 *        -3：无法打开串口：参数错误！
 */
COMSerial.instance().addCOM(String portStr, int ibaudRate);
//也可以使用该方法添加串口，自定义串口参数
COMSerial.instance().addCOM(String portStr, int ibaudRate, int mStopBits, int mDataBits, int mParity, int mFlowCon);

//例
COMSerial.instance().addCOM("/dev/ttyS1", 9600);
COMSerial.instance().addCOM("/dev/ttyS2", 115200);
COMSerial.instance().addCOM("/dev/ttyS3", 9600, 1, 8, 0, 0);
```

### 第2步：往串口发数据
``` java
/**
 * 注意发送的数据类型为hex，字符串需要转成hex在发送
 * 转换方法：SerialDataUtils.stringToHexString(String s)
 * @param portStr 串口号（即需要往哪个串口发送数据）
 * @param hexData 发送的数据
 */
COMSerial.instance().sendHex(String portStr, String hexData)
```

### 第3步：串口返回的数据接收
``` java
//dataListener为串口的接收数据回调，打开的所有串口有数据接收就会触发该回调，回调中会区分数据来自哪个串口，默认接收的类型为hex。
COMSerial.instance().addDataListener(OnComDataListener dataListener)
```
总结：多个串口使用只需要多次调用addCOM方法，就可以同时打开多个串口。调用sendHex往不同的串口发送数据，同时addDataListener来监听串口数据返回。如需使用其他功能使用，可参考下面的**自定义使用**。

## 自定义使用

### 第1步：创建实类
``` java
/**
 * 打开串口
 * @param portStr   串口号
 * @param ibaudRate 波特率
 */
BaseSerial mBaseSerial = new BaseSerial() {
                           @Override
                           public void onDataBack(String data) {
                               //这里是串口的数据返回，默认返回类型为16进制字符串
                           }
                       };
```

### 第2步：参数配置
``` java
/**
 * 设置串口
 * @param portStr 串口号
 */
mBaseSerial.setsPort(String sPort);

/**
 * 设置波特率
 * @param iBaudRate 波特率
 */
mBaseSerial.setiBaudRate( int iBaudRate);

/**
 * 停止位 【1 或 2】
 * @param mStopBits 停止位（默认 1）
 */
mBaseSerial.setmStopBits( int mStopBits);

/**
 * 数据位【5 ~ 8】
 * @param mDataBits 数据位（默认 8）
 */
mBaseSerial.setmDataBits( int mDataBits);

/**
 * 奇偶校验【0 None； 1 Odd； 2 Even】
 * @param mParity 奇偶校验（默认 0）
 */
mBaseSerial.setmParity( int mParity);

/**
 * 流控 【不使用流控(NONE), 硬件流控(RTS/CTS), 软件流控(XON/XOFF)】
 * @param mFlowCon 默认不使用流控
 */
mBaseSerial.setmFlowCon(int mFlowCon);
```

### 第3步：打开串口
``` java
/**
 * 打开串口
 *
 * @return 0：打开串口成功
 *        -1：无法打开串口：没有串口读/写权限！
 *        -2：无法打开串口：未知错误！
 *        -3：无法打开串口：参数错误！
 */
mBaseSerial.openSerial();
```

### 第4步：向串口发送数据
``` java
//发送HEX字符串
mBaseSerial.sendHex(String sHex);

//发送字符串
mBaseSerial.sendTxt(String sTxt);

//发送字节数组
mBaseSerial.sendByteArray(byte[] bOutArray);
```

## GOOGLE串口通信API

### 设置su路径
``` java
//需要在打开串口前调用
SerialPort.setSuPath("/system/xbin/su");
```

### 查看设备串口列表
``` java
SerialPortFinder serialPortFinder = new SerialPortFinder();
String[] allDevices = serialPortFinder.getAllDevices();
String[] allDevicesPath = serialPortFinder.getAllDevicesPath();

```

## 更新记录
- 1.5.0 【2019-11-26】
    - 发布1.5.0版本
- 1.3.0 【2019-09-19】
    - 增加停止位、数据位、奇偶校验、流控设置
- 1.1.0 【2019-08-13】
    - minSdkVersion改为14
    - 打开串口回调方法优化
- 1.0.0 【2019-07-18】
    - 发布1.0.0版本

bluecard2020/AndroidSerialPort

简介

发行版

贡献者

近期动态

bluecard2020/AndroidSerialPort .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

bluecard2020/AndroidSerialPort