Archivo de configuración de Device Update para IoT Hub

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
• additionalProperties
• 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.
iotHubProtocol	Los valores aceptados son mqtt o mqtt/ws para cambiar el protocolo que se usa para conectarse con IoT Hub. El valor predeterminado es 'mqtt'
compatPropertyNames	Estas propiedades se usan para comprobar la compatibilidad del dispositivo con el destino de la implementación de actualizaciones. Para que todas las propiedades especificadas sean compatibles, los valores deben estar en minúsculas
additionalProperties	Campo opcional. Se pueden establecer y usar propiedades notificadas de dispositivo adicionales para la comprobación de compatibilidad. Limitado a cinco propiedades de dispositivo. Estas propiedades solo deben estar en minúsculas.
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"
  ],
  "iotHubProtocol": "mqtt",
  "compatPropertyNames":"manufacturer,model,location,language" <The property values must be in lower case only>,
  "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>,
      "additionalDeviceProperties": {
        "location": "usa",
        "environment": "development"
      }
    }
  ]
}