在本系列的第一篇文章中，我们已经在 v1beta1 版本的设备管理 API 中引入了设备属性（Property）的定义，使用户可以获取设备的状态。而在 KubeEdge 1.19 版本中，我们进一步扩展了 API，引入了设备方法（Device Method），允许用户调用设备方法实现对设备属性的动态控制。

Device Method 的 API 定义如下：

// DeviceMethod describes the specifics all the methods of the device.type DeviceMethod struct {    // Required: The device method name to be accessed. It must be unique.    Name string `json:"name,omitempty"`    // Define the description of device method.    // +optional    Description string `json:"description,omitempty"`    // PropertyNames are list of device properties that device methods can control.    // Required: A device method can control multiple device properties.    PropertyNames []string `json:"propertyNames,omitempty"`}

复制代码

在 Device Method 的设计中，它主要由以下三个核心字段构成：

➤ Name：用于标识设备方法，在同一 device-instance 内，每个方法的名称必须是唯一的。

➤ Description：用于说明该方法的具体用途。

➤ PropertyNames：定义该方法能够操作的设备属性列表，一个方法可以控制多个设备属性

下面是一个 device-instance 配置文件示例，展示了如何添加 Device Method：

apiVersion: devices.kubeedge.io/v1beta1kind: Devicemetadata:  name: sensor-tag-instance-02  namespace: defaultspec:  deviceModelRef:    name: sensor-tag-model  nodeName: edge-node  properties:    - name: temperature      visitors:     ...  methods:       - name: setValue     description: This method aim to writing values to device properties     propertyNames:       - temperature       - name2

复制代码

这里我们为 sensor-tag-instance-02 的设备定义了一个 setValue 方法，该方法允许用户修改 temperature 和 name2 这两个设备属性的值。

需要注意的是，在 device-instance 配置文件中定义的 Device Method 仅是方法的框架性定义，具体的功能实现仍然需要在 mapper 设备驱动层完成。

Mapper-Framework 设备数据写入接口

用户通过 Device Method API 定义设备方法的框架之后，需要在 mapper 设备驱动层根据预定义的方法，实现相应的数据写入逻辑。为简化用户操作，1.19 版本的 Mapper-Framework 实现了设备写入的接口：

func (c *CustomizedClient) DeviceDataWrite(visitor *VisitorConfig, deviceMethodName string, propertyName string, data interface{}) error {    // TODO: add the code to write device's data    // you can use c.ProtocolConfig and visitor    return nil}

复制代码

具体来说，用户可以调用 device-instance CRD 中设备协议配置信息（ProtocolConfig）以及设备属性访问配置（VisitorConfig），实现对设备寄存器的写入操作。例如，在 Modbus 设备中，用户可以根据 VisitorConfig 访问特定的 Modbus 寄存器地址并写入新值，进而控制设备的运行状态。

Mapper-Framework Restful API 能力增强

在 KubeEdge 1.19 版本中，Mapper-Framework 扩展了 Restful API，使用户可以更加便捷地查询和调用 Device Method，具体功能如下：

➤ 获取设备的所有设备方法

Url: https://{mapper-pod-ip}:{mapper-api-port}/api/v1/devicemethod/{deviceNamespace}/{deviceName}Response:{"Data": {     "Methods": [         {             "Name": "setValue",             "Path": "/api/v1/devicemethod/default/random-instance-01/setValue/{propertyName}/{data}",             "Parameters": [                 {                     "PropertyName": "random-int",                     "ValueType": "int"                 }             ]         }     ] } }

复制代码

从 Response 中可以看出，目标 device 拥有名为 setValue 的 Device Method，可以通过 Path 中显示的字段进行调用。此外，setValue method 可以用来控制 random-int 这一设备属性。

➤ 创建设备数据写入请求

Url: https://{mapper-pod-ip}:{mapper-api-port}/api/v1/devicemethod/{deviceNamespace}/{deviceName}/{deviceMethodName}/{propertyName}/{data}Response: { "statusCode": 200, "Message": "Write data ** to device ** successfully." }

复制代码

用户通过 Restful API 发起设备数据写入请求有两种方式：

1）边缘端调用

用户可以直接在边缘节点上，通过 Mapper Pod 暴露的 Restful API 发送请求，直接与设备交互，实现低延迟的本地控制。

2）云端调用

在云端，用户可以借助 EdgeMesh 等组件，将请求从云端转发至对应的边缘节点，然后由 Mapper 处理并执行设备写入操作。

无论采用哪种调用方式，Mapper 在接收到设备数据写入请求后，会执行以下操作：

解析请求内容，获取目标设备、目标方法及其参数。
调用设备驱动层中的 DeviceDataWrite 功能，按照定义的协议与设备进行通信。
完成设备属性的写入，更新设备状态。

截至目前，本系列文章已经系统地介绍了 KubeEdge SIG Device-IoT 自 1.15 版本以来的核心特性，包括：

基于物模型的设备管理 API，能够更全面的描述物理设备。
DMI 数据面能力增强
Mapper-Framework 开发框架原理，用于简化用户开发自定义 mapper 插件。
使用 Mapper 进行视频流数据采集与上报，支持摄像头等设备的数据接入。
使用 Mapper 进行设备数据写入，增强边缘设备管理能力。

在本系列的最后一篇文章中，我们将向大家展示如何从零开始基于 Mapper-Framework 开发一个 Modbus 协议的 Mapper 插件，并详细讲解如何定义设备模型、构建 Mapper 工程、实现设备驱动、获取并推送设备数据，从而帮助开发者更高效地构建和集成自定义 Mapper 组件。

【更多 KubeEdge 资讯推荐】玩转 KubeEdge 保姆级攻略——环境搭建篇

玩转 KubeEdge 保姆级攻略——环境搭建篇

《玩转 KubeEdge 保姆级攻略——环境搭建篇》课程主要介绍如何通过华为云服务快速搭建一套 KubeEdge 边缘计算开发平台及部署 Sedna、EdgeMesh 等 KubeEdge 生态组件。

课程免费学习链接：https://connect.huaweicloud.com/courses/learn/course-v1:HuaweiX+CBUCNXNX022+Self-paced/about

KubeEdge 社区介绍：KubeEdge 是业界首个云原生边缘计算框架、云原生计算基金会（CNCF）唯一毕业级边缘计算开源项目，社区已完成业界最大规模云原生边云协同高速公路项目（统一管理 10 万边缘节点/50 万边缘应用）、业界首个云原生星地协同卫星、业界首个云原生车云协同汽车、业界首个云原生油田项目，开源业界首个分布式协同 AI 框架 Sedna 及业界首个边云协同终身学习范式，并在持续开拓创新中。

KubeEdge 网站 : https://kubeedge.io

GitHub 地址 : https://github.com/kubeedge/kubeedge

Slack 地址 : https://kubeedge.slack.com

邮件列表 : https://groups.google.com/forum/#!forum/kubeedge

每周社区例会 : https://zoom.us/j/4167237304

Twitter : https://twitter.com/KubeEdge

文档地址 : https://docs.kubeedge.io/en/latest/

发布于: 刚刚阅读数: 3