Solucionar problemas de Azure Sphere

Desde un terminal:

1. Ejecuta sudo lsusb. Compruebe que Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC aparece en la salida.

Usando una ventana de PowerShell:

1. Ejecuta Get-PnpDevice -PresentOnly | Where-Object { $_. InstanceId -match '^USB' }. Verifique que msft MT3620 Std Interface aparezca en la salida.

Si no puede desconectar y volver a conectar el dispositivo, la siguiente mejor opción es reiniciar el DCS. Desde un terminal:

1. Ejecuta sudo azspheredctl restart. Comprueba que el comando se complete correctamente.
   1. Si se produce un error en el comando, ejecute sudo systemctl restart azsphered.

Si no puede desconectar y volver a conectar el dispositivo, la siguiente mejor opción es emitir un comando de rescan para el DCS. Al recibir este comando, el DCS ciclo y reajusta el chip de interfaz FTDI utilizado para comunicarse con el MT3620. Usando una ventana de PowerShell:

1. Ejecutar el comando az sphere device rescan-attached

Ahora vuelva a ejecutar el comando que intentó inicialmente. Si el problema sigue sin resolverse, la siguiente mejor opción es intentar reiniciar el DCS. Desde una ventana de Powershell de nivel de administrador:

1. Ejecuta Restart-Service -Name AzureSphereDeviceCommunicationService. Comprueba que el comando se complete correctamente.

Como alternativa, reinicie el DCS con una interfaz gráfica de usuario.

1. Presione Inicio y escriba Servicios. Haga clic con el botón derecho en el Servicio de comunicación de Dispositivo Azure Sphere y seleccione Reiniciar.

Error al crear cuatro convertidores serie USB

Después de configurar una placa de desarrollo MT3620, deberías ver cuatro convertidores serie USB en Administrador de dispositivos. Si ve menos de cuatro, es posible que tenga un problema con el controlador FTDI.

Si el controlador FTDI no está instalado correctamente, es posible que los convertidores aparezcan en una ubicación incorrecta, como Otros dispositivos, o que no aparezcan en absoluto.

Para resolver este problema:

1. Para abrir Administrador de dispositivos, haga clic en Inicio y escriba Administrador de dispositivos.

2. En Controladores de bus serie universal, selecciona USB Serial Converter A. Haz clic con el botón derecho en el nombre, selecciona Desinstalar dispositivo y elimina el controlador si aparece la opción:

   

   Repite este paso para usb serial converter B a USB Serial Converter D.

3. Desconecta la placa de desarrollo del equipo y vuelve a enchufarla. "MSFT MT3620 Std Interface" debe aparecer con un icono de advertencia de triángulo, que indica que no hay ningún controlador disponible.

4. Haz clic con el botón derecho en uno de los dispositivos MSFT MT3620 Std Interface y selecciona Actualizar controlador. Elige Búsqueda automáticamente para obtener software de controlador actualizado. Actualizar uno debería corregirlos todos. Ahora deberías ver cuatro convertidores serie USB en la sección Controladores de bus serie universal. Si no aparecen los cuatro convertidores, repita este paso para cada convertidor.

Error al instalar controladores FTDI

Windows debe descargar e instalar automáticamente los controladores FTDI cuando el dispositivo Azure Sphere se conecte por primera vez a su equipo. Si los controladores están instalados correctamente, verás cuatro convertidores serie USB enumerados en Controladores de bus serie universal en Administrador de dispositivos, como se describe en Configurar el kit de desarrollo.

Windows 10, versión 2004, no busca los controladores. En este caso, los controladores no se descargan e instalan automáticamente y verás los siguientes elementos enumerados en Administrador de dispositivos:

Para instalar los controladores, descarga manualmente los controladores desde Future Technology Devices International (FTDI). Elige el controlador que coincida con la instalación de Windows (32 o 64 bits).

Para ver las fechas de disponibilidad y los números de compilación de las versiones de Windows 10, consulte Windows 10 información de lanzamiento. Esta información puede ayudarle a determinar si su versión de Windows 10 es anterior o posterior a la versión 2004.

Problemas de conexión causados por la configuración del adaptador de TAP-Windows

Las herramientas de Azure Sphere se comunican con los paneles de desarrollo conectados mediante una red IP a través de USB. Esto requiere el adaptador de TAP-Windows de OpenVPN Technologies. El procedimiento de instalación del SDK de Azure Sphere instala este adaptador en el equipo si aún no está presente.

