华为云用户手册

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

创建产品 某一类具有相同能力或特征的设备的集合称为一款产品。除了设备实体，产品还包含该类设备在物联网能力建设中产生的产品信息、产品模型（Product Model）、编解码插件等资源。下面，我们按照小熊派智慧路灯的基本特征，在控制台上创建智慧路灯产品。 登录管理控制台，选择您的实例，单击实例卡片进入。单击左侧导航栏“产品”，单击页面左侧的“创建产品”。 图10 产品-创建产品 创建一个协议类型为LwM2M/CoAP协议、设备类型为StreetLamp的产品，参考页面提示填写参数后，单击“确定”。 图11 创建产品-CoAP

更多参考 开发产品模型 在产品详情“基本信息”页面，单击“自定义模型”，配置产品的服务。 产品模型设计思路： 表1 设备服务列表 服务类型（ServiceID） 服务描述 Button 实时按键检测 LED LED灯控制 Sensor 实时检测光照强度 Connectivity 实时检测信号质量 服务能力如下表所示。 表2 Button 能力描述 属性名称 数据类型 数据范围 属性列表 toggle int 0 ~ 65535 表3 LED命令列表 能力描述 命令名称 命令字段 字段名称 类型 数据长度 枚举 命令列表 Set_LED 下发命令 LED string 3 ON、OFF 响应命令 Light_state string 3 ON、OFF 表4 Sensor 能力描述 属性名称 数据类型 数据范围 属性列表 luminance int 0 ~ 65535 表5 Connectivity 能力描述 属性名称 数据类型 数据范围 属性列表 SignalPower int -140 ~ -44 ECL int 0 ~ 2 SNR int -20 ~ 30 CellID int 0 ~ 65535

编译并烧录代码 由于提供的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设备管理器可查看对应的驱动是否安装成功。若下图所示，表明驱动安装成功。

上传产品模型 产品模型是用来描述设备能力的文件，通过JSON的格式定义了设备的基本属性、上报数据和下发命令的消息格式。定义产品模型，即在物联网平台构建一款设备的抽象模型，使平台理解该款设备的功能。我们已提供开发好的产品模型，帮助您快速体验上云流程，如果您想体验产品模型的开发流程，可参考开发产品模型。 操作步骤： 找到新增的产品，单击产品进入产品界面。 在产品详情“基本信息”页面，单击“上传模型文件”。 图12 上传产品模型-CoAP 在弹出的页面中，上传提供的产品模型（本示例的产品模型），然后单击“确定”。 图13 上传模型文件-CoAP

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

场景说明 智慧路灯是城市智能化道路上重要一环，智慧路灯的实施具有节约公共照明能耗、减少因照明引起的交通事故等多种社会意义。路灯也是大家在日常生活中可以强烈感知到的公共设施，更易理解其智能化的场景。 在该文档中，我们基于华为一站式开发工具平台（VS code工具IoTlink插件），从设备（小熊派开发套件）、平台（IoTDA华为物联网平台）、端到端构建一款智慧路灯解决方案样例，带您体验十分钟快速上云。实现智慧路灯检测并上报光照强度，显示在IoTDA控制台，并在IoTDA控制台远程控制LED灯开关的功能。

安装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存放目录

配置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 工程”，输入工程名称，工程目录，并选择开发板的硬件平台和示例工程模板。 工程名称：自定义，如QuickStart。 工程目录：可以使用工具安装的默认路径，也可以选择系统盘以外的其他盘，如D:\。 硬件平台：当前提供的demo只适配STM32L431_BearPI硬件平台，请选择STM32L431_BearPI。 示例工程：本示例中，我们以智慧路灯为例，请选择oc_streetlight_template，否则烧录的demo样例和在控制台定义的产品模型不匹配，无法上报数据。如果您需要适配智慧烟感等其他场景，请选择对应的oc_smoke_template demo样例。 单击“确定”，导入完成。

业务实现 使用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://**.**.**.**:8943/iodm/dev/v2.0/upgradefile/applications/********/devices/********/packages/********" -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,请参考设备上报版本号

创建煤气监测产品 访问 设备接入服务 ，单击“立即使用”进入设备接入控制台。选择您的实例，单击实例卡片进入。 选择左侧导航栏的“产品”。 单击左侧的“创建产品”，创建煤气浓度监测产品，填写参数后，单击“确定”。 表1 创建产品参数示例 基本信息 产品名称 自定义，如gasdevice。 协议类型 选择“MQTT” 数据格式 选择“JSON” 所属行业 自定义 设备类型 在基本信息页面，单击“自定义模型”，参考下表，完成产品模型配置。gaslevel服务用于监控煤气浓度，windowswitch服务用于执行开关窗命令。 表2 煤气浓度监测产品模型参数示例 服务ID 参数类型 添加参数说明内容 gaslevel 属性 属性名称：gaslevel 数据类型：int 访问权限：可读 取值范围：0~100 windowswitch 命令 命令名称：switch 下发参数名称：switch 数据类型：enum 枚举值：on，off

