Résoudre les problèmes liés à Azure Sphere

Voici quelques étapes de résolution des problèmes qui peuvent se produire pendant l’installation et l’installation.

Problèmes de communication d’appareil

Un échec de connexion à l’appareil à partir d’un ordinateur hôte peut se produire pour de nombreuses raisons et peut déclencher plusieurs messages d’erreur, selon les outils ou applications qui le rencontrent. Les messages d’erreur suivants peuvent indiquer un échec de connexion :

• An error occurred. Please check your device is connected and your PC has been configured correctly, then retry.
• Could not connect to the device. Check if your device is connected to the PC. The device may be unresponsive if it is applying an Azure Sphere operating system update; wait a few minutes and then retry. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.
• An unexpected issue occurred. Please try again; if the issue persists, please refer to aka.ms/azurespheresupport for troubleshooting suggestions and support.
• Failed to retrieve device ID from attached device: 'Could not connect to the device; please ensure it is attached.'
• Failed to establish communication with device after recovery.

Trois composants peuvent entraîner des problèmes de communication de l’appareil : (1) l’interface de ligne de commande elle-même ; (2) le service de communication d’appareil (DCS) qui facilite la communication avec un appareil ; et (3) l’appareil.

Pour isoler la cause, effectuez les étapes de diagnostic suivantes :

1. Vérifiez que vous pouvez communiquer directement avec l’appareil. Accédez à https://192.168.35.2/status dans un navigateur web. Ignorez et ignorez tous les avertissements SSL présentés. Vous devez voir une sortie similaire à : {"uptime":56} dans la fenêtre du navigateur web.

Note

Vous pouvez également effectuer cette étape à partir de la ligne de commande à l’aide de curl https://192.168.35.2/status --insecure.

Note

Vous pouvez également effectuer cette étape à partir de PowerShell (v6 ou version ultérieure). Invoke-WebRequest https://192.168.35.2/status -SkipCertificateCheck

2. Vérifiez que le service de communication de l’appareil a détecté un appareil. Accédez à http://localhost:48938/api/service/devices dans un navigateur web et vérifiez qu’au moins un appareil est affiché dans la sortie JSON.

Avertissement

Le DCS Linux est inclus uniquement dans les versions 23.05 et ultérieures du Kit de développement logiciel (SDK). Suivez les étapes de résolution des problèmes héritées pour les versions 22.11 et antérieures du Kit de développement logiciel (SDK).

Note

Vous pouvez également effectuer cette étape à partir de PowerShell via Invoke-WebRequest http://localhost:48938/api/service/devices.

Impossible de communiquer directement avec l’appareil et l’appareil n’est pas détecté par le contrôleur de domaine

Si une connexion n’a pas pu être établie avec l’appareil (étape 1) et que l’appareil ne peut pas être détecté par le contrôleur de domaine (étape 2), il y a probablement un problème avec la configuration de l’appareil physique.

Tout d’abord, case activée l’appareil a été détecté par l’ordinateur.

À partir d’un terminal :

1. Exécutez sudo lsusb. Vérifiez que Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC apparaît dans la sortie.

Utilisation d’une fenêtre PowerShell :

1. Exécutez Get-PnpDevice -PresentOnly | Where-Object { $_. InstanceId -match '^USB' }. Vérifiez que MSFT MT3620 Std Interface apparaît dans la sortie.

Si la commande précédente ne retourne pas la sortie attendue, connectez l’appareil à un autre port USB. Si cela ne résout toujours pas votre problème, case activée l’appareil dispose de ses cavaliers correctement configurés. Par exemple, les kits de développement Seeed MT3620 sont expédiés à partir de l’usine avec un en-tête de jumper sur les broches 2 et 3 de J3, qui alimente l’horloge à partir de l’alimentation main. Vérifiez que l’en-tête n’a pas été délogé ou supprimé.

Impossible de communiquer directement avec l’appareil, mais l’appareil est détecté par le contrôleur de domaine

Si aucune connexion n’a pu être établie avec l’appareil (étape 1), mais que l’appareil a été détecté par le contrôleur de domaine (étape 2), il est probable que le service de communication de l’appareil ou de l’appareil soit dans un état incorrect.

