华为云用户手册

控制台操作概览 在完成实体设备硬件连接和代码编译烧录之后，我们需要在 设备接入服务 控制台创建产品、定义产品模型、开发编解码插件和注册设备。 创建产品：在 物联网平台 上规定好某一款产品的协议类型、数据格式、厂商名称、设备类型。此处我们需要按照智慧路灯的特征，在控制台创建智慧路灯的产品。 定义产品模型：产品模型是用来描述设备能力的文件，通过JSON的格式定义了设备的基本属性、上报数据和下发命令的消息格式。定义产品模型，即在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的属性信息。此处，我们需要在控制台上，定义开关灯控制、光照强度、信号质量等。 编解插件开发：编解码插件是供物联网平台调用，完成二进制格式和JSON格式相互转换的。它将设备上报的二进制数据解码为JSON格式供应用服务器“阅读”，将应用服务器下行的JSON格式命令编码为二进制格式数据供终端设备（UE）“理解执行”。智慧路灯的数据格式是二进制，因此我们需要开发编解码插件，让物联网能够理解智慧路灯上报的数据，智慧路灯也能理解物联网平台下发的命令。 注册设备：将小熊派智慧路灯注册到物联网平台。

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

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

编译并烧录代码 由于提供的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协议、设备类型为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

配置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样例。 单击“确定”，导入完成。

场景说明 智慧路灯是城市智能化道路上重要一环，智慧路灯的实施具有节约公共照明能耗、减少因照明引起的交通事故等多种社会意义。路灯也是大家在日常生活中可以强烈感知到的公共设施，更易理解其智能化的场景。 在该文档中，我们基于华为一站式开发工具平台（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存放目录

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

