Устранение неполадок с устройством Azure Percept DK

  • Статья

Важно!

Прекращение поддержки Azure Percept DK.

Обновление 22 февраля 2023 г.: обновление встроенного ПО для периферийных компонентов Percept DK Vision and Audio (также известных как Визуальное и звуковое SOM) теперь доступно здесь и позволит компонентам аксессуаров продолжать работу после даты прекращения использования.

Общедоступная предварительная версия Azure Percept будет развиваться для поддержки новых платформ пограничных устройств и возможностей разработчика. В рамках этой эволюции Azure Percept DK и аудио-аксессуаров и связанных служб Поддержки Azure для Percept DK будет прекращена 30 марта 2023 г.

Начиная с 30 марта 2023 г. Azure Percept DK и аудиосхозяйки больше не будут поддерживаться службами Azure, включая Azure Percept Studio, обновления ОС, обновления контейнеров, просмотр веб-потока и интеграцию Пользовательское визуальное распознавание. Корпорация Майкрософт больше не будет предоставлять поддержку по успешному выполнению клиентами и связанные с ней вспомогательные услуги. Дополнительные сведения см. в записи блога Уведомление о прекращении поддержки.

Цель этой статьи, посвященной вопросам устранения неполадок, — помочь пользователям Azure Percept DK быстро устранять распространенные проблемы, связанные с пакетами средств разработки. Кроме того, в ней содержатся рекомендации по сбору журналов для получения дополнительной поддержки.

Сбор журналов

В этом разделе приведены рекомендации по выбору и сбору журналов.

Сведения о сборе журналов

  1. Подключитесь к своему пакету средств разработки по протоколу SSH.

  2. Выполните необходимые команды в окне терминала SSH. Список команд сбора журналов см. в следующем разделе.

  3. Перенаправьте все выходные данные в TXT-файл для дальнейшего анализа, используя следующий синтаксис:

    sudo [command] > [file name].txt

  4. Измените разрешения для TXT-файла, чтобы его можно было скопировать:

    sudo chmod 666 [file name].txt

  5. Скопируйте файл на свой компьютер узла через SCP:

    scp [remote username]@[IP address]:[remote file path]/[file name].txt [local host file path]

    [local host file path] — это расположение на хост-компьютере, куда будет скопирован файл .txt. [remote username] —это имя пользователя SSH, выбранное во время установки.

Типы журналов и команды

Назначение журнала Случаи, в которых нужно собирать журнал Команда
Пакет поддержки: предоставляет набор журналов, необходимых для большинства запросов на поддержку клиентов. Этот журнал следует собирать при запросе поддержки. sudo iotedge support-bundle --since 1h

В выражении "--since 1h" можно указать любой промежуток времени, например "6h" (6 часов), "6d" (6 дней) или "6m" (6 минут)
Журналы OOBE: в этих журналах записываются сведения о настройке. Эти журналы необходимо собирать во время настройки. sudo journalctl -u oobe -b
Журналы edgeAgent: в этих журналах записываются номера версий всех модулей, работающих на вашем устройстве. Эти журналы следует собирать, если не работает один или несколько модулей. sudo iotedge logs edgeAgent
Журналы контейнеров модулей: в этих журналах записываются сведения об определенных контейнерах модулей IoT Edge Эти журналы следует собирать при обнаружении проблем, связанных с каким-либо модулем sudo iotedge logs [container name]
Сетевые журналы: набор журналов, охватывающий службы Wi-Fi и сетевой стек. Эти журналы следует собирать при обнаружении проблем, связанных с Wi-Fi или сетью. sudo journalctl -u hostapd.service -u wpa_supplicant.service -u ztpd.service -u systemd-networkd > network_log.txt

cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version && rpm -q ztpd > system_ver.txt

Выполните обе команды. Каждая команда собирает несколько журналов и помещает их в один набор выходных данных.

Предупреждение

Выходные данные команды support-bundle могут содержать имена узлов, устройств и модулей, сведения, регистрируемые модулями и т. д. Имейте это в виду при совместном использовании выходных данных на общедоступном форуме.

Устранение неполадок с командами

