零硬件上手华为云 IoTDA：快速搭建物联网数据采集与远程控制

一、背景与痛点

1. 设备还没到，云端流程无法验证：硬件采购、接线、固件调试都需要时间，业务应用不能一直等。
2. 数据格式和平台模型对不上：设备发了数据，平台却无法识别温度、湿度等属性。
3. 控制命令有去无回：设备收到命令后没有返回执行结果，云端无法确认操作成功。
4. 设备数据和业务数据脱节：设备已经上报数据，但后端应用还不知道如何可靠地获取。

设备模拟器 → 属性上报 → IoTDA → OBS 持久化
业务控制台 → 命令下发 → 设备模拟器 → 命令响应

二、方案设计

2.1 场景定义

• 上报温度、湿度两个属性。
• 接收云端下发的 device_switch 命令。
• 返回命令执行结果。
• 将上报数据转发到 OBS，供后续查询和分析。

2.2 技术选型

2.3 整体架构

┌──────────────────────┐
                │ 华为云设备接入 IoTDA │
                │                      │
┌───────────┐  │  ┌────────────────┐  │  ┌──────────┐
│ 设备模拟器 │──┼─▶│ 属性上报        │──┼─▶│ OBS      │
└───────────┘  │  └────────────────┘  │  └──────────┘
      ▲        │                      │
      │        │  ┌────────────────┐  │
      └────────┼──│ 命令下发与响应  │  │
               │  └────────────────┘  │
               │  ┌────────────────┐  │
               │  │ 产品模型        │  │
               │  │ 设备影子        │  │
               │  └────────────────┘  │
               └──────────────────────┘

2.4 消息交互设计

$oc/devices/{device_id}/sys/properties/report

$oc/devices/{device_id}/sys/commands/request_id={request_id}

$oc/devices/{device_id}/sys/commands/response/request_id={request_id}

方案关键：模拟器已经能上报属性，不代表它一定能处理同一条 JSON 里的任意业务字段。产品模型定义了什么属性、命令包含哪些参数，就按什么格式收发。

三、实操步骤

3.1 开通服务并确认实例

3.2 创建产品与产品模型

• 协议类型：MQTT
• 数据格式：JSON
• 产品名称：iotdemo-temperature-sensor

• 命令名称：device_switch
• 命令参数：value
• 参数类型：string
• 参数取值：ON、OFF

BasicData
├── temperature：设备上报
└── humidity：设备上报

LightControl
└── device_switch(value)：平台下发

3.3 注册设备

• 设备 ID
• 设备密钥
• MQTT 接入地址

DEVICE_ID：iotdemo-temperature-sensor-001
接入地址：your-iotda-endpoint

3.4 使用设备模拟器上报属性

{
  "services": [
    {
      "service_id": "BasicData",
      "properties": {
        "temperature": 26.3,
        "humidity": 58.1
      }
    }
  ]
}

• temperature 是否更新为 26.3
• humidity 是否更新为 58.1
• 数据时间是否刷新

{
  "services": [
    {
      "service_id": "BasicData",
      "properties": {
        "temperature": 30.5,
        "humidity": 45.0
      }
    }
  ]
}

3.5 下发远程控制命令

• 服务：LightControl
• 命令：device_switch
• 参数：value = ON

• 命令名称
• value 参数
• request_id

{
  "result_code": 0,
  "response_name": "COMMAND_RESPONSE",
  "paras": {
    "result": "success"
  }
}

1. 设备是否在线。
2. 产品模型中是否存在 LightControl 服务及 device_switch 命令。
3. 命令参数名是否为 value。
4. 返回消息是否发送到了本次命令对应的响应 Topic。
5. 响应中的 request_id 是否与下发命令中的值一致。

3.6 配置数据转发到 OBS

• 规则名称：iotdemo-obs-forwarding
• 数据来源：设备属性
• 触发事件：设备属性上报
• 转发目标：对象存储服务 OBS
• 区域：与 OBS 桶相同的区域
• 存储桶：选择已创建的桶

3.7 核对端到端闭环

四、验证与排障

4.1 上报失败，设备影子没有更新

{
  "services": [
    {
      "service_id": "BasicData",
      "properties": {
        "temperature": 25.0,
        "humidity": 60.0
      }
    }
  ]
}

4.2 设备连不上或一直显示离线

• 核对设备 ID 是否复制完整，没有多余空格。
• 核对设备密钥是否正确。
• 核对接入地址和端口是否符合当前实例要求。
• 检查真实设备所在网络能否访问 IoTDA 接入地址。
• 使用平台的消息跟踪功能，确认设备是否发出消息、平台是否收到。

4.3 命令发出了，但设备没有动作

• 平台是否成功下发？
• 设备是否成功执行并返回响应？

1. 收到命令。
2. 控制实际硬件。
3. 读取执行后的状态。
4. 返回结果。

4.4 数据没有进入 OBS

1. 数据转发规则是否已启动。
2. 规则的数据来源和触发事件是否匹配属性上报。
3. 是否已授权 IoTDA 访问目标 OBS 桶。
4. OBS 桶所在区域是否允许当前转发配置选择。
5. 再次上报数据后，观察规则执行状态和 OBS 新对象。

五、实践总结与后续扩展

• 设备有身份：通过产品模型、设备注册和密钥认证接入平台。
• 状态可表达：通过属性上报和固定 Topic 上传温湿度。
• 控制可闭环：云端下发命令，设备返回执行响应。
• 数据可落地：通过规则引擎把设备数据转发到 OBS。

1. 接入真实设备：移植 MQTT 客户端，使用设备 ID 和密钥建立连接。
2. 增加断网缓存：网络恢复后补传数据，降低数据丢失风险。
3. 增强数据安全：使用证书认证和加密传输，并定期更换凭证。
4. 增加数据处理：验证 SQL 数据流转规则，或使用 FunctionGraph 对数据做格式转换。
5. 建立设备联动：设置阈值规则，实现数据触发控制。
6. 对接业务应用：使用可信后端调用 IoTDA API，避免在页面或客户端中直接保存设备密钥。

结语