Programmation de votre Radio

Ce guide vous montrera comment utiliser le logiciel FRC® Radio Configuration Utility pour configurer le pont sans fil (Wireless bridge) de votre robot pour une utilisation en dehors des événements officiels de la FRC.

Pré-requis

L’utilitaire FRC Radio Configuration Utility nécessite des privilèges d’administrateur pour configurer les paramètres réseau de votre radio. Le programme doit demander automatiquement les privilèges nécessaires (ceci peut nécessiter un mot de passe s’il est exécuté à partir d’un compte non administrateur), mais si vous rencontrez des problèmes, essayez de l’exécuter à partir d’un compte administrateur.

Téléchargez la toute dernière version du logiciel d’installation de l’utilitaire FRC Radio Configuration Utility à partir des liens suivants:

FRC Radio Configuration 24.0.1

FRC Radio Configuration 24.0.1 Israel Version

Note

La version _IL est destinée aux équipes israéliennes et contient une version du firmware OM5PAC avec des canaux restreints pour une utilisation en Israël.

Avant de procéder à l’installation du logiciel:

  1. Désactivez toutes les autres cartes réseau

  2. Branchez directement à partir de votre ordinateur dans le port Ethernet du pont sans fil le plus proche de la prise d’alimentation. Assurez-vous qu’aucun autre appareil n’est connecté à votre ordinateur via le port Ethernet. Si vous alimentez la radio via le port PoE, branchez un câble Ethernet du PC sur le côté de la prise de l’adaptateur PoE (où le roboRIO se brancherait). Si vous rencontrez des problèmes de configuration en vous connectant via l’adaptateur PoE, vous pouvez essayer de connecter le PC à l’autre port de la radio.

Avertissement

Le OM5P-AN et AC utilisent la même prise d’alimentation que le D-Link DAP1522, cependant ce sont des radios de 12V. Branchez la radio aux bornes 12V 2A sur le module VRM (la broche centrale étant de signe positif).

Notes d’application

Par défaut, l’utilitaire FRC Radio Configuration Utility programmera la radio pour appliquer la limite de bande passante de 4 Mbps sur le trafic sortant de la radio via l’interface sans fil. Dans le configuration maison (mode AP), ce nombre de 4Mbps signifie l’utilisation de la totalité de la bande passante, et non une limite par client. Cela veut dire que la vidéo en streaming vers plusieurs clients n’est pas recommandée.

L’utilitaire a été testé sur Windows 7, 8 et 10. Il peut fonctionner sur d’autres systèmes d’exploitation, mais n’y a pas été testé.

Configuration programmée

Répertorie les noms de chacun des voyants lumineux d’état sur les deux radios légales.

L’utilitaire FRC Radio Configuration Utility programme un certain nombre de paramètres de configuration dans la radio lors de son exécution. Ces paramètres s’appliquent à la radio dans tous les modes (y compris lors d’événements). Il s’agit notamment de:

  • Définir une IP statique de 10.TE.AM.1

  • Définir une adresse IP alternative du côté relié par fil de 192.168.1.1 pour la programmation future

  • Relier des ports câblés afin qu’ils puissent être utilisés de façon interchangeable

  • La DEL de configuration notée dans le graphique ci-dessus.

  • Limiter la bande passante à 4 Mo/s du côté sortie de l’interface sans fil (ceci peut être désactivé pour une utilisation à la maison)

  • La qualité de service ou QS régularise la hiérarchisation interne des paquets (affecte la mémoire tampon interne et les paquets à éliminer si la limite de bande passante est atteinte). Les règles appliquées sont les suivantes:

    • Contrôle et état du robot (UDP 1110, 1115, 1150)

    • Robot TCP & NetworkTables (TCP 1735, 1740)

    • En vrac (Tout autre trafic). (désactivé si la limite de largeur de bande (BW) est désactivée)

  • DHCP server enabled. Serves out:

    • 10.TE.AM.11 - 10.TE.AM.111 du côté relié par fil

    • 10.TE.AM.138 - 10.TE.AM.237 du côté sans-fil

    • Masque Subnet de 255.255.255.0

    • Adresse de diffusion 10.TE.AM.255

  • Serveur DNS activé. L’adresse IP du serveur DNS et le suffixe de domaine (.lan) sont servis dans le cadre du DHCP.

À la maison seulement:

  • SSID peut avoir un « Nom de robot » joint au numéro d’équipe pour distinguer plusieurs réseaux.

  • L’option Pare-feu peut être activée pour imiter les règles du champ pare-feu (pour les ports ouverts veuillez consulter le Manuel de jeu)

