Поделиться через


Файл конфигурации для службы "Обновление устройств для Центра Интернета вещей"

Агент обновления устройств получает сведения о конфигурации из файла du-config.json на устройстве. Агент считывает эти значения и передает их в службу "Обновление устройств".

  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["производитель"]
  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["модель"]
  • DeviceInformation.manufacturer
  • DeviceInformation.model
  • additionalProperties
  • connectionData
  • connectionType

Расположение файла

При установке агента Debian на устройстве Интернета вещей с ОС Linux измените файл /etc/adu/du-config.json для обновления значений. Для системы сборки Yocto в разделе или на диске с именем adu необходимо создать файл JSON с именем /adu/du-config.json.

Список полей

Имя Описание
SchemaVersion Версия схемы, которая сопоставляет текущую версию формата файла конфигурации.
aduShellTrustedUsers Список пользователей, которые могут запускать программу adu-shell. Обратите внимание, что adu-shell — это программа-брокер, которая выполняет различные действия обновления с использованием привилегированных прав. Стандартные обработчики обновления содержимого для службы "Обновление устройств" вызывают adu-shell для выполнения задач, для которых требуются права суперпользователя. Примеры задач, требующих этой привилегии: apt-get install или выполнение привилегированного скрипта.
aduc_manufacturer Это значение передается интерфейсом AzureDeviceUpdateCore:4.ClientMetadata:4 для классификации устройства с целью развертывания необходимых обновлений.
aduc_model Это значение передается интерфейсом AzureDeviceUpdateCore:4.ClientMetadata:4 для классификации устройства с целью развертывания необходимых обновлений.
iotHubProtocol Допустимые значения — это mqtt или mqtt/ws изменить протокол, используемый для подключения к Центру Интернета вещей. Значение по умолчанию — "mqtt"
compatPropertyNames Эти свойства используются для проверка для обеспечения совместимости устройства для целевого развертывания обновления. Для всех свойств, указанных для компатабиности, значения должны быть только в нижнем регистре.
additionalProperties Дополнительное поле. Дополнительные сообщаемые свойства устройства можно задать и использовать для comaptibility проверка ing. Поддерживается не более пяти свойств устройства. Эти свойства должны быть только в нижнем регистре.
connectionType Допустимые значения: string или AIS. Используйте string при подключении устройства к Центру Интернета вещей вручную в целях тестирования. Для сценариев в рабочей среде используйте AIS, если используется служба идентификации Интернета вещей для подключения устройства к Центру Интернета вещей. Подробные сведения см. в разделе Общие сведения о конфигурациях службы идентификации Интернета вещей.
connectionData Если connectionType = "string", добавьте строку подключения устройства Интернета вещей или модуля здесь. Если connectionType = "AIS", настройте connectionData как пустую строку ("connectionData": "").
manufacturer Это значение передается агентом обновления устройств как часть интерфейса DeviceInformation.
модель Это значение передается агентом обновления устройств как часть интерфейса DeviceInformation.

Например, содержимое файла 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"
      }
    }
  ]
}