Una sonda es una placa pequeña en tu wifi que mide la radio que comparte tu casa inteligente: lo ocupado que está cada canal Thread, qué redes wifi hay en él y, allí donde puede unirse a tu malla Thread, la malla tal como la describen sus propios routers. ThreadMapper la lee a través de tu propia red.
Una sola pieza, unos diez minutos, sin soldar. La sonda forma parte de ThreadMapper Pro.
| Pieza | Notas |
|---|---|
| Seeed Studio XIAO ESP32C6 | Unos 5–8 $. El firmware está hecho para esta placa y para ninguna otra: controla el conmutador de antena de esta placa, su luz y su botón. |
| Un cable USB-C que transmita datos | Muchos cables que vienen con los cargadores solo llevan corriente. Si el ordenador no ve la placa, prueba primero con otro cable. |
| Un ordenador con Chrome, Edge o Firefox | Solo para la instalación. Safari no puede acceder a un puerto serie USB, y tampoco un iPhone ni un iPad. |
| Wifi en 2,4 GHz | La placa no tiene radio de 5 GHz. Una red que ofrece las dos bandas con un mismo nombre sirve. |
| Un cargador USB | Cualquiera. Ahí es donde vive la sonda una vez configurada. |
Medir funciona en todas las casas. Para leer la malla, la sonda tiene que unirse a tu red Thread, y que pueda hacerlo depende de qué gestiona esa red.
| Tu casa | El ruido de los canales, y el wifi que hay en cada canal | La propia malla Thread |
|---|---|---|
| Routers de borde de Apple o de Google, y nada más | Sí | No. Ninguno de los dos te deja sacar las credenciales de tu red Thread. Apple solo da a una app el derecho a leerlas cuando su fabricante también fabrica un router de borde certificado, y el de ThreadMapper no lo hace. |
| Lo mismo, con Home Assistant | Sí | Sí. La app Companion de Home Assistant puede copiar las credenciales a Home Assistant, y de ahí las copias tú a la sonda (paso 5). |
| Un router de borde OpenThread propio | Sí | Sí. Léelas de él (paso 5). |
Si tu casa es la primera fila, la sonda no dibujará tu malla. Aun así mide lo que ningún teléfono puede: el ruido en cada uno de los dieciséis canales Thread, cada cinco minutos, y qué redes wifi hay detrás. Decide con eso en mente antes de comprar.
Solo si la placa es nueva. Borrar se lleva todo lo que se le había dicho a una sonda: su wifi, su clave y su red Thread. Una sonda que ya funciona se actualiza en lugar de eso (consulta Actualizar), y si el instalador se lo pregunta a una así, deja la casilla sin marcar.
Tarda un minuto o dos y termina con Installation complete! Pulsa Next. La ventana del propio instalador está en inglés.
Si el puerto no está en la lista, casi siempre es el cable. Si no es eso, mantén pulsado el botón B de la placa mientras la conectas, y vuelve a intentarlo.
¿No tienes ninguno de esos navegadores? esptool, de Espressif, hace lo mismo. Una primera instalación, que borra lo que hubiera en la placa:
esptool.py --chip esp32c6 write_flash 0x0 threadmapper-probe-full.bin
Una actualización, que deja a la sonda lo que se le había dicho:
esptool.py --chip esp32c6 write_flash 0x20000 threadmapper-probe.bin
Las dos imágenes son threadmapper-probe-full.bin y threadmapper-probe.bin. Después abre el puerto serie de la placa con cualquier programa de terminal, y dale a la sonda su wifi escribiendo (paso 2, Sin la lista).
Tras una primera instalación, con Erase device marcado, el instalador pasa por sí solo a Configure Wi-Fi. Si en su lugar ves su lista de opciones, pulsa ahí Connect to Wi-Fi.
La sonda enumera las redes que oye.
El instalador dice Trying to connect, lo que puede tardar casi un minuto, y después Device connected to the network! La luz de la sonda queda entonces encendida, y sigue encendida. Pulsa Continue.
La sonda solo se queda con una red cuando ha conseguido unirse a ella. Unable to connect significa que lo intentó y no entró: casi siempre es la contraseña, a veces un router demasiado lejos. El intento no cambió nada: una sonda que ya tenía una red la sigue teniendo, y vuelve a ella. Vuelve a intentarlo.
¿Tu red no está en la lista? La sonda no tiene radio de 5 GHz, así que una red que solo está en 5 GHz no aparece. Tampoco aparece una red que oculta su nombre: elige Join other… y escribe el nombre.
El campo de la contraseña oculta lo que escribes. El nombre y la contraseña bajan por el cable hasta la placa, que los guarda en su propia memoria y no escribe la contraseña en ningún log.
Si el instalador no ofrece Connect to Wi-Fi, es que no oyó responder a la sonda: cierra su ventana, pulsa otra vez el botón de instalación y elige el puerto.
A la sonda también se le puede dar su red en su consola, en Logs & Console o en cualquier programa de terminal conectado a su puerto. Escribe wifi y pulsa Intro. Las líneas que empiezan por > son lo que escribes tú:
> wifi
Network name? Type it and press Return.
> My network
Password? The probe does not write it back. Return alone for a network without one.
> my password
stored: "My network", with a password of 11 characters.
Restarting to join it. The light stays on once it has.
Nada necesita comillas, y letras como ñ, á o ü no dan problemas. La sonda no repite la contraseña. La página sí la muestra mientras la escribes, y la guarda en su log hasta que cierras la ventana: es tu propia pantalla, así que mira primero por encima del hombro.
Si recibe una red de esta forma, la sonda se reinicia para unirse a ella y no la ha probado antes. Si su luz vuelve a un parpadeo corto cada dos segundos, es que lo intentó diez veces, no pudo unirse y ha olvidado la red.
Espera a que la luz se quede encendida. En el iPhone, abre ThreadMapper y ve a Ajustes → Sonda de ThreadMapper. Con el teléfono en el mismo wifi, la sonda aparece en En esta red: elígela. Probar conexión dice entonces qué es la sonda y cómo está.
Si la app no la muestra, pregúntale a la sonda dónde está: cierra la ventana del instalador, pulsa otra vez el botón de instalación, elige el puerto, abre Logs & Console y escribe status. Una de sus líneas es la dirección que hay que escribir en la app:
in the app: http://192.168.1.50:8099
Puede que algún día tu router le dé a la sonda otra dirección. La app conoce a la sonda por algo más que su dirección: abierta, y con el teléfono en el mismo wifi, vuelve a encontrarla por sí sola.
El cable ya ha hecho su trabajo. Desconecta la placa y ponla en un cargador, en algún lugar del centro de la casa mejor que detrás del router: la sonda oye lo que tiene cerca.
Una sonda sin clave responde a cualquiera que esté en tu wifi. Eso incluye los nombres de las redes wifi que oye, y peticiones que sacan su radio del canal de tu malla durante varios segundos cada vez.
Pulsa dos veces el botón B de la placa, una pulsación justo después de la otra. (No el R: ese reinicia la sonda.) La luz parpadea dos veces por segundo, durante tres minutos o hasta que un teléfono se ha llevado la clave. En la app, en Ajustes → Sonda de ThreadMapper, toca Obtener la clave.
A partir de entonces, la sonda solo hace lo que le cuesta tiempo de radio para un teléfono que tiene la clave. La clave demuestra quién pregunta; no oculta nada. Las respuestas siguen viajando por tu wifi sin cifrar, y también la clave, una vez, cuando se le da a un teléfono.
Solo un teléfono tiene la clave a la vez. Un segundo teléfono al que se le da se la quita al primero.
Sáltate este paso si tu casa es la primera fila de la tabla de arriba.
La sonda se une a una red Thread con el dataset activo de esa red (su «conjunto de datos activo»), una cadena de unos doscientos dígitos hexadecimales que contiene la clave de la red.
sudo ot-ctl dataset active -xConecta otra vez la sonda al ordenador, pulsa el botón de instalación de arriba, elige su puerto y abre Logs & Console sin instalar nada. Escribe thread dataset, pulsa Intro y pega el dataset cuando la sonda te lo pida:
> thread dataset
Dataset, as hex? The probe does not write it back.
> 0e080000000000010000000300001935060004001fffe0...
stored: "MyHome", channel 25. Restarting to join it.
En unos minutos, Ajustes → Sonda de ThreadMapper dice en la app que la sonda está en su malla Thread.
El dataset es la clave de tu red Thread. La sonda no lo repite, pero la página en la que lo pegas lo muestra, y lo guarda en su log hasta que cierras la ventana. La sonda lo guarda en su propia memoria, que no está cifrada: quien se lleve la placa puede leerlo.
| En la app | Solo con wifi | También con tu red Thread |
|---|---|---|
| Escáner de canales: el ruido medido en los dieciséis canales Thread | Sí | Sí |
| Las redes wifi que hay detrás del ruido, por nombre y canal | Sí | Sí |
| Un día de lecturas de ruido, tomadas cada cinco minutos mientras la app estaba cerrada | Sí | Sí |
| Lecturas de la sonda: cada router de la malla, los nodos que oye la sonda con su señal medida, y cómo enruta la malla entre ellos | No | Sí |
| En la página de un dispositivo: quién lo oye y con qué intensidad, y si responde | No | Sí |
| Doctor de Red, para un dispositivo Thread enchufado a la corriente y que Apple Home no puede alcanzar: si responde aun así en la malla y, en el caso de un dispositivo Matter, si un router de borde tiene todavía su registro | No | Sí |
Los nombres de las redes wifi se muestran en el teléfono y no se guardan en ningún sitio.
| Luz | Significado |
|---|---|
| Un parpadeo corto cada dos segundos | Todavía sin red wifi. Paso 2. |
| Parpadea despacio | Tiene una red y se está uniendo a ella. |
| Encendida | Está en tu wifi. Así es como debe verse. |
| Dos parpadeos por segundo | Has pulsado el botón dos veces: le dará la clave a un teléfono, durante tres minutos o hasta que uno se la haya llevado. |
| Parpadea deprisa | Has pulsado el botón una vez. Eso abre una ventana de tres minutos que esta versión de la app no usa. Se cierra sola y la sonda se reinicia, con lo que su día de lecturas vuelve a empezar. |
| Titila | Has mantenido pulsado el botón tres segundos. A los diez borra todo lo que se le había dicho a la sonda. |
Un firmware nuevo llega a esta página. Conecta la sonda al ordenador, pulsa el botón de instalación y elige el puerto. El instalador dice qué firmware tiene la sonda y ofrece Update ThreadMapper Probe: púlsalo, y después Install. Una actualización no borra nada: la sonda conserva su wifi, su clave y su red Thread.
Una sonda con un firmware anterior al 0.8.0 no le dice al instalador qué es. El instalador ofrece entonces Install ThreadMapper Probe y pregunta si quieres borrar el dispositivo: deja Erase device sin marcar.
Cuando la sonda ya tiene el firmware más reciente, el instalador ofrece en su lugar Erase User Data. Eso borra todo lo que se le había dicho a la sonda, igual que mantener pulsado su botón diez segundos.
| Lo que ves | Qué es |
|---|---|
| El botón de instalación dice que el navegador no es compatible | Usa Chrome, Edge o Firefox en un ordenador. |
| El puerto no está en la lista | El cable solo lleva corriente, u otro programa tiene el puerto abierto. |
| El instalador dice Unable to connect | La contraseña es incorrecta, la sonda está demasiado lejos del router o la red solo está en 5 GHz. No se cambió nada. Vuelve a intentarlo. |
| El instalador no ofrece Connect to Wi-Fi | No oyó responder a la sonda. Cierra su ventana, pulsa otra vez el botón de instalación y elige el puerto. |
| La luz ha vuelto a un parpadeo corto cada dos segundos | La sonda no pudo unirse a una red escrita en la consola: la contraseña es incorrecta, o la red solo está en 5 GHz. Tras diez intentos, la sonda la olvidó. Dale la red otra vez (paso 2). |
| La luz sigue parpadeando despacio | La sonda ya se había unido a esta red y ahora no llega a ella: el router está apagado o demasiado lejos, o su contraseña ha cambiado. Si ha cambiado, dale la red otra vez (paso 2). |
| La sonda dice que el dataset está cortado, o que no tiene la longitud correcta | Un pegado largo puede perder un trozo por el camino. Pégalo otra vez. |
| La app no muestra la sonda | El teléfono está en otro wifi, o en una red de invitados que mantiene los dispositivos separados. Escribe la dirección que da status. |
| La app dice que la sonda tiene una clave que este iPhone no tiene | Otro teléfono se llevó la clave, o la sonda volvió a empezar desde cero. Pulsa B dos veces y toca otra vez Obtener la clave. |
| La app dice que la sonda está fuera de su malla Thread | Tiene un dataset y no encuentra la red: el dataset es de otra red, o no hay ningún router al alcance. |
| Quieres empezar de nuevo | Mantén pulsado el botón B diez segundos. |