华为云用户手册

场景说明 微型气象是不可预测的，基本上不能通过人工手段来分析其变化，因此必须运用新技术，对气象进行实时监测，以便采取相应的措施来避免或解决事故的发生。而常规气象环境数据采集容易造成数据损失、人力成本高、数据安全性差、可追踪性差等问题。为解决上述问题，可以通过网关将设备采集的数据上报到华为云IoT平台，实现对现场设备数据的实时监控，您可通过华为云IoT平台实时查看现场温度、湿度、光照、风速等环境数据，并对数据进行转储、分析等处理，同时也能通过IoT平台对设备进行控制。本文以金鸽的R40设备为例进行演示。

设备简介 R40（如图2）负责将传感器的数据收集上来，上报到华为云IoT平台，同时负责将华为云IoT平台下发的控制信息下发给传感器。其中演示的传感器设备有如下三种： 1. 风速变送器（如图3）将采集到的风速通过电流信号输出给R40； 2. 气象多要素百叶箱（如图4）将采集到的噪声、光照、温湿度信息通过RS485口（Modbus协议）输出给R40。 3. 报警器（如图5）通过R40的DO口接收从华为云IoT下发给的控制信息。

创建产品 某一类具有相同能力或特征的设备的集合称为一款产品。除了设备实体，产品还包含该类设备在物联网能力建设中产生的产品信息、产品模型（Profile）等资源。下面，我们按照R40的基本特征，在控制台上创建R40产品。 访问 设备接入服务 ，单击“立即使用”进入设备接入控制台。 选择左侧导航栏的“产品”，然后单击左侧的“创建产品”，创建一个基于MQTT协议的产品，参考下表填写参数后，单击“确定”，完成产品的创建。 基本信息 所属资源空间 选择您需要归属到的资源空间 产品名称 自定义，如“R40” 协议类型 选择“MQTT” 数据格式 选择“JSON” 所属行业 无 设备类型 EnvironmentalMonitoringDevice 产品创建成功后，单击“查看详情”按钮进入产品界面，进行后面操作。

创建产品 登录管理控制台，单击左侧导航栏“产品”，单击页面左侧的“创建产品”。 根据页面提示填写参数，然后单击“确认”，完成产品的创建。 基本信息 所属资源空间 平台自动将新创建的产品归属在默认资源空间下。如需归属在其他资源空间下，下拉选择所属的资源空间。如无对应的资源空间，请先创建资源空间。 产品名称 为产品命名。产品名称在相同资源空间有唯一性。长度不超过64，只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合。 协议类型 选择MQTT。 数据格式 选择JSON。 所属行业 请根据实际情况选择。 设备类型 请根据实际情况选择。 高级配置 产品ID 定制ProductID，用于唯一标识一个产品。如果携带此参数，平台将产品ID设置为该参数值；如果不携带此参数，产品ID在 物联网平台 创建产品后由平台分配获得。 图3 创建产品-MQTT

开发产品模型 找到新增的产品，单击“查看”进入产品界面。 在产品详情“模型定义”页面，直接上传模型文件BearPi_Agriculture.zip。 在产品列表中，单击对应的产品，进入产品详情页。您可以查看产品ID、产品名称、设备类型、数据格式、厂商名称、所属资源空间、协议类型等产品基本信息。 产品创建成功后，您可以单击“删除”删除不再使用的产品。删除产品后，该产品下的产品模型、编解码插件等资源将被清空，请谨慎操作。