Si vous venez de connecter un appareil à Internet et que le système d’exploitation de l’appareil est obsolète, l’appareil peut appliquer une mise à jour du système d’exploitation. Il y a également une faible probabilité que l’appareil prenne une mise à jour du système d’exploitation si l’heure coïncide avec une fenêtre de publication. Lors d’une mise à jour du système d’exploitation, vous ne pourrez pas communiquer avec un appareil.

Si vous pensez que l’appareil est à jour et/ou qu’il n’est pas connecté à Internet, la meilleure option suivante consiste à le débrancher et à le reconnecter à votre PC. Cela doit entraîner le renouvellement de la connexion du contrôleur de domaine à l’appareil et la réinitialisation de l’appareil à un état initial.

Si vous ne pouvez pas débrancher et reconnecter l’appareil, la meilleure option suivante consiste à redémarrer le DCS. À partir d’un terminal :

1. Exécutez sudo azspheredctl restart. Vérifiez que la commande se termine correctement.
   1. Si la commande échoue, exécutez sudo systemctl restart azsphered.

Si vous ne pouvez pas débrancher et reconnecter l’appareil, la meilleure option suivante consiste à émettre une commande de nouvelle analyse pour le contrôleur de domaine. À la réception de cette commande, le CONTRÔLEUR de domaine effectue un cycle et réinitialise la puce d’interface FTDI utilisée pour communiquer avec le MT3620. Utilisation d’une fenêtre PowerShell :

1. Exécuter la commande az sphere device rescan-attached

Réexécutez maintenant la commande que vous avez initialement essayée. Si le problème n’est toujours pas résolu, la meilleure option suivante consiste à essayer de redémarrer le contrôleur de domaine. À partir d’une fenêtre PowerShell de niveau administrateur :

1. Exécutez Restart-Service -Name AzureSphereDeviceCommunicationService. Vérifiez que la commande se termine correctement.

Vous pouvez également redémarrer le contrôleur de domaine à l’aide d’une interface utilisateur graphique.

1. Appuyez sur Démarrer et entrez Services. Cliquez avec le bouton droit sur le service de communication d’appareil Azure Sphere , puis sélectionnez Redémarrer.

Réexécutez maintenant la commande que vous avez initialement essayée.

Si la commande continue d’échouer ou az sphere device list-attached si la sortie est similaire à celle-ci :

1 device attached:
--> Device ID: Cannot get device ID
  --> Is responsive: no
  --> IP address: 192.168.35.2
  --> Connection path: 213

Courir az sphere device recover

Peut communiquer directement avec l’appareil et l’appareil est détecté par le contrôleur de domaine

Cela indique probablement un problème avec l’interface CLI. Vérifiez que vous disposez de la dernière version du Kit de développement logiciel (SDK).

Si vous disposez de la dernière version du Kit de développement logiciel (SDK) et que votre problème n’est toujours pas résolu, publiez une question sur le forum Q&R.

Connexions supprimées ou appareils manquants

Si votre ordinateur peut se connecter à l’appareil Azure Sphere, mais qu’il supprime souvent la connexion, vous pouvez rencontrer un conflit dans le sous-réseau IP.

Azure Sphere utilise le sous-réseau 192.168.35.*. Si vous avez d’autres logiciels qui utilisent le même sous-réseau, désactivez ce logiciel ou limitez la plage d’adresses IP qu’il utilise. Actuellement, vous ne pouvez pas modifier la plage d’adresses IP utilisée par Azure Sphere.

Impossible d’appliquer les fonctionnalités de l’appareil

Si vous recevez des erreurs lorsque vous essayez d’appliquer une fonctionnalité d’appareil à un appareil Azure Sphere, le problème peut être que le système d’exploitation de votre appareil est obsolète. Ce problème peut se produire si l’appareil est hors connexion pendant une période prolongée, au cours de laquelle Microsoft a mis à jour ses clés internes. Les erreurs suivantes sont des symptômes de ce problème :

Les commandes az sphere device enable-development ou az sphere device enable-cloud-test retournent une erreur similaire à ce qui suit :

error: The device did not accept the device capability configuration. Please check the Azure Sphere OS on your device is up-to-date using 'az sphere device show-deployment-status'.

La commande az sphere device capability update retourne une erreur similaire à celle-ci :

error: Could not apply device capability configuration to device.

Cela est dû au fait que le magasin de clés approuvé sur l’appareil est obsolète. Pour résoudre ce problème, suivez les instructions fournies ici.

Échec de la création de quatre convertisseurs série USB

