This commit is contained in:
2026-02-10 09:51:18 +08:00
commit 634e0b9456
150 changed files with 18730 additions and 0 deletions
@@ -0,0 +1,19 @@
## 1.0.92025-04-19
优化
## 1.0.82025-04-08
去掉安全判断
## 1.0.72025-02-28
优化
## 1.0.62025-02-11
优化
## 1.0.52025-01-16
修复uniapp bug
## 1.0.42024-10-28
修改uniapp @UTSJS.keepAlive 问题
## 1.0.32024-10-08
已知问题修复
## 1.0.12024-09-04
修复bug
## 1.0.02024-09-03
初始化,本周内完善文档
Binary file not shown.
@@ -0,0 +1,87 @@
{
"id": "android-serialport",
"displayName": "Android平台串口通信 serialport(长期维护)",
"version": "1.0.9",
"description": "android/安卓平台串口通信uts,支持串口号、波特率、数据位、校验位、停止位、流控等参数设置(长期维护)",
"keywords": [
"SerialPort串口",
"UTS",
"安卓串口,233,485"
],
"repository": "",
"engines": {
"HBuilderX": "^3.91"
},
"dcloudext": {
"type": "uts",
"sale": {
"regular": {
"price": "19.99"
},
"sourcecode": {
"price": "101.00"
}
},
"contact": {
"qq": "1530948626"
},
"declaration": {
"ads": "无",
"data": "插件不采集任何数据\n使用过程中有任何问题可以加qq 1530948626 联系,随时修复",
"permissions": "必须ROOT"
},
"npmurl": ""
},
"uni_modules": {
"dependencies": [],
"encrypt": [],
"platforms": {
"cloud": {
"tcb": "y",
"aliyun": "y",
"alipay": "y"
},
"client": {
"Vue": {
"vue2": "u",
"vue3": "y"
},
"App": {
"app-android": {
"minVersion": "21"
},
"app-ios": "n",
"app-harmony": "u"
},
"H5-mobile": {
"Safari": "n",
"Android Browser": "n",
"微信浏览器(Android)": "n",
"QQ浏览器(Android)": "n"
},
"H5-pc": {
"Chrome": "n",
"IE": "n",
"Edge": "n",
"Firefox": "n",
"Safari": "n"
},
"小程序": {
"微信": "n",
"阿里": "n",
"百度": "n",
"字节跳动": "n",
"QQ": "n",
"钉钉": "n",
"快手": "n",
"飞书": "n",
"京东": "n"
},
"快应用": {
"华为": "n",
"联盟": "n"
}
}
}
}
}
+173
View File
@@ -0,0 +1,173 @@
# android-serialport
### uniappx/uniapp demo 亲测可用
### 长期维护 有任何问题 可在群中联系
### uniapp demo 在例子项目下的 zip 文件
#### 插件测试使用方法
1. 选择试用,绑定要试用的项目appid,
2. 选择后下载到对应的本地项目,
3. 按照文档 -》把插件引入项目(即 import {SerialPortHelper} from "@/uni_modules/android-serialport"; 需要先引入),
4. 发布-》云打包-》选择制作基座-》打包等基座制作完成
5. 运行 -》 运行到手机或模拟器-》运行到Androidapp基座-》选择使用自定义基座运行-》选择手机-》运行
### uni-app x项目(uvue)中调用示例:(调试需要自定义基座)
```
import {SerialPortHelper} from "@/uni_modules/android-serialport";
var helper=new SerialPortHelper();
// var array=[] as string[];
// array=helper.getAllDevices() // 获取串口列表
helper.setPath("/dev/ttyS7");
helper.setBaudrate(9600);
//一般默认
// helper.dataBits(8);
// helper.parity(0);
// helper.stopBits(1);
// helper.flags(0)
var state= helper.open();
if(state){
helper.startAutoReadData(function(res){
// console.log(res[0])
console.log(helper.byte2HexString(res))
})
// var b:ByteArray=new ByteArray(5);
// b[0]=0x55;
// b[1]=0x00;
// b[2]=0x12;
// b[3]=0x00;
// b[4]=0x7B;
// helper.sendData(b)
helper.sendDataString("550120057B")
//停止自动接收
// helper.stopReadPortData();
//关闭串口
// helper.close()
}
```
### uni-app 项目(vue nvue)中调用示例:(调试需要自定义基座)
```
import {SerialPortHelper} from "@/uni_modules/android-serialport";
var helper=new SerialPortHelper();
// console.log(helper.getAllDevices())
helper.setPath("/dev/ttyS7");
helper.setBaudrate(9600);
var state= helper.open();
if(state){
helper.startAutoReadData(function(res){
console.log(helper.uint8ArrayToHexString(res))
})
var b=new Uint8Array(5);
b[0]=0x55;
b[1]=0x00;
b[2]=0x12;
b[3]=0x00;
b[4]=0x7B;
helper.sendDataUnit8Array(b)
//helper.sendDataString("550120057B")
}
```
### 开发文档
### 获取设备列表
#### getAllDevice()
return 串口列表
### 设置串口参数
setPath 设置路径
####
setBaudrate 设置波特率
####
dataBits 数据位 默认8,可选值为5~8
####
parity 校验位 parity 0:无校验位(默认);1:奇校验位
###
stopBits 停止位 stopBits 默认11:1位停止位;2:2位停止位
###
flags 标志 flags 默认0
### 打开串口
#### open 需要调用才可打开
return 返回是否打开成功
#### isOpen
return 返回是否打开成功
### 关闭串口
close
### 开启自动读取串口数据,需要先打开串口
#### startAutoReadData
回调读取的数据function 数据类型为ByteArray
### 关闭自动读取串口数据
#### stopReadPortData
### 手动读取串口数据 手动读取之前需先打开串口 且不可和自动读串口数据同时调用
#### available()
return 返回-1 表示无可读数据 其它为可读数据长度
#### readData
参数1 需要读取数据的长度 number
参数2 开始读取位置 number
参数3 读取数据结束位置 number
参数4 回调读取的数据function 数据类型为ByteArray
### 发送数据
#### sendData
参数1 需要发送的ByteArray
#### sendDataString
参数1 string 类型的16进制的字符串 例如 "550120057B"
### 辅助转换方法
### 将16进制字符串转换为ByteArray
#### parseHexStr2Byte
参数1 为16进制字符串
### ByteArray转换成16进制字符串
#### byte2HexString
参数1 ByteArray
### ByteArray 辅助操作方法
#### 将两个ByteArray进行合并
#### addBytes
参数1 合并ByetArray 1
参数2 合并ByetArray 2
return 合并后的ByetArray
#### 将ByteArray进行剪切
#### subBytes
参数1 需要剪切的 ByetArray
参数2 开始位置 类型number
参数3 需要剪切的长度 number
return 剪切后的ByetArray
#### js Unit8Array 转为String
#### uint8ArrayToHexString
参数1 Unit8Array
return String
@@ -0,0 +1,4 @@
{
"abis": ["armeabi-v7a", "arm64-v8a"],
"minSdkVersion": "21"
}