设备接入 IOTDA-华为云

设备接入 IOTDA-设备间消息通信使用说明:使用流程

使用流程以下流程主要以设备间一对一为例：图1 M2M使用流程创建流转规则，设置转发Topic：在控制台界面创建M2M流转规则并设置转发Topic。策略配置：在控制台界面进行策略配置。通过策略配置允许发送、接收数据的设备进行发布及订阅。设备A、B鉴权：设备发起连接鉴权（MQTT设备），鉴权参数填写请参考：设备连接鉴权。设备B订阅Topic：设备对云服务端进行主题订阅。设备B订阅的Topic为创建流转规则中设置的Topic。若订阅成功，平台返回订阅成功ACK。设备A数据上报：设备对云服务端进行主题发布。若发布成功，平台返回发布成功ACK。设备B收到数据：若转发成功，设备B将收到设备A发送的数据。

设备接入 IOTDA 设备间消息通信（M2M）

设备接入 IOTDA-设备间消息通信使用说明:操作步骤

操作步骤以下示例主要针对平台中创建流转规则配置。通过修改流转规则可以实现不同场景的应用。访问设备接入服务，单击“管理控制台”进入设备接入控制台。在左侧导航栏“规则”中单击“数据转发”，可到数据转发界面。图2 数据转发页面单击“创建规则”按照业务具体填写需要转发的数据参数，填写完成后单击“创建规则”。参数值可参考下图。图3 创建数据转发规则表1 创建数据转发规则-参数说明参数说明规则名称自定义，如test。长度不超过256，只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合。规则描述自定义，对该规则的描述。数据来源转发规则的数据来源，下拉可选择多种数据来源。在使用M2M时，请选择“设备消息”。触发事件不同的数据来源有不同的触发事件，若使用M2M，请选择“设备消息上报”。资源空间下拉选择所属的资源空间。可以选择所有资源空间，如无对应的资源空间，请先创建资源空间。数据过滤语句使用SQL语句可以进行数据筛选，详情可见：SQL语句。图片中在WHERE中填入notify_data.body.topic IN ('/test/M2M')，代表只有Topic为“/test/M2M”的数据进行数据转发。在创建数据转发规则的第二步，可以添加转发到的目标，包括设置转发后的Topic、缓存时间等。若使用M2M，请将转发目标设置为“设备”，按照业务具体填写参数后单击“确定”。图4 设置转发目标表2 设置转发目标-参数说明参数说明转发目标下拉选择转发目标，在设备间消息通信中，请选择为“设备”。 Topic 自定义，长度不超过128个字符，可以以$和/开头，不可以$和/符号结尾；不允许有a-zA-Z0-9() ',-.:=@;_!*'%?+\以外的符号。 ttl 数据缓存时间。当设备不在线时，数据会进行缓存（当ttl为0时不缓存），当设备上线时再进行下发。输入值范围在0~1440（一天）分钟，且值为5的倍数。启动规则。在创建数据转发规则的第三步，单击启动，完成规则设置。图5 启动规则

设备接入 IOTDA 设备间消息通信（M2M）

设备接入 IOTDA-非$oc开头自定义Topic通信使用说明:使用流程&操作步骤

使用流程&操作步骤图1 非$oc开头自定义topic通信为了适配新老客户的使用，策略默认放通所有“非$oc开头的自定义Topic通信”。新增的资源空间会默认加入策略“system_default_policy”，system_default_policy策略会允许所有Topic的订阅与发布。当业务场景不适用时，可以删除该策略。值得注意的是，策略只会限制“非$oc开头的自定义Topic通信”。“$oc开头的自定义Topic”权限由产品下的设定决定。现如今广州、北京四、上海局点不支持策略，可跳过策略（步骤2、3）、直接使用。

设备接入 IOTDA 自定义Topic通信

设备接入 IOTDA-自定义鉴权概述:约束与限制

