MicroDuck verbinden: Suche, WLAN und Konsole

1. Finden Sie den richtigen Roboter von Ihrem Laptop aus.

Installieren Sie zuerst uv, falls Sie es noch nicht haben. Der veröffentlichte duckctl-Client läuft auf einem Laptop über uvx; Führen Sie es nicht auf dem Roboter aus. Der erste Befehl unten liest BLE-Anzeigen in der Nähe, ohne eine Verbindung herzustellen oder nach einer PIN zu fragen. Verwenden Sie den Namen aus Ihrer eigenen Scan-Ausgabe anstelle des Upstream-Beispiels duck-c51b. Die Angabe eines Namens ist wichtig: Ohne Namen kann der erste gefundene Roboter auf einer gemeinsamen Bank gewinnen. Der zweite Befehl stellt eine Verbindung zum Lesen der Identität her und kann die Roboter-PIN koppeln und überprüfen; Es handelt sich um einen anderen Schritt als beim passiven Scannen. Offizieller Laptop-Leitfaden ↗ Client-Implementierung ↗.

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

Wenn der Roboter fehlt, kann uvx duckctl scan --verbose anzeigen, was das Bluetooth-Funkgerät sonst noch gesehen hat, aber das Fehlen allein identifiziert keinen Strom-, Funk- oder Namensfehler. Halten Sie die Scan-Ausgabe privat, da sie Geräteadressen enthalten kann. uvx duckctl kann ein zwischengespeichertes Paket verwenden oder ein neu veröffentlichtes auflösen; Diese Anweisungen wurden mit dem 0.17.2-Client verglichen. Vergleichen Sie daher den installierten Client und die Roboterversion, wenn sich das Verhalten unterscheidet. 0.17.2 Paket ↗.

2. Behandeln Sie „keine Adresse“ als WLAN-Frage und nicht als fehlgeschlagenen BLE-Scan.

Diese beiden Wi-Fi-Abfragen fragen den Roboter über Bluetooth; Eine bestehende WLAN- oder SSH-Verbindung ist nicht erforderlich. Wählen Sie den genauen Roboternamen. Im Gegensatz zum passiven scan stellt eine Wi-Fi-Abfrage eine Verbindung her und benötigt die Roboter-PIN ( --pin, DUCK_PIN oder den dokumentierten 000000-Fallback). Die PIN-Prüfung ist kein Beweis dafür, dass die BLE-Verbindung verschlüsselt ist. Veröffentlichen Sie Ihre PIN, Ihren WLAN-Namen oder Ihre Geräteadresse nicht mit einer Supportfrage. WLAN- und PIN-Anleitung ↗ BLE-Dienststandard ↗.

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

Wenn Sie absichtlich einem Netzwerk beitreten, ersetzen Sie beide Platzhalter lokal in der offiziellen Befehlsvorlage unten. Die feste duckctl-CLI akzeptiert das Passwort als --psk-Argument; Auf dieser Route wird keine versteckte interaktive Passwortoption angeboten. Auf einem gemeinsam genutzten Computer können Befehlszeilenargumente und der Shell-Verlauf ihn offenlegen. Noch schlimmer ist, dass der feste Bluetooth-Dienst 0.17.2 auf einem normalen Entwicklungsboard standardmäßig keine Kopplung oder Verbindungsverschlüsselung vornimmt: Die PIN und die Wi-Fi-Passphrase können von jemandem in Funkreichweite gelesen werden. Behandeln Sie dies als reine Entwicklungsbereitstellung in einem vertrauenswürdigen, isolierten Labornetzwerk mit temporären Anmeldeinformationen. Geben Sie auf dieser Route kein normales WLAN-Passwort für zu Hause oder am Arbeitsplatz ein, als ob es sicher wäre. Fügen Sie niemals den abgeschlossenen Befehl in einen Beitrag ein. Dieser Schritt verändert das Netzwerk des Roboters: Eine bestehende Wi-Fi-SSH-Sitzung wird möglicherweise getrennt, was ein erwartetes Ergebnis sein kann. Der Dienst fragt bis zu 45 Sekunden lang ab und der Kunde hat eine separate Frist von 60 Sekunden; Beides ist kein erfolgreiches Beitrittsversprechen. Lassen Sie --psk nur für ein absichtlich offenes Netzwerk weg. offizielles Wi-Fi-Verfahren ↗ CLI-Argumentdefinition ↗ Dienstwarnung ↗ unverschlüsselte Route ↗.

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

3. Trennen Sie eine Adresse von einer Arbeitskonsole.

Lesen Sie nach dem Beitritt den WLAN-Status und die Adresse erneut ab. open --print druckt nur die Konsolen-URL des Roboters, ohne einen Browser zu öffnen; Der reguläre Befehl open öffnet die integrierte Roboterseite. Ein Roboter ohne Netzwerkadresse kann diese WebRTC-Konsole nicht anbieten. Die Seite selbst wird auf Port 8080 bereitgestellt, während ihre separate Signalisierungsverbindung Port 8443 verwendet. Wenn die Seite geladen wird, aber meldet, dass die Signalisierung nicht geantwortet hat, ist die Roboterseite erreichbar und die nächste Frage ist der Netzwerkpfad zu 8443, oft eine Firewall. Dies ist kein Grund, Bluetooth erneut zu koppeln. Stellen Sie keinen der Ports als Verknüpfung zur Fehlerbehebung dem öffentlichen Internet zur Verfügung. Konsolenbereich ↗.

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

Die Konsole enthält Live-Bewegungssteuerungen. Die Schaltfläche „Stopp“ setzt die von dieser Seite gesendeten Absichten auf Null. Es wird die Servoleistung nicht unterbrochen und es handelt sich nicht um einen physischen Notstopp. In diesem Artikel wird erläutert, wie Sie auf die Seite zugreifen und nicht, wie Sie Bewegungen überprüfen. offizielle Sicherheitsgrenze der Konsole ↗.

Teilen Sie die fehlgeschlagene Phase mit entfernten Geheimnissen.

Eine nützliche technische Frage gibt die Client- und Roboterversion an, sofern bekannt, ob ein benannter Roboter in scan auftauchte, ob seine Adresse fehlte und ob das Problem die Port-8080-Seite oder die Port-8443-Signalisierung ist. Sagen Sie, ob es sich bei der Maschine um eine offizielle Maschine oder eine Nachbildung handelt. Entfernen Sie die Bluetooth-Adresse, die Seriennummer, die lokale IP, die SSID, die PIN, das WLAN-Passwort und die Kontodetails. Befolgen Sie für die Reaktion des Gamepads nach der Verbindung die separate Bluetooth-Pad-Diagnose; Informationen zum UDP-Steuerungstiming finden Sie im 0.17.2 Release Guide.