更新记录

0.1.1（2023-10-13）

0.1.1 (2023-10-11)

• 修改关闭串口的方法；
• 优化多个串口同时连接后数据收发；

0.1.0（2023-10-08）

更新记录

0.1.0 (2023-10-07)

• 基于原生Android开发的 uni-app 插件，实现与平板的串口通信；
• 支持同时连接多个串口，同时进行数据收发；
• 修改每个连接串口的波特率、数据位、校验位、停止位、流控等参数设置；
• 每个串口进行独立的数据收发；

平台兼容性

原生插件通用使用流程：

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

dodo-uniplugin-serialPort

插件测试平台

1. 测试平板型号：PET_A133、PET_RK3568；

2. 测试平板系统：Android 12；

3. 设备已root

功能简介

1. 基于原生Android开发的 uni-app 插件，实现与平板的串口通信；

2. 支持同时连接多个串口，同时进行数据收发；

3. 修改每个连接串口的波特率、数据位、校验位、停止位、流控等参数设置；

4. 每个串口进行独立的数据收发；

使用方法

引用

    // #ifdef APP-PLUS
    const serialPort = uni.requireNativePlugin('dodo-uniplugin-serialPort')
    // #endif

API

1. 获取设备所有串口

       serialPort.getAllDeicesPath((res) => {          
           if (res?.list) {
               console.log(res.list)
           }
       })

2. 初始化指定的串口

       let params = {
           path: '/dev/ttyS4',
           baudRate: '115200', // 波特率 
           parity: '0', // 校验位:：0(不校验)、1(奇校验)、2(偶校验)
           dataBits: '8', //  数据位:5，6，7，8
           stopBits: '1', // 停止位:1、2
           flowCon: '0', // 流控:0(不使用流控)、1(硬件流控RTS/CTS)、2(软件流控XON/XOFF)
       }    
       serialPort.initSerialPort(...Object.values(params), (res) => {      
           if (res?.success) {//根据success判断初始化是否正常
               uni.showToast({
                   icon: 'none',
                   title: `串口[${path}]初始化成功`,
                   duration: 2000
               });
           }
       })

3. 打开指定的串口

        let path='/dev/ttyS4'
        serialPort.openSerialPort(path, res => {
            if (res?.success) {      
                setTimeout(() => {
                    onListenerHex(item) //开始监听串口数据
                }, 2000)
            }
        })

4. 监听已打开的串口

   4.1 以十六进制返回 onSerialPortDataListenerHex

   4.2 以字符串返回 onSerialPortDataListenerASCII

   4.3 以字节返回 onSerialPortDataListenerByte

    let path='/dev/ttyS4'
    // 以十六进制返回  onSerialPortDataListenerHex 
    serialPort.onSerialPortDataListenerHex(path, receive => {
            //实时监听接收的数据 
            console.log(receive)
        }, send => {
            //实时监听发送的数据
            console.log(send)
        })

5. 向打开的串口发送消息

   5.1 以十六进制发送 sendHex

   5.2 以字符串发送 sendASCII

   5.3 以字节发送 sendBytes

    let path='/dev/ttyS4'   
    //以十六进制发送 sendHex       
    serialPort.sendHex(path, , (res) => {
            if (res?.success) {
                uni.showToast({
                    icon: 'none',
                    title: `串口[${path}]发送消息成功`,
                    duration: 2000
                });
            }
        })

6. 查看串口开启状态

        let path='/dev/ttyS4'   
        serialPort.serialPortState(path,  (res) => {
            if (res?.success) {
                uni.showToast({
                    icon: 'none',
                    title: `串口[${path}]已打开`,
                    duration: 2000
                });
            }else{
                uni.showToast({
                    icon: 'none',
                    title: `串口[${path}]未打开`,
                    duration: 2000
                });
            }
        })

7. 设置串口

   7.1 设置波特率 setBaudRate 波特率：9600 14400 19200 115200 ...

   7.2 设置校验位 setParity 校验位：0(不校验)、1(奇校验)、2(偶校验)

   7.3 设置数据位 setDataBits 数据位：5，6，7，8

   7.4 设置停止位 setStopBits 停止位：1，2

   7.5 设置流控 flowCon 流控：0(不使用流控)，1(硬件流控RTS/CTS)，2(软件流控XON/XOFF)

        let baudRate = 9600
        serialPort.setBaudRate(path, baudRate, (res) => {
            if (res?.success) {
                uni.showToast({
                    icon: 'none',
                    title: `串口[${path}]设置成功`,
                    duration: 2000
                });
            }
        })

8. 关闭指定的串口

        serialPort.serialPortClose(path,  (res) => {
            if (res?.success) {
                uni.showToast({
                    icon: 'none',
                    title: `串口[${path}]已关闭`,
                    duration: 2000
                });
            } 
        })

9. 获取root权限

        serialPort.rootCommand('default',(res) => {//默认第一个参数为字符串default 
            if (res) {
                uni.showToast({
                    icon: 'none',
                    title: ` [${res.msg}] `,
                    duration: 2000
                });
            }
        })

如果觉得可以就点个👍吧，您的关注就是我们的动力！

有使用问题或项目定制需求，联系微信

• rick6655（请备注添加原因）

参考文档 集成uni-app项目测试插件

参考文档 离线打包制作自定义基座