添加一台设备
认识采集配置页的层级树,新建分组,用「添加设备」对话框或设备模板把一台 PLC 加入采集,下发后启停采集。
视频教程 · 灵犀·Studio 从入门到精通 · 第 3 集 6:14
接入第一台 PLC:Modbus TCP 实战
你将完成
读完本篇你将完成:
- 在采集配置页里新建一个分组;
- 用「添加设备」对话框添加一台设备,填好协议与通讯参数;
- 把改动下发到采集网关服务,并在树里看到这台设备;
- 按需启用 / 停用这台设备的采集。
开始之前
- 已安装并能登录灵犀·Studio(参见安装与部署);
- 知道目标设备用什么协议、IP 地址和端口。
先认识采集配置页#
打开菜单 采集系统 → 采集配置。页面分左右两栏:
- 左栏是「采集层级」树,从左到右分四级:分组 → 设备 → 测点组(点表)→ 点位。顶部一排按钮:导入设备 JSON、导出全部 JSON、套用模板、添加设备。
- 右栏是设备总览:设备列表、通信状态筛选,以及每台设备的名称、类型、地址、采集开关与通信健康度。
四级各管什么
分组只负责组织结构,可以多级嵌套;设备保存协议与 IP、端口等通讯参数;测点组决定一组点位的采样间隔,可整组启停;点位是最小单位,一个地址加一个数据类型对应一个实时值。点位的配置见配置采集点位。
新建一个分组#
在树上找到放设备的位置#
分组可以按车间、产线来建。右键已有分组(如「示例设备」),菜单里选 新增子分类;也可以右键树的空白处,选 新增顶级分类。
输入分组名称#
在弹出的输入框里填写分类名称,如「一车间」。确认后提示「分类已创建」。
空分组不会出现在「所属分组」下拉里
「添加设备」对话框的所属分组下拉只列出已有设备的分组路径。要让新设备放进刚建的空分组,请右键这个分组,选 在该分类下添加设备,分组会被自动带进对话框。
添加设备#
打开对话框#
点击树顶部的 添加设备 按钮。对话框默认选中「常规 Modbus-TCP 客户端」,这是最常用的协议。
- 1点击换协议
- 2填写名称
- 3选择分组
- 4点击添加
选择设备协议#
点击顶部的协议卡片打开选择设备协议弹窗:左列选设备大类(PLC 等设备 / 机器人 / CNC 数控 / 特殊设备 / 插件设备),中列选厂商品牌,右列选具体协议。也可以在顶部搜索框直接搜「Modbus」「西门子」或 DeviceType 名称。
- 1选大类
- 2选品牌
- 3选协议
- 4搜索框:直接搜协议名、厂商或 DeviceType
选中后点 确认选择 回到表单。协议一旦保存就不能改——它决定了整棵点位子树的寄存器体系,要换协议只能删除重建。
填写基础属性#
| 字段 | 说明 | 默认值 |
|---|---|---|
| 设备名称 | 必填,树与列表里显示的名字 | 空 |
| 所属分组 | 必填,选择或新建分组路径 | 空 |
| 固定编号 | 可选,便于巡检时核对设备 | 空 |
| 采集开关 | 已启用(创建即采集)/ 已停用 / 停止并隐藏 | 已启用 |
| 请求间隙 (ms) | 两次通讯之间的间隔,0–30000 | 50 |
| 描述 | 可选备注 | 空 |
填写通讯参数#
以太网类协议(Modbus TCP、S7、MC 等)填这些:
| 字段 | 说明 | 默认值 |
|---|---|---|
| IP 地址 | 必填,设备的 IP | 空 |
| 端口 | 必填,协议默认端口会自动带入 | 按协议 |
| 冗余 IP 地址 | 主地址失败时切换使用,可留空 | 空 |
| 建连超时 (ms) | TCP 建连的超时 | 2000 |
| 接收超时 (ms) | 等待设备应答的超时 | 2000 |
串口类协议(Modbus RTU 等)则填串口名(如 COM3 或 /dev/ttyUSB0)、波特率、数据位、校验位、停止位。
部分协议在协议卡片下方有专属参数。例如 Modbus 系协议有站号、地址从 0 开始、高低字节排列顺序等,逐项含义见接入 Modbus TCP 设备。
测试连接后保存#
填完 IP 与端口后,点对话框底部的 测试连接。它按当前表单参数直接与设备握手,不需要先保存。握手成功后点 添加设备。
测试连接与保存互不影响
测试连接走实时探测通道,改完参数可以反复测;保存只把设备写入本地编辑。
下发并确认#
找到「配置发生变更」提示条#
保存后设备先进入本地编辑状态:树里立即出现这台设备,页面顶部出现橙色提示条「配置发生变更,下发后生效」。此时采集网关服务还不知道它。
点下发#
点提示条右侧的 下发,在确认框里点 立即下发。下发是热加载,采集网关服务不重启、不中断其它设备的采集。
- 1改动先进入本地编辑,树里立即可见,但采集网关服务尚未应用
- 2点击下发
在树里确认#
下发完成后,左侧树里该分组下的设备即为生效状态;右栏设备总览的「通信」列能看到它的通信健康度。
提示「网关配置已被其他操作修改,请刷新后重试」
说明另一个浏览器页面或同事在你看配置之后改过网关。刷新页面重新加载配置,再改再下发即可。多人协作时尽量由一人统一改、统一下发。
用模板一次建好设备与点位#
如果设备型号在项目里重复出现(例如同型号电表、同型号 PLC),用模板可以一次建好设备与整张点表:
打开套用模板#
点树顶部的 套用模板(或右键分组选 在该分类下基于模板创建设备),在模板列表里选择一个模板。
- 1搜模板
- 2模板卡片:点击后进入下一步,只需填名称、分组与 IP
填名称、分组与 IP#
对话框会自动生成设备名称与固定编号,通讯参数取模板默认值,你只需要填 IP 地址(串口模板填串口名)和所属分组,确认后设备与全部测点组一起进入本地编辑。
下发#
与手工添加一样,点顶栏 下发 生效。
模板本身可以在 采集系统 → 设备模板 页面维护,也可以从现有设备导出。
启停采集#
采集开关决定这台设备是否参与轮询。右键设备,选 停用设备(或 启用设备),改完同样在顶部提示条里 下发 生效。停用后设备保留在树里,但采集引擎不再与它通讯,适合检修、停机时段使用。
- 1停用采集
常见问题#
保存后设备没被采集#
保存只写了本地编辑,必须点顶栏 下发 才会生效。看顶部是否还有「配置发生变更,下发后生效」提示条。
编辑设备时协议是灰的#
协议在编辑模式下锁定。协议决定寄存器布局,改协议等于换一台设备,请删除后按新协议重建。
「添加设备」点了没反应#
检查是否还有未关闭的对话框;协议选择弹窗需要点 确认选择 才会回到表单。
下一步#
- 接入 Modbus TCP 设备 用内置仿真产线走一遍完整流程,并学会地址写法与排错。
- 接入西门子 S7 S7 的地址体系与 DB 块写法。
- 配置采集点位 设备建好后,把点位一条条配起来。
这篇文档对你有帮助吗?