添加一台设备

认识采集配置页的层级树,新建分组,用「添加设备」对话框或设备模板把一台 PLC 加入采集,下发后启停采集。

  • 入门
  • 动手约 15 分钟
  • 阅读 4 分钟
  • 更新于 2026-11-09

视频教程 · 灵犀·Studio 从入门到精通 · 第 3 集 6:14

接入第一台 PLC:Modbus TCP 实战

你将完成

读完本篇你将完成:

  • 在采集配置页里新建一个分组;
  • 用「添加设备」对话框添加一台设备,填好协议与通讯参数;
  • 把改动下发到采集网关服务,并在树里看到这台设备;
  • 按需启用 / 停用这台设备的采集。

开始之前

  • 已安装并能登录灵犀·Studio(参见安装与部署);
  • 知道目标设备用什么协议、IP 地址和端口。

先认识采集配置页#

打开菜单 采集系统 → 采集配置。页面分左右两栏:

  • 左栏是「采集层级」树,从左到右分四级:分组 → 设备 → 测点组(点表)→ 点位。顶部一排按钮:导入设备 JSON、导出全部 JSON、套用模板、添加设备。
  • 右栏是设备总览:设备列表、通信状态筛选,以及每台设备的名称、类型、地址、采集开关与通信健康度。
采集层级树:分组、设备、测点组、点位四级结构采集配置页左侧的采集层级树分四级:分组按车间或产线组织设备,可以嵌套;设备对应一台物理控制器,保存协议与通讯参数;测点组是一台设备的点表,决定采样间隔与整组启停;点位是最小单位,一个地址加数据类型对应一个实时值。这一层管什么▾ 示例设备分组(分类)· 可嵌套多级,如「一车间 / 灌装线」组织结构:分类存放、整组导出设备 JSON灌装产线PLC设备 · ModbusTcpClient · 以太网 · host.docker.internal:15022一台物理控制器:协议、IP、端口、站号产线点表测点组(点表)· 采样间隔 500 ms · 可整组启停点表:采样周期、请求数与整组启停启动命令x=1;0 · bool当日产量x=4;4 · ushort点位(测点):地址 +数据类型 = 一个实时值
图 1 采集层级树的四级结构:分组放设备,设备带点表,点表里是一条条点位

四级各管什么

分组只负责组织结构,可以多级嵌套;设备保存协议与 IP、端口等通讯参数;测点组决定一组点位的采样间隔,可整组启停;点位是最小单位,一个地址加一个数据类型对应一个实时值。点位的配置见配置采集点位。

新建一个分组#

在树上找到放设备的位置#

分组可以按车间、产线来建。右键已有分组(如「示例设备」),菜单里选 新增子分类;也可以右键树的空白处,选 新增顶级分类。

输入分组名称#

在弹出的输入框里填写分类名称,如「一车间」。确认后提示「分类已创建」。

空分组不会出现在「所属分组」下拉里

「添加设备」对话框的所属分组下拉只列出已有设备的分组路径。要让新设备放进刚建的空分组,请右键这个分组,选 在该分类下添加设备,分组会被自动带进对话框。

添加设备#

打开对话框#

点击树顶部的 添加设备 按钮。对话框默认选中「常规 Modbus-TCP 客户端」,这是最常用的协议。

「添加设备」对话框:上半部分选协议,下半部分填名称与通讯参数
  1. 1点击换协议
  2. 2填写名称
  3. 3选择分组
  4. 4点击添加

选择设备协议#

点击顶部的协议卡片打开选择设备协议弹窗:左列选设备大类(PLC 等设备 / 机器人 / CNC 数控 / 特殊设备 / 插件设备),中列选厂商品牌,右列选具体协议。也可以在顶部搜索框直接搜「Modbus」「西门子」或 DeviceType 名称。

选择设备协议:大类 → 品牌 → 协议三级选择,顶部可搜索
  1. 1选大类
  2. 2选品牌
  3. 3选协议
  4. 4搜索框:直接搜协议名、厂商或 DeviceType

选中后点 确认选择 回到表单。协议一旦保存就不能改——它决定了整棵点位子树的寄存器体系,要换协议只能删除重建。

