壹、设备登录 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 接口地址
操作步骤:
-
登录 华为云控制台
-
在首页搜索栏输入 “IoTDA” → 进入 “设备接入 IoT 平台”
-
左侧导航栏选择「实例管理」或「总览」
-
在当前实例的右侧点击 “接入信息”
-
查看以下地址:
-
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(推荐临时访问)
操作步骤:
-
登录 API Explorer:获取IAM Token
-
输入账号/密码(或使用 curl 脚本)
-
成功后,返回内容中有
"X-Subject-Token"
,这个值就是你接下来请求 IoTDA 时要放在 Header 里的 Token
✅ 方式二:创建访问密钥 AK/SK(推荐给长期接入 APP 使用)
操作步骤:
-
登录 华为云控制台
-
点击右上角头像 → 「我的凭证」
-
左侧选择「访问密钥」
-
点击「新增访问密钥」
-
系统会显示你的 AK(Access Key) 和 SK(Secret Key)
记得把 SK 下载保存,仅显示一次!
3. 【accessCode(仅限 AMQP)】如何获取?
-
进入 IoTDA 控制台 → 左侧菜单点击「设备接入」
-
点击「接入凭证管理」
-
创建或查看已有的接入凭证,复制 Access Code
4. 【产品模型】如何获取并下载?
产品模型是设备的“能力说明书”,APP 需要了解以便数据交互格式正确。
操作步骤:
-
进入 IoTDA 控制台 → 左侧菜单「产品管理」
-
找到对应的产品,点击「操作」→「详情」
-
点击「产品模型」,可看到定义好的属性、命令、服务等内容
-
点击「导出产品模型」下载
.json
文件(APP 可解析使用)
5. 【产品ID 和设备信息】如何获取?
产品ID 获取方式:
-
在「产品管理」页面,点击对应产品右侧「复制产品ID」
设备名称/ID 获取方式:
-
在「设备管理」页面,找到对应设备 → 点击「详情」
-
复制「设备ID」与「设备名称」
6. 【Topic 路径】如何查看?
Topic 是设备和 APP 之间通信的“信封地址”,必须知道正确路径才能通信。
查看方式:
-
进入「产品管理」→ 找到产品 → 点击「详情」
-
查看「Topic 类模板」页签
-
可以看到平台预置的发布/订阅路径格式,如:
-
发布数据路径:
/v1/devices/{device_id}/data
-
命令响应路径:
/v1/devices/{device_id}/command/response
-
7. 【API 使用方式】如何查看?
推荐入口:华为云 API Explorer(提供示例)
-
打开:IoTDA API Explorer
-
按功能搜索,比如“创建设备”、“获取设备属性”等
-
选择请求方式(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 发起一次性命令 |