Se han notificado dos tipos distintos de problemas con el adaptador de TAP-Windows:

• Si ya hay una versión diferente del adaptador de TAP-Windows instalada, o si el dispositivo Azure Sphere no está conectado a la primera instancia del adaptador de TAP-Windows, es posible que las herramientas de Azure Sphere no puedan conectarse a su dispositivo.

• Si usted está utilizando la red privada virtual de Cisco AnyConnect (VPN), su adaptador de TAP-Windows puede aparecer desenchufado y la comunicación del dispositivo puede no funcionar. Esto se debe a que la VPN puede redirigir el tráfico lejos de la dirección IP del adaptador TAP.

Asegúrese de que el dispositivo Azure Sphere esté conectado al adaptador de TAP-Windows adecuado

Para determinar si el problema está relacionado con el adaptador TAP, primero averigua cuántos adaptadores TAP están instalados en tu PC y, a continuación, modifica la instalación si es necesario.

Para determinar cuántos adaptadores TAP están instalados en tu PC:

1. Abre Configuración de Windows y selecciona el grupo Red & Internet .

2. En Configuración avanzada de red, selecciona Cambiar opciones del adaptador. Deberías ver solo un adaptador TAP, como se muestra en la siguiente captura de pantalla:

   

   Si ves más de un adaptador DE TAP, o si ves solo un adaptador TAP pero su nombre no es Azure Sphere, sigue estos pasos para desinstalar todos los adaptadores TAP y reinstalar el SDK. Si no ve ningún adaptador TAP, vuelva a instalar el SDK.

Para desinstalar los adaptadores TAP:

1. Haga clic en Inicio y escriba Administrador de dispositivos.

2. En Administrador de dispositivos, abre Adaptadores de red y selecciona TAP-Adaptador de Windows:

   

3. Haz clic con el botón derecho en Adaptador tap-Windows y selecciona Desinstalar dispositivo. En el cuadro de diálogo, selecciona Eliminar el software de controlador de este dispositivo y, a continuación, haz clic en Desinstalar.

4. Abra un símbolo del sistema como administrador y ejecute el siguiente script del instalador de Powershell:

    powershell -ExecutionPolicy RemoteSigned -File "%ProgramData%\Microsoft\Azure Sphere\TapDriverInstaller\TapDriverInstaller.ps1" Install
   

5. Si la instalación se realiza correctamente, reinicie el Servicio de comunicación de dispositivo Azure Sphere:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

6. Vuelva a instalar el SDK de Azure Sphere.

Corregir el estado desenchufado al utilizar el cliente VPN Cisco AnyConnect

Cuando usted está utilizando el cliente VPN de Cisco AnyConnect, el adaptador de TAP-Windows puede aparecer desenchufado y la comunicación del dispositivo puede no estar funcionando. Puede corregir el problema de la siguiente manera:

1. Asegúrese de que tiene privilegios de administrador en el equipo.

2. Abre Configuración de Windows y selecciona el grupo Red & Internet .

3. En Configuración avanzada de red, selecciona Cambiar opciones del adaptador.

4. Haz clic con el botón derecho en Azure Sphere TAP-Windows Adapter V9 y selecciona Propiedades.

5. En la ficha redes , busque la entrada del controlador de filtro del administrador de acceso de la red de Cisco AnyConnect y borre el elemento.

   

6. Selecciona Aceptar para guardar la configuración y salir de las propiedades.

7. Comprueba que la comunicación con tu dispositivo Azure Sphere está funcionando abriendo un símbolo del sistema y escribiendo el az sphere device show-attached comando.

El dispositivo no responde

Uno o varios de los siguientes errores de un comando azsphere pueden indicar que no se pudo iniciar el servicio de comunicación de dispositivo de Azure Sphere:

• warn: Device is not responding. Could not perform version check.​
• Device is not responding. Cannot get device ID.​
• error: Could not connect to the Azure Sphere Device Communication Service. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.​
• error: The device is not responding. The device may be unresponsive if it is applying an Azure Sphere operating system update; please retry in a few minutes.

Asegúrate de que has realizado los pasos de solución de problemas de comunicación del dispositivo.

Si el problema sigue sin resolverse y el equipo ha realizado recientemente una actualización de Windows, es posible que el servicio de comunicación del dispositivo no se inicie después de la actualización de Windows y en los casos en que uno de los archivos de configuración JSON internos o el archivo de configuración se haya dañado.

