检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
应用管理概述 应用管理是IoT边缘提供的边缘应用管理能力,通过将系统预置的应用或用户自定义的应用部署到边缘节点,可在边侧进行协议解析、数据处理、本地子系统集成等能力拓展。当前IoT边缘支持容器化部署和安装包部署的方式,您可以制作镜像上传到容器镜像服务(SWR),也可以选择上传安装
概述 简介 为解决用户自定义处理设备数据以及自定义协议设备快速接入IOT平台的诉求,IoT边缘提供ModuleSDK,用户可通过集成SDK让设备以及设备数据快速上云。IoT边缘平台应用功能有自定义处理设备数据(即数据处理),自定义协议设备快速接入(即协议解析),IT子系统接入(即
网络环境 安装部署边缘节点时,需要具备的网络环境。 边缘环境需要具备访问公网的能力,与OBS云服务互通。 确认自身内网是否具备访问公网能力,存在网络隔离,如涉及通信是否在同一个子网内,可参考虚拟私有云 VPC。 服务器下载工具版本是否符合要求以及对应端口是否开放,可参考表3。 部
主备配置 图1 构架图 通过主备配置,保证主机数据的可靠性和相关业务的可持续性。 [主] 执行边缘所有业务, [备] 下载所有镜像且仅执行edge_agent、edge_keepalive应用,在主节点发生宕机,网络故障等情况下进行主备倒换,且原主节点恢复后不会进行抢占。 使用约束
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 IoTEdge.00000005 The request parameter is invalid
导入自定义业务应用配置模板 添加业务应用配置模板 业务应用配置模板是描述业务应用自定义配置项的元数据,应用配置包括基本配置项元数据、默认数据。当用户添加自定义应用时,可通过添加自定义应用配置模板完成元数据的定义。 应用数据源模板导入 数据源模板描述了数据源配置项的元数据,用户在配
DcClient方法说明 ModuleSDK中,客户端类DcClient提供多个方法供客户开发应用时使用,使用时可参考每个函数的功能定义。 表1 DcClient方法说明 接口 说明 createFromEnv 根据环境变量创建客户端,相关配置参数从环境变量获取。 setPointsCallback
DriverClient方法说明 ModuleSDK中,客户端类DriverClient提供多个方法供客户开发应用时使用,使用时可参考每个函数的功能定义。 表1 DriverClient方法说明 接口 说明 createFromEnv 根据环境变量创建客户端,相关配置参数从环境变量获取。
ItClient方法说明 ModuleSDK中,客户端类ItClient提供多个方法供客户开发应用时使用,使用时可参考每个函数的功能定义。 表1 ItClient方法说明 接口 说明 createFromEnv 根据环境变量创建客户端,相关配置参数从环境变量获取。 syncConfigs
准备数据源 在部署数采应用之前需要先准备数据源,数据源可以是Modbus Server的对应服务器,也可以是类似Modbus Slave的模拟器网关,此处以Modbus Slave模拟器举例。 安装Modbus Slave模拟器 下载Modbus Slave模拟器。 安装完毕后,启动Modbus
OT数采配置 配置数据源 数据源提供OT数据的设备和系统,如DCS、SCADA、PLC、数据库等。 创建数采连接 访问IoT边缘,单击“管理控制台”进入IoT边缘控制台。 在左侧导航栏选择“边缘节点 > 节点管理”,节点名称选择“test_IoT10”进入页面。 在左侧导航栏选择“数采配置
接口函数 表1 edge.h中支持的接口函数 接口 说明 edge_init 初始化sdk的工作环境,加载证书、读取配置等 edge_set_callbacks 注册回调接口,登录、子设备添加、删除、设备消息、设备命令等都是异步通知的,故需要注册对应的处理函数 edge_login
OT数采配置 添加数采模板 描述数采配置项的元数据,数采配置包括数据源配置元数据、点位采集配置元数据。 系统数据源模板导入 数据源模板描述了数据源配置项的元数据,用户在配置数据源之前,需要先导入数据源模板。IoT边缘服务当前已经预置通用数据源模板,可以直接使用,系统也支持用户自定义导入模板。
边缘设备 在节点详情页的“边缘设备”页签,可查看或者添加边缘设备。 关于子设备管理的更多使用描述,可参见设备接入边缘节点。 图1 边缘设备 批量导入设备 访问IoT边缘,单击“管理控制台”进入IoT边缘控制台。 在左侧导航栏选择“边缘节点 > 节点管理”,选择之前创建的边缘节点,单击节点进入详情页。
客户端通用方法说明 ModuleSDK中提供多个通用方法供客户开发应用时使用,使用时可参考每个函数的功能定义。 表1 客户端通用方法 接口 说明 open 打开客户端。 startModuleShadow 启动影子,设置收到影子回调并触发获取影子动作。 getModuleShadow
OT数采配置 添加数采模板 数采模板是描述数采配置项的元数据,数采配置包括数据源配置元数据、点位采集配置元数据。当用户添加自定义数采应用时,可通过添加自定义数采模板完成元数据的定义。 应用数据源模板导入 数据源模板描述了数据源配置项的元数据,用户在配置数据源之前,需要先导入数据源
上传进程包到OBS 进程包插件由用户/伙伴开发,需集成边缘SDK,根据需要可分别基于ItClient/OAClient/DriverClient进行开发。此处仅演示部署步骤,故假设已有一个进程包。 ProcessWithStartBash.tar.gz 访问对象存储服务 OBS,
重装边缘节点 使用约束 重新安装边缘节点时,边缘节点需要处于离线状态。 边缘节点类型是基础版或专业版节点(Docker),不支持专业版节点(KubeEdge)。 含有主备配置的节点,主节点重装参考主节点异常重装,备节点重装请参考备节点异常重装。 操作步骤 在“边缘节点”的节点列表
如何创建和管理边缘网关(专业版) 注册边缘节点 访问IoT边缘,单击“管理控制台”进入IoT边缘控制台。 选择左侧导航栏“边缘节点 > 节点管理”单击右上角“注册节点”。 根据页面提示填写参数,勾选右下角“《华为云服务等级协议》”单击“下一步”配置节点数据。 图1 注册专业版节点
内部架构 表1 通用接口 接口 说明 IModuleShadowCallback 模块影子回调,实现对影子通知的处理 IPointsCallback 点位处理回调,实现点位的读写操作 IConnectionStatusChangeCallback 连接状态变化回调接口,用于MQTT连接状态改变时的处理