Compartir vía

Solución de problemas al usar los tutoriales de Eclipse ThreadX para dispositivos insertados

  • Artículo

A medida que sigue los tutoriales de Eclipse ThreadX para dispositivos insertados, es posible que experimente algunos problemas comunes. En general, se pueden producir problemas en cualquiera de los orígenes siguientes:

  • El entorno. La configuración y conexión de la máquina, el software o la red.
  • Los recursos de Azure IoT. El centro de IoT y el dispositivo que ha creado para conectarse a Azure IoT.
  • El dispositivo. La placa física y su configuración.

En este artículo, se proporcionan sugerencias de resolución para los problemas más comunes que se pueden producir al completar los tutoriales.

Requisitos previos

Para todos los pasos de solución de problemas, es necesario que haya completado los siguientes requisitos previos para el tutorial en el que trabaje:

  • Ha instalado o adquirido todos los requisitos previos y las herramientas de software para el tutorial.
  • Ha creado una aplicación de Azure IoT o Azure IoT Central, y ha registrado un dispositivo, como se indica en el tutorial.
  • Ha creado una imagen para el dispositivo, como se indica en el tutorial.

Problema: El directorio de origen no contiene el archivo CMakeLists.txt

Descripción

Este problema se puede producir al intentar compilar el proyecto. Es el resultado de que el proyecto se ha clonado incorrectamente desde GitHub. El proyecto contiene varios submódulos que no se clonarán de forma predeterminada a menos que se utilice la marca --recursive.

Solución

  • Al clonar el repositorio mediante Git, confirme que la opción --recursive está presente.

Problema: Se produce un error en la compilación

Descripción

El problema se puede producir porque la ruta de un archivo de objeto supera la longitud máxima de ruta predeterminada en Windows. Examine la salida de compilación para ver un mensaje similar al siguiente ejemplo:

-- 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

Solución

Puede probar una de las opciones siguientes para resolver este error:

  • Clone el repositorio en un directorio con una ruta más corta e inténtelo de nuevo.
  • Siga las instrucciones de Limitación de longitud máxima de ruta para habilitar rutas largas en Windows 11 versión 10 y versión 1607 y posteriores.

Problema: El dispositivo no se puede conectar a IoT Hub

Descripción

El problema se puede producir después de haber creado recursos de Azure y de haber actualizado el dispositivo. Al intentar conectar el dispositivo recién actualizado a Azure IoT, verá un mensaje de consola como el siguiente ejemplo:

Unable to resolve DNS for MQTT Server

Solución

  • Compruebe la ortografía y las mayúsculas y minúsculas de los valores de configuración que ha escrito para la configuración de IoT en el archivo azure_config.h. Los valores de algunos atributos de recursos de IoT, como deviceID y primaryKey, distinguen mayúsculas y minúsculas.

Problema: No se puede conectar la red Wi-Fi

Descripción

Después de actualizar un dispositivo que usa una conexión Wi-Fi, recibe un mensaje de error que indica que la red Wi-Fi no se puede conectar.

Solución

  • Compruebe la frecuencia y la configuración de la red Wi-Fi. Todos los dispositivos de los tutoriales para dispositivos insertados usan 2,4 GHz. Confirme que el enrutador Wi-Fi está configurado para admitir una red de 2,4 GHz.
  • Compruebe el modo de Wi-Fi. Confirme qué configuración ha usado para la constante WIFI_MODE en el archivo azure_config.h. Compruebe la configuración Wi-Fi de autenticación o seguridad de red para confirmar que el modo de seguridad de Wi-Fi coincide con lo que tiene en el archivo de configuración.

Problema: Se produce un error al actualizar la placa

Descripción

No puede completar el proceso de actualización del dispositivo. Los síntomas siguientes indican que el parpadeo está incompleto:

  • El archivo de imagen *.bin que ha creado no se copia en el dispositivo.
  • La utilidad que usa para actualizar el dispositivo genera una advertencia o un error.
  • La utilidad que usa para actualizar el dispositivo no indica que la programación se ha completado correctamente.

Solución

  • Asegúrese de que está conectado al puerto USB correcto en el dispositivo. Algunos dispositivos tienen más de un puerto.
  • Pruebe a usar otro cable Micro USB. Algunos dispositivos y cables no son compatibles.
  • Intente conectarse a otro puerto USB en el equipo. Es posible que un puerto USB esté desconectado internamente, deshabilitado en el software o en un estado inutilizable temporal.
  • Reinicie el equipo.

Problema: El dispositivo no se puede conectar al puerto

Descripción

Después de flashear su dispositivo y conectarlo a su ordenador, obtendrá un mensaje como el siguiente en su software de terminal:

Failed to initialize the port.
Please verify the COM port settings.

Solución

  • En la configuración del software de terminal, compruebe la opción Puerto para confirmar que ha seleccionado el puerto correcto. Si se muestran varios puertos, puede abrir el Administrador de dispositivos de Windows y seleccionar el nodo Puertos para buscar el puerto correcto para el dispositivo conectado.

Problema: La salida del terminal muestra texto codificado

Descripción

Después de actualizar el dispositivo correctamente y conectarlo al equipo, ve una salida de texto codificado en el software de terminal.

Solución

  • En la configuración del software de terminal, confirme que el valor de Velocidad en baudios es 115,200.

Problema: La salida del terminal no muestra texto

Descripción

Después de actualizar el dispositivo correctamente y conectarlo al equipo, no ve ninguna salida en el software de terminal.

Solución

  • Confirme que la configuración del software de terminal coincide con la del tutorial.
  • Reinicie el software de terminal.
  • Presione el botón Reset (Restablecer) en el dispositivo.
  • Confirme que el cable USB está conectado correctamente.

Problema: No funciona la comunicación entre el dispositivo e IoT Hub

Descripción

Después de flashear su dispositivo y conectarlo a su ordenador, obtendrá una salida como el siguiente mensaje en su ventana de terminal:

Failed to publish temperature

Solución

  • Confirme que el Nivel de precios y de escala es Gratis o Estándar. No se admite Básico, ya que no permite la comunicación de la nube al dispositivo y de dispositivos gemelos.

Problema: mensajes adicionales enviados al conectarse a IoT Central o a IoT Hub

Descripción

Dado que el módulo de Defender para IoT está habilitado de manera predeterminada desde el extremo del dispositivo, es posible que observe mensajes adicionales en la salida.

Solución

  • Para deshabilitarlo, defina NX_AZURE_DISABLE_IOT_SECURITY_MODULE en el archivo de encabezado nx_port.h de NetX Duo.

Pasos siguientes

Si después de revisar los problemas de este artículo, todavía no puede supervisar el dispositivo en un terminal ni conectarse a Azure IoT, es posible que haya un problema con el hardware o la configuración física del dispositivo. Vea la página del fabricante del dispositivo para buscar documentación y opciones de soporte técnico.