约束与限制使用自定义鉴权功能，要求设备必须使用TLS同时支持SNI(Server Name Indication)，SNI中需要携带平台分配的域名。每个用户默认最多支持10个自定义鉴权的配置。自定义鉴权的函数最大处理时间为5秒，5秒内函数没返回结果，则认为鉴权失败。每个用户总鉴权请求的TPS限制参考产品规格说明，自定义鉴权为总鉴权TPS的50%（不包含设备自注册）。若用户开启了缓存FunctionGraph的鉴权结果，则在相同参数下，函数服务的修改生效时间需在缓存超期后才能生效。在所有的设备接入鉴权方式中，当满足自定义鉴权条件时（匹配到设备携带的自定义鉴权器名称或用户配置了默认自定义鉴权器），优先采用自定义鉴权方式进行设备接入。

设备接入 IOTDA 自定义鉴权

设备接入 IOTDA-自定义鉴权概述:概述

概述自定义鉴权是指用户可以通过函数服务自定义实现鉴权逻辑，以对接入平台的设备进行身份认证。在设备接入物联网平台前，用户可以通过应用服务调用控制台配置自定义鉴权信息，然后通过调用函数服务（FunctionGraph入门简介）配置自定义鉴权函数。在设备接入物联网平台时，物联网平台会获取设备ID和自定义鉴权函数名称等参数，并向FunctionGraph发起发起鉴权请求，由用户实现鉴权逻辑以完成设备的接入鉴权。

设备接入 IOTDA 自定义鉴权

设备接入 IOTDA-消息下发:下发消息状态

下发消息状态 MQTT设备消息执行状态以及状态变化机制如下所示。图4 设备消息状态表2 消息执行状态消息执行状态说明等待（PENDING） MQTT协议设备不在线，物联网平台会将消息进行缓存，此时任务状态为“等待”状态。超时（TIMEOUT）物联网平台缓存的PENDING状态的消息，如果1天之内还没有下发下去，物联网平台会将消息状态设置为“超时”。已送达（DELIVERED）物联网平台将消息发送给设备后，状态变为“已送达”。失败（FAILED）物联网平台发送消息给设备不成功，消息状态变为“失败”。

设备接入 IOTDA

设备接入 IOTDA-消息下发:消息下发使用QoS 1说明

消息下发使用QoS 1说明 MQTT设备接入，使用QoS 1的系统Topic进行设备消息下发说明：图2 消息下发使用Qos 1流程图设备上线。订阅Topic，设置订阅Topic的QoS为1。图3 订阅Topic的QoS为1 应用侧或平台用下发设备消息接口，下发请求到物联网平台，下发消息样例如下： POST https://{Endpoint}/v5/iot/{project_id}/devices/{device_id}/messages Content-Type: application/json X-Auth-Token: ******** { "message_id": "99b32da9-cd17-4cdf-a286-f6e849cbc364", "name": "messageName", "message": "HelloWorld" } 物联网平台根据协议规范下发消息给设备。MQTT设备必须先订阅平台消息下发下行接口对应的Topic才能收到平台下发的消息，消息样例如下： Topic: $oc/devices/{device_id}/sys/messages/down 数据格式： { "object_device_id": "{object_device_id}", "name": "name", "id": "id", "content": "hello" } 物联网平台向设备下发消息后，向应用服务器返回201 Created，消息状态为DELIVERED。消息下发是异步操作，不需要等设备ACK就可以回响应。物联网平台没有收到设备接收消息的ACK响应，重发消息；默认每隔2s重发一次，总下发3次。设备再次上线或订阅Topic。物联网平台会重发之前设备未回ACK且未超时的消息，默认每隔10s重发一次，总下发5次；每次重发也会触发每隔2s重发机制。平台将消息的最终结果推送给应用服务器，设备消息状态为已送达（DELIVERED）或超时（TIMEOUT）。使用接口：设备消息状态变更通知接口。 Topic: $oc/devices/{device_id}/sys/messages/down 数据格式： { "resource": "device.message.status", "event": "update", "notify_data": { "message_id": "string", "name": "string", "device_id": "string", "status": "DELIVERED", "timestamp": "string" } }

设备接入 IOTDA

