Github傳送門:OkUSB
OkUSB
一個簡潔的Android串口通信框架。
功能簡介
- 支持設置波特率
- 支持設置數據位
- 支持設置停止位
- 支持設置校驗位
- 支持DTS和RTS
- 支持串口連接狀態監聽
用法簡介
Gradle
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
dependencies {
compile 'com.github.zhouzhuo810:OkUSB:1.0.0'
}
具體用法
1.在AndroidManifest.xml中添加如下特性:
<uses-feature android:name="android.hardware.usb.host" />
在需要連接串口的Activity中添加:
<intent-filter>
<action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
</intent-filter>
<meta-data
android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
android:resource="@xml/device_filter" />
2.在res文件夾創建xml文件夾,新建device_filter.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
<!-- 要進行通信的USB設備的供應商ID(VID)和產品識別碼(PID)-->
<usb-device vendor-id="0403" product-id="6001" />
</resources>
3.前面都是準備工作,這里才真正使用。
//初始化
usb = new USB.USBBuilder(this)
.setBaudRate(115200) //波特率
.setDataBits(8) //數據位
.setStopBits(UsbSerialPort.STOPBITS_1) //停止位
.setParity(UsbSerialPort.PARITY_NONE) //校驗位
.setMaxReadBytes(20) //接受數據最大長度
.setReadDuration(500) //讀數據間隔時間
.setDTR(false) //DTR enable
.setRTS(false) //RTS enable
.build();
//實現監聽連接狀態和數據收發。
usb.setOnUsbChangeListener(new USB.OnUsbChangeListener() {
@Override
public void onUsbConnect() {
Toast.makeText(MainActivity.this, "conencted", Toast.LENGTH_SHORT).show();
}
@Override
public void onUsbDisconnect() {
Toast.makeText(MainActivity.this, "disconencted", Toast.LENGTH_SHORT).show();
}
@Override
public void onDataReceive(byte[] data) {
tvResult.setText(new String(data, Charset.forName("GB2312")));
}
@Override
public void onUsbConnectFailed() {
Toast.makeText(MainActivity.this, "connect fail", Toast.LENGTH_SHORT).show();
}
@Override
public void onPermissionGranted() {
Toast.makeText(MainActivity.this, "permission ok", Toast.LENGTH_SHORT).show();
}
@Override
public void onPermissionRefused() {
Toast.makeText(MainActivity.this, "permission fail", Toast.LENGTH_SHORT).show();
}
@Override
public void onDriverNotSupport() {
Toast.makeText(MainActivity.this, "no driver", Toast.LENGTH_SHORT).show();
}
@Override
public void onWriteDataFailed(String error) {
Toast.makeText(MainActivity.this, "write fail" + error, Toast.LENGTH_SHORT).show();
}
@Override
public void onWriteSuccess(int num) {
Toast.makeText(MainActivity.this, "write ok " + num, Toast.LENGTH_SHORT).show();
}
});
4.發送數據
usb.writeData(byte[], 500);
5.如果是Activity,可以在onDestroy中調用如下代碼關閉串口。
if (usb != null) {
usb.destroy();
}
License
Copyright 2017 zhouzhuo810
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.