Android-SerialPort-API
Introduction: Fork 自 Google 开源的 Android 串口通信 Demo,修改成 Android Studio 项目
Tags:
Fork自 Google 开源的 Android 串口通信 Demo,修改成 Android Studio 项目
This lib is a fork of the Android serial port communication Demo open sourced by Google.
Installation & Usage
Gradle
添加依赖:
Add the dependency:
allprojects {
repositories {
...
jcenter()
mavenCentral() // since 2.1.3
}
}
dependencies {
// 传统 4KB 内存页面版本
implementation 'com.licheedev:android-serialport:2.1.4'
// 适配 16KB 页面版本,https://developer.android.google.cn/guide/practices/page-sizes?hl=zh-cn
implementation 'com.licheedev:android-serialport:2.1.5'
}
Import
import android.serialport.SerialPort;
su path
In order to read/write to a serial port in Android you'll need su binary installed on device (this can be done by rooting the device). Usually Android devices that has the ability to communicate with serial ports have su installed on the default path "/system/bin/su". To change this use:
// su 默认路径为 "/system/bin/su"
// The default path of su is "/system/bin/su"
// 可通过此方法修改
// If the path is different then change it using this
SerialPort.setSuPath("/system/xbin/su");
Usage
// 默认 8N1(8 数据位、无校验位、1 停止位)
// Default 8N1 (8 data bits, no parity bit, 1 stop bit)
SerialPort serialPort = new SerialPort(path, baudrate);
// 可选配置数据位、校验位、停止位 - 7E2(7 数据位、偶校验、2 停止位)
// or with builder (with optional configurations) - 7E2 (7 data bits, even parity, 2 stop bits)
SerialPort serialPort = SerialPort
.newBuilder(path, baudrate)
// 校验位;0:无校验位(NONE,默认);1:奇校验位(ODD);2:偶校验位(EVEN)
// Check bit; 0: no check bit (NONE, default); 1: odd check bit (ODD); 2: even check bit (EVEN)
// .parity(2)
// 数据位,默认 8;可选值为 5~8
// Data bit, default 8; optional value is 5~8
// .dataBits(7)
// 停止位,默认 1;1:1 位停止位;2:2 位停止位
// Stop bit, default 1; 1:1 stop bit; 2: 2 stop bit
// .stopBits(2)
.build();
// read/write to serial port - needs to be in different thread!
InputStream in = serialPort.getInputStream();
OutputStream out = serialPort.getOutputStream();
// close
serialPort.tryClose();
实现方式参考
Implementation reference
