主题
快速上手：APP 终端用户
本文面向 终端用户、业主、操作员，帮助你在约 15～30 分钟内完成：注册登录 → 添加设备 → 进入设备面板查看与控制。
若你是 安装调试人员 需要装网关、配南向，请阅读 快速上手：网关接入。
适用角色与阅读路径
| 角色 | 你需要做什么 | 重点阅读 |
|---|---|---|
| 首次使用 APP 的终端用户 | 注册、登录、添加已有设备 | 阶段 0～3 |
| 已注册的老用户 | 登录、添加新设备 | 阶段 1、阶段 2 |
| 安装调试人员 | 现场装网关、下发南向 | 快速上手：网关接入 |
开始前请向企业管理员获取 租户 ID（APP 注册与登录必填）。
15 分钟速览清单
- [ ] 准备：手机可上网；已安装微信；已向管理员获取 租户 ID
- [ ] 注册/登录：完成账号注册，或用手机号@租户ID 登录
- [ ] （推荐） 绑定微信，便于下次快捷登录
- [ ] 添加设备：扫码或手工录入 模块 ID 与 验证码
- [ ] 验证：设备出现在「设备」列表，可进入 设备面板 查看状态
整体流程
获取租户ID → 注册/登录 → （可选）绑定微信 → 添加设备 → 进入设备面板阶段 0：准备工作
参与人：终端用户
预计时间：5 分钟
| 事项 | 说明 |
|---|---|
| 租户 ID | 企业唯一标识，向管理员或平台服务商索取 |
| 设备信息 | 设备或网关标签上的 模块 ID、验证码，或完整二维码 |
| 手机权限 | 注册需短信验证码；扫码添加需 相机；部分功能需 定位 |
| 前置条件 | 设备通常已由管理员/安装人员接入平台；本流程是将设备 绑定到你的账号 下使用 |
与「网关安装」的区别：本文是 添加已有设备到个人账号；网关安装（含南向下发、设备档案）见 网关安装。
阶段 1：注册与登录
参与人：终端用户
预计时间：5 分钟
1.1 注册账号（首次使用）
- 打开小程序，在登录页点击「立即注册」
- 填写 租户 ID、手机号，获取并输入短信 验证码
- 设置 登录密码（建议 6 位以上，含字母与数字）
- 点击「注册」——注册成功后通常会自动登录
详细步骤见 小程序用户注册。
1.2 登录账号
- 在登录页填写 账号：
手机号@租户ID（例如13800000000@test） - 输入 密码，点击「登录」
详细步骤见 小程序用户登录与微信绑定。
1.3 绑定微信（推荐）
首次登录后，按提示选择「去绑定」并完成微信授权。绑定后下次可快捷登录，无需重复输入账号密码。
阶段 2：添加设备
参与人：终端用户
预计时间：5 分钟
产出：设备出现在你的设备列表中
- 登录后进入底部 「设备」 菜单
- 点击右上角 「添加」
- 选择添加方式：
- 扫码添加：对准设备标签二维码（通常含模块 ID 与验证码）
- 手工添加：手动输入标签上的 模块 ID 和 验证码
- 核对信息后点击「确认添加」
详细图文见 添加设备与可视化控制。
阶段 3：设备面板（查看与控制）
参与人：终端用户
预计时间：3 分钟
目标：能查看设备状态并进行允许范围内的操作
- 在 设备列表 中找到刚添加的设备
- 点击设备卡片右侧的 设备面板图标（具体样式以租户配置为准）
- 在设备面板中查看实时状态，并按业务需要进行控制（开关、调参等，以实际界面为准）
注意：若看不到设备面板入口，可能是租户未开启
app.device-panel功能，请联系管理员。
至此，APP 终端用户快速上手目标已完成。
常见卡点速查
| 现象 | 最可能原因 | 处理 |
|---|---|---|
| 不知道租户 ID | 未向管理员索取 | 联系企业管理员或平台服务商 |
| 注册/登录失败 | 租户 ID 错误或账号格式不对 | 确认账号为 手机号@租户ID |
| 添加设备失败 | 模块 ID/验证码错误 | 核对设备标签，注意大小写 |
| 提示设备已被绑定 | 设备已关联其他账号 | 联系管理员解绑或分配权限 |
| 列表无设备面板入口 | 租户未开启面板功能 | 联系管理员检查 APP 配置 |
| 面板无数据 | 设备未上线或网关离线 | 联系管理员检查网关与南向配置；见 设备与数据 FAQ |