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

Avant de commencer avec le logiciel:

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

  2. Branchez directement depuis votre ordinateur dans le port Ethernet du pont sans fil le plus proche de la prise d’alimentation et assurez-vous qu’aucun autre appareil n’est connecté à votre ordinateur via Ethernet.

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. Câblez la radio aux bornes 12V 2A sur le module VRM (la broche centrale étant de signe positif).

Pré-requis

L’utilitaire FRC Radio Configuration Utility nécessite des privilèges d’administrateur pour configurer les paramètres réseau de votre appareil. 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 le dernier programme d’installation de l’utilitaire FRC Radio Configuration Utility à partir des liens suivants:

Note

Il n’y a pas de changements à cet outil pour la saison 2021 de sorte que la version 20.0.0 demeure toujours la dernière disponible.

FRC Configuration Radio 20.0.0

FRC Configuration Radio 20.0.0 Version Israel

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.

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

Lists the names of each of the status lights on the two legal radios.

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éfinissez une IP statique de 10.TE.AM.1

  • Définissez 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)

  • Serveur DHCP activé. Sert:

    • 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’IP du serveur DNS et le suffixe de domaine (.lan) font partie 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

The radio configuration installer .exe file in windows explorer.

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

The FRC Radio Configuration Utility in the start menu.

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é

User Account Control dialog that pops up when running the config utility.

Si votre ordinateur exécute Windows, une invitation peut s’afficher pour autoriser l’utilitaire de configuration à apporter des modifications à l’ordinateur. Cliquez sur Yes si l’invitation apparaît.

Sélectionner l’interface réseau

Each of the Parts of the Network Interfaces selection pop up.

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 exécuter une version FRC spécifique du firmware OpenWRT. Les radios OM5P-AC du KoP 2019 ne devraient pas avoir besoin d’une mise à jour.

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

Avertissement

Les radios utilisées en 2019 n’ont pas besoin d’être mises à jour avant la configuration, l’utilitaire 2020 utilise le même firmware qu’en 2019.

Chargement du micrologiciel FRC pour ouvrir la radio Mesh

Highlighting the radio dropdown and the Load Firmware button on the main configuration utility screen.

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.

Les équipes peuvent également voir cette erreur avec les systèmes d’exploitation en langue étrangère. Si vous rencontrez des problèmes de chargement du firmware ou de la programmation sur un système d’exploitation en langue étrangère, essayez d’utiliser un système d’exploitation en anglais, par exemple sur le PC fourni dans le Kit de Pièces (KOP) ou de configurer les paramètres locaux sur « en_us » comme décrit sur cette page.

Sélectionnez la radio et le mode de fonctionnement

Highlights the Radio and Mode dropdown boxes.
  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

Setting the robot name will change the SSID.  The checkboxes make the radio more similar to competition operation.

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’en mode AP, il s’agit d’une limite totale, et non par client, donc le streaming 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

At the bottom of the screen is instructions for completing the configuration process.

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

The progress bar dialog while the configuration is working.

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

A pop up dialog indicating the programming was successful.

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

A error dialog pop up.

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.

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

  • Si vous utilisez un système d’exploitation en français, essayez plutôt d’utiliser un système d’exploitation en anglais, comme sur le PC fourni dans le Kit de Pièces KOP ou définissez le paramètre Locale comme « en_us » comme décrit sur cette page.