Aller au contenu principal

Guide de téléversement par navigateur

Avec Google Chrome ou Microsoft Edge (version 89+), vous pouvez programmer votre carte directement depuis le navigateur — sans logiciel supplémentaire. Cette page explique le fonctionnement et comment résoudre les problèmes courants.

Prérequis​

  • Navigateur : Google Chrome ou Microsoft Edge, version 89 ou ultérieure
  • Système d'exploitation : Windows, macOS, Linux ou ChromeOS
  • Connexion USB : votre carte doit être connectée en USB
Non pris en charge

Le téléversement par navigateur n'est pas disponible sur Firefox, Safari ou les navigateurs mobiles. Ces navigateurs ne prennent pas en charge les API Web requises (WebUSB, WebHID, Web Serial). Utilisez Board Server à la place.

Ajouter une carte​

  1. Connectez votre carte à votre ordinateur en USB
  2. Ouvrez Node Blue
  3. Cliquez sur « + Add Board... » dans le menu déroulant de sélection de carte en haut de la page
  4. Une boîte de dialogue du navigateur apparaît, listant les périphériques USB disponibles — sélectionnez votre carte et cliquez sur « Connect »
  5. Il se peut que l'on vous demande d'accorder l'accès HID — sélectionnez à nouveau le même appareil et cliquez sur « Connect »
  6. Votre carte apparaît maintenant dans le menu déroulant avec son nom et son numéro de série

Les autorisations de la carte sont mémorisées par le navigateur. Vous n'avez besoin de faire cela qu'une seule fois par carte.

Plusieurs cartes

Si vous avez plusieurs cartes du même type, chacune apparaîtra séparément dans le menu déroulant grâce à son numéro de série unique.

Téléverser le firmware​

  1. Sélectionnez votre carte dans le menu déroulant
  2. Compilez votre projet dans Node Blue
  3. Cliquez sur (ou appuyez sur Ctrl+U)
  4. Node Blue compile votre projet sur le serveur, puis téléverse le firmware sur votre carte

Premier téléversement​

Lors du tout premier téléversement avec une nouvelle carte, il se peut que l'on vous demande d'accorder l'accès au port série pour le bootloader. Cela se produit parce que le bootloader de la carte utilise une configuration USB différente de celle du firmware applicatif. Sélectionnez le port série qui apparaît et cliquez sur « Connect ». Cette autorisation est également mémorisée pour les téléversements ultérieurs.

Comment ça marche​

Le téléversement par navigateur utilise trois API Web modernes :

APIFonction
WebUSBDétecte les cartes connectées et lit leurs métadonnées (numéro de série, type de carte, version du firmware)
WebHIDEnvoie la commande de redémarrage pour entrer en mode bootloader (sur les cartes sans port série)
Web SerialTéléverse le firmware vers le bootloader de la carte (protocoles SAM-BA, STK500, Nordic DFU)

Chaque API nécessite une autorisation unique de la part de l'utilisateur. Une fois accordée, le navigateur mémorise l'autorisation et la carte peut être utilisée sans nouvelle demande.

Dépannage​

« Add Board » n'affiche aucun périphérique​

  • Assurez-vous que votre carte est branchée en USB
  • Essayez un autre câble USB (certains câbles ne servent qu'à la charge et ne transmettent pas les données)
  • Sous Windows, vérifiez que la carte apparaît dans le Gestionnaire de périphériques
  • Essayez de débrancher et de rebrancher la carte

Le téléversement échoue avec « No serial port found »​

  • Le port série du bootloader peut nécessiter une autorisation unique. Cliquez à nouveau sur Upload — si une boîte de dialogue de port série apparaît, sélectionnez le port et cliquez sur « Connect »
  • Si le bootloader de la carte a expiré, appuyez deux fois rapidement sur le bouton reset pour ré-entrer en mode bootloader, puis réessayez le téléversement

Le téléversement échoue avec « Could not open serial port »​

  • Assurez-vous qu'aucune autre application (IDE Arduino, moniteur série, etc.) n'a le port ouvert
  • Fermez les autres onglets du navigateur qui pourraient utiliser la même carte
  • Débranchez et rebranchez la carte, puis réessayez

La carte n'est pas détectée après le téléversement​

  • Après un téléversement réussi, la carte redémarre et se ré-énumère. Elle devrait réapparaître dans le menu déroulant en quelques secondes
  • Si ce n'est pas le cas, cliquez sur le bouton de rafraîchissement à côté du sélecteur de carte

Le navigateur affiche « WebUSB / WebHID / Web Serial not supported »​

  • Assurez-vous d'utiliser Chrome ou Edge version 89 ou ultérieure
  • Vérifiez que votre navigateur est à jour
  • Ces API ne sont pas disponibles en mode Navigation privée / Incognito sur certains navigateurs