更新记录

1.0.4（2023-07-19）

1. 修复个别系统open接口出错情况

1.0.3（2023-07-17）

1. USB设备相关接口增加端口interfaceIndex参数

1.0.2（2023-07-06）

1. 增加USB权限，修复某些设备调用findSerialPortDevice获取不到设备的问题

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

前言

android OTG USB串口通讯，无需root权限系统，支持多个串口收发数据，串口参数支持波特率、数据位、校验位、停止位、流控,支持CP210X、CDC、FTDI、PL2303、CH34X、CP2130 SPI-USB

    var usbSerial = uni.requireNativePlugin("wrs-usbSerial");

方法

整体流程：监听USB设备的插拔-》获取USB设备列表-》选择其中一个设备-》请求设备权限-》打开设备-》设置波特率/数据位/停止位等 -》监听接收数据-》发送数据

• 注册监听

// 注册监听
            usbSerial.registerReceiver((resp) => {
                var action = resp.action;
                switch (action) {
                    // USB授权结果
                    case "com.android.wrs.USB_PERMISSION":
                        var granted = resp.granted;
                        this.showMsg("USB授权结果:" + granted);
                        break;
                    case "android.hardware.usb.action.USB_DEVICE_ATTACHED":
                        this.showMsg("有USB设备连接");
                        break;
                    case "android.hardware.usb.action.USB_DEVICE_DETACHED":
                        this.showMsg("USB设备断开连接");
                        break;
                    default:
                        break;
                }
            });

• 获取所有USB串口

                // 先获取所有的USB设备
                usbSerial.findSerialPortDevice((resp) => {
                    var devices = resp.devices;

                });

• 请求串口权限，权限结果通过registerReceiver接口回调

            var key = devices[clickIndex].key;
            var params = {};
            params.key = key; // 设备key,从findSerialPortDevice接口获取
            // 请求权限
            usbSerial.requestPermission(params);

• 打开USB

             var params = {};
             params.key = key;
             // params.interfaceIndex = 0;
             // 打开USB串口
             usbSerial.open(params, (openResp) => {
                this.deviceKey = key;
             });

• 监听接收数据

             var params = {};
             params.key = key;
             // params.interfaceIndex = 0;
             usbSerial.read(params, (resp) => {
                var data = resp.data;
             });

• 写数据

             var params = {};
             params.key = key;
             // params.interfaceIndex = 0;
             params.data = "FAFBFC";
             usbSerial.write(params);

• 设置波特率

                var params = {};
                 // params.interfaceIndex = 0;
                params.key = this.deviceKey;
                params.value = this.baudRate;
                usbSerial.setBaudRate(params);

• 设置数据位

                    var params = {};
                     // params.interfaceIndex = 0;
                    params.key = this.deviceKey;
                    params.value = 8; // 5~8
                    usbSerial.setDataBits(params);

• 设置停止位

                    var params = {};
                     // params.interfaceIndex = 0;
                    params.key = this.deviceKey;
                    params.value = 1; // 1: STOP_BITS_1 2: STOP_BITS_2 3: STOP_BITS_15
                    usbSerial.setStopBits(params);

• 设置校验位

                    var params = {};
                     // params.interfaceIndex = 0;
                    params.key = this.deviceKey;
                    params.value = 1; // 0: PARITY_NONE 1: PARITY_ODD 2: PARITY_EVEN 3: PARITY_MARK 4:PARITY_SPACE
                    usbSerial.setParity(params);

• 设置流控

                    var params = {};
                     // params.interfaceIndex = 0;
                    params.key = this.deviceKey;
                    params.value = 1; // 0: FLOW_CONTROL_OFF 1: FLOW_CONTROL_RTS_CTS 2: FLOW_CONTROL_DSR_DTR 3: FLOW_CONTROL_XON_XOFF
                    usbSerial.setFlowControl(params);

• 设置setRTS

        var params = {};
         // params.interfaceIndex = 0;
         params.key = this.deviceKey;
        params.value = true;
        usbSerial.setRTS(params);   

• 设置setDTR

        var params = {};
        params.key = this.deviceKey;
        // params.interfaceIndex = 0;
        params.value = true;
        usbSerial.setDTR(params);   

• 关闭USB串口

        var params = {};
        params.key = this.deviceKey;
        // params.interfaceIndex = 0;
        usbSerial.close(params);    

        或
        usbSerial.syncClose(params);    

支持定制，QQ252797991

如果觉得可以就点个👍吧，欢迎粉丝收藏，土豪打赏，您的关注就是我们创作的动力！