主题
服务器数据对接
本手册说明两件事：怎么把现场数据送到 LPPLC 服务器，以及怎么从服务器把数据取出来供其它系统使用。
先看这里：数据怎么上传到服务器
首次对接可从这一页开始：
该页用一张表列出 5 条上云通道的适用对象、是否需要编写代码、数据存放位置，选定方案后再看细节章节。
一句话概括：
| 使用场景 | 推荐路径 |
|---|---|
| 用的是 LP 系列 PLC | DTU 云交互数据点，配置即可，不用写代码 |
| 上报前要换算或判断 | Lua 脚本上云 |
| 第三方设备 / 自己的程序 | MQTT 直连（推荐）或 HTTP 上报 |
| ERP / MES / 后台系统要读写数据 | HTTP API |
| 只想在画面上看一个 PLC 寄存器 | 云组态直连寄存器 |
| SCADA / 组态王 / 触摸屏要取数 | Modbus TCP Server |
核心概念：实时数据库
服务器的中心是实时数据库，里面是一个个数据点（名字 + 当前值）。
数据只要进了实时数据库，上面所有能力就都能用。对接的第一目标就是让数据变成数据点。
端口速查
| 服务 | 端口 | 说明 |
|---|---|---|
| HTTP / WebSocket | 80 | API 与实时推送 |
| HTTPS / WSS | 443 | 公网部署请用这个 |
| MQTT | 1883 | 不支持 TLS，没有 8883 |
| Modbus TCP Server | 502 | 对接 SCADA |
| PLC Server（FX 协议） | 5550 | LP 设备接入 |
| FTP | 21 / 20 | 文件传输，不支持 PASV |
完整清单见 附录 A 端口速查表。
三个关键注意事项
1. HTTP 接口的操作名字段是 cmd，不是 function
json
{ "cmd": "get_real", "username": "...", "password": "...", "data": ["点名"] }没有登录接口，没有 Token，没有 /api/ 前缀。每个请求自带账号密码，统一 POST 到 /web。详见 4.1。
2. MQTT 的 payload 直接放裸值最简单
topic: 车间1/1号机/温度
payload: 25.6请勿直接套用其它平台的 {"value":25.6,"timestamp":...,"quality":"good"} 格式：timestamp 和 quality 会各自变成一个真实数据点。完整映射规则见 5.5 消息格式规范。
3. 没设存盘方式就没有历史数据
数据点默认「不存盘」。要曲线、要报表，必须在「数据管理 → 实时数据库 → 存盘方式」里逐点设置。见 4.4 历史数据接口。
章节导航
| 章节 | 内容 |
|---|---|
| 第一章 概述与架构 | 服务器能力、架构图、协议选择 |
| 第二章 部署与配置 | 安装、端口防火墙、HTTPS 证书、数据库 |
| 第三章 设备数据上云 | 五种上云方式、DTU 绑定、Lua 脚本、组态直连寄存器 |
| 第四章 HTTP 对接 | 认证、实时数据、历史数据、调用示例、设备端上报 |
| 第五章 MQTT 对接 | Broker 配置、消息格式规范、设备互发、组态 MQTT 变量 |
| 第六章 Modbus TCP Server | 寄存器映射、SCADA 对接 |
| 第七章 WebSocket | 实时推送、订阅机制、前端接入 |
| 第八章 运维与监控 | 服务状态、日志、性能、备份、排查 |
| 附录 | 端口、错误码、配置文件、问题索引 |
安全提醒
所有接口的账号密码都是明文放在请求体里的，没有 Token 机制。因此：
- 公网部署必须走 HTTPS / WSS，不要使用 80 端口明文传输
- 给每个对接程序、每台设备开独立子账号，不要共用主账号
- 不要把主账号密码写进前端页面或客户端 App