Atualização de dispositivo para o arquivo de configuração do Hub IoT
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,environment" <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"
}
}
]
}