135 lines
4.2 KiB
Plaintext
135 lines
4.2 KiB
Plaintext
---
|
||
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)
|
||
|