KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #react #mcp #open-source #deepseek-harness #dsh-plugin #ai

DeviceConnector

★ 80 Open GitHub ↗

🔥Android 设备连接者，提供Android上位机和外设的连接通讯通道，支持多种连接方式选择，如串口、Usb Com、Usb、蓝牙、Wifi的连接.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DeviceConnector

Android 设备连接者，提供Android上位机和外设的连接通讯通道，支持多种连接方式选择，如串口、Usb Com、Usb、经典蓝牙、低功耗蓝牙、Wifi的连接，
DeviceConnector框架上层调用一致，底层不同实现，方便使用者切换连接方式。为简化上层调用和方便数据处理， 全部连接采用同步操作，即一发一收（一问一答）的方式通讯

**应用场景：**

基于硬件协议编写应用层硬件通讯（供应商没有提供SDK的情况），App示例可作为调试工具使用

# 效果图

[安装包下载](app-debug.apk)

# 依赖引入

步骤 1. 在工程跟目录build.gradle文件下添加仓库

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

步骤2. 添加依赖

dependencies {
          //1.1.0-RC2之前
	      implementation 'com.github.kellysong:DeviceConnector:1.1.0-RC2'
          implementation 'com.github.mik3y:usb-serial-for-android:3.4.3'
          implementation 'com.github.licheedev:Android-SerialPort-API:2.0.0'
          implementation 'androidx.annotation:annotation:1.2.0'

//1.1.0之后
		  implementation 'com.github.kellysong:DeviceConnector:1.2.1'
	}

# API调用

在Application onCreate()初始化

DeviceContext.init(this,false);

**1.初始化实例**

//串口
    BaseConnectProvider baseConnectProvider = new SerialPortConnectProvider(SerialPortConfig serialPortConfig);
    
    //Usb Com
    BaseConnectProvider baseConnectProvider = new UsbComConnectProvider(int vendorId, int productId, SerialPortConfig serialPortConfig);
    //or
    BaseConnectProvider baseConnectProvider = new UsbComConnectProvider(UsbDevice usbDevice, SerialPortConfig serialPortConfig);
    
    //Usb
    BaseConnectProvider baseConnectProvider = new UsbConnectProvider(int vendorId, int productId);
    //or
    BaseConnectProvider baseConnectProvider = new UsbConnectProvider(UsbDevice usbDevice);
    //默认蓝牙 Com
    BaseConnectProvider baseConnectProvider = new BluetoothConnectProvider(BluetoothDevice bluetoothDevice);
    BaseConnectProvider baseConnectProvider = new BluetoothConnectProvider(String address);
    //指定蓝牙服务UUID
    BaseConnectProvider baseConnectProvider = new BluetoothConnectProvider(BluetoothDevice bluetoothDevice, String uuid);
    BaseConnectProvider baseConnectProvider = new BluetoothConnectProvider(String address, String uuid);
    
    //Wifi
    BaseConnectProvider baseConnectProvider = new WifiConnectProvider(String host, int port, int connectTimeout, int readTimeout);

//特别地：蓝牙Ble
    BluetoothLeConnectProvider connectProvider = new BluetoothLeConnectProvider(BluetoothDevice bluetoothDevice);
    BluetoothLeConnectProvider connectProvider = new BluetoothLeConnectProvider(String address);

**2.打开连接**

baseConnectProvider.open();

**3.写和读数据**

//只写
    baseConnectProvider.write(byte[] sendParams, int timeout);
    //只读
    baseConnectProvider.read(byte[] buffer, int timeout);
    //写和读（通用型api）
    baseConnectProvider.read(byte[] sendParams, byte[] buffer, int timeout);

**3.1 蓝牙Ble通讯**

蓝牙Ble,与其它连接方式不好统一，故做特殊处理

