主题
快速上手：从购网关到看到数据
本文面向 新购网关 的用户，串联 Web 后台配置与 APP 现场安装，帮助你在约 30～60 分钟内完成第一次数据接入。
租户管理员 若尚未完成企业、用户、产品等基础配置，请先阅读 租户初始化。
各步骤的详细说明请通过文内链接跳转到对应章节。
适用角色与阅读路径
| 角色 | 你需要做什么 | 重点阅读 |
|---|---|---|
| 租户管理员 / 实施人员 | 后台配南向、发配置、分权限 | 阶段 0、阶段 1、阶段 3 |
| 现场安装人员 | APP 扫码装网关 | 阶段 0、阶段 2 |
| 业务使用人员 | 登录查看设备数据 | 阶段 3、阶段 4 |
若你还不熟悉系统界面，可先阅读 Web 快速开始 或 小程序概览与准备。
30 分钟速览清单
按顺序勾选，完成即表示接入成功：
- [ ] 准备：账号可登录 Web / APP；网关已上电联网；备好模块 SN 与验证码
- [ ] （管理员） 在 Web 创建或确认 南向配置，状态为 就绪 并已 发布
- [ ] （管理员，可选） 创建 项目，便于后续分组管理
- [ ] （现场） 通过 APP 安装网关 或 Web 网关列表新增 完成绑定
- [ ] 验证：
网关管理中网关 在线 - [ ] 验证：
设备管理中能看到下挂 设备 - [ ] 验证：设备详情中 实时数据 正常（数值量级合理）
整体流程
准备 → 后台配置南向并发布 → 现场安装网关 → Web 验证数据 → （可选）告警/大屏/售后
↑ 管理员 Web APP 或 Web 所有人 Web阶段 0：准备工作
参与人：管理员 + 现场人员
预计时间：10 分钟
0.1 账号与权限
| 事项 | 说明 |
|---|---|
| Web 账号 | 管理员需能登录后台，具备南向配置、网关相关权限 |
| APP 账号 | 安装人员需能登录小程序/App，具备安装网关入口 |
| 权限不足 | 菜单缺失或按钮灰色时，联系管理员，参见 权限管理 |
0.2 网关与网络
- 网关已 上电，指示灯正常
- 网关能 联网（4G / 以太网 / Wi‑Fi，视型号而定）
- 记下设备标签上的 模块 SN、模块验证码（或二维码，格式为
SN;验证码）
0.3 现场接线（Modbus RTU 场景）
- RS485 A/B 线接对，必要时加终端电阻
- 确认仪表 从站地址、波特率、数据位/校验/停止位（常见 8N1）
- 这些信息将用于后续南向配置，详见 Modbus RTU 指南
阶段 1：后台配置（管理员 · Web）
参与人：租户管理员 / 实施人员
预计时间：15～40 分钟（视点位数量而定）
产出：至少一条 已发布 的南向配置
重要：未发布的南向配置不会出现在安装网关时的下拉列表中。
1.1 登录 Web
- 浏览器打开系统地址，使用管理员账号登录
- 不熟悉界面可先阅读 快速开始
1.2 创建项目（推荐，可选）
- 进入
项目管理/项目列表→ 新增项目 - 填写项目名称、地址等基本信息
项目用于按站点分组设备、分配成员权限。详见 项目管理。
1.3 配置并发布南向
- 进入
网关管理/南向配置 - 新建配置，按现场填写：
- 驱动：串口、波特率、8N1 等
- 设备：从站地址、字节顺序
- 属性：寄存器地址、功能码、数据类型、数据转换表达式
- 在配置详情页点击 「状态检测」，确认状态为 就绪
- 点击 发布
注意：仅 就绪 状态的配置可以发布。若仍为草稿或「驱动已配置」等中间状态，说明驱动、设备或属性尚未配全，请按提示补全后再检测。
Modbus RTU 逐步说明与示例见 南向配置 - Modbus RTU。
数据转换表达式（如温度 MUL(0.1)）语法见 南向配置 4.3 节，Modbus 示例见 5.3 节。
也可使用 Excel 批量导入属性，再执行状态检测并发布。
1.3.1 最小可运行示例（首次接入推荐）
若你是第一次配置，可先按下面 最小示例 跑通流程（1 个驱动 + 1 个设备 + 1 个属性），确认能采到数据后，再按现场仪表手册补全其余点位。
前提：现场仪表通信参数与下表一致（最常见为 9600-8-N-1，从站地址 1）。
| 步骤 | 配置项 | 示例值 |
|---|---|---|
| 新建配置 | 配置名称 | 首次接入-测试 |
| 添加驱动 | 协议 | Modbus RTU |
| 串口 | COM1（与网关 RS485 接线口一致） | |
| 波特率 / 数据位 / 停止位 / 校验 | 9600 / 8 / 1 / none | |
| 添加设备 | 设备名称 | 仪表1 |
| 从站地址 | 1（须与仪表拨码一致） | |
| 字节顺序 | ABCD（数值异常时再试 CDAB） | |
| 添加属性 | 属性名称 | 温度 |
| 寄存器地址 | 40001（按仪表手册填写） | |
| 读功能码 | 03（读保持寄存器） | |
| 数据类型 | int | |
| 运算方式 | MUL(0.1)（若仪表输出需 ÷10；已为工程量则留空） | |
| 发布前 | 状态检测 | 显示 就绪 后点击 发布 |
成功标准：完成阶段 2 安装并下发后，在设备详情中能看到该属性有实时数值更新——哪怕只有 1 个点，即表示接入链路已打通。
1.4 确认产品与物模型（按需）
若安装时需选择「产品」或设备档案有必填项，请管理员在 系统设置 中提前配置产品型号与物模型。
详见 系统设置。
1.5 分配安装人员权限（按需）
确保现场人员账号具备网关安装相关能力；业务人员具备设备查看权限。
权限码参考 附录。
阶段 2：现场安装网关
参与人：现场安装 / 调试人员
预计时间：5～15 分钟
产出：网关绑定成功，平台自动发现下挂设备
安装前请确认阶段 1 的南向配置 已发布。
方式 A：APP / 小程序安装（推荐）
适用于绝大多数现场场景。完整图文步骤见 网关安装。
简要步骤：
- 登录 APP → 进入「安装网关」（设备列表「更多」或「我的网关」→「安装新网关」）
- 填写或扫码 模块 SN、模块验证码
- 在「南向配置」中选择阶段 1 已发布 的配置
- 按租户要求填写 设备档案（带红色星号为必填）
- （可选）获取 安装地址
- 点击「立即安装」，等待进度完成（绑定网关 → 下发南向 → 设备注册等）
安装成功后可在「我的网关」中查看网关及下挂设备。
方式 B：Web 网关列表新增
适用于管理员在办公室远程代装场景。
- 进入
网关管理→网关列表 - 点击「新增」
- 填写或扫码 模块 SN（网关 UID）、模块验证码
- 保存后进入该网关的 网关详情，点击「下发南向配置」，选择阶段 1 已发布 的配置
详见 4.1.3 新增网关。
Web 安装后必做
Web 路径与 APP 不同：新增网关 不会自动下发 南向配置，需按以下顺序完成：
确认网关在线
在网关管理/网关列表中，目标网关状态须为 在线。若离线，先排查供电、SIM/网线、天线；离线时无法下发 南向配置。下发南向配置
进入 网关详情 → 点击「下发南向配置」→ 选择已发布配置 → 确认下发。
下发过程中网关可能短暂重载驱动，属正常现象。等待设备发现
下发完成后等待 1～3 分钟（设备较多时可能更久）。
先在 网关详情 → 设备列表 查看是否已出现设备，再前往设备管理/设备列表核对。验证数据
进入设备详情查看实时数据。若网关详情中已有设备但无数值，参见阶段 3.3 与 常见卡点速查。
两种方式对比
| 对比项 | APP 安装 | Web 网关列表新增 |
|---|---|---|
| 适用场景 | 现场扫码、记录定位 | 办公室远程代装 |
| 安装地址 | 支持 GPS 定位 | 需在网关详情或设备档案中维护 |
| 入口 | 小程序 / App | 网关管理 → 网关列表 |
| 南向下发 | 安装时一并选择并下发 | 新增后需在网关详情手动下发 |
阶段 3：验证接入成功（Web）
参与人：管理员或业务人员
预计时间：5 分钟
目标：在主站 第一次看到实时数据
按以下顺序检查三个「成功信号」：
3.1 网关在线
- 路径：
网关管理/网关列表 - 期望：目标网关状态为 在线，有最近心跳时间
- 若离线：检查网关供电、网络、SIM/网线；参见 常见问题 Q27
3.2 设备已出现
- 路径：
设备管理/设备列表 - 期望：列表中出现该网关下的设备（名称/数量与南向配置一致）
- 若「网关下未发现设备」：南向下发后需等待发现，稍后在网关详情查看；参见 网关安装 FAQ
3.3 实时数据正常
- 路径：点击设备进入 设备详情 → 查看实时数据 / 历史曲线
- 期望：点位有数值更新，单位与量级合理
- 若数值异常：依次检查字节顺序、数据类型、数据转换表达式，参见 常见问题 Q26、Q28
至此，快速上手核心目标已完成。
阶段 4：可选进阶
接入成功后，可按业务需要继续配置：
| 需求 | 参考章节 |
|---|---|
| 设备归入项目、成员权限 | 项目管理 |
| 告警规则与通知 | 告警管理 |
| 项目数据大屏 | 数据可视化 |
| 网关 / 设备固件升级 | 固件管理 |
| 售后工单与维保 | 售后服务 |
| 摄像头接入 | 视频中心 |
常见卡点速查
| 现象 | 最可能原因 | 处理 |
|---|---|---|
| 安装时南向列表为空 | 南向未 发布 | 管理员在 Web 发布配置 |
| 绑定网关失败 | SN/验证码错误或已被绑定 | 核对标签，联系管理员解绑 |
| 网关一直离线 | 未联网或网络异常 | 查供电、SIM、天线、网线 |
| 安装成功但无设备 | 南向与现场参数不一致 | 核对从站地址、波特率、接线 |
| 有数据但数值不对 | 字节序或转换表达式错误 | 见 Q26/Q28 与 运算方式 4.3 |
| 安装进度长时间卡住 | 网关执行慢或网络不稳 | 保持网络畅通，确认网关在线后重试 |
更多问题见 网关与南向接入 FAQ · Web FAQ · 南向与 Modbus。
下一步阅读
- 租户管理员（首次交付）：快速上手：租户初始化
- APP 终端用户：快速上手：APP 终端用户
- 继续熟悉 Web 各模块：手册目录
- 深入 Modbus 配置：南向配置 - Modbus RTU
- APP 其他功能：小程序手册首页
- 术语与权限码：附录