Azure IoT Edge入门（9）云到边缘设备控制-Azure iot edge module direct method

本文介绍：

1. Azure IoT edge 从云到边缘设备的控制方式之一 direct method。

2. Edge-agent中内置的 direct method

本文参考：https://docs.microsoft.com/zh-cn/azure/iot-edge/how-to-edgeagent-direct-method

视频：

https://www.51azure.cloud/post/2020/11/14/azure-iot-edge9azure-iot-edge-module-direct-method

图文：

我们之前介绍过Azure IoT Hub 的云到设备控制的方法之一是direct method，参见《云到设备的控制-direct method》。

与此类似，Azure IoT Edge Module中也支持direct method，可以实现对在线module的控制及数据传输（通过payload）。

同时，Azure IoT Edge的系统Module之一的Edge-agent中也内置了几个direct method。

direct metod 功能通过 Module client 提供，各个语言的Module client 语法， 请参阅首选 SDK 语言的 API 参考：C#、C、Python、Java 或 Node.js。

例如C#语言的 direct method 相关的方法：

https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.azure.devices.client.moduleclient.setmessagehandlerasync?view=azure-dotnet

ModuleClient.SetMessageHandlerAsync Method

Definition

Namespace:

Microsoft.Azure.Devices.Client

Assembly:

Microsoft.Azure.Devices.Client.dll

Package:

Microsoft.Azure.Devices.Client v1.33.1

Overloads

OVERLOADS

SetMessageHandlerAsync(MessageHandler, Object)	Sets a new default delegate which applies to all endpoints. If a delegate is already associated with the input, it will be called, else the default delegate will be called. If a default delegate was set previously, it will be overwritten.
SetMessageHandlerAsync(MessageHandler, Object, CancellationToken)	Sets a new default delegate which applies to all endpoints. If a delegate is already associated with the input, it will be called, else the default delegate will be called. If a default delegate was set previously, it will be overwritten.

示例代码请参照：

https://github.com/Azure/iotedge/blob/master/edge-modules/SimulatedTemperatureSensor/src/Program.cs

 

相关逻辑请参考：

云端发送了“Reset” direct method请求，edge 设备的 module 执行了响应：

 

 

 

 

 

 

 

我们可以自行根据Module client 中的 SetMethodHandlerAsync 语法自行实现自己的 direct method：例如控制module重启，控制module 调整发送频率等等。

 

除了自行写代码实现这些功能，IoT Edge 中的 系统module之一的Edge-agnet 也内置了一些direct method：

 

https://docs.microsoft.com/zh-cn/azure/iot-edge/how-to-edgeagent-direct-method

 

PING

在IoT edge 中找到执行 direct method的设备，然后进入 edgeAgent module：

 

 

 

 

RestartModule

重启指定module：

在第八讲基础上运行的module，SensorModule会在重启后发送一条特殊的消息：Sensor Module Start

如下图所示：

 

接下来我们通过EdgeAgent的 RestartModule重启SensorModule，观察云端收到的数据

 

云端收到Module重启后发送的指令：

 

 

 

 

 

诊断相关的直接方法：

• GetModuleLogs：在直接方法的响应中检索内联模块日志。
• UploadModuleLogs：检索模块日志，并将其上传到 Azure Blob 存储。
• UploadSupportBundle：使用支持捆绑检索模块日志，并将 zip 文件上传到 Azure Blob 存储。
• GetTaskStatus：检查上传日志或支持捆绑请求的状态。

注意，IoT Edge Runtime 1.0.10 版本提供这些诊断直接方法。

 

---

声明：

点击可查阅本站文章目录 《文章分类目录》

本站所有内容仅代表个人观点，如与官文档冲突，请以官方文档为准。

可在本页面下方留言或通过下方联系方式联系我：

微信：wxyusz；邮箱：shuzhen.yu@foxmail.com

欢迎关注公众号“云计算实战”，接收最新文章推送。

本作品由Sean Yu 采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。
欢迎转载、使用、重新发布，但务必保留文章链接：https://www.51azure.cloud，且不得用于商业目的。