События устройства

Когда на устройстве OSS происходит значимое событие, оно регистрируется (например, EVENT_UPGRADE_COMPLETE). Эти события передаются в Azure, и их можно просмотреть на вкладке "Raw data" приложения IoT Central, к которому подключён OSS.

Пример события на вкладке "Raw data":

Ниже перечислены все события, которые могут встретиться при работе с устройствами OSS.

Управление паролем

EVENT_PASSWORD_REMOVAL_REQ

Сообщение: NFC password removal requested!

Значение: запрос на удаление пароля NFC инициирован через приложение OSS Companion, через Azure или троекратным нажатием кнопки "MD".

Примечание: кнопка "MD" - физическая кнопка на субсборке устройства OSS. Пользоваться ею следует только разработчикам, а также для удаления пароля, если связанный мобильный телефон недоступен, пароль забыт или нет подключения к облаку.

EVENT_PASSWORD_REMOVAL_SUCC

Сообщение: NFC password removed!

Примечание: удаление пароля NFC не завершится, пока мобильный телефон не установит NFC-контакт с устройством OSS: NFC-чип устройства OSS, в котором хранится пароль, питается не от самого устройства, а от мобильного телефона пользователя.

Обновление прошивки

EVENT_UPGRADE_START

Сообщение: Over-the-air firmware download started!

EVENT_UPGRADE_FAIL

Сообщение: Firmware download failed! Retrying.

Значение: после загрузки всех частей прошивки проверка контрольной суммы не прошла. Загрузка начнётся заново с первой части.

EVENT_UPGRADE_PART_DOWNLOAD

Сообщение: [part_num]/[total_chunks] of firmware downloaded!

Значение: часть прошивки загружена и добавлена в файл прошивки.

EVENT_UPGRADE_FULL_DOWNLOAD

Сообщение: Firmware download complete! Flashing firmware…

EVENT_UPGRADE_COMPLETE

Сообщение: Upgrade successful! New firmware version: [app_version]

EVENT_SUPERVISOR_UPGRADE_FAIL

Сообщение: Supervisor MCU’s firmware upgrade failed! Version mismatch detected!

Примечание: Supervisor MCU выполняет роль контроллера, отвечающего за NFC-интерфейс, питание OSS и управление батареей.

EVENT_SUPERVISOR_UPGRADE_SUCC

Сообщение: The supervisor firmware MCU was upgraded successfully!

Датчик

EVENT_SENSOR_INVALID_VALUE

Сообщение: [parameter] value out of range! [parameter]: [value]

Значение: показание датчика вышло за пределы заданного диапазона.

Заданные диапазоны:

• температура: от -40 до 85°C
• влажность: от 0% до 100%
• CO2: от 1 до 10,001 ppm

EVENT_SENSOR_TIMEOUT

Сообщение: Unable to read sensor parameters!

Значение: система трижды безуспешно пыталась прочитать данные датчика.

EVENT_SENSOR_NOT_FOUND

Сообщение: Unable to detect the sensor pod or the sensor pod did not boot!

EVENT_SENSOR_UPGRADE_FAIL

Сообщение: Sensor pod’s firmware upgrade failed! Version mismatch detected!

Значение: версия прошивки модуля датчиков не совпадает с ожидаемой.

Миграция устройства

EVENT_MIGRATE_START

Сообщение: Device migration started! Destination device ID: [device_id]

Значение: процесс миграции устройства начался.

EVENT_MIGRATE_SUCC

Сообщение: Device migrated! Destination device ID: [device_id]

Значение: миграция устройства успешно завершена.

EVENT_MIGRATE_FAIL

Сообщение: Device migration failed!

Значение: миграция устройства не удалась, выполнен возврат к исходной сущности устройства в IoT Central.

EVENT_MIGRATE_INVALID_KEY

Сообщение: Invalid primary key! Device migration will not start!

Значение: команда "Device Migrate" не выполнена из-за неверного первичного ключа, устройство возвращено к исходной сущности устройства в IoT Central.

Команда Advanced

EVENT_ADVANCED_ACCEPTED_CMD

Сообщение: "Advanced" command “([command])” accepted!

Значение: допустимая команда "Advanced" получена и успешно выполнена.

Примечание: команды "Advanced" дают дополнительные возможности, например калибровку уровня CO2.

EVENT_ADVANCED_REJECTED_CMD

Сообщение: "Advanced" command “([command])” rejected!

Значение: недопустимая команда "Advanced" отклонена. Причиной может быть опечатка или неподдерживаемая команда.