更新记录

1.0.0(2022-11-02)

沁恒微电子串口通讯,支持CH342/CH343/CH9102/CH9103,打开/关闭串口,读写通讯,串口设置


平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 12.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 ×

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


前言

沁恒微电子串口通讯,支持CH342/CH343/CH9102/CH9103


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

方法

  • 是否支持USB HOST

            var resp = wchuart.usbFeatureSupported();
            if(isString(resp)) {
                resp = JSON.parse(resp);
            }
            if(!resp.flag) { 
                // 系统不支持USB Host功能
                this.showMsg("系统不支持USB Host功能")
            }
  • 检测USB状态

            // 检测USB状态
            wchuart.monitorUSBState((resp) => {
                var opt = resp.opt;
                // 
                if(opt == "usbDeviceDetach") {
                    //设备移除
                } else if(opt == "usbDeviceAttach") {
                    // 设备插入

                } else if(opt == "usbDevicePermission") {
                     //请求打开设备权限结果
                     var result = resp.result;
                }
                this.showMsg(JSON.stringify(resp));
            });
  • 动态权限申请

wchuart.checkSelfPermission();
  • 初始化设备

wchuart.initDevice();
  • 获取所有设备

                var resp = wchuart.getAllDevice();
                if(isString(resp)) {
                    resp = JSON.parse(resp);
                }
                var devices = resp.devices;
                this.deviceId = devices[0].deviceId;
                this.showMsg(JSON.stringify(resp));
  • 打开设备

                var deviceId = this.deviceId;
                var params = {};
                params.deviceId = deviceId;
                var resp = wchuart.openDevice(params, (receiveData) => {
                     var serialNumber = receiveData.serialNumber;
                      var buffer = receiveData.buffer;
                      this.showMsg("收到数据:" + buffer);
                });
                if(isString(resp)) {
                    resp = JSON.parse(resp);
                }
                var flag = resp.flag;
                if(flag) { // 打开成功

                } else{
                    var code = resp.code;
                    if(code == -2) {
                        // 没有权限打开该设备
                        wchuart.requestPermission({deviceId: deviceId});
                    } else {

                    }
                }
  • 设置串口参数

                var deviceId = this.deviceId; // 通过getAllDevice接口获取到某个设备的deviceId

                //获取芯片串口数目,为负则代表出错
                var serialNumResp = wchuart.getSerialCount({deviceId: deviceId});
                if(isString(serialNumResp)) {
                    serialNumResp = JSON.parse(serialNumResp);
                }
                // 串口数目
                var serialNumberMax = serialNumResp.serialNumber - 1;

                var serialNumber = 0; // 第几个串口, 取值范围为0~ serialNumberMax
                var params = {};
                params.deviceId = deviceId; // 设备ID
                params.baud = 115200; // 波特率
                params.data = 8; // 数据位
                params.stop = 1; // 停止位
                params.parity = 1; // parity
                params.isFlow = false; // isFlow
                var resp = wchuart.setSerialParameter(params);
                if(isString(resp)) {
                    resp = JSON.parse(resp);
                }
  • 获取串口数量

                var serialNumResp = wchuart.getSerialCount({deviceId: this.deviceId});
                if(isString(serialNumResp)) {
                    serialNumResp = JSON.parse(serialNumResp);
                }
                // 串口数目
                var serialNumber = serialNumResp.serialNumber;
  • setDTR

                var params = {};
                params.deviceId = this.deviceId;
                params.serialNumber = 0;
                params.checked = true;
                var resp = wchuart.setDTR(params);
                if(isString(resp)) {
                    resp = JSON.parse(resp);
                }
                this.showMsg(JSON.stringify(resp));
  • setRTS

                var params = {};
                params.deviceId = this.deviceId;
                params.serialNumber = 0;
                params.checked = true;
                var resp = wchuart.setRTS(params);
                if(isString(resp)) {
                    resp = JSON.parse(resp);
                }
                this.showMsg(JSON.stringify(resp));
  • 写数据/发送数据

                var deviceId = this.deviceId;
                var params = {};
                params.deviceId = deviceId;
                params.serialNumber = 0;
                params.data = "FFAA00EECC";//  十六进制
                var resp = wchuart.writeData(params);
                if(isString(resp)) {
                    resp = JSON.parse(resp);
                }
                if(resp.result > 0) {
                     // 发送成功
                }
                this.showMsg(JSON.stringify(resp));
  • 断开设备

                wchuart.disconnect({
                    deviceId: this.deviceId
                });

详细代码见demo

支持定制,QQ252797991

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

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/> <uses-feature android:name="android.hardware.usb.host" android:required="true" />

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问