设备接入与APP（应用程序）接入华为云iotDA平台的详细操作步骤及获取方式

 壹、设备登录 IoTDA 的通关清单详细操作路径及获取方式

下面将之前整理的“设备登录 IoTDA 的通关清单”补充为带有详细操作路径的实用指南，逐项说明这些信息在哪里查、怎么查、怎么用，可以一步步操作落地，无需额外查文档。

---

✅【完整版】设备登录 IoTDA 的通关清单 + 获取方式详解

类别	必要信息	获取方式	操作说明（带路径）
① 地址	平台接入地址（域名/IP）	IoTDA 控制台首页	登录 华为云控制台 → 搜索“IoTDA” → 进入实例 → 查看“接入信息” → 复制 MQTT、AMQP、HTTPS 接入地址。
② 身份	设备ID	设备管理 页面	左侧菜单「设备管理」 → 找到目标设备 → 点击设备名称 → 页面上方即显示设备ID（用于通信与认证）。
③ 标识	物理标识码（IMEI/MAC）	自己设备端查看 / 注册设备时填写	开发设备端时，通过代码获取或使用硬件默认标识。若设备注册为“静态注册”，平台需要你填写这项；若是“自注册”方式可自动带入。
④ 名称	设备名称	创建设备时填写	「设备管理」→「添加设备」时自定义填写。建议按“区域_功能_编号”命名，便于管理（如：sh_room01_sensor_001）。
⑤ 产品	产品ID / 名称	产品管理 页面	「产品管理」→ 找到产品 → 右侧操作栏点击「详情」→ 可复制产品名称和产品ID（用于设备归属认证）。
⑥ 认证	设备密钥 / 证书	设备详情页面	若使用密钥方式：「设备管理」→ 设备名称 → 页面中可见密钥（不可见可点击“重置密钥”）；若用证书方式：「设备管理」→ 下载证书包，并配置好 X.509。
⑦ 通信方式	协议类型（MQTT / HTTPS / LwM2M）	创建产品时指定	「产品管理」→ 创建产品时选“设备接入协议” → 支持 MQTT / LwM2M / CoAP / HTTPS。注意：不同协议对应不同端口和认证方式。
⑧ 安全设置	安全模式（密钥 / 证书 / PSK）	产品详情中查看	「产品管理」→ 产品详情 → 查看“认证方式”字段。MQTT 默认密钥或证书，LwM2M 支持 PSK / NoSec / RPK 等。
⑨ Topic 路径	平台预置或自定义Topic	产品模型中查看	「产品管理」→ 产品详情 → 「Topic类模板」页签 → 查看预置Topic路径（如上报属性、接收命令等）
⑩ 能力模型	产品模型（属性/命令/服务）	产品详情中导出	「产品管理」→ 找到产品 → 点击右侧「详情」→ 进入「产品模型」 → 点击「导出」，下载 .json 模型文件。设备和平台通信必须严格按模型格式。
⑪ SDK / 驱动	设备端 SDK 或通信代码	华为开发者文档	登录 开发者中心 → 搜索“设备SDK” → 下载适配语言版本（C/Python/Java）并参考示例配置密钥、Topic 和模型。
⑫ 网络连通性	设备所在网络能访问 IoTDA	命令行测试	在设备或开发板上执行：ping iot-mqtts.cn-north-4.myhuaweicloud.com，能通说明连得上平台。否则检查代理、防火墙或 DNS。

---

一次性准备清单：快速汇总（适合文档记录）

类型	参数示例	用于
接入地址	iot-mqtts.cn-north-4.myhuaweicloud.com:8883	连接 IoTDA
产品ID	a87dc9xx-xxxx-4bde-xxxx-937bxxxx	注册设备时归属产品
设备ID	device_001_abc123	设备通信认证用
密钥	Ahd93sXxx12...	MQTT 密钥认证
Topic 路径	/v1/devices/device_001_abc123/data/report	发布数据
产品模型文件	product_model.json	定义属性/命令格式
证书指纹	E3:BC:4F:XX:...	证书认证时需填写
SDK版本	IoT Device SDK C v1.1.1	嵌入式设备集成通信库

---

❗常见错误提醒：

问题	原因	解决方案
设备连接不上平台	地址错误 / 密钥错误 / 网络不通	检查端口、密钥、执行 ping
上报数据无响应	Topic 错误 / 模型格式不一致	校对 Topic 路径 & JSON 结构
平台显示离线	没有保持心跳包或上报周期过长	使用 SDK 示例中 keepalive 配置