验证操作 方法一： 您可以使用MQTT.fx模拟设备验证。 使用MQTT.fx分别模拟煤气探测器设备和推窗器，并连接到物联网平台。操作方法请参考在线开发MQTT协议的模拟智慧路灯。 打开模拟推窗器的MQTT.fx，订阅平台下发的命令。 选择“Subscribe”页签。 输入订阅平台下发命令的Topic=$oc/devices/{device_id}/sys/commands/#（其中与步骤2获取的设备ID保持一致。）。 单击“Subscribe”按钮，完成平台命令下发订阅。 图5 创建MQTT订阅 切换到模拟煤气探测的MQTT.fx，上报属性。 选择“Publish”页签。 输入属性上报的Topic：“$oc/devices/{device_id}/sys/properties/report（其中{deviceId}与步骤1获取的设备ID保持一致。）。 上报1条“gaslevel”大于6的属性。 样例： { "services": [{ "service_id": "gaslevel", "properties": { "gaslevel": 45 } } ] } 单击“Publish”按钮上报属性值。 图6 MQTT属性上报 切换到模拟推窗器的MQTT.fx，选择“Subscribe”页签。可以看到收到平台下发的“switch”取值为“on”的命令。 图7 查看下发命令 方法二： 您可以使用配置设备接入服务时注册的真实设备接入平台，上报“gaslevel”大于6的数据。设备会收到一条“switch”取值为“on”的命令，自动推开窗户。

使用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通信。

注册设备 本文介绍集成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 / /

安装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设备管理器可查看对应的驱动是否安装成功。若下图所示，表明驱动安装成功。

创建产品 某一类具有相同能力或特征的设备的集合称为一款产品。除了设备实体，产品还包含该类设备在物联网能力建设中产生的产品信息、产品模型（Product Model）、插件等资源。 登录管理控制台，选择您的实例，单击实例卡片进入。单击左侧导航栏“产品”，单击页面左侧的“创建产品”。 图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 小熊派开发板

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

模拟数据上报及结果验证 使用MQTT模拟器连接到平台（模拟器使用请参考：使用MQTT.fx调测）。 使用模拟器进行属性上报(参考：设备属性上报)。 上报内容如下： { "services": [{ "service_id": "order", "properties": { "orderID": "0000002", "area": "罗湖区", "orderTime": "20220815T121215Z", "goods": "商品02", "amount": 30.5 }, "event_time": "20220815T121215Z" } ] } 打开 数据可视化 服务查看数据是否刷新。 图15 结果查看

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

创建产品和设备 访问设备接入服务，单击“立即使用”进入设备接入控制台。 选择左侧导航栏的“产品”，在搜索框中选择新建产品所属的资源空间。 单击左侧的“创建产品”，创建一个基于MQTT协议的产品，填写参数后，单击“确定”。 图3 创建产品-MQTT 为上一步创建的产品导入产品模型，请参考导入产品模型。 选择第3步创建的产品，在该产品下注册设备、请参考注册单个设备。 本文中使用的产品模型和设备仅为示例，您可以使用自己的产品模型和设备进行操作。

示例场景 在本示例中，我们实现下述场景： 设备上报数据到物联网平台，物联网平台将数据以 CS V格式存储到 对象存储服务 （OBS），数据可视化服务( DLV )从OBS文件读取数据并展现为多个维度的报表。 操作步骤如下： 在物联网平台创建产品和设备：创建MQTT协议产品、开发产品模型、并注册设备。 在物联网平台进行数据转发规则配置：创建数据转发规则，将数据以CSV格式持久化至OBS服务。 数据上报及验证数据是否转发成功。 配置数据可视化服务（DLV）：展示OBS中物联网数据。 模拟数据上报及结果验证：使用设备模拟器上报数据，验证DLV大屏数据实时刷新。 图1 示例说明