Après avoir configuré une carte de développement MT3620, vous devriez voir quatre convertisseurs série USB dans Gestionnaire de périphériques. Si vous voyez moins de quatre, vous pouvez rencontrer un problème avec le pilote FTDI.

Note

Si cette carte a déjà été utilisée pour le développement RTApp, vous pouvez voir trois convertisseurs au lieu de quatre. Cela est normal et ne représente pas d’erreur.

Si le pilote FTDI n’est pas correctement installé, les convertisseurs peuvent apparaître au mauvais emplacement, par exemple Autres appareils, ou ne pas apparaître du tout.

Pour résoudre ce problème :

1. Pour ouvrir Gestionnaire de périphériques, cliquez sur Démarrer et entrez Gestionnaire de périphériques.

2. Sous Contrôleurs de bus série universels, sélectionnez Usb Serial Converter A. Cliquez avec le bouton droit sur le nom, sélectionnez Désinstaller l’appareil, puis supprimez le pilote si vous avez l’option :

   

   Répétez cette étape pour le convertisseur série USB B à USB Serial Converter D.

3. Débranchez votre carte de développement de votre PC et rebranchez-la. « MsfT MT3620 Std Interface » doit apparaître avec une icône d’avertissement de triangle, indiquant qu’aucun pilote n’est disponible.

4. Cliquez avec le bouton droit sur l’un des appareils MSFT MT3620 Std Interface, puis sélectionnez Mettre à jour le pilote. Choisissez Recherche automatiquement pour le logiciel pilote mis à jour. La mise à jour d’un doit toutes les corriger. Vous devez maintenant voir quatre convertisseurs série USB dans la section Contrôleurs de bus série universel. Si les quatre convertisseurs n’apparaissent pas, répétez cette étape pour chaque convertisseur.

Échec de l’installation des pilotes FTDI

Les pilotes FTDI doivent être téléchargés et installés automatiquement par Windows lorsque votre appareil Azure Sphere est connecté pour la première fois à votre PC. Si les pilotes sont correctement installés, vous verrez quatre convertisseurs série USB répertoriés sous Contrôleurs de bus série universel dans Gestionnaire de périphériques, comme décrit dans Configurer votre kit de développement.

Windows 10, version 2004, ne recherche pas les pilotes. Dans ce cas, les pilotes ne sont pas téléchargés et installés automatiquement et vous verrez les éléments suivants répertoriés dans Gestionnaire de périphériques :

Pour installer les pilotes, téléchargez-les manuellement à partir de Future Technology Devices International (FTDI). Choisissez le pilote qui correspond à votre installation Windows (32 ou 64 bits).

Pour connaître les dates de disponibilité et les numéros de build des versions Windows 10, consultez Windows 10 informations de publication. Ces informations peuvent vous aider à déterminer si votre version de Windows 10 est antérieure ou ultérieure à la version 2004.

Problèmes de connexion causés par la configuration de l’adaptateur TAP-Windows

Les outils Azure Sphere communiquent avec les cartes de développement attachées à l’aide d’un réseau IP via USB. Cela nécessite l’adaptateur TAP-Windows des technologies OpenVPN. La procédure d’installation du Kit de développement logiciel (SDK) Azure Sphere installe cet adaptateur sur votre PC s’il n’est pas déjà présent.

Deux types de problèmes distincts ont été signalés avec l’adaptateur TAP-Windows :

• Si une autre version de l’adaptateur TAP-Windows est déjà installée, ou si l’appareil Azure Sphere n’est pas connecté au premier instance de l’adaptateur TAP-Windows, les outils Azure Sphere peuvent ne pas se connecter à votre appareil.

• Si vous utilisez le réseau privé virtuel (VPN) Cisco AnyConnect, votre carte TAP-Windows peut sembler déconnectée et la communication de l’appareil peut ne pas fonctionner. Cela est dû au fait que le VPN peut rediriger le trafic hors de l’adresse IP de l’adaptateur TAP.

Vérifier que l’appareil Azure Sphere est connecté à l’adaptateur TAP-Windows approprié

Pour déterminer si le problème est lié à l’adaptateur TAP, commencez par déterminer le nombre d’adaptateurs TAP installés sur votre PC, puis modifiez l’installation si nécessaire.

Pour déterminer le nombre d’adaptateurs TAP installés sur votre PC :

1. Ouvrez Paramètres Windows et sélectionnez le groupe Réseau & Internet .