---

贰、APP 登录 IoTDA 平台通关清单的操作步骤及获取方式

APP 登录 IoTDA 平台所需的 入场与操作清单内容，提供逐项详细操作步骤和获取方式，并穿插贴士便于理解与实际操作落地。内容基于 华为云 IoTDA 控制台 和 IAM 控制台 的实际使用路径整理。

---

✅ APP 登录 IoTDA 的入场与操作清单：获取方式详解

---

1. 【接入地址】如何获取？

目的：获取 APP 连接 IoTDA 所需的 MQTT、AMQP 或 HTTP 接口地址

操作步骤：

1. 登录 华为云控制台

2. 在首页搜索栏输入 “IoTDA” → 进入 “设备接入 IoT 平台”

3. 左侧导航栏选择「实例管理」或「总览」

4. 在当前实例的右侧点击 “接入信息”

5. 查看以下地址：

   • MQTT 接入地址

   • AMQP 接入地址（例：amqps://iot-xxxx:5671）

   • HTTPS API 地址（如需通过 API 调用）

小贴士：

• 不同协议有不同的端口，注意区分：

  • MQTT：端口8883

  • AMQP：端口5671

  • HTTP API：无固定端口，一般为 https://iot-xxx.myhuaweicloud.com

---

2. 【IAM Token 或 AK/SK】如何获取？

✅ 方式一：获取 IAM Token（推荐临时访问）

操作步骤：

1. 登录 API Explorer：获取IAM Token

2. 输入账号/密码（或使用 curl 脚本）

3. 成功后，返回内容中有 "X-Subject-Token"，这个值就是你接下来请求 IoTDA 时要放在 Header 里的 Token

✅ 方式二：创建访问密钥 AK/SK（推荐给长期接入 APP 使用）

操作步骤：

1. 登录 华为云控制台

2. 点击右上角头像 → 「我的凭证」

3. 左侧选择「访问密钥」

4. 点击「新增访问密钥」

5. 系统会显示你的 AK（Access Key） 和 SK（Secret Key）

记得把 SK 下载保存，仅显示一次！

---

3. 【accessCode（仅限 AMQP）】如何获取？

1. 进入 IoTDA 控制台 → 左侧菜单点击「设备接入」

2. 点击「接入凭证管理」

3. 创建或查看已有的接入凭证，复制 Access Code

---

4. 【产品模型】如何获取并下载？

产品模型是设备的“能力说明书”，APP 需要了解以便数据交互格式正确。

操作步骤：

1. 进入 IoTDA 控制台 → 左侧菜单「产品管理」

2. 找到对应的产品，点击「操作」→「详情」

3. 点击「产品模型」，可看到定义好的属性、命令、服务等内容

4. 点击「导出产品模型」下载 .json 文件（APP 可解析使用）

---

5. 【产品ID 和设备信息】如何获取？

产品ID 获取方式：

• 在「产品管理」页面，点击对应产品右侧「复制产品ID」

设备名称/ID 获取方式：

• 在「设备管理」页面，找到对应设备 → 点击「详情」

• 复制「设备ID」与「设备名称」

---

6. 【Topic 路径】如何查看？

Topic 是设备和 APP 之间通信的“信封地址”，必须知道正确路径才能通信。

查看方式：

1. 进入「产品管理」→ 找到产品 → 点击「详情」

2. 查看「Topic 类模板」页签

3. 可以看到平台预置的发布/订阅路径格式，如：

   • 发布数据路径：/v1/devices/{device_id}/data

   • 命令响应路径：/v1/devices/{device_id}/command/response

---

7. 【API 使用方式】如何查看？

推荐入口：华为云 API Explorer（提供示例）

1. 打开：IoTDA API Explorer

2. 按功能搜索，比如“创建设备”、“获取设备属性”等

3. 选择请求方式（GET/POST）、输入参数，系统将自动生成调用代码

---

8. 【网络环境】如何测试是否联通 IoTDA？

方法：

• 在 APP 所在服务器或手机终端上执行：

bash

ping iot-xxx.myhuaweicloud.com

或使用 curl：

bash

curl https://iot-xxx.myhuaweicloud.com/v5/iot/...

若 ping 不通或 curl 报错，说明你可能需要开通公网访问或配置网络代理。

---

附加建议

场景	推荐使用方式
APP 使用 Web 或服务端调用	建议用 API + AK/SK
APP 需要实时监听设备数据	建议用 AMQP 通道订阅消息
APP 临时操作设备	可用 IAM Token 发起一次性命令