连接鉴权 参考连接鉴权接口文档，使用MQTT.fx工具激活在物联网平台上注册的设备。 下载MQTT.fx（默认是64位操作系统，如果是32位操作系统，单击此处下载MQTT.fx），安装MQTT.fx工具。 安装最新版MQTT.fx工具，可点击此处下载。 MQTT.fx 1.7.0及旧版本对带有$的主题（Topic）处理存在问题，请使用最新版本进行测试。 访问这里，填写注册设备后生成的设备ID（DeviceId）和密钥（DeviceSecret），生成连接信息（ClientId、Username、Password）。 DeviceSecret在此场景下可随意填写，如12345678。 图15 获取ClientId 参数 必选/可选 类型 参数描述 ClientId 必选 String(256) 一机一密的设备clientId由4个部分组成：设备ID、设备身份标识类型、密码签名类型、时间戳，通过下划线“_”分隔。 设备ID：指设备在平台成功注册后生成的唯一设备标识，通常由设备的产品ID和设备的NodeId通过分隔符“_”拼装而来。 设备身份标识类型：固定值为0，表示设备ID。 密码签名类型：长度1字节，当前支持2种类型： “0”代表HMA CS HA256不校验时间戳。 “1”代表HMACSHA256校验时间戳。 时间戳：为设备连接平台时的UTC时间，格式为YYYYMMDDHH，如UTC 时间2018/7/24 17:56:20 则应表示为2018072417。 Username 必选 String(256) 设备ID。 设备通过MQTT协议的connect消息进行鉴权，对于构造clientId的各个部分信息都必须包括进去，平台收到connect消息时，会判断设备的鉴权类型和密码摘要算法。 使用生成工具生成的clientId格式，默认不校验时间戳：设备ID_0_0_时间戳。 当采用“HMACSHA256”校验时间戳方式时，会先校验消息时间戳与平台时间是否一致，再判断密码是否正确。 当采用“HMACSHA256”不校验时间戳方式时，鉴权消息也必须带时间戳，但不检验时间是否准确，仅判断密码是否正确。 connect消息鉴权失败时，平台会返回错误，并自动断开MQTT链路。 打开MQTT.fx软件，单击“设置”图标。 图16 设置 填写“ Connection Profile” 相关信息。 图17 “General ”可以使用工具默认信息 参数名称 说明 Broker Address 填写从设备接入服务控制台获取的设备对接地址，此地址为域名信息。不能通过域名接入的设备，填写IP地址，详细请参考2中获取的。 Broker Port 为8883。 Cliend ID 设备cliendID，请参考2中获取。 单击“User Credentials”填写“User Name”。 图18 填写设备ID 参数名称 说明 User Name 即设备ID，请参考2中获取。 Password 使用X.509证书认证时不需要填写。 单击“SSL/TLS”配置鉴权参数，然后单击““Apply””。选择开启 “SSL/TLS”，勾选“ Self signed certificates”，配置相关证书内容。 图19 填写“SSL/TLS”相关参数 CA File为对应的CA证书。下载并获取证书（加载pem格式的证书），获取证书请根据需要在资源获取里下载。 Client Certificate File为设备的设备证书（deviceCert.pem）。 Client Key File为设备的私钥（deviceCert.key）。 单击“Connect”，设备鉴权成功后，在物联网平台可以看到设备处于在线状态。 图20 设备状态

创建产品 登录管理控制台，单击左侧导航栏“产品”，单击页面左侧的“创建产品”。 图2 产品-创建产品 根据页面提示填写参数，然后单击“确定”。 基本信息 所属资源空间 平台自动将新创建的产品归属在默认资源空间下。如需归属在其他资源空间下，下拉选择所属的资源空间。如无对应的资源空间，请先创建资源空间。 产品名称 自定义。支持字母、数字、下划线（_）、连字符（-）的字符组合。 协议类型 选择MQTT。 数据格式 选择JSON。 所属行业 请根据实际情况填写。若使用平台预置的产品模型，请根据产品模型所属的行业填写。没有填无。 设备类型 请根据实际情况填写。若使用平台预置的产品模型，会自动关联设备类型，不需要再输入设备类型。 高级配置 产品ID 定制ProductID，用于唯一标识一个产品。如果携带此参数，平台将产品ID设置为该参数值；如果不携带此参数，产品ID在物联网平台创建产品后由平台分配获得。 图3 创建产品-MQTT