填写基础属性#

字段说明默认值
设备名称必填,树与列表里显示的名字空
所属分组必填,选择或新建分组路径空
固定编号可选,便于巡检时核对设备空
采集开关已启用(创建即采集)/ 已停用 / 停止并隐藏已启用
请求间隙 (ms)两次通讯之间的间隔,0–3000050
描述可选备注空

填写通讯参数#

以太网类协议(Modbus TCP、S7、MC 等)填这些:

字段说明默认值
IP 地址必填,设备的 IP空
端口必填,协议默认端口会自动带入按协议
冗余 IP 地址主地址失败时切换使用,可留空空
建连超时 (ms)TCP 建连的超时2000
接收超时 (ms)等待设备应答的超时2000

串口类协议(Modbus RTU 等)则填串口名(如 COM3 或 /dev/ttyUSB0)、波特率、数据位、校验位、停止位。

部分协议在协议卡片下方有专属参数。例如 Modbus 系协议有站号、地址从 0 开始、高低字节排列顺序等,逐项含义见接入 Modbus TCP 设备。

测试连接后保存#

填完 IP 与端口后,点对话框底部的 测试连接。它按当前表单参数直接与设备握手,不需要先保存。握手成功后点 添加设备。

测试连接与保存互不影响

测试连接走实时探测通道,改完参数可以反复测;保存只把设备写入本地编辑。

下发并确认#

找到「配置发生变更」提示条#

保存后设备先进入本地编辑状态:树里立即出现这台设备,页面顶部出现橙色提示条「配置发生变更,下发后生效」。此时采集网关服务还不知道它。

点下发#

点提示条右侧的 下发,在确认框里点 立即下发。下发是热加载,采集网关服务不重启、不中断其它设备的采集。

顶栏的下发提示条:本地改动点「下发」后才会写到采集网关服务
  1. 1改动先进入本地编辑,树里立即可见,但采集网关服务尚未应用
  2. 2点击下发

在树里确认#

下发完成后,左侧树里该分组下的设备即为生效状态;右栏设备总览的「通信」列能看到它的通信健康度。

提示「网关配置已被其他操作修改,请刷新后重试」

说明另一个浏览器页面或同事在你看配置之后改过网关。刷新页面重新加载配置,再改再下发即可。多人协作时尽量由一人统一改、统一下发。

用模板一次建好设备与点位#

如果设备型号在项目里重复出现(例如同型号电表、同型号 PLC),用模板可以一次建好设备与整张点表:

打开套用模板#

点树顶部的 套用模板(或右键分组选 在该分类下基于模板创建设备),在模板列表里选择一个模板。

套用模板:选中模板后只需填名称、分组和 IP,点位随模板带入
  1. 1搜模板
  2. 2模板卡片:点击后进入下一步,只需填名称、分组与 IP

填名称、分组与 IP#

对话框会自动生成设备名称与固定编号,通讯参数取模板默认值,你只需要填 IP 地址(串口模板填串口名)和所属分组,确认后设备与全部测点组一起进入本地编辑。

下发#

与手工添加一样,点顶栏 下发 生效。

模板本身可以在 采集系统 → 设备模板 页面维护,也可以从现有设备导出。

启停采集#

采集开关决定这台设备是否参与轮询。右键设备,选 停用设备(或 启用设备),改完同样在顶部提示条里 下发 生效。停用后设备保留在树里,但采集引擎不再与它通讯,适合检修、停机时段使用。

设备右键菜单:停用 / 启用设备,改完仍需下发
  1. 1停用采集

常见问题#

保存后设备没被采集#

保存只写了本地编辑,必须点顶栏 下发 才会生效。看顶部是否还有「配置发生变更,下发后生效」提示条。

编辑设备时协议是灰的#

协议在编辑模式下锁定。协议决定寄存器布局,改协议等于换一台设备,请删除后按新协议重建。

「添加设备」点了没反应#

检查是否还有未关闭的对话框;协议选择弹窗需要点 确认选择 才会回到表单。

下一步#

这篇文档对你有帮助吗?