Connecter MicroDuck : découverte, Wi-Fi et console

1. Trouvez le bon robot depuis votre ordinateur portable.

Installez d'abord uv si vous ne l'avez pas déjà. Le client duckctl publié s'exécute sur un ordinateur portable via uvx ; ne l'exécutez pas sur le robot. La première commande ci-dessous lit les publicités BLE à proximité sans se connecter ni demander de code PIN. Utilisez le nom de votre propre sortie d'analyse à la place de l'exemple en amont duck-c51b. Préciser un nom est important : sans nom, le premier robot trouvé peut gagner sur un banc partagé. La deuxième commande se connecte pour lire l'identité et peut associer et prouver le code PIN du robot ; c'est une étape différente de l'analyse passive. guide officiel de l'ordinateur portable ↗ implémentation du client ↗.

uvx duckctl scan
uvx duckctl --name duck-c51b info

Si le robot est absent, uvx duckctl scan --verbose peut montrer ce que la radio Bluetooth a vu d'autre, mais l'absence à elle seule n'identifie pas un défaut d'alimentation, de radio ou de dénomination. Gardez le résultat de l'analyse privé, car il peut inclure des adresses de périphériques. uvx duckctl peut utiliser un package mis en cache ou résoudre un package récemment publié ; ces instructions ont été vérifiées par rapport au client 0.17.2, comparez donc la version du client installé et de la version du robot si le comportement diffère. Paquet 0.17.2 ↗.

2. Traitez « pas d'adresse » comme une question Wi-Fi et non comme un échec d'analyse BLE.

Ces deux requêtes Wi-Fi demandent au robot via Bluetooth ; une connexion Wi-Fi ou SSH existante n’est pas requise. Choisissez le nom exact du robot. Contrairement au scan passif, une requête Wi-Fi se connecte et nécessite le code PIN du robot ( --pin, DUCK_PIN ou le repli documenté 000000). La vérification du code PIN ne prouve pas que le lien BLE est crypté. Ne publiez pas votre code PIN, votre nom Wi-Fi ou l'adresse de votre appareil avec une question d'assistance. Guide Wi-Fi et PIN ↗ Service BLE par défaut ↗.

uvx duckctl --name duck-c51b wifi status
uvx duckctl --name duck-c51b wifi scan

Si vous rejoignez intentionnellement un réseau, remplacez les deux espaces réservés localement dans le modèle de commande officiel ci-dessous. La CLI duckctl fixe accepte le mot de passe comme argument --psk ; il n'offre pas d'option de mot de passe interactif caché sur cet itinéraire. Sur un ordinateur partagé, les arguments de ligne de commande et l'historique du shell peuvent l'exposer. Plus sérieusement, le service Bluetooth 0.17.2 fixe par défaut aucun couplage ni cryptage de lien sur une carte de développement ordinaire : le code PIN et la phrase secrète Wi-Fi peuvent être lus par quelqu'un à portée radio. Traitez cela comme un provisionnement réservé au développement sur un réseau de laboratoire fiable et isolé avec des informations d'identification temporaires ; n'entrez pas un mot de passe Wi-Fi domestique ou professionnel ordinaire dans cette route comme s'il était sécurisé. Ne collez jamais la commande terminée dans un message. Cette étape modifie le réseau du robot : une session Wi-Fi SSH existante peut se déconnecter, ce qui peut être un résultat attendu. Le service interroge jusqu'à 45 secondes et le client dispose d'un délai distinct de 60 secondes ; une promesse d’adhésion réussie n’est pas non plus une promesse. Omettez --psk uniquement pour un réseau intentionnellement ouvert. procédure Wi-Fi officielle ↗ Définition de l'argument CLI ↗ avertissement de service ↗ route non cryptée ↗.

uvx duckctl --name duck-c51b wifi connect 'YOUR_SSID' --psk 'YOUR_WIFI_PASSWORD'

3. Séparez une adresse d'une console de travail.

Après vous être inscrit, lisez à nouveau l’état du Wi-Fi et l’adresse. open --print imprime uniquement l'URL de la console du robot sans ouvrir de navigateur ; la commande régulière open ouvre la page du robot intégré. Un robot sans adresse réseau ne peut pas proposer cette console WebRTC. La page elle-même est servie sur le port 8080, tandis que sa connexion de signalisation distincte utilise le port 8443. Si la page se charge mais signale que la signalisation n'a pas répondu, la page du robot est accessible et la question suivante est le chemin réseau vers 8443, souvent un pare-feu. Ce n’est pas une raison pour réappairer Bluetooth. N'exposez aucun des deux ports à l'Internet public comme raccourci de dépannage. lunette de console ↗.

uvx duckctl --name duck-c51b wifi status
uvx duckctl --name duck-c51b ip
uvx duckctl --name duck-c51b open --print

La console contient des commandes de mouvement en direct. Son bouton Stop remet à zéro les intentions envoyées par cette page ; il ne coupe pas la puissance du servo et ne constitue pas un arrêt d'urgence physique. Cet article explique comment accéder à la page, pas comment valider le mouvement. Limite de sécurité officielle de la console ↗.

Partagez l’étape ayant échoué, avec les secrets supprimés.

Une question technique utile indique la version du client et du robot si elle est connue, si un robot nommé est apparu dans scan, si son adresse était absente et si le problème est la page du port 8080 ou la signalisation du port 8443. Dites si la machine est officielle ou une réplique. Supprimez l'adresse Bluetooth, la série, l'adresse IP locale, le SSID, le code PIN, le mot de passe Wi-Fi et les détails du compte. Pour la réponse de la manette de jeu après la connexion, suivez le diagnostic de la manette Bluetooth ; pour la synchronisation du contrôle UDP, consultez le guide de version 0.17.2.