R40配置 在R40上需要对传感器的参数进行配置： 风速变速器相关配置： R40上电后，在自己的电脑上连接King开头的wifi，连上后在浏览器中输入地址192.168.3.1进入R40的配置界面。 输入用户名（默认为admin）和密码（默认无密码）后，单击“登录”按钮。 单击上方菜单栏“RTU I/O”，选中“模拟量接入”，进入模拟输入配置界面。 在AIN1输入一行（因为风速变速器选择的是该口）中，选择“电流4~20mA”（风速变速器的输出为该值）。并且按照传感器推荐的将最小值设置为0，最大值设置为30，单位设置为m/s。 设置完毕后，单击“保存并应用”。 通过旋转风速变速器的扇叶，然后刷新当前的配置页，可以看到“当前值”那一栏中有数据，说明已经能采集到传感器的数据。 气象多要素百叶箱相关配置： R40上电后，在自己的电脑上连接King开头的wifi，连上后在浏览器中输入地址192.168.3.1进入R40的配置界面。 输入用户名（默认为admin）和密码（默认无密码）后，单击“登录”按钮。 单击上方菜单栏“应用”，选择“Modbus”主站，进入Modbus主站配置页面。 在下方的框中填写“noise”，单击“添加”按钮。添加完成后，单击“编辑”按钮（“删除”按钮旁的那一个），进入传感器的配置界面。 在配置界面，将别名设置为“噪声监测”，从机地址设置为“2”，寄存器类型设置为“16位数据”，功能码设置为“03”，寄存器起始地址设置为“0”，数据个数设置为“1”，映射地址分配设置为“手动”，映射起始地址设置为“20004”，从机接口设置为“RS485”。 设置完毕后，单击“保存”。然后单击左下角的“返回至概况”。然后单击“保存并应用”。 单击“noise”这一行的“查询”按钮，可以看到“数据值”，如果周围噪声发生改变，可以通过刷新按钮来查看值的变化。 从机地址、寄存器类型、功能码以及寄存器起始地址可以从气象多要素百叶箱的配置文件中获取到。 映射地址为R40的寄存器地址，建议改为手动，同时设置映射地址。因为该地址跟物模型中的属性是对应的，属性名称需要设置成“REG”+ 映射起始地址。这里设置20004是因为物模型中已经设置了REG20004的属性名。 从噪声查看页单击“返回至概况”，在Modbus设置界面下方的空白框处填写“lightIntensity”，单击“添加”按钮。添加完成后，单击“编辑”按钮（“删除”按钮旁的那一个），进入传感器的配置界面。 在配置界面，将别名设置为“光照强度”，从机地址设置为“5”，寄存器类型设置为“32位数据”，功能码设置为“03”，寄存器起始地址设置为“0”，数据个数设置为“1”，映射地址分配设置为“手动”，映射起始地址设置为“20130”，从机接口设置为“RS485”。 设置完毕后，单击“保存”。然后单击左下角的“返回至概况”。然后单击“保存并应用”。 单击“lightIntensity”这一行的“查询”按钮，可以看到“数据值”，如果周围光照强度发生改变，可以通过刷新按钮来查看值的变化。 从机地址、寄存器类型、功能码以及寄存器起始地址可以从气象多要素百叶箱的配置文件中获取到。 映射地址为R40的寄存器地址，建议改为手动，同时设置映射地址。因为该地址跟物模型中的属性是对应的，属性名称需要设置成“REG”+ 映射起始地址。这里设置20130是因为物模型中已经设置了REG20130的属性名。 从光照强度查看页单击“返回至概况”，在Modbus设置界面下方的空白框处填写“shidu”，单击“添加”按钮。添加完成后，单击“编辑”按钮（“删除”按钮旁的那一个），进入传感器的配置界面。 在配置界面，将别名设置为“湿度”，从机地址设置为“1”，寄存器类型设置为“16位数据”，功能码设置为“03”，寄存器起始地址设置为“500”，数据个数设置为“1”，映射地址分配设置为“手动”，映射起始地址设置为“20015”，从机接口设置为“RS485”。 设置完毕后，单击“保存”。然后单击左下角的“返回至概况”。然后单击“保存并应用”。 单击“shidu”这一行的“查询”按钮，可以看到“数据值”，如果周围光照强度发生改变，可以通过刷新按钮来查看值的变化。 从机地址、寄存器类型、功能码以及寄存器起始地址可以从气象多要素百叶箱的配置文件中获取到。 映射地址为R40的寄存器地址，建议改为手动，同时设置映射地址。因为该地址跟物模型中的属性是对应的，属性名称需要设置成“REG”+ 映射起始地址。这里设置20115是因为物模型中已经设置了REG20115的属性名。 从湿度强度查看页单击“返回至概况”，在Modbus设置界面下方的空白框处填写“wendu”，单击“添加”按钮。添加完成后，单击“编辑”按钮（“删除”按钮旁的那一个），进入传感器的配置界面。 在配置界面，将别名设置为“温度”，从机地址设置为“1”，寄存器类型设置为“16位数据”，功能码设置为“03”，寄存器起始地址设置为“501”，数据个数设置为“1”，映射地址分配设置为“手动”，映射起始地址设置为“20003”，从机接口设置为“RS485”。 设置完毕后，单击“保存”。然后单击左下角的“返回至概况”。然后单击“保存并应用”。 单击“shidu”这一行的“查询”按钮，可以看到“数据值”，如果周围光照强度发生改变，可以通过刷新按钮来查看值的变化。 从机地址、寄存器类型、功能码以及寄存器起始地址可以从气象多要素百叶箱的配置文件中获取到。 映射地址为R40的寄存器地址，建议改为手动，同时设置映射地址。因为该地址跟物模型中的属性是对应的，属性名称需要设置成“REG”+ 映射起始地址。这里设置20003是因为物模型中已经设置了REG20003的属性名。 R40上报到平台的配置： 在上方的菜单栏中选择“云平台”，选择“华为云”。“认证方式”选择“设备密钥”，设备ID和密钥在iot平台注册所得，服务ID填写“basicData”，发布周期填写60。 配置完后，单击“保存并应用”。设置完毕后，R40会自动连上华为云iot平台，并且每隔60s报一次数据。

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

控制台操作概览 在真实设备连接之前，需要在设备接入服务控制台创建产品、定义产品模型和注册设备。 创建产品：在物联网平台上规定好某一款产品的协议类型、数据格式、厂商名称、设备类型。此处我们需要按照R40的特征，在控制台创建R40的产品。 定义产品模型：产品模型是用来描述设备能力的文件，通过JSON的格式定义了设备的基本属性、上报数据和下发命令的消息格式。定义产品模型，即在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的属性信息，例如风速、光照强度、温湿度、噪声等。 注册设备：将R40设备注册到物联网平台。

