【亲测免费】安装与配置向导：安卓USB串口驱动库（usb-serial-for-android）-优快云博客

安装与配置向导：安卓USB串口驱动库（usb-serial-for-android）

【免费下载链接】usb-serial-for-android Android USB host serial driver library for CDC, FTDI, Arduino and other devices. 项目地址: https://gitcode.com/gh_mirrors/us/usb-serial-for-android

项目基础介绍及编程语言

usb-serial-for-android 是一个专为Android平台设计的开源驱动库，它允许开发者通过Android USB主机模式(OTG)与Arduino、FTDI芯片、Silabs CP2102等USB串行设备进行通信，自Android 3.1版本起被支持，并从Android 4.2稳定工作。该库无需root权限，不依赖ADK或特殊内核驱动，完全由Java实现。项目采用MIT许可证分发，使得它在开源社区中易于使用和二次开发。

主要编程语言： Java

关键技术和框架

USB Host API: 利用Android提供的USB主机API来直接与连接的USB设备交互。
CDC/ACM Protocol Support: 支持通用串行总线通信控制与数据传输（CDC/ACM）协议，适用于如Arduino的设备。
自定义驱动探测: 提供了UsbSerialProber类以支持未知但兼容的设备，允许添加自定义规则识别设备。
事件驱动读取: 实现了一种基于事件的读取机制，通过SerialInputOutputManager处理输入数据流，增强应用响应性。

准备工作与详细安装步骤

步骤一：获取项目代码

首先，访问项目主页https://github.com/mik3y/usb-serial-for-android，点击“Code”按钮选择ZIP下载或者通过Git克隆仓库到本地：

git clone https://github.com/mik3y/usb-serial-for-android.git

步骤二：环境配置

确保您已安装：

Android Studio: 最新版本，用于Android应用的开发环境。
Android SDK: 包含对应于目标设备的API级别。
JDK: 至少Java 8以上版本。

步骤三：集成库到您的项目

添加JitPack仓库（对于Gradle项目）

打开项目的根目录下的build.gradle(Project)文件。

在allprojects块中的repositories添加JitPack仓库地址：

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

或者，如果你使用的是较新版的Gradle并且喜欢在settings.gradle中管理：

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

添加依赖

在您的应用模块的build.gradle(Module)文件中加入以下依赖：

dependencies {
    implementation 'com.github.mik3y:usb-serial-for-android:3.8.0'
}

步骤四：配置设备过滤器（可选）

为了当设备插入时接收通知，在应用的res/xml目录下创建device_filter.xml文件，并在AndroidManifest.xml中指定它。

device_filter.xml示例

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <usb-device vendor-id="1234" product-id="5678"/>
</resources>

在AndroidManifest.xml中关联此过滤器：

<activity android:name=".YourActivity">
    <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" />
</activity>

步骤五：使用驱动进行设备通讯

获取可用驱动并打开连接：

UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);
List<UsbSerialDriver> availableDrivers = UsbSerialProber.getDefaultProber().findAllDrivers(manager);
UsbSerialDriver driver = availableDrivers.get(0);
UsbDeviceConnection connection = manager.openDevice(driver.getDevice());
UsbSerialPort port = driver.getPorts().get(0);
port.open(connection);
port.setParameters(115200, 8, UsbSerialPort.STOPBITS_1, UsbSerialPort.PARITY_NONE);

进行数据读写操作：

byte[] request = {...}; // 准备发送的数据
port.write(request, WRITE_WAIT_MILLIS);

int len;
byte[] response = new byte[1024];
len = port.read(response, READ_WAIT_MILLIS);

实现事件驱动的读取（利用SerialInputOutputManager）：

SerialInputOutputManager ioManager = new SerialInputOutputManager(port, YourActivity.this);
ioManager.start();

@Override
public void onNewData(byte[] data) {
    runOnUiThread(() -> textView.append(new String(data)));
}

// 记得在适当的时候关闭端口
port.close();

至此，您已经成功将usb-serial-for-android集成至您的项目中，并可以开始进行USB串行通讯的开发工作了。记得测试不同场景以保证兼容性和稳定性。