Avertissement

Il n’est pas possible de modifier la configuration manuellement.

Installez le logiciel

Le fichier .exe correspondant au programme d’installation de l'outil de configuration de la radio dans l’explorateur Windows.

Double-cliquez sur FRC_Radio_Configuration_VERSION.exe pour lancer le programme d’installation. Suivez les instructions pour terminer l’installation.

Durant l’installation, on proposera d’installer Npcap si il n’est pas déjà présent. L’installateur pour Npcap contient un certain nombre de cases à cocher pour configurer l’installation. Vous devez laisser les valeurs par défaut pour chacune des options.

Lancer le logiciel

L’utilitaire FRC Radio Configuration Utility dans le menu Démarrer.

Utilisez le menu Démarrer ou le raccourci de bureau pour lancer le programme.

Note

Si vous avez besoin de localiser le programme, il est installé dans C:\Program Files (x86)\FRC Radio Configuration Utility. Pour les machines 32 bits, le chemin est C:\Program Files\FRC Radio Configuration Utility

Autoriser le programme à apporter des modifications, si vous y êtes invité

Boîte de dialogue User Account Control qui s’affiche lors de l’exécution de l’utilitaire de configuration.

Une invite peut s’afficher pour autoriser l’utilitaire de configuration à apporter des modifications à l’ordinateur. Cliquez sur Yes si l’invite s’affiche.

Sélectionner l’interface réseau

Chacune des parties de la sélection Network Interfaces apparaît.

Utilisez la fenêtre contextuelle pour sélectionner l’interface ethernet que l’utilitaire de configuration utilisera pour communiquer avec la passerelle sans fil. Sur les ordinateurs Windows, les interfaces ethernet sont généralement nommées « Local Area Connection ». L’utilitaire de configuration ne peut pas programmer une passerelle via une connexion sans fil.

  1. Si aucune interface Ethernet n’est répertoriée, cliquez sur Refresh pour effectuer une nouvelle recherche des interfaces disponibles.

  2. Sélectionnez l’interface que vous souhaitez utiliser dans la liste déroulante.

  3. Cliquez sur OK.

Note concernant le Firmware Open Mesh

Pour que l’utilitaire de configuration radio FRC puisse programmer la radio OM5P-AN et OM5P-AC, la radio doit fonctionner sous une version FRC spécifique du micrologiciel OpenWRT.

Si vous n’avez pas besoin de mettre à jour ou de réinstaller le firmware, sautez l’étape suivante.

Avertissement

Radios used in 2019-2023 do not need to be updated before configuring, the 2024 tool uses the same 2019 firmware.

Chargement du micrologiciel FRC pour ouvrir la radio Mesh

Mise en surbrillance de la liste déroulante de la radio et du bouton Load Firmware ou Charger le firmware sur l’écran principal de l’utilitaire de configuration.

Si vous devez charger le firmware FRC (ou réinitialiser la radio), vous pouvez le faire à l’aide de l’utilitaire de configuration radio FRC.

  1. Suivez les instructions ci-dessus pour installer le logiciel, lancer le programme et sélectionner l’interface Ethernet.

  2. Assurez-vous que la radio Open Mesh est sélectionnée dans la liste déroulante Radio.

  3. Assurez-vous que la radio est connectée au PC via Ethernet.

  4. Débranchez l’alimentation de la radio. (Si vous utilisez un câble PoE, il faudra également débrancher le Ethernet sur le PC, ce qui est correct)

  5. Appuyez sur le bouton Load Firmware

  6. Lorsque vous y êtes invité, branchez l’alimentation de la radio. Le logiciel doit détecter la radio, charger le firmware et vous informer, une fois terminé.

Avertissement

Si vous voyez une erreur concernant le nom NPF, essayez de désactiver tous les adaptateurs autres que celui utilisé pour programmer la radio. Si un seul adaptateur est trouvé, l’outil doit essayer de l’utiliser. Consultez les étapes dans Désactivation des cartes réseau pour plus d’informations.

Teams may also see this error with Operating Systems configured for languages other than US English. If you experience issues loading firmware or programming on a foreign language OS, try using an English OS, such as on the KOP provided PC or setting the Locale setting to « en_us » as described on this page.

Sélectionnez la radio et le mode de fonctionnement