硬件连接 将风速变速器的棕色线和黑色线分别接到外部电源的正极和负极，将蓝色线和绿色线分别接入到R40的AIN1口和AGND口（见下图）。 图6 风速变速器连接R40 将气象多要素百叶箱的棕色线和黑色线分别接到电源的正极和负极，将黄色线和蓝色线分别接入到R40的485A口和485B口（见下图）。 图7 气象多要素百叶箱连接R40 将报警器的红色线和黑色线分别接到电源正极和R40的DO2口，将电源的负极接入到R40的DO1口（见下图）。 图8 报警器连接R40

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

设备简介 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。 图4 上传产品模型-MQTT 在产品列表中，单击对应的产品，进入产品详情页。您可以查看产品ID、产品名称、设备类型、数据格式、厂商名称、所属资源空间、协议类型等产品基本信息。 产品创建成功后，您可以单击“删除”删除不再使用的产品。删除产品后，该产品下的产品模型、编解码插件等资源将被清空，请谨慎操作。

获取AMQP接入凭证 若应用使用AMQP协议接入物联网平台进行数据流转，请先预置接入凭证。您可以通过调用生成接入凭证接口预置，也可以前往控制台页面进行预置，详细方法请参考如下操作： 选择“IoTDA实例 ”，进入您所选择的实例版本，单击“详情”进入实例详情页面。 单击“预置接入凭证”预置接入凭证密钥（accessCode）和接入凭证键值（accessKey）。 图2 实例管理-预置接入凭证 如果您之前预置过接入凭证，重新预置之后，之前的接入凭证密钥将不能再使用。

连接配置说明 AMQP客户端接入物联网平台的连接地址和连接认证参数说明如下： AMQP接入地址：amqps://${server.address}:5671。 连接字符串：amqps://${server.address}:5671?amqp.vhost=default&amqp.idleTimeout=8000&amqp.saslMechanisms=PLAIN 参数 说明 server.address AMQP服务端接入地址，请前往管理控制台-实例-总览页面-实例基本信息-接入信息-AMQPS接入地址处获取。 图1 总览-获取接入信息 amqp.vhost 当前amqp使用是默认的host，只支持default。 amqp.saslMechanisms 连接认证方式当前支持PLAIN-SASL。 amqp.idleTimeout 心跳时间单位为毫秒。如果超过心跳时间，Connection上没有任何帧通信，物联网平台将关闭连接。 端口：5671 客户端身份认证参数 username =“accessKey=${accessKey}|timestamp=${timestamp}|instanceId=${instanceId}” password =“${accessCode}” 参数 是否必须 说明 accessKey 是 接入凭证键值，当前单个键值最多能和32个客户端同时进行建链。 首次建链时候，请参考这里进行预置。 timestamp 是 表示当前时间，13位毫秒值时间戳。 服务端校验客户端的时间戳，且时间戳相差5分钟。 instanceId 否 实例Id，同一Region购买多个标准版实例时需要填设置该参数，实例Id参考这里这里获取。 accessCode 是 接入凭证密钥，长度不超过256个。 首次建链时候，请参考这里进行预置。若密钥丢失，可通过调用接入凭证接口进行重置，也可以参考这里进行重置。

建链认证过程 AMQP客户端与物联网平台建立TCP连接，然后进行TLS握手校验。 为了保障安全，接收方必须使用TLS加密，且使用TLS1.2版本，不支持非加密的TCP传输。客户端的时间不能与标准时间差5分钟及以上，否则接入不进来。 客户端请求建立连接。 客户端向物联网平台发起请求，建立Receiver Link（即平台向客户端推送数据的单向通道）。客户端建立Connection成功后，需在15秒内完成Receiver Link的建立，否则物联网平台会关闭连接。建立Receiver Link后，客户端成功接入物联网平台。 一个Connection上最多能够创建十个Receiver Link，不支持创建Sender Link，即只能由平台向客户端推送消息，客户端不能向平台发送消息。