2. Sous Paramètres réseau avancés, sélectionnez Modifier les options de la carte. Vous ne devez voir qu’un seul adaptateur TAP, comme illustré dans la capture d’écran suivante :

   

   Si vous voyez plusieurs adaptateurs TAP, ou si vous ne voyez qu’un seul adaptateur TAP mais que son nom n’est pas Azure Sphere, procédez comme suit pour désinstaller tous les adaptateurs TAP et réinstaller le SDK. Si vous ne voyez aucun adaptateur TAP, réinstallez le Kit de développement logiciel (SDK).

Pour désinstaller les adaptateurs TAP :

1. Cliquez sur Démarrer et entrez Gestionnaire de périphériques.

2. Dans Gestionnaire de périphériques, ouvrez Cartes réseau et sélectionnez Carte TAP-Windows :

   

3. Cliquez avec le bouton droit sur l’adaptateur TAP-Windows et sélectionnez Désinstaller l’appareil. Dans la boîte de dialogue, sélectionnez Supprimer le logiciel du pilote pour cet appareil, puis cliquez sur Désinstaller.

4. Ouvrez une invite de commandes en tant qu’administrateur et exécutez le script d’installation PowerShell suivant :

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

5. Si l’installation réussit, redémarrez le service de communication d’appareil Azure Sphere :

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

6. Réinstallez le Kit de développement logiciel (SDK) Azure Sphere.

Corriger l’état débranché lors de l’utilisation du client VPN Cisco AnyConnect

Lorsque vous utilisez le client VPN Cisco AnyConnect, l’adaptateur TAP-Windows peut sembler déconnecté et la communication de l’appareil peut ne pas fonctionner. Vous pouvez corriger le problème comme suit :

1. Vérifiez que vous disposez de privilèges d’administrateur sur votre ordinateur.

2. Ouvrez Paramètres Windows et sélectionnez le groupe Réseau & Internet .

3. Sous Paramètres réseau avancés, sélectionnez Modifier les options de la carte.

4. Cliquez avec le bouton droit sur Azure Sphere TAP-Windows Adapter V9 , puis sélectionnez Propriétés.

5. Sous l’onglet Mise en réseau , recherchez l’entrée Cisco AnyConnect Network Access Manager Filter Driver et effacez l’élément.

   

6. Sélectionnez OK pour enregistrer le paramètre et quitter les propriétés.

7. Vérifiez que la communication avec votre appareil Azure Sphere fonctionne désormais en ouvrant une invite de commandes et en entrant la az sphere device show-attached commande .

L’appareil ne répond pas

Une ou plusieurs des erreurs suivantes d’une commande azsphere peuvent indiquer que le service de communication d’appareil Azure Sphere n’a pas pu démarrer :

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

Vérifiez que vous avez effectué les étapes de résolution des problèmes de communication de l’appareil.

Si votre problème n’est toujours pas résolu et que votre ordinateur a récemment pris une mise à jour Windows, le service de communication de l’appareil peut ne pas démarrer après la mise à jour de Windows et dans les cas où l’un des fichiers de paramètres JSON internes ou le fichier de configuration est endommagé.

Échec après Windows Update

Ces erreurs peuvent se produire une fois que vous avez mis à jour Windows sur votre PC. Parfois, Windows Update désinstalle les pilotes FTDI requis pour le service de communication.

Pour résoudre le problème :

1. Débranchez l’appareil Azure Sphere de l’USB et rebranchez-le. Lors du rebranchement de l’appareil, les pilotes appropriés doivent être réinstallés.
2. Si le débranchement et le rebrassage de l’appareil ne parvient pas à résoudre le problème, désinstallez et réinstallez le Kit de développement logiciel (SDK) Azure Sphere.

Fichier JSON

Si vous n’avez pas récemment mis à jour Windows, la cause de l’erreur peut être le restore.json fichier utilisé pour le service.

Pour résoudre ce problème :

1. Enregistrez une copie du fichier suivant :

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

2. Supprimez le fichier de son emplacement d’origine.

3. Arrêtez, puis redémarrez le service de communication d’appareil Azure Sphere :

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

Fichier de configuration endommagé

Si une erreur est signalée lorsque vous essayez d’exécuter une commande, le fichier de configuration endommagé peut empêcher votre appareil de s’exécuter correctement.

