Conectar MicroDuck: descubrimiento, Wi-Fi y consola

1. Encuentre el robot adecuado desde su computadora portátil.

Instale uv primero si aún no lo tiene. El cliente duckctl publicado se ejecuta en una computadora portátil a través de uvx; no lo ejecute en el robot. El primer comando a continuación lee anuncios BLE cercanos sin conectarse ni solicitar un PIN. Utilice el nombre de su propio resultado de escaneo en lugar del ejemplo ascendente duck-c51b. Es importante especificar un nombre: sin nombre, el primer robot encontrado puede ganar en un banco compartido. El segundo comando se conecta para leer la identidad y puede emparejarse y probar el PIN del robot; es un paso diferente al escaneo pasivo. guía oficial de portátiles ↗ implementación del cliente ↗.

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

Si falta el robot, uvx duckctl scan --verbose puede mostrar qué más vio la radio Bluetooth, pero la ausencia por sí sola no identifica una falla de energía, radio o nombre. Mantenga la salida del escaneo privada porque puede incluir direcciones de dispositivos. uvx duckctl puede utilizar un paquete almacenado en caché o resolver uno recién publicado; Estas instrucciones se compararon con el cliente 0.17.2, así que compare el cliente instalado y la versión del robot si el comportamiento difiere. paquete 0.17.2 ↗.

2. Trate "sin dirección" como una pregunta sobre Wi-Fi, no como un escaneo BLE fallido.

Estas dos consultas de Wi-Fi las realiza el robot a través de Bluetooth; No se requiere una conexión Wi-Fi o SSH existente. Elija el nombre exacto del robot. A diferencia del scan pasivo, una consulta de Wi-Fi se conecta y necesita el PIN del robot (--pin, DUCK_PIN o el respaldo 000000 documentado). La verificación del PIN no es prueba de que el enlace BLE esté cifrado. No publique su PIN, nombre de Wi-Fi o dirección de dispositivo con una pregunta de soporte. Guía de Wi-Fi y PIN ↗ Servicio BLE predeterminado ↗.

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

Si se une intencionalmente a una red, reemplace ambos marcadores de posición localmente en la plantilla de comando oficial a continuación. La CLI duckctl fija acepta la contraseña como argumento --psk; no ofrece una opción de contraseña interactiva oculta en esta ruta. En una computadora compartida, los argumentos de la línea de comandos y el historial del shell pueden exponerlo. Más en serio, el servicio Bluetooth fijo 0.17.2 por defecto no tiene emparejamiento ni cifrado de enlaces en una placa de desarrollo normal: alguien que esté dentro del alcance de la radio puede leer el PIN y la contraseña de Wi-Fi. Trate esto como un aprovisionamiento exclusivo para desarrollo en una red de laboratorio aislada y confiable con credenciales temporales; No introduzcas una contraseña Wi-Fi normal de casa o del trabajo en esta ruta como si fuera segura. Nunca pegues el comando completado en una publicación. Este paso cambia la red del robot: una sesión Wi-Fi SSH existente puede desconectarse, lo que puede ser un resultado esperado. El servicio sondea por hasta 45 segundos y el cliente tiene un plazo separado de 60 segundos; tampoco lo es una promesa de unión exitosa. Omita --psk solo para una red abierta intencionalmente. procedimiento oficial de Wi-Fi ↗ definición de argumento CLI ↗ advertencia de servicio ↗ ruta no cifrada ↗.

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

3. Separe una dirección de una consola que funcione.

Después de unirse, lea nuevamente el estado de Wi-Fi y la dirección. open --print solo imprime la URL de la consola del robot sin abrir un navegador; el comando normal open abre la página del robot incorporado. Un robot sin dirección de red no puede ofrecer esta consola WebRTC. La página en sí se sirve en el puerto 8080, mientras que su conexión de señalización independiente utiliza el puerto 8443. Si la página se carga pero informa que la señalización no respondió, se puede acceder a la página del robot y la siguiente pregunta es la ruta de red al 8443, a menudo un firewall. Esta no es una razón para volver a emparejar Bluetooth. No exponga ninguno de los puertos a la Internet pública como atajo para la solución de problemas. alcance de la consola ↗.

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

La consola contiene controles de movimiento en vivo. Su botón Detener pone a cero los intents enviados por esa página; no corta la potencia del servo y no es una parada de emergencia física. Este artículo explica cómo llegar a la página, no cómo validar el movimiento. límite de seguridad oficial de la consola ↗.

Comparte la etapa fallida, sin secretos.

Una pregunta técnica útil indica la versión del cliente y del robot, si se conoce, si apareció un robot con nombre en scan, si su dirección estaba ausente y si el problema es la página del puerto 8080 o la señalización del puerto 8443. Indique si la máquina es oficial o una réplica. Elimine la dirección de Bluetooth, serie, IP local, SSID, PIN, contraseña de Wi-Fi y detalles de la cuenta. Para conocer la respuesta del gamepad después de la conexión, siga el diagnóstico del mando Bluetooth; para conocer la sincronización del control UDP, consulte la guía de versión 0.17.2.