使用说明 配置自定义 域名 。 选择左侧导航栏“总览”页签，在选择的实例基本信息中，单击“接入信息”。 图1 总览-获取接入信息 单击“接入信息”页面中的“自定义域名”列中的“详情”，进入配置自定义域名的界面。 图2 接入信息-自定义域名详情 在自定义域名界面，单击“添加域名”，根据参数说明配置自定义域名后单击“确定”。 图3 自定义域名-配置自定义域名 创建DNS记录；配置自定义域名后需要联系购买域名的厂商添加域名解析，以便自定义域名指向华为云IoTDA的接入点。您可以参考平台对接信息获取设备的接入点。

使用限制 当且仅当存在一个正常数据转发目标时，支持添加一个异常数据转发目标。 每个IoTDA实例最多支持创建5个异常数据转发目标。 支持异常数据转发目标的规则数据来源：设备、设备属性、设备消息、设备消息状态、设备状态、批量任务、产品和设备异步命令状态。 支持配置异常数据转发的正常转发目标类型： 数据接入服务 （DIS）、分布式消息服务（Kafka）、 对象存储服务 （OBS）、应用与 数据集成平台 （ROMA Connect）、第三方应用服务（HTTP推送）、分布式消息服务（RocketMQ）、 函数工作流 服务 （FunctionGraph）、云数据库（GeminiDB Influx）、云数据库 MySQL（RDS）、云数据库 PostgreSQL（RDS）、 MapReduce服务 （ MRS Kafka）、 区块链 服务（ BCS ）和文档数据库服务（DDS）。 支持作为异常转发目标的通道类型：AMQP推送消息队列。

异常转发数据格式 异常转发数据格式示例如下： { "request_id": "2131d048-234f-4564-9190-6030234678ad", "rule_id": "6519d048-3b7f-442b-9190-6030773879cc", "action_id": "f376ab9f-d060-4fbf-a383-3e52af98ae9d", "channel": "MYSQL_FORWARDING", "base64_original_payload": "ewogICAgInJlc291cmNlIjogImRldmljZS5tZXNzYWdlIiwKICAgICJldmVudCI6ICJyZXBvcnQiLAogICAgImV2ZW50X3RpbWUiOiAiMjAyNDA2MDFUMDAwMDAwWiIsCiAgICAiZXZlbnRfdGltZV9tcyI6ICIyMDI0LTA2LTAxVDAwOjAwOjAwLjAwMFoiLAogICAgInJlcXVlc3RfaWQiOiAiMjEzMWQwNDgtMjM0Zi00NTY0LTkxOTAtNjAzMDIzNDY3OGFkIiwKICAgICJub3RpZnlfZGF0YSI6IHsKICAgICAgICAiaGVhZGVyIjogewogICAgICAgICAgICAiYXBwX2lkIjogIjU4N2MyMzc3ZGRmYzQzMmI4OTMxZGNhYmNhODkyOTUyIiwKICAgICAgICAgICAgImRldmljZV9pZCI6ICIwMDAwMDAwMDAwMDAwMCIsCiAgICAgICAgICAgICJub2RlX2lkIjogIjIwMjAwNzExMTk5OTkxMDAwIiwKICAgICAgICAgICAgInByb2R1Y3RfaWQiOiAiMTIzNDU2Nzg5MDAiLAogICAgICAgICAgICAiZ2F0ZXdheV9pZCI6ICIyMDIwMDcxMTE5OTk5MTAwMCIKICAgICAgICB9LAogICAgICAgICJib2R5IjogewogICAgICAgICAgICAidG9waWMiOiAidGVzdFRvcGljIiwKICAgICAgICAgICAgImNvbnRlbnQiOiAiV2VsY29tZSB0byBIdWF3ZWkgQ2xvdWQgSW9UIERldmljZSBBY2Nlc3MoSW9UREEpIgogICAgICAgIH0KICAgIH0KfQo=", "error_message": "Push failed. Cause: Table 'xxx' doesn't exist. The iot platform will resume the push within 3 minutes after the channel is restored." } 表1 异常转发数据说明 参数 参数类型 描述 request_id String 推送异常的消息ID，由设备侧指定或平台生成，用于跟踪业务流程。 rule_id String 推送异常的规则触发条件ID，用于唯一标识一条规则触发条件，在创建规则时由物联网平台分配获得。 action_id String 推送异常的数据转发目标ID，用于唯一标识一个数据转发目标，在创建数据转发目标时由物联网平台分配获得。 channel String 推送异常的数据转发目标类型。 base64_original_payload String 经过Base64编码的原始流转数据。 error_message String 错误的描述和说明。 异常转发数据格式可能存在增加字段的情况，在使用的时候务必做好序列化兼容性。

