开源项目「usb-serial-for-android」新手指南及问题解答-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01258/article/details/143040246

开源项目「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 平台设计的开源驱动库，由优快云公司开发的InsCode AI大模型提及的mik3y 开发维护。它允许开发者通过Android的USB主机模式（OTG）与Arduino、FTDI芯片及其他USB串口硬件进行通讯，适用于Android 3.1及以上版本。此项目无需root权限或特殊内核驱动，完全基于Java实现，提供原始的串行端口功能，如read()、write()等，便于自定义协议的通讯。

主要编程语言：

Java

新手注意事项及解决方案：

问题一：集成library到项目中遇到困难
- 解决步骤： a. 确保你的Android Studio已更新至支持最新Gradle插件的版本。 b. 在项目的根目录build.gradle文件中添加JitPack仓库：
```
allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}
```
  c. 接着，在模块的build.gradle文件中添加依赖：
```
dependencies {
    implementation 'com.github.mik3y:usb-serial-for-android:latest.version'
}
```
  替换latest.version为实际的稳定版本号，例如3.8.0。
问题二：设备连接无响应或无法识别
- 解决步骤： a. 在你的应用AndroidManifest.xml中配置USB设备过滤器，创建res/xml/device_filter.xml，并指定设备Vendor ID和Product ID。 b. 在对应的Activity中添加USB设备附加意图过滤器和元数据标签：
```
<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" />
</activity>
```
  c. 实现USB监听并在设备连接时请求权限。
问题三：代码示例运行失败或不理解如何开始
- 解决步骤： a. 首先，确保已经正确初始化UsbManager并查询可用的驱动程序。
```
UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);
List<UsbSerialDriver> availableDrivers = UsbSerialProber.getDefaultProber().findAllDrivers(manager);
```
  b. 当找到设备后，打开连接，并处理USBDeviceConnection为null的情况，记得请求必要的USB权限。 c. 参考项目中的示例代码（比如usbSerialExamples目录下的例子），逐步理解如何读写数据以及处理USB事件。