设备接入 IOTDA-消息下发:消息缓存下发使用说明

消息缓存下发使用说明消息下发是平台向设备直接下发消息的一种方式。具有缓存特性，当设备不在线时，平台会对下发的消息进行缓存，直到设备上线。以MQTT设备接入为例，使用系统Topic进行设备消息缓存下发说明：图1 消息缓存下发流程应用侧或平台用下发设备消息接口，下发请求到物联网平台，下发消息样例如下： POST https://{Endpoint}/v5/iot/{project_id}/devices/{device_id}/messages Content-Type: application/json X-Auth-Token: ******** { "message_id": "99b32da9-cd17-4cdf-a286-f6e849cbc364", "name": "messageName", "message": "HelloWorld" } 物联网平台向应用返回201 Created，消息状态为PENDING。物联网平台通过设备消息状态变更通知接口推送消息结果给应用，设备未上线时，设备消息状态为等待（PENDING），对应的消息样例如下： Topic: $oc/devices/{device_id}/sys/messages/down 数据格式： { "resource": "device.message.status", "event": "update", "notify_data": { "message_id": "string", "name": "string", "device_id": "string", "status": "PENDING", "timestamp": "string" } } 设备上线。设备订阅消息下发的topic，用于接收消息，订阅的topic见步骤6。物联网平台根据协议规范下发消息给设备。MQTT设备必须先订阅平台消息下发下行接口对应的Topic才能收到平台下发的消息，消息样例如下： Topic: $oc/devices/{device_id}/sys/messages/down 数据格式： { "object_device_id": "{object_device_id}", "name": "name", "id": "id", "content": "hello" } 平台将消息的最终结果推送给应用服务器，设备消息状态为已送达（DELIVERED）。使用接口：设备消息状态变更通知接口。 Topic: $oc/devices/{device_id}/sys/messages/down 数据格式： { "resource": "device.message.status", "event": "update", "notify_data": { "message_id": "string", "name": "string", "device_id": "string", "status": "DELIVERED", "timestamp": "string" } }

设备接入 IOTDA

设备接入 IOTDA-消息下发:使用服务质量

使用服务质量支持MQTT的服务质量等级为QoS 0、QoS 1，不支持QoS 2。 Topic的QoS为 0 时，消息下发不需要等设备回ACK，仅只下发一次; Topic的QoS为 1时，消息下发需要等设备回ACK。平台默认该设备订阅了QoS为0的系统Topic, 如果需要QoS为1的下行系统Topic，需要设备设置订阅QoS。设备订阅非$oc开头的自定义Topic, 如果需要平台支持该Topic的QoS为1, 需向平台提交工单联系申请。如果设备订阅Topic的QoS为1, 平台下发消息没有收到设备确认ACK时, 平台会重发消息, 默认每隔2s重发1次, 共重发3次; 重发后设备依旧没有回确认响应且消息还在缓存时间内, 设备再次上线或订阅Topic时, 平台会再重发消息, 默认每隔10s重发1次, 共重发5次; 同时每次重发也会触发每隔2s重发机制, 故订阅Topic的QoS为1时平台会重发消息, 设备可能会收到重复消息，建议设备要有去重机制。

设备接入 IOTDA

设备接入 IOTDA-消息下发:概述

概述消息下发不依赖产品模型，提供给设备的单向通知，具有消息缓存功能；云端消息下发中，平台会以异步方式（消息下发后无需等待设备侧回复响应）下发消息给设备；若设备不在线，则在设备在线后发送数据（支持配置，最长缓存时间24小时）。平台对每个设备默认只保存20条消息，超过20条后，后续的消息会替换下发最早的消息。同时，消息下发支持使用自定义topic的格式进行数据下发。表1 消息下发Topic类别消息下发Topic类别描述系统Topic 平台预先定义了各种设备和平台通信的Topic，具体Topic列表和功能说明可参考Topic定义。自定义Topic 用户可以自定义Topic，设备和平台间可以基于用户自定义的Topic进行通信。自定义topic分类：在产品中定义需要使用的Topic，这类Topic有$oc/devices/{device_id}/user/前缀，消息上报或者消息下发时平台会校验Topic是否在产品中定义，未在产品中定义的Topic会被平台拒绝。使用方式可以参考链接使用自定义Topic进行通信的最佳实践。使用非$oc开头的自定义Topic，如/aircondition/data/up进行消息通信，这类Topic平台不校验Topic权限，根据MQTT协议定义的规则进行Topic的消息上下行通信。使用方式可以参考链接第三方云设备迁移至华为云最佳实践。