概述 在数据被转发至华为云其他服务或第三方应用时，若由于云服务权限不足、 华为云其他服务或第三方应用不可用等原因导致目标服务器不可达，物联网平台会停止消息的推送，并每三分钟进行一次通道恢复探测，若探测成功，通道将恢复正常使用。如果用户消息实时性要求高，为降低通道故障对业务的影响，用户可通过配置异常数据转发目标来获取异常转发数据，以便继续进行业务处理和分析失败原因，从而降低因单一通道异常而对业务产生的影响。 图1 异常数据转发目标示例 在转发规则配置异常数据转发目标后，24小时内若正常数据转发目标不可达，数据将会被直接推送至异常数据转发目标。若超过24小时正常数据转发目标仍未恢复，物联网平台将暂停数据推送。

相关推荐 相关文档 相关产品 设备数据上报 使用HTTP/HTTPS转发 使用AMQP转发 查看运行日志（旧版） 消息通知 服务 SMN 数据接入服务DIS 分布式消息服务Kafka 对象存储服务OBS 应用与数据集成平台ROMA Connect 云日志 服务（LTS） 函数工作流FunctionGraph 分布式消息服务（RocketMQ） 云数据库 GeminiDB Influx MapReduce服务（MRS Kafka） 云数据库MySQL 云数据库PostgreSQL 区块链服务 B CS

