Compartir vía

Archivo de configuración de Device Update para IoT Hub

  • Artículo

El agente de Device Update obtiene la información de configuración del archivo du-config.json en el dispositivo. El agente lee estos valores y los notifica al servicio Device Update:

  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["manufacturer"]
  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["model"]
  • DeviceInformation.manufacturer
  • DeviceInformation.model
  • connectionData
  • connectionType

Ubicación del archivo

Al instalar el agente de Debian en un dispositivo IoT con un sistema operativo Linux, modifique el archivo /etc/adu/du-config.json para actualizar los valores. Para un sistema de compilación Yocto, en la partición o disco denominado adu, cree un archivo JSON llamado /adu/du-config.json.

Lista de campos

Nombre Descripción
SchemaVersion La versión del esquema que asigna la versión actual del formato de archivo de configuración.
aduShellTrustedUsers Lista de usuarios que pueden iniciar el programa adu-shell. Tenga en cuenta que adu-shell es un programa agente que realiza varias acciones de actualización como "raíz". Los controladores de actualización de contenido predeterminados de Device Update invocan a adu-shell para realizar tareas que requieren privilegios de superusuario. Ejemplos de tareas que requieren este privilegio son apt-get install o la ejecución de scripts con privilegios.
aduc_manufacturer Indicado por la interfaz AzureDeviceUpdateCore:4.ClientMetadata:4 para clasificar el dispositivo y establecer como destino la implementación de la actualización.
aduc_model Indicado por la interfaz AzureDeviceUpdateCore:4.ClientMetadata:4 para clasificar el dispositivo y establecer como destino la implementación de la actualización.
connectionType Los valores aceptados son string o AIS. Use string al conectar el dispositivo a IoT Hub manualmente con fines de prueba. En escenarios de producción, use AIS al utilizar el servicio de identidad de IoT para conectar el dispositivo a IoT Hub. Para obtener más información, consulte la información sobre las configuraciones del servicio de identidad de IoT.
connectionData Si connectionType = "string", agregue aquí la cadena de conexión del dispositivo o módulo del dispositivo IoT. Si connectionType = "AIS", establezca connectionData en una cadena vacía ("connectionData": "").
fabricante El agente de Device Update lo notifica como parte de la interfaz DeviceInformation.
model El agente de Device Update lo notifica como parte de la interfaz DeviceInformation.

Contenido de archivo "du-config.json" de ejemplo


{
  "schemaVersion": "1.1",
  "aduShellTrustedUsers": [
    "adu",
    "do"
  ],
  "manufacturer": <Place your device info manufacturer here>,
  "model": <Place your device info model here>,
  "agents": [
    {
      "name": <Place your agent name here>,
      "runas": "adu",
      "connectionSource": {
        "connectionType": "string", //or “AIS”
        "connectionData": <Place your Azure IoT device connection string here>
      },
      "manufacturer": <Place your device property manufacturer here>,
      "model": <Place your device property model here>
    }
  ]
}