Azure Device Update for IoT Hub：华硕Tinker Board 2导入清单创建与镜像获取咨询

一、创建并导入更新清单 #

1. 准备更新内容 #

• 如果是整镜像更新：先制作适配Tinker Board 2的Debian 10镜像（需包含硬件驱动、deviceupdate-agent等必要组件），并计算镜像的SHA256哈希值用于校验。
• 如果是版本增量更新：整理好需要升级的软件包列表，或者编写自动化升级脚本（比如apt批量升级逻辑）。

2. 编写更新清单（JSON格式） #

清单是Device Update服务识别更新的核心文件，需包含设备匹配规则、更新步骤、文件信息：

整镜像更新清单示例

{
  "updateId": "tinkerboard2-debian10-v1.1",
  "description": "Tinker Board 2 Debian 10 完整镜像更新",
  "compatibility": [
    {
      "deviceManufacturer": "ASUS",
      "deviceModel": "Tinker Board 2",
      "osName": "Debian",
      "osVersion": "10"
    }
  ],
  "instructions": [
    {
      "type": "imageFlash",
      "handler": "mtd",
      "files": ["tinkerboard2-debian10-v1.1.img"],
      "properties": {
        "targetPartition": "/dev/mmcblk0"
      }
    }
  ],
  "files": [
    {
      "fileName": "tinkerboard2-debian10-v1.1.img",
      "sizeInBytes": 4294967296,
      "hashes": {
        "sha256": "替换为你的镜像SHA256哈希值"
      }
    }
  ]
}

增量版本更新清单示例

{
  "updateId": "tinkerboard2-debian10-patch-v1.0",
  "description": "Debian 10 软件包批量升级",
  "compatibility": [
    {
      "deviceManufacturer": "ASUS",
      "deviceModel": "Tinker Board 2",
      "osName": "Debian",
      "osVersion": "10"
    }
  ],
  "instructions": [
    {
      "type": "shell",
      "script": "apt update && apt upgrade -y && systemctl restart deviceupdate-agent",
      "handler": "shell"
    }
  ]
}

3. 导入清单到Device Update服务 #

• 若使用命令行工具deviceupdate-cli，执行以下命令（替换占位符为你的实际信息）：

  deviceupdate-cli import manifest --file ./your-manifest.json --account-id <你的账户ID> --instance-id <你的实例ID>
  

• 也可通过Device Update管理控制台上传清单文件，同时确保镜像/脚本文件已上传到服务关联的存储位置（内置存储或绑定的云存储）。

二、镜像文件的加载方式 #

• 自动下载（默认）：只要清单中files字段正确配置了服务可访问的文件地址，deviceupdate-agent会自动检测到更新清单，然后后台下载镜像/更新文件，无需手动拷贝到设备。
• 手动加载（离线场景）：如果设备无法联网，可提前将镜像文件放到设备本地路径（比如/tmp/update/），然后修改清单中files的路径为本地路径，更新指令调整为读取本地文件执行操作。

内容的提问来源于stack exchange，提问作者DaliDade