概述 数据转发功能用于提供IoTDA与其他第三方以及华为云服务的连接通道，从而实现将设备数据平滑流转至消息中间件、存储、数据分析、业务应用。各转发方式在各规格的支持情况，详见产品规格说明中 基础版、标准版与企业版实例功能差异。当前物联网平台支持如下转发方式： 表1 数据转发概述 分类 转发目标 说明 操作指导 第三方服务 第三方应用服务（HTTP推送） 将数据转发至客户的HTTP服务器，客户可以在数据转发界面创建流转规则，并指定推送的URL，将订阅的数据源信息推送到指定URL的服务器。 使用限制：支持基础版、标准版、企业版。 使用HTTP/HTTPS转发 AMQP推送消息队列 客户可以通过数据转发界面，订阅指定的AMQP通道，将订阅的数据源信息推送到指定AMQP通道，用户可通过AMQP的客户端与IoT平台建立链接，接收数据。 使用限制：支持基础版、标准版、企业版。 使用AMQP转发 MQTT推送消息队列 客户可以通过数据转发界面，订阅指定的MQTT Topic，将订阅的数据源信息推送到指定MQTT Topic，用户可通过Mqtt的客户端与IoT平台建立链接，接收数据。 使用限制：支持标准版、企业版。 使用MQTT转发 设备间通信 物联网平台支持基于MQTT协议实现设备间的消息通信，客户可以通过数据转发界面，订阅指定的Topic，平台会将设备上报的消息推送到指定的Topic，其他设备可以通过订阅该Topic来接收不同设备的消息。 使用限制：支持标准版、企业版。仅支持消息上报。 设备间通信 数据分析 数据接入服务 DIS 将数据流转到华为云DIS云服务。目前DIS支持数据转存储至对象存储服务 OBS、MapReduce服务 MRS、 数据湖探索 DLI 、 数据仓库服务 DWS 、 表格存储服务 CloudTable 。具体DIS支持的转存储任务以实际购买的实例为准。 应用场景：数据接入服务主要解决云服务外的数据实时传输到云服务内的问题。 规格参考：通道规格理论1个分区1M/秒接入，2M/秒读取。 使用限制：支持基础版、标准版、企业版。 数据转发至DIS 分布式消息服务Kafka版 将数据流转到华为云DMS Kafka云服务，适用于构建实时数据管道、流式数据处理、第三方解耦、流量削峰去谷等场景，具有大规模、高可靠、高并发访问、可扩展且完全托管的特点。 应用场景：在日志收集、流式数据传输、在线/离线系统分析、实时监控等领域有广泛的应用。 规格参考：Kafka实例规格。 使用限制：支持基础版、标准版、企业版。 数据转发至Kafka存储 应用与数据集成平台ROMAConnect 将数据流转到华为云ROMA Connect，可以实现无缝联接应用、消息、数据、API、设备，帮助企业快速、简单的打通并管理遗留系统与云原生应用，ROMA Connect是一个全栈式的应用与数据集成平台，源自华为数字化转型集成实践，聚焦应用和数据连接，适配多种企业常见的使用场景。 规格参考：ROMA实例规格。 使用限制：支持企业版。 - 分布式消息服务RocketMQ版 将数据流转到华为云RocketMQ云服务，兼容开源RocketMQ客户端。提供顺序、延迟、定时、重投、死信、事务消息等功能。提供消息追踪、消息溯源、链路诊断、死信导出、监控告警等能力，帮助您全方面的了解服务状况，保证业务正常运行。 应用场景：适用于电商、金融等多样的业务场景。 规格参考：RocketMQ实例规格。 使用限制：支持标准版、企业版。 数据转发至RokcetMQ 云日志服务 LTS 将数据流转到华为云LTS云服务，实现一站式日志采集、秒级搜索、海量存储、结构化处理、转储和可视化图表等功能。 应用场景：适用于应用运维、网络日志可视化分析、等保合规和运营分析等应用场景。 规格参考：日志流规格。 使用限制：支持基础版、标准版、企业版。 查看运行日志 函数工作流 FunctionGraph 将数据流转到华为云FunctionGraph云服务，客户只需要在FunctionGraph中编写业务函数代码并设置运行的条件，无需配置和管理服务器等基础设施，函数以弹性、免运维、高可靠的方式运行。此外，按函数实际执行资源计费，不执行不产生费用。 使用限制：支持标准版、企业版。 数据转发转发至FunctionGraph函数工作流 MapReduce服务 MRS 将数据转发到华为云MRS Kafka云服务，它的Kafka集群是一个分布式的、分区的、多副本的消息发布-订阅系统，它提供了类似于JMS的特性，但在设计上完全不同，它具有消息持久化、高吞吐、分布式、多客户端支持、实时等特性，适用于离线和在线的消息消费，如常规的消息收集、网站活性跟踪、聚合统计系统运营数据（监控数据）、日志收集等大量数据的互联网服务的数据收集场景。 使用限制：支持企业版。 - 区块链服务 BCS 将数据转发到华为云BCS云服务，作为面向企业及开发者提供的区块链技术服务平台，可以帮助客户快速部署、管理、维护区块链网络，降低客户使用区块链的门槛，让客户可以更专注于自身业务的开发与创新，实现业务快速上链。 规格参考：BCS产品规格。 使用限制：支持企业版。 数据转发至BCS可信上链 数据存储 云数据库 GeminiDB Influx 将数据流转到华为云GeminiDB Influx，兼容InfluxDB生态的云原生时序数据库。提供高性能读写、高压缩率、冷热分层存储以及弹性扩容、监控告警等服务能力，可以实现大并发的时序数据读写，压缩存储和类SQL查询等功能，支持多维聚合计算和 数据可视化 分析能力。 应用场景：广泛应用于资源监控、业务监控分析、物联网设备实时监控、工业生产监控、生产质量评估和故障回溯等。提供了高吞吐量和并发性，可以通过快速的响应时间来支持大量的连接，非常适合要求苛刻的物联网应用。 规格参考：InfluxDB规格。 使用限制：支持标准版、企业版。 数据转发至GeminiDB Influx 云数据库 RDS for MySQL 将数据流转到华为云RDS MySQL，相比自建数据库，RDS价格便宜、 即开即用，便捷运维，支持弹性伸缩并具备实例管理、实例监控、备份恢复、日志管理、参数管理等功能，支持单机和主备部署。 应用场景：网站业务、移动应用、游戏业务、电商业务、金融业务以及企业应用等。 规格参考：Mysql性能规格。 使用限制：支持标准版、企业版。 数据转发至MySQL 对象存储服务 OBS 将数据流转至华为云OBS云服务，OBS为客户提供海量、安全、高可靠、低成本的数据存储能力，使用时无需考虑容量限制，并且提供多种存储类型供选择，满足客户各类业务场景诉求，OBS也支持对接实时计算CS云服务，实时分析数据流，分析结果对接到其他云服务或者第三方应用进行数据可视化等。 应用场景：适用于海量大数据存储分析的场景。 规格参考：OBS存储规格。 使用限制：支持基础版、标准版、企业版。 数据转发至OBS长期存储 文档数据库服务DDS功能 将数据流转至华为云文档数据库服务DDS，DDS完全兼容MongoDB协议，具备安全审计，多账号管理，时间点备份恢复能力，支持集群和副本集部署架构。10倍备份恢复能力，分钟级横向扩容，轻松承载海量数据的高并发写入。 应用场景：游戏业务，物联网业务，电商、考勤系统等有典型高并发场景，对数据库性能要求较高。 规格参考：DDS性能规格 使用限制：支持企业版。 数据转发至MongoDB存储 云数据库 RDS for PostgreSQL 将数据流转到华为云RDS for PostgreSQL，RDS for PostgreSQL提供安全可靠、易用稳定、管理便捷的云数据库服务，支持弹性伸缩并具备备份恢复、参数模板管理、插件管理、日志管理等功能，支持单机和主备部署。 应用场景：电商、游戏、金融、政企等核心数据库等。 规格参考：PostgreSQL性能规格。 使用限制：支持企业版。 数据转发至PostgreSQL存储 通过公网进行数据转发流量限制不超过1M/s，超过后消息会直接丢弃。如果要使用更大的流量进行数据转发，推荐使用企业版，企业版支持私网进行数据转发，无此限制。

