更新记录

1.0.1(2022-12-22)

1、对原生功能进行封装,使其可以在uniapp项目中进行 串口调试获取串口信息


平台兼容性

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


使用说明

采购的K7G10安卓屏,选配的 RS485,本测试案例也是在RS485串口中接入了电子秤传感器,按传感器协议进行的通讯调试;

相关人员使用中,根据自己所接入的设备,按协议通过串口发送数据

注:1、该插件并不适用于所有的安卓屏设备 2、部分使用者,在使用的过程中会报错,有可能是 项目中 manifest.json 的 minSdkVersion 不兼容,需要根据报错提示进行修改

第一步:引入插件

const Xdserialport = uni.requireNativePlugin('Xd-serialPort');

相关功能 api

1、测试插件是否正常引入

Xdserialport.testPlugin(function (res) { 
    console.log('Xdserialport ', res); 
}) 

2、打开串口

/**
* "/dev/ttyS3" =》设备节点 
* 9600 =》波特率 
*/
Xdserialport.openSerialPort("/dev/ttyS3", 9600); 

3、通过串口发送指令

/**
* "01040000000131ca" =》 demo中,秤传感器通讯获取重量的指令;用户在实际使用中,需要根据实际情况修改为适合自己的
*/
Xdserialport.sendPacket("01040000000131ca");

4、读取串口数据

Xdserialport.getPortData((res) => { 
    console.log('获取串口信息', res); 
    this.portData = res.data;
});

注:实际项目使用中,通过屏串口读取数据;需要采用周期定时器,内部通过不断地发送指令、读取指令,来获取最新的串口数据;

5、关闭串口

Xdserialport.closeSerialPort(function (res) { 
    console.log('closeSerialPort', res); 
});

隐私、权限声明

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

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

插件不采集任何数据

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

许可协议

作者未提供license.md

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