开发产品模型 找到新增的产品，单击“产品”进入产品界面。 在产品详情“模型定义”页面，单击“自定义模型”，配置产品的服务。 新增服务类型“Connectivity”。 在“添加服务”页面，填写“服务ID”、“服务类型”和“服务描述”，单击“确定”。 “服务ID”：Connectivity “服务类型”：建议和服务ID保持一致 “服务描述”：Connectivity 图4 添加服务 在“Connectivity”的下拉菜单下单击“添加属性”，填写相关信息后，单击“确定”。 “属性名称”：dailyActivityTime “数据类型”：int（整型） “访问权限”：可读 “取值范围”：0~65535 “步长”：1 “单位”：s 图5 添加属性 新增服务类型“Battery”。 在“模型定义”下单击“添加服务”，填写“服务ID”、“服务类型”和“服务描述”，单击“确定”。 “服务ID”：Battery “服务类型”：建议和服务ID保持一致 “服务描述”：Battery 图6 添加服务 在““Battery””的下拉菜单下单击“添加属性”，填写相关信息后，单击“确定”。 “属性名称”：batteryLevel “数据类型”：int（整型） “访问权限”：可读 “取值范围”：0-100 “步长”：1 “单位”：% 图7 添加属性

制作设备CA调测证书 本文以Windows环境为例，介绍通过Openssl工具制作调测证书的方法，生成的证书为PEM编码格式的证书。 在浏览器中访问这里，下载并进行安装OpenSSL工具。 以管理员身份运行cmd命令行窗口。 执行cd c:\openssl\bin（请替换为openssl实际安装路径），进入openssl命令视图。 执行以下命令生成密钥对。 openssl genrsa -out rootCA.key 2048 执行以下命令，使用密钥对中的私有密钥生成 CA 证书。 openssl req -x509 -new -nodes -key rootCA.key -sha256 -days 1024 -out rootCA.pem 系统提示您输入如下信息，所有参数可以自定义。 Country Name (2 letter code) [AU]：国家，如CN。 State or Province Name (full name) []: 省份，如GD。 Locality Name (for example, city) []:城市，如SZ。 Organization Name (for example, company) []：组织，如Huawei。 Organizational Unit Name (for example, section) []：组织单位，如IoT。 Common Name (e.g. server FQDN or YOUR name) []: 名称，如zhangsan。 Email Address []:邮箱地址，如1234567@163.com。 在openssl安装目录的bin文件夹下，获取生成的CA证书（rootCA.pem）。

获取设备接入信息 在设备接入服务控制台获取设备接入平台所需的信息。 访问设备接入服务，单击管理控制台进入控制台。 单击管理控制台进入控制台，单击左侧导航栏的“总览”，点击“实例基本信息 - 接入信息”查看设备接入信息，记录域名和端口。 图1 进入平台接入地址 针对不支持用域名接入的设备，通过在cmd命令框中执行“ping 域名”获取IP地址，用IP地址接入平台。由于IP地址不固定，您需要将IP地址做成可配置项。

验证操作 您可以使用配置设备接入服务时注册的真实设备接入平台，上报“temperature”大于80的数据。 您也可以使用模拟器模拟设备订阅Topic: “$oc/devices/{device_id}/sys/properties/report”（其中{deviceId}需要替换成实际设备ID）后，上报“temperature”大于80的数据，操作方法请参考在线开发MQTT协议的智慧路灯。 您还可以使用虚拟设备进行在线调试，上报“temperature”大于80的数据。 期望结果： 若您使用真实设备上报数据，设备会收到一条“power”取值为“OFF”的“ON_OFF”命令。 若您使用模拟器上报数据，可在“Subscribe”页签查看到平台下发的“power”取值为“OFF”的“ON_OFF”命令。