Ниже приведен набор команд, которые можно использовать для устранения неполадок, связанных с пакетом средств разработки. Чтобы выполнить эти команды, необходимо сначала подключиться к пакету средств разработки по протоколу SSH.

Дополнительные сведения о командах Azure IoT Edge см. в документации по устранению неполадок в устройствах Azure IOT Edge.

Функция Назначение Команда
Проверка версии программного обеспечения в пакете средств разработки. Используйте эту функцию, когда нужно узнать версию программного обеспечения в используемом вами пакете средств разработки. cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version
Проверка температуры пакета средств разработки Используйте эту функцию, когда вы считаете, что пакет средств разработки перегревается. cat /sys/class/thermal/thermal_zone0/temp
Проверка идентификатора телеметрии в пакете средств разработки. Используйте эту функцию, когда необходимо узнать уникальный идентификатор телеметрии пакета средств разработки. sudo azure-device-health-id
Проверка состояния IoT Edge Используйте эту функцию, если возникают проблемы с модулями IoT Edge, подключаемыми к облаку. sudo iotedge check
Перезапуск управляющей программы системы безопасности Azure IoT Edge Используйте эту функцию, если IoT Edge не отвечает или работает неправильно. sudo systemctl restart iotedge
Отображение списка развернутых модулей Azure IoT Edge Используйте эту функцию, когда необходимо просмотреть все модули, развернутые в пакете средств разработки sudo iotedge list
Отображение доступного и общего места в указанных файловых системах Используйте эту функцию, если необходимо узнать доступное место в хранилище в пакете средств разработки. df [option] [file]
Отображение сведений об IP-адресе и интерфейсе пакета средств разработки Используйте эту функцию, если необходимо узнать IP-адрес пакета средств разработки. ip route get 1.1.1.1
Отображение только IP-адреса пакета средств разработки Используйте эту функцию, если нужно узнать только IP-адрес пакета средств разработки, а не другие сведения о интерфейсе. ip route get 1.1.1.1 | awk '{print $7}'
ifconfig [interface]

Ошибки обновления USB

Ошибка: Решение:
LIBUSB_ERROR_XXX во время обновления UUU через USB Эта ошибка возникает при сбое USB-подключения во время обновления UUU. Ошибки такого рода возникают, если кабель USB неправильно подключен к портам USB на компьютере или к плате-носителю Percept DK. Попробуйте отключить и повторно подключить оба конца USB-кабеля и пошевелите кабель, чтобы обеспечить надежное подключение.

Очистка места на жестком диске в Azure Percept DK

Существует два компонента, занимающие место на жестком диске Azure Percept DK, — журналы контейнеров Docker и сами контейнеры Docker. Чтобы журналы контейнеров не заняли все свободное место на жестком диске, в Azure Percept DK имеется встроенная функция ротации журналов, которая удаляет старые журналы по мере создания новых.

Если из-за большого количества контейнеров Docker на жестком диске не хватает места, можно удалить неиспользуемые контейнеры, выполнив указанные ниже действия.

  1. Подключение к пакету средств разработки по протоколу SSH
  2. Выполните следующую команду: docker system prune

При этом будут удалены все неиспользуемые контейнеры, сети, образы и, возможно, тома. Дополнительные сведения см. на этой странице.

Индикаторы на плате-носителе Azure Percept DK

На корпусе платы-носителя есть три небольших светодиодных индикатора. Рядом с индикатором 1 изображен значок облака, рядом с индикатором 2 — значок Wi-Fi, с индикатором 3 — значок восклицательного знака. Состояния светодиодных индикаторов описаны в следующей таблице.

Светодиодный индикатор Состояние Описание
Светодиод 1 (Центр Интернета вещей) Светится (непрерывно) Устройство подключено к Центру Интернета вещей.
Светодиод 2 (Wi-Fi) Медленно мигает Устройство готово к настройке с помощью Wi-Fi Easy Connect и сообщает о себе конфигуратору.
Светодиод 2 (Wi-Fi) Быстро мигает Проверка подлинности прошла успешно, выполняется связывание устройства.
Светодиод 2 (Wi-Fi) Светится (непрерывно) Проверка подлинности и связывание успешно выполнены; устройство подключено к сети Wi-Fi.
Светодиод 3 Н/Д Светодиодный индикатор не используется.