Устранение неполадок с руководствами по внедренным устройствам Eclipse ThreadX
Следуя руководствам по внедренным устройствам Eclipse ThreadX, вы можете столкнуться с некоторыми распространенными проблемами. Как правило, они связаны с одним из следующих источников.
- Ваша среда. Это конкретный компьютер, программное обеспечение, настройки сети или подключение.
- Ваши ресурсы Интернета вещей Azure. Это центр Интернета вещей и устройство, которые вы создали для подключения к Интернету вещей Azure.
- Ваше устройство. Это физическая плата и ее конфигурация.
В этой статье приводятся рекомендуемые решения для наиболее распространенных проблем, которые могут возникнуть при выполнении учебников.
Необходимые компоненты
Все действия по устранению неполадок требуют, чтобы вы выполнили следующие предварительные требования для руководства, в который вы работаете:
- Вы установили или приобрели все необходимые компоненты и средства программного обеспечения для учебника.
- Вы создали центр Интернета вещей Azure или приложение Azure IoT Central и зарегистрировали устройство, как показано в руководстве.
- Вы создали образ для устройства, как показано в руководстве.
Проблема. Исходный каталог не содержит файла CMakeLists.txt
Description
Эта проблема может возникнуть при попытке выполнить компиляцию проекта. Это результат ошибки при клонировании проекта из GitHub. Проект содержит несколько вложенных модулей, которые по умолчанию не клонируются, если не указан флаг --recursive.
Разрешение
- При клонировании репозитория с помощью Git обязательно укажите аргумент --recursive.
Ошибка. Компиляция завершается ошибкой
Description
Эта ошибка может возникнуть из-за того, что путь к объектному файлу превышает стандартную максимальную длину пути в среде Windows. Проверьте выходные данные сборки для сообщения, аналогичного следующему примеру:
-- Configuring done
CMake Warning in C:/embedded tutorials/areallyreallyreallylongpath/getting-started/core/lib/netxduo/addons/azure_iot/azure_iot_security_module/iot-security-module-core/CMakeLists.txt:
The object file directory
C:/embedded tutorials/areallyreallyreallylongpath/getting-started/NXP/MIMXRT1060-EVK/build/lib/netxduo/addons/azure_iot/azure_iot_security_module/iot-security-module-core/CMakeFiles/asc_security_core.dir/./
has 208 characters. The maximum full path to an object file is 250
characters (see CMAKE_OBJECT_PATH_MAX). Object file
src/serializer/extensions/custom_builder_allocator.c.obj
cannot be safely placed under this directory. The build may not work
correctly.
-- Generating done
Разрешение
Чтобы устранить эту ошибку, выполните одно из следующих действий.
- Клонируйте репозиторий в каталог с более коротким путем и повторите попытку.
- Следуйте инструкциям в разделе "Ограничение максимальной длины пути" , чтобы включить длинные пути в Windows 11 и Windows 10 версии 1607 и более поздних версий.
Ошибка. Устройство не может подключиться к центру Интернета вещей
Description
Такая ошибка может возникнуть, если вы после создания ресурсов Azure перепрограммировали устройство. При попытке подключить новое устройство к Azure IoT вы увидите сообщение консоли, как показано в следующем примере:
Unable to resolve DNS for MQTT Server
Разрешение
- Проверьте правильность написания и регистра букв для всех значений конфигурации в файле конфигурации Интернета вещей azure_config.h. Значения некоторых атрибутов для ресурсов Интернета вещей, например
deviceID
иprimaryKey
, чувствительны к регистру.
Ошибка. Не удается подключить Wi-Fi
Description
После вспышки устройства, использующего подключение Wi-Fi, вы получите сообщение об ошибке, что Wi-Fi не удается подключиться.
Разрешение
- Проверьте частоту и параметры сети Wi-Fi. Устройства, используемые в руководствах по внедренным устройствам, используют 2,4 ГГц. Убедитесь, что на маршрутизаторе Wi-Fi настроена поддержка сети с частотой 2,4 ГГц.
- Проверьте режим Wi-Fi. Проверьте, какие параметры вы указали для константы WIFI_MODE в файле azure_config.h. Проверьте параметры Wi-Fi для сетевой безопасности или проверки подлинности и убедитесь, что режим безопасности Wi-Fi соответствует настройкам в файле конфигурации.
Ошибка. Перепрограммирование платы завершается ошибкой
Description
Вам не удается завершить процесс перепрограммирования устройства. Следующие симптомы указывают на то, что мигание является неполным:
- Созданный файл образа *.bin не удается скопировать на устройство.
- Программа перепрограммирования устройства выдает предупреждение или ошибку.
- Программа перепрограммирования устройства не выдает сообщения об успешном завершении операции программирования.
Разрешение
- Убедитесь, что вы подключены к правильному USB-порту на устройстве. Некоторые устройства имеют более одного порта.
- Попробуйте использовать другой кабель micro-USB. Некоторые устройства и кабели несовместимы.
- Попробуйте подключиться к другому USB-порту на компьютере. Возможно, этот USB-порт отсоединен на аппаратном уровне, отключен в программном обеспечении или временно неработоспособен.
- Restart your computer.
Ошибка. Устройство не может подключиться к порту
Description
После вспышки устройства и подключения к компьютеру вы получите следующее сообщение в программном обеспечении терминала:
Failed to initialize the port.
Please verify the COM port settings.
Разрешение
- В параметрах программы терминала убедитесь, что параметр Порт указывает на правильный порт. Если здесь отображается несколько портов, попробуйте открыть диспетчер устройств Windows и выбрать узел Порты, чтобы найти правильный порт для подключенного устройства.
Ошибка. В выходных данных терминала отображается нечитаемый текст
Description
После успешного перепрограммирования устройства при подключении его к компьютеру вы видите в программе терминала нечитаемый текст.
Разрешение
- В параметрах программы терминала убедитесь, что скорость передачи имеет значение 115 200.
Ошибка. В выходных данных терминала не отображается текст
Description
После успешного перепрограммирования устройства при подключении его к компьютеру вы не видите текста в программе терминала.
Разрешение
- Убедитесь, что параметры в программном обеспечении терминала соответствуют параметрам в руководстве.
- Перезапустите программу терминала.
- Нажмите кнопку Reset (Сбросить) на устройстве.
- Убедитесь, что USB-кабель подключен правильно.
Ошибка. Сбой связи между устройством и Центром Интернета вещей
Description
После вспышки устройства и подключения к компьютеру вы получите следующее сообщение в окне терминала:
Failed to publish temperature
Разрешение
- Убедитесь, что ценовая категория и уровень масштабирования имеют значения Бесплатный или Стандартный. Уровень "Базовый" не поддерживается, так как он не поддерживает обмен данными между облаком и устройством и с двойником устройства.
Проблема: дополнительные сообщения, отправленные при подключении к IoT Central или Центр Интернета вещей
Description
Так как модуль Defender для Интернета вещей включен по умолчанию из конца устройства, в выходных данных могут отображаться дополнительные сообщения.
Разрешение
- Чтобы отключить его, определите
NX_AZURE_DISABLE_IOT_SECURITY_MODULE
в файлеnx_port.h
заголовка NetX Duo.
Следующие шаги
Если изучение проблем, описанных в этой статье, не позволило вам нормально отслеживать устройство в терминале или подключиться к Интернету вещей Azure, возможно, существует проблема с оборудованием или физической конфигурацией устройства. Воспользуйтесь страницей изготовителя устройства, чтобы найти документацию и варианты поддержки для него.