更新记录

1.0.0（2024-06-04）

1.0.0 初版发布

平台兼容性

原生插件通用使用流程：

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

西门子S7 TCP通讯插件

介绍

本插件支持西门子S7通讯协议，目前支持以下功能：

1. 支持读写DB区、M区、I区、Q区、T区、C区、V区
2. 支持的PLC型号：S200_SMART、S300、S400、S1200、S1500
3. 支持多通道连接PLC，最多支持255个连接
4. 支持断线重连

使用说明

1. 引用插件

   const testS7 = uni.requireNativePlugin("firefly-s7")

2. 连接

   const host = '127.0.0.1';
   const port = 102;
   const rack = 0;
   const slot = 2;
   // 自动重连间隔（单位毫秒，0表示不自动重连）
   const reconnectInterval = 0
   testS7.connect(
       {
           'clientId' : 2,      // 客户端ID，1-255，默认为1
           'host' : host,
           'port' : port,
           'rack' : 1,
           'slot' : 1,
           'plcType' : 'S200_SMART', // 如果使用了字符串类型数据时，请设置一下这个属性，因为S200_SMART和其他型号，在处理字符串时有区别。
           'reconnectInterval' : reconnectInterval,
       }, 
       (result) => {
           modal.toast({
               message: result.msg,
               duration: 2
           });
       }
   );

3. 读数据

   // 读取数据
   var plcAddr = 'DB1.10';
   var clientId = 1;
   testS7.read(clientId, plcAddr, 'Word', (result) => {
       if (result.code == 0) {
           modal.toast({
               message: result.msg + ", 数据为" + result.data,
               duration: 2
           });
       } else {
           modal.toast({
               message: result.msg,
               duration: 2
           });
       }
   });

4. 写数据

   // PLC地址
   var plcAddr = 'DB1.10';
   // 要写入的数据
   var val = '121';
   var clientId = 1;
   testS7.write(clientId, plcAddr, 'Word', val, (result) => {
       modal.toast({
           message: result.msg,
           duration: 2
       });
   });

5. 断开连接

   var clientId = 1;
   testS7.disconnect(clientId, 
       (result) => {
           modal.toast({
               message: result.code + '-' + result.msg,
               duration: 2
           });
       }
   );

方法说明

1. read(clientId, addr, dataType, callback)：读取PLC数据

   参数名	说明	示例
   clientId	客户端ID，1-255	1
   addr	PLC地址，具体格式参照下面的章节	DB1.10
   dataType	PLC数据类型，更多内容参照下面的章节	BOOL
   callback	回调方法，(result) => {}	result格式： {"code": 0, "data": 1, "msg": "读取成功"}

2. write(clientId, addr, dataType, val, callback)：写入PLC数据

   参数名	说明	示例
   clientId	客户端ID，1-255	1
   addr	PLC地址，具体格式参照下面的章节	DB1.10.0
   dataType	PLC数据类型，更多内容参照下面的章节	BOOL
   val	要写入的数据，都以字符串形式传给插件	true
   callback	回调方法，(result) => {}	result格式： {"code": 0, "msg": "写入成功"

支持的数据类型

• PLC数据类型

  数据类型	说明	示例
  WORD	2个字节，无符号整型（0 到 65535）	100
  DWORD	4个字节，无符号整型（0 到 4294967295）	100
  INT	2个字节，有符号整型（-32768 到 32767）	-6
  DINT	4个字节，有符号整型（-2147483648 到 2147483647）	-23
  REAL	4个字节，浮点型	23.45
  BOOL	布尔型，1位，true或者false	true
  BYTE	字节，1个字节	12
  STRING	字符串，长度不定	'abcd'
  BYTE_ARRAY	字节数组，长度不定，以16进制字符串表示	'0A0B23A0'

PLC地址格式说明

    // DB开头
    [DB][区编号].[起始地址].[布尔型的位置或者是字符串的长度]
    // 例如：
    // 如果是WORD类型的数据，DB15.10表示从DB区15编号，起始地址为10，取2个字节
    // 如果是BOOL类型的数据，DB15.10.0表示从DB区15编号，起始地址为10，取第1个字节的第0位
    // 如果是STRING类型的数据，DB15.12.20表示从DB区15编号，起始地址为12，取20个字节
    // 非DB开头
    [M|I|Q|T|C|V][起始地址].[布尔型的位置或者是字符串的长度]
    // 例如：
    // 如果是WORD类型的数据，VW100表示从V区，起始地址为100，取2个字节
    // 如果是BOOL类型的数据，VW100.0表示从V区，起始地址为100，取第1个字节的第0位
    // 如果是STRING类型的数据，V100.12表示从V区，起始地址为100，取12个字节