连接鉴权 使用MQTT.fx工具激活在物联网平台上注册的设备。 下载MQTT.fx（默认是64位操作系统，如果是32位操作系统，单击此处下载MQTT.fx），安装MQTT.fx工具。 访问这里，填写注册设备后生成的设备ID（DeviceId）和密钥（DeviceSecret），生成连接信息（ClientId、Username、Password）。 参数 必选/可选 类型 参数描述 ClientId 必选 String(256) 一机一密的设备clientId由4个部分组成：设备ID、设备身份标识类型、密码签名类型、时间戳，通过下划线“_”分隔。 设备ID：指设备在平台成功注册后生成的唯一设备标识，通常由设备的产品ID和设备的NodeId通过分隔符“_”拼装而来。 设备身份标识类型：固定值为0，表示设备ID。 密码签名类型：长度1字节，当前支持2种类型： “0”代表HMACSHA256不校验时间戳。 “1”代表HMACSHA256校验时间戳。 时间戳：为设备连接平台时的UTC时间，格式为YYYYMMDDHH，如UTC 时间2018/7/24 17:56:20 则应表示为2018072417。 Username 必选 String(256) 设备ID。 Password 必选 String(256) 加密后的设备密钥。Password的值为使用“HMACSHA256”算法以时间戳为密钥，对secret进行加密后的值。 secret为注册设备时平台返回的secret。 设备通过MQTT协议的connect消息进行鉴权，对于构造clientId的各个部分信息都必须包括进去，平台收到connect消息时，会判断设备的鉴权类型和密码摘要算法。 使用生成工具生成的clientId格式，默认不校验时间戳：设备ID_0_0_时间戳。 当采用“HMACSHA256”校验时间戳方式时，会先校验消息时间戳与平台时间是否一致，再判断密码是否正确。 当采用“HMACSHA256”不校验时间戳方式时，鉴权消息也必须带时间戳，但不检验时间是否准确，仅判断密码是否正确。 connect消息鉴权失败时，平台会返回错误，并自动断开MQTT链路。 打开MQTT.fx软件，单击设置图标。 参考下表配置鉴权参数，然后单击“Apply”。 参数名称 说明 Broker Address 填写从设备接入服务控制台获取的平台对接信息，此接入地址为域名信息。不能通过域名接入的设备，通过在cmd命令框中执行“ping 域名”获取IP地址，用IP地址接入平台。由于IP地址不固定，您需要将IP地址做成可配置项。 Broker Port 默认为1883。 Cliend ID 设备cliendID，请参考2中获取。 User Name 即设备ID，请参考2中获取。 Password 加密后的设备密钥，请参考2中获取。 单击“Connect”，设备鉴权成功后，在物联网平台可以看到设备处于在线状态。 图11 设备在线

开发产品模型 找到新增的产品，单击产品进入产品界面。 在产品详情“模型定义”页面，单击“自定义模型”，配置产品的服务。 图3 自定义模型-MQTT 新增服务类型“BasicData”。 在“添加服务”页面，根据页面提示填写“服务ID”、“服务类型”和“服务描述”，单击“确定”。 图4 添加服务-BasicData 在“BasicData”服务列表右侧区域，单击“新增属性”，填写相关信息后，单击“确定”。 图5 新增属性-luminance 新增服务类型“LightControl”。 在“模型定义”下单击“添加服务”，根据页面提示填写后，单击“确定”。 “服务ID”：LightControl “服务类型”：建议和服务ID保持一致 “服务描述”：路灯开关控制 在“LightControl”的下拉菜单下单击“添加命令”，输入命令名称“Switch”。 图6 新增命令-Switch 在“新增命令”页面，单击“新增输入参数”，填写相关信息后，单击“确定”。 图7 新增命令参数-value

场景说明 在物联网场景下，部分设备具备重要的应用场景，比如物联网网关等，设备管理者需要感知这些设备的上下线情况。 设备接入服务提供规则引擎功能可以满足该诉求，您可以通过简单的操作实现当设备状态满足某个条件时，物联网平台触发指定动作进行通知。 示例说明： 某企业的网关产品下有一批网关设备，单个网关设备下挂载了约400个子设备，用户需要实时关注这批网关设备的状态，确保子设备正常上报数据，同时由于网关设备和物联网平台通过4G网络建立连接，存在由于网络抖动导致频繁告警的问题，因此用户认为短暂的离线后上线属于正常场景，不希望感知这种场景。 通过以下示例可以实现监控该网关产品下所有网关设备在离线持续时间达到5分钟后通过物联网平台上报告警，在设备上线持续时间达到1分钟后恢复该告警，同时发送邮件或短信通知给指定的手机号码。

