您现在的位置是：首页 >技术教程 >【物联网】华为云物联网开发实践-基于MQTT协议的智慧路灯(mqttfx)网站首页技术教程

00. 目录

01. 项目概述

以“智慧路灯”为示例，通过MQTT.fx的设备模拟器替代真实的设备，带您快速体验设备上报数据到物联网平台和远程下发控制命令到设备的全过程。

假设：路灯设备上报一条光照强度（luminance）消息；支持远程控制路灯开关状态的命令（switch），上报数据的格式为JSON格式。

02. 环境搭建

• 已注册华为云官方帐号。未注册可单击注册页面完成注册。
• 已完成实名制认证。未完成可在华为云上单击实名认证完成认证，否则无法使用设备接入功能。
• 已开通设备接入服务。未开通则访问设备接入服务，单击“立即使用”后开通该服务。

03. 业务流程

基于MQTT.fx体验平台功能是指以在MQTT.fx模拟器为例，介绍数据上报、命令下发等业务。

1. 创建产品。创建一个MQTT协议的产品。
2. 开发产品模型。通过定义产品模型，在物联网平台构建一款路灯设备，支持上报光照强度、下发路灯开关状态命令。
3. 注册设备。注册一个MQTT协议的设备，体验数据上报业务。
4. 连接鉴权。使用MQTT.fx激活在物联网平台上注册的设备。
5. 数据上报。使用MQTT.fx向物联网平台上报数据。
6. 命令下发。在管理控制台下发命令，远程控制设备。

04. 创建产品

4.1登录管理控制台，单击左侧导航栏“产品”，单击页面右上角的“创建产品”。

4.2 根据页面提示填写参数，然后单击“确定”。

05. 开发产品模型

5.1 找到创建产品章节新增的产品，单击产品进入产品界面。

5.2 在产品详情“模型定义”页面，单击“自定义模型”，配置产品的服务。

5.3 新增服务类型**“BasicData”**。

在“添加服务”页面，填写“服务ID”、“服务类型”和“服务描述”，单击“确定”。

• “服务ID”：BasicData
• “服务类型”：建议和服务ID保持一致
• “服务描述”：上报路灯数据

在“BasicData”服务列表右侧区域，单击“添加属性”，填写相关信息后，单击“确定”。

• “属性名称”：luminance
• “属性描述”：光照强度
• “数据类型”：int(整型)
• “访问权限”：可读、可写
• “取值范围”：0~65535
• “步长”：0
• “单位”：不填写

5.4 新增服务类型**“LightControl”**。

在“模型定义”下单击“添加服务”，填写“服务ID”、“服务类型”和“服务描述”，单击“确定”。

• “服务ID”：LightControl
• “服务类型”：建议和服务ID保持一致
• “服务描述”：路灯开关控制

在“LightControl”的下拉菜单下单击“添加命令”，输入命令名称“Switch”。

在“新增命令”页面，单击“新增输入参数”，填写相关信息后，单击“确定”。

06. 注册设备

6.1 在管理控制台页面，选择左侧导航栏“设备 > 所有设备”，单击页面右上角的“注册设备”。

6.2 根据页面提示信息填写参数，然后单击“确定”。

6.3 成功注册设备后，平台会自动生成设备ID和密钥，请妥善保管好设备ID（deviceId）和密钥（deviceSecret），用于设备接入。

07. 连接鉴权

使用MQTT.fx工具激活在物联网平台上注册的设备。

7.1 下载MQTT.fx（默认是64位操作系统，如果是32位操作系统，单击此处下载MQTT.fx），安装MQTT.fx工具。

7.2 访问这里，填写注册设备后生成的设备ID（DeviceId）和密钥（DeviceSecret），生成连接信息（ClientId、Username、Password）。

设备通过MQTT协议的connect消息进行鉴权，对于构造clientId的各个部分信息都必须包括进去，平台收到connect消息时，会判断设备的鉴权类型和密码摘要算法。

使用生成工具生成的clientId格式，默认不校验时间戳：设备ID_0_0_时间戳。

• 当采用“HMACSHA256”校验时间戳方式时，会先校验消息时间戳与平台时间是否一致，再判断密码是否正确。
• 当采用“HMACSHA256”不校验时间戳方式时，鉴权消息也必须带时间戳，但不检验时间是否准确，仅判断密码是否正确。

connect消息鉴权失败时，平台会返回错误，并自动断开MQTT链路。

7.3 打开MQTT.fx软件，单击设置图标。

7.4 参考下表配置鉴权参数，然后单击“Apply”。

7.5 单击“Connect”，设备鉴权成功后，在物联网平台可以看到设备处于在线状态。

08. 上报数据

使用MQTT.fx工具向物联网平台上报数据。

设备若通过MQTT通道上报数据，需要发给指定的topic，上报消息的topic格式为：$oc/devices/{device_id}/sys/properties/report，其中deviceId的值，对一机一密设备，使用deviceId接入时填写为设备注册成功后返回的deviceId值。

8.1 填写接口地址

此处以$oc/devices/{device_id}/sys/properties/report为例，

如$oc/devices/64798dbeec46a256bca53bc7_Test8888/sys/properties/report

8.2 在工具中间的空白处填写上报的数据。

请求参数

ServiceProperty定义表：

请求示例

{
    "services": [{
            "service_id": "BasicData",
            "properties": {
                "luminance": 80
        }
      }
   ]
}

8.3 单击“Publish”，可以在物联网平台上查看设备是否成功上报数据。

09. 命令下发

在管理控制台下发命令，远程控制设备。

9.1 选择“设备 > 所有设备”，找到注册设备章节新建的设备，单击“查看”进入设备详情页面。

9.2 单击“命令”页签，下发同步命令。

说明：

MQTT协议设备仅支持同步命令下发，NB-IoT设备仅支持异步命令下发。

9.3 可以在MQTT.fx模拟器端查看到下发的命令。

说明

• 由于MQTT.fx模拟器不支持查看下发的命令参数。具体下发内容，请参考平台命令下发。
• 界面提示命令下发失败，是因为下发的同步命令需要设备侧及时回响应，响应内容请参考平台命令下发。

按照本页面的指导，使用MQTT.fx模拟MQTT设备接入物联网平台后，您应该已经基本了解MQTT设备调用物联网平台开放的接口与平台交互。

10. 附录

参考：华为云社区