Installer le logiciel

Installer le firmware

Aucun outil à installer : le firmware va sur la carte directement depuis ton navigateur. Tu peux l'installer sur une carte nue avant de construire le robot.

1. Ouvre le flasher web dans Chrome ou Edge sur un ordinateur.
2. Branche la carte ESP32 en USB, avec un câble qui transporte les données.
3. Installe : appuie sur Connecter et installer et choisis le port de la carte. Le bon firmware pour ta puce est choisi pour toi.
4. Connecte : saisis ton Wi-Fi quand on te le demande, puis choisis Visit device.

Note

Le flasher web installe par défaut la version Stable. Le canal Bêta reçoit les nouveautés en premier et peut encore contenir des bugs. Voir les canaux de publication (en anglais).

Mettre à jour, compiler depuis les sources

• Mettre à jour un robot déjà installé : quand une nouvelle version sort, l'écran principal du robot affiche Version X disponible avec Nouveautés et Mettre à jour. Touche Mettre à jour, puis Installer maintenant : ton téléphone télécharge la version pour la puce du robot et l'envoie au robot, qui redémarre dessus environ une minute plus tard. Garde la page ouverte jusqu'à ce qu'elle annonce le retour du robot. Les réglages et la calibration sont conservés. On retrouve tout ça dans Réglages → Robot → Mise à jour du firmware, où Impossible de vérifier les mises à jour veut dire que ton téléphone n'a pas accès à Internet (touche Réessayer). Termine ou arrête d'abord une Session de jeu ou une Calibration.
• Stable ou Bêta : Réglages → Robot → Mise à jour du firmware → Canal de mise à jour choisit les versions proposées au robot (canaux de publication). Le robot garde ce choix après un redémarrage ou une mise à jour. Tant que tu n'as pas choisi, il suit la version installée : une bêta propose des bêtas.
• Pas d'Internet sur ton téléphone (par exemple sur le hotspot du robot) : télécharge à l'avance le fichier -ota.bin de ta puce dans les versions publiées, puis envoie-le depuis Réglages → Robot → Mise à jour du firmware → Installer depuis un fichier.
• Compiler depuis les sources avec PlatformIO ; Bien démarrer présente les outils :

cd firmware
pio run -e esp32 -t upload   # ou esp32s3 / esp32c3

• La carte n'apparaît pas ? Essaie un autre câble, puis installe le pilote de sa puce USB : voir Installer avec le flasher web pour les liens de téléchargement.

Premier démarrage

1. Si tu as saisi ton Wi-Fi dans le flasher web, passe à l'étape 3. Sinon, alimente le robot : sans Wi-Fi configuré, il ouvre un hotspot CatWandConnect-XXXX.
2. Connecte-toi à ce hotspot depuis ton téléphone. La page de configuration s'ouvre toute seule ; sinon, va sur http://192.168.4.1/. Choisis ton Wi-Fi et saisis son mot de passe, ou touche Continuer sans Wi-Fi pour utiliser le robot depuis le hotspot pour l'instant.
3. Reviens sur ton Wi-Fi habituel et ouvre l'adresse affichée à la fin de la configuration, par exemple http://catwandconnect-3f9a.local/ (ou l'adresse IP affichée). Avec le nom par défaut, l'adresse .local du robot se termine par 4 caractères qui lui sont propres, pour que deux robots ne se gênent jamais ; les robots installés avant la version 0.2.1 gardent catwandconnect.local. Ouverte par adresse IP, la page propose d'abord Utilise l'adresse permanente du robot : touche Y aller pour passer à l'adresse .local, qui reste valable quand l'IP change. Elle ne le propose que si ton téléphone ou ton ordinateur arrive à l'ouvrir ; sinon, vois l'adresse .local ne s'ouvre pas.
4. Calibre. L'écran principal t'y invite. L'assistant te fait amener chaque axe aux extrémités de sa course sans danger et choisir la position de repos, puis il parcourt lentement les nouvelles limites pour que tu vérifies que rien ne touche. Une fois les limites enregistrées, il balaie chaque axe pendant que tu règles sa vitesse minimale et maximale, puis lui fait faire de courts mouvements pendant que tu règles son accélération (Passer garde une valeur telle quelle). D'ici là, les mouvements restent dans une plage prudente de 60° à 120° sur chaque axe.
5. Joue. Fais glisser le joystick pour bouger la baguette et relâche pour l'arrêter. Appuie sur Ranger pour la ranger.
6. Personnalise-le. Donne un nom au robot dans les Réglages ; son adresse suit, par exemple http://catwandconnect-salon.local/. Sur un téléphone, la première visite montre comment ajouter le robot à ton écran d'accueil pour avoir une icône comme une appli (Compris masque l'astuce ; Réglages → Robot ou Aide → Ajouter à ton écran d'accueil la réaffiche). Réglages → Réseau affiche l'adresse IP du robot, et Changer de réseau Wi-Fi le fait passer sur un autre réseau plus tard (nouvelle box, déménagement).

Un problème ? Voir le dépannage, puis Obtenir de l'aide.

Ensuite, en option : Configurer Home Assistant.