Error tras Windows Update

Estos errores pueden producirse después de actualizar Windows en el PC. A veces Windows Update desinstala los controladores FTDI necesarios para el servicio de comunicación.

Para resolver el problema:

1. Desconecta el dispositivo Azure Sphere de USB y conéctalo de nuevo. Después de desconectar el dispositivo, deben reinstalar los controladores correctos.
2. Si el problema no se soluciona desconectando y desconectando el dispositivo, desinstale y vuelva a instalar el SDK de Azure Sphere.

Archivo JSON

Si no ha actualizado Windows recientemente, la causa del error podría ser el restore.json archivo que se usa para el servicio.

Para resolver este problema:

1. Guarde una copia del archivo siguiente:

   c:\windows\serviceprofiles\localservice\appdata\local\Azure Sphere Tools\restore.json

2. Elimine el archivo de su ubicación original.

3. Detenga y reinicie el Servicio de comunicación de Dispositivo azure Sphere:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

Archivo de configuración dañado

Si se notifica un error al intentar ejecutar un comando, es posible que el archivo de configuración dañado impida que el dispositivo se ejecute correctamente.

Para resolver este problema, elimine el archivo de configuración dañado ubicado en .azsphere\config en Windows o ~/.azsphere/config en Linux.

Windows se bloquea al conectar o desenchufar un dispositivo

La placa para desarrolladores MT3620 tiene un chip FT4232HQ Future Technology Devices International (FTDI), que facilita la comunicación entre el dispositivo y el PC. El controlador oficial FTDI, Combined Driver Model (CMD), contiene dos controladores: uno proporciona acceso a través de la API D2XX, y el otro proporciona un puerto com virtual (VCP) para el mismo dispositivo. Ambos controladores se instalan de manera predeterminada si el chip FTDI tiene el modo VCP habilitado. Esto puede provocar que Windows se bloquee cuando el chip esté encendido/apagado.

Para resolver este problema, usted puede inhabilitar el modo VCP para el chip FTDI. Deberás usar la herramienta FT_PROG para reprogramar el EEPROM del chip FTDI.

1. Consulte FTDI FT_PROG herramienta de programación para averiguar cómo descargar e instalar esta herramienta.

2. Ejecuta FT_PROG y busca el dispositivo conectado, como se describe en FT_PROG aplicación GUI.

3. En la vista Árbol de dispositivos, expande la sección Específico de hardware . Deberías ver cuatro puertos.

   

4. Seleccione Puerto A y elija D2XX Direct en lugar de Puerto com virtual.

   

5. Repita el paso anterior para el puerto C y el puerto D. El puerto B debe estar ya en el modo directo D2XX.

6. Seleccione el icono Dispositivos de programa (similar a un rayo) para entrar en el modo de programación.

   

7. Selecciona Programa para programar el EEPROM y espera a que finalice.

   

8. Desconecta el dispositivo del puerto USB, vuelve a conectarlo al ciclo de energía del dispositivo y haz que el cambio surta efecto. En Windows Administrador de dispositivos, la sección de puertos (COM & LPT) ahora debe mostrar tres puertos COM menos. El número de dispositivos bus serie universal debe permanecer el mismo.

Se ha perdido la conexión a dispositivos FTDI que no son de Azure Sphere después de habilitar la depuración rtApp

Algunos usuarios de Azure Sphere han informado de que ya no pueden comunicarse con otros dispositivos FTDI de Esfera de Azure adjuntos después de usar el comando az sphere device enable-development --enable-rt-core-debugging para desarrollar y depurar RTApps desde su equipo host.

Por ejemplo, si tienes un dispositivo Azure Sphere y otro dispositivo FTDI conectado a tu PC, es posible que veas dos controladores serie universales denominados dispositivos USB Serial Converter B en Windows Administrador de dispositivos antes de ejecutar el comando.

Después de ejecutar el comando, ambos dispositivos USB Serial Converter B desaparecen de la sección Controlador de bus serie universal y aparecen dos nuevos dispositivos en los dispositivos bus serie universal en Administrador de dispositivos.

Causa