//特征写请求,其它请求创建不同的实例发送即可
    CharacteristicWriteRequest bluetoothLeRequest = new CharacteristicWriteRequest();
    bluetoothLeRequest.setService(UUID_SERVICE);
    bluetoothLeRequest.setCharacter(UUID_CHARACTER_WRITE);
    bluetoothLeRequest.setBytes(sendData);
    BluetoothLeResponse response = new BluetoothLeResponse();
    bluetoothLeRequest.sendRequest(bluetoothLeRequest,response,5*1000);

//蓝牙ble监听服务端(也叫从机/外围设备/peripheral)数据，分两步操作

//1.监听通知信息
     bluetoothLeConnectProvider.setBluetoothLeNotifyListener(new BluetoothLeNotifyListener() {
                            @Override
                            public void onNotify(UUID serviceId, UUID characterId, byte[] value) {
                                
                            }
                        });
	//2.开启通知
    NotifyRequest notifyRequest = new NotifyRequest();
    notifyRequest.setService(UUID_SERVICE);
    notifyRequest.setCharacter(UUID_CHARACTER_READ);
    notifyRequest.setEnable(true);
    BluetoothLeResponse response = new BluetoothLeResponse();
    bluetoothLeConnectProvider.sendRequest(notifyRequest,response,5*1000);
    //3. 修改mtu(子线程执行)
    MtuRequest mtuRequest = new MtuRequest();
    mtuRequest.setMtu(240);
    //ble包的最大值，实际以返回的mtu作为参考值
    BluetoothLeResponse response = new BluetoothLeResponse();
    bluetoothLeConnectProvider.mtuRequest(notifyRequest,response,5*1000);

**4.关闭连接**

baseConnectProvider.close();

# 混淆

-keep class android.serialport.**{*;}
    -keep class * implements com.hoho.android.usbserial.driver.UsbSerialDriver {
  
            public static java.util.Map getSupportedDevices();
    }

# 注意事项

1. 检查设备支持的连接方式
2. 检查连接参数配置是否正确
3. 发送数据时，检查数据是否符合硬件协议要求，此外注意是否需要在报文数据尾部追加报文结束符/r(0x0A)或/n(0x0D)或/r/n(0x0A 0x0D)或其它校验码
4. 传统串口连接需要Root,免Root连接建议使用Usb Com
5. Usb Com和Usb连接之前需要先申请Usb权限，再调用open，不然出现首次连接失败;需要注意的是，正常申请一次权限就可以，但是Usb设备被拔出或者应用卸载了，连接之前需要再次申请权限
6. Usb连接传输模式、传输速度的不同，要注意发送数据包的大小，这里的包指一次传输数据的大小，包大小受限于端点的最大包大小
7. Usb Com和Usb连接如果的read()方法的逻辑需要改变或者需要一次发送，多次循环读取才能把数据读取完整的话，建议继承**连接提供者**，覆写read()方法进行一次写多次读；V1.1.0-RC2版本开始支持上层多次读，无须继承覆写read()方法
8. 蓝牙搜索在Android 6.0以上需要申请定位权限；高版本蓝牙连接会弹出蓝牙配对授权窗口,建议在蓝牙设置里面进行配对和取消配对，配对一次即可或者直接通过蓝牙地址直连；如果基于Android 12+设备运行，需要开发者自行申请运行时的蓝牙扫描和连接权限
9. Wifi连接需要网络权限
10. App示例中，使用手机就可以模拟测试Wifi连接和蓝牙连接，前提是先启动服务；串口和USB测试需要相应的设备连接
11. 已集成网络、蓝牙（包括ble）、Usb定位权限（权限申请由调用者申请）
12. 提高ble蓝牙连接成功率的建议：1.扫描到后连接 2.蓝牙断开再次连接，等待蓝牙断开连接回调后再次尝试 2.在连接失败或者断开连接之后，关闭之前进行缓存刷新（框架已经处理）
13. 针对有输入输出流的连接者（串口、Wifi、经典蓝牙），需要在外部处理，建议拿到输入流之后在外部启动线程监听，这时候不能使用read方法，需要调用者自己实现

# License

Copyright 2022 Song Jiali
    
    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.

DeviceConnector

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README