Compartilhar via

Arquivo de configuração da Atualização de Dispositivo para Hub IoT

  • Artigo

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

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

Local do arquivo

Ao instalar o agente do Debian em um Dispositivo IoT com um SO Linux, modifique o arquivo /etc/adu/du-config.json para atualizar os valores. Para um sistema de build Yocto, na partição ou no disco chamado adu, crie um arquivo JSON chamado /adu/du-config.json.

Lista de campos

Nome Descrição
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. Observe que adu-shell é um programa de agente que realiza várias ações de atualização como "raiz". Os manipuladores de atualização de conteúdo padrão da Atualização de Dispositivo invocam adu-shell para executar tarefas que exigem o privilégio de superusuário. Exemplos de tarefas que exigem esse privilégio são apt-get install ou executar scripts com privilégios.
aduc_manufacturer Relatado pela interface AzureDeviceUpdateCore:4.ClientMetadata:4 para classificar o dispositivo para direcionar a implantação de atualização.
aduc_model Relatado pela interface AzureDeviceUpdateCore:4.ClientMetadata:4 para classificar o dispositivo para direcionar a implantação de atualização.
connectionType Os valores aceitos 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 serviço de identidade de IoT para conectar o dispositivo ao Hub IoT. Para saber mais, confira entender as configurações do Serviço de Identidade IoT.
connectionData Se connectionType = "string", adicione a cadeia de conexão do módulo ou do dispositivo IoT aqui. Se connectionType = "AIS", defina connectionData como uma cadeia de caracteres varia ("connectionData": "").
fabricante Relatado pelo agente da Atualização de Dispositivo como parte da interface DeviceInformation.
modelo Relatado pelo agente da Atualização de Dispositivo como parte da interface DeviceInformation.

Conteúdo do arquivo de exemplo "du-config.json"


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