Azure IoT Device Update教程在树莓派3B/3B+启动卡住问题求助

故障排查与解决步骤 #

该启动卡住问题通常由镜像兼容性、SD卡异常、网络配置缺失、ADU代理配置错误或供电不足导致，可按以下步骤逐一处理：

• 步骤1：确认镜像适配性
  选择Azure IoT Hub Device Update发布的稳定版镜像，不要使用预发布测试版本，同时确认镜像和你使用的树莓派硬件型号（3B/3B+/4B/Zero系列）匹配，不要混用不同硬件的镜像。
• 步骤2：规范SD卡刷写流程
  • 优先使用官方Raspberry Pi Imager工具刷写镜像，刷写完成后等待工具自动完成校验，不要中途强制拔出SD卡
  • 刷写前将SD卡格式化为FAT32格式，优先选择Class 10以上、容量32GB及以下的正规品牌SD卡，避免使用扩容卡、劣质卡
• 步骤3：提前配置启动参数
  刷完镜像后先不要将SD卡插入树莓派，在电脑端访问SD卡的boot分区做如下修改：
  • 新建名为ssh的无后缀空文件，开启SSH远程访问权限
  • 新建名为wpa_supplicant.conf的配置文件，预写入WiFi连接信息，避免启动时等待网络连接超时卡住，文件内容参考：

country=CN
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
network={
ssid="你的WiFi名称"
psk="你的WiFi密码"
}

• 步骤4：临时禁用ADU代理排查配置问题
  如果完成以上操作还是卡住，可在boot分区的cmdline.txt文件末尾追加systemd.mask=adu-agent.service参数，临时禁用ADU代理的开机自启动。插入SD卡开机后通过SSH连接到设备，检查/etc/adu/du-config.json配置文件内的设备连接字符串、模型ID等参数是否正确，确认配置无误后执行systemctl enable adu-agent.service开启代理自启动即可。
• 步骤5：排查供电问题
  使用官方5V 3A及以上规格的电源为树莓派供电，不要用电脑USB口或者功率不足的第三方电源，避免供电不足导致启动过程中外设加载失败卡住。

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