设备接入 IOTDA

设备接入 IOTDA-数据转发积压策略配置:操作步骤

操作步骤访问设备接入服务，单击“管理控制台 ”进入设备接入控制台。依次单击“规则 - 数据转发 - 策略配置 - 数据流转积压策略”进入积压策略配置界面。图1 策略配置界面在弹出的界面中填写名称、描述、积压大小、积压时间等信息后，单击确定即可完成积压策略创建。图2 创建积压策略表1 参数说明参数名称描述策略名称长度为4-256，只允许中文、字母、数字以及_?'#().,&%@!-等字符的组合。描述关于该策略的描述，长度为4-256，只允许中文、字母、数字以及_?'#().,&%@!-等字符的组合。积压大小单个转发规则流转数据在IoT物联网平台最大积压（缓存）大小，单位为B，最大可配置为1073741823 B，即1GB。积压时间单个转发规则流转数据在IoT物联网平台最大积压（缓存）时间，单位为秒，最大可配置为86399秒，即24小时。

设备接入 IOTDA

设备接入 IOTDA-数据转发积压策略配置:概述

概述当转发目标（如第三方应用服务器等）由于性能等原因无法快速处理IoT物联网平台流转数据时，未能及时处理的流转数据会积压（缓存）在IoT物联网平台。目前IoT物联网平台默认配置单个转发规则流转数据的最大积压（缓存）大小为1GB，最大积压（缓存）时间为24小时，超过最大积压（缓存）大小或积压（缓存）时间时，最早未被处理的流转数据会被丢弃直至满足积压（缓存）大小和时间限制。客户可以根据自身的业务场景以及转发目标（如第三方应用服务器等）的性能等情况，在IoT物联网平台上创建合适的积压策略，控制流转数据在IoT物联网平台的积压情况。例如：当业务对数据实时性的要求高于完整性，而转发目标（如第三方应用服务器等）长时间性能不足或业务中断一段时间，未能及时处理IoT物联网平台流转数据，导致流转数据大量积压在IoT物联网平台，转发目标（如第三方应用服务器等）接收到的数据一直是延迟、滞后的数据，此时可以考虑使用积压策略配置较小的积压大小和积压时间，丢弃过时的数据，接收、处理较为实时的流转数据。

设备接入 IOTDA

设备接入 IOTDA-静态策略:概述

概述静态策略，即设备关键字模糊匹配的发放策略。每条静态策略实例指：匹配上该策略实例的设备，将会被发放到该条策略实例关联的设备接入实例的对应资源空间（即应用）下。设备匹配静态策略实例的机制为：设备的发放策略为“静态策略”，设备的关键字来源字符串包含某一静态策略实例的关键字，即被认为该设备匹配上该条策略实例。关键字来源有以下两种来源类型：设备名称：如果设备名称包含设置的关键字，即可按照该行策略指定的发放应用进行实例发放。数据上报：如果设备在连接后，进行发放publish时，上报Topic “$oc/devices/${deviceId}/sys/bootstrap/up” 中，json上报的属性 “baseStrategyKeyword” 包含设置的关键字，即可按该实例进行发放。一个设备最多匹配一条静态策略实例；当一个设备匹配上多条静态策略实例时，则以优先级最高的策略实例为优先。

设备接入 IOTDA

设备接入 IOTDA-静态策略:操作步骤