业务实现 使用MQTT.fx模拟设备接入平台，详情请参考连接鉴权。 用MQTT.fx订阅平台下行信息Topic，MQTT.fx会收到平台服务端下发的查询版本命令。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 请参考平台下发获取版本信息通知 图10 订阅通知 通过MQTT.fx上报软固件版本信息。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 请参考设备上报软固件版本 示例 Topic: $oc/devices/{device_id}/sys/events/up 数据格式： { "object_device_id": "{object_device_id}", "services": [{ "service_id": "$ota", "event_type": "version_report", "event_time": "20151212T121212Z", "paras": { "sw_version": "v1.0", "fw_version": "v1.0" } }] } 图11 上报版本号 上报完版本号后，模拟器会接收到平台下发的升级通知，通知信息如下： Topic 上行: $oc/devices/{device_id}/sys/events/down 参数说明 请参考平台下发升级通知 图12 获取升级通知 设备收到升级通知后，可通过Http请求下载升级包。 本次演示使用Curl命令代替。 图13 下载升级包 示例 curl -X GET -H "Authorization:Bearer ****************************" "https://100.93.28.202:8943/iodm/dev/v2.0/upgradefile/applications/ddecccc223574aee9466fe8f7e16a205/devices/6079042873515a02c16ffd82_123456789/packages/4f201f38c281ca5d40794a3f" -v -k 应在http附加请求消息头（header）字段附加Authorization信息，其值为“Bearer {access_token}”，其中{access_token}为收到的升级通知中的access_token。Bearer和{access_token}之间有一个空格。 如果event_type为firmware_upgrade_v2、software_upgrade_v2，则在请求下载软固件包时不需要携带请求头。请求示例如下： GET https://******.obs.cn-north-4.myhuaweicloud.com:443/test.bin?AccessKeyId=DX5G7W********* 设备上报升级状态 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 请参考设备上报升级状态 示例 Topic: $oc/devices/{device_id}/sys/events/up 数据格式： { "object_device_id": "{object_device_id}", "services": [{ "service_id": "$ota", "event_type": "upgrade_progress_report", "event_time": "20151212T121212Z", "paras": { "result_code": 0, "progress": 50, "version": "V1.0", "description": "upgrade processing" } }] } 如下图所示上报升级进度为50%，可以在平台查询到升级进度为50%。 图14 上报升级进度50% 图15 任务详情-Test_upgrade_1-升级进度 完成升级 上报升级进度为100%，且当前版本为升级的目标版本，可以在平台查询到升级完成。 图16 上报升级进度100% 图17 软固件升级-固件升级

场景说明 MQTT（Message Queuing Telemetry Transport）是一个基于客户端-服务器的消息发布/订阅传输协议，主要应用于计算能力有限，且工作在低带宽、不可靠的网络的远程传感器和控制设备，适合长连接的场景，如智能路灯等。固件升级功能是网络设备所必须支持的基础服务。在设备固件出现安全漏洞、软件bug维护、自身功能优化、以及设备性能改良等需更新固件时，在线升级功能就尤为重要。本文档通过MQTT.fx模拟固件设备，使用华为云平台对该固件进行设备升级。 软件升级流程和固件升级流程一样，只是在设备上报版本号时对应参数字段不一样。固件升级上报版本号对应参数字段为fw_version，软件升级上报版本号对应参数字段为sw_version,请参考设备上报版本号