Pour résoudre ce problème, supprimez le fichier de configuration endommagé situé dans .azsphere\config sur Windows ou ~/.azsphere/config sur Linux.

Windows se bloque lors du branchement ou du débranchement d’un appareil

La carte de développement MT3620 dispose d’une puce FTDI (Future Technology Devices International) FT4232HQ, qui facilite la communication entre l’appareil et le PC. Le pilote FTDI officiel, Combined Driver Model (CMD), contient deux pilotes : l’un fournit l’accès via l’API D2XX et l’autre fournit un port de com virtuel (VCP) pour le même appareil. Les deux pilotes sont installés par défaut si le mode VCP est activé sur la puce FTDI. Cela peut entraîner le blocage de Windows lorsque la puce est en panne d’alimentation.

Pour résoudre ce problème, vous pouvez désactiver le mode VCP pour la puce FTDI. Vous devez utiliser l’outil FT_PROG pour reprogrammer l’EEPROM de la puce FTDI.

1. Consultez l’outil de programmation FTDI FT_PROG pour savoir comment le télécharger et l’installer.

2. Exécutez FT_PROG et recherchez votre appareil attaché, comme décrit dans FT_PROG’application GUI.

3. Dans la vue Arborescence de l’appareil, développez la section Matériel spécifique . Vous devriez voir quatre ports.

   

4. Sélectionnez Port A et choisissez D2XX Direct au lieu de Port com virtuel.

   

5. Répétez l’étape précédente pour les ports C et D. Le port B doit déjà être en mode direct D2XX.

6. Sélectionnez l’icône Program Devices (qui ressemble à un éclair) pour passer en mode programmation.

   

7. Sélectionnez Programme pour programmer l’EEPROM, puis attendez qu’elle se termine.

   

8. Débranchez votre appareil du port USB, puis reconnectez-le pour le mettre sous tension et faire en sorte que la modification prenne effet. Dans Windows Gestionnaire de périphériques, la section Ports (COM & LPT) doit maintenant afficher trois ports COM de moins. Le nombre d’appareils Universal Serial Bus doit rester le même.

Perte de connexion à des appareils FTDI non-Azure Sphere après l’activation du débogage RTApp

Certains utilisateurs d’Azure Sphere ont signalé qu’ils ne peuvent plus communiquer avec d’autres appareils FTDI attachés et non Azure Sphere après avoir utilisé la commande az sphere device enable-development --enable-rt-core-debugging pour développer et déboguer des applications RTApp à partir de leur PC hôte.

Par exemple, si vous avez un appareil Azure Sphere et un autre appareil FTDI connectés à votre PC, vous pouvez voir deux contrôleurs série universels nommés Usb Serial Converter B dans Windows Gestionnaire de périphériques avant d’exécuter la commande.

Après l’exécution de la commande, les deux périphériques USB Serial Converter B disparaissent de la section Contrôleur de bus série universel et deux nouveaux appareils apparaissent dans l’affichage des périphériques De bus série universel dans Gestionnaire de périphériques.

Cause

Ce problème se produit parce que la commande az sphere device enable-development --enable-rt-core-debugging installe un nouveau pilote pour le port B de la puce FTDI sur le MT3620 ; le port devient alors MSFT MT3620 Std Interface. Toutefois, l’installation de ce pilote modifie par inadvertance le pilote pour le port B de l’autre appareil non-Azure Sphere. En raison d’une limitation dans la bibliothèque sous-jacente, tous les appareils FTDI avec les mêmes VID (0x0403) et PID (0x6011) verront leur pilote de port B remplacé.

Solution

Procédez comme suit pour rétablir manuellement la version précédente du pilote pour tous les appareils non-Azure Sphere :

1. Dans Gestionnaire de périphériques, sélectionnez l’appareil non-Azure Sphere (un autre ftDI Quad GZ dans l’exemple), puis cliquez avec le bouton droit et sélectionnez Mettre à jour le pilote.

2. Dans Mettre à jour les pilotes, sélectionnez Parcourir mon ordinateur pour rechercher le logiciel du pilote.

   

3. Sélectionnez Laissez-moi choisir dans une liste de pilotes disponibles sur mon ordinateur.

   

4. Sélectionnez Pilote USB Serial Converter B dans la liste, puis cliquez sur Suivant.

   

5. Cliquez sur Fermer dans la fenêtre de confirmation.

