Atualização de dispositivo para o arquivo de configuração do Hub IoT

  • Artigo

O agente de Atualização de Dispositivo obtém suas informações de configuração do du-config.json arquivo no dispositivo. O agente lê esses valores e os relata ao serviço de Atualização de Dispositivo:

  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["fabricante"]
  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["modelo"]
  • DeviceInformation.fabricante
  • DeviceInformation.model
  • adicionalPropriedades
  • connectionData
  • Tipo de conexão

Localização do ficheiro

Ao instalar o agente Debian em um dispositivo IoT com um sistema operacional Linux, modifique o /etc/adu/du-config.json arquivo para atualizar valores. Para um sistema de construção Yocto, na partição ou disco chamado , crie um arquivo json chamado adu/adu/du-config.json.

Lista de campos

Name Description
SchemaVersion A versão do esquema que mapeia a versão atual do formato do arquivo de configuração.
aduShellTrustedUsers A lista de usuários que podem iniciar o programa adu-shell . Nota, adu-shell é um programa de corretagem que faz várias ações de atualização como 'root'. Os manipuladores de atualização de conteúdo padrão da Atualização de Dispositivo invocam adu-shell para executar tarefas que exigem privilégio de superusuário. Exemplos de tarefas que exigem esse privilégio são apt-get install : ou executando um script privilegiado.
aduc_manufacturer Relatado pela interface AzureDeviceUpdateCore:4.ClientMetadata:4 para classificar o dispositivo para direcionar a implantação da atualização.
aduc_model Relatado pela interface AzureDeviceUpdateCore:4.ClientMetadata:4 para classificar o dispositivo para direcionar a implantação da atualização.
Protocolo iotHub; Os valores aceitos são mqtt ou mqtt/ws para alterar o protocolo usado para se conectar ao hub IoT. O valor padrão é 'mqtt'
compatPropertyNames Essas propriedades são usadas para verificar a compatibilidade do dispositivo para direcionar a implantação da atualização. Para todas as propriedades especificadas a serem usadas para compatibilidade, os valores devem estar apenas em minúsculas
adicionalPropriedades Campo opcional. Propriedades adicionais relatadas pelo dispositivo podem ser definidas e usadas para verificação de comaptibilidade . Limitado a cinco propriedades do dispositivo. Estas propriedades devem estar apenas em minúsculas.
Tipo de conexão Os valores aceites são string ou AIS. Use string ao conectar o dispositivo ao Hub IoT manualmente para fins de teste. Para cenários de produção, use AIS ao usar o IoT Identity Service para conectar o dispositivo ao Hub IoT. Para obter mais informações, consulte Compreender as configurações do IoT Identity Service.
connectionData Se connectionType = "string", adicione a cadeia de conexão do dispositivo IoT ou do módulo aqui. Se connectionType = "AIS", defina connectionData como string vazia ("connectionData": "").
fabricante Relatado pelo agente de Atualização de Dispositivo como parte da interface DeviceInformation .
modelo Relatado pelo agente de Atualização de Dispositivo como parte da interface DeviceInformation .

Exemplo de conteúdo do arquivo "du-config.json"


{
  "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"
      }
    }
  ]
}