使用虚拟设备在线调试 在智慧路灯产品的开发空间，选择“在线调试”，单击“新增测试设备”。 在新增测试设备页面，选择“虚拟设备”，然后单击“确定”，创建一个虚拟设备。虚拟设备名称包含 “DeviceSimulator”字样，每款产品下只能创建一个虚拟设备。 图22 在线调试-创建虚拟设备 单击“调试”，进入调试界面。 图23 在线调试-进入调试 模拟设备数据上报场景，在设备模拟器中，输入十六进制码流：002000（00为地址域meaasgeID，长度为1个字节；20表示光照强度，长度为1个字节；00表示路灯开关状态为关闭状态，长度为1个字节），然后单击“发送”，我们可以在应用模拟器中看到转换为JSON格式的数据为："Light_Intensity":32, "Light_Status":0。 图24 在线调试-模拟数据上报 模拟远程下发控制命令场景，在应用模拟器中，选择服务：StreetLight，命令：SWITCH_LIGHT，命令取值为：ON，单击“发送”，我们可以在设备模拟器中看到转换为十六进制的码流：0100014F4E（经ASCLL码转为为十六进制）。 图25 在线调试-模拟命令下发

在线开发插件 通常情况下设备为了省电，设备会采用“二进制”格式上报数据，编解码插件的作用就是将设备上报的“二进制”格式数据，按照产品模型文件的定义的属性转换为“JSON”格式数据，便于物联网平台和应用服务器识别。同时，用户远程下发控制命令时，物联网平台会将“JSON”格式的命令转换为“二进制”格式数据下发给设备。 如果设备本身上报的是JSON格式数据，则不需要定义编解码插件。 在智慧路灯产品的开发空间，选择“插件开发”，单击“图形化开发”。 单击“新增消息”，配置数据上报消息，上报路灯的数据消息。 消息名：LightData 消息类型：数据上报 添加响应字段：是。添加响应字段后，物联网平台在收到设备上报的数据后，会下发用户设置的响应数据到设备。 响应数据：AAAA0000（默认） 图7 插件开发-新增消息 单击“添加字段”，添加messageId字段，表示消息种类。 图8 插件开发-添加字段messageId 添加LightIntensity字段，表示光照强度，数据类型：int8u（8位无符号整型），长度：1字节。 图9 插件开发-添加字段LightIntensity 添加LightStatus字段，表示路灯上报的路灯开关状态数据。数据类型：int8u（8位无符号整型），长度：1字节。 图10 插件开发-添加字段LightStatus 再次单击“新增消息”，定义远程控制路灯开关的命令对应的编解码插件消息。 消息名：SwitchStatus 消息类型：命令下发 添加响应字段：是。添加响应字段后，设备在接收命令后，会上报命令执行结果。 图11 插件开发-新增消息SwitchStatus 单击“添加字段”，添加messageId字段，表示消息种类。 图12 插件开发-添加字段messageId 添加mid字段，用于将下发的命令和命令执行结果进行关联。 图13 插件开发-添加命令字段mid 添加SwitchStatus字段，数据类型：string（字符串类型），长度：3字符。 图14 插件开发-添加命令字段SwitchStatus 单击“添加响应字段”，配置命令下发响应消息。 添加messageId，表示消息种类。命令执行结果为上行消息，需要通过messageId和数据上报消息进行区分。 图15 插件开发-添加响应字段messageId 添加mid字段，用于将下发的命令和命令执行结果进行关联。 图16 插件开发-添加响应字段mid 添加errcode字段，用于表示命令执行状态：00表示成功，01表示失败，如果未携带该字段，则默认命令执行成功。 图17 插件开发-添加响应字段errcode 添加result字段，用于表示命令执行结果。 图18 插件开发-添加响应字段result 拖动右侧“产品模型”区域的属性字段和命令字段（产品模型文件定义的字段），与编解码插件定义的数据上报消息和命令下发消息的相应字段建立映射关系。 图19 插件开发-在线开发插件 编解码插件与产品模型文件建立映射完成后，单击右上角“保存”，并单击“部署”，完成编解码插件的部署。

使用真实设备在线调试 模拟器在线调测具备设备模拟和应用模拟功能，可以对定义的产品模型文件和编解码插件进行调试，用户可以直观的感受设备上报数据到物联网平台，以及使用物联网平台下发远程控制命令。 在智慧路灯产品的开发空间，选择“在线调试”，单击“新增测试设备”。 在新增测试设备页面，完成设备参数的填写后，单击“确定”。 设备类型：真实设备。 设备名称：自定义。 设备标识码：设备的IMEI号，用于设备在接入物联网平台时携带该标识信息完成接入鉴权，可在NB模组上查看。 密钥：如果使用DTLS传输层安全协议接入时，且请妥善保存密钥。 图20 在线调试-新增测试设备 新添加的设备处于未激活状态，此时不能进行在线调试，可参考连接鉴权，待设备接入平台后，进行调试。 单击“调试”，进入调试界面。 图21 在线调试-进入调试 模拟远程下发控制命令场景，在应用模拟器中，选择服务：StreetLight，命令：SWITCH_LIGHT，命令取值为：ON，单击“发送”，我们可以看到路灯被点亮。