refactor: 初始化缓存编译读写表达式

修改默认启动端口

.gitignore

@@ -362,8 +362,14 @@ MigrationBackup/
 # Fody - auto-generated XML schema
 FodyWeavers.xsd
 
-/src/ThingsGateway.Web.Server/Default.db
-/src/PluginPro*/
+/src/*Pro*/
 /src/*Pro*
-/src/TestResults*/
-/src/ThingsGateway.Web.Server/ThingsGateway.db
+/src/*pro*
+/src/*pro*/
+/doc/.*
+/doc/build/
+/src/ThingsGateway.Server/.config/
+/src/nuget.exe
+/src/nupkgs/
+/src/nupkgs
+

LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Cachetribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2023-present Diego
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

README.md

@@ -1,110 +1,72 @@
-<div align="center"><h1 align="center">ThingsGateway</a></h1></div>
-<div align="center"><h3 align="center">边缘采集网关</h3></div>
+# ThingsGateway
+
+## Introduction
+
+A cross-platform, high-performance edge data collection gateway based on net8, capable of handling millions of data points per.
+
+## Documentation
+
+[Documentation](https://kimdiego2098.github.io/).
+
+[NuGet](https://www.nuget.org/packages?q=Tags%3A%22ThingsGateway%22)
+
+### Plugin List
+
+#### Data Collection Plugins
 
-#### 介绍
+| Plugin Name | Remarks | 
+|-------|-------|
+| Modbus | Supports Rtu/Tcp message formats, with Serial/Tcp/Udp links | 
+| SiemensS7 | Siemens PLC S7 series | 
+| Dlt6452007 | Supports Serial/Tcp/Udp links | 
+| OpcDaMaster | Compiled for 64-bit |
+| OpcUaMaster | Supports certificate login, object extension, Json read/write |
 
-基于Net6/7+Blazor Server的跨平台边缘采集网关，支持南北端插件式开发，
-动态更新插件，并拥有较完善的北端Rpc权限管理。
+#### Business Plugins
 
+| Plugin Name | Remarks | 
+|-------|-------|
+| ModbusSlave | Supports Rtu/Tcp message formats, with Serial/Tcp/Udp links, supports Rpc reverse writing | 
+| OpcUaServer | OpcUa server, supports Rpc reverse writing | 
+| MqttClient | Mqtt client, supports Rpc reverse writing, script-customizable upload content | 
+| MqttServer | Mqtt server, supports WebSocket, supports Rpc reverse writing, script-customizable upload content | 
+| KafkaProducer | Script-customizable upload content | 
+| RabbitMQProducer | Script-customizable upload content | 
+| SqlDB | Relational database storage, supports historical storage and real-time data updates | 
+| SqlHisAlarm | Alarm historical data relational database storage | 
+| TDengineDB | Time-series database storage | 
+| QuestDB | Time-series database storage | 
 
-####  功能亮点
+
+## License
+
+[Apache-2.0](https://gitee.com/diego2098/ThingsGateway/blob/master/LICENSE)
+
+## Demo
+
+[ThingsGateway Demo Address](http://47.119.161.158:5000/)
+
+Account: **SuperAdmin**
+
+Password: **111111**
+
+**In the upper-right corner, switch to the IoT Gateway module in the personal popup box**
 
-- Blazor Server架构，开发部署更简单
-- 采集/上传配置完全支持Excel导入导出
-- 插件式驱动，方便驱动二次开发，并支持动态更新
-- 支持时序数据库存储
-- 实时/历史报警(Sql转储)，支持布尔/高低限值
+## Docker 
+```shell
 
-#### 社区版采集插件
-> 支持分包解析/订阅
-- Modbus(Rtu/Tcp/Udp)
-- OPCDAClient（支持导入节点）
-- OPCUAClient（支持导入节点）
-- 西门子S7协议
+docker pull registry.cn-shenzhen.aliyuncs.com/thingsgateway/thingsgateway
 
-#### 社区版上传插件
-> 支持Rpc写入
-- Modbus Server
-- OPCUA Server
-- Mqtt Server
-- Mqtt Client
-
-> 不支持Rpc
-- RabbitMQ
-
-
-#### nuget
-
-- Modbus库，支持ModbusTcp、ModbusRtu、ModbusRtuOverTcp、ModbusUdp、ModbusServer等
-``` powershell
- dotnet add package ThingsGateway.Foundation.Adapter.Modbus
 ```
-- OPCDA客户端库，支持X64，支持NetCore，支持检测重连
-``` powershell
- dotnet add package ThingsGateway.Foundation.Adapter.OPCDA
-```
-- OPCUA客户端库
-``` powershell
- dotnet add package ThingsGateway.Foundation.Adapter.OPCUA
-```
-
-- S7库
-``` powershell
- dotnet add package ThingsGateway.Foundation.Adapter.Siemens
-```
-
-####  效果图
- <table>
-    <tr>
-        <td><img src="https://gitee.com/diego2098/ThingsGateway/raw/master/Image/1.png"/></td>
-        <td><img src="https://gitee.com/diego2098/ThingsGateway/raw/master/Image/2.png"/></td>
-        <td><img src="https://gitee.com/diego2098/ThingsGateway/raw/master/Image/3.png"/></td>
-    </tr>
-    <tr>
-        <td><img src="https://gitee.com/diego2098/ThingsGateway/raw/master/Image/4.png"/></td>
-        <td><img src="https://gitee.com/diego2098/ThingsGateway/raw/master/Image/5.png"/></td>
-        <td><img src="https://gitee.com/diego2098/ThingsGateway/raw/master/Image/6.png"/></td>
-    </tr>
-        <tr>
-        <td><img src="https://gitee.com/diego2098/ThingsGateway/raw/master/Image/7.png"/></td>
-        <td><img src="https://gitee.com/diego2098/ThingsGateway/raw/master/Image/8.png"/></td>
-        <td><img src="https://gitee.com/diego2098/ThingsGateway/raw/master/Image/9.png"/></td>
-    </tr>
- </table>
-
-
- ####  文档
-
- 使用前请查看Gitee Pages [文档站点](https://diego2098.gitee.io/thingsgateway/)
-
- #### 特别鸣谢
--  Furion：[https://dotnetchina.gitee.io/furion](https://dotnetchina.gitee.io/furion)
--  SqlSugar：[https://gitee.com/dotnetchina/SqlSugar](https://gitee.com/dotnetchina/SqlSugar)
--  Simple.Admin：[https://gitee.com/zxzyjs/SimpleAdmin](https://gitee.com/zxzyjs/SimpleAdmin)
--  Masa.Blazor：[https://www.masastack.com/blazor](https://www.masastack.com/blazor)
--  IdGenerator：[https://github.com/yitter/idgenerator](https://github.com/yitter/idgenerator)
--  CodingSeb.ExpressionEvaluator：[https://github.com/codingseb/ExpressionEvaluator](https://github.com/codingseb/ExpressionEvaluator)
--  TouchSocket：[https://gitee.com/rrqm_home/touchsocket](https://gitee.com/rrqm_home/touchsocket)
--  Hardware.Info：[https://github.com/Jinjinov/Hardware.Info](https://github.com/Jinjinov/Hardware.Info)
--  UAParser：[https://github.com/ua-parser/uap-csharp](https://github.com/ua-parser/uap-csharp)
-
-#### 补充说明
-* 使用OPC相关插件时请遵循OPC基金会的授权规则
-* 使用OPCDA插件时，需安装OPC核心库，[文件地址](https://gitee.com/diego2098/ThingsGateway/attach_files)
-
-#### 开源协议
-
-请仔细阅读 [授权协议](https://diego2098.gitee.io/thingsgateway/docs/)
-
-
-
-####  支持作者
- 如果对您有帮助，请点击右上角⭐Star关注，感谢支持开源！
-
- 若希望捐赠项目，请[点击](https://diego2098.gitee.io/thingsgateway/docs/03%E3%80%81%E6%94%AF%E6%8C%81%E9%A1%B9%E7%9B%AE%E4%B8%8EPro%E7%89%88%E8%AF%B4%E6%98%8E/%E6%94%AF%E6%8C%81%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/)查看捐赠码或使用Gitee捐赠功能
-
-
-####  联系作者
- * QQ群：605534569
- * 邮箱：2248356998@qq.com
-
+
+## Sponsorship
+
+[Sponsorship Approach](https://kimdiego2098.github.io/docs/1000)
+
+## Community
+
+QQ Group: 605534569 [Jump](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=NnBjPO-8kcNFzo_RzSbdICflb97u2O1i&authKey=V1MI3iJtpDMHc08myszP262kDykbx2Yev6ebE4Me0elTe0P0IFAmtU5l7Sy5w0jx&noverify=0&group_code=605534569)
+
+## Pro Plugins
+
+[Plugin List](https://kimdiego2098.github.io/docs/1001)

README.zh-CN.md

@@ -0,0 +1,73 @@
+
+# ThingsGateway
+
+## 介绍
+
+基于net8的跨平台高性能边缘采集网关，单机采集数据点位可达百万
+
+## 文档
+
+[文档](https://kimdiego2098.github.io/)
+
+[NuGet](https://www.nuget.org/packages?q=Tags%3A%22ThingsGateway%22)
+
+### 插件列表
+
+#### 采集插件
+| 插件名称 | 备注 | 
+|-------|-------|
+| Modbus | Rtu/Tcp报文格式，支持串口/Tcp/Udp链路 | 
+| SiemensS7 | 西门子PLC S7系列 | 
+| Dlt6452007 | 支持串口/Tcp/Udp链路 | 
+| OpcDaMaster | 64位编译 |
+| OpcUaMaster | 支持证书登录，扩展对象，Json读写 |
+
+#### 业务插件
+| 插件名称 | 备注 | 
+|-------|-------|
+| ModbusSlave | Rtu/Tcp报文格式，支持串口/Tcp/Udp链路，支持Rpc反写 | 
+| OpcUaServer | OpcUa服务端，支持Rpc反写 | 
+| MqttClient | Mqtt客户端，支持Rpc反写，脚本自定义上传内容 | 
+| MqttServer | Mqtt服务端，支持WebSocket，支持Rpc反写，脚本自定义上传内容 | 
+| KafkaProducer | 脚本自定义上传内容 | 
+| RabbitMQProducer  | 脚本自定义上传内容 | 
+| SqlDB | 关系数据库存储，支持历史存储和实时数据更新 | 
+| SqlHisAlarm | 报警历史数据关系数据库存储 | 
+| TDengineDB | 时序数据库存储 | 
+| QuestDB | 时序数据库存储 | 
+
+## 协议
+
+[Apache-2.0](https://gitee.com/diego2098/ThingsGateway/blob/master/LICENSE)
+
+## 演示
+
+[ThingsGateway演示地址](http://47.119.161.158:5000/)
+
+账户	:  **SuperAdmin**	
+
+密码 : **111111**
+
+**右上角个人弹出框中，切换到物联网关模块**
+
+## Docker 
+```shell
+
+docker pull registry.cn-shenzhen.aliyuncs.com/thingsgateway/thingsgateway
+
+```
+
+## 赞助
+
+[赞助途径](https://kimdiego2098.github.io/docs/1000)
+
+## 社区
+
+QQ群：605534569 [跳转](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=NnBjPO-8kcNFzo_RzSbdICflb97u2O1i&authKey=V1MI3iJtpDMHc08myszP262kDykbx2Yev6ebE4Me0elTe0P0IFAmtU5l7Sy5w0jx&noverify=0&group_code=605534569)
+
+## Pro插件
+
+[插件列表](https://kimdiego2098.github.io/docs/1001)
+
+
+

doc/docs/1.mdx

@@ -0,0 +1,57 @@
+---
+id: 1
+title: 版权说明
+---
+
+:::tip 公告
+
+注意以下常见版权问题：
+
+- 社区版本不得去除可视页面的ThingsGateway Logo
+- 不得将程序集单独包装售卖，申请专利，开发竞品
+
+:::  
+
+
+## 使用前必要阅读
+
+ThingsGateway 由作者Diego及其他贡献者开发，所有版权归作者Diego所有，程序集源代码在遵循 Apache License 2.0 的开源协议以及**附加协议**下，可**免费**供其他开发者二次开发或（商业）使用。
+
+
+### 个人使用须知:
+
+- 不得将程序集用作违法犯罪活动。
+- 不得将程序集单独包装售卖，申请专利等。
+- 不得擦除程序集所有有关作者的信息。
+
+**以上内容必须全部符合，个人使用授权才成立。**
+
+### 二次开发须知:
+
+- 不得将程序集用作违法犯罪活动。
+- 不得将程序集单独包装售卖，申请专利等。
+- 不得擦除程序集所有有关作者的信息。
+- 二次开发完成后的作品必须附带源作品所有作者信息，包括但不限于作者名、Gitee、Github 地址等。
+
+**以上内容必须全部符合，二次开发授权才成立。**
+
+### 盈利性（商业）用途使用须知:
+
+- 不得将程序集用作违法犯罪活动。
+- 不得将程序集单独包装售卖，申请专利等。
+- **不得擦除程序集所有有关作者的信息，并必须于用户可见界面（如关于）中提名。**
+
+**以上内容必须全部符合，商业使用授权才成立。**
+
+
+## ThingsGatewayPro 商用许可
+
+ ThingsGatewayPro 软件框架与 ThingsGateway 一致，另包含其他定制插件。所有版权归作者Diego所有。
+
+ ThingsGatewayPro 不公开开源。
+
+
+
+# 免责申明
+
+**在使用 ThingsGateway 之前请进行缜密的测试。在使用期间，由本程序集造成或间接造成的所有损失，均自己承担，与本程序集无关。**

doc/docs/100.mdx

@@ -0,0 +1,45 @@
+---
+id: 100
+title: 驱动调试
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `配置须知`
+
+变量地址的格式可从浮动提示中查看，如需要详细说明，可查看对应的插件章节
+
+:::
+## 一、说明
+
+**ThingsGateway** 网关程序中包含了调试页面，也单独提供跨平台的桌面端调试软件
+
+<img src={require("@site/static/img/docs/驱动调试.png").default} />
+
+下面举例说明Modbus驱动的调试流程
+
+## 二、Modbus调试流程
+
+选择需要的驱动，进入页面后，新建通道
+<img src={require("@site/static/img/docs/驱动调试1.png").default} />
+
+<img src={require("@site/static/img/docs/驱动调试2.png").default} />
+
+2、 查看变量寄存器地址的填写格式
+<img src={require("@site/static/img/docs/驱动调试3.png").default} />
+
+3、 打开模拟软件，点击读取
+
+<img src={require("@site/static/img/docs/驱动调试4.png").default} />
+
+可以看到交互的报文以及读取结果
+
+
+## 三、网关中的调试页面
+
+<img src={require("@site/static/img/docs/驱动调试5.png").default} />
+
+操作与桌面软件一样

doc/docs/1000.mdx

@@ -0,0 +1,28 @@
+---
+id: 1000
+title: 赞助项目
+---
+
+## 赞助ThingsGateway项目
+> 您的支持就是我不懈努力的动力。<br></br>如果对您有帮助，请⭐Star关注或扫码捐赠，感谢支持开源！
+
+### 赞助途径
+![](/img/pay.png)
+
+
+### 赞助名单（以下排名只按照赞助时间顺序）
+
+|序号|名称|金额|
+|-----------|--------------|-----------------|
+|1| 绢| 10￥|
+|2| 小蚂蚁 |500+￥|
+|3| *伟 |18.8￥|
+|4| *碟 |20￥|
+|5| *长 |6.66￥|
+|6| 小黄鸭 |38.8￥|
+|7| *交 |50￥|
+|8| *洋 |200￥+50￥|
+|9| *元 |20￥|
+|10| 冬日暖阳 |66.66￥|
+
+

doc/docs/10001.mdx

@@ -0,0 +1,9 @@
+---
+id: 10001
+title: ABCipMatser
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+

doc/docs/1001.mdx

@@ -0,0 +1,96 @@
+---
+id: 1001
+title: Pro版
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+:::tip 公告
+
+注意以下常见版权问题：
+
+- 社区版本不得去除可视页面的ThingsGateway Logo
+- ThingsGatewayPro授权后可去除Logo，但Pro插件不开放源代码
+- 任何版本不得将程序集单独包装售卖，申请专利，开发竞品
+:::  
+
+## 一、说明
+
+ThingsGatewayPro是ThingsGateway的加强版本，**基础功能与ThingsGateway一致，并添加一些额外功能插件**
+
+同时ThingsGatewayPro提供企业定制服务及必要的远程协助,具体收费可以咨询**作者Diego，联系方式：QQ：2248356998**
+
+## 二、授权
+
+** ThingsGatewayPro分为个人授权与企业授权，区别在于授权归属**
+
+ThingsGatewayPro授权不开放源代码，**Pro版本基础代码和开源版本相同**
+
+授权后获得证书凭据(图片形式)
+
+### 2.1 个人授权
+
+- **授权归属于购买者个人所有**
+- 价格 998￥
+
+### 2.2 企业授权
+
+- **授权归属于企业所有，仅企业主体享有授权**
+- 价格 1998￥
+
+
+## 三、插件差异
+
+|序号| 插件名称           |  说明      |            
+|----| ---------------| --------------------------|
+|1| Vigor | 丰炜串口/TCP通信插件，支持VS系列|
+|2| Fins Tcp/Udp | 欧姆龙Fins通信插件，支持CJ系列、CV系列、CS系列、NX系列等,一般欧姆龙带网口的都支持FINS|
+|3| ABCIP Tcp | 罗克韦尔CIP通信插件，支持1756，1769系列等|
+|4| SECS | SECS半导体协议|
+|5| 三菱MC QnA3E_Binary | MC 3E帧 二进制 |
+|6| USB扫码枪 | USB扫码枪(键盘输入式),键盘钩子获取的方式，目前只有windows版本|
+|7| URF_R330 读卡器  | dll，目前只有windows版本|
+|8| 精伦idr 210 读卡器 | dll，目前只有windows版本|
+|9| 明泰URF_R330 读卡器 | dll，目前只有windows版本|
+|10| 新中新DKQ-A16D 读卡器 | dll，目前只有windows版本|
+
+## 四、插件开发计划
+
+|序号| 插件名称           |  说明      |  
+|----| ---------------| --------------------------|
+|1| 双机热备 | 网关双机冗余| 
+|2| 远程更新 | 远程更新软件| 
+
+
+## 五、授权名单(部分企业用户不公示)
+
+|序号| 被授权主体           |  说明      |     时间           |       
+|----| ---------------| --------------------------|-------------------|
+|1| 成都**创新科技有限公司 | | 2023-4-21|
+|2| 超级士兵 | | 2023-5-18|
+|3| SunnyUI | | 2023-7-13|
+|4| 俞智峰 | | 2023-7-13|
+|5| 西安***物联网科技有限公司 | | 2023-7-15|
+|6| 深圳市***自动化技术有限公司 | | 2023-7-16|
+|7| 西安***信息技术有限责任公司 | | 2023-9-4|
+|8| 北京****网络科技发展有限公司 | | 2023-9-26|
+|9| 长沙**软件科技有限公司 | | 2023-10-16|
+|10| 航科**科技有限公司 | | 2023-10-30|
+|11| 福建**包装有限公司 | | 2023-11-17|
+|12| 内蒙古**科技有限公司 | | 2023-11-26|
+|13| 佛山**自动化科技有限公司 | | 2023-11-27|
+|14| Z | | 2023-12-03|
+|15| 狼有一心 | | 2023-05-29|
+
+## 六、购买途径
+
+**购买前请先联系作者Diego**。联系QQ：2248356998。
+
+![](/img/pay.png) 
+
+
+
+

doc/docs/1002.mdx

@@ -0,0 +1,24 @@
+---
+id: 1002
+title: 联系我们
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+**ThingsGateway团队**成立1年来一直致力于工业物联网关解决方案。我们的初衷是使设备接入更简单，为用户打造提高效率的产品。
+
+可以通过以下方式找到我们：
+
+### 技术支持
+
+QQ群：605534569
+
+QQ：2248356998
+
+### 咨询、合作
+
+手机：15622119120 林工
+
+微信：15622119120

doc/docs/101.mdx

@@ -0,0 +1,37 @@
+---
+id: 101
+title: 插件管理
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `配置须知`
+
+ 更改设备/变量/插件等，需要重启后台(右上角重启后台按钮)
+
+:::
+## 一、说明
+
+**ThingsGateway** 网关核心代码都由插件完成，主程序只负责调度执行
+
+插件支持热重载，可由外部上传到网关中
+
+## 二、上传插件
+
+
+<img src={require("@site/static/img/docs/上传插件.png").default} />
+
+## 二、手动重载插件
+
+<img src={require("@site/static/img/docs/重载插件.png").default} />
+
+可由顶部按钮或者插件管理页面按钮执行手动重载
+
+:::tip 提示
+
+插件重新检测文件后，运行态的插件不会发送任何改变，如果立即生效，请按右上角的重启后台按钮
+
+:::

doc/docs/102.mdx

@@ -0,0 +1,39 @@
+---
+id: 102
+title: 通道
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `配置须知`
+
+ 更改设备/变量/插件等，需要重启后台(右上角重启后台按钮)
+
+:::
+## 一、说明
+
+**ThingsGateway** 网关通道其实是一个实际的串口/TCP/UDP链路，或者是线程池中的一个任务
+
+## 二、添加通道/修改通道
+
+<img src={require("@site/static/img/docs/添加通道.png").default} />
+
+## 三、通道配置项
+|  属性| 说明 |
+| --- | --- |
+| 名称 | 通道名称|
+| 通道类型 | 选择 TcpClient/TcpService/SerialPortClient/UdpSession/Other |
+| 使能 | 是否启用此通道 |
+| 调试日志 | 初始运行时，是否启用调试日志，可在运行状态界面中再次启用/停用 |
+| 远程地址 | 对于TcpClient/UdpSession 作为客户端有效， 填入服务端的Url信息，比如192.168.0.1:502  |
+| 本地地址 | 对于TcpClient/TcpService/UdpSession 有效，作为本机的绑定地址，可选择填入，为空时是随机绑定端口 |
+| COM口 | 对于SerialPortClient有效，串口名称 |
+| 波特率 | 对于SerialPortClient有效，串口波特率 |
+| 数据位 | 对于SerialPortClient有效，串口数据位 |
+| 校验位 | 对于SerialPortClient有效，串口校验位 |
+| 停止位 | 对于SerialPortClient有效，串口停止位 |
+| 启用Dtr | 对于SerialPortClient有效，串口DtrEnable |
+| 启用Rts | 对于SerialPortClient有效，串口RtsEnable |

doc/docs/103.mdx

@@ -0,0 +1,46 @@
+---
+id: 103
+title: 设备
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `配置须知`
+
+ 更改设备/变量/插件等，需要重启后台(右上角重启后台按钮)
+
+:::
+
+## 一、说明
+
+**ThingsGateway** 网关设备对应每个实际采集设备/上传业务
+
+## 二、添加设备/修改设备
+
+<img src={require("@site/static/img/docs/添加设备.png").default} />
+
+## 三、设备属性配置项
+
+|  属性| 说明 |
+| --- | --- |
+|名称| 设备名称| 
+|描述| 当前设备描述 |
+|默认执行间隔| 执行间隔，对于采集设备，这个属性是默认的采集间隔，对于业务设备，这个属性是循环线程的等待间隔时间 |
+|设备使能| 启动/停用采集设备 |
+|通道| 选择对应的通道 |
+|插件| 选择对应的插件 |
+|是否冗余| 启动/停用设备冗余 |
+|冗余设备| 备用设备选择，当此设备离线时，会在适当的时间切换到备用设备，注意备用设备初始时不会有实际通讯线程创建，链接的变量也不会生效 |
+|备用字段| 存储自定义信息 |
+
+## 四、插件属性配置项
+
+对于不同的插件，插件属性项也不相同，查看对应插件章节中的详细说明。
+
+比如ModbusMaster
+
+<img src={require("@site/static/img/docs/插件属性.png").default} />
+

doc/docs/104.mdx

@@ -0,0 +1,124 @@
+---
+id: 104
+title: 变量
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `配置须知`
+
+ 更改设备/变量/插件等，需要重启后台(右上角重启后台按钮)
+
+:::
+
+## 一、说明
+
+**ThingsGateway** 网关变量对应每个寄存器点位
+
+## 二、添加变量/修改变量
+
+### 变量基础属性配置项
+
+<img src={require("@site/static/img/docs/添加变量.png").default} />
+
+|属性名称| 属性描述| 备注|
+|-----------|--------------|-----------------|
+|名称| 当前变量名称，全局唯一(变量)| |
+|描述| 当前变量描述 ||
+|单位| 变量值单位 ||
+|读写权限| 读写/只写/只读 ||
+|使能| 启用/停用变量 ||
+|远程写入| 对于变量的写入使能配置 ||
+|设备| 当前采集设备选择的设备，通过级联选择器选择对应设备名称设置 ||
+|变量地址| PLC寄存器/OPC ITEMID等 |对于不同插件的设备,变量地址配置不相同,查看对应的插件说明|
+|执行间隔| 读取时间间隔/执行特殊方法读取的间隔 ||
+|特殊方法| 某些插件特有的方法 |对于不同的插件,特殊方法配置不相同,查看对应的插件说明|
+|数据类型| 对应的数据类型 |注意除了特殊驱动，一般不应该选择object|
+|读取表达式| 动态解析的表达式 ,原始值的代码为raw|示例：``raw.ToInt()*10+3`` 结果：原始值raw为8,输出实时值83 。|
+|写入表达式| 动态解析的表达式，在写入值时转化,原始值的代码为raw|示例：``raw.ToInt()/10`` 结果：写入值为230时，会下发23到PLC 。|
+|备用字段| 存储自定义信息 |
+
+
+
+:::tip `变量地址通用说明`
+
+通用格式，不区分大小写
+
+4字节转换格式
+
+DATA=ABCD;
+
+举例：
+
+DATA=ABCD; ，代表大端格式，其中
+
+ABCD=>Big-Endian;
+
+BADC=>Big-Endian Byte Swap;
+
+CDAB=>Little-Endian Byte Swap;
+
+DCBA=>Little-Endian
+
+字符串长度：
+
+LEN=1;
+
+BCD格式：
+
+BCD=C8421;，其中有C8421;C5421;C2421;C3;Gray
+
+字符格式：
+
+encoding=UTF8;，其中有UTF8;ASCII;Default;Unicode
+
+数组长度：
+
+arraylen=2;
+
+:::
+
+
+### 报警属性配置项
+
+<img src={require("@site/static/img/docs/添加变量1.png").default} />
+
+:::tip `说明`
+
+报警属性中定义变量产生报警的规则所需的配置
+
+:::
+
+|属性名称| 属性描述| 备注|
+|-----------|--------------|-----------------|
+|报警使能| 启用对应报警功能| |
+|报警限值| 超限时产生报警，布尔量为固定 ||
+|报警文本| 对应显示的报警文本 ||
+|报警约束| 动态解析的表达式 ,原始值的代码为raw，计算值为true时才能产生报警 ||
+
+:::tip `例子`
+
+数值高高报警
+
+变量值大于报警限值，并且报警约束为true或者报警约束不存在时，产生报警
+
+比如设置高高限值为1，其他默认，当变量值大于1时，产生报警
+
+:::
+
+
+### 业务属性配置项
+<img src={require("@site/static/img/docs/添加变量2.png").default} />
+
+:::tip `说明`
+
+上传属性中定义变量关联的上传设备所需的配置
+
+对于不同的插件，插件属性项也不相同，查看对应插件章节中的详细说明。
+
+:::
+
+

doc/docs/105.mdx

@@ -0,0 +1,34 @@
+---
+id: 105
+title: 网关状态
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+## 一、说明
+
+**ThingsGateway** 
+
+运行状态页面，可查看采集/业务设备的运行状态，调试日志等信息
+
+实时数据页面，可查看变量实时信息
+
+实时报警页面，可查看变量实时报警
+
+硬件信息页面，可查看服务器CPU信息等
+
+## 二、图示
+
+<img src={require("@site/static/img/docs/运行状态详情.png").default} />
+
+<img src={require("@site/static/img/docs/实时数据详情.png").default} />
+
+<img src={require("@site/static/img/docs/实时报警详情.png").default} />
+
+<img src={require("@site/static/img/docs/硬件信息详情.png").default} />
+
+

doc/docs/106.mdx

@@ -0,0 +1,26 @@
+---
+id: 106
+title: 网关日志
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+## 一、说明
+
+**ThingsGateway** 
+
+后台日志记录 有关采集/业务上传的全部网关后台日志
+
+RPC日志记录 全部反写RPC日志
+
+## 二、图示
+
+<img src={require("@site/static/img/docs/RPC日志详情.png").default} />
+
+<img src={require("@site/static/img/docs/后台日志详情.png").default} />
+
+

doc/docs/2.mdx

@@ -0,0 +1,63 @@
+---
+id: 2
+title: 产品介绍
+---
+
+## 产品介绍
+
+**ThingsGateway** 是c#开发的一款边缘采集网关，核心分为四大部分
+
+### 通道
+
+通道，实际上相当于一个实际的通讯链路，比如一个串口，一个TCP连接等，在**ThingsGateway**中，
+通道也会作为线程池中的一个任务，对于同一个通道中的不同设备，采集/业务方法是顺序进行的。
+
+### 🔥插件
+
+ThingsGateway中的采集方法或者上传方法等都由插件完成，主程序只负责调度执行。
+对于不同的采集协议或者业务需求，可以通过开发插件完成自定义的业务操作。
+
+### 设备
+
+建立设备，必须指定通道以及插件，也可以说设备其实是插件的配置。
+同时对于采集设备、业务设备，会有些许差别。
+
+采集设备：采集数据入网关/写入数据到现场
+
+业务设备：上传数据到第三方/第三方RPC反写
+
+### 变量
+
+变量，用于配置采集设备的具体点位详情，以及对应业务设备中的配置项
+
+
+
+
+
+## 产品特性
+
+
+
+### 可视化操作
+
+通过web浏览器配置，调试，验证整个流程
+
+### 🔥脚本支持
+
+灵活的数据转换脚本以及数据上传自定义实体脚本，可适配各大云平台的物模型
+
+### 🔥自定义插件支持
+
+通过开发插件完成自定义的业务操作。
+
+### 🔥性能
+
+测试100w变量点位，500ms-1000ms全部采集完成，稳定连续采集占用CPU资源、内存资源低
+
+### 断线缓存
+
+支持断线缓存，恢复后自动上传
+
+### 🔥完整可商用的边缘网关
+
+完善的配置权限，操作日志功能等，还有OPC，Web Api,Mqtt,Kafka,时序库,变量报警等更多功能等待你发现

doc/docs/200.mdx

@@ -0,0 +1,78 @@
+---
+id: 200
+title: ModbusMatser
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+## 一、说明
+
+ModbusMatser作为主站，主动采集Modbus从站协议的设备
+
+插件支持modbusTcp/modbusRtu格式报文
+
+通讯链路支持 TcpClient/TcpService(DTU)/串口/Udp
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/ModbusMaster.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| Modbus协议类型         | modbusTcp/modbusRtu格式报文           | |
+| 默认站号         | 默认的mudbus站号id            | **变量可单独配置站号**   |
+| 无交互2min时断开连接         |  没有发送/收到消息 ，2分钟后断开连接             | 仅适用于TcpService链路（DTU模式）|
+| 心跳检测         |  大写16进制字符串，符合心跳内容会自动回应             | 仅适用于TcpService链路（DTU模式）|
+| 读写超时时间         | 读写超时时间                | 3000|
+| 连接超时时间         | 建立通讯链路的超时时间                | 3000|
+| 发送延时时间         | 在发送请求前的延时时间               | 0|
+| 组包缓存超时         | 返回分包时的分包间隔超时时间              | 1000 |
+| 默认解析顺序         | 4个字节以上的数据解析，可设置为ABCD/BADC/CDBA/DCBA,默认ABCD , **变量可单独配置**|ABCD：Big-Endian<br></br>BADC：Big-Endian Byte Swap<br></br>CDAB：Little-Endian Byte Swap<br></br>DCBA：Little-Endian |
+| 最大打包长度         | 打包长度，最大限值是125              | 100 |
+| 离线重试间隔         | 设备检测到离线时，重新连接的间隔时间（秒）              | 30 |
+| 失败重试次数         | 读取失败时，重试n次后判定变量为离线              | 3 |
+| 最大并发数量         | ModbusTcp格式报文特有，ModbusTcp可并发采集              | 1 |
+
+## 三、变量地址配置项
+
+- 1、基本地址
+
+Modbus PLC寄存器
+
+| 地址           | 功能码         |  说明                    |
+| ---------------| --------------|--------------------------|
+| 4xxxxx         | 03            | 读取03功能码              |
+| 3xxxxx         | 04            | 读取04功能码              |
+| 1xxxxx         | 02            | 读取02功能码              |
+| 0xxxxx         | 01            | 读取01功能码              |
+
+- 2、站号(可选)
+
+  当需要指定站号地址时可使用，举例：
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| s=2;10001         |  读取02功能码 ,设备地址为2      |
+| s=11;40001         |  读取03功能码 ,设备地址为11        |
+
+- 3、写入功能码(可选)
+
+  当需要指定16/15功能码时可使用，举例：
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| w=15;10001         |  读取02功能码 ,写入15功能码      |
+| w=16;40001         |  读取03功能码 ,写入16功能码        |
+
+- 3、Dtu注册(可选)
+
+  当需要指定Dtu客户端可使用，举例：
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| id=12;40001         |  读取03功能码 ,设备地址为默认，Dtu注册包为"12",注意是UTF8格式        |
+

doc/docs/20001.mdx

@@ -0,0 +1,96 @@
+---
+id: 20001
+title: Modbus
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+
+## 定义
+
+程序集：[ThingsGateway.Foundation.Modbus](https://www.nuget.org/packages/ThingsGateway.Foundation.Modbus)
+
+## 一、说明
+
+**ThingsGateway.Foundation.Modbus**是对于Modbus协议的封装类库
+
+支持Tcp/Rtu格式
+
+支持多个通讯链路：Tcp/Udp/SerialPort
+
+支持Dtu
+
+## 二、Modbus主站
+
+1、创建ModbusMaster
+
+```
+        /// <summary>
+        /// 新建链路
+        /// </summary>
+        /// <returns></returns>
+        public IChannel GetChannel()
+        {
+            TouchSocketConfig touchSocketConfig = new TouchSocketConfig();
+            return touchSocketConfig.GetSerialPortWithOption(new("COM1")); //直接获取串口对象
+            //return touchSocketConfig.GetChannel(ChannelTypeEnum.SerialPortClient, null, null, new("COM1"));//通过链路枚举获取对象
+        }
+
+        /// <summary>
+        /// 新建协议对象
+        /// </summary>
+        /// <param name="channel"></param>
+        /// <returns></returns>
+        public IProtocol GetProtocol(IChannel channel)
+        {
+            var client = new ModbusMaster(channel);
+            return client;
+        }
+```
+2、读写操作
+
+
+```
+            ModbusMaster modbusMasterTest = new ModbusMaster();
+            var channel = modbusMasterTest.GetChannel();
+            var protocol = modbusMasterTest.GetProtocol(channel);
+            var data = await protocol.ReadDoubleAsync("400001"); //读取保持寄存器地址0
+
+```
+
+`400001`是PLC Modbus的地址表示方式，代表保持寄存器地址0
+
+- 基本地址
+
+Modbus PLC寄存器
+
+| 地址           | 功能码         |  说明                    |
+| ---------------| --------------|--------------------------|
+| 4xxxxx         | 03            | 读取03功能码              |
+| 3xxxxx         | 04            | 读取04功能码              |
+| 1xxxxx         | 02            | 读取02功能码              |
+| 0xxxxx         | 01            | 读取01功能码              |
+
+- 站号(可选)
+
+  当需要指定站号地址时可使用，举例：
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| s=2;10001         |  读取02功能码 ,设备地址为2      |
+| s=11;40001         |  读取03功能码 ,设备地址为11        |
+
+- Dtu注册(可选)
+
+  当需要指定Dtu客户端可使用，举例：
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| id=12;40001         |  读取03功能码 ,设备地址为默认，Dtu注册包为"12",注意是UTF8格式        |
+
+
+## 三、Modbus从站
+

doc/docs/20002.mdx

@@ -0,0 +1,9 @@
+---
+id: 20002
+title: SiemensS7
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+

doc/docs/20003.mdx

@@ -0,0 +1,9 @@
+---
+id: 20003
+title: OpcDa
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+

doc/docs/20004.mdx

@@ -0,0 +1,9 @@
+---
+id: 20004
+title: OpcUa
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+

doc/docs/20005.mdx

@@ -0,0 +1,112 @@
+---
+id: 20005
+title: Dlt645
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+## 定义
+
+程序集：[ThingsGateway.Foundation.Dlt645](https://www.nuget.org/packages/ThingsGateway.Foundation.Dlt645)
+
+## 一、说明
+
+**ThingsGateway.Foundation.Dlt645**是对于Dlt645-2007协议的封装类库
+
+支持多个通讯链路：Tcp/Udp/SerialPort
+
+## 二、Dlt645-2007主站
+
+1、创建Dlt645Master
+
+```
+        /// <summary>
+        /// 新建链路
+        /// </summary>
+        /// <returns></returns>
+        public IChannel GetChannel()
+        {
+            TouchSocketConfig touchSocketConfig = new TouchSocketConfig();
+            return touchSocketConfig.GetSerialPortWithOption(new("COM1")); //直接获取串口对象
+            //return touchSocketConfig.GetChannel(ChannelTypeEnum.SerialPortClient, null, null, new("COM1"));//通过链路枚举获取对象
+        }
+
+        /// <summary>
+        /// 新建协议对象
+        /// </summary>
+        /// <param name="channel"></param>
+        /// <returns></returns>
+        public IProtocol GetProtocol(IChannel channel)
+        {
+            var client = new Dlt645_2007Master(channel);
+            client.Station = "311111111114";//表号
+            return client;
+        }
+```
+2、读写操作
+
+
+```
+            Dlt645MasterTest dlt645MasterTest = new Dlt645MasterTest();
+            var channel = dlt645MasterTest.GetChannel();
+            var protocol = dlt645MasterTest.GetProtocol(channel);
+            var data = await protocol.ReadDoubleAsync("02010100"); //读取A相电压
+
+```
+
+`02010100`是Dlt645中的地址表示方式，代表A相电压，请查看相关协议文档，可在源码附件中找到文档
+
+- 基本地址
+
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| 02010100        |  读取02010100(A相电压)      |
+
+参考DLT2007协议文档数据标识，可在插件源码中找到附件
+
+- 站号(可选)
+
+  当需要指定站号地址时可使用，举例：
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| s=111111111111;02010100        |  读取02010100 ,设备地址为111111111111      |
+
+- Dtu注册(可选)
+
+  当需要指定Dtu客户端可使用，举例：
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| id=12;40001         |  读取03功能码 ,设备地址为默认，Dtu注册包为"12",注意是UTF8格式        |
+
+
+3、其他方法
+
+修改密码
+
+```
+      var result = await protocol.WritePasswordAsync(level, oldPassword, newPassword);
+```
+
+更改表号
+
+```
+      var result = await protocol.WriteDeviceStationAsync(station);
+```
+
+修改波特率
+
+```
+      var result = await protocol.WriteBaudRateAsync(baudRate);
+```
+
+读取表号
+
+```
+      var result = await protocol.ReadDeviceStationAsync;
+```

doc/docs/201.mdx

@@ -0,0 +1,58 @@
+---
+id: 201
+title: ModbusSlave
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+## 一、说明
+
+ModbusSlave作为从站，响应主站的采集报文
+
+插件支持modbusTcp/modbusRtu格式报文
+
+通讯链路支持 TcpClient/TcpService(DTU)/串口/Udp
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/ModbusSlave.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| Modbus协议类型         | modbusTcp/modbusRtu格式报文           | |
+| 默认站号         | 默认的mudbus站号id            | **变量可单独配置站号**   |
+| 默认解析顺序         | 4个字节以上的数据解析，可设置为ABCD/BADC/CDBA/DCBA,默认ABCD , **变量可单独配置**|ABCD：Big-Endian<br></br>BADC：Big-Endian Byte Swap<br></br>CDAB：Little-Endian Byte Swap<br></br>DCBA：Little-Endian |
+| 无交互2min时断开连接         |  没有发送/收到消息 ，2分钟后断开连接             | 仅适用于TcpService链路|
+| 组包缓存超时         | 分包时的分包间隔超时时间              | 1000 |
+| 多站点         | 是否区分不同的站号的数据              | true|
+| 允许写入         | 写入权限使能              | Flase |
+| 立即写入内存         | 外部写入时，是否立即写入内存池              | Flase |
+
+## 三、变量业务属性
+
+### 1、从站地址
+
+- 1、基本地址
+
+Modbus PLC寄存器
+
+| 地址           | 功能码         |  说明                    |
+| ---------------| --------------|--------------------------|
+| 4xxxxx         | 03            | 读取03功能码              |
+| 3xxxxx         | 04            | 读取04功能码              |
+| 1xxxxx         | 02            | 读取02功能码              |
+| 0xxxxx         | 01            | 读取01功能码              |
+
+- 2、站号(可选)
+
+  当需要指定站号地址时可使用，举例：
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| s=2;10001         |  读取02功能码 ,设备地址为2      |
+| s=11;40001         |  读取03功能码 ,设备地址为11        |
+

doc/docs/202.mdx

@@ -0,0 +1,72 @@
+---
+id: 202
+title: Dlt645Master
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+## 一、说明
+
+Dlt645Master作为主站，主动采集Dlt645协议的设备
+
+插件支持Dlt645-2007格式报文
+
+通讯链路支持 TcpClient/TcpService(DTU)/串口/Udp
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/Dlt645Master.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| 无交互2min时断开连接         |  没有发送/收到消息 ，2分钟后断开连接             | 仅适用于TcpService链路（DTU模式）|
+| 心跳检测         |  大写16进制字符串，符合心跳内容会自动回应             | 仅适用于TcpService链路（DTU模式）|
+| 读写超时时间         | 读写超时时间                | 3000|
+| 连接超时时间         | 建立通讯链路的超时时间                | 3000|
+| 发送延时时间         | 在发送请求前的延时时间               | 0|
+| 组包缓存超时         | 返回分包时的分包间隔超时时间              | 1000 |
+| 默认解析顺序         | 4个字节以上的数据解析，可设置为ABCD/BADC/CDBA/DCBA,默认ABCD , **变量可单独配置**|ABCD：Big-Endian<br></br>BADC：Big-Endian Byte Swap<br></br>CDAB：Little-Endian Byte Swap<br></br>DCBA：Little-Endian |
+| 默认地址         | 电表地址，12个字符              |  |
+| 密码         | 协议写入所需密码              | Flase |
+| 操作员代码         | 协议写入所需操作员代码              | Flase |
+| 前导符报文头         | 设为true时，发送请求将添加4个0xFE到报文头部              | Flase |
+| 离线重试间隔         | 设备检测到离线时，重新连接的间隔时间（秒）              | 30 |
+| 失败重试次数         | 读取失败时，重试n次后判定变量为离线              | 3 |
+
+
+## 三、变量地址配置项
+
+- 1、基本地址
+
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| 02010100        |  读取02010100(A相电压)      |
+
+参考DLT2007协议文档数据标识，可在插件源码中找到附件
+
+- 2、站号(可选)
+
+  当需要指定站号地址时可使用，举例：
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| s=111111111111;02010100        |  读取02010100 ,设备地址为111111111111      |
+
+- 3、Dtu注册(可选)
+
+  当需要指定Dtu客户端可使用，举例：
+
+| 地址           |   说明                    |
+| ---------------| --------------------------|
+| id=12;02010100         |  读取02010100  ,设备地址为默认，Dtu注册包为"12",注意是UTF8格式        |
+
+
+:::tip `说明`
+
+ 注意DLT645协议中，所有的变量都支持String！
+
+:::
+

doc/docs/203.mdx

@@ -0,0 +1,51 @@
+---
+id: 203
+title: SiemensS7Master
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+## 一、说明
+
+SiemensS7Master作为主站，主动采集西门子S7协议的设备
+
+插件支持S7格式报文，支持S7-200;S7200-SMART;S7-300;S7-400;S7-1200;S7-1500;
+
+通讯链路支持 TcpClient/Udp(通常不存在)
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/SiemensS7Master.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| S7类型         | S200;S200SMART;S300;S400;S1200;S1500;           | |
+| 机架号         |   机架号            | 0|
+| 槽位号         |   槽位号            | 0|
+| LocalTSAP         |  查看西门子localTsap说明，网关中一般不需要再设置             | 0 |
+| 读写超时时间         | 读写超时时间                | 3000|
+| 连接超时时间         | 建立通讯链路的超时时间                | 3000|
+| 发送延时时间         | 在发送请求前的延时时间               | 0|
+| 组包缓存超时         | 返回分包时的分包间隔超时时间              | 1000 |
+| 默认解析顺序         | 4个字节以上的数据解析，可设置为ABCD/BADC/CDBA/DCBA,默认ABCD , **变量可单独配置**|ABCD：Big-Endian<br></br>BADC：Big-Endian Byte Swap<br></br>CDAB：Little-Endian Byte Swap<br></br>DCBA：Little-Endian |
+| 离线重试间隔         | 设备检测到离线时，重新连接的间隔时间（秒）              | 30 |
+| 失败重试次数         | 读取失败时，重试n次后判定变量为离线              | 3 |
+
+
+## 三、变量地址配置项
+
+- 1、基本地址
+
+| 地址           |           说明                    |
+| ---------------| --------------------------|
+| Txxxxx         |       Timer寄存器,例如T100/T100.1             |
+| Cxxxxx         |       Counter寄存器,例如C100/C100.1                 |
+| AIxxxxx         |       AI寄存器,例如AI100/AI100.1               |
+| AQxxxxx         |       AQ寄存器,例如AQ100/AQ100.1                |
+| Ixxxxx         |       I寄存器,例如I100/I100.1              |
+| Qxxxxx         |       Q寄存器,例如Q100/Q100.1              |
+| Mxxxxx         |       M寄存器,例如M100/M100.1               |
+| DBxxxxx         |       DB寄存器,例如DB100.1/DB100.1.1               |
+

doc/docs/204.mdx

@@ -0,0 +1,51 @@
+---
+id: 204
+title: OpcDaMaster
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `OPCDA驱动注意`
+
+ 使用OPCDA插件时，需安装[OPC核心库](https://gitee.com/diego2098/ThingsGateway/attach_files)
+
+:::
+
+:::tip `提示`
+
+可以通过调试页面，导出/导入OPC节点到网关
+
+:::
+
+## 一、说明
+
+OpcDaMaster作为主站，主动采集OPCDA协议的设备
+
+插件支持远程OPCDA，但需要配置DCOM，相关知识请自行查阅资料
+
+通道只支持 Other 类型
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/OpcDaMaster.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| IP         | 连接IP              | localhost|
+| Opc名称         | OPC名称，可识别ProgID或CLSID             | Kepware.KEPServerEX.V6|
+| 激活订阅         | 是否采用OPC订阅方式读取变量                | True|
+| 检查重连频率         | 每隔设定时间获取一次服务器状态，并尝试重新连接(min)  |10|
+| 死区         | OPC死区              | 0|
+| 最大组大小         | 每隔设定大小分一个OPCGroup              | 500|
+| 更新频率         | 订阅更新频率或者连读频率 (ms)             | 1000 |
+| 离线重试间隔         | 设备检测到离线时，重新连接的间隔时间（秒） ，只适用于非订阅模式             | 30 |
+| 失败重试次数         | 读取失败时，重试n次后判定变量为离线        ，只适用于非订阅模式       | 3 |
+
+
+## 三、变量地址配置项
+
+- 变量地址即为 OPC ItemID
+
+

doc/docs/205.mdx

@@ -0,0 +1,53 @@
+---
+id: 205
+title: OpcUaMaster
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `提示`
+
+可以通过调试页面，导出/导入OPC节点到网关
+
+:::
+
+## 一、说明
+
+插件支持OPCUA扩展类型，自定义类型等等，最终体现为json格式
+
+通道只支持 Other 类型
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/OpcUaMaster.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| OPCURL         | OPCUA URL            | opc.tcp://127.0.0.1:49320|
+| 登录账号         | 为空时采用匿名方式登录              |  |
+| 登录密码         |               |  |
+| 检查域         | 是否检查域               | Flase|
+| 安全策略         | 是否安全认证/证书方式登录                | True|
+| 使用SourceTime         | 是否采用服务端的变量时间                | True|
+| 加载服务端数据类型         | 是否加载服务端的数据类型，对应OPCUA自定义类型，必须为true                | True|
+| 激活订阅         | 是否采用OPC订阅方式读取变量                | True|
+| 更新频率         | 订阅更新频率或者连读频率              | 1000 |
+| 死区         | OPC死区              | 0|
+| 最大组大小         | 每隔设定大小分一个OPCGroup              | 500|
+| 心跳频率         |   |3000|
+| 离线重试间隔         | 设备检测到离线时，重新连接的间隔时间（秒） ，只适用于非订阅模式             | 30 |
+| 失败重试次数         | 读取失败时，重试n次后判定变量为离线        ，只适用于非订阅模式       | 3 |
+
+
+## 三、变量地址配置项
+
+- 变量地址即为 OPC NodeId
+
+## 四、证书说明
+
+证书可以在软件目录\OPCUAClientCertificate下查看或者导出/复制
+
+
+<img src={require("@site/static/img/docs/OpcUaMaster1.png").default} />

doc/docs/206.mdx

@@ -0,0 +1,24 @@
+---
+id: 206
+title: VariableExpression
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+## 一、说明
+
+VariableExpression不与工业设备交互，实际上是一个不依赖采集的表达式脚本计算方法
+如果不填写变量表达式，变量值会自增
+
+有关变量表达式的说明，请查看[变量表达式](./104.mdx#变量基础属性配置项) 
+
+## 二、插件属性配置项
+
+无
+
+## 三、变量地址配置项
+
+无
+

doc/docs/3.mdx

@@ -0,0 +1,134 @@
+---
+id: 3
+title: 入门指南
+slug: /
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+:::tip 提示
+
+如果你的开发机不是**Windows**系统，在解决方案中，可能存在一些vs生成事件脚本(目录拷贝等不支持)，会提示编译失败，请删除.csproj文件中的对应事件，手动拷贝插件类库
+
+:::
+
+
+## 一、说明
+
+**ThingsGateway** 基于NET6、8,默认开发IDE为VS2022(**17.8版本以上**),安装VS时需勾选ASP.NET类别.
+
+<img src={require("@site/static/img/docs/vs2022install.png").default} />
+
+## 二、下载源码
+
+[最新版本](https://gitee.com/diego2098/ThingsGateway) 
+
+## 三、编译运行
+
+下面我们将以vs2022作为示例：
+
+:::tip 提示
+
+**注意需要编译解决方案，因为插件与主体没有引用关系**
+
+:::  
+
+
+1、 vs2022打开解决方案，编译解决方案
+
+<img src={require("@site/static/img/docs/生成解决方案.png").default} />
+
+2、 设置ThingsGateway.Server为启动项目，开始调试或开始执行
+<img src={require("@site/static/img/docs/设置启动项目.png").default} />
+<img src={require("@site/static/img/docs/开始执行.png").default} />
+
+3、 启动后会显示登录界面
+
+<img src={require("@site/static/img/docs/login.png").default} />
+
+恭喜你体验了软件的启动第一步！
+
+:::tip 提示
+
+测试环境下，账密会自动填充为超级管理员账号，默认账户：**SuperAdmin**，密码：**111111**
+
+:::  
+
+
+## 四、建立一个完整的流程
+
+下面举例说明 采集ModbusTcp设备中的寄存器，通过MqttServer发布 的具体流程
+
+### 1、建立通道
+<img src={require("@site/static/img/docs/添加通道.png").default} />
+
+添加tcpClient通道
+<img src={require("@site/static/img/docs/通道配置1.png").default} />
+
+添加mqttClient通道，选择other即可
+<img src={require("@site/static/img/docs/通道配置2.png").default} />
+
+### 2、建立采集设备
+添加采集设备，选择tcpClient通道，modbusTcp驱动
+<img src={require("@site/static/img/docs/采集设备1.png").default} />
+<img src={require("@site/static/img/docs/采集设备2.png").default} />
+
+### 3、建立业务设备
+添加业务设备，选择mqttClient通道，mqttClient驱动，插件属性中填入第三方MqttBroker的连接信息
+<img src={require("@site/static/img/docs/业务设备1.png").default} />
+<img src={require("@site/static/img/docs/业务设备2.png").default} />
+
+### 4、建立变量
+
+添加变量，选择modbusTcp设备，填写变量寄存器地址
+<img src={require("@site/static/img/docs/变量1.png").default} />
+<img src={require("@site/static/img/docs/变量2.png").default} />
+
+
+### 5、验证
+
+经过以上的配置，已经可以从127.0.0.1:502的模拟Modbus设备中，采集到PLC地址(400001)，并通过网关的mqttClient插件发布到第三方mqttBroker
+。下面来验证一下
+
+首先先启动模拟的modbusSlave软件
+<img src={require("@site/static/img/docs/modbus模拟软件.png").default} />
+
+
+然后重启网关后台服务，注意并不是需要重新启动软件进程，
+而是**重新加载网关的组态配置到运行态中**，通过**网页右下角的重启运行时按钮**进行操作
+
+<img src={require("@site/static/img/docs/重启后台.png").default} />
+
+跳转到网关的运行状态查看
+
+<img src={require("@site/static/img/docs/运行状态.png").default} />
+
+开启调试日志的话，可以看到每次交互的modbus报文以及结果状态
+
+采集的数据点位值与相关信息跳转到实时数据页面
+
+<img src={require("@site/static/img/docs/实时数据.png").default} />
+
+可以看到值与采集时间等等的变化，注意这里的页面实时值变化是1s的间隔时间，如果配置了采集间隔小于1s，页面刷新不及时是正常的，不影响业务上传
+
+MqttClient的日志也可以在运行状态中看到
+<img src={require("@site/static/img/docs/运行状态1.png").default} />
+
+
+## 五、详细说明
+
+:::tip 提示
+
+在查看案例前，请先查看**关于网关的基础内容**
+
+:::  
+- [文档](https://diego2098.gitee.io/thingsgateway-docs) 
+
+- [博客](https://www.cnblogs.com/ThingsGateway/collections/1104) 
+
+- [视频](https://space.bilibili.com/88105259/channel/series) 
+

doc/docs/30001.mdx

@@ -0,0 +1,31 @@
+---
+id: 30001
+title: 串口
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+### 前言
+
+串口使用一个称为串行通信协议的协议来管理数据传输。串行通信协议在数据传输期间控制数据流，包括起始位、数据位、波特率、校验位和停止位等。    
+下面每个名称做一个简单的解释。   
+
+``波特率``是指串口通信中每秒传输的二进制位数
+``起始位``是1位时间、值为0的位。      
+``数据位``通常可能为1位、1.5位、2位时间。          
+``校验位``是1位时间，根据校验方式确定验证值，比如奇校验时，计算数据位中的值为1的个数，如果是奇数，则为1，否则应为0      
+``停止位``通常可能为1位、1.5位、2位时间。停止位是值为1的位。停止位代表着数据传输结束。     
+
+线路路空闲或者数据传输结束时，值总是1。   
+对于正逻辑的TTL电平，值为1是高电平，对于负逻辑(如RS-232电平)则相反。
+
+单看文字很难理解具体含义，所以我们看图说话，下面这张串口示波器图清晰的表现出二进制的传输原理
+
+<img src={require("@site/static/img/docs/串口1.png").default} />
+
+
+如上图，可以看出2进制是 起始``1``、数据(右到左)``01010101``、停止``0``  ，那么解析出来的数据就是``0x55``
+
+看到这里，相信大家都对串口知识有了一定的理解，这些基础知识对于c#工程师看似没有必要，但可以让你的实际调试开发工作更加得心应手

doc/docs/301.mdx

@@ -0,0 +1,287 @@
+---
+id: 301
+title: MqttClient
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `提示`
+
+通过自定义脚本，可快速适配业务模型，比如各大云平台的Iot物模型
+
+脚本的示例请查看**常见问题**
+
+:::
+
+## 一、说明
+
+MqttClient通过Tcp/WebSocket的方式，发布内容到Broker(Server)，可以定时/变化发布数据
+
+
+通道只支持 Other 
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/MqttClient.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| IP         | ServerIP,为空时指任意IP              | |
+| 端口         | 连接端口              | 1883|
+| 是否WebSocket连接         | 是否WebSocket连接             | False |
+| WebSocketUrl         | WebSocketUrl             | ws://127.0.0.1:8083/mqtt |
+| 账号         | 账号             |  |
+| 密码         | 密码              |  |
+| 连接Id         | 连接Id              |  |
+| 连接超时时间         | 连接超时时间              |  |
+| 允许Rpc写入         | 是否允许写入变量              |  |
+| Rpc写入Topic         | 写入变量的主题              | 实际的写入主题为固定通配 {RpcWrite/+} ，其中RpcWrite为该属性填入内容，+通配符是请求GUID值；返回结果主题会在主题后添加Response , 也就是{RpcWrite/+/Response} |
+| 数据请求Topic        | 该主题接受到任何消息都会发布全部信息到对应的变量/设备/报警主题中             |  |
+| 设备是否列表         | 设备是否列表上传，false时每个设备实体都会单独发布，注意性能需求，默认为true             |  |
+| 变量是否列表         | 变量是否列表上传，false时每个变量实体都会单独发布，注意性能需求，默认为true             |  |
+| 报警是否列表         | 报警是否列表上传，false时每个报警实体都会单独发布，注意性能需求，默认为true             |  |
+| 设备Topic         | 设备实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 变量Topic         | 变量实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 报警Topic         | 报警实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 设备实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**DeviceData**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题**  |
+| 变量实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**VariableData**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题** |
+| 报警实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**AlarmVariable**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题** |
+| 是否选择全部变量         | 是否选择全部变量，true时不需要单个变量添加业务属性            |  |
+| 是否间隔执行         | 是否选择全部变量，true间隔上传，False变化检测上传            |  |
+| 间隔执行时间         | 间隔执行时间           |  |
+| 启用缓存         | 是否启用缓存           |  |
+| 上传列表最大数量         | 每一次上传的列表最大数量           |  |
+| 内存队列最大数量         | 内存队列的最大数量，超出或失败时转入文件缓存，根据数据量设定适当值           |  |
+
+### 脚本接口
+```
+
+public interface IDynamicModel
+{
+    IEnumerable<dynamic> GetList(IEnumerable<dynamic> datas);
+}
+
+
+```
+
+### DeviceData
+```
+
+/// <summary>
+/// 设备业务变化数据
+/// </summary>
+public class DeviceData
+{
+    /// <inheritdoc cref="PrimaryIdEntity.Id"/>
+    public long Id { get; set; }
+
+    /// <inheritdoc cref="Device.Name"/>
+    public string Name { get; set; }
+
+    /// <inheritdoc cref="DeviceRunTime.ActiveTime"/>
+    public DateTime ActiveTime { get; set; }
+
+    /// <inheritdoc cref="DeviceRunTime.DeviceStatus"/>
+    public DeviceStatusEnum DeviceStatus { get; set; }
+
+    /// <inheritdoc cref="DeviceRunTime.LastErrorMessage"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string LastErrorMessage { get; set; }
+
+    /// <inheritdoc cref="Device.Remark1"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark1 { get; set; }
+
+    /// <inheritdoc cref="Device.Remark2"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark2 { get; set; }
+
+    /// <inheritdoc cref="Device.Remark3"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark3 { get; set; }
+
+    /// <inheritdoc cref="Device.Remark4"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark4 { get; set; }
+
+    /// <inheritdoc cref="Device.Remark5"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark5 { get; set; }
+}
+
+```
+
+### VariableData
+```
+
+/// <summary>
+/// 变量业务变化数据
+/// </summary>
+public class VariableData
+{
+    /// <inheritdoc cref="PrimaryIdEntity.Id"/>
+    public long Id { get; set; }
+
+    /// <inheritdoc cref="Variable.Name"/>
+    public string Name { get; set; }
+
+    /// <inheritdoc cref="VariableRunTime.DeviceName"/>
+    public string DeviceName { get; set; }
+
+    /// <inheritdoc cref="VariableRunTime.Value"/>
+    public object Value { get; set; }
+
+    /// <inheritdoc cref="VariableRunTime.ChangeTime"/>
+    public DateTime ChangeTime { get; set; }
+
+    /// <inheritdoc cref="VariableRunTime.CollectTime"/>
+    public DateTime CollectTime { get; set; }
+
+    /// <inheritdoc cref="VariableRunTime.IsOnline"/>
+    public bool IsOnline { get; set; }
+
+    /// <inheritdoc cref="VariableRunTime.LastErrorMessage"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string? LastErrorMessage { get; set; }
+
+    /// <inheritdoc cref="Device.Remark1"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark1 { get; set; }
+
+    /// <inheritdoc cref="Device.Remark2"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark2 { get; set; }
+
+    /// <inheritdoc cref="Device.Remark3"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark3 { get; set; }
+
+    /// <inheritdoc cref="Device.Remark4"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark4 { get; set; }
+
+    /// <inheritdoc cref="Device.Remark5"/>
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark5 { get; set; }
+}
+
+```
+
+### AlarmVariable
+```
+
+/// <summary>
+/// 报警变量
+/// </summary>
+public class AlarmVariable
+{
+    /// <inheritdoc  cref="Variable.Name"/>
+    [SugarColumn(ColumnDescription = "变量名称", IsNullable = false)]
+    public string Name { get; set; }
+
+    /// <inheritdoc  cref="Variable.Description"/>
+    [SugarColumn(ColumnDescription = "描述", IsNullable = true)]
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string? Description { get; set; }
+
+    /// <inheritdoc  cref="VariableRunTime.DeviceName"/>
+    [SugarColumn(ColumnDescription = "设备名称", IsNullable = true)]
+    public string DeviceName { get; set; }
+
+    /// <inheritdoc  cref="Variable.RegisterAddress"/>
+    [SugarColumn(ColumnDescription = "变量地址")]
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string RegisterAddress { get; set; }
+
+    /// <inheritdoc  cref="Variable.DataType"/>
+    [SugarColumn(ColumnDescription = "数据类型", ColumnDataType = "varchar(100)")]
+    public DataTypeEnum DataType { get; set; }
+
+    /// <inheritdoc  cref="VariableRunTime.AlarmCode"/>
+    [SugarColumn(ColumnDescription = "报警值", IsNullable = false)]
+    public string AlarmCode { get; set; }
+
+    /// <inheritdoc  cref="VariableRunTime.AlarmLimit"/>
+    [SugarColumn(ColumnDescription = "报警限值", IsNullable = false)]
+    public string AlarmLimit { get; set; }
+
+    /// <inheritdoc  cref="VariableRunTime.AlarmText"/>
+    [SugarColumn(ColumnDescription = "报警文本", IsNullable = true)]
+    public string? AlarmText { get; set; }
+
+    /// <inheritdoc  cref="VariableRunTime.AlarmTime"/>
+    [SugarColumn(ColumnDescription = "报警时间", IsNullable = false)]
+    public DateTime AlarmTime { get; set; }
+
+    /// <inheritdoc  cref="VariableRunTime.EventTime"/>
+    public DateTime EventTime { get; set; }
+
+    /// <summary>
+    /// 报警类型
+    /// </summary>
+    public AlarmTypeEnum? AlarmType { get; set; }
+
+    /// <summary>
+    /// 事件类型
+    /// </summary>
+    public EventTypeEnum EventType { get; set; }
+
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark1 { get; set; }
+
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark2 { get; set; }
+
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark3 { get; set; }
+
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark4 { get; set; }
+
+    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
+    public string Remark5 { get; set; }
+}
+
+```
+
+## 三、变量业务属性
+
+### 允许写入
+
+单独配置变量是否允许写入
+
+
+
+## 四、Rpc
+
+### 1、请求内容
+
+MqttRpc的请求内容与WebApi一致，请求参数为Dictionary<string, string>，比如
+
+```
+{
+
+  "D500":"1"
+
+}
+```
+
+键为变量名称，值为写入参数值
+
+### 2、请求主题
+
+请求主题在配置属性中设置，查看**Rpc写入Topic**
+
+注意，实际的请求主题为 `{ThingsGateway.Rpc/[自定义GUID或者雪花ID]/[Rpc写入Topic]}`
+
+
+### 3、Rpc返回主题
+
+`{ThingsGateway.Rpc/[自定义GUID或者雪花ID]/[Rpc写入Topic]/Response}`
+
+### 4、图示
+
+<img src={require("@site/static/img/docs/MqttRpc.png").default} />

doc/docs/302.mdx

@@ -0,0 +1,74 @@
+---
+id: 302
+title: MqttServer
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `提示`
+
+通过自定义脚本，可快速适配业务模型
+
+脚本的示例请查看**常见问题**
+
+:::
+
+:::tip `权限注意`
+
+Server的连接权限除了Id前缀限制外，账号密码同样要求，在网关后台创建的所有账号密码都可以登录MqttServer
+
+:::
+
+
+## 一、说明
+
+MqttServer支持Tcp/webSocket方式接入，可以定时/变化发布数据，支持Rpc写入
+
+
+通道只支持 Other 
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/MqttServer.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| IP         | ServerIP,为空时指任意IP              | |
+| 端口         | Tcp绑定端口              | 1883|
+| WebSocket端口         | WebSocket绑定端口             | 8083，固定/mqtt路由 |
+| 允许连接的ID(前缀)         | 允许连接的ID(前缀)             |ClientId必须以这个属性开头  |
+| 允许Rpc写入         | 是否允许写入变量              |  |
+| Rpc写入Topic         | 写入变量的主题              | 实际的写入主题为固定通配 {RpcWrite/+} ，其中RpcWrite为该属性填入内容，+通配符是请求GUID值；返回结果主题会在主题后添加Response , 也就是{RpcWrite/+/Response} |
+| 设备是否列表         | 设备是否列表上传，false时每个设备实体都会单独发布，注意性能需求，默认为true             |  |
+| 变量是否列表         | 变量是否列表上传，false时每个变量实体都会单独发布，注意性能需求，默认为true             |  |
+| 报警是否列表         | 报警是否列表上传，false时每个报警实体都会单独发布，注意性能需求，默认为true             |  |
+| 设备Topic         | 设备实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 变量Topic         | 变量实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 报警Topic         | 报警实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 设备实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**DeviceData**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题**  |
+| 变量实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**VariableData**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题** |
+| 报警实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**AlarmVariable**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题** |
+| 是否选择全部变量         | 是否选择全部变量，true时不需要单个变量添加业务属性            |  |
+| 是否间隔执行         | 是否选择全部变量，true间隔上传，False变化检测上传            |  |
+| 间隔执行时间         | 间隔执行时间           |  |
+| 启用缓存         | 是否启用缓存           |  |
+| 上传列表最大数量         | 每一次上传的列表最大数量           |  |
+| 内存队列最大数量         | 内存队列的最大数量，超出或失败时转入文件缓存，根据数据量设定适当值           |  |
+
+### 脚本与实体
+
+查看MqttClient页面[脚本接口](./301.mdx#脚本接口) 
+
+## 三、变量业务属性
+
+### 允许写入
+
+单独配置变量是否允许写入
+
+
+## 四、Rpc
+
+查看MqttClient页面[Rpc](./301.mdx#四rpc) 

doc/docs/303.mdx

@@ -0,0 +1,58 @@
+---
+id: 303
+title: RabbitMQProducer
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `提示`
+
+通过自定义脚本，可快速适配业务模型
+
+脚本的示例请查看**常见问题**
+
+:::
+
+## 一、说明
+
+RabbitMQProducer适配RabbitMQ协议，主动发布内容到服务端，可以定时/变化发布数据
+
+通道只支持 Other 
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/RabbitMQProducer.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| IP         | ServerIP,为空时指任意IP              | |
+| 端口         | 连接端口              | |
+| 账号         | 账号             |  |
+| 密码         | 密码              |  |
+| 是否声明队列         | 初始化时是否自动创建队列              |  |
+| 虚拟Host         | /              |  |
+| 交换机名称         | 交换机名称              |  |
+| 设备是否列表         | 设备是否列表上传，false时每个设备实体都会单独发布，注意性能需求，默认为true             |  |
+| 变量是否列表         | 变量是否列表上传，false时每个变量实体都会单独发布，注意性能需求，默认为true             |  |
+| 报警是否列表         | 报警是否列表上传，false时每个报警实体都会单独发布，注意性能需求，默认为true             |  |
+| 设备Topic         | 设备实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 变量Topic         | 变量实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 报警Topic         | 报警实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 设备实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**DeviceData**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题**  |
+| 变量实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**VariableData**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题** |
+| 报警实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**AlarmVariable**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题** |
+| 是否选择全部变量         | 是否选择全部变量，true时不需要单个变量添加业务属性            |  |
+| 是否间隔执行         | 是否选择全部变量，true间隔上传，False变化检测上传            |  |
+| 间隔执行时间         | 间隔执行时间           |  |
+| 启用缓存         | 是否启用缓存           |  |
+| 上传列表最大数量         | 每一次上传的列表最大数量           |  |
+| 内存队列最大数量         | 内存队列的最大数量，超出或失败时转入文件缓存，根据数据量设定适当值           |  |
+
+### 脚本与实体
+
+查看MqttClient页面[脚本接口](./301.mdx#脚本接口) 
+
+

doc/docs/304.mdx

@@ -0,0 +1,77 @@
+---
+id: 304
+title: KafkaProducer
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::tip `提示`
+
+通过自定义脚本，可快速适配业务模型
+
+脚本的示例请查看**常见问题**
+
+:::
+
+:::tip `须知`
+
+插件使用**librdkafka**,注意按需安装c库
+
+On Mac OSX, install librdkafka with homebrew:
+```
+$ brew install librdkafka
+```
+On Debian and Ubuntu, install librdkafka from the Confluent APT repositories, see instructions here and then install librdkafka:
+```
+$ apt install librdkafka-dev
+
+```
+On RedHat, CentOS, Fedora, install librdkafka from the Confluent YUM repositories, instructions here and then install librdkafka:
+```
+$ yum install librdkafka-devel
+```
+For other platforms, follow the source building instructions below.
+:::
+
+## 一、说明
+
+KafkaProducer适配Kafka协议，主动发布内容到服务端，可以定时/变化发布数据
+
+通道只支持 Other 
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/KafkaProducer.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| 服务地址         | 服务地址              | 127.0.0.1:9092|
+| 发布超时时间         | 发布超时时间             |5000  |
+| 用户名         | 用户名             |  |
+| 密码         | 密码              |  |
+| SecurityProtocol         | SecurityProtocol              |  |
+| SaslMechanism         | SaslMechanism              |  |
+| 设备是否列表         | 设备是否列表上传，false时每个设备实体都会单独发布，注意性能需求，默认为true             |  |
+| 变量是否列表         | 变量是否列表上传，false时每个变量实体都会单独发布，注意性能需求，默认为true             |  |
+| 报警是否列表         | 报警是否列表上传，false时每个报警实体都会单独发布，注意性能需求，默认为true             |  |
+| 设备Topic         | 设备实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 变量Topic         | 变量实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 报警Topic         | 报警实体的发布主题 ，使用${key}作为匹配项，key必须是上传实体中的属性            |  |
+| 设备实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**DeviceData**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题**  |
+| 变量实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**VariableData**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题** |
+| 报警实体脚本         | 脚本返回新的实体列表，动态类中需继承**IDynamicModel**，传入列表为**AlarmVariable**,查看以下具体属性            | 编辑页面中，可通过检查按钮验证脚本，脚本示例请查看**常见问题** |
+| 是否选择全部变量         | 是否选择全部变量，true时不需要单个变量添加业务属性            |  |
+| 是否间隔执行         | 是否选择全部变量，true间隔上传，False变化检测上传            |  |
+| 间隔执行时间         | 间隔执行时间           |  |
+| 启用缓存         | 是否启用缓存           |  |
+| 上传列表最大数量         | 每一次上传的列表最大数量           |  |
+| 内存队列最大数量         | 内存队列的最大数量，超出或失败时转入文件缓存，根据数据量设定适当值           |  |
+
+### 脚本与实体
+
+查看MqttClient页面[脚本接口](./301.mdx#脚本接口) 
+
+

doc/docs/305.mdx

@@ -0,0 +1,34 @@
+---
+id: 305
+title: TDengineDBProducer
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+ 
+ 
+## 一、说明
+
+TDengineDBProducer适配TDengineDB时序数据库，可以定时/变化存储变量数据
+
+通道只支持 Other 
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/TDengineDBProducer.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| 链接字符串         | 链接字符串              | Host=localhost;Port=6030;Username=root;Password=taosdata;Database=test|
+| 是否选择全部变量         | 是否选择全部变量，true时不需要单个变量添加业务属性            |  |
+| 是否间隔执行         | 是否选择全部变量，true间隔上传，False变化检测上传            |  |
+| 间隔执行时间         | 间隔执行时间           |  |
+| 启用缓存         | 是否启用缓存           |  |
+| 上传列表最大数量         | 每一次上传的列表最大数量           |  |
+| 内存队列最大数量         | 内存队列的最大数量，超出或失败时转入文件缓存，根据数据量设定适当值           |  |
+
+
+

doc/docs/306.mdx

@@ -0,0 +1,34 @@
+---
+id: 306
+title: QuestDBProducer
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+ 
+ 
+## 一、说明
+
+QuestDBProducer适配QuestDB时序数据库，可以定时/变化存储变量数据
+
+通道只支持 Other 
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/QuestDBProducer.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| 链接字符串         | 链接字符串              | host=localhost;port=8812;username=admin;password=quest;database=qdb;ServerCompatibilityMode=NoTypeLoading;|
+| 是否选择全部变量         | 是否选择全部变量，true时不需要单个变量添加业务属性            |  |
+| 是否间隔执行         | 是否选择全部变量，true间隔上传，False变化检测上传            |  |
+| 间隔执行时间         | 间隔执行时间           |  |
+| 启用缓存         | 是否启用缓存           |  |
+| 上传列表最大数量         | 每一次上传的列表最大数量           |  |
+| 内存队列最大数量         | 内存队列的最大数量，超出或失败时转入文件缓存，根据数据量设定适当值           |  |
+
+
+

doc/docs/307.mdx

@@ -0,0 +1,38 @@
+---
+id: 307
+title: SqlDBProducer
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+ 
+ 
+## 一、说明
+
+SqlDBProducer适配关系数据库，可以定时/变化存储变量数据，也可以实时更新数据到实时表
+
+通道只支持 Other 
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/SqlDBProducer.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| 是否实时表         | 开启实时更新数据功能              | |
+| 是否历史表         | 开始历史存储功能              |true |
+| 实时表名称         | 实时表名称              | |
+| 数据库类型         | 数据库类型              | |
+| 链接字符串         | 链接字符串              | server=.;uid=sa;pwd=111111;database=test;|
+| 是否选择全部变量         | 是否选择全部变量，true时不需要单个变量添加业务属性            |  |
+| 是否间隔执行         | 是否选择全部变量，true间隔上传，False变化检测上传            |  |
+| 间隔执行时间         | 间隔执行时间           |  |
+| 启用缓存         | 是否启用缓存           |  |
+| 上传列表最大数量         | 每一次上传的列表最大数量           |  |
+| 内存队列最大数量         | 内存队列的最大数量，超出或失败时转入文件缓存，根据数据量设定适当值           |  |
+
+
+

doc/docs/308.mdx

@@ -0,0 +1,32 @@
+---
+id: 308
+title: SqlHisAlarm
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+ 
+ 
+## 一、说明
+
+SqlHisAlarm适配关系数据库，可以变化存储变量报警数据
+
+通道只支持 Other 
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/SqlHisAlarm.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| 数据库类型         | 数据库类型              | |
+| 链接字符串         | 链接字符串              | server=.;uid=sa;pwd=111111;database=test;|
+| 启用缓存         | 是否启用缓存           |  |
+| 上传列表最大数量         | 每一次上传的列表最大数量           |  |
+| 内存队列最大数量         | 内存队列的最大数量，超出或失败时转入文件缓存，根据数据量设定适当值           |  |
+
+
+

doc/docs/309.mdx

@@ -0,0 +1,53 @@
+---
+id: 309
+title: OpcUaServer
+---
+
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+ 
+:::tip `权限注意`
+
+如果开启安全策略，在网关后台创建的所有账号密码都可以登录OpcUaServer
+
+如果不开启安全策略，则可以匿名登录
+
+:::
+
+## 一、说明
+
+OpcUaServer支持外部OpcUa客户端读写
+
+通道只支持 Other 
+
+## 二、插件属性配置项
+
+<img src={require("@site/static/img/docs/OpcUaServer.png").default} />
+
+| 属性           |  说明                    | 备注|
+| ---------------| --------------------------| ---|
+| 是否选择全部变量         | 是否选择全部变量，true时不需要单个变量添加业务属性            |  |
+| 服务地址         | Url ,以分号分割，可设置多个          | opc.tcp://127.0.0.1:49321 |
+| SubjectName         | 证书内容           |  |
+| 安全策略         | 启用后将不接受使用匿名登录的客户端，并且可以写入变量 | |
+| 自动接受不受信任的证书         | 自动获取客户端证书并接受              | True |
+
+
+
+## 三、变量业务属性
+
+### 数据类型
+
+同变量管理数据类型Enum
+
+## 四、证书说明
+
+证书可以在软件目录\OPCUAServerCertificate下查看或者导出/复制
+
+
+<img src={require("@site/static/img/docs/OpcUaServer1.png").default} />
+
+

doc/docs/400.mdx

@@ -0,0 +1,31 @@
+---
+id: 400
+title: 发布
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+## 一、编译解决方案
+
+<img src={require("@site/static/img/docs/发布.png").default} />
+
+选择Release , 点击解决方案全编译(或者编译plugin文件夹)
+
+## 二、发布版本
+
+<img src={require("@site/static/img/docs/发布1.png").default} />
+
+按需选择发布版本(图中为linux-64 net6)
+
+## 三、复制插件文件夹
+
+:::tip `提示`
+
+如果你的开发机是**Windows**系统，这一步不再需求进行，发布时通过脚本已经自动复制到发布文件夹
+
+:::
+
+<img src={require("@site/static/img/docs/发布2.png").default} />
+

doc/docs/401.mdx

@@ -0,0 +1,37 @@
+---
+id: 401
+title: Windows部署
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+:::tip `提示`
+
+ 如果需要Runtime依赖部署，需要安装ASP.NET Core Runtime，如果是独立发布部署，则不需要安装Runtime
+
+ 下载链接:https://dotnet.microsoft.com/zh-cn/download/dotnet
+
+:::
+
+
+
+
+ 
+
+
+遵循windows service服务安装/启动/停止方式 https://docs.microsoft.com/zh-cn/windows-server/administration/windows-commands/sc-create 
+
+提供懒人bat脚本文件，管理员身份运行**WindowsServiceCreate.bat**
+
+
+<img src={require("@site/static/img/docs/Windows服务.png").default} />
+
+运行脚本后可以在windows服务中找到**ThingsGateway**
+
+<img src={require("@site/static/img/docs/Windows服务1.png").default} />
+
+如需删除服务，运行**WindowsServiceDelete.bat**
+

doc/docs/402.mdx

@@ -0,0 +1,195 @@
+---
+id: 402
+title: IIS部署
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::caution 注意
+
+1、必须启用IIS WebSocket协议
+
+2、禁用IIS回收
+:::
+
+
+:::tip `提示`
+
+ 如果需要Runtime依赖部署，需要安装ASP.NET Core Runtime，如果是独立发布部署，则不需要安装Runtime
+
+ 下载链接:https://dotnet.microsoft.com/zh-cn/download/dotnet
+
+:::
+
+
+:::tip 精简发布文件
+
+如果需要精简发布后的文件，也就是删除不必要的文件夹，可以编辑 Web 项目的 `.csproj` 并添加 `<SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>`，如：
+
+```cs showLineNumbers  {3}
+<PropertyGroup>
+  <TargetFramework>net6.0</TargetFramework>
+  <SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>
+</PropertyGroup>
+```
+
+若无需生成 `.pdb` 文件，可以继续添加：
+
+```cs showLineNumbers {2-3}
+<PropertyGroup>
+  <DebugType>none</DebugType>
+  <DebugSymbols>false</DebugSymbols>
+</PropertyGroup>
+```
+
+:::
+
+
+## 服务器环境配置
+
+### 第一步
+
+安装.NET Core 运行时捆绑包：[点击下载](https://dotnet.microsoft.com/permalink/dotnetcore-current-windows-runtime-bundle-installer)
+
+### 第二步（命令）
+
+```bash showLineNumbers
+net stop was /y
+```
+
+### 第三步（命令）
+
+```bash showLineNumbers
+net start w3svc
+```
+
+### 第四步（命令）
+
+```bash showLineNumbers
+set ASPNETCORE_ENVIRONMENT=Production
+```
+
+## 部署到 IIS
+
+### 添加新网站
+
+<img src={require("@site/static/img/furion/ds1.png").default} />
+
+### 配置网站信息
+
+<img src={require("@site/static/img/furion/ds2.png").default} />
+
+### 34.1.3.3 配置应用程序池
+
+<img src={require("@site/static/img/furion/ds3.png").default} />
+
+### 34.1.3.4 设置为 `非托管`
+
+<img src={require("@site/static/img/furion/ds4.png").default} />
+
+### 34.1.3.5 重启网站
+
+只需重启网站或应用程序池即可。
+
+## 34.1.4 常见问题
+
+### 34.1.4.1 405 状态码，不支持 `PUT，DELETE` 请求
+
+默认情况下，`IIS`拒绝 `PUT`和 `DELETE` 请求，原因为 `IIS` 默认注册了一个名为 `WebDAVModule` 的自定义 `HttpModule` 导致的。
+
+解决该问题，只需要在 `web.config` 移除即可：
+
+```xml {2-6}
+<configuration>
+ <system.webServer>
+   <modules runAllManagedModulesForAllRequests="true">
+     <remove name="webDAVModule"/>
+   </modules>
+ </system.webServer>
+</configuration>
+```
+
+微软官方文档：[https://docs.microsoft.com/zh-cn/troubleshoot/developer/webapps/iis/health-diagnostic-performance/http-error-405-website](https://docs.microsoft.com/zh-cn/troubleshoot/developer/webapps/iis/health-diagnostic-performance/http-error-405-website)
+
+<img src={require("@site/static/img/furion/iis5.png").default} />
+
+### 34.1.4.2 `WebSocket`/ `SignalR` 连接报错
+
+如果项目部署在 `IIS` 中出现 `WebSoket`/`SignalR` 不能连接或连接失败等问题，请确保 `IIS` 服务中的 `WebSocket 协议` 是勾选状态
+
+<img src={require("@site/static/img/furion/iis2.png").default} />
+
+### 34.1.4.3 部署之后缺失 `api-ms-win.xxxx.dll` 问题
+
+有时候将发布文件发布到服务器后，出现丢失 `api.ms-win.xxxx.dll` 文件，这时只需要重新发布并选择服务器特定的架构即可。
+
+<img src={require("@site/static/img/furion/iis4.jpg").default} />
+
+<img src={require("@site/static/img/furion/iis3.png").default} />
+
+## 34.1.5 `IIS` 回收问题和配置
+
+通过 `IIS` 部署 `.NET Core` 应用程序，如果启动了系统日志，就会发现经常出现 `Application is shutting down...` 的日志，代表 `IIS` 回收了应用程序池。
+
+对于一个长期在线的网站来说，这是非常不合理的，所以我们可以通过以下配置让 `IIS` 进行长时间不访问便回收的机制。
+
+---
+
+配置步骤如下：
+
+1. 打开 `IIS` 并点击左侧树根节点（计算机名称）并点击右侧的 `Configuration Editor`（配置编辑器）
+
+<img src={require("@site/static/img/furion/iis6.png").default} />
+
+2. 在 `Section`（节）选择 `system.applicationHost/applicationPools` 并设置 `startMode` 为 `AlwaysRunning`，之后点击 `Apply` 保存。
+
+<img src={require("@site/static/img/furion/iis7.png").default} />
+
+3. 点击左侧树根节点（计算机名称）下的 `Application Pools` 并点击最右侧的 `Set Appliation Pool Defaults...`（设置应用程序池默认配置...）
+
+<img src={require("@site/static/img/furion/iis8.png").default} />
+
+4. 设置 `Idle Time-out (minutes)`（闲置超时（分钟）为 `0`
+
+<img src={require("@site/static/img/furion/iis9.png").default} />
+
+这样即可解决 `IIS` 回收问题。
+
+## 34.1.6 卷影（无占用）复制发布替换
+
+正常情况下如果我们代码重新发布后替换 `IIS` 中的文件，这时候会出现文件占用无法进行替换，过去运维人员都是先停止站点后替换再启动。但我们也可以配置 `web.config` 文件启用卷影复制模式实现类似**热更新**操作，如：
+
+```xml showLineNumbers {12-18}
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <!-- To customize the asp.net core module uncomment and edit the following section.
+  For more info see https://go.microsoft.com/fwlink/?linkid=838655 -->
+
+  <system.webServer>
+    <handlers>
+      <remove name="aspNetCore"/>
+      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModulev2" resourceType="Unspecified"/>
+    </handlers>
+    <aspNetCore processPath="%LAUNCHER_PATH%" arguments="%LAUNCHER_ARGS%" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout">
+      <handlerSettings>
+        <handlerSetting name="experimentalEnableShadowCopy" value="true" />
+        <handlerSetting name="shadowCopyDirectory" value="../ShadowCopyDirectory/" />
+        <!-- Only enable handler logging if you encounter issues-->
+        <!--<handlerSetting name="debugFile" value=".\logs\aspnetcore-debug.log" />-->
+        <!--<handlerSetting name="debugLevel" value="FILE,TRACE" />-->
+      </handlerSettings>
+    </aspNetCore>
+  </system.webServer>
+</configuration>
+```
+
+关于卷影复制更多知识可查看以下文档：
+
+- [https://devblogs.microsoft.com/dotnet/asp-net-core-updates-in-net-6-preview-3/#shadow-copying-in-iis](https://devblogs.microsoft.com/dotnet/asp-net-core-updates-in-net-6-preview-3/#shadow-copying-in-iis)
+- [https://learn.microsoft.com/zh-cn/dotnet/framework/app-domains/shadow-copy-assemblies](https://learn.microsoft.com/zh-cn/dotnet/framework/app-domains/shadow-copy-assemblies)
+
+
+
+

doc/docs/403.mdx

@@ -0,0 +1,122 @@
+---
+id: 403
+title: Docker部署
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+:::important 特别注意
+
+验证码使用SkiaSharp，如果是在 linux 服务下运行则需要安装 libfontconfig1，如 ubuntu 的安装命令
+```
+apt-get update
+apt-get -y install libfontconfig1
+```
+如果是采用 docker 模式运行，则需要在 dockerfile 中添加如下配置，该命令适用于 debian 和 ubuntu 的 docker
+```
+RUN apt-get update && apt-get -y install libfontconfig1
+```
+:::
+
+:::tip `提示`
+
+ 如果需要Runtime依赖部署，需要安装ASP.NET Core Runtime，如果是独立发布部署，则不需要安装Runtime
+
+ 下载链接:https://dotnet.microsoft.com/zh-cn/download/dotnet
+
+:::
+
+
+:::tip 精简发布文件
+
+如果需要精简发布后的文件，也就是删除不必要的文件夹，可以编辑 Web 项目的 `.csproj` 并添加 `<SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>`，如：
+
+```cs showLineNumbers  {3}
+<PropertyGroup>
+  <TargetFramework>net6.0</TargetFramework>
+  <SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>
+</PropertyGroup>
+```
+
+若无需生成 `.pdb` 文件，可以继续添加：
+
+```cs showLineNumbers {2-3}
+<PropertyGroup>
+  <DebugType>none</DebugType>
+  <DebugSymbols>false</DebugSymbols>
+</PropertyGroup>
+```
+
+:::
+
+
+## 34.2.1 关于 `Docker` 部署
+
+在 `Docker` 中部署网站有两种方式：
+
+- `发布后构建`：此方式是先发布网站后在再构建镜像，这样可以减少不必要的构建层，而且还能缩减镜像大小。**（推荐）**
+- `编译+构建+发布`：也就是说在 `Dockerfile` 中配置网站从构建到发布的完整过程，此方式会速度慢，而且会产生冗余层，增加镜像大小。
+
+## 34.2.2 两种方式构建
+
+### 34.2.2.1 发布后构建
+
+
+- 👉 编写 `Dockerfile`
+
+```
+FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
+COPY .  /app
+WORKDIR /app
+EXPOSE 80
+#linux安装
+RUN echo "deb https://mirrors.tuna.tsinghua.edu.cn/debian/ sid main contrib non-free" > /etc/apt/sources.list
+RUN apt-get update && apt-get -y install libfontconfig1
+ENTRYPOINT ["dotnet", "ThingsGateway.Web.Server.dll","--urls","http://*:7200"]
+
+```
+
+
+
+- 👉 将 `Dockerfile` 文件拷贝到发布根目录
+
+将编写好的 `Dockerfile` 文件（注意 `D` 大写）拷贝到发布网站的根目录下。
+
+:::tip `提示`
+
+git仓库中已经包含 `Dockerfile` 文件
+
+:::
+
+- 👉 构建 `Docker` 镜像
+
+在网站发布后的路径根目录下（必须含 `Dockerfile`）打开 `CMD/PowerShell` 只需构建命令：
+
+```bash showLineNumbers
+docker build -t 网站名称:网站版本号 .
+```
+
+:::important 特别注意
+
+后端的 `.` 不能省略
+
+:::
+
+- 👉 启动镜像
+
+```bash showLineNumbers
+docker run --name 容器名称 -p 5000:80 --restart=always -d 网站名称:网站版本号
+```
+
+:::caution `.NET8` 中 `80` 端口问题
+
+在使用 `.NET8`，默认的端口由原来的 `80` 端口变成了 `8080`。[查看相关说明](https://learn.microsoft.com/zh-cn/dotnet/core/compatibility/containers/8.0/aspnet-port)
+
+:::
+
+
+- 👉 在 `Dockerfile` 所在路径构建
+
+接下来的步骤和上述步骤一致，不再重复编写。

doc/docs/404.mdx

@@ -0,0 +1,55 @@
+---
+id: 404
+title: Linux服务部署
+---
+
+:::important 特别注意
+
+验证码使用SkiaSharp，如果是在 linux 服务下运行则需要安装 libfontconfig1，如 ubuntu 的安装命令
+```
+apt-get update
+apt-get -y install libfontconfig1
+```
+如果是采用 docker 模式运行，则需要在 dockerfile 中添加如下配置，该命令适用于 debian 和 ubuntu 的 docker
+```
+RUN apt-get update && apt-get -y install libfontconfig1
+```
+:::
+
+### （一）PM2守护 
+
+详细安装请自行查找资料
+
+查阅详细官方文档 https://pm2.keymetrics.io/docs/usage/quick-start/
+
+下面介绍一下常用指令
+
+- 安装pm2
+
+```
+npm install pm2@latest -g
+```
+
+- 启用应用程序
+
+```
+pm2 start pm2-linux.json
+```
+
+- 停止应用程序
+
+```
+pm2 stop pm2-linux.json
+```
+
+- 自动启动
+
+```
+pm2-startup
+pm2 save
+```
+
+### （二）linux服务
+
+自行查询相关资料 **NetCore/Linux/Systemd**
+

doc/docs/501.mdx

@@ -0,0 +1,47 @@
+---
+id: 501
+title: 常见问题
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+#### 1、Modbus地址可以只写地址0吗，一定要写成类似400001?
+
+按照PLC Modbus寄存器的格式，以区域号为起始字符，后续加上（寄存器地址+1）  
+所以一定要写成400001
+
+#### 2、数据如何设置小数位
+
+网关提供灵活的脚本式配置转换，可以在变量的读取表达式中进行配置转换 
+如果要设置小数位为2，可以填入 
+```
+Math.Round(raw.ToDecimal(), 2)
+```
+
+#### 3、源码打开razor文件时，不出现智能提示，有waring警告(波浪线)
+
+VS的bug导致的，可以尝试升级vs，把工程目录下的.vs文件夹已经全部的bin OR obj 删除后，重新打开解决方案
+
+#### 4、报警属性中的报警约束如何定义
+
+报警约束和变量表达式类似，填入脚本，返回值为true时，报警生效
+
+
+  ```csharp
+  
+  //新建testInt1,testInt2两个变量
+
+  //在testInt1的高高报警值为1，开启使能
+  //在testInt1的高高报警约束中定义testInt2>10
+
+
+  //testInt1为8,testInt2为11时，产生testInt1报警
+  //testInt1为8,testInt2为10时，不会产生testInt1报警
+  ```
+
+#### 5、启动项目之后，驱动调试页面没有任何信息，设备选择插件时也不出现任何选择项
+
+网关插件未编译，需要编译解决方案，查看入门指南；或者插件未能成功拷贝到插件目录(Plugins)

doc/docs/502.mdx

@@ -0,0 +1,118 @@
+---
+id: 502
+title: 脚本常见问题
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+## 一、脚本示例
+
+```
+
+//变量脚本动态设置传输实体的Demo
+//只传输变量名称，变量值，变量在线状态，变量值改变时间
+    public class DemoScript:IDynamicModel
+    {
+        public IEnumerable<dynamic> GetList(IEnumerable<object> datas)
+        {
+            List<DemoData> demoDatas = new List<DemoData>();
+            foreach (var v in datas)
+            {
+                var data=(VariableData)v;
+                DemoData demoData = new DemoData();
+                demoData.Value = data.Value;
+                demoData.Name = data.Name;
+                demoData.IsOnline = data.IsOnline;
+                demoData.ChangeTime = data.ChangeTime;
+                demoDatas.Add(demoData);
+            }
+            return demoDatas;
+        }
+    }
+    public class DemoData
+    {
+        public string Name { get; set; }
+        public bool IsOnline { get; set; }
+        public object Value { get; set; }
+        public DateTime ChangeTime { get; set; }
+    }
+
+```
+
+
+## 二、适配阿里云物模型脚本
+
+
+对应文档：[阿里云设备属性上报](https://help.aliyun.com/zh/iot/user-guide/data-formats?spm=a2c4g.11186623.0.i17#section-jrb-lrl-b2b)
+
+
+
+### 变量脚本
+```
+
+//一个适配阿里云IOT的变量脚本demo
+
+
+public class AliYunIotScript:IDynamicModel
+{
+   public IEnumerable<dynamic> GetList(IEnumerable<object> datas)
+    {
+        List<AliYunIot> aliYunIots = new();
+        // 对输入列表进行分组，根据 Remark1属性分组
+        var groups = datas.Where(a => !string.IsNullOrEmpty(((VariableData)a).Remark1)).GroupBy(a => ((VariableData)a).Remark1,a=> ((VariableData)a));
+        // 遍历每一个分组
+        foreach (var item in groups)
+        {
+            var requestId = Yitter.IdGenerator.YitIdHelper.NextId();
+            var iotId = item.Key; //Remark1自定义为设备Id
+            var productKey = item.FirstOrDefault(a => !string.IsNullOrEmpty(a.Remark2))?.Remark2;//Remark2自定义为产品Id
+            var deviceName = item.FirstOrDefault(a => !string.IsNullOrEmpty(a.Remark3))?.Remark3;//Remark3自定义为设备名称
+            AliYunIot aliYunIot = new();
+            aliYunIot.iotId = iotId;
+            aliYunIot.requestId = requestId.ToString();
+            aliYunIot.deviceName = deviceName;
+            aliYunIot.productKey = productKey;
+            // 遍历分组内的每一个元素
+            foreach (var varItem in item)
+            {
+
+                    // 设置采集时间，并转换为 Unix 时间戳
+                    // 设置值
+                    var data = new Property() { value = varItem.Value, time = new DateTimeOffset(varItem.CollectTime).ToUnixTimeSeconds() };
+                    // 以 变量名称 作为键，将新对象添加到分组的 属性 中
+                    aliYunIot.items.Add(varItem.Name, data);
+ 
+            }
+            aliYunIots.Add(aliYunIot);
+        }
+        return aliYunIots;
+    }
+
+   
+}
+ public class AliYunIot
+    {
+        public string iotId { get; set; }
+        public string requestId { get; set; }
+        public string productKey { get; set; }
+        public string deviceName { get; set; }
+        public Dictionary<string, Property> items { get; set; } = new();
+    }
+
+    public class Property
+    {
+        public object value { get; set; }
+        public long time { get; set; }
+    }
+
+
+
+```
+
+
+### 传输主题
+
+变量Topic 填入 `/${productKey}/${deviceName}/thing/event/property/post`

doc/docs/601.mdx

@@ -0,0 +1,38 @@
+---
+id: 601
+title: 采集插件开发
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+## 说明
+
+ThingsGateway封装了丰富的协议解析方法，方便开发多种PLC通讯插件  
+下面我们以Omron FinsTcp/Udp为例，讲解如何基于ThingsGateway开发一个**通用驱动**以及ThingsGateway插件
+
+## 一、协议解析
+
+ `Fins` 协议是OSI模型第7层上的应用层报文传输协议，我们画一个简单的应用层协议报文解析图
+
+| Fins over TCP           |   Fins over UDP                      |
+| ---------------| --------------------------|
+|  FinsTCP Header |  None      |
+|  FinsUDP Header    |  FinsUDP Header  |  
+|  Command Data    |Command Data    |  
+
+
+可以看出，基于Tcp的Fins和基于Udp的Fins协议，差别只是Tcp连接时会加一个FinsTcp报文头。    
+下面我们进行每个部分的说明
+
+
+### 1、FinsTCP Header
+
+FinsTcp头部固定为16个字节
+
+| FinsTCP Header           |   说明                      |
+| ---------------| --------------------------|
+|  Magic  |  固定0x46494E53，也就是FINS字符串的ASCII码      |
+|  Length     |  后续全部字节的长度  |  
+|  Command     | 0是客户端请求握手，1是服务端返回握手信息，除0,1外是其他方法   |  

doc/docs/602.mdx

@@ -0,0 +1,9 @@
+---
+id: 602
+title: 业务插件开发
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+

doc/docs/upgrade.mdx

@@ -0,0 +1,80 @@
+---
+id: upgrade
+title: 更新日志
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+import Tag from "@site/src/components/Tag.js";
+import Highlight from '@site/src/components/Highlight.js';
+
+
+
+
+## v5.0.0.1
+> 2024-1-21
+
+**更新描述：**
+
+此版本是大版本更新。可能会产生很多不兼容部分，所以升级之前请做好备份。
+
+如果需要从5.0前升级，请按以下操作进行
+
+1、导出旧版本的excel配置文件，包括采集设备、上传设备、变量等
+
+2、5.0框架中，只建立一个对应插件的设备/变量，这一步是因为插件是按需导出的，需要建立对应插件，才会导出相应的sheet，建好后导出excel
+
+3、参照5.0版本的excel内容，把旧版本的配置内容移到新版本excel文件中
+
+4、导入已修改好的5.0版本excel配置文件
+
+**更新详情：**
+
+- &nbsp;<Tag>调整</Tag> 重构采集驱动底层，网关缓存
+- &nbsp;<Tag>调整</Tag> 重构网关权限管理框架
+- &nbsp;<Tag>调整</Tag> 重构网关线程管理器
+- &nbsp;<Tag>调整</Tag> 重构网关断线续传功能
+- &nbsp;<Tag>调整</Tag> 重构脚本支持，方便对应各大云平台的iot格式
+- &nbsp;<Tag>调整</Tag> 调整网关UI外观风格
+
+
+
+## v3.0.0.25
+
+- &nbsp;<Tag>调整</Tag> 删除S7插件中的DstTSAP属性,用插槽号与机架号代替，更直观
+- &nbsp;<Tag>调整</Tag> OPCUAServer插件 url属性支持多个url，以逗号分割
+
+## v3.0.0.19
+
+- &nbsp;<Tag>新增</Tag> 添加TDengineDB时序库上传插件
+- &nbsp;<Tag>新增</Tag> 添加QuestDB时序库上传插件
+- &nbsp;<Tag>新增</Tag> 添加DLT645采集插件
+- &nbsp;<Tag>新增</Tag> 添加调试软件
+
+
+## v1.7.0
+
+- &nbsp;<Tag>优化</Tag> OPCUAClient支持动态类型
+
+
+## v1.2.0
+
+  - &nbsp;<Tag>新增</Tag> 添加OPCUAServer插件
+
+##
+
+## v1.1.0
+
+  - &nbsp;<Tag>新增</Tag> 添加OPCDAClient采集插件
+
+  - &nbsp;<Tag>新增</Tag> 添加OPCUAClient采集插件
+
+  - &nbsp;<Tag>新增</Tag> 串口基础框架
+
+##
+
+## v1.0.0
+
+  - &nbsp;<Tag>新增</Tag> 初始发布
+
+
+##

doc/docusaurus.config.js

@@ -0,0 +1,165 @@
+
+module.exports = {
+    title: "thingsgateway",
+    tagline: "物联网",
+    url: "https://kimdiego2098.github.io",
+    baseUrl: "/",
+  onBrokenLinks: "throw",
+  onBrokenMarkdownLinks: "throw",
+  favicon: "img/favicon.ico",
+  projectName: "ThingsGateway",
+  scripts: [],
+  themeConfig: {
+    zoom: {
+      selector:
+        ".markdown :not(em) > img,.markdown > img, article img[loading]",
+      background: {
+        light: "rgb(255, 255, 255)",
+        dark: "rgb(50, 50, 50)",
+      },
+      // options you can specify via https://github.com/francoischalifour/medium-zoom#usage
+      config: {},
+    },
+    docs: {
+      sidebar: {
+        hideable: true,
+        autoCollapseCategories: true,
+      },
+    },
+    prism: {
+      additionalLanguages: ["powershell", "csharp", "sql"],
+    },
+    navbar: {
+        title: "ThingsGateway",
+        logo: {
+            alt: "ThingsGateway Logo",
+            src: "img/ThingsGatewayLogo.png",
+      },
+      hideOnScroll: true,
+      items: [
+        {
+          label: "更新日志",
+          position: "left",
+          to: "docs/upgrade"
+        },
+        {
+          label: "演示",
+          position: "right",
+          href: "http://47.119.161.158:5000",
+        },
+        {
+          label: "源码",
+          position: "right",
+          items: [
+            {
+              label: "Gitee（主库）",
+              href: "https://gitee.com/diego2098/ThingsGateway",
+            },
+            {
+              label: "GitHub",
+              href: "https://github.com/kimdiego2098/ThingsGateway",
+            },
+            {
+              label: "Nuget",
+              href: "https://www.nuget.org/profiles/kimdiego",
+            },
+          ],
+        },
+        // {
+        //   label: "博客",
+        //   position: "right",
+        //   href: "https://www.cnblogs.com/ThingsGateway/collections/1104",
+        // },
+        {
+          label: "视频",
+          position: "right",
+          href: "https://space.bilibili.com/88105259/channel/series",
+        },
+        {
+          label: "社区",
+          position: "right",
+          href: "https://gitee.com/dotnetchina",
+        },
+      ],
+    },
+    footer: {
+      style: "dark",
+      links: [
+        {
+          title: "文档",
+          items: [
+            {
+              label: "入门",
+              to: "docs",
+            },
+            {
+              label: "手册",
+              to: "docs",
+            },
+          ],
+        },
+        {
+          title: "社区",
+          items: [
+            {
+              label: "讨论",
+              href: "https://gitee.com/diego2098/ThingsGateway/issues",
+            },
+            {
+              label: "看板",
+              href: "https://gitee.com/diego2098/ThingsGateway/board",
+            },
+          ],
+        },
+        {
+          title: "更多",
+          items: [
+            {
+              label: "仓库",
+              href: "https://gitee.com/diego2098/ThingsGateway",
+            },
+          ],
+        },
+      ],
+      copyright: `Copyright © 2020-${new Date().getFullYear()} Diego.`,
+    },
+  },
+  presets: [
+    [
+      "@docusaurus/preset-classic",
+      {
+        docs: {
+          sidebarPath: require.resolve("./sidebars.js"),
+          editUrl:
+            "https://gitee.com/diego2098/ThingsGateway/tree/master/doc/",
+          showLastUpdateTime: true,
+          showLastUpdateAuthor: true,
+          sidebarCollapsible: true,
+          sidebarCollapsed: true,
+          
+          // sidebarCollapsible: true,
+        },
+        // blog: {
+        //   showReadingTime: true,
+        //   editUrl:
+        //     "https://gitee.com/diego2098/ThingsGateway/tree/master/doc/",
+        // },
+        theme: {
+          customCss: require.resolve("./src/css/custom.css"),
+        },
+      },
+    ],
+  ],
+  plugins: [require.resolve("docusaurus-plugin-image-zoom")],
+  themes: [
+    [
+      "@easyops-cn/docusaurus-search-local",
+      {
+        hashed: true,
+        language: ["zh","en"],
+        highlightSearchTermsOnTargetPage: true,
+        explicitSearchResultPath: true,
+      },
+    ],
+  ],
+};

doc/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thingsgateway",
-  "version": "^1.2.0",
+  "version": "v6.0",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -14,8 +14,8 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
-    "@docusaurus/core": "^2.2.0",
-    "@docusaurus/preset-classic": "^2.2.0",
+    "@docusaurus/core": "^2.4.3",
+    "@docusaurus/preset-classic": "^2.4.3",
     "@easyops-cn/docusaurus-search-local": "^0.33.5",
     "@mdx-js/react": "^1.6.22",
     "@svgr/webpack": "^6.5.1",
@@ -41,7 +41,7 @@
     ]
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "^2.2.0",
+    "@docusaurus/module-type-aliases": "^2.4.3",
     "react-iconfont-cli": "^2.0.2"
   },
   "engines": {

doc/sidebars.js

@@ -0,0 +1,315 @@
+module.exports = {
+  docs: [
+    {
+      type: "doc",
+      id: "upgrade",
+      label: "更新日志"
+    },
+    {
+      type: "doc",
+      id: "1",
+      label: "版权说明"
+    },
+    {
+      type: "doc",
+      id: "2",
+      label: "产品介绍"
+    },
+
+    {
+      type: "doc",
+      id: "3",
+      label: "入门指南"
+    },
+    {
+      type: "doc",
+      id: "100",
+      label: "驱动调试"
+    },
+    {
+      type: "category",
+      label: "基础手册",
+      items: [
+        {
+          type: "category",
+          label: "网关配置",
+          items: [
+
+            {
+              type: "doc",
+              id: "101",
+              label: "插件管理"
+            },
+            {
+              type: "doc",
+              id: "102",
+              label: "通道管理"
+            },
+            {
+              type: "doc",
+              id: "103",
+              label: "设备"
+            },
+            {
+              type: "doc",
+              id: "104",
+              label: "变量"
+            },
+          ]
+        },
+        {
+          type: "doc",
+          id: "105",
+          label: "网关状态查看"
+        },
+        {
+          type: "doc",
+          id: "106",
+          label: "网关日志"
+        },
+      ]
+    },
+
+    {
+      type: "category",
+      label: "采集插件手册",
+      items: [
+        {
+          type: "doc",
+          id: "200",
+          label: "ModbusMaster"
+        },
+
+        {
+          type: "doc",
+          id: "202",
+          label: "Dlt645Master"
+        },
+
+        {
+          type: "doc",
+          id: "203",
+          label: "SiemensS7Master"
+        },
+
+        {
+          type: "doc",
+          id: "204",
+          label: "OpcDaMaster"
+        },
+
+        {
+          type: "doc",
+          id: "205",
+          label: "OpcUaMaster"
+        },
+
+        {
+          type: "doc",
+          id: "206",
+          label: "VariableExpression"
+        }
+
+      ]
+    },
+    {
+      type: "category",
+      label: "业务插件手册",
+      items: [
+        {
+          type: "doc",
+          id: "201",
+          label: "ModbusSlave"
+        },
+        {
+          type: "doc",
+          id: "301",
+          label: "MqttClient"
+        },
+        {
+          type: "doc",
+          id: "302",
+          label: "MqttServer"
+        },
+        {
+          type: "doc",
+          id: "303",
+          label: "RabbitMQProducer"
+        },
+        {
+          type: "doc",
+          id: "304",
+          label: "KafkaProducer"
+        },
+        {
+          type: "doc",
+          id: "305",
+          label: "TDengineDBProducer"
+        },
+        {
+          type: "doc",
+          id: "306",
+          label: "QuestDBProducer"
+        },
+        {
+          type: "doc",
+          id: "307",
+          label: "SqlDBProducer"
+        },
+
+        {
+          type: "doc",
+          id: "308",
+          label: "SqlHisAlarm"
+        },
+        {
+          type: "doc",
+          id: "309",
+          label: "OpcUaServer"
+        },
+      ]
+    },
+    {
+      type: "category",
+      label: "Pro插件手册",
+      items: [
+        {
+          type: "doc",
+          id: "10001",
+          label: "ABCipMatser"
+        },
+      ]
+    },
+    {
+      type: "category",
+      label: "部署",
+      items: [
+        {
+          type: "doc",
+          id: "400",
+          label: "编译发布"
+        },
+        {
+          type: "doc",
+          id: "401",
+          label: "windows服务部署"
+        },
+        {
+          type: "doc",
+          id: "402",
+          label: "iis部署"
+        },
+        {
+          type: "doc",
+          id: "403",
+          label: "docker部署"
+        },
+        {
+          type: "doc",
+          id: "404",
+          label: "linux服务部署"
+        }
+      ]
+    },
+    {
+      type: "category",
+      label: "常见问题",
+      items: [
+        {
+          type: "doc",
+          id: "501",
+          label: "常见问题"
+        },
+        {
+          type: "doc",
+          id: "502",
+          label: "脚本常见问题"
+        },
+      ]
+    },
+    {
+      type: "category",
+      label: "插件开发",
+      items: [
+        {
+          type: "doc",
+          id: "601",
+          label: "采集插件"
+        },
+        {
+          type: "doc",
+          id: "602",
+          label: "业务插件"
+        },
+      ]
+    },
+    {
+      type: "category",
+      label: "nuget包文档",
+      items: [
+        {
+          type: "doc",
+          id: "20001",
+          label: "Modbus"
+        },
+        {
+          type: "doc",
+          id: "20002",
+          label: "SiemensS7"
+        },
+        {
+          type: "doc",
+          id: "20003",
+          label: "OpcDa"
+        },
+        {
+          type: "doc",
+          id: "20004",
+          label: "OpcUa"
+        },
+        {
+          type: "doc",
+          id: "20005",
+          label: "Dlt645"
+        },
+      ]
+    },
+
+    {
+      type: "category",
+      label: "协议开发教程",
+      items: [
+        {
+          type: "doc",
+          label: "基础知识",
+          id: "30001",
+
+        }
+      ]
+    },
+
+    {
+      type: "category",
+      label: "技术支持/合作",
+      items: [
+        {
+          type: "doc",
+          id: "1002",
+          label: "联系我们"
+        },
+        {
+          type: "doc",
+          id: "1000",
+          label: "赞助项目"
+        },
+        {
+          type: "doc",
+          id: "1001",
+          label: "Pro版"
+        },
+      ]
+    },
+
+  ]
+};
+

doc/src/components/Highlight.js

@@ -0,0 +1,15 @@
+import React from 'react';
+
+export default function Highlight({children, color}) {
+  return (
+    <span
+      style={{
+        backgroundColor: color,
+        borderRadius: '2px',
+        color: '#fff',
+        padding: '0.2rem',
+      }}>
+      {children}
+    </span>
+  );
+}

doc/src/components/Tag.js

@@ -5,10 +5,6 @@ import classes from "./Tag.module.css";
 export default function (props) {
   const { children } = props;
   const operates = {
-    最新版: {
-      icon: "xinzeng",
-      bgColor: "#39b54a",
-    },
     新增: {
       icon: "xinzeng",
       bgColor: "#39b54a",
@@ -35,7 +31,7 @@ export default function (props) {
     },
     移除: {
       icon: "shanchu",
-      bgColor: "#666",
+      bgColor: "red",
     },
     答疑: {
       icon: "dayi",
@@ -45,6 +41,16 @@ export default function (props) {
       icon: "youhua",
       bgColor: "#38e550",
     },
+
+    推荐: {
+      bgColor: "#38e550",
+    },
+    DEMO: {
+      bgColor: "#38e550",
+    },
+    Pro版: {
+      bgColor: "#23AAF2",
+    }
   };
   return (
     <label