arduino-azure-iot-edge-integration

Arduino Azure IoT Edge 集成

当用户需要将 Arduino 类设备连接到 Azure IoT 时使用此技能，尤其是在边缘计算密集型场景中（网关、间歇性网络、离线缓冲和本地执行）。

何时使用

在以下请求中使用此技能：

• “我想将 Arduino 传感器连接到 Azure”
• “如何将 MQTT 遥测数据发送到 IoT Hub？”
• “我需要一个用于现场设备的边缘网关”
• “我想要云端到设备命令和 OTA 配置更新”

强制文档审查

在推荐 IoT Edge 拓扑或运行时行为之前，请审查：

• https://learn.microsoft.com/azure/iot-edge/

如果无法查阅文档，请基于明确假设继续，并在专门章节中突出这些假设。

官方 Arduino 参考和最佳实践（必需）

在提出固件、接线或通信实现细节之前，请先查阅官方 Arduino 来源：

• https://www.arduino.cc/en/Guide
• https://docs.arduino.cc/
• https://docs.arduino.cc/language-reference/
• references/arduino-official-best-practices.md

在实现方案之间进行选择时，优先采用官方 Arduino 指导，而不是社区片段，除非有明确的技术理由偏离。

目标

• 生成从 Arduino 设备到云端洞察的安全端到端参考路径。
• 处理不稳定链路（存储转发、重试、幂等性）。
• 定义可操作的设备和云待办事项。

集成模式

模式 A：Arduino 直连 IoT Hub

在连接稳定且云延迟可接受时使用。

• 协议：基于 TLS 的 MQTT。
• 身份：每设备凭据（SAS 或 X.509）。
• 遥测负载：包含时间戳、设备 ID、指标和可选质量标志的紧凑 JSON。

模式 B：Arduino 到本地网关，再到 IoT Edge

在链路受限、需要本地控制，或批处理可改善成本/可靠性时使用。

• Arduino 与本地网关通信（串口、BLE、本地 MQTT、RS-485、Modbus 桥接）。
• 网关通过 IoT Edge 运行时向上游发布，并将数据路由到 IoT Hub。
• 本地模块即使在云中断期间也可以过滤、聚合并触发操作。

设计流程

1) 设备契约

定义：

• 传感器目录和单位。
• 采样频率和预期吞吐量。
• 消息模式版本化策略。
• 用于控制运行时行为的期望/报告设备孪生属性。

2) 安全基线

要求：

• 每台设备的唯一身份。
• 源代码或固件产物中不得硬编码密钥。
• 凭据轮换策略。
• 尽可能使用签名固件和受控更新流程。

3) 可靠性和离线行为

规划并记录：

• 带抖动的退避。
• 有界大小的本地队列/缓冲策略。
• 重复抑制或下游幂等处理。
• 回退到上次已知良好配置。

4) 云和边缘路由

为以下内容定义路由：

• 原始遥测到冷存储。
• 精选遥测到热分析。
• 告警到运营渠道。
• 命令和配置返回到边缘/设备。

5) 可观测性

指定最低运营遥测：

• 设备心跳和固件版本。
• 连接状态转换。
• 消息发送成功/错误计数器。
• 网关模块健康和重启原因。

复用其他技能

在相关时，结合使用：

• azure-smart-city-iot-solution-builder 用于城市级架构和分阶段推出。
• azure-resource-visualizer 用于关系图。
• appinsights-instrumentation 用于应用和服务遥测模式。

同时使用 references/arduino-official-best-practices.md 作为固件和硬件推荐的质量基线，并在最终确定架构或实现指导之前使用 references/arduino-iot-checklist.md。

必需输出

始终提供：

1. 所选连接模式及其理由。
2. 消息契约（字段、单位、示例负载）。
3. 身份/凭据/更新的安全检查清单。
4. 可靠性方案（重试、缓冲、去重）。
5. 实施待办清单（固件、网关、云）。

输出模板

1. 场景与假设
2. 推荐架构
3. 设备与网关契约
4. 安全与可靠性控制
5. 部署方案与验证测试

指南

• 不要提议在设备间共享凭据的生产部署。
• 不要假设现场部署中始终在线连接。
• 在执行器场景中，不要省略命令授权与审计。