6. Gestionnaire de périphériques doit afficher le port B de l’autre périphérique FTDI en tant que convertisseur série USB B, ce qui indique qu’il utilise le pilote FTDI officiel. Le pilote du MT3620 reste MSFT MT3620 Std Interface.

   

Informations supplémentaires

• Si vous branchez un autre nouvel appareil FTDI non-Azure Sphere après avoir exécuté la commande azsphere device enable-development --enable-rt-core-debugging , ce périphérique se verra attribuer le pilote d’Azure Sphere MT3620 de la même manière. Répétez les étapes ci-dessus pour rétablir le pilote FTDI officiel de l’appareil.

• Si vous débranchez et rebranchez un appareil FTDI non-Azure Sphere après l’avoir retourné au pilote FTDI officiel, l’appareil conserve le pilote FTDI officiel.

• Si vous exécutez à nouveau la commande az sphere device enable-development --enable-rt-core-debugging après avoir rétabli le pilote, le pilote ftDI non-Azure Sphere sera de nouveau remplacé, et vous devrez suivre les étapes décrites dans Solution pour revenir au pilote FTDI officiel. Cela se produit indépendamment du fait que l’appareil FTDI non Azure Sphere soit ou non attaché au PC lorsque la commande az sphere device enable-development --enable-rt-core-debugging est exécutée.

Commandes non reconnues

Si vous voyez l’erreur suivante lorsque vous entrez une commande azsphere, vérifiez que vous utilisez PowerShell ou une invite de commandes standard sur Windows.

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

Le programme d’installation se bloque à 60 %

Le programme d’installation se bloque à 60 %, et vous êtes informé que le service de communication de l’appareil n’a pas pu démarrer. Cela se produit généralement lorsque l’installation du pilote TAP échoue d’une manière étrange, laissant le système dans un état indéterminé.

Vérifier que le problème est lié au pilote TAP

1. Ouvrez le observateur d'événements Windows pour case activée les journaux.

2. Recherchez le message d’erreur suivant dans le journal des applications et le journal du service de communication d’appareil Azure Sphere :

   « SerialSlipToTun.TunInterfaceSetupException : Error access tun registry settings ---> System.Collections.Generic.KeyNotFoundException : Tun tap device not found ---> System.Security.SecurityException : Requested registry access is not allowed. »

   

3. Lors de la vérification du journal des applications, filtrez le journal pour éviter de voir les nombreux messages non liés. Sous l’onglet Action , sélectionnez Filtrer le journal actuel.

4. Sélectionnez Erreur, puis Sélectionnez AzureSphereDeviceCommunicationService pour répertorier uniquement les messages d’erreur du service de communication d’appareil Azure Sphere.

   

5. Si vous ne trouvez pas l’erreur dans le journal des applications ou dans le journal Azure Sphere Device Communication Service, il se peut qu’il ne s’agit pas d’un problème lié au pilote TAP.

Pour résoudre le problème du pilote TAP, procédez comme suit :

1. Accédez au Centre réseau et partage, puis sélectionnez Modifier les paramètres de la carte.

   

2. Dans Network Connections sous Azure Sphere, sélectionnez TAP-WIndows Adapter V9 et ouvrez ses propriétés.

   

3. Dans Propriétés d’Azure Sphere, sélectionnez Internet Protocol Version 4 (TCP/IPv4), puis sélectionnez Propriétés pour afficher les paramètres du protocole.

   

4. Vérifiez que l’adresse IP est définie sur 192.168.35.1 et que le masque de sous-réseau est défini sur 255.255.255.0.

5. Réessayez le programme d’installation. S’il se bloque toujours, essayez de réinitialiser vos connexions réseau. Pour effectuer une réinitialisation, accédez à Paramètres>Réseau & État Internet>, puis sélectionnez Réinitialisation réseau en bas de la page.

   Important

   La réinitialisation de votre réseau réinitialise tous les paramètres réseau.

Arrêter le service de communication d’appareil Azure Sphere

Si le programme d’installation se bloque, vous pouvez arrêter le service de communication d’appareil Azure Sphere à l’aide de la commande taskkill .

Procédez comme suit :

1. Copiez le PID pour AzureSphereDeviceCommunicationService.

   • Accédez à l’ongletServices du Gestionnaire> des tâches et notez le PID pour le service AzureSphereDeviceCommunicationService, ou
   • Dans la ligne de commande, tapez tasklist /fi "SERVICES eq AzureSphereDeviceCommunicationService*" et copiez le PID à partir de la sortie.