使用AT指令定位模组通信问题 IoT Link在与物联网平台连接使用时，可使用AT指令快速定位模组与云端连通性问题，提高开发效率。本节将以“小熊派开发板”为例，介绍如何使用AT指令检测通信模组常见问题，如设备无法上线，数据上报不成功等。 小熊派开发板和电脑已正常连接（确保驱动已安装），并将开发板右上角的拨测开关切换到AT-PC模式。 单击VSCode底部工具栏的“Serial”。 选择4.b中查看的端口号，波特率设置为9600，然后单击“打开”。 输入“AT+CGATT?”，然后单击“发送”，若返回“+CGATT:1”，表示网络附着成功（附着成功代表NB-IoT联网正常），返回“+CGATT:0”表示网络附着失败（附着失败代表NB-IoT联网异常），请查看SIM卡是否插入正确，或联系运营商检查网络状态。 使用AT指令检测完模组通信后，请将拨测开关拨到AT-MCU模式，以便完成控制台的开发后，将采集到的传感器数据通过通信模组发送到平台。 PC模式是开发板与电脑串口通信，AT指令读写开发板的状态等数据；MCU模式是开发板通过模组上插的SIM连接网络，实现NB-IoT通信。

安装IoT Link Studio插件 IoT Link Studio是针对IoT物联网端侧开发的IDE环境，提供了编译、烧录、调试等一站式开发体验，支持 C、 C++、汇编等多种开发语言，让您快速、高效地进行物联网开发。 以win10为例，获取电脑的系统配置：在运行窗口中输入pc，然后单击“属性”，查看系统配置，因为后续安装软件要选择操作系统。 图3 获取系统配置 访问 这里 ，根据您电脑系统配置，下载匹配的Visual Studio Code并安装。（本文以windows 10 64-bit系统Visual Studio Code为例。请下载1.49版本，其他版本不支持IoT Link）。 图4 下载Visual Studio Code 注：Visual Studio Code不支持苹果Mac系统。 安装成功后，打开VSCode 插件应用商店，搜索 IoT Link 找到IoT Link，然后单击安装。 图5 安装 首次启动配置。 IoT Link Studio 首次启动时会自动从网络下载最新的SDK包以及gcc依赖环境，请确保您的网络可用。安装过程中请不要关闭窗口，耐心等待。安装完成后重启VSCode使插件生效。 若您的网络需要配置代理，请在VSCode主页，选择左下角-设置-应用程序-代理服务器，在Proxy Support下拉框中选择“on”。 假如下载SDK包及gcc依赖环境失败，请手动下载SDK包，放到C:\Users\${用户名}\.iotlink\sdk目录下,文件名修改为IoT_LINK。放置完后，重新打开VSCode即可。目录格式如下图： 图6 SDK下载失败 图7 SDK存放目录

编译并烧录代码 由于提供的demo样例中已配置好和华为云物联网平台的对接信息，您可以直接编译（代码不用做任何修改），并烧录到小熊派开发板MCU，节省开发时间。 单击VSCode底部工具栏的“Build”，等待系统编译完成。编译成功后，界面显示“编译成功”。 使用USB数据线，将小熊派开发与电脑连接，开发板右上角的拨测开关拨到右侧“AT-MCU模式”。 单击VSCode底部工具栏的“Download”，等待系统烧录完成。烧录成功后，界面显示“烧录成功”。 如果显示烧录失败，可能是开发板没有驱动导致与电脑无法串口通信，请参考2检查ST-Link驱动是否安装成功，如果驱动未安装，则参考这里下载并安装ST-Link驱动。 （可选）安装ST-Link驱动。 访问ST官网，下载ST-Link驱动，双击stlink_winusb_install.bat文件进行自动安装。（本文以Windows10-64bit ST-Link 2.0.1为例）。 注：您也可以使用适配您系统版本的exe文件进行安装。 打开PC设备管理器可查看对应的驱动是否安装成功。若下图所示，表明驱动安装成功。

注册设备 本文介绍集成NB模组设备的注册方法。 在产品详情页面，选择“在线调试”，单击“新增测试设备”，此处新增的是非安全的NB-IoT设备。 在新增测试设备页面，选择“真实设备”，完成设备参数的填写后，单击“确定”。 图17 在线调试-新增测试设备 设备名称：自定义。 设备标识码：设备的IMEI号，用于设备在接入物联网平台时携带该标识信息完成接入鉴权，可在NB模组上查看。您也可以将拨测开关拨到AT-PC模式，选择STM的端口，波特率设置为9600，输入指令“AT+CGSN=1”获取IMEI号。 注：获取IMEI注册完设备后，需要将开发板的拨测开关拨到“AT-MCU”模式，因为开发板在MCU模式下才会通过NB卡连接网络。 设备注册方式：不加密。 设备创建成功，可在页面看到创建的设备。