Met en surbrillance les zones déroulantes Radio et Mode.
  1. Sélectionnez la radio que vous configurez à l’aide de la liste déroulante.

  2. Sélectionnez le mode d’opération à configurer. Dans la plupart des cas, la sélection par défaut du point d’accès 2.4 GHz sera suffisante. Si vos ordinateurs le supporte, le mode AP 5GHz est recommandé, car 5GHz est moins encombré dans de nombreux environnements.

Sélectionnez les options

La définition du nom du robot changera le SSID. Les cases à cocher rendent la radio plus similaire au mode d’opération en compétition.

Les valeurs par défaut des options ont été sélectionnées pour correspondre au cas d’utilisation de la plupart des équipes, cependant, vous pouvez personnaliser ces options à votre scénario spécifique :

  1. Robot Name: Il s’agit d’une chaîne de caractères qui est ajoutée au SSID utilisé par la radio. Cela vous permet d’avoir plusieurs réseaux avec le même numéro d’équipe et de toujours pouvoir les distinguer.

  2. Firewall: Si cette case est cochée, le pare-feu radio sera configuré pour tenter d’imiter le comportement de blocage de port du pare-feu présent sur le champ FRC. Pour une liste des ports ouverts, veuillez consulter le manuel du jeu FRC.

  3. BW Limit: Si cette case est cochée, la radio applique une limite de bande passante de 4 Mbps comme elle le fait lorsqu’elle est programmée lors d’événements. Notez qu’il s’agit d’une limite totale, pas par client, donc la diffusion de vidéo vers plusieurs clients simultanément peut provoquer un comportement indésirable.

Note

Le pare-feu et la limite BW s’appliquent uniquement aux radios Open Mesh. Ces options n’ont aucun effet sur les radios D-Link.

Avertissement

L’option « Firewall » configure la radio pour émuler le pare-feu de terrain. Cela signifie que vous ne pourrez pas déployer du code sans fil avec cette option activée. Ceci est utile pour simuler les ports bloqués qui peuvent exister lors de compétitions.

Démarrage du processus de configuration

Au bas de l’écran se trouvent des instructions pour terminer le processus de configuration.

Suivez les instructions à l’écran pour préparer votre passerelle sans fil, entrer les paramètres avec lesquels la passerelle sera configurée et démarrer le processus de configuration. Ces instructions à l’écran sont mises à jour pour correspondre au modèle de pont et au mode de fonctionnement choisi.

Progression de la configuration

Boîte de dialogue de la barre de progression pendant que la configuration fonctionne.

Tout au long du processus de configuration, la fenêtre indique:

  1. L’étape en cours d’exécution.

  2. La progression globale du processus de configuration.

  3. Toutes les étapes exécutées jusqu’à présent.

Configuration terminée

Une boîte de dialogue contextuelle indiquant que la programmation a réussi.

Une fois la configuration terminée:

  1. Appuyez sur OK dans la fenêtre de dialogue.

  2. Appuyez sur OK dans la fenêtre principale pour revenir à l’écran des paramètres.

Erreurs de configuration

Une boîte de dialogue d’erreur s’affiche.

Si une erreur se produit pendant le processus de configuration, suivez les instructions du message d’erreur pour corriger le problème.

Dépannage

  • Désactiver tous les autres adapteurs réseaux.

  • Assurez-vous d’attendre suffisamment longtemps pour que le voyant d’alimentation reste fixe pendant 10 secondes.

  • Assurez-vous que vous disposez de la bonne interface réseau et qu’une seule interface est répertoriée dans la liste déroulante.

  • Assurez-vous que votre pare-feu (Firewall) est désactivé.

  • Branchez directement depuis votre ordinateur dans le pont sans fil (Wireless bridge) et assurez-vous qu’aucun autre appareil n’est connecté à votre ordinateur via Ethernet.

  • Assurez-vous que l’Ethernet est branché sur le port le plus proche de la prise d’alimentation sur le pont sans fil.

  • If using an Operating System configured for languages other than US English, try using an English OS, such as on the KOP provided PC or setting the Locale setting to « en_us » as described on this page.

  • Due to Unicode incompatibles, non-US Teams may face a configuration failure because of incorrect network interface reading. In that case, change the network adapter name to another name in English and retry.

  • Certains utilisateurs ont signalé avoir réussi après avoir installé npcap 1.60. Si cela ne résout pas le problème, il est recommandé de désinstaller npcap et l’outil radio, puis de réinstaller l’outil radio afin de revenir à une configuration connue.

  • Si tout le reste échoue, essayez un autre ordinateur.