2. Tapez ce qui suit dans la ligne de commande pour mettre fin au service. La commande taskkill met fin au processus qui correspond au numéro d’ID du processus. L’option /f est utilisée pour mettre fin avec force au processus.

   taskkill /PID <DCS_PID> /f

3. Réessayez le programme d’installation.

Impossible d’arrêter le service de communication d’appareil Azure Sphere

Lors de la mise à niveau d’un Kit de développement logiciel (SDK) Azure Sphere existant, vous pouvez voir un message indiquant que le service 'Azure Sphere Device Communication Service' (AzureSphereDeviceCommunicationService) n’a pas pu être arrêté. Vérifiez que vous disposez des privilèges suffisants pour arrêter les services système. » Si vous recevez ce message, redémarrez et réexécutez le programme d’installation.

La communication de l’appareil est interrompue lors de l’utilisation du tunneling fractionné

Lorsqu’un ordinateur de développement est connecté au VPN d’entreprise et que le tunneling fractionné est désactivé par la configuration VPN, l’ordinateur de développement peut ne pas être en mesure de communiquer avec l’appareil Azure Sphere.

Pour résoudre ce problème, effectuez l’une des opérations suivantes :

• Déconnectez-vous du VPN d’entreprise et réessayez la connexion à l’appareil Azure Sphere.
• Modifiez la configuration VPN pour autoriser le tunneling fractionné.

Les problèmes de communication peuvent également être causés par la configuration de l’adaptateur TAP-Windows. Consultez la section Problèmes de connexion causés par TAP-Windows configuration de l’adaptateur .

Impossible d’installer ou de désinstaller le Kit de développement logiciel (SDK) Azure Sphere sur Windows 11

Après la mise à niveau vers Windows 11, les utilisateurs ne peuvent pas installer ou désinstaller le Kit de développement logiciel (SDK) Azure Sphere. Pour résoudre ce problème, installez la dernière version du Kit de développement logiciel (SDK) Azure Sphere pour Windows. Après avoir installé la version 21.07 Update 2 ou une version ultérieure, vous pourrez désinstaller le Kit de développement logiciel (SDK).

Impossible de compiler ou de déboguer des applications en temps réel

Si CMake signale des erreurs lors de la recherche des chaînes d’outils ou openocd lorsque vous essayez de générer ou de déboguer une application en temps réel, assurez-vous que :

• Vous avez installé GNU Arm Embedded Toolchain pour votre environnement de développement.
• Vous avez spécifié le chemin d’accès correct, openocd comme décrit dans Tutoriel : Créer une application en temps réel.

Résolution des problèmes de communication d’appareil antérieurs à la version 23.05

Avertissement

Ces étapes s’adressent aux utilisateurs avec la version 22.11 ou antérieure du KIT de développement logiciel (SDK). Vérifiez que la version du SDK installée est 22.11 ou antérieure en exécutant azsphere show-version.

Sur les systèmes Linux exécutant le KIT de développement logiciel (SDK) version 22.11 ou antérieure, le script azsphere_connect.sh doit être exécuté chaque fois que vous branchez l’appareil ou que vous le débranchez ou le rebranchez. Le script actualise les connexions d’appareil et génère un pilote de noyau qui mappe le trafic réseau à l’appareil.

Si vous rencontrez des problèmes de communication, commencez par les étapes de base suivantes :

1. Vérifiez que l’appareil est connecté par USB.

2. Exécutez le script azsphere_connect.sh , si ce n’est déjà fait.

3. Vérifiez que vous pouvez communiquer directement avec l’appareil. Accédez à https://192.168.35.2/status dans un navigateur web. Ignorez et ignorez tous les avertissements SSL présentés. Vous devez voir une sortie similaire à : {"uptime":56} dans la fenêtre du navigateur web.

Note

Vous pouvez également effectuer cette étape à partir de la ligne de commande à l’aide de curl https://192.168.35.2/status --insecure.

1. Si l’erreur persiste, débranchez l’appareil du port USB, reconnectez-le et attendez qu’il redémarre. Exécutez ensuite le script azsphere_connect.sh .

2. Si l’erreur persiste, vérifiez qu’il n’existe aucun conflit de sous-réseau avec d’autres outils de mise en réseau.