配置IoT link Studio工程 单击VSCode底部工具栏的“Home”。 Home：管理IoT Link工程； Serial：输入AT指令检查开发板状态； Build：编译示例代码（步骤3后可见）； Download：把编译后的代码烧录到MCU（步骤3后可见）。 配置交叉编译工具链。在弹出界面中单击“IoT Link设置”，选择工具链，若GCC工具目录或文件不存在，点击下载安装。 图8 IoT Link设置 图9 交叉编译工具链 小熊派STM32431下载的编译工具链版本为win32.zip。 在弹出界面中单击“创建 IoT 工程”，输入工程名称，工程目录，并选择开发板的硬件平台和示例工程模板。 工程名称：自定义，如Smoke。 工程目录：可以使用工具安装的默认路径，也可以选择系统盘以外的其他盘，如D:\。 硬件平台：当前提供的demo只适配STM32L431_BearPI硬件平台，请选择STM32L431_BearPI。 示例工程：本示例中，我们以智慧烟感为例，请选择oc_smoke_template demo，否则烧录的demo样例和在控制台定义的产品模型不匹配，无法上报数据。单击“确定”，导入完成。 单击“确定”，导入完成。

定义产品模型 在产品详情，“模型定义”页面，单击“自定义模型”，配置产品的服务。具体创建方法可见： 产品模型设计思路： 表1 设备服务列表 服务类型（ServiceID） 服务描述 Smoke 实时检测烟雾状况 服务能力如表2、表3所示。 表2 Smoke 能力描述 属性名称 数据类型 数据范围 属性列表 Smoke value int 0 ~ 65535 表3 Smoke命令列表 能力描述 命令名称 命令字段 字段名称 类型 数据长度 枚举 命令列表 Smoke control beep 下发命令 beep string 3 ON、OFF 响应命令 beep_state int / /

创建产品 某一类具有相同能力或特征的设备的集合称为一款产品。除了设备实体，产品还包含该类设备在物联网能力建设中产生的产品信息、产品模型（Profile）、插件等资源。 登录管理控制台，单击左侧导航栏“产品”，单击页面左侧的“创建产品”。 图10 产品-创建产品 创建一个协议类型为LwM2M/CoAP协议、设备类型为SmokeSensors的产品，参考页面提示填写参数后，单击“确定”。 图11 创建产品-CoAP

场景说明 近年来，火灾频发，造成很大的人员及财产损失，国家高度重视，陆续出台相关文件，明确相关要求，落实消防安全责任。同时，人民消防意识逐渐提高，独立烟感得到一定程度的普及，在防火减灾方面起到一定的作用。但由于独立烟感产品存在一定的局限，例如人不在场收不到报警信息，工作状态不能实时掌握，独立烟感没有完全解决这些问题。 NB-IoT智慧烟感解决了传统烟感器布线难、电池使用周期短、维护成本高、无法与业主及消防机构交互等缺点。智慧烟感采用无线通信，具备即插即用、无需布线、易于安装等特点。 在该文档中，我们基于华为一站式开发工具平台（VS code工具IoTlink插件），从设备（小熊派开发套件）、平台（IoTDA华为物联网平台）、端到端构建一款智慧烟感解决方案样例，带您体验十分钟快速上云。实现智慧烟感检测并上报烟雾浓度值，显示在IoTDA控制台，并在IoTDA控制台远程控制蜂鸣器开关的功能。

