Una sonda è una piccola scheda elettronica collegata al tuo Wi-Fi che misura la radio che la tua casa smart condivide: quanto è affollato ogni canale Thread, quali reti Wi-Fi lo occupano e, dove può entrare nella tua mesh Thread, la mesh così come la riportano i suoi stessi router. ThreadMapper la legge attraverso la tua stessa rete.
Un solo componente, circa dieci minuti, nessuna saldatura. La sonda fa parte di ThreadMapper Pro.
| Componente | Note |
|---|---|
| Seeed Studio XIAO ESP32C6 | Circa 5–8 $. Il firmware è fatto per questa scheda e per nessun’altra: comanda il commutatore d’antenna di questa scheda, la sua spia e il suo pulsante. |
| Un cavo USB-C che trasporta dati | Molti cavi forniti con i caricabatterie trasportano solo corrente. Se il computer non vede la scheda, prova prima un altro cavo. |
| Un computer con Chrome, Edge o Firefox | Solo per l’installazione. Safari non può accedere a una porta seriale USB, e nemmeno un iPhone o un iPad. |
| Wi-Fi a 2,4 GHz | La scheda non ha una radio a 5 GHz. Una rete che offre entrambe le bande sotto un solo nome va bene. |
| Un caricabatterie USB | Uno qualsiasi. È lì che vive la sonda una volta configurata. |
La misurazione funziona in ogni casa. Per leggere la mesh la sonda deve entrare nella tua rete Thread, e se può farlo dipende da che cosa gestisce quella rete.
| La tua casa | Il rumore dei canali, e il Wi-Fi su ogni canale | La mesh Thread vera e propria |
|---|---|---|
| Border router di Apple o di Google, e nient’altro | Sì | No. Né Apple né Google ti permettono di estrarre le credenziali della tua rete Thread. Apple dà a un’app il diritto di leggerle solo quando chi la produce produce anche un border router certificato, e chi produce ThreadMapper non lo fa. |
| Lo stesso, con Home Assistant | Sì | Sì. L’app Companion di Home Assistant può copiare le credenziali in Home Assistant, e tu le copi da lì alla sonda (passaggio 5). |
| Un OpenThread Border Router tuo | Sì | Sì. Leggile direttamente dal border router (passaggio 5). |
Se la prima riga è casa tua, la sonda non disegnerà la tua mesh. Misura comunque ciò che nessun telefono può misurare: il rumore su ciascuno dei sedici canali Thread, ogni cinque minuti, e quali reti Wi-Fi ci stanno dietro. Decidi in base a questo prima di comprare.
Solo per una scheda nuova. La cancellazione porta via con sé tutto ciò che è stato detto a una sonda: il suo Wi-Fi, la sua chiave e la sua rete Thread. Una sonda che funziona già viene invece aggiornata (vedi Aggiornamento), e se il programma di installazione lo chiede per una sonda così, lascia la casella senza spunta.
Ci vogliono uno o due minuti e finisce con Installation complete! Premi Next. La finestra del programma di installazione è in inglese.
Se la porta non è nell’elenco, è quasi sempre il cavo. Altrimenti, tieni premuto il pulsante B della scheda mentre la colleghi, e riprova.
Nessuno di quei browser? esptool di Espressif fa la stessa cosa. Una prima installazione, che cancella qualunque cosa ci fosse sulla scheda:
esptool.py --chip esp32c6 write_flash 0x0 threadmapper-probe-full.binUn aggiornamento, che lascia alla sonda ciò che le è stato detto:
esptool.py --chip esp32c6 write_flash 0x20000 threadmapper-probe.binLe due immagini sono threadmapper-probe-full.bin e threadmapper-probe.bin. Poi apri la porta seriale della scheda con un qualsiasi programma di terminale, e dai alla sonda il suo Wi-Fi scrivendolo (passaggio 2, Senza l’elenco).
Dopo una prima installazione, con Erase device spuntato, il programma di installazione passa da solo a Configure Wi-Fi. Se invece hai davanti il suo elenco di scelte, premi lì Connect to Wi-Fi.
La sonda elenca le reti che rileva.
Il programma di installazione dice Trying to connect, cosa che può richiedere quasi un minuto, e poi Device connected to the network! A quel punto la spia della sonda è accesa e resta accesa. Premi Continue.
La sonda tiene una rete solo dopo esserci entrata. Unable to connect significa che ha provato e non ci è riuscita: quasi sempre è la password, a volte un router troppo lontano. Il tentativo non ha cambiato nulla: una sonda che prima aveva una rete ce l’ha ancora, e ci torna. Riprova.
La tua rete non è nell’elenco? La sonda non ha una radio a 5 GHz, quindi una rete solo a 5 GHz non c’è. E non c’è nemmeno una rete che nasconde il proprio nome: scegli Join other… e scrivi il nome.
Il campo della password nasconde ciò che scrivi. Il nome e la password scendono lungo il cavo fino alla scheda, che li conserva nella propria memoria e non scrive la password in nessun log.
Se il programma di installazione non offre Connect to Wi-Fi, non ha sentito la sonda rispondere: chiudi la sua finestra, premi di nuovo il pulsante di installazione e scegli la porta.
Alla sonda si può dare la rete anche dalla sua console, in Logs & Console o in un qualsiasi programma di terminale sulla sua porta. Scrivi wifi e premi Invio. Le righe che iniziano con > sono ciò che scrivi tu:
> 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.Non servono virgolette, e lettere come å, ä e ö vanno bene. La sonda non riscrive la password. La pagina invece la mostra mentre la scrivi, e la conserva nel proprio log finché non chiudi la finestra: è il tuo schermo, quindi prima guardati alle spalle.
Ricevuta una rete in questo modo, la sonda si riavvia per entrarci e non l’ha provata prima. Se la sua spia torna a un breve lampo ogni due secondi, ha provato dieci volte, non è riuscita a entrare e ha dimenticato la rete.
Aspetta che la spia resti accesa. Sull’iPhone, apri ThreadMapper e vai in Impostazioni → Sonda ThreadMapper. Con il telefono sullo stesso Wi-Fi, la sonda compare sotto In questa rete: sceglila. Prova la connessione dice poi che cos’è la sonda e in che stato si trova.
Se l’app non la elenca, chiedi alla sonda dov’è: chiudi la finestra del programma di installazione, premi di nuovo il pulsante di installazione, scegli la porta, apri Logs & Console e scrivi status. Una delle sue righe è l’indirizzo da scrivere nell’app:
in the app: http://192.168.1.50:8099Un giorno il tuo router potrebbe dare alla sonda un altro indirizzo. L’app riconosce la sonda da qualcosa di più del suo indirizzo: quando è aperta, e con il telefono sullo stesso Wi-Fi, ritrova la sonda da sola.
Il cavo ha fatto il suo lavoro. Scollega la scheda e mettila su un caricabatterie, da qualche parte al centro della casa piuttosto che dietro il router: la sonda rileva ciò che le sta vicino.
Una sonda senza chiave risponde a chiunque sia sul tuo Wi-Fi. Questo comprende i nomi delle reti Wi-Fi che rileva, e richieste che portano la sua radio fuori dal canale della tua mesh per alcuni secondi alla volta.
Premi due volte il pulsante B della scheda, una pressione subito dopo l’altra. (Non R: quello riavvia la sonda.) La spia lampeggia due volte al secondo, per tre minuti o finché un telefono non ha preso la chiave. Nell’app, in Impostazioni → Sonda ThreadMapper, tocca Ottieni la chiave.
Da quel momento la sonda fa ciò che costa tempo alla sua radio solo per un telefono che ha la chiave. La chiave dimostra chi sta chiedendo; non nasconde nulla. Le risposte continuano ad attraversare il tuo Wi-Fi non cifrate, e così anche la chiave, una volta, quando viene data a un telefono.
Un solo telefono alla volta ha la chiave. Un secondo telefono a cui viene data la toglie al primo.
Salta questo passaggio se la tua casa è la prima riga della tabella qui sopra.
La sonda entra in una rete Thread con il dataset attivo di quella rete, una stringa di circa duecento cifre esadecimali che contiene la chiave della rete.
sudo ot-ctl dataset active -xCollega di nuovo la sonda al computer, premi il pulsante di installazione qui sopra, scegli la sua porta e apri Logs & Console senza installare nulla. Scrivi thread dataset, premi Invio e incolla il dataset quando la sonda lo chiede:
> thread dataset
Dataset, as hex? The probe does not write it back.
> 0e080000000000010000000300001935060004001fffe0...
stored: "MyHome", channel 25. Restarting to join it.Entro pochi minuti Impostazioni → Sonda ThreadMapper, nell’app, dice che la sonda è nella sua mesh Thread.
Il dataset è la chiave della tua rete Thread. La sonda non lo riscrive, ma la pagina in cui lo incolli lo mostra, e lo conserva nel proprio log finché non chiudi la finestra. La sonda lo conserva nella propria memoria, che non è cifrata: chi prende la scheda può leggerlo.
| Nell’app | Solo con il Wi-Fi | Anche con la tua rete Thread |
|---|---|---|
| Scanner dei canali: il rumore misurato su tutti e sedici i canali Thread | Sì | Sì |
| Le reti Wi-Fi dietro il rumore, per nome e canale | Sì | Sì |
| Un giorno di misure del rumore, prese ogni cinque minuti mentre l’app era chiusa | Sì | Sì |
| Misure della sonda: ogni router della mesh, i nodi che la sonda rileva con il loro segnale misurato, e come la mesh instrada tra loro | No | Sì |
| Nella pagina di un dispositivo: chi lo rileva e quanto bene, e se risponde | No | Sì |
| Dottore della rete, per un dispositivo Thread alimentato a rete che Apple Home non riesce a raggiungere: se risponde comunque nella mesh e, per un dispositivo Matter, se un border router ne conserva ancora la registrazione | No | Sì |
I nomi delle reti Wi-Fi sono mostrati sul telefono e non vengono salvati da nessuna parte.
| Spia | Significato |
|---|---|
| Un breve lampo ogni due secondi | Ancora nessuna rete Wi-Fi. Passaggio 2. |
| Lampeggia lentamente | Ha una rete e ci sta entrando. |
| Accesa | È sul tuo Wi-Fi. È così che deve apparire. |
| Due lampi al secondo | Hai premuto il pulsante due volte: darà la chiave a un telefono, per tre minuti o finché uno non l’ha presa. |
| Lampeggia velocemente | Hai premuto il pulsante una volta. Questo apre una finestra di tre minuti che questa versione dell’app non usa. Si chiude da sola e la sonda si riavvia, il che fa ricominciare il suo giorno di misure. |
| Tremola | Hai tenuto premuto il pulsante per tre secondi. A dieci cancella tutto ciò che è stato detto alla sonda. |
Un nuovo firmware arriva su questa pagina. Collega la sonda al computer, premi il pulsante di installazione e scegli la porta. Il programma di installazione dice quale firmware è in esecuzione sulla sonda e offre Update ThreadMapper Probe: premilo, e poi Install. Un aggiornamento non cancella nulla: la sonda conserva il suo Wi-Fi, la sua chiave e la sua rete Thread.
Una sonda con un firmware precedente alla 0.8.0 non dice al programma di installazione che cos’è. Il programma di installazione offre allora Install ThreadMapper Probe e chiede se cancellare il dispositivo: lascia Erase device senza spunta.
Quando sulla sonda è già in esecuzione il firmware più recente, il programma di installazione offre invece Erase User Data. Questo cancella tutto ciò che è stato detto alla sonda, come fa tenere premuto il suo pulsante per dieci secondi.
| Che cosa vedi | Che cos’è |
|---|---|
| Il pulsante di installazione dice che il browser non è supportato | Usa Chrome, Edge o Firefox su un computer. |
| La porta non è nell’elenco | Il cavo trasporta solo corrente, oppure un altro programma tiene aperta la porta. |
| Il programma di installazione dice Unable to connect | La password è sbagliata, la sonda è troppo lontana dal router, oppure la rete è solo a 5 GHz. Non è stato cambiato nulla. Riprova. |
| Il programma di installazione non offre Connect to Wi-Fi | Non ha sentito la sonda rispondere. Chiudi la sua finestra, premi di nuovo il pulsante di installazione e scegli la porta. |
| La spia è tornata a un breve lampo ogni due secondi | La sonda non è entrata in una rete scritta dalla console: la password è sbagliata, oppure la rete è solo a 5 GHz. Dopo dieci tentativi la sonda l’ha dimenticata. Dalle di nuovo la rete (passaggio 2). |
| La spia continua a lampeggiare lentamente | La sonda è già entrata in questa rete in passato e ora non riesce a raggiungerla: il router è spento o troppo lontano, oppure la sua password è cambiata. Se è cambiata, dalle di nuovo la rete (passaggio 2). |
| La sonda dice che il dataset è troncato, o della lunghezza sbagliata | Un testo lungo incollato può perdere un pezzo per strada. Incollalo ancora una volta. |
| L’app non elenca la sonda | Il telefono è su un altro Wi-Fi, o su una rete ospiti che tiene separati i dispositivi. Scrivi l’indirizzo dato da status. |
| L’app dice che la sonda ha una chiave che questo iPhone non ha | Un altro telefono ha preso la chiave, oppure la sonda è stata fatta ripartire da zero. Premi due volte B e tocca di nuovo Ottieni la chiave. |
| L’app dice che la sonda è fuori dalla sua mesh Thread | Ha un dataset e non trova la rete: il dataset è di un’altra rete, oppure nessun router è a portata. |
| Vuoi ricominciare da capo | Tieni premuto il pulsante B per dieci secondi. |