面向非技术客户的技术说明

在数字孪生项目中，接入评估不能只看设备是否能接 USB、串口或网口，还需要确认数据如何从设备进入平台、平台按什么协议读取，以及最终如何绑定到图表、三维模型、告警或联动动作。可将完整链路理解为四层：物理/设备层、网络传输层、应用/协议层和业务展示层。

图 1  从设备连接到业务展示的四层关系

1. 各层含义与客户需确认内容层级客户需确认的问题典型示例物理 / 设备层信号是否能够被采集、传出传感器芯片、PLC、采集卡、USB、串口、网口网络传输层数据是否能够到达平台或服务器IP、域名、端口、TCP/UDP、局域网/公网、VPN、防火墙应用 / 协议层软件按什么规则读取和解析数据HTTP API、WebSocket、MQTT、MODBUS TCP、OPC UA、数据库业务展示层数据如何被看见并触发动作图表、三维模型绑定、告警、联动动画、API 控制说明：USB、传感器芯片和设备型号属于“硬件入口”；HTTP API、WebSocket 等属于“软件入口”。硬件能够连接，并不等于应用层已经可读。平台还需要接口地址、请求方式、鉴权方式、字段含义、数据格式、刷新频率和异常处理规则。

2. 我们产品常见接入方式

孪大师平台可配置多类数据源。业务系统或服务器通常优先采用 HTTP API（GET/POST 返回 JSON），适合定时刷新看板；需要实时推送时，可采用 WebSocket 或 MQTT，适合设备状态、告警和高频数据；PLC 或工业设备常见 MODBUS TCP、OPC UA、TCP/UDP，由设备或网关提供点位；视频场景可接 HTTP-FLV、HLS、MPEG-DASH、RTSP/RTMP 等流地址；数据也可来自 MySQL、SQL Server、PostgreSQL、Oracle、MongoDB、Redis、Excel/CSV 等。

3. 典型数据接入路径

图 2  数据从设备进入孪大师平台的典型路径

4. 客户资料清单

•  硬件：设备型号、传感器芯片、量程、精度、供电、USB/串口/网口等接口。

•  网络：IP/域名、端口、是否公网、VPN、防火墙白名单。

•  协议：HTTP、WebSocket、MQTT、OPC UA、MODBUS 等，以及账号、Token、证书。

•  数据：字段名、单位、示例数据、更新时间、历史查询能力。

•  展示：字段绑定到哪个模型/图表，是否需要告警、反控、联动动画。

5. 接入可行性判断

建议先用一条最小链路验证：一个设备、一个点位、一个接口、一个图表。验证通过后，再扩展到批量设备和复杂业务联动。判断标准不是“USB 是否能插上”，而是“硬件数据是否能稳定转换为平台可配置、可解析、可展示、可告警的数据源”。