Uma sonda é uma pequena placa no seu Wi-Fi que mede o rádio que a sua casa inteligente compartilha: o quão ocupado está cada canal Thread, quais redes Wi-Fi estão nele e, onde ela consegue entrar na sua malha Thread, a malha como os próprios roteadores dela a informam. O ThreadMapper lê a sonda pela sua própria rede.
Uma peça só, cerca de dez minutos, sem solda. A sonda faz parte do ThreadMapper Pro.
| Peça | Observações |
|---|---|
| Seeed Studio XIAO ESP32C6 | Cerca de US$ 5–8. O firmware é feito para esta placa e nenhuma outra: ele controla o comutador de antena desta placa, a luz e o botão dela. |
| Um cabo USB-C que transmita dados | Muitos cabos que vêm com carregadores só transmitem energia. Se o computador não enxergar a placa, tente outro cabo primeiro. |
| Um computador com Chrome, Edge ou Firefox | Só para a instalação. O Safari não consegue acessar uma porta serial USB, e um iPhone ou um iPad também não. |
| Wi-Fi em 2,4 GHz | A placa não tem rádio de 5 GHz. Uma rede que oferece as duas faixas com um só nome serve. |
| Um carregador USB | Qualquer um. É onde a sonda fica depois de configurada. |
Medir funciona em qualquer casa. Para ler a malha, a sonda precisa entrar na sua rede Thread, e se ela consegue depende do que opera essa rede.
| Sua casa | Ruído dos canais, e o Wi-Fi em cada canal | A própria malha Thread |
|---|---|---|
| Roteadores de borda da Apple ou do Google, e nada mais | Sim | Não. Nenhum dos dois deixa você tirar de lá as credenciais da sua rede Thread. A Apple só dá a um app o direito de lê-las quando quem faz o app também faz um roteador de borda certificado, e quem faz o ThreadMapper não faz. |
| O mesmo, com o Home Assistant | Sim | Sim. O app Companion do Home Assistant consegue copiar as credenciais para dentro do Home Assistant, e de lá você as copia para a sonda (passo 5). |
| Um OpenThread Border Router seu | Sim | Sim. Leia as credenciais nele (passo 5). |
Se a primeira linha é a sua casa, a sonda não vai desenhar a sua malha. Ela ainda mede o que nenhum celular consegue: o ruído em cada um dos dezesseis canais Thread, a cada cinco minutos, e quais redes Wi-Fi estão por trás dele. Decida com base nisso antes de comprar.
Só para uma placa nova. Apagar leva junto tudo o que foi informado a uma sonda: o Wi-Fi, a chave e a rede Thread dela. Uma sonda que já funciona é atualizada em vez disso (veja Atualização), e, se o instalador fizer essa pergunta sobre uma delas, deixe a caixa desmarcada.
Leva um ou dois minutos e termina com Installation complete! Clique em Next. A janela do próprio instalador está em inglês.
Se a porta não estiver na lista, quase sempre é o cabo. Se não for, segure o botão B da placa enquanto a conecta e tente de novo.
Nenhum desses navegadores? O esptool, da Espressif, faz o mesmo. Uma primeira instalação, que apaga o que quer que a placa tivesse:
esptool.py --chip esp32c6 write_flash 0x0 threadmapper-probe-full.binUma atualização, que deixa com a sonda o que foi informado a ela:
esptool.py --chip esp32c6 write_flash 0x20000 threadmapper-probe.binAs duas imagens são threadmapper-probe-full.bin e threadmapper-probe.bin. Depois, abra a porta serial da placa com qualquer programa de terminal e dê à sonda o Wi-Fi dela digitando (passo 2, Sem a lista).
Depois de uma primeira instalação, com Erase device marcado, o instalador segue sozinho para Configure Wi-Fi. Se, em vez disso, você estiver vendo a lista de opções dele, clique em Connect to Wi-Fi ali.
A sonda lista as redes que ouve.
O instalador diz Trying to connect, o que pode levar quase um minuto, e depois Device connected to the network! A luz da sonda então está acesa e continua acesa. Clique em Continue.
A sonda só guarda uma rede depois de ter entrado nela. Unable to connect quer dizer que ela tentou e não conseguiu entrar: quase sempre é a senha, às vezes um roteador longe demais. A tentativa não mudou nada: uma sonda que já tinha uma rede continua com ela, e volta para ela. Tente de novo.
Sua rede não está na lista? A sonda não tem rádio de 5 GHz, então uma rede que só existe em 5 GHz não aparece ali. Uma rede que esconde o nome também não: escolha Join other… e digite o nome.
O campo de senha esconde o que você digita. O nome e a senha descem pelo cabo até a placa, que os guarda na própria memória e não escreve a senha em nenhum log.
Se o instalador não oferecer Connect to Wi-Fi, é porque ele não ouviu a sonda responder: feche a janela dele, clique de novo no botão de instalação e escolha a porta.
A sonda também pode receber a rede pelo console dela, em Logs & Console ou em qualquer programa de terminal na porta dela. Digite wifi e pressione Enter. As linhas que começam com > são o que você digita:
> 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 precisa de aspas, e letras como ã, ç e é funcionam. A sonda não escreve a senha de volta. Já a página mostra a senha enquanto você digita, e a guarda no log dela até você fechar a janela: a tela é a sua, então olhe por cima do ombro antes.
Ao receber uma rede desse jeito, a sonda reinicia para entrar nela, sem tê-la testado antes. Se a luz voltar a dar uma piscada curta a cada dois segundos, é porque ela tentou dez vezes, não conseguiu entrar e esqueceu a rede.
Espere a luz ficar acesa. No iPhone, abra o ThreadMapper e vá em Ajustes → Sonda do ThreadMapper. Com o celular no mesmo Wi-Fi, a sonda aparece em Nesta rede: escolha-a. Testar conexão diz então o que a sonda é e em que pé ela está.
Se o app não listar a sonda, pergunte a ela onde está: feche a janela do instalador, clique de novo no botão de instalação, escolha a porta, abra Logs & Console e digite status. Uma das linhas é o endereço a digitar no app:
in the app: http://192.168.1.50:8099Um dia o seu roteador pode dar outro endereço à sonda. O app conhece a sonda por mais do que o endereço: aberto, e com o celular no mesmo Wi-Fi, ele encontra a sonda de novo sozinho.
O cabo já fez o trabalho dele. Desconecte a placa e ligue-a a um carregador, em algum ponto no meio da casa, e não atrás do roteador: a sonda ouve o que está perto dela.
Uma sonda sem chave responde a qualquer um no seu Wi-Fi. Isso inclui os nomes das redes Wi-Fi que ela ouve, e pedidos que tiram o rádio dela do canal da sua malha por segundos de cada vez.
Pressione o botão B da placa duas vezes, uma logo depois da outra. (Não o R: esse reinicia a sonda.) A luz pisca duas vezes por segundo, durante três minutos ou até um celular pegar a chave. No app, em Ajustes → Sonda do ThreadMapper, toque em Obter a chave.
Daí em diante, a sonda só faz o que custa tempo de rádio para um celular que tenha a chave. A chave prova quem está perguntando; ela não esconde nada. As respostas continuam trafegando pelo seu Wi-Fi sem criptografia, e a chave também, uma vez, quando um celular a recebe.
Só um celular tem a chave de cada vez. Um segundo celular que a receba tira a chave do primeiro.
Pule este passo se a sua casa for a primeira linha da tabela acima.
A sonda entra em uma rede Thread com o dataset ativo dessa rede (o “conjunto de dados ativo”), uma sequência de uns duzentos dígitos hexadecimais que contém a chave da rede.
sudo ot-ctl dataset active -xConecte a sonda de novo ao computador, clique no botão de instalação acima, escolha a porta dela e abra Logs & Console sem instalar nada. Digite thread dataset, pressione Enter e cole o dataset quando a sonda pedir:
> thread dataset
Dataset, as hex? The probe does not write it back.
> 0e080000000000010000000300001935060004001fffe0...
stored: "MyHome", channel 25. Restarting to join it.Em poucos minutos, Ajustes → Sonda do ThreadMapper, no app, diz que a sonda está na malha Thread dela.
O dataset é a chave da sua rede Thread. A sonda não o escreve de volta, mas a página em que você o cola o mostra, e o guarda no log dela até você fechar a janela. A sonda o guarda na própria memória, que não é criptografada: quem pegar a placa consegue ler o dataset.
| No app | Só com o Wi-Fi | Também com a sua rede Thread |
|---|---|---|
| Scanner de canais: o ruído medido em todos os dezesseis canais Thread | Sim | Sim |
| As redes Wi-Fi por trás do ruído, por nome e canal | Sim | Sim |
| Um dia de leituras de ruído, feitas a cada cinco minutos enquanto o app estava fechado | Sim | Sim |
| Leituras da sonda: cada roteador da malha, os nós que a sonda ouve com o sinal medido, e como a malha roteia entre eles | Não | Sim |
| Na página de um dispositivo: quem o ouve e com que intensidade, e se ele responde | Não | Sim |
| Doutor da Rede, para um dispositivo Thread ligado à tomada que o Apple Home não alcança: se ele responde na malha mesmo assim e, no caso de um dispositivo Matter, se algum roteador de borda ainda tem o registro dele | Não | Sim |
Os nomes das redes Wi-Fi aparecem no celular e não são salvos em lugar nenhum.
| Luz | Significado |
|---|---|
| Uma piscada curta a cada dois segundos | Ainda sem rede Wi-Fi. Passo 2. |
| Piscando devagar | Ela tem uma rede e está entrando nela. |
| Acesa | Ela está no seu Wi-Fi. É assim que deve ficar. |
| Duas piscadas por segundo | Você pressionou o botão duas vezes: ela vai dar a chave a um celular, durante três minutos ou até um deles pegá-la. |
| Piscando rápido | Você pressionou o botão uma vez. Isso abre uma janela de três minutos que esta versão do app não usa. Ela se fecha sozinha e a sonda reinicia, o que recomeça o dia de leituras dela. |
| Tremeluzindo | Você segurou o botão por três segundos. Aos dez, isso apaga tudo o que foi informado à sonda. |
Um firmware novo chega nesta página. Conecte a sonda ao computador, clique no botão de instalação e escolha a porta. O instalador diz qual firmware a sonda está rodando e oferece Update ThreadMapper Probe: clique nele, e depois em Install. Uma atualização não apaga nada: a sonda mantém o Wi-Fi, a chave e a rede Thread dela.
Uma sonda com um firmware anterior ao 0.8.0 não diz ao instalador o que ela é. O instalador então oferece Install ThreadMapper Probe e pergunta se deve apagar o dispositivo: deixe Erase device desmarcado.
Quando a sonda já roda o firmware mais novo, o instalador oferece Erase User Data no lugar. Isso apaga tudo o que foi informado à sonda, assim como segurar o botão dela por dez segundos.
| O que você vê | O que é |
|---|---|
| O botão de instalação diz que o navegador não é compatível | Use o Chrome, o Edge ou o Firefox em um computador. |
| A porta não está na lista | O cabo só transmite energia, ou outro programa está com a porta aberta. |
| O instalador diz Unable to connect | A senha está errada, a sonda está longe demais do roteador, ou a rede só existe em 5 GHz. Nada foi alterado. Tente de novo. |
| O instalador não oferece Connect to Wi-Fi | Ele não ouviu a sonda responder. Feche a janela dele, clique de novo no botão de instalação e escolha a porta. |
| A luz voltou a dar uma piscada curta a cada dois segundos | A sonda não conseguiu entrar em uma rede digitada no console: a senha está errada, ou a rede só existe em 5 GHz. Depois de dez tentativas, a sonda a esqueceu. Dê a rede a ela de novo (passo 2). |
| A luz continua piscando devagar | A sonda já entrou nesta rede antes e não consegue alcançá-la agora: o roteador está desligado ou longe demais, ou a senha da rede mudou. Se mudou, dê a rede a ela de novo (passo 2). |
| A sonda diz que o dataset está cortado, ou com o tamanho errado | Uma colagem longa pode perder um pedaço no caminho. Cole de novo. |
| O app não lista a sonda | O celular está em outro Wi-Fi, ou em uma rede de convidados que mantém os dispositivos separados. Digite o endereço que status mostra. |
| O app diz que a sonda tem uma chave que este iPhone não tem | Outro celular pegou a chave, ou a sonda foi iniciada de novo do zero. Pressione B duas vezes e toque em Obter a chave de novo. |
| O app diz que a sonda está fora da malha Thread dela | Ela tem um dataset e não encontra a rede: o dataset é de outra rede, ou nenhum roteador está ao alcance. |
| Você quer começar de novo | Segure o botão B por dez segundos. |