软固件升级失败原因 物联网平台上报的失败原因： 失败原因 原因解释 处理建议 Device Abnormal is not online 设备异常未在线 请检查设备侧。 Task Conflict 任务冲突 请检查当前设备是否有软件升级、固件升级、日志收集或设备重启的任务正在进行。 Waiting for the device online timeout 等待设备上线超时 请检查设备侧。 Wait for the device to report upgrade result timeout 等待设备上报升级结果超时 请检查设备侧。 Waiting for report device firmware version timeout 等待上报设备固件版本超时 请检查设备侧。 Waiting for report cellId timeout 等待上报cellId超时 请检查设备侧。 Updating timeout and query device version for check timeout 等待升级结果超时，且等待设备版本信息超时 请检查设备侧。 Waiting for device downloaded package timeout 等待设备完成下载固件包超时 请检查设备侧。 Waiting for device start to update timeout 等待设备启动更新超时 请检查设备侧。 Waiting for device start download package timeout 等到设备开始下载固件包超时 请检查设备侧。 设备上报的失败原因： 失败原因 原因解释 处理建议 Not enough storage for the new firmware package 下载的固件包存储空间不足 请检查设备存储。 Out of memory during downloading process 下载过程中内存不足 请检查设备内存。 Connection lost during downloading process 下载过程中连接断开 请检查设备连接状态。 Integrity check failure for new downloaded package 下载的固件包完整性校验失败 请检查设备下载的固件包是否完整。 Unsupported package type 固件包类型不支持 请检查设备状态和厂商提供的固件包是否正确。 Invalid URI URI不可用 检查设备侧的固件包下载地址是否正确。 Firmware update failed 固件更新失败 请检查设备侧。

上传软固件包 创建批量设备软件、固件升级任务前需要上传软件升级包，平台支持两种方式上传软件、固件包： 应用服务器通过调用“创建OTA升级包”API接口，创建OTA升级包，详情请参考创建OTA升级包。 通过控制台，在软固件升级页面上传软件、固件升级包，详情请参考软固件包上传。 通过API接口创建的OTA升级包，只支持MQTT协议设备升级。 升级包为OBS对象时，无论OBS桶是否配置了CDN域名加速功能，下发的升级包链接都为OBS链接地址。