检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
IoT Device SDK使用指南(Go) IoT Device SDK(go)提供设备接入华为云IoT物联网平台的go版本的SDK,提供设备和平台之间通讯能力,以及设备服务、OTA等高级服务,并且针对各种场景提供了丰富的demo代码。相关集成指导请参考IoT Device SDK(go)使用指南。
device_name 设备名称,可以同node_id一致。 secret 设备密钥,性能测试时可以固定填写一个密钥。 在“批量注册设备窗口”单击“添加文件”上传写好的批量注册文件模板,单击“确定”创建任务。 图1 设备-批量注册设备 批量注册执行成功后,保存好设备ID和密钥。 导入测试计划
gateway_id 否 String 参数说明:网关ID,用于标识一个网关设备。当设备是直连设备时,gatewayId与设备的deviceId一致。当设备是非直连设备时,gatewayId为设备所关联的直连设备(即网关)的deviceId。 最大长度:256 tags 否 Array
部署插件 具体操作: 导航栏选择“IoTDA 实例”,单击对应实例的“详情”按钮,进入实例详情页面,选择“泛协议接入”页签。 图1 泛协议-泛协议接入 选择“云网关->新增云网关”。端口填写为“8888”。镜像选择镜像名称为“protocol-plugin-jt808”的镜像。 图2
设备管理 创建设备 查询设备列表 查询设备 修改设备 删除设备 重置设备密钥 冻结设备 解冻设备 重置设备指纹 灵活搜索设备列表 查询指定设备加入的设备组列表 父主题: API
uest_id} 设备 平台 设备侧主动获取平台的设备影子数据 $oc/devices/{device_id}/sys/shadow/get/response/request_id={request_id} 平台 设备 设备侧主动获取平台设备影子数据的响应 设备事件相关Topic
提供在线签发设备证书能力 设备发放能提供在线签发设备证书能力,设备厂商无需加密管理设备的CA证书和设备证书,或者具备PKI证书颁发能力,通过设备发放在线签发设备证书,实现设备的安全认证。 具体使用示例参考MQTT 华为云证书注册组发放示例。 注册组极简接入 设备发放提供注册组功
$oc/devices/{device_id}/sys/bootstrap/up 设备 设备发放平台 设备向发放服务请求对应设备接入实例的引导信息。 $oc/devices/{device_id}/sys/bootstrap/down 设备发放平台 设备 设备接收发放服务下发的引导信息。 场景示例矩阵 表2 示例列表
发起发起鉴权请求,由用户实现鉴权逻辑以完成设备的接入鉴权。 图1 自定义鉴权业务架构图 应用场景 迁移场景:当用户的设备从第三方云平台迁移到IoTDA平台时,存量设备可以依据现有的设备鉴权方式,在平台自定义配置设备的鉴权逻辑,以实现设备鉴权方式免改动的能力。 原生场景:用户有自定
rawMessage.getPayload(); }, 0); 测试验证 先运行设备侧 SDK代码,使设备上线,并订阅广播topic。然后运行应用侧SDK代码,调用broadcastMessage接口向设备发送广播消息,设备侧收到的广播消息样例如下: 图1 广播消息样例 父主题: 广播通信
属性下发分为查询设备属性和修改属性参数两种,查询设备属性用于应用侧或平台主动获取设备属性数据,修改属性参数用于应用侧或平台设置设备属性值并同步到设备侧。设备接收到属性下发指令后需要立即响应,如果设备没有响应,平台会认为属性下发执行超时。 使用场景 用于平台主动获取或修改设备属性值。 平台规范、解析、过滤的数据。
平台的设备进行身份认证,用户可以通过平台预置的函数灵活编排鉴权方式。 应用场景 迁移场景:当设备从第三方物联网平台迁移到华为云IoTDA时,通过配置平台提供的自定义鉴权模板可以兼容原来的鉴权方式,设备侧无需改动实现无缝迁移。 原生场景:自定义模板鉴权可以让用户扩展自己的设备鉴权方
够上网。 创建产品和设备 参考创建产品,创建基于MQTT协议的产品。 参考注册设备,获取设备ID(deviceID)和设备密钥。 注册设备后,请妥善保管设备ID和设备密钥。设备密钥无法找回,如果忘记,可在“设备详情”页面单击“重置密钥”设置新的密钥。 访问设备接入控制台,获取MQ
镜像制作 将jar文件打包成镜像文件,请参照制作镜像包或插件包。 dockerfile内容参照如下(具体可参考编写高效的Dockerfile )。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 FROM registry-cbu
买ECS服务器、购买ELB负载均衡、进行容器化等操作和费用。 当前只有IoTDA企业版支持托管部署,使用托管部署方案后,资源费用包含在IoTDA企业版内客户不用单独为部署资源付费。IoTDA标准版可以参考非托管部署方案进行部署和运维,产生的费用参考ECS服务器或者云容器实例CCI的费用说明。
上行消息保序 在需要上行消息保序的场景,可以参考如下图的方案进行设计: 设备-平台:设备侧上报消息时,Qos值设置为1,上报消息A后,等收到消息A的Qos响应后,再依次上报消息B和消息C,从而保证设备与平台侧的消息上行保序。 平台-应用:IoTDA配置数据流转规则为流转到Ka
过这些接口,平台和设备可以实现设备鉴权、消息上报及属性上报。 消息类型 说明 设备鉴权 用于设备获取鉴权信息access_token。 设备属性上报 用于设备按产品模型中定义的格式将属性数据上报给平台。 设备消息上报 用于设备将自定义数据上报给平台,平台将设备上报的消息转发给应用
JT808协议接入 JT808协议说明 部署插件 设备侧对接 应用侧对接 父主题: 泛协议接入
SL651协议接入 SL651协议说明 部署插件 设备侧对接 父主题: 泛协议接入
运行main方法成功启动后,即可在设备设备详情页面查看上报的设备属性数据。详细接口信息请参考设备属性上报。 图2 查看上报数据-level 图3 查看上报数据-temperature_value 如果在“设备详情”页面没有最新上报数据,请修改产品模型中服务和属性的内容,确保设备上报的服务/属性和