小熊派开发板简介 开发板在物联网系统架构中属于感知设备，该类设备通常由传感器、通信模组、芯片以及操作系统组成。为增加开发板的可扩展性，小熊派开发板没有采用传统的板载设计，而是使用了可更换传感器扩展板以及可更换通信模组扩展板设计，通信模组是数据传输的出入口，常用的通信模组包括NB-IoT，Wifi以及4G等，芯片是设备的主控设备，该开发板内置了一个低功耗的STM32L431单片机作为主控芯片，即MCU。操作系统使用的是华为的LiteOS操作系统，其提供了丰富的端云互通组件。 为了便于开发调试，如图1所示，该开发板板载了2.1版本的ST-Link，它具有在线调试烧录，拖拽下载以及虚拟串口等功能。开发板中间板载一块分辨率为240 * 240的LCD屏幕，其主要用于显示传感器数据以及调试日志。LCD屏幕下方是主控芯片。 开发板右上角具有一个拨码开关，将其拨至左侧AT-PC模式，通过电脑端的串口助手，发送AT指令调试通信模组。右侧AT-MCU模式，通过MCU发送AT指令与通信模组进行交互，将采集到的传感器数据通过通信模组发送到云端。 图1 小熊派开发板

场景说明 在物联网解决方案中，针对庞大的数据进行自动学习时，需要对海量数据进行标注、训练，按照传统的方式进行标注、训练不仅耗时耗力，而且对资源消耗也是非常庞大的。华为云物联网平台可以通过规则引擎，将数据转发到华为云其他云服务，可实现将海量数据通过 函数工作流 （FunctionGraph）进行处理，再将数据流入 AI开发平台 （ModelArts）进行AI分析，并将分析结果统一转发至HTTP服务器中。 图1 场景说明 在本示例中，我们实现以下场景： 设备上报银行客户特征信息，物联网平台将数据转发至FunctionGraph，由FunctionGraph转发至ModelArts进行AI分析，最终将分析的结果转发至HTTP服务器中。

模拟数据上报及结果验证 使用MQTT模拟器连接到平台（模拟器使用请参考：使用MQTT.fx调测）。 使用模拟器进行消息上报，详情请参考：设备消息上报。 上报内容如下： { "age": "34", "profession": "blue-collar", "maritalStatus": "single", "educationalStatus": "tertiary", "realEstateSituation": "no", "loanStatus": "tertiary" } 查看HTTP服务器是否收到预测结果。 图17 查看消息

前提条件 已注册华为官方账号。未注册可参考注册华为账户完成注册。 已完成实名制认证。未完成可在华为云上单击实名认证完成认证，否则会影响后续云服务的开通。 已开通设备接入服务。未开通则访问设备接入服务，单击“免费试用”或单击“价格计算器”购买并开通该服务。 已开通FunctionGraph服务。未开通则访问FunctionGraph服务，单击“立即使用”后开通该服务。 已开通ModelArts服务。未开通则访问AI开发平台，单击“控制台”后进入该服务。 自建一个HTTP服务器，并提供POST接口用来接收推送的数据（本示例默认已经提供好相应的服务器与接口，不再展示如何搭建HTTP服务器指导）。

MQTT设备消息下发 本示例通过使用postman，下发开启室内空调指令。 使用MQTT.fx模拟器，订阅自定义Topic。 确保创建自定义Topic时，设备操作权限包含“订阅”功能，详细操作请参考自定义Topic。 使用IoT Device SDK或者原生MQTT协议接入的设备，需要在设备程序中，设置设备订阅的自定义Topic名称。 使用postman工具模拟应用侧调用下发设备消息接口，下发开启室内空调的命令。 调用查询设备消息接口，查看下发命令是否成功。若命令下发成功，室内空调将会被开启。

数据上报及验证数据是否转发成功 使用MQTT模拟器连接到平台（模拟器使用请参考：使用MQTT.fx调测）。 使用模拟器进行属性上报(参考：设备属性上报)。 上报内容如下： { "services": [{ "service_id": "order", "properties": { "orderID": "0000001", "area": "南山区", "orderTime": "20220815T121215Z", "goods": "商品01", "amount": 30.5 }, "event_time": "20220815T121215Z" } ] } 前往OBS控制台，查看转发目标设置的文件是否生成。 图7 查看OBS桶内文件