操作步骤进入“策略”界面，单击展开“静态策略”，单击“添加实例”。按照下方参数说明填写关键参数信息后，单击“确定”。表1 静态策略参数列表参数名称说明示例关键字即关键字来源中的关键字。设备发放时，如果关键字来源字符串中包含设置的关键字，则可按该实例进行发放。将设备名称携带Beijing的设备发放至华北-北京四的物联网平台。设备名称：WaterMeter-Beijing0001、WaterMeter-Beijing0002 关键字来源：设备名称关键字：Beijing 发放区域：华北-北京四发放应用：beijing-app1 将上报信息中携带Beijing的设备发放至华北-北京四的物联网平台。关键字来源：数据上报 topic“$oc/devices/${device_id}/sys/bootstrap/up”上报信息：{ "baseStrategyKeyword": "WaterMeter-Beijing0003"} 关键字：Beijing 发放区域：华北-北京四发放应用：beijing-app1 关键字来源关键字来源指的是用于匹配关键字的字符串信息的数据来源。目前支持设备名称与数据上报两种形式。如果为设备名称，则匹配关键字的字符串取设备创建后的设备名称。如果为数据上报，则匹配关键字的字符串取设备发放过程中，发起发放请求Topic“$oc/devices/${device_id}/sys/bootstrap/up” 的上报信息json中的baseStrategyKeyword属性。优先级别发放策略的优先级，取值范围1 - 5级，1级为最低优先级。当一个设备符合多个发放策略时，按照优先级最高的策略实例发放。发放区域发放到指定区域后，设备将接入对应区域的设备接入服务。所选区域未开通设备接入服务时，如果确定添加实例，系统将自动为您开通设备接入服务。不同区域设备接入服务价格不同，收费详情请参考价格说明。发放应用选择对应设备接入服务区域已创建的应用。在物联网平台中，设备由应用统一管理。如果对应设备接入服务区域未创建应用，需要前往对应服务创建应用。

设备接入 IOTDA

设备接入 IOTDA-创建产品:操作步骤

操作步骤访问设备接入服务，单击“管理控制台”进入设备接入控制台。单击左侧导航栏“产品”，单击页面左侧的“创建产品”。根据页面提示填写参数，然后单击“确定”，完成产品的创建。基本信息所属资源空间下拉选择所属的资源空间。如无对应的资源空间，请先创建资源空间。产品名称为产品命名。产品名称在相同资源空间有唯一性。长度不超过64，只允许中文、字母、数字、以及_?'#().,&%@!-等字符的组合。协议类型 MQTT：使用MQTT协议接入平台的设备，数据格式可以是二进制也可以是JSON格式，采用二进制时需要部署编解码插件。 LwM2M/CoAP：使用在资源受限（包括存储、功耗等）的NB-IoT设备，数据格式是二进制，需要部署编解码插件才能与物联网平台交互。 HTTPS：HTTPS是基于HTTP协议，通过SSL加密的一种安全通信协议。物联网平台支持HTTPS协议通信。 Modbus：物联网平台支持使用Modbus协议接入，使用Modbus协议的设备接入IoT边缘节点的方式为非直连。直连设备和非直连设备差异说明，请参考这里。 HTTP(TLS加密)、ONVIF、OPC-UA、OPC-DA、Other：通过边缘接入。数据格式 JSON：平台和设备之间的通信协议采用JSON格式。二进制码流：您需在控制台开发编解码插件，将设备上报的二进制码流数据转换为JSON格式；将平台下发的JSON格式数据解析为二进制码流格式，设备才能与平台进行通信。所属行业请根据实际情况选择。设备类型请根据实际情况选择。高级配置产品ID 定制ProductID，用于唯一标识一个产品。如果携带此参数，平台将产品ID设置为该参数值；如果不携带此参数，产品ID在物联网平台创建产品后由平台分配获得。产品描述产品描述。请根据实际情况填写。产品创建成功后，您可以单击“删除”删除不再使用的产品。删除产品后，该产品下的产品模型、编解码插件等资源将被清空，请谨慎操作。

设备接入 IOTDA

云服务器内容精选

设备接入 IOTDA

7*24

备案

专业服务

退订

建议反馈

售前咨询热线