Este problema se produce porque el comando az sphere device enable-development --enable-rt-core-debugging instala un nuevo controlador para el puerto B del chip FTDI en el MT3620; el puerto se convierte en MSFT MT3620 Std Interface. Sin embargo, la instalación de este controlador cambia involuntariamente el controlador para el puerto B del otro dispositivo que no sea Azure Sphere. Debido a una limitación en la biblioteca subyacente, todos los dispositivos FTDI con el mismo VID (0x0403) y PID (0x6011) tendrán su controlador port B reemplazado.

Solución

Siga estos pasos para revertir manualmente el controlador de cualquier dispositivo que no sea Azure Sphere a su versión anterior:

1. En Administrador de dispositivos, seleccione el dispositivo que no es Azure Sphere (otro FTDI Quad GZ en el ejemplo) y, a continuación, haga clic con el botón derecho y seleccione Actualizar controlador.

2. En Actualizar controladores, selecciona Buscar software de controlador en el equipo.

   

3. Selecciona Elegir en una lista de controladores disponibles en el equipo.

   

4. Selecciona Controlador USB Serial Converter B en la lista y, a continuación, haz clic en Siguiente.

   

5. Haga clic en Cerrar en la ventana de confirmación.

6. Administrador de dispositivos debe mostrar el puerto B para el otro dispositivo FTDI como USB Serial Converter B, que indica que utiliza el controlador FTDI oficial. El controlador para el MT3620 sigue siendo MSFT MT3620 Std Interface.

   

Información adicional

• Si conectas otro nuevo dispositivo FTDI que no sea azure Sphere después de ejecutar el comando azsphere device enable-development --enable-rt-core-debugging , ese dispositivo se asignará del mismo modo al controlador de Azure Sphere MT3620. Repita los pasos anteriores para revertir el dispositivo al controlador ftdi oficial.

• Si desconectas y vuelves a enchufar un dispositivo FTDI de esferas que no sea azure después de devolverlo al controlador oficial de FTDI, el dispositivo conservará el controlador ftdi oficial.

• Si ejecutas de nuevo el comando az sphere enable-development --enable-rt-core-debugging después de revertir el controlador, el dispositivo FTDI que no sea de Azure Sphere volverá a tener su controlador reemplazado y tendrás que seguir los pasos de la Solución para revertir al controlador FTDI oficial. Esto ocurre independientemente de si el dispositivo FTDI no Azure Sphere está conectado al equipo cuando se ejecuta el comando az sphere device enable-development --enable-rt-core-debugging .

Comandos no reconocidos

Si ve el siguiente error al introducir un comando azsphere, asegúrese de que está usando PowerShell o un símbolo del sistema estándar en Windows.

'azsphere' is not recognized as an internal or external command, operable program or batch file.

El instalador se bloquea al 60 por ciento

El instalador se bloquea al 60 % y se le indica que el servicio de comunicación de dispositivos no se ha iniciado correctamente. Esto suele ocurrir cuando la instalación del controlador TAP falla de una manera extraña, dejando el sistema en un estado indeterminado.

Confirma que el problema es el controlador TAP

1. Abre el Visor de eventos de Windows para comprobar los registros.

2. Busque el siguiente mensaje de error en el registro de la aplicación y en el registro del servicio de comunicación de dispositivo azure Sphere:

   "SerialSlipToTun.TunTunesSetupException: Configuración del Registro de tun de acceso de error ---> System.Collections.Generic.KeyNotFoundException: No se encuentra el dispositivo tap tun ---> System.Security.SecurityException: no se permite el acceso al Registro solicitado".

   

3. Al comprobar el registro de aplicaciones, filtre el registro para evitar ver los muchos mensajes no relacionados. En la pestaña Acción , seleccione Filtrar registro actual.

4. Seleccione Error y, a continuación, seleccione AzureSphereDeviceCommunicationService para enumerar solo los mensajes de error del Servicio de comunicación de dispositivos Azure Sphere.

   

5. Si no encuentra el error en el registro de aplicaciones o en el registro del servicio de comunicación de dispositivo azure Sphere, es posible que no se trate de un problema de controlador TAP.

Para resolver el problema del controlador TAP, sigue estos pasos:

1. Ve al Centro de redes y recursos compartidos y selecciona Cambiar la configuración del adaptador.

   

2. En Network Connections en Azure Sphere, selecciona TAP-WIndows Adapter V9 y abre sus propiedades.

   

3. En Propiedades de Azure Sphere, selecciona Protocolo de Internet versión 4 (TCP/IPv4) y , a continuación , propiedades para ver la configuración del protocolo.

   

4. Asegúrese de que la dirección IP se fija a 192.168.35.1 y la máscara de subred se fija a 255.255.255.0.

5. Pruebe el instalador de nuevo. Si sigue cuelgándose, intenta restablecer las conexiones de red. Para realizar un restablecimiento, ve a Configuración>Red &Estado de Internet > y selecciona Restablecimiento de red cerca de la parte inferior de la página.

   Importante

   Al restablecer la red se restablecerá toda la configuración de red.

Detener el servicio de comunicación de Azure Sphere Device

Si el instalador se bloquea, puede detener el Servicio de comunicación de Dispositivo azure Sphere usando el comando taskkill .

Sigue estos pasos:

1. Copie el PID para AzureSphereDeviceCommunicationService.

   • Vaya a la pestañaServiciosdel Administrador> de tareas y anote el PID para el servicio AzureSphereDeviceCommunicationService, o bien
   • En la línea de comandos, escriba tasklist /fi "SERVICES eq AzureSphereDeviceCommunicationService*" y copie el PID de la salida.

2. Escriba lo siguiente en la línea de comandos para finalizar el servicio. El comando taskkill finaliza el proceso que corresponde al número de id. del proceso. La /f opción se usa para finalizar con fuerza el proceso.

   taskkill /PID <DCS_PID> /f

3. Pruebe el instalador de nuevo.

No se puede detener el servicio de comunicación azure sphere device

Al actualizar un SDK de Azure Sphere existente, es posible que vea un mensaje que diga "No se pudo detener el servicio 'Servicio de comunicación de dispositivos de Azure Sphere' (AzureSphereDeviceCommunicationService). Comprueba que tienes privilegios suficientes para detener los servicios del sistema". Si recibe este mensaje, reinicie y ejecute el instalador de nuevo.

La comunicación del dispositivo se rompe cuando se usa el túnel dividido

Cuando un equipo de desarrollo está conectado a la VPN corporativa y el túnel dividido está deshabilitado por la configuración de VPN, es posible que el equipo de desarrollo no pueda comunicarse con el dispositivo Azure Sphere.

Para resolver este problema, siga uno de estos procedimientos:

• Desconecta de la VPN corporativa y prueba de nuevo la conexión con el dispositivo Azure Sphere.
• Cambie la configuración vpn para permitir el túnel dividido.

Los problemas de comunicación también pueden deberse a la configuración del adaptador de TAP-Windows. Consulta la sección Problemas de conexión causados por TAP-Windows solución de problemas de configuración del adaptador.

No se puede instalar ni desinstalar el SDK de Azure Sphere en Windows 11

Después de actualizar a Windows 11, los usuarios no pueden instalar ni desinstalar el SDK de Azure Sphere. Para resolver este problema, instale la versión más reciente de Azure Sphere SDK para Windows. Después de instalar 21.07 Update 2 o posterior, podrás desinstalar el SDK.

No se pueden compilar ni depurar RTApps

Si CMake notifica errores al encontrar las cadena de herramientas o openocd al intentar crear o depurar una RTApp, asegúrese de que:

• Has instalado el GNU Arm Embedded Toolchain para tu entorno de desarrollo.
• Ha especificado la ruta de acceso correcta a openocd como se describe en Tutorial: Crear una aplicación compatible con tiempo real.

Solución de problemas de comunicación de dispositivos antes de la versión 23.05

En sistemas Linux que ejecutan SDK versión 22.11 o anterior, el script de azsphere_connect.sh debe ejecutarse cada vez que conectes el dispositivo o lo desenchufes o vuelvas a conectarlo. El script actualiza las conexiones de los dispositivos y genera un controlador de kernel que asigna el tráfico de red al dispositivo.

Si tiene problemas de comunicación, comience con estos pasos básicos:

1. Asegúrate de que el dispositivo esté conectado mediante USB.

2. Si aún no lo ha hecho, ejecute el script de azsphere_connect.sh .

3. Comprueba que puedes comunicarte directamente con el dispositivo. Navega a https://192.168.35.2/status en un explorador web. Ignorar y descartar todas las advertencias SSL presentadas. Debería ver resultados similares a: {"uptime":56} en la ventana del explorador web.

1. Si el error continúa, desenchufa el dispositivo del puerto USB, conéctalo de nuevo y espera a que se reinicie. Después, ejecute el script de azsphere_connect.sh .

2. Si el error continúa, asegúrate de que no haya conflictos de subred con otras herramientas de red.