WCS 介绍

WCS（仓库控制系统）通过网络将各种物理设备连接到平台，实现设备的统一接入、实时监控与远程控制。平台将物理设备抽象为产品和设备两层结构，并通过物模型描述设备的能力与交互方式。

产品与设备

产品是一类具有相同功能的设备的集合，是设备的抽象模板。例如"IO控制门"是一个产品，定义了该类设备所具备的属性、事件和服务。

设备是产品的具体实例，绑定到实际的物理硬件，具有唯一的名称和网络地址。例如"3车间1号门"是一个设备，属于"IO控制门"产品。

物模型

物模型（Thing Model）是对设备功能的数字化描述，包含三大核心要素：

要素	说明	示例
属性	设备自身的状态或配置值	门状态、当前楼层、温度值
服务	设备可被调用的功能或方法	开门、关门、呼叫电梯
事件	设备主动上报的重要状态变化	门已打开、到达楼层

属性上报

设备端将自身状态数据（如开关状态、传感器数值）上报至平台，平台自动更新设备属性的当前值并记录历史数据。

属性下发

在平台侧修改属性值后，平台将指令同步下发至设备端，设备端执行相应动作。常用于远程控制设备，例如改变继电器开关、设置运行参数等。

产品列表

路径：物联网 → 产品

产品列表展示平台中所有已定义的产品类型。每个产品可查看详细的物模型定义。

列	说明
产品名称	产品的显示名称
描述	该产品的用途说明

点击详情可查看产品的完整物模型，包括属性、事件和服务三个标签页。

产品详情

产品详情页展示产品的基本信息及物模型定义：

• 产品标识：系统内唯一标识符（如 LogiMaster.IODoor）
• 产品名称：显示名称（如 IO控制门）
• 描述：产品用途说明
• 驱动：底层通信驱动（如 IODoorDriver）

属性标签页列出该产品所有属性的标识符、显示名称、数据类型、访问方式（只读/读写）和单位。

事件标签页列出设备可主动上报的事件，例如"门已打开"、"门已关闭"。

服务标签页列出可调用的服务，例如"开门"、"关门"。

设备列表

路径：物联网 → 设备

设备列表展示平台中所有已接入的物理设备实例。

列	说明
名称	设备唯一名称
产品名称	该设备所属的产品类型
设备分组	设备所属分组，便于分类管理
在线状态	设备当前的连接状态（在线/离线）

筛选与搜索

• 设备分组下拉框：按分组筛选设备
• 名称搜索框：按名称模糊搜索设备

操作菜单

每行设备提供操作下拉菜单，包含以下操作：

操作	说明
详情	进入设备详情页，查看属性、服务等实时数据
编辑	修改设备的名称、IP地址、端口、分组等基本信息
复制	以当前设备为模板快速创建新设备
删除	从平台移除该设备

新建设备

点击新建设备按钮，填写以下信息创建设备：

字段	说明
名称	设备唯一名称（必填）
描述	设备用途描述
IP地址	设备网络地址
端口号	通信端口
产品名称	选择设备所属的产品类型
设备分组	选择分组（默认为未分组）

提示

物理设备要连接到平台，需要先在平台创建设备，再将物理设备的网络参数与平台配置保持一致。

设备分组管理

点击设备分组按钮可管理分组，对设备进行分类，便于批量查看和管理同类设备。

设备详情

路径：操作 → 详情

设备详情页提供设备的实时状态和完整物模型数据查询，包含以下标签页：

属性

展示设备当前所有属性的实时值，按属性名称分卡片显示。支持多设备单元切换查看（如设备包含多个子单元）。

对于读写属性，可点击属性下发链接，向设备下发新的属性值。

设备信息

展示设备的基本配置信息：

• 名称、产品名称、产品标识
• IP地址、端口号、驱动
• 在线状态、最后更新时间、创建时间、最后修改时间
• 描述

服务调用

列出该设备可调用的所有服务，每个服务提供调用按钮及对应的 API 命令预览（curl 格式），方便开发调试。

设备单元

部分设备支持多个子单元（例如一台上位机管理多个工位），此标签页展示所有子单元的配置。

设备日志

查询该设备的操作日志，支持按日志类型、时间范围筛选。日志记录包含：时间、日志类型、标识名、入参、出参、是否成功。

激活状态

设备详情页顶部提供激活状态开关，关闭后该设备将暂停与平台的通信交互，可用于设备维护期间临时下线。