Manual do SIMUT

Capítulo 1

O SIMUT em uma página

Este capítulo diz o que o SIMUT faz, para quem ele serve e o que ele não é, mostra os três aparelhos lado a lado e ensina a ler o resto do manual. É para todo leitor, antes de qualquer outro capítulo.

O que o SIMUT faz

O SIMUT é um firmware para o Raspberry Pi Pico W que transforma a placa num monitor de temperatura, umidade e pressão. Um aparelho SIMUT:

• lê até 16 sensores dos tipos DS18B20, DHT22, BME280 e BMP280, ligados aos pinos GP0 a GP15 (capítulo 2, capítulo 6);
• grava o histórico no próprio aparelho, um registro por intervalo, a partir de 1 min. Com 11 grandezas e um registro por minuto, cabem cerca de 116 dias (medido em 31/07/2026; capítulo 15);
• mostra as leituras no painel de toque ou no LCD, conforme a imagem, e na interface web, que o próprio aparelho serve (capítulo 11, capítulo 12, capítulo 13);
• dispara alarmes por limite, com som, tela e aviso ao servidor, e aceita janelas de manutenção (capítulo 7);
• envia as medições a um servidor seu por HTTP, HTTPS, MQTT ou MQTTS, e os alarmes por uma segunda linha, separada (capítulo 21, capítulo 22);
• conversa com outros sistemas pelo Home Assistant, pelo Prometheus, pelo syslog e por uma API REST (capítulo 20, capítulo 26);
• controla quem faz o quê, com até 32 contas e 13 permissões, senha na web e PIN no painel (capítulo 8);
• se atualiza pela rede, pela página Arquivos (capítulo 17).

Para quem

O manual fala com quatro leitores:

Um mesmo profissional pode acumular mais de uma dessas funções. O roteiro de leitura no fim deste capítulo indica os capítulos de cada um.

O que o SIMUT não é

• Não é um instrumento metrológico certificado. Antes de usá-lo onde a norma exige instrumento certificado, compare-o com uma referência sua. A calibração por sensor está no capítulo 6.
• Não aciona equipamentos. O aparelho não tem saídas para relés ou atuadores. Um alarme sai como som, como aviso na tela e como mensagem ao seu servidor.
• Não depende de nuvem. A interface web sai do próprio aparelho e funciona numa rede local sem internet. As medições só saem para um servidor que você configurar: de fábrica, a telemetria e a linha de alarmes estão desligadas. O que o aparelho procura na rede de fábrica é a hora certa, por NTP (capítulo 10).

Os três aparelhos

O mesmo código gera três imagens de firmware publicadas, uma para cada montagem de hardware:

• release: o monitor com painel de toque colorido de 320×240;
• alpha: o monitor com LCD de 16×2 caracteres e console pelo Bluetooth;
• Air (SIMUT Air): o registrador a bateria, sem tela, que hiberna entre as leituras. É experimental.

Os 16 slots de sensor, os quatro tipos de sensor, o histórico, os alarmes, as contas e as permissões são iguais nas três imagens. As diferenças de cada recurso estão no capítulo dele: o ponto de acesso no capítulo 9, o console no capítulo 14, o PIN no capítulo 8, o Air no capítulo 19.

As imagens de bancada

O código gera também três imagens para testes automáticos: pico_w_test, pico_w_test_https e pico_w_asserts. Elas não são publicadas e não servem para uso: as duas primeiras trazem o console completo e comandos de teste, e a terceira existe para detectar erros de concorrência. Use sempre uma das três imagens publicadas.

Como ele funciona por dentro

O RP2040, o processador do Pico W, tem dois núcleos:

• o Core 0 faz quase tudo: lê os sensores, avalia os alarmes, grava o histórico, cuida da rede, atende a interface web e o console e envia a telemetria;
• o Core 1 cuida só da tela. Na release, ele desenha o painel e lê o toque; na alpha, ele escreve no LCD; no Air, que não tem tela, ele não é usado.

A memória flash do Pico W tem 2 MB, divididos em duas metades:

O que fica só na memória RAM se perde num reinício ou numa falta de energia:

• o bloco aberto do histórico, com os registros ainda não selados. O aparelho grava uma cópia dele depois de cada registro e a recupera no boot, então uma falta de energia perde no máximo o último registro (capítulo 15);
• a fila da linha de alarmes (capítulo 22);
• a senha inicial do administrador, que o aparelho mostra uma única vez (capítulo 4).

O mapa completo do sistema de arquivos está no capítulo 17.

Versões

Este manual descreve a v2.11.1, de 12/10/2026, a versão publicada mais recente. A linha 2.7 saiu do beta com a v2.7.0.

O que a v2.11.1 mudou para quem usa o aparelho:

• a troca obrigatória de PIN não pode mais ser pulada: SAIR volta à tela inicial, e o menu só abre depois da troca (capítulo 8);
• no painel, uma conta com a permissão Usuários só concede as permissões de painel que ela mesma tem (capítulo 8);
• uma política de PIN mais exigente não tranca mais do painel quem tem um PIN mais curto: a conta se identifica com o PIN antigo e vai para a troca, e a mensagem de PIN curto diz o mínimo da política (capítulo 8);
• Adotar a sonda ligada aqui lê o GPIO do próprio slot, e a leitura segue com a sonda nova na hora (capítulo 6);
• o AP aberto pelo gesto no boot segue o prazo de 15 min num aparelho com rede configurada (capítulo 9);
• a página Arquivos explica a recusa v=6, a de uma imagem de outro chip (capítulo 17).

A v2.11.0, de 04/10/2026, tinha trazido:

• o Pico 2 W (RP2350) passa a ter imagens publicadas: o .uf2 de fábrica, que traz a tabela de partições, e o .bin de atualização (capítulo 3);
• no Pico 2 W, a atualização pela rede vai para o outro slot, sem tocar no sistema de arquivos, e sobe em teste. Se não se confirmar em cinco minutos, ou se o aparelho reiniciar antes, ele volta sozinho para a versão anterior, e o painel e a página Arquivos dizem isso (capítulo 26);
• uma transferência longa, como uma atualização, um backup ou uma restauração, não cai mais quando outra página do aparelho está aberta no navegador (capítulo 18);
• na alpha, gravar a configuração não reinicia mais o aparelho pelo watchdog.

Um aparelho com a v2.11.0 não tem os itens da v2.11.1, e o que as versões anteriores trouxeram está no apêndice Histórico de versões. Onde este manual diz “na v2.7.1” ou “pelo código da v2.7.1”, o texto vale também para as versões seguintes, salvo nas mudanças que o apêndice registra da v2.7.2 em diante. Como conferir a versão do seu aparelho está no capítulo 17.

Como ler este manual

Selos de imagem

Uma seção que vale só para algumas imagens começa com selos:

Uma seção sem selo vale para as três imagens.

Selos de permissão

Uma ação que exige permissão mostra o nome técnico da permissão num selo, como PERM_NET_CONFIG, e o nome que a página Usuários usa no texto, como Rede. As 13 permissões estão no capítulo 8.

Faixas

Figuras

As figuras mostram telas do painel, fotos do LCD, páginas da interface web, fotos do hardware e diagramas. Onde uma figura ainda não foi capturada, o manual mostra uma caixa com a descrição do que ela vai mostrar e em que estado.

Textos da interface

Os rótulos aparecem em negrito, como o aparelho os mostra com o pacote de idioma pt-BR. Na primeira vez, o rótulo em inglês vem entre parênteses e em itálico, como Buscar redes (Scan): é o texto de um aparelho sem pacote de idioma. Comandos, campos e respostas do aparelho aparecem em fonte fixa, exatamente como o aparelho os escreve.

Os exemplos usam nomes de documentação: simut como nome do aparelho, MinhaRede como rede Wi-Fi, 192.0.2.10 como endereço e coletor.exemplo.com.br como servidor. Troque pelos seus.

Roteiro de leitura

Os limites do aparelho estão no capítulo 28, os problemas comuns no capítulo 30 e os termos no capítulo 31.

Voltar ao sumário

Capítulo 2

Hardware e ligações

Este capítulo descreve o Pico W e a alimentação, o mapa completo de pinos de cada imagem, os pinos que servem para sensores, a ligação de cada tipo de sensor e a placa de circuito do projeto. É para quem monta o aparelho. A configuração dos sensores depois de ligados está no capítulo 6.

O Pico W e a alimentação

O SIMUT roda num Raspberry Pi Pico W: o processador RP2040, 2 MB de memória flash e o chip de rádio CYW43, que faz o Wi-Fi e o Bluetooth. O firmware é compilado para o Pico W e depende do rádio dele: o Pico sem W não serve.

A alimentação vem pelo conector USB do Pico W, em 5 V. Dentro do aparelho:

Regras de montagem:

• Terra comum. Ligue o GND do Pico W, da tela e de todos os sensores entre si.
• Sensores e TFT no 3V3. Os sensores, os resistores de pull-up e o TFT vão no 3V3, o pino 36.
• LCD no 5 V. O LCD 16×2 da alpha vai no 5 V (VBUS, pino 40), não no 3V3.
• Cabo USB de qualidade. O guia de ligações do projeto pede cabo de pelo menos 22 AWG: queda de tensão no cabo causa reinícios.

Os GPIOs 23, 24, 25 e 29 não saem na borda da placa: o Pico W os usa internamente para falar com o chip de rádio.

O mapa de pinos

Cada imagem usa os pinos de GP16 em diante para a tela, o toque, a cigarra e, no Air, para o controle de energia. Os pinos de GP0 a GP15 ficam para os sensores nas três imagens.

“Sem uso” quer dizer que o firmware não usa o pino. Ele também não serve para sensor: um slot só aceita GP0 a GP15 (Onde ligar os sensores).

A numeração física segue a do Pico W: o pino 1 é o GP0, no canto do conector USB, e os pinos seguem em U até o 40, o VBUS, do outro lado do mesmo canto.

A release: TFT e toque

release O painel é um TFT de 320×240 com controlador ILI9341 e toque resistivo com controlador XPT2046, no mesmo barramento SPI0. Os dois compartilham MISO, MOSI e SCK e têm cada um o seu CS.

O firmware não controla a luz de fundo: com o pino LED no 3V3, ela fica sempre acesa.

A alpha: LCD 16×2

alpha A alpha usa um LCD de 16×2 caracteres com controlador HD44780, ligado em modo paralelo de 4 bits.

O aparelho só escreve no LCD, por isso o R/W vai direto ao GND. Com o contraste errado, o LCD parece apagado ou mostra blocos cheios: ajuste o potenciômetro com o aparelho ligado.

A cigarra

release alpha A cigarra fica entre o GP22 (pino 29) e o GND. Use uma cigarra passiva, que toca a frequência que recebe: o aparelho gera cada nota pelo PIO do RP2040. O Air não tem cigarra. Os sons estão no capítulo 7.

O Air: energia dos sensores e carregador

air O Air usa dois pinos além dos sensores. O do carregador se troca ou se desliga pelo console, com o comando air charger (capítulo 19); o de energia não tem comando e fica no GP16. Os pinos de fábrica:

O GP16 serve para dois fins, e você pode usar um, os dois ou nenhum:

• Cortar a energia dos sensores durante o sono. Ligue o GP16 à entrada de controle de uma chave do lado positivo, como um MOSFET de canal P com o circuito de acionamento adequado ou o pino de habilitação de um regulador de 3,3 V, e alimente os sensores pela saída dessa chave. Nunca alimente os sensores direto do GP16: um GPIO fornece pouca corrente e o DHT22 consome mais que isso durante a medição.
• Medir o ciclo. O nível do GP16 mostra, num analisador lógico, quando o aparelho está acordado.

O GP17 espera um divisor resistivo a partir dos 5 V do carregador, que o leve a nível alto (3,3 V) enquanto o carregador está ligado. Com o carregador, o Air fica acordado e alcançável; sem ele, volta a hibernar no fim do tempo de ociosidade (capítulo 19).

Onde ligar os sensores

Nas três imagens, os sensores vão nos pinos GP0 a GP15, que são os 16 slots. A página Configurações e o console recusam qualquer pino de GP16 em diante. Um pino atende um só slot ativo: dois slots ativos no mesmo GPIO são recusados.

Os tipos podem se misturar: 10 DS18B20 e 2 BME280 ocupam 14 GPIOs e deixam 2 livres.

Cuidados por imagem:

• release Durante o boot, o GP8 e o GP9 transmitem e recebem o diagnóstico de boot pela UART1, a 115200 baud, até o sensor configurado neles assumir o pino. Com um adaptador USB-serial de 3,3 V no GP8 (pino 11), você lê em que etapa um boot parou.
• A busca de sondas mexe no GP16. O botão Procurar sondas testa os pinos de GP0 a GP16 (capítulo 6). O GP16 é o MISO do TFT na release, o RS do LCD na alpha e, no Air, a saída que liga a energia dos sensores. A busca não devolve esses pinos ao estado de antes: reinicie o aparelho depois de uma busca.
• A placa do projeto só leva GP0 a GP10 aos conectores de sensor (A placa do projeto).

Os sensores

O aparelho liga o pull-up interno do RP2040 em todo pino de sensor. Ele é fraco demais para substituir os resistores externos da tabela. O que acontece com uma leitura fora da faixa está no capítulo 6.

DS18B20

O DS18B20 é um sensor de temperatura de 1 fio (1-Wire), em geral numa sonda à prova d’água com três fios.

Ponha um resistor de 4,7 kΩ entre o DQ e o 3V3.

Ligue uma sonda por GPIO. O aparelho identifica a sonda pelo número de série gravado nela (a ROM) e lê esse número com um comando que só funciona com uma sonda no fio. Com a ROM gravada no slot, o aparelho percebe a troca de sonda (capítulo 6).

DHT22

O DHT22 mede temperatura e umidade por um único fio de dados.

Ligue um DHT22 por GPIO. O aparelho lê cada DHT22 a cada 2 s, o intervalo mínimo do sensor.

BME280 e BMP280

O BME280 e o BMP280 são sensores I²C: usam dois GPIOs, SDA e SCL. Por fora os módulos são iguais; o BMP280 não mede umidade.

• O endereço. Com um sensor por par, qualquer um dos dois endereços funciona: o aparelho procura em 0x76 e, sem resposta, em 0x77.
• O tipo. Se você escolheu BME280 e o chip é um BMP280, ou o contrário, o aparelho corrige o tipo pelo identificador do chip e grava a correção (capítulo 6).
• A busca de sondas só encontra um BME280 ou BMP280 em GP4 (SDA) e GP5 (SCL). Em outros pinos, configure o slot à mão.

As regras do I²C

O RP2040 tem dois periféricos I²C. Cada um só aceita SDA e SCL em certos pinos:

Com o SDA num pino de SDA e o SCL num pino de SCL do mesmo periférico, o aparelho usa o periférico I²C. Qualquer outro par é lido pelo PIO do RP2040, mais devagar: o SDA num periférico e o SCL no outro (SDA em GP8 e SCL em GP11), o SDA e o SCL trocados (SDA em GP5 e SCL em GP4) e dois pinos do mesmo papel (SDA em GP0 e SCL em GP4). O log de eventos registra o aviso BME in bit-bang (no free hardware I2C).

Para ligar vários BME280 ou BMP280:

1. Um sensor por par. A leitura do aparelho aceita dois sensores no mesmo par, em 0x76 e 0x77, mas a página Configurações e o console recusam dois slots ativos no mesmo GPIO. Dê a cada sensor o seu par.
2. O periférico fica com o primeiro par. O aparelho prende cada periférico aos pinos do primeiro sensor que o usa, pela ordem dos slots. Um segundo sensor em outro par do mesmo periférico é lido pelo PIO, como os pares cruzados, e o aviso do log traz ctx igual a 100 mais o GPIO do SDA.

A placa do projeto

O projeto publica uma placa de circuito para a release e a alpha, desenhada no KiCad. Os arquivos de projeto e de fabricação (Gerber e furação) estão na pasta PCB_test/ do repositório.

Use a revisão v1.1, que é a da pasta PCB_test/. As duas revisões estão publicadas como releases do repositório, cada uma com o arquivo simut_pcb_fabrication.zip; a v1.0 fica só como registro do defeito.

O que a placa v1.1 tem:

• Soquete do Pico W.
• Entrada de rede elétrica, marcada 90-240Vac, com um conversor HLK-PM01 que fornece os 5 V. Os 5 V chegam ao pino VBUS do Pico W e ao LCD.
• Conector TFT-Touch, de 14 pinos, na ordem da tabela da release. O VCC e o LED do módulo vêm do 3V3 do Pico W.
• Conector Alphanumeric, de 12 pinos, na ordem VSS, VDD, VO, RS, RW, E, D4, D5, D6, D7, A e K, com um trimpot de contraste na placa.
• Cigarra na placa, acionada pelo GP22 por meio de um transistor.
• Coluna de sensores S0 a S10, ligada a GP0 a GP10, com redes de resistores de pull-up para o 3V3. Os pinos GP11 a GP15 não chegam a nenhum conector: nesta placa, o aparelho tem 11 posições de sensor.
• Quatro furos de fixação para parafusos M2.5.

Os arquivos da placa e do esquema não definem o valor de nenhum resistor. Para as redes de pull-up dos sensores, use 4,7 kΩ, o valor da tabela dos sensores.

Lista de conferência da montagem

Antes de ligar o aparelho pela primeira vez:

1. O GND do Pico W, da tela e de todos os sensores está ligado entre si.
2. Os sensores e os pull-ups vão no 3V3 (pino 36), não no 5 V.
3. alpha O LCD vai no 5 V (pino 40), com o R/W no GND e o potenciômetro de contraste no VO.
4. Cada DS18B20 tem o resistor de 4,7 kΩ do dado ao 3V3, e há uma sonda por GPIO.
5. Cada BME280 ou BMP280 tem o seu par, com SDA e SCL nos papéis da tabela do I²C.
6. Nenhum sensor está em GP16 ou acima.
7. release O TFT e o toque compartilham MISO, MOSI e SCK, com CS separados: GP28 para o TFT e GP17 para o toque.
8. Anote qual sensor está em qual GPIO: a configuração dos slots pede essa informação (capítulo 6).

Voltar ao sumário

Capítulo 3

Instalar o firmware

Este capítulo mostra quais arquivos cada versão publica, como escolher a imagem certa, como gravá-la pelo cabo USB, como pôr o pacote de idioma no aparelho, como montar uma imagem sob medida e como compilar o firmware a partir do código-fonte. É para quem instala um aparelho novo ou atualiza um aparelho antigo pelo USB. A atualização pela rede, de um aparelho já em uso, está no capítulo 17.

Os arquivos de cada versão

Cada versão publicada, na página de versões do projeto no GitHub (github.com/angeloINTJ/simut/releases), traz doze arquivos:

As imagens do Pico 2 W (RP2350), com releasetwo no nome, são publicadas desde a v2.11.0.

Desde a v2.9.0, cada arquivo publicado também tem um atestado de procedência, que liga o arquivo à execução do CI que o gerou e ao commit de onde veio; quem tem o gh confere um download com gh attestation verify <arquivo> --repo angeloINTJ/simut. Os .bin e os .uf2 vêm assinados: a assinatura são os 241 bytes do fim do arquivo (capítulo 17).

O .uf2 e o .bin de uma mesma imagem têm o mesmo firmware: o .uf2 é o .bin embrulhado no formato que o Pico W aceita pelo USB. No Pico 2 W os dois arquivos diferem, embora o programa seja o mesmo. O .uf2 traz também a tabela de partições, que um Pico 2 W virgem não tem. O .bin traz a marca que faz a imagem nova subir em teste: se ela não se confirmar em cinco minutos, o aparelho volta sozinho para a imagem anterior. Não troque um pelo outro: a página Arquivos recusa o .uf2 (capítulo 17), e a unidade do BOOTSEL ignora o .bin.

Os pacotes de idioma não vão dentro do firmware. Eles ficam no sistema de arquivos do aparelho e entram por outro caminho (O pacote de idioma). Os 11 temas do painel (arquivos .thm) não vêm na página da versão: estão na pasta data/themes do código-fonte, e são opcionais (capítulo 11).

Escolher a imagem

A imagem depende do hardware montado (capítulo 2):

Na dúvida sobre um aparelho já instalado, o tipo de imagem aparece na interface de programação: no campo sys.env de /api/status e no campo env de /api/perms (capítulo 26).

O aparelho confere o tipo de imagem de dois jeitos diferentes:

• Pela página Arquivos, ele recusa uma imagem de outro tipo antes de aplicá-la (capítulo 17).
• Pelo USB, ele aceita qualquer imagem. A conferência é sua: leia o nome do arquivo antes de copiar.

Uma imagem gravada no hardware errado não encontra a tela dela: o painel ou o LCD fica apagado. Grave de novo, pelo USB, a imagem certa.

Gravar pelo USB com o BOOTSEL

Este é o caminho para um Pico W novo e o caminho que sempre funciona, porque não depende do firmware que está na placa. Você precisa do cabo USB e do arquivo .uf2 da sua imagem.

1. Desligue o cabo USB do Pico W.
2. Aperte e segure o botão BOOTSEL, o único botão da placa.
3. Ligue o cabo USB ao computador, ainda segurando o botão.
4. Solte o botão. O computador mostra uma unidade de disco chamada RPI-RP2.
5. Copie o arquivo .uf2 para a unidade RPI-RP2.
6. Espere. A unidade some sozinha, e o Pico W reinicia já com o SIMUT.

A gravação pelo USB só escreve a área do programa. O sistema de arquivos fica como estava:

• num Pico W novo, o sistema de arquivos está vazio. No primeiro boot, o aparelho o formata, cria as pastas e começa com a configuração de fábrica (capítulo 4);
• num aparelho em uso, a configuração, as contas, o histórico, a calibração e os pacotes de idioma continuam lá. O firmware novo converte a configuração antiga no boot, dentro dos limites de Atualizar um aparelho antigo.

Com o picotool

O picotool é a ferramenta de linha de comando do Raspberry Pi para o RP2040. Com o Pico W no modo BOOTSEL (passos 1 a 4 acima):

picotool info
picotool load -x simut_v2.11.1_release.uf2

O picotool info confirma que a placa está no modo BOOTSEL. O load -x grava e reinicia a placa no fim.

Sem apertar o botão: o toque de 1200 baud

Um aparelho com o firmware funcionando entra no modo BOOTSEL sozinho quando o computador abre a porta serial USB dele a 1200 baud e a fecha. O pio run -t upload faz isso automaticamente antes de gravar (Compilar a partir do código-fonte). O toque só funciona enquanto o USB do firmware responde; num aparelho travado, use o botão.

air O Air desliga o USB enquanto dorme, e a porta serial some do computador. Grave o Air com ele acordado, em M0 (capítulo 19), ou pelo botão BOOTSEL.

O pacote de idioma

Sem pacote de idioma, o painel e a interface web aparecem em inglês. O console serial responde em português de fábrica, com ou sem pacote (capítulo 14).

O caminho recomendado é enviar o pacote pela interface web, depois que o aparelho estiver na rede (capítulo 4):

1. Entre na interface web com uma conta que tenha as permissões Leitura PERM_FILE_READ e Upload PERM_FILE_UPLOAD. O admin tem as duas.
2. Abra a página Arquivos e a pasta /lang.
3. Toque em Enviar e escolha language_pt-BR.lng, o da mesma versão do firmware.
4. Confira se o arquivo aparece na pasta com o tamanho certo.
5. Reinicie o aparelho. O pacote só é lido no boot.

Detalhes da página Arquivos estão no capítulo 17, e o comportamento do idioma na web, no capítulo 13.

O uploadfs, só num aparelho novo

Quem compila da fonte pode gravar o sistema de arquivos inteiro com a pasta data/ do código-fonte:

pio run -e pico_w_release -t uploadfs

A pasta data/ leva os dois pacotes de idioma e os 11 temas. Depois de um uploadfs, apague language_es-ES.lng da pasta /lang pela página Arquivos, se você quer o aparelho em português, e reinicie.

Uma imagem sob medida

O configurador de build monta uma imagem com outro conjunto de recursos, pelo navegador. Ele tem português e inglês, tema claro e escuro, e pode ser instalado como aplicativo.

1. Em Produto, escolha SIMUT (a imagem release), SIMUT Alpha, SIMUT Air ou SIMUT para o Pico 2 W.
2. Em Recursos, ligue ou desligue o que a imagem leva. Cada recurso mostra quanto a imagem daquele produto cresce ou encolhe, medido compilando. Uma combinação que o firmware não compila aparece Bloqueada, com o motivo.
3. Em Resultado, a página soma as mudanças e diz se a imagem Cabe, está No limite ou Não cabe, no espaço do programa e no teto da atualização pela rede. No Pico 2 W os dois tetos são o slot de 1.568.768 B.
4. Toque em Compilar esta build. A integração contínua do projeto compila a imagem e entrega o .uf2, para o USB, e o .bin, para a página Arquivos (capítulo 17). No Pico 2 W são as duas imagens que a release publica para ele: o .uf2 de fábrica, com a tabela de partições, e o .bin, uma atualização que vai para o outro slot e roda em teste.

Compilar esta build exige um token do GitHub com acesso de escrita ao repositório. Sem ele, Pedir esta build abre um pedido no GitHub com a configuração preenchida.

• A soma é uma estimativa. Contra oito builds reais de mudanças combinadas, ela errou por até 4.392 B de flash e 8.192 B de .bin. Por isso a página diz No limite perto de um teto; a build dá o número exato.
• A imagem sai da main e informa a versão da main, que pode estar à frente da última versão publicada. Sem mudanças, a página aponta a última versão publicada, porque compilar gera a main de hoje.
• A imagem continua do mesmo tipo. O configurador não troca a tela de um produto, então a página Arquivos aceita o .bin num aparelho do mesmo produto (capítulo 17).

Compilar a partir do código-fonte

A maioria das instalações usa as imagens publicadas. Compile só para mudar uma opção de compilação, como a frequência do TFT (capítulo 2).

Você precisa de Python 3 e do PlatformIO. Os passos abaixo repetem os da integração contínua do projeto:

git clone https://github.com/angeloINTJ/simut.git
cd simut
pip install platformio zopfli
pio pkg install -e pico_w_release
bash tools/arduino_pico_overrides/patch.sh
pio run -e pico_w_release

• O patch.sh aplica as correções que o projeto faz no framework arduino-pico. Sem ele, a compilação falha. Rode-o de novo sempre que o framework for reinstalado.
• O zopfli comprime as páginas web. Sem ele, a compilação usa o gzip e a imagem sai alguns kB maior.
• O ambiente escolhe a imagem: pico_w_release, pico_w_alpha ou pico_w_air. O pio run sem -e compila só a pico_w_release.

A imagem sai em .pio/build/pico_w_release/, como firmware.uf2 e firmware.bin. Para gravar direto, com o Pico W ligado ao USB:

pio run -e pico_w_release -t upload

O PlatformIO usa o toque de 1200 baud e o picotool para gravar; o botão BOOTSEL também funciona.

Uma opção de compilação muda com -D e vale sobre o padrão do arquivo src/simut_config.h. Por exemplo, para escrever no TFT a 33,25 MHz em vez de 66,5 MHz:

PLATFORMIO_BUILD_FLAGS="-DSIMUT_TFT_SPI_HZ=33250000u" pio run -e pico_w_release

Atualizar um aparelho antigo

As versões anteriores à 1.6.2-beta tinham um defeito na atualização pela rede: diziam que tinham aplicado a imagem sem aplicá-la. Por isso, a primeira atualização de um aparelho desses é pelo USB.

Um aparelho na versão 1.x perde duas coisas no primeiro boot da 2.11.1:

• A configuração. O firmware não lê configurações das versões 1.x. O aparelho começa com a configuração de fábrica e uma senha nova para o admin, mostrada no console USB (capítulo 4). Anote a rede, as contas e os sensores antes de atualizar.
• O histórico no formato antigo. Os arquivos .sim4 da pasta /history são apagados no primeiro boot. Baixe-os antes de atualizar e converta-os no computador, com a ferramenta tools/history_v5.py do código-fonte:

python3 tools/history_v5.py --convert-v4 AAAAMMDD.sim4 AAAAMMDD.h5

Um aparelho na versão 2.x mantém a configuração: o firmware novo a converte no boot.

Depois de gravar

O primeiro boot de um aparelho novo mostra a senha do administrador uma única vez, no console USB. Deixe o console aberto antes de o aparelho reiniciar (capítulo 4). Para conferir a versão gravada, veja o capítulo 17.

Voltar ao sumário

Capítulo 4

Primeiro boot e primeira configuração

Este capítulo leva um aparelho recém-gravado do primeiro boot até o uso: a senha inicial, a entrada na rede, a primeira entrada na web, o idioma, a hora, o primeiro sensor e o PIN do painel. É para quem instala. Cada passo é curto e aponta para o capítulo que traz os detalhes.

O caminho em resumo

1. Abra o console USB e ligue o aparelho: anote a senha do administrador (A senha inicial). release No fim do boot, o painel pergunta a data e a hora (O que o boot mostra).
2. Ponha o aparelho na rede: abra o ponto de acesso de configuração com o comando ap ou pelo menu do painel, ou grave a rede pelo console (Pôr o aparelho na rede).
3. Entre na interface web e troque a senha (A primeira entrada na web).
4. Instale o pacote de idioma e confira o fuso e a hora (Idioma, fuso e hora).
5. Configure o primeiro sensor (O primeiro sensor).
6. release Troque o PIN de fábrica do painel (O PIN do painel).
7. Confira a lista final (Pronto para usar).

Antes de ligar

Tenha à mão:

• o aparelho com o firmware gravado (capítulo 3) e a montagem conferida (capítulo 2);
• um computador com um programa de comunicação serial, como o picocom ou o PuTTY, e o cabo USB. O console usa 115200 baud, 8N1 (capítulo 14);
• release alpha um celular ou computador com Wi-Fi, para entrar no ponto de acesso de configuração;
• o nome e a senha da rede Wi-Fi do local. O aparelho só usa redes de 2,4 GHz, e o nome e a senha têm até 31 caracteres (capítulo 9).

O que o boot mostra

Um aparelho novo não tem rede configurada, e nenhuma imagem abre o ponto de acesso de configuração sozinha: ele abre quando você pede (Pôr o aparelho na rede). Sem rede também não há NTP, e o relógio em uso é o provisório, que parte de uma data gravada no firmware (capítulo 10). Por isso, no fim do boot, um aparelho sem rede configurada pede a data e a hora: a release, no painel; todas as imagens, numa linha do console USB:

Sem rede, relogio provisorio: conf time AAAA-MM-DD HH:MM:SS

O comando que a linha cita funciona no console de todas as imagens, pelo USB ou pelo Bluetooth (capítulo 10). Sem rede configurada, o boot não espera a rede: segue na hora, e a pergunta aparece logo no fim dele. O aparelho mede e grava o histórico com ou sem rede.

No painel

release Depois de ligar, o painel leva alguns segundos para mostrar as etapas do boot: cerca de 7,5 s, medidos em bancada em 22/09/2026, durante o desenvolvimento da v2.7.1. Em seguida aparecem SIMUT, a versão e a caixa com as etapas (capítulo 11). Sem rede configurada, a caixa não espera o roteador: mostra Conexão Ignorada pelo Usuário. e segue.

No fim do boot, num aparelho sem rede configurada, o painel abre a tela Data e hora em vez da tela inicial:

• cinco colunas, dd / mm / aaaa hh : mm, que começam na data e na hora do relógio provisório;
• acima de cada valor, uma seta que soma 1; abaixo, uma seta que subtrai 1. Segurada, a seta repete a cada 300 ms;
• a linha Sem Wi-Fi, os dados levam esta hora., em âmbar;
• os botões PULAR e SALVAR.

Ajuste a data e a hora do local e toque em SALVAR: o relógio passa a valer na hora, e o painel vai à tela inicial. PULAR vai à tela inicial sem mudar o relógio. Sem nenhum toque por 30 s, o painel faz o mesmo que PULAR: um aparelho que volta de uma falta de energia sem ninguém por perto mostra as leituras, não uma pergunta.

A pergunta não pede conta nem PIN, e volta a cada boot enquanto o aparelho não tiver rede: o acerto à mão não sobrevive a um reinício. Enquanto o relógio for o provisório, a barra de cima da tela inicial mostra a data e a hora em âmbar, com ? no lugar do -. Tudo isso está no capítulo 10.

No LCD

alpha O LCD mostra SIMUT 2.11.1 e Inicializando e, depois, uma barra de progresso (capítulo 12).

Num aparelho novo, o boot não espera a rede: no fim dele, o LCD mostra Sem WiFi e Offline por 3 s e passa às leituras (capítulo 12):

 Sem WiFi
    Offline

O LCD não mostra a data e a hora, e a pergunta sai só no console. No alpha, o console é o jeito de respondê-la: digite o comando que a linha cita, com a data e a hora locais, pelo console USB ou pelo Bluetooth:

SIMUT> conf time 2026-10-01 14:30:00
OK: Hora aplicada (imediato, nao persiste em reboot)

A interface web também acerta o relógio, por um ponto de acesso aberto com ap (capítulo 10).

No Air

air O Air não tem tela. Ao ligar, ele fica acordado (M0), com o console completo pelo USB e pelo Bluetooth e com a interface web. Como as outras imagens, ele não abre o ponto de acesso sozinho. Sem rede configurada, ele escreve no console a mesma linha do relógio provisório, e o comando time acerta o relógio (capítulo 10). Sem nenhuma atividade no console ou na web por 5 min, ele começa a hibernar (capítulo 19).

A senha inicial do administrador

Na primeira partida, o aparelho cria a conta admin com uma senha aleatória de 8 caracteres, feita de letras maiúsculas e algarismos, sem O, 0, I e 1. Ele mostra a senha uma única vez, no console USB:

==============================================
 SEC-003: FACTORY DEFAULTS ATIVADO
 Senha ADMIN inicial: R8TNC3VH
 Trocar no primeiro login (forcado).
==============================================

A senha do exemplo é ilustrativa. A moldura sai sempre em português, no meio das linhas de diagnóstico do boot, que começam com [DBG].

• Nenhuma tela mostra a senha. O painel, o LCD e a interface web não a exibem. Só o console USB.
• Ela não volta a aparecer. O aparelho não guarda a senha em texto: depois do primeiro reinício, a moldura não sai mais, e a senha continua valendo.
• Abra o programa serial cedo. O aparelho espera 1 s pelo USB antes de escrever no console. Abra a porta assim que ela aparecer no computador.

Se você não viu a senha, gere outra pelo cabo USB (capítulo 14):

SIMUT> system admin reset confirm
Senha admin resetada. Nova senha (unica vez):
 K4XW7PQA
Trocar no 1o login via web (forcado).

air No Air, entre antes no modo privilegiado com enable. O comando não funciona pelo Bluetooth.

A conta viewer, a outra conta de fábrica, não tem senha conhecida. Gere uma senha para ela ou exclua a conta (capítulo 8).

Pôr o aparelho na rede

Pelo ponto de acesso de configuração

release alpha O ponto de acesso é a rede Wi-Fi que o aparelho cria para você configurá-lo. Ele só abre quando você pede. Os detalhes estão no capítulo 9.

1. Abra o ponto de acesso. No console USB, que você já abriu para a senha, digite ap. A resposta traz a chave, e o console mostra também o nome da rede:

   SIMUT> ap
   
   [AP] SSID: simut_SETUP
   [AP] PSK : M7TQ4XH2RP   (WPA2)
   [AP] URL : http://192.168.4.1
   OK: Modo AP iniciado (WPA2). Senha: M7TQ4XH2RP
   Conecte-se ao AP e acesse http://192.168.4.1

   Na release, o item 8 do menu do painel, Modo de Configuração, faz o mesmo, com uma conta que tenha a permissão Rede no painel, e o painel passa a mostrar a rede e a chave (capítulo 11). Na alpha, o ap funciona também pelo Bluetooth, e o LCD alterna o endereço, a rede e a chave (capítulo 12).

2. No celular ou no computador, conecte-se à rede simut_SETUP com a chave.

3. Abra http://192.168.4.1. A página de entrada aparece.

4. Entre como admin, com a senha inicial.

5. Defina a senha nova na página Bem-vindo! (capítulo 13).

6. Abra a página Rede, toque em Buscar, escolha a sua rede e digite a senha dela (capítulo 9).

7. Toque em Salvar e reiniciar na barra de topo.

8. Volte o celular ou o computador para a sua rede.

O aparelho reinicia e entra na rede. Se a senha da rede estiver errada, o aparelho fica tentando a rede pela escada de reconexão, e o ponto de acesso não volta sozinho: abra-o de novo e refaça a configuração (capítulo 9). Sem rede configurada, o ponto de acesso fica aberto até você gravar uma rede ou reiniciar o aparelho.

A chave do ponto de acesso é sempre a mesma para aquele aparelho, mesmo depois de um reset de fábrica. Anote-a: ela serve toda vez que o aparelho precisar do ponto de acesso.

Com o ponto de acesso aberto, o painel da release passa ao terminal da tela de boot e mostra o nome real da rede, simut_SETUP de fábrica, PSK seguido da chave, Acesse no celular: 192.168.4.1 e AP Ativo! Reinicie a placa para sair. O LCD do alpha alterna três páginas, com o endereço, a rede e a chave. O aparelho continua medindo com o ponto de acesso aberto (capítulo 9).

Pelo console

Sem celular à mão, grave a rede pelo console USB.

release alpha No console de emergência:

SIMUT> system ssid MinhaRede
OK: SSID salvo. Use 'reload confirm' para reconectar.
SIMUT> system pass senha-da-rede
OK: Senha salva. Use 'reload confirm' para reconectar.
SIMUT> reload confirm

air No console completo do Air:

SIMUT> enable
SIMUT# configure terminal
SIMUT(config)# system ssid MinhaRede
SIMUT(config)# system pass senha-da-rede
SIMUT(config)# end
SIMUT# reload confirm

air O Air mede e grava o histórico mesmo sem rede. A rede serve para a telemetria e para a hora certa (capítulo 19).

Encontrar o endereço do aparelho

Na sua rede, o aparelho recebe um endereço IP do roteador. Para descobri-lo:

Com o NTP ligado e sem servidor de hora alcançável, o nome .local não responde (Idioma, fuso e hora).

A primeira entrada na web

1. No navegador, abra o endereço do aparelho, como http://192.0.2.10.
2. Entre como admin.
3. Se você ainda não trocou a senha inicial, a página Bem-vindo! pede a senha nova: pelo menos 8 caracteres, com letra, algarismo e símbolo (capítulo 13).

Sem pacote de idioma, a interface aparece em inglês. O resto da interface está no capítulo 13.

Idioma, fuso e hora

1. Idioma. Envie language_pt-BR.lng para a pasta /lang, pela página Arquivos, e reinicie o aparelho (capítulo 3). O idioma de fábrica do aparelho é o português: depois do reinício com o pacote na pasta, o painel e a interface web ficam em português. O console já responde em português. release O idioma do painel muda em Configurações > Idioma (capítulo 11); o da web, no seletor de cada navegador (capítulo 13).
2. Fuso. O de fábrica é −3, o de Brasília. Para outro, mude o Fuso Horário na página Configurações, seção Identidade, e toque em Salvar e reiniciar (capítulo 10).
3. Hora. O NTP vem ligado e acerta o relógio pela internet. Numa rede sem acesso à internet, aponte o aparelho para um servidor de hora da própria rede ou acerte o relógio à mão: sem o primeiro acerto, o aparelho não termina de entrar na rede, e a telemetria espera (capítulo 10). Num aparelho que vai funcionar sem Wi-Fi, acerte a hora à mão depois de cada boot: em qualquer imagem, com o comando time no console; na release, também pela pergunta do boot ou pelo item 13 do menu, Data e hora (capítulo 10).

O primeiro sensor

1. Abra Configurações e role até Sensores e GPIO.
2. Toque em + Adicionar slot de sensor.
3. Escolha o tipo, o GPIO de cada pino, o ID de Hardware e o Nome, e ligue Ativo.
4. Toque em Concluído e depois em Salvar e reiniciar.

O passo a passo completo, com a busca de sondas e a calibração, está no capítulo 6. O sensor aparece no Painel de Controle depois das primeiras leituras.

release O mínimo e o máximo do cartão no painel dependem de o número do slot coincidir com o do GPIO. Veja a atenção de Os cartões antes de escolher os pinos.

air No Air, configure os sensores pela web com o aparelho acordado ou pelos comandos sensor do console (capítulo 14).

O PIN do painel

release O painel não usa senha: cada pessoa se identifica com a conta e um PIN. A conta admin sai de fábrica com o PIN 1234, que precisa ser trocado no primeiro uso (capítulo 8).

1. Na tela inicial, toque em CFG, na barra de botões de baixo, logo depois do último sensor (capítulo 11).
2. Na tela Quem está usando o painel?, toque em admin e depois em ENTRAR.
3. Digite 1234 e toque em ENTRAR.
4. O painel abre a tela Novo PIN. Digite o PIN novo e toque em ENTRAR.

O tamanho mínimo e os caracteres do PIN seguem a política de PIN (capítulo 8). Para cada operador, crie uma conta com PIN e só as permissões de que ele precisa (capítulo 8).

Pronto para usar

Confira antes de entregar o aparelho:

1. A senha do admin foi trocada e está guardada em lugar seguro.
2. A conta viewer tem senha nova ou foi excluída (capítulo 8).
3. O aparelho está na rede, e você sabe o endereço dele (Encontrar o endereço).
4. A chave do ponto de acesso está anotada (capítulo 9).
5. A hora está certa e o fuso é o do local (capítulo 10). release No painel, a data e a hora da barra de cima não têm o ? do relógio provisório.
6. Há um só pacote de idioma na pasta /lang (capítulo 3).
7. Cada sensor aparece no Painel de Controle com leituras plausíveis (capítulo 6).
8. Os limites de alarme de cada sensor estão definidos (capítulo 7).
9. release O PIN do admin não é mais 1234, e cada operador tem a sua conta com PIN (capítulo 8).
10. A telemetria e a linha de alarmes estão configuradas, se houver servidor (capítulo 21, capítulo 22).
11. Um backup da configuração foi baixado (capítulo 17).
12. air O ciclo de hibernação foi conferido (capítulo 19).

Voltar ao sumário

Capítulo 5

Configuração pela web: os três botões e a página Configurações

Este capítulo explica como a interface web grava uma alteração de configuração, o que cada um dos três botões de gravação faz e quando o aparelho precisa reiniciar. Depois, percorre a página Configurações campo a campo. É para quem configura o aparelho pelo navegador.

Como uma alteração é gravada

Nas páginas de configuração, nada é gravado enquanto você digita. Cada campo alterado vira uma alteração preparada, guardada na aba do navegador. As páginas Configurações, Alarmes e Sons, Telemetria, Rede e Usuários preparam alterações no mesmo conjunto: você pode alterar um limite de alarme, passar para a página Rede, alterar o DNS e gravar tudo de uma vez.

O conjunto preparado:

• sobrevive à troca de página e ao recarregar a página, dentro da mesma aba;
• some se você fechar a aba, tocar em Sair ou entrar de novo;
• não é visto por outra aba, outro navegador ou outra pessoa.

Na primeira alteração de um conjunto novo, um aviso lembra: Clique em “Salvar e Reiniciar” para aplicar as alterações. (Click “Save & Restart” to apply your changes.). A partir daí, a barra de topo mostra um selo e os botões de gravação (capítulo 13). No celular, eles ficam numa barra fixa no rodapé.

Os campos de cada página mostram o valor gravado no aparelho, com as alterações preparadas por cima. O que aparece na página é o que será gravado.

O ensaio: o aparelho decide

Cerca de 0,6 s depois da última alteração, a página envia o conjunto preparado ao aparelho como um ensaio (o parâmetro _dry=1). O aparelho aplica todas as verificações de faixa e de formato numa cópia da configuração, compara a cópia com a configuração em uso e responde quais grupos de configuração mudariam e se algum deles exige reinício. Nada é gravado e nada reinicia.

Quem decide é o aparelho, não a página. Um campo digitado de volta ao valor atual não conta como mudança.

O selo da barra de topo mostra a resposta:

O aparelho recusa o ensaio quando o conjunto inclui slots de sensor ou calibração (capítulo 6). Essas alterações só se gravam com Salvar e reiniciar. Contas (capítulo 8) passam pelo ensaio desde a v2.10.0, mas sem Testar: uma conta não se testa. No SIMUT Air, o ensaio é sempre recusado (No SIMUT Air).

Os grupos aparecem com o nome curto que o aparelho usa, em inglês, como time ou alarms. Com Não exige reinício, pare o ponteiro sobre o selo para ver a lista dos grupos. A tabela de Os grupos de configuração diz o que cada nome inclui.

Os três botões

Testar e Aplicar agora só aparecem quando o ensaio respondeu Não exige reinício. Salvar e reiniciar aparece sempre que há alteração preparada, e reinicia mesmo quando a alteração se aplicaria sem reinício.

Para experimentar uma alteração sem gravá-la:

1. Faça a alteração, por exemplo um limite de alarme.
2. Espere o selo mostrar Não exige reinício.
3. Toque em Testar.

O aviso Aplicado SEM salvar — um reinício desfaz (Applied WITHOUT saving — a restart undoes it) aparece, seguido dos grupos aplicados. A barra de gravação continua visível, porque a alteração ainda não está gravada. Para mantê-la, toque em Aplicar agora. Para desistir dela, toque em Sair ou feche a aba e reinicie o aparelho.

Para gravar sem reiniciar:

1. Faça as alterações.
2. Espere o selo mostrar Não exige reinício.
3. Toque em Aplicar agora.

O aviso Aplicado e salvo (Applied and saved) aparece, seguido dos grupos aplicados. A sessão continua aberta e o aparelho não sai do ar.

Para gravar e reiniciar:

1. Faça as alterações.
2. Toque em Salvar e reiniciar.
3. Leia a confirmação e toque em OK.

A confirmação diz: Isto salvará todas as alterações e reiniciará o sistema. O dispositivo ficará offline por ~10 segundos. Qualquer gravação de histórico/log em andamento será interrompida. Continuar? Depois de OK, aparece Salvo! Reiniciando sistema… (Saved! Restarting system…) e a página se recarrega sozinha cerca de 12 s depois (O que um reinício custa).

Se há uma calibração preparada (capítulo 6), Salvar e reiniciar primeiro envia a calibração ao aparelho e só depois grava o resto. Se a calibração falha, nada é gravado e aparece Erro na calibração: seguido do motivo, ou Tempo esgotado na calibração. Tente novamente.

Os grupos de configuração

O aparelho classifica cada alteração comparando a configuração de antes com a de depois, campo por campo. Um grupo só se aplica sem reinício quando o firmware relê aqueles campos a cada uso, ou tem uma função que empurra o valor novo para quem o usa. Todo o resto reinicia. Um campo que não pertence a nenhum grupo conhecido cai em unclassified e também reinicia. Quatro campos que nenhuma parte do firmware lê são a exceção: Amostra (ms), Registro Local e dois que só o arquivo de configuração carrega. O aparelho os reconhece, eles não entram em grupo nenhum e gravam sem reiniciar, desde a v2.7.4.

O tema do painel tem gravação própria, pelo Painel de Controle, e não passa por estes botões (capítulo 13).

Valores recusados

O aparelho confere cada campo antes de gravar. Um valor fora da faixa ou com formato errado é descartado: o campo mantém o valor anterior, e o resto da gravação continua.

• Depois de Testar ou Aplicar agora, o aviso Campos não aplicados: (Fields not applied) lista as chaves recusadas, como s_int ou net.dns2.
• Depois de Salvar e reiniciar, a página se recarrega sem esse aviso. Confira os campos alterados depois do reinício.

Alguns erros recusam a gravação inteira, e nada muda. O aviso é Falha ao salvar. (Save failed.) seguido do motivo e, quando existe, da seção entre parênteses. Os casos:

Cada seção do conjunto exige a sua permissão, e a gravação é tudo ou nada: se uma seção é proibida, nenhuma é gravada.

O que um reinício custa

Um Salvar e reiniciar leva o aparelho para fora do ar por cerca de 10 s. Na ordem:

1. O painel mostra Aplicando configurações… e depois Reiniciando o sistema…, cerca de 1,5 s cada.
2. O aparelho grava a configuração, registra o evento e responde à página.
3. O aparelho reinicia. Uma gravação de histórico ou de log em andamento é interrompida.
4. A página se recarrega cerca de 12 s depois e mostra a página de entrada, porque um reinício encerra todas as sessões (capítulo 13).

Dois casos mudam o passo 4:

• Porta web alterada: a página avisa Salvo. Redirecionando para nova porta… e, cerca de 15 s depois, abre o endereço com a porta nova (capítulo 9).
• Conta criada ou senha redefinida: antes de recarregar, a página mostra a senha provisória de cada conta. Anote-a: ela não aparece de novo (capítulo 8).

Depois do reinício, o aparelho se reconecta ao Wi-Fi, acerta o relógio de novo (capítulo 10) e retoma a telemetria.

O log de eventos registra cada gravação com o código 303 (Config alterada), com um destes textos:

No SIMUT Air

air

O Air recusa o ensaio e o Testar: a imagem do Air está no limite de memória de programa, e os dois caminhos que trabalham numa cópia da configuração ficaram de fora. Na barra de topo do Air, o selo fica em Alterações não salvas e só Salvar e reiniciar aparece. Toda gravação pela web reinicia o Air.

Lembre que a interface web do Air só existe enquanto ele está acordado em M0 (capítulo 13, capítulo 19).

Pela API

Os três botões usam a mesma rota, POST /api/commit_all, com o conjunto preparado no campo _payload. O que muda é o parâmetro extra:

A resposta diz o que aconteceu. Um ensaio de fuso horário, por exemplo:

{"status":"dry","reboot":true,"applied":["time"],"reboot_for":["time"]}

Um integrador pode usar o ensaio para validar uma configuração antes de mandá-la a vários aparelhos. O formato completo está no capítulo 26.

A página Configurações

A página Configurações (System Config, rota /config) exige a permissão Sistema. Ela tem sete seções, nesta ordem; a alpha e o Air não têm a sexta:

1. Identidade (General Identity)
2. Data e Hora (Date & Time)
3. Hardware (Hardware & Sampling)
4. Sensores e GPIO (Sensors & GPIO)
5. Syslog Remoto (Auditoria) (Remote Syslog (Audit Trail))
6. release Calibração do Touch (Touch Calibration)
7. Reiniciar (Restart)

As cinco primeiras preparam alterações para os botões da barra de topo. A página não tem botão de gravar próprio. Calibração do Touch e Reiniciar agem na hora, cada uma com botão próprio.

Se a página não consegue ler a configuração do aparelho, ela mostra uma faixa vermelha: Não foi possível carregar as configurações atuais. Os campos estão desabilitados para evitar salvar valores em branco sobre a sua configuração. Os campos ficam desabilitados, de propósito. Toque em Tentar novamente (Retry). A página já tenta três vezes antes de mostrar a faixa.

Identidade

O Nome aparece em vários lugares:

• no nome da rede do ponto de acesso de configuração, seguido de _SETUP (capítulo 9);
• no endereço mDNS, seguido de .local (release, capítulo 9);
• no nome Bluetooth (alpha air, capítulo 14);
• no campo de origem das mensagens de syslog (capítulo 25) e no rótulo das métricas Prometheus (capítulo 24);
• na etiqueta {DEV} da telemetria (capítulo 21);
• em show system info, no console.

Como o nome vira endereço de rede e nome de rede Wi-Fi, prefira letras sem acento, números e hífen.

O Fuso Horário não tem horário de verão nem frações de hora. Detalhes, e um efeito colateral de digitar neste campo, estão no capítulo 10.

Data e Hora

O botão Aplicar Agora (Apply Now) desta seção acerta o relógio imediatamente, sem passar pela barra de topo e sem reiniciar. Ele interpreta a data e a hora digitadas no fuso do campo Fuso Horário, como ele está na página. A resposta aparece abaixo do botão: Hora aplicada. (Time applied.), Falhou ao aplicar. (Failed to apply.) ou, com um campo vazio, Preencha data e hora. (Fill date and time.).

Com o NTP ligado, os campos de data e hora ficam esmaecidos, mas continuam editáveis: o acerto manual vale até a próxima sincronização. A dica abaixo do botão lembra: Usa fuso horário do dispositivo. Salve e Reinicie para persistir o toggle do NTP.

O funcionamento do relógio, do NTP e do acerto manual está no capítulo 10.

Hardware

Sobre a resolução: nesta versão, o aparelho espera 750 ms por leitura do DS18B20 em qualquer resolução. Baixar a resolução reduz a precisão sem encurtar a leitura. Detalhes no capítulo 6.

A dica abaixo de Intervalo Histórico (min) diz: 1 a 1440 min (24h). Padrão: 1. air No Air, esse intervalo é também o intervalo entre despertares, porque a tarefa principal de cada despertar é gravar um registro (capítulo 19).

release Os três campos do PIN formam a política de PIN do painel e só aparecem na imagem release, que é a única com painel de toque. Eles se validam juntos: o teto do tamanho mínimo muda com o teclado, e a dica abaixo do campo mostra a faixa permitida, como 4 – 8. Pela web, salvar uma política nova reinicia o aparelho, porque ela pertence à classe users. Pelo painel (Configurações, linha 11), a mesma mudança vale na próxima tela de PIN, sem reinício. Uma política mais exigente marca as contas com PIN para escolher um PIN novo. O significado de cada teclado está no capítulo 8.

Sensores e GPIO

A seção Sensores e GPIO (Sensors & GPIO) configura os 16 slots de sensor. Ela é descrita inteira no capítulo 6. Em resumo:

• a dica GP0–GP15 estão disponíveis para sensores; GP16 em diante pertencem ao display, ao touch e ao buzzer.;
• um mapa dos GPIOs em uso;
• a tabela dos slots, com as colunas Slot, Tipo, GPIOs, ID de Hardware e Nome;
• os botões + Adicionar slot de sensor e Procurar sondas;
• o editor de slot, com Tipo, Nome, ID de Hardware, Estado (Ativo e Alarmes habilitados), Atribuição de GPIO, Calibração, Gravação no histórico e Hardware, e os botões Liberar slot, Descartar alterações e Concluído.

Alterações de slot e de calibração só se gravam com Salvar e reiniciar. Com os 16 slots em uso, a página diz Os 16 slots estão em uso. Libere um para adicionar outro.

Syslog Remoto (Auditoria)

Esta seção envia os eventos do log a um coletor syslog na rede, para que a trilha de auditoria exista também fora do aparelho. A dica diz que o envio segue a RFC 5424 sobre UDP, que o servidor é um IPv4 da rede local e não um nome, e que não há garantia de entrega.

Com o interruptor ligado e o IP do Coletor vazio, nada é enviado. O formato das mensagens e a configuração do coletor estão no capítulo 25.

Calibração do Touch

release

O botão Resetar Calibração (Reset Touch Calibration) apaga a calibração do toque guardada e abre o assistente de calibração no painel. Ele age na hora, sem passar pela barra de topo:

1. Toque em Resetar Calibração.
2. Confirme em Resetar calibração do touch para padrão de fábrica?
3. Vá até o painel e siga os passos do assistente (capítulo 11).

O aviso Calibração resetada. Recalibre pelo display. confirma. Se alguém tocou no painel há menos de 5 s, aparece Display em uso. Tente novamente em alguns segundos. O log de eventos registra Touch calibration reset via web com o código 303.

A seção só aparece na imagem release, a única com painel de toque. Até a v2.7.3 ela aparecia também na alpha e no Air, onde o botão apagava o registro de calibração guardado e dizia que o assistente estava rodando num painel que não existe.

Reiniciar

Desde a v2.7.3, a última seção da página tem o botão Reiniciar sem salvar (Restart without saving). Ele reinicia o aparelho sem gravar nada: o que está pendente na barra de topo é descartado, e o que foi aplicado com Testar também se desfaz, porque o aparelho volta com a configuração gravada. Ele age na hora, sem passar pela barra de topo:

1. Toque em Reiniciar sem salvar.
2. Confirme em Reiniciar agora SEM salvar? O aviso lembra que as alterações não salvas nesta página serão perdidas e que o aparelho fica fora do ar por cerca de 10 s.

O aviso Reiniciando… confirma, e a página se recarrega cerca de 12 s depois, na página de entrada, porque o reinício encerra as sessões. Medido em 25/09/2026: o aparelho saiu do ar 3,3 s depois do clique e voltou a responder aos 26,4 s. O log de eventos registra o código 2 (Reboot solicitado pelo usuário).

Se alguém tocou no painel há menos de 5 s, aparece Display em uso. Tente novamente em alguns segundos. e nada acontece. Se o aparelho recusar o pedido, aparece Não foi possível reiniciar. e ele continua no ar.

Referência rápida

Todos os campos da página Configurações que passam pela barra de topo, na seção sys de POST /api/commit_all. Os campos da página Telemetria estão no capítulo 21 e no capítulo 22; os da página Rede, no capítulo 9.

As três chaves pin_* só existem na imagem release. Nas outras, a página não as envia.

Voltar ao sumário

Capítulo 6

Sensores e calibração

Este capítulo mostra como dizer ao aparelho quais sensores estão ligados e em quais pinos, como ele valida cada leitura e como corrigir um sensor contra um instrumento de referência. É para quem instala e mantém o aparelho; os limites de alarme de cada grandeza estão no capítulo 7.

Onde os sensores são configurados

Os sensores ficam na página Configurações (System Config, rota /config), em duas seções:

• Hardware (Hardware & Sampling): a resolução do DS18B20, o intervalo do histórico e a política de PIN do painel;
• Sensores e GPIO (Sensors & GPIO): a lista de slots e o editor de cada um.

A página exige a permissão Sistema PERM_SYS_CONFIG. A calibração, dentro do editor de slot, exige também a permissão Calibração PERM_CALIB; sem ela, o editor abre sem o bloco de calibração e não mostra erro (Requisitos da calibração).

Tudo o que você muda nestas seções fica preparado na aba do navegador até você gravar. Os três botões de gravação estão no capítulo 5. Mudanças de slot e de calibração só são gravadas com Salvar e reiniciar (Save & restart): o aparelho não aceita testá-las nem aplicá-las sem reiniciar.

A seção Hardware

Os três campos de PIN estão explicados no capítulo 8. Nas imagens alpha e Air, que não têm painel com toque, a página esconde esses três campos.

Resolução DS18B20

A resolução define o menor passo da temperatura medida pelo DS18B20: 9 bits é o passo mais grosso e 12 bits o mais fino. O aparelho envia a resolução na partida, pelo GPIO do primeiro slot DS18B20 ativo. Uma sonda DS18B20 ligada a outro GPIO não recebe o ajuste.

O aparelho sempre espera 750 ms pela conversão, que é o tempo da resolução de 12 bits. Uma resolução menor, portanto, não deixa a leitura mais rápida.

Amostra (ms)

Intervalo Histórico (min)

É o intervalo entre dois registros do histórico, de 1 min a 1440 min (24 h). O valor de fábrica é 1 min. O que o histórico grava em cada registro está em Leitura e histórico, e o histórico em si no capítulo 15.

A seção Sensores e GPIO

A seção mostra, de cima para baixo:

• o aviso GP0–GP15 estão disponíveis para sensores; GP16 em diante pertencem ao display, ao touch e ao buzzer.;
• a faixa de pinos, de GP0 a GP15. Um pino ocupado aparece destacado, com o número do slot dono ao lado;
• a tabela de slots;
• os botões + Adicionar slot de sensor (+ Add sensor slot) e Procurar sondas (Scan for probes).

A faixa e a tabela mostram o estado que o aparelho terá depois de gravar, e não o estado gravado: um slot com alteração pendente aparece com fundo destacado.

A tabela tem uma linha por slot em uso:

Toque numa linha para abrir o editor daquele slot. Sem nenhum slot em uso, a tabela diz Nenhum slot de sensor configurado ainda. Com os 16 slots em uso, o botão de adicionar some e aparece Os 16 slots estão em uso. Libere um para adicionar outro. Se a página não conseguir ler os slots do aparelho, mostra Não foi possível carregar os slots de sensores.; recarregue a página.

Slots

O aparelho tem 16 slots, numerados de 0 a 15. Um slot é uma posição da configuração, não um pino: ele guarda o tipo do sensor, os GPIOs que o sensor usa (de 1 a 4), a identificação e os limites de alarme. O número do slot é a identidade do sensor para o histórico, para o console serial e para a linha de alarmes, por isso a página o mostra.

De fábrica, os 16 slots estão vazios e nenhum GPIO está ocupado.

Tipos de sensor

Todas as imagens (release, alpha e Air) trazem os quatro tipos:

Sobre os sensores I²C (BME280 e BMP280):

• Um por par de pinos. A leitura aceitaria dois sensores no mesmo par SDA/SCL, em 0x76 e 0x77, mas a gravação recusa dois slots ativos no mesmo GPIO. Dê a cada sensor o seu par, e siga as regras do I²C do capítulo 2: um segundo sensor em outro par do mesmo periférico é lido pelo PIO, mais devagar.
• O aparelho confere o chip. Se você escolheu BME280 e o chip é um BMP280, ou o contrário, o aparelho corrige o tipo na partida pelo identificador do chip e grava a correção.
• Pares do periférico I²C. Com SDA e SCL num par que o periférico I²C do RP2040 aceita, a leitura usa esse periférico. Em outros pares, o aparelho lê o sensor pelo PIO do RP2040, sem o periférico. A ligação está no capítulo 2.

O editor de slot

O editor abre sobre a página. Para fechá-lo, toque no × do canto, toque fora da caixa ou toque em Concluído (Done). Fechar não descarta nada: as edições continuam preparadas.

Abaixo dos campos, o editor mostra, nesta ordem:

• o bloco Calibração (Calibration), só para slots ativos já gravados e só para contas com a permissão Calibração (Calibração);
• Gravação no histórico (History recording), com o botão Recompor o histórico agora (Recompor o histórico);
• Hardware, com Adotar a sonda ligada aqui (só para DS18B20) e Resetar época do histórico (Operações de hardware);
• uma linha de aviso em vermelho, quando há um problema;
• os botões Liberar slot (Free slot), Descartar alterações (Discard staged) e Concluído;
• o lembrete As edições são acumuladas conforme você digita e gravadas ao Salvar e Reiniciar.

Se você ativar um slot sem digitar o ID de hardware, o aparelho recusa a gravação (Erros ao gravar). Um slot ativo que chegue à partida sem ID, gravado por outro caminho que não esta página, recebe um ID automático: o tipo seguido do número do slot com dois dígitos, como DHT2202 para um DHT22 no slot 2. Se o nome também estiver vazio, ele vira o tipo e o slot, como DHT22 #2.

Adicionar um sensor

1. Abra Configurações e role até Sensores e GPIO.
2. Toque em + Adicionar slot de sensor. O editor abre no slot livre de menor número.
3. Escolha o Tipo. O formulário ganha um seletor para cada pino do tipo.
4. Escolha o GPIO de cada pino em Atribuição de GPIO.
5. Digite o ID de Hardware, por exemplo FREEZER-1.
6. Digite o Nome, por exemplo Freezer da sala 2.
7. Ligue Ativo.
8. Confira se a linha de aviso vermelha está vazia.
9. Toque em Concluído.
10. Toque em Salvar e reiniciar na barra de topo e confirme.

O aparelho reinicia, e a página se recarrega sozinha. O sensor aparece no Painel de Controle e no painel logo depois das primeiras leituras.

Um DS18B20 criado pela página não conhece ainda o número de série da sonda. Na partida seguinte, o aparelho lê esse número (a ROM) no pino, liga o slot a ele e grava. A partir da partida seguinte a essa, o aparelho passa a conferir a sonda (Como o aparelho valida as leituras).

Editar um sensor

1. Na tabela, toque na linha do slot.
2. Mude os campos.
3. Toque em Concluído.
4. Toque em Salvar e reiniciar.

Para desistir das mudanças de um slot antes de gravar, abra o editor dele e toque em Descartar alterações. O botão descarta também as mudanças de calibração desse slot e relê o que está gravado no aparelho.

Ao trocar o Tipo de um slot, o aparelho trata o sensor como outro: grava a data da troca como a época do slot (Resetar época do histórico) e apaga a ROM guardada.

Desligar sem apagar

Para parar de ler um sensor sem perder sua configuração, desligue Ativo e grave com Salvar e reiniciar. O slot continua na tabela, sem o ponto verde, e seus GPIOs ficam livres para outros slots.

Remover um sensor

1. Na tabela, toque na linha do slot.
2. Toque em Liberar slot.
3. Confirme a pergunta Liberar este slot? Tipo, GPIOs e identificação serão apagados.
4. Toque em Salvar e reiniciar.

O slot volta a ficar vazio e sai da tabela. O histórico já gravado continua no aparelho. As correções de calibração do sensor continuam no arquivo calib.csv.

Erros ao gravar

O editor confere as regras enquanto você digita e mostra o primeiro problema na linha vermelha:

Na gravação, o aparelho confere as mesmas regras e mais algumas. Se alguma falhar, nada é gravado, o aparelho não reinicia, e a página mostra Falha ao salvar. (Save failed.) seguido do motivo, em inglês:

Procurar sondas

O botão Procurar sondas varre os pinos do aparelho em busca de sensores ligados. Ele só informa o que encontrou: não cria nem muda nenhum slot.

1. Toque em Procurar sondas. O botão fica desativado e a página mostra Procurando… (Scanning…).
2. Espere o resultado, que chega em poucos segundos. A página espera no máximo 10 s.
3. Leia a lista, como 2 encontrada(s): GP2 (28FF641E8716045C), GP3.

A busca por BME280 e BMP280 olha só o par GP4/GP5. Um sensor I²C em outros pinos não aparece na busca, mas funciona se você configurar o slot à mão.

Grandezas e unidades

Cada slot informa uma ou mais grandezas, que o aparelho chama de canais:

A chave é o nome da grandeza na interface de programação, na telemetria e no arquivo de calibração. Na página, os rótulos curtos são Temp, Umid, Press e Luz.

A luminosidade existe na tabela de grandezas, mas nenhum dos quatro tipos de sensor a informa na v2.7.1.

Leitura e histórico

O aparelho lê cada sensor no seu próprio ritmo e grava o histórico no ritmo do Intervalo Histórico. São duas coisas diferentes.

Ritmo de leitura. É fixo por tipo:

Média. Cada grandeza guarda as últimas 10 leituras. Com as 10 guardadas, o aparelho descarta as 2 menores e as 2 maiores e tira a média das 6 restantes. Antes disso, logo depois da partida, usa a média simples do que tem. A correção de calibração é aplicada sobre essa média. O resultado é o valor que o painel, a página e a telemetria mostram.

Histórico. A cada Intervalo Histórico, o aparelho grava um registro com o valor corrigido de cada grandeza naquele instante. Um sensor em erro entra no registro sem valor. O primeiro registro depois de um reinício não espera o intervalo inteiro, desde que o relógio já esteja acertado.

air No Air, o aparelho lê os sensores a cada despertar (capítulo 19).

Como o aparelho valida as leituras

Uma leitura falha quando o sensor não responde, quando a conferência dos dados falha ou quando o valor está fora do que o aparelho aceita:

Um valor que não é número (infinito, indefinido) nunca entra na média.

Estado de erro. Um sensor entra em erro depois de 3 falhas seguidas e sai dele depois de 5 leituras boas seguidas. Enquanto está em erro, o aparelho não usa as leituras dele.

Sonda trocada. Um DS18B20 com ROM gravada só é lido se a sonda no pino for a mesma. Se outra sonda aparecer, o slot entra em erro na hora, em quarentena. A cada 10 ciclos de leitura, o aparelho relê a ROM do pino. Quando a sonda certa volta, a quarentena acaba sozinha e o log registra Hardware match restored. Para aceitar a sonda nova, use Adotar a sonda ligada aqui (Operações de hardware). Um DS18B20 sem ROM gravada aceita qualquer sonda no pino.

O log de eventos registra a entrada em erro, com o GPIO do sensor (capítulo 16):

Como o erro aparece

• Painel release: o cartão do sensor mostra Erro (ERROR) em letras grandes, no lugar do valor. O alarme de falha deixa o cartão âmbar (capítulo 7).
• LCD alpha: quando o LCD chega ao sensor em erro, mostra ERRO em letras grandes. O mesmo ERRO aparece quando não há nenhum sensor ativo.
• Interface web: na tabela de sensores do Painel de Controle, o ponto fica vermelho e a leitura mostra Error (capítulo 13).
• Histórico: os registros do período em erro ficam sem valor para aquele sensor.

Operações de hardware

As operações da seção Hardware do editor agem no aparelho na hora. Elas não passam por Salvar e reiniciar.

Adotar a sonda ligada aqui

Só aparece em slots DS18B20. Use depois de trocar uma sonda, quando o slot está em quarentena por divergência de hardware.

1. Abra o editor do slot.
2. Toque em Adotar a sonda ligada aqui (Adopt the probe wired here).

O aparelho lê a ROM da sonda no GPIO do slot, liga o slot a ela, grava e recarrega os sensores: a leitura segue com a sonda nova na hora, sem reiniciar. O GPIO do slot não muda. Se a ROM já constar do arquivo calib.csv, o slot recebe o ID de hardware e o nome guardados para ela; se não constar, recebe o ID LIB_SENS. Quando o ID muda, o aparelho grava a data como a época do slot (Resetar época do histórico).

Resetar época do histórico

Grava o instante atual como a época do slot: a data em que o sensor atual começou nele. Use quando trocar o sensor físico de um slot, para registrar a troca.

1. Abra o editor do slot.
2. Toque em Resetar época do histórico (Reset history epoch).
3. Confirme a pergunta. A página mostra Época do histórico resetada.

Recompor o histórico

O botão Recompor o histórico agora (Rebind history now) vale para o aparelho inteiro, não só para o slot aberto. Ele reescreve o arquivo de histórico do dia para os slots gravados, mantém os registros já feitos e reinicia o aparelho no fim. O histórico está no capítulo 15.

1. Grave antes as mudanças pendentes. Com alguma pendente, a página recusa e mostra Salve e Reinicie antes — recompor agora usaria a configuração anterior.
2. Toque em Recompor o histórico agora e confirme.
3. Espere a mensagem Histórico reescrito seguida da contagem. A página se recarrega cerca de 25 s depois.

Se o arquivo do dia não puder ser lido, a página pergunta se deve recriá-lo vazio. Recriar perde os registros de hoje; os dias anteriores ficam intactos. Se o aparelho não responder, a página mostra Sem resposta do dispositivo. Recarregue a página e confira o log antes de tentar de novo.

Calibração

A calibração corrige a leitura de um sensor para que ela coincida com a de um instrumento de referência. Cada grandeza de cada sensor tem a sua correção: um BME280 tem três, uma para temperatura, uma para umidade e uma para pressão.

A correção é feita por pontos. Cada ponto liga um valor bruto, o que o sensor leu, ao valor de referência, o que o instrumento confiável mostrou no mesmo momento. Uma grandeza aceita até 5 pontos.

Abaixo do menor valor bruto e acima do maior, a correção fica igual à do ponto da ponta. O aparelho nunca projeta uma inclinação para fora da faixa medida.

Reta ou Suave

A Interpolação (Interpolation) define como a correção passa de um ponto ao outro:

• Reta (Straight): linhas retas entre os pontos. É a escolha de fábrica.
• Suave (Smooth): uma curva cúbica monótona, do tipo PCHIP. Ela passa por todos os pontos sem ultrapassar nenhum deles entre um ponto e o seguinte.

A escolha Suave precisa de 3 pontos ou mais. Com menos, ela se comporta como Reta, e a página avisa: Suave é uma cúbica monótona: dobra pelas âncoras sem jamais ultrapassá-las. Precisa de 3+ pontos; com menos, comporta-se como reta.

Requisitos

• Permissões. A conta precisa de Sistema PERM_SYS_CONFIG, para abrir a página, e de Calibração PERM_CALIB, para ver e gravar o bloco.
• Relógio acertado. Sem o relógio acertado, por NTP ou à mão (capítulo 10), o aparelho recusa a gravação da calibração, e o bloco avisa em vermelho: NTP não sincronizado. Até a v2.8.0 a recusa nunca acontecia, porque o aparelho dava o relógio por sincronizado mesmo sem acerto.
• Slot ativo e gravado. O bloco só aparece em slots ativos já gravados no aparelho. Num slot novo, grave o slot primeiro e calibre depois.
• Uma leitura ao vivo, para os pontos em que você deixar o valor bruto vazio.
• Uma gravação a cada 5 s. O aparelho recusa uma segunda gravação de calibração antes disso.

Calibrar um sensor

Para cada grandeza, o bloco mostra:

• uma linha com o nome da grandeza, a leitura Bruto (Raw) e a leitura corrigido (corrected), como Temp — Bruto: 23.61 °C → corrigido: 23.40 °C;
• um mini gráfico da correção: a linha do zero, que é o sensor sem correção, e a curva com os pontos;
• sem pontos, Sem correção — padrão do sensor. (No correction — sensor default.), ou Offset constante (Constant offset) seguido do valor, quando a correção é um offset antigo gravado sem ponto de origem;
• os pontos, um por linha, cada um com Bruto, Referência (Reference), o botão ↻ (Usar a leitura bruta atual) e o botão × (Remover este ponto);
• + Adicionar ponto (Add point), até 5 pontos;
• Remover correção (Remove correction);
• Interpolação: com Reta e Suave.

Para calibrar:

1. Ponha o sensor e o instrumento de referência no mesmo ambiente e espere os dois estabilizarem.
2. Abra o editor do slot.
3. Na grandeza a corrigir, toque em + Adicionar ponto.
4. Toque em ↻ para copiar a leitura bruta atual para Bruto. Se preferir, deixe Bruto vazio: o aparelho capta a leitura bruta no momento da gravação.
5. Digite em Referência o valor que o instrumento mostra.
6. Para mais pontos, mude o ambiente (por exemplo, outra temperatura), espere estabilizar e repita os passos 3 a 5.
7. Escolha Reta ou Suave.
8. Confira se a linha de aviso vermelha do bloco está vazia.
9. Toque em Concluído e depois em Salvar e reiniciar.

Os pontos não precisam estar em ordem: o aparelho os ordena pelo valor bruto. Na gravação, o aparelho grava a calibração primeiro e aplica a correção aos sensores; em seguida grava o resto e reinicia. O log de eventos registra o código 407, Sensores calibrados.

Para tirar a correção de uma grandeza, toque em Remover correção e grave.

Erros da calibração

O bloco confere os pontos enquanto você digita e mostra o primeiro problema, precedido do nome da grandeza:

Na gravação, uma recusa do aparelho aparece como Erro na calibração: (Calibration error:) seguido do motivo, e nada é gravado:

Se a gravação da calibração demorar mais de 30 s, a página mostra Tempo esgotado na calibração. Tente novamente.

O arquivo calib.csv

As correções ficam no arquivo /calib.csv, na raiz do sistema de arquivos do aparelho, e não na configuração. O arquivo aparece na página Arquivos (capítulo 17).

A primeira linha é VERSION, seguida de um número que cresce a cada gravação. As outras linhas têm uma correção cada:

VERSION,1790000000
28FF641E8716045C,FREEZER-1,Freezer da sala 2,-18.40,-18.00,4.10,4.00
E6614103E7512B29,tSALA-1,Sala,cub,15.20,15.00,22.80,22.50,30.10,30.00
E6614103E7512B29,uSALA-1,Sala,55.00,52.00

Uma linha de DS18B20 sem pontos continua no arquivo: ela guarda a associação entre a ROM, o ID e o nome, que a adoção de sonda consulta.

Você pode enviar um calib.csv pela página Arquivos. O aparelho só o aceita se o número de VERSION for maior que o do arquivo atual; caso contrário, descarta o envio.

Voltar ao sumário

Capítulo 7

Alarmes, sons e janelas de manutenção

Este capítulo mostra quando o aparelho dispara um alarme, o que acontece no painel, na cigarra e na interface web, e como silenciar, desligar e suspender alarmes com uma janela de manutenção. É para quem opera o aparelho no dia a dia e para quem define os limites; o envio dos alarmes a um servidor está no capítulo 22.

Os dois tipos de alarme

O aparelho tem dois alarmes por sensor, independentes um do outro:

Nenhum dos dois dispara num slot inativo, nem num slot com a janela de manutenção aberta (Janelas de manutenção).

air O Air não tem painel nem cigarra. Nele, os alarmes só saem pela linha de alarmes (capítulo 22).

Limites por grandeza

Cada grandeza de cada sensor tem um mínimo e um máximo. O alarme de limite dispara quando qualquer grandeza do sensor fica abaixo do mínimo ou acima do máximo. Um BME280, por exemplo, tem três pares de limites: temperatura, umidade e pressão.

O valor comparado é o valor corrigido que o painel mostra, depois da média e da calibração (capítulo 6).

Limites de fábrica, em todo slot novo:

As regras dos limites:

• Mínimo abaixo do máximo. Se o mínimo ficar igual ou maior que o máximo, o aparelho sobe o máximo para o mínimo mais 0,1.
• Dentro da faixa da grandeza. Cada grandeza aceita limites só dentro da sua faixa plausível (capítulo 6). Pela web, um limite fora dela faz o aparelho recusar a gravação inteira, com Alarm limit outside channel range.
• Uma casa decimal. A página e o painel ajustam os limites em passos de 0,1.

Os limites podem ser mudados na página Alarmes e Sons (A página Alarmes e Sons) e no painel (Limites no painel).

Ligar e desligar os alarmes de um sensor

Desligar os alarmes de um sensor desliga só o alarme de limite dele. O alarme de falha continua ativo: uma falha de comunicação não é um limite que se possa desligar.

Há quatro lugares para isso:

De fábrica, os alarmes de todo slot vêm ligados. Religar os alarmes de um sensor, pela web ou pelo painel, também desfaz o silêncio do alarme de falha dele (Desativar).

O que acontece quando um alarme dispara

Quando um alarme dispara, o aparelho:

• toca a cigarra, com a melodia e o volume de alarme (Sons);
• no painel, pisca o cartão do sensor: em vermelho para limite, em âmbar para falha;
• no painel, leva o sensor em alarme para o cartão de baixo, a menos que ele já esteja fixado no cartão de cima;
• registra no log de eventos o código 470, Alarme disparado;
• se a linha de alarmes estiver ligada, envia o registro ao servidor (capítulo 22).

Quando nenhum sensor está mais em alarme, a cigarra para, os cartões param de piscar e o log registra o código 471, Alarme zerado.

No painel

release Toque no cartão que pisca para abrir a tela de alarme daquele sensor. O título mostra ! seguido do nome do sensor, e três botões:

No LCD

alpha A imagem alpha tem cigarra, mas o LCD não mostra alarmes e não há como silenciar no aparelho. A cigarra toca até o valor voltar à faixa, até alguém desligar os alarmes do sensor pela web, ou até alguém ligar o Mudo Global (Sons pela web). O LCD mostra ERRO para um sensor em falha (capítulo 6).

Na interface web

A interface web não mostra alarmes de limite. No Painel de Controle, um sensor em falha aparece com o ponto vermelho e Error (capítulo 13); um sensor fora dos limites aparece com a leitura normal.

release O espelho do painel, no Painel de Controle, mostra o painel como ele está, inclusive o cartão piscando (capítulo 13).

Para acompanhar alarmes de longe, use a linha de alarmes (capítulo 22).

Silenciar

Silenciar 120s cala o alarme por 120 s. Durante esse tempo:

• a cigarra para;
• os cartões param de piscar;
• a barra de cima do painel mostra Silenciado: seguido dos segundos que faltam, como Silenciado: 97s;
• nenhum alarme toca, nem um alarme novo de outro sensor.

O silêncio vale para todos os sensores, mesmo tocado a partir da tela de um só. Ele não exige PIN. O log registra o código 447, Alarme silenciado via UI, e a linha de alarmes recebe um registro de silêncio do sensor da tela (alarm_sil ou err_sil).

Quando os 120 s acabam, o log registra o código 448, Silenciamento de alarme expirou. Se algum sensor ainda estiver em alarme, a cigarra volta a tocar e o cartão volta a piscar. Se todos os alarmes acabarem antes, o silêncio é cancelado (código 472, Silenciamento cancelado).

Desativar

Desativar desliga o alarme do sensor da tela, e só dele. O efeito depende do alarme que está ativo:

• Limite: desliga os alarmes do sensor, como a linha Alarmes do menu do sensor. A mudança é gravada e continua valendo depois de um reinício. O log registra o código 456, Alarmes do sensor bloqueados pelo painel.
• Falha: cala só a falha daquele sensor, e o limite continua armado. O silêncio da falha dura até o sensor voltar a ler; se ele falhar de novo, o alarme volta. Religar os alarmes do sensor também o desfaz, e um reinício também. O log registra o código 449, Todos alarmes desativados (RAM).

Para desativar:

1. Toque no cartão que pisca.
2. Toque em Desativar.
3. Escolha a conta na lista Quem está usando o painel? (capítulo 8).
4. Digite o PIN.

Se a conta não tiver a permissão Bloqueio (painel) PERM_ALARM_BLOCK, o painel mostra Sem permissão e toca o som de erro; o log registra o código 458, Ação do painel recusada: sem permissão. Com a permissão, a cigarra para, o painel volta à tela inicial e a linha de alarmes recebe um registro alarm_off ou err_off com o nome da conta.

A página Alarmes e Sons

A página Alarmes e Sons (Alarms & Sounds, rota /alarms) exige a permissão Sistema PERM_SYS_CONFIG. Ela tem duas seções: Limites de Alarme e Configuração de Sons.

A página não tem botão próprio de gravar. As mudanças ficam preparadas na aba e são gravadas pelos botões da barra de topo (capítulo 5):

• limites e chaves de alarme valem sem reiniciar: Testar e Aplicar agora funcionam para eles;
• mudanças de som exigem reinício, e a barra oferece só Salvar e reiniciar.

Limites de Alarme

A seção mostra um cartão por sensor ativo. Sem sensores ativos, mostra Nenhum sensor configurado. (No sensors configured.); os sensores são criados na página Configurações (capítulo 6).

Cada cartão tem:

Ao digitar um mínimo igual ou maior que o máximo, a página sobe o máximo para o mínimo mais 0,1; ao digitar um máximo igual ou menor que o mínimo, desce o mínimo.

Para mudar um limite:

1. Abra Alarmes e Sons.
2. Digite o novo valor no campo.
3. Toque em Aplicar agora na barra de topo.

O aparelho passa a usar o limite novo na verificação seguinte, sem reiniciar.

Configuração de Sons

O botão de teste toca a melodia escolhida no navegador, não na cigarra do aparelho, no volume do controle correspondente. Os detalhes de cada som estão em Sons.

Ligar Mudo Global desliga as outras seis chaves; ligar qualquer uma delas desliga Mudo Global.

O menu de alarmes do painel

release No painel, os alarmes ficam no item Limites de Alarme do menu de configurações. O item aparece para contas com pelo menos uma das três permissões de painel:

Para abrir o menu, toque no botão de configurações da tela inicial, escolha a conta e digite o PIN (capítulo 8). O que cada conta pode fazer é decidido pelas permissões da conta que o PIN identificou.

A lista de sensores

A tela Limites de Alarme lista os sensores ativos, quatro por página, cada um com o nome e o estado dos alarmes: SIM (ligados) ou NÃO (desligados). As setas do rodapé mudam a seleção e SAIR volta ao menu.

Toque num sensor para selecioná-lo; toque de novo para abrir o menu dele.

O menu do sensor

O título é o nome do sensor. O menu tem três linhas:

Uma linha cuja permissão a conta não tem aparece apagada, com um cadeado. Tocar nela só toca o som de erro. O menu abre na primeira linha que a conta pode usar: uma conta só com Manut. (painel) abre em Manutenção.

O rodapé tem as setas, SAIR, que volta à lista, e ENTRAR, que abre a linha selecionada.

Tocar em Alarmes grava na hora. O log registra o código 456 ao desligar e 457 ao religar, com o nome da conta, e a linha de alarmes recebe alarm_off ou alarm_on.

Limites no painel

O título é o nome do sensor. O editor mostra uma barra por limite, quatro por página, com o nome da grandeza seguido de MIN ou MAX, como Temperatura MIN e Umidade MAX, o valor e a unidade. As setas nas pontas de cada barra diminuem e aumentam o valor.

1. Toque na barra do limite.
2. Toque nas setas das pontas para ajustar. Um toque muda 0,1. Segurando, o passo cresce: 0,5 depois de 2 s, 1 depois de 4 s e 10 depois de 6 s.
3. Toque em SALVAR.

As setas do rodapé mudam a barra selecionada, e SAIR volta ao menu do sensor sem gravar. O editor não deixa o mínimo passar do máximo: ao empurrar um, ele empurra o outro.

SALVAR exige a permissão Limites (painel) PERM_ALARM_LIMITS. O aparelho grava, passa a usar os limites novos na hora, registra no log o código 442, Limites de alarme salvos via UI, e envia um registro alarm_lim por grandeza alterada, com os limites novos e o nome da conta.

Janelas de manutenção

A janela de manutenção suspende os alarmes de um sensor por um tempo definido, enquanto alguém mexe nele. Durante a janela, aquele sensor:

• não dispara alarme de limite;
• não dispara alarme de falha, então desligar o cabo do sensor não faz a cigarra tocar;
• não gera registros de limite nem de falha na linha de alarmes.

O sensor continua sendo lido e gravado no histórico normalmente.

A janela guarda a hora em que termina, não um estado ligado ou desligado. Ela sobrevive a reinícios e fecha sozinha no prazo, e a duração máxima é de 30 dias. Um pedido maior é cortado para 30 dias.

A linha de alarmes recebe dois registros por janela: maint_on ao abrir, com a hora prevista do fim e o nome de quem abriu, e maint_off ao fechar, por comando ou por prazo. Um reinício no meio da janela não gera um maint_on novo. Se o sensor ainda estiver fora da faixa quando a janela fecha, o alarme dispara de novo.

Pelo painel

1. No menu do sensor, toque em Manutenção e depois em ENTRAR.
2. Na tela Manutenção, ajuste Horas e Minutos com as setas das pontas. A tela abre com 1 h e 0 min. As horas vão de 0 a 720; os minutos mudam de 5 em 5, de 0 a 55.
3. Toque em INICIAR.

A janela precisa ter pelo menos 5 min: com 0 h e 0 min, INICIAR só toca o som de erro. A ação exige a permissão Manut. (painel) PERM_MAINT. O log registra o código 454, Manutenção aberta pelo painel, com o nome da conta.

Com a janela aberta, a mesma tela mostra o nome do sensor e o tempo que falta, como 1h45 restantes, e o botão FECHAR. Toque em FECHAR para encerrar a janela antes do prazo; o log registra o código 455, Manutenção encerrada pelo painel. SAIR volta ao menu do sensor sem mudar nada.

Pela web e por um servidor

A interface web não tem controle de janela de manutenção. Um servidor, ou um script, abre e fecha janelas pela interface de programação, com uma conta que tenha a permissão Sistema:

• o pedido diz em quantos segundos a partir de agora a janela termina; 0 fecha a janela;
• um valor negativo é recusado, e um valor acima de 30 dias é cortado; nos dois casos o campo volta na lista rejected da resposta;
• a consulta de alarmes informa, por sensor, quantos segundos faltam para a janela fechar, e 0 quando não há janela.

O formato do pedido está no capítulo 26; o uso a partir de um servidor de alarmes, no capítulo 22.

Sons

release alpha A cigarra toca cinco tipos de som. Cada tipo tem seis melodias à escolha e pode ser ligado ou desligado:

Os ajustes gerais:

• Dois volumes. O volume de alarme vale só para o som de alarme; o volume do sistema vale para os outros quatro.
• Sons Web. Quando ligado, o aparelho toca o som de confirmação a cada entrada na interface web e o som de erro a cada senha errada (capítulo 13).
• Mudo Global. Cala todos os sons, inclusive o de alarme.

Com o som de alarme desligado, ou com Mudo Global, um alarme continua disparando no painel, no log e na linha de alarmes, mas a cigarra não toca.

air O Air não tem cigarra. A seção de sons existe na página, mas não tem efeito.

Sons no painel

release O item Sons de Alarme do menu de configurações exige a permissão Sistema PERM_SYS_CONFIG. A tela Config. de Sons tem nove linhas, em três páginas:

Na escolha de melodia, o painel lista as seis melodias numeradas e toca cada uma ao ser selecionada. SALVAR liga o som com a melodia escolhida e desliga o Mudo Global; SAIR volta sem mudar.

Ao ligar Mudo Global, o painel toca o som de atenção e pergunta: Todos os sons serão desabilitados. Tem certeza? Confirmar liga o mudo e desliga todos os sons; SAIR volta sem mudar.

As mudanças só valem depois de SALVAR, no rodapé da tela. O painel grava na hora, sem reiniciar, e o log registra o código 446, Config de som salva.

A linha de alarmes

Além do painel e da cigarra, o aparelho pode enviar cada mudança de alarme a um servidor, pela linha de alarmes, uma segunda linha da telemetria, desligada de fábrica. Ela envia um registro por transição, não um por leitura: limite ultrapassado (alarm), falha (err), silêncio (alarm_sil, err_sil), desativação e reativação (alarm_off, err_off, alarm_on), limites alterados no painel (alarm_lim) e janelas de manutenção (maint_on, maint_off). Os registros de ações feitas com PIN ou pela web levam o nome da conta. Para evitar picos isolados, um limite só vira registro depois de duas verificações seguidas com o valor fora da faixa; o painel e a cigarra reagem já na primeira. Os registros esperam numa fila na memória até o servidor confirmar o recebimento. Tudo isso está no capítulo 22.

Voltar ao sumário

Capítulo 8

Contas, permissões e PIN

Este capítulo explica quem pode fazer o quê no aparelho: as contas, as 13 permissões, a página Usuários, as senhas da interface web e o PIN com que cada pessoa se identifica no painel. É para quem administra o aparelho, e é a referência de permissões do manual inteiro.

O modelo de contas

O aparelho guarda até 32 contas. Cada conta tem:

• um nome, de 1 a 15 caracteres, único sem diferenciar maiúsculas de minúsculas;
• uma senha, para a interface web;
• um conjunto de permissões, uma por ação (As 13 permissões);
• release um PIN opcional, para se identificar no painel (Identidade no painel).

A mesma conta serve à web e ao painel. Uma pessoa que usa os dois tem uma conta só, com uma senha para a web e um PIN para o painel.

As contas de fábrica

As duas contas precisam trocar a senha no primeiro acesso pela web (capítulo 13). Para usar a conta viewer, toque em Reset na página Usuários e entregue a senha de uso único que aparece; se não for usá-la, exclua a conta.

A conta admin ocupa sempre a primeira posição da tabela e não pode ser excluída, nem pela web nem pelo painel. Nenhuma conta nova pode se chamar admin.

Como a senha é guardada

O aparelho nunca guarda a senha. Ele guarda um resumo feito com HMAC-SHA256 em 5.000 rodadas, com um sal aleatório de 8 bytes gerado pelo hardware para cada conta e com o número de série da placa misturado à chave.

Contas antigas, gravadas no formato anterior de 2.500 rodadas, são convertidas sozinhas para o formato atual na primeira entrada certa.

O PIN do painel também é guardado só como resumo, com um sal próprio do aparelho e o número de série da placa.

As 13 permissões

Cada permissão libera um grupo de ações. O aparelho confere a permissão em cada página, em cada consulta da interface de programação e em cada ação do painel: esconder um item da tela é só conforto.

Detalhes que a tabela não mostra:

• Histórico e Logs abre com Histórico ou com Logs, mas cada metade da página consulta o aparelho com a sua própria permissão (capítulo 13).
• Baixar um arquivo de /history exige Leitura e Histórico; baixar um arquivo de log de eventos exige Leitura e Logs.
• No painel, o item Limites de Alarme aparece com qualquer uma das três permissões de painel, e cada linha do menu do sensor exige a sua (capítulo 7).
• Sem nenhuma permissão, a conta entra na web mas não tem página para abrir (capítulo 13).
• Os itens Alterar Senha (o próprio PIN), Licença e Status do Sistema do painel valem para qualquer conta identificada.
• Os gráficos, o calendário e o mínimo e máximo do painel não exigem PIN.

As rotas exatas de cada permissão estão no capítulo 26.

O administrador e as ações exclusivas

Além das 13 permissões, existe o nível de administrador completo, que só a conta admin tem de fábrica. Quatro ações exigem exatamente esse nível, e nenhuma combinação das 13 permissões as libera:

A página Usuários concede no máximo as 13 permissões. Uma conta criada pela web, mesmo com todas elas marcadas, não faz backup nem atualiza o firmware. O nível completo só se concede pelo console completo, com user perm <nome> admin. As imagens release e alpha vêm com o console de emergência, que não tem esse comando: nelas, só a conta admin tem o nível completo (capítulo 14).

Ninguém concede o que não tem

Desde a v2.7.0, quem cria uma conta pela web só pode marcar permissões que a própria conta tem. Uma conta com Usuários e Painel, por exemplo, cria contas com Painel, com Usuários ou com as duas, e nada além disso.

Pelo mesmo motivo, só a própria conta admin, ou uma conta com o nível completo, define ou apaga o PIN do admin pela web.

A página Usuários

A página Usuários (Users, rota /users) exige a permissão Usuários PERM_USER_MGR. O título é Gestão de Acessos (Access Management). Ela tem a tabela de contas e o formulário Adicionar (Add New User).

Toda mudança nesta página fica preparada na aba e só vale quando você grava. Aplicar agora grava e aplica sem reiniciar; Salvar e reiniciar grava e reinicia. Testar não aparece quando há contas preparadas: uma conta não se testa. Depois de gravar, a página se recarrega sozinha. Até a v2.9.0, toda gravação de contas reiniciava o aparelho.

A tabela de contas

Os botões de cada conta:

A linha da conta admin tem só PIN e o selo Protegido (Protected): ela não pode ser resetada nem excluída pela página. A senha do admin se troca pela própria conta (capítulo 13) ou, em recuperação, pelo console (capítulo 18).

Uma ação preparada aparece na linha até a gravação: Pendente: PIN, Pendente: Reset, Pendente: Excluir, ou uma linha nova com Pendente: Novo e o botão ↶, que desfaz a última ação preparada.

Criar uma conta

O formulário Adicionar tem:

• Nome (Username): de 1 a 15 caracteres, sem aspas nem barra invertida;
• as 13 caixas de permissão, com os nomes da tabela de permissões;
• PIN do painel (opcional) (Panel PIN (optional)), só na imagem release;
• o botão Criar (Create User).

Para criar uma conta:

1. Digite o Nome.
2. Marque as permissões.
3. Se a pessoa vai usar o painel, digite um PIN em PIN do painel (opcional).
4. Toque em Criar. A conta aparece na tabela com Pendente: Novo.
5. Toque em Aplicar agora na barra de topo.
6. Copie a senha que aparece na janela Senha temporária (Temporary password).
7. Toque em Guardei — recarregar (I saved it — reload).

A janela Senha temporária lista cada conta criada ou resetada nessa gravação, com a senha de uso único ao lado. A senha tem 8 caracteres, entre letras maiúsculas e dígitos, sem O, 0, I e 1. Ela aparece só nessa janela: o aparelho guarda apenas o resumo. A janela não fecha com Esc, e a página só recarrega depois de Guardei — recarregar.

Entregue a senha à pessoa. Na primeira entrada, ela é levada à troca de senha obrigatória (capítulo 13).

Mudar as permissões de uma conta

A página Usuários não edita as permissões de uma conta existente. Para mudá-las pela web:

1. Toque em Excluir na conta e confirme Excluir?.
2. Crie a conta de novo, com o mesmo nome e as permissões novas.
3. Toque em Aplicar agora.
4. Entregue a nova senha de uso único.

As duas ações podem ir na mesma gravação. O aparelho as aplica na ordem em que foram preparadas; por isso, prepare a exclusão antes da criação, ou o nome ainda estará em uso. O PIN de painel da conta excluída se perde com ela; defina-o de novo na criação.

Outros caminhos:

• as três permissões de painel de uma conta mudam no painel, sem apagar a conta (Usuários no painel);
• qualquer permissão muda pelo console completo, com user perm, que vem instalado só no Air (capítulo 14).

Excluir uma conta

1. Toque em Excluir na linha da conta.
2. Confirme a pergunta Excluir?.
3. Toque em Aplicar agora.

O aparelho apaga o registro inteiro da conta, inclusive o resumo da senha e o PIN. Uma sessão web aberta da conta termina no pedido seguinte, e uma identificação no painel, na ação seguinte; o log registra o código 312, Sessão encerrada: conta alterada. A exclusão é feita pela posição da conta na tabela. O log de eventos guarda o nome da conta nas entradas antigas.

Resetar a senha de uma conta

1. Toque em Reset na linha da conta.
2. Confirme a pergunta Forçar reset?.
3. Toque em Aplicar agora.
4. Copie a nova senha na janela Senha temporária.

O reset troca só a senha. As permissões e o PIN continuam como estavam. Uma sessão web aberta da conta termina no pedido seguinte; a identificação no painel continua, porque o painel identifica pelo PIN.

PIN pela web

release O botão PIN abre uma pergunta do navegador com a regra, PIN: 4 a 8 de 0-9. Vazio remove o PIN.

1. Toque em PIN na linha da conta.
2. Digite o PIN, ou deixe vazio para apagar o PIN da conta.
3. Toque em OK. A linha mostra Pendente: PIN.
4. Toque em Aplicar agora.

Pela web, o PIN tem sempre de 4 a 8 dígitos, qualquer que seja a política de PIN do aparelho. O aparelho recusa um PIN que outra conta já use.

Motivos de recusa

A página não mostra estas recusas: a gravação continua e a ação recusada não aparece. Um script que grava contas pela interface de programação recebe a lista em rejected (capítulo 26).

Senhas e sessões da web

A entrada, as mensagens, a troca de senha e as sessões estão no capítulo 13. Em resumo:

O bloqueio guarda até 8 endereços ao mesmo tempo. A contagem de erros de um endereço para de subir em 12, o que mantém a espera em 300 s. Se os 8 lugares estiverem ocupados por bloqueios ainda ativos, o aparelho recusa uma entrada de um endereço novo com o código HTTP 429 e diz quanto esperar. Quem tem a permissão Usuários consulta esses bloqueios pela interface de programação.

Identidade no painel

release O painel não usa senha. Para abrir as configurações, a pessoa escolhe a própria conta numa lista e digita o PIN dela. A partir daí, o que o painel deixa fazer depende das permissões dessa conta. Cada vez que alguém toca no botão de configurações da tela inicial, o painel pede a identificação de novo; e depois de 30 s sem toque, ele volta sozinho à tela inicial.

Só contas com PIN conseguem se identificar. Uma conta sem PIN não aparece na lista.

Entrar

1. Na tela inicial, toque em CFG, na barra de botões de baixo, logo depois do último sensor (capítulo 11).
2. Na tela Quem está usando o painel?, toque na sua conta para selecioná-la e toque de novo, ou toque em ENTRAR.
3. Digite o PIN no teclado (O teclado).
4. Toque em ENTRAR.

Com o PIN certo, o painel toca o som de confirmação e abre o menu de configurações. O título mostra Configurações > seguido do nome da conta, e o menu lista só os itens que as permissões da conta alcançam. Com o menu filtrado, os itens aparecem sem os números.

A lista mostra quatro contas por página. As setas do rodapé andam uma conta por vez; com mais de oito contas, andam uma página por vez. SAIR volta à tela inicial. Uma conta bloqueada por tentativas erradas aparece com bloqueado em vermelho e não abre o teclado.

O teclado

O teclado depende da política de PIN (A política de PIN) e da finalidade da tela.

Para se identificar, com 2 ou 3 caracteres por tecla, o painel mostra cartões embaralhados. Cada cartão traz 2 ou 3 caracteres, e um toque no cartão vale por qualquer um deles: o painel nunca pergunta qual. Depois de cada toque, os caracteres são distribuídos de novo, então quem olha a tela não descobre o PIN pelos cartões tocados, nem se dois caracteres do PIN são iguais. O aparelho confere todas as combinações possíveis contra o PIN da conta escolhida.

Os símbolos de enfeite completam os cartões para que todos tenham o mesmo número de caracteres. Eles nunca fazem parte de um PIN.

Com 1 caractere por tecla, o painel mostra um teclado ordenado, que não embaralha:

• com 0-9, um teclado numérico: 1 a 9 em três linhas e o 0 sozinho no meio da quarta;
• com 0-9 A-Z, nove teclas de grupo, 0-9, ABC, DEF, GHI, JKL, MNO, PQRS, TUV e WXYZ. O primeiro toque abre o grupo; o segundo escolhe o caractere. Um toque fora da janela do grupo a fecha sem digitar nada.

Para definir um PIN, o painel usa sempre o teclado ordenado do alfabeto da política, qualquer que seja o número de caracteres por tecla. Escolher um PIN é o oposto de esconder um: o embaralhamento só custaria toques.

Em todos os teclados, a linha de pontos mostra quantos caracteres já foram digitados, e o rodapé tem:

• a tecla de apagar, que tira o último caractere;
• SAIR, que abandona a tela e funciona até durante uma espera;
• ENTRAR, que envia o PIN.

PIN errado e bloqueios

Um PIN errado faz o painel mostrar PIN inválido!, tocar o som de erro e distribuir os cartões de novo. Para identificar, o painel confere qualquer PIN a partir de 4 caracteres, mesmo abaixo do mínimo da política: um PIN assim pode ter sido definido antes de a política mudar, ou pela web. Se ele estiver certo, a conta vai direto para a troca (O PIN de fábrica). Com menos de 4 caracteres, o painel mostra PIN muito curto (mín. 4) e não confere. Até a v2.11.0, um PIN mais curto que o mínimo da política nunca era conferido, e a conta ficava sem o painel.

As tentativas erradas são contadas por conta:

Durante uma espera, o teclado some e a tela mostra Tentativas Excedidas e Aguarde N segundos…. A espera vale para o teclado inteiro, não só para a conta que errou. Uma entrada certa zera a contagem daquela conta.

Além disso, o painel inteiro trava depois de 20 tentativas erradas somadas entre todas as contas, contadas desde a última entrada certa. A tela fica vermelha, com ACESSO BLOQUEADO e Reinicialização requerida, e só um reinício destrava. As contagens ficam só na memória: um reinício zera todas.

A web não é afetada por nenhum desses bloqueios.

O PIN de fábrica

A conta admin sai de fábrica com o PIN 1234. Na primeira identificação com ele, o painel abre direto a tela Novo PIN, e o log registra o código 302 com o texto PIN padrão detectado; forçando troca. A troca fica pendente até o admin escolher um PIN diferente de 1234; escolher 1234 de novo não a desfaz.

Da mesma forma, quando a política de PIN fica mais exigente, toda conta com PIN é marcada para trocá-lo, e o painel abre Novo PIN na próxima identificação de cada uma (A política de PIN).

Nos dois casos, a conta já está identificada quando a tela Novo PIN abre, mas o menu só abre depois da troca. SAIR volta à tela inicial sem trocar, e a tela volta na identificação seguinte. Até a v2.11.0, SAIR levava ao menu sem trocar, inclusive com o 1234 de fábrica.

O próprio PIN

Qualquer conta identificada troca o próprio PIN pelo item Alterar Senha do menu (o 5º, Change Password).

1. Toque em Alterar Senha.
2. Na tela Novo PIN, digite o PIN novo no teclado ordenado e toque em ENTRAR.
3. Na tela Confirme o PIN, digite de novo e toque em ENTRAR.

Cada mensagem de resultado tem o botão ENTENDI, que volta à tela de onde a ação partiu. O log registra o código 445, PIN do display alterado.

O PIN precisa ser único porque dois PINs iguais deixariam de identificar quem está no painel. Por isso o aparelho recusa um PIN já usado, sem dizer de quem é.

A política de PIN

A política define como são os PINs de todas as contas. Ela tem três ajustes, que dependem um do outro:

O teto de tamanho depende dos caracteres por tecla: 8 com 3, 12 com 2 e 16 com 1. Com 2 ou 3 caracteres por tecla, o aparelho confere todas as combinações que os toques podem formar, e mais caracteres custariam tempo demais. Um toque além do teto não é aceito.

Como escolher:

• Mais caracteres por tecla escondem melhor o PIN de quem olha a tela, mas facilitam um chute às cegas.
• O alfabeto 0-9 A-Z torna um chute às cegas muito mais difícil sem custo nenhum. As letras são sempre maiúsculas.
• Um PIN mais longo é a defesa principal contra chutes.

No painel. O item Segurança do PIN (o 7º, PIN security) exige a permissão Usuários PERM_USER_MGR.

1. Toque numa linha para selecioná-la e toque de novo para mudar o valor. Tamanho mínimo sobe até o teto e volta a 4; Teclado mostra o teto ao lado, como 3 (max 8); Caracteres alterna entre 0-9 e 0-9 A-Z.
2. Toque em SALVAR. O painel mostra PIN salvo!.

Ao mudar um ajuste, o painel corrige os outros para uma combinação possível. SAIR descarta. A política vale na próxima tela de PIN, sem reiniciar, e o log registra o código 459, Política de PIN alterada pelo painel.

Na web. Os três campos ficam na seção Hardware da página Configurações, que exige a permissão Sistema (capítulo 6). A dica do tamanho mínimo mostra a faixa permitida, como 4 – 8. Pela web, a mudança vale com Aplicar agora, sem reiniciar (até a v2.9.0, exigia Salvar e reiniciar). O log registra o mesmo código 459, com a marca [web].

Quando a política fica mais exigente em qualquer ajuste (mínimo maior, alfabeto menor ou teto menor), toda conta com PIN é marcada para trocá-lo, e é levada a Novo PIN logo depois de se identificar (O PIN de fábrica). Afrouxar a política não marca ninguém.

• Mínimo maior: a conta se identifica com o PIN antigo, mesmo mais curto que o mínimo novo. Até a v2.11.0, o teclado recusava esse PIN como curto, e a conta ficava sem o painel.
• Alfabeto menor ou teto menor: um PIN antigo com uma letra que saiu dos cartões, ou mais longo que o teto novo, não pode mais ser digitado: o teto não sobe para um PIN antigo, porque é o tempo de conferir. Defina um PIN novo para essa conta no item Usuários do painel, na página Usuários da web ou no console.

Usuários no painel

O item Usuários (o 6º, Users) exige a permissão Usuários PERM_USER_MGR. Ele lista todas as contas menos a admin, com:

• um ponto depois do nome, quando a conta tem PIN;
• as letras L, B e M à direita, acesas para as permissões Limites (painel), Bloqueio (painel) e Manut. (painel) que a conta tem.

O rodapé tem SAIR e NOVO. Toque numa conta para selecioná-la e de novo para abrir o editor dela.

Criar uma conta no painel:

1. Toque em NOVO.
2. Digite o nome no teclado de texto, com até 15 caracteres, e toque em OK. O X do título volta à lista.
3. Na tela seguinte, marque as permissões de painel: toque em Editar limites, Bloquear alarmes e Manutenção para alternar entre SIM e NÃO.
4. Toque em SEGUIR.
5. Digite o PIN da conta em Novo PIN e de novo em Confirme o PIN, tocando em ENTRAR a cada vez.

O painel mostra Usuário salvo! e grava na hora, sem reiniciar. O log registra o código 450, Usuário criado pelo painel, com o nome de quem criou e da conta nova.

Uma conta criada no painel tem só as três permissões de painel e uma senha web aleatória que ninguém conhece. Ela não abre nenhuma página web até um administrador recriá-la pela página Usuários com permissões web e entregar a senha de uso único (Mudar as permissões de uma conta).

Editar uma conta no painel. O editor mostra o nome da conta no título e cinco linhas:

As três primeiras linhas só mudam na tela; SALVAR grava, e o painel mostra Usuário salvo! (código 453, Permissões alteradas pelo painel). As permissões web da conta ficam como estavam.

O painel só concede as permissões de painel que a conta identificada tem. Marcar, numa conta nova ou numa existente, uma permissão que ela não tem é recusado com Sem permissão, e nada é gravado: o log registra o código 458, Ação do painel recusada: sem permissão. Desmarcar é sempre possível, e uma permissão que a conta editada já tinha pode ficar. A regra é a mesma da página Usuários da web, e vale também para a própria conta. Até a v2.11.0, quem tinha a permissão Usuários concedia as três a qualquer conta, inclusive a si mesmo. Definir PIN grava ao fim da confirmação (código 452, PIN do painel definido).

Excluir uma conta no painel:

1. No editor da conta, toque em Excluir usuário.
2. Na pergunta Excluir este usuário?, com o nome da conta embaixo, toque em EXCLUIR. CANCELAR volta ao editor.

O painel mostra Usuário excluído e grava na hora, sem reiniciar (código 451, Usuário removido pelo painel). O painel não exclui a conta admin nem a conta que está identificada no momento.

Auditoria

O aparelho registra quem fez cada ação:

O código 311, Entrada do teclado casa com duas contas, era de uma versão em que o PIN identificava a conta sozinho. Desde que a conta é escolhida antes do PIN, ele não ocorre mais.

Como as posições da tabela de contas são reaproveitadas, o que identifica a pessoa num registro antigo é o nome no texto, e não o número da posição. A leitura do log de eventos está no capítulo 16.

O que existe em cada imagem

Nas imagens alpha e Air, o aparelho recusa um PIN enviado pela interface de programação (users.pin), mas cria a conta normalmente.

Recuperação

Voltar ao sumário

Capítulo 9

Rede, Wi-Fi e HTTPS

Este capítulo cobre a página Rede, a escolha da rede Wi-Fi, o que o aparelho faz quando perde a rede, o ponto de acesso de configuração durante a operação, o IP estático, o DNS, a porta web, o mDNS e o HTTPS com certificado próprio. É para quem instala o aparelho numa rede e para a equipe de TI que cuida dessa rede. A primeira configuração da rede, no primeiro boot, está no capítulo 4.

A página Rede

A página Rede (Network, rota /network) exige a permissão Rede PERM_NET_CONFIG. Ela tem duas partes:

• Status da Conexão (Current Connection Status): o estado da rede agora, só para leitura;
• Configuração (Network Configuration): o formulário, com as seções Wi-Fi, IPv4, Configuração de DNS, Servidor de Hora (NTP) e Servidor Web.

Como nas outras páginas de configuração, cada alteração fica preparada e só vale depois de gravada pelos botões da barra de topo (capítulo 5). Quase tudo nesta página exige reinício: com uma alteração da página Rede preparada, conte com Salvar e reiniciar.

Status da Conexão

Os valores são os que estão em uso agora, não os configurados: com DHCP, são os que o roteador entregou.

Conectado quer dizer que o aparelho terminou de entrar na rede. Com o NTP ligado, isso inclui o primeiro acerto do relógio: até lá, a linha diz Desconectado mesmo com um IP na linha de baixo (capítulo 10).

Wi-Fi

• O botão Buscar (Scan), ao lado do SSID, lista as redes ao alcance (Escolher a rede pela busca).
• O botão com o olho, ao lado da Senha, mostra ou esconde o que você digitou (Mostrar senha / Ocultar senha).
• O campo Senha sempre abre vazio. O aparelho nunca devolve a senha gravada, nem para um administrador.
• Um SSID vazio na gravação é ignorado: o aparelho mantém a rede atual.

O rádio do Pico W só opera em 2,4 GHz. Uma rede só de 5 GHz não aparece na busca e não aceita o aparelho.

IPv4

Com DHCP ligado, os três campos de baixo ficam esmaecidos e não são gravados. Para usar IP fixo:

1. Desligue DHCP.
2. Preencha IP Estático, Máscara e Gateway.
3. Na seção Configuração de DNS, desligue Obter DNS automaticamente (DHCP) e preencha DNS Primário (DNS).
4. Toque em Salvar e reiniciar.
5. Depois do reinício, abra a interface pelo endereço novo.

Um endereço que não é um IPv4 válido é recusado (net.ip, net.mask ou net.gw), e o aparelho mantém o anterior (capítulo 5). O aparelho não confere se o endereço está livre na rede: reserve-o no roteador ou escolha um fora da faixa do DHCP.

DNS

Com Obter DNS automaticamente (DHCP) ligado, os dois campos ficam esmaecidos. O DNS que vale em cada combinação:

Com IP fixo não há roteador para entregar DNS: o DNS Primário vale sempre. Desligue o DNS automático para poder editá-lo e para o secundário valer.

O aparelho precisa de DNS para achar servidores por nome: o NTP (capítulo 10) e o coletor da telemetria, quando configurado por nome (capítulo 21).

Um DNS Primário inválido é ignorado sem aviso, e o aparelho mantém o anterior. Um DNS Secundário inválido é recusado com net.dns2.

Servidor de Hora (NTP)

A dica abaixo do campo diz Deixe vazio para usar o padrão (pool.ntp.org). Se o NTP estiver desligado na página Configurações, a seção mostra a faixa NTP está desabilitado. com o atalho Habilite em Configurações do Sistema →. Como o aparelho escolhe e troca de servidor está no capítulo 10.

Servidor Web

A dica da porta diz Padrão: 80. Após salvar, o navegador redireciona automaticamente para a nova porta. Depois de Salvar e reiniciar, a página avisa Salvo. Redirecionando para nova porta… e abre o endereço novo cerca de 15 s depois. Guarde a porta: sem ela, o endereço sem porta não responde. A porta vale também para o HTTPS, com uma exceção: com a porta 80, o HTTPS atende na 443 (HTTPS).

Conexões persistentes (keep-alive) está ligado de fábrica desde a v2.3.0 e vale para HTTP e HTTPS. Em HTTPS, ele evita uma negociação TLS a cada pedido, e a dica diz que as páginas carregam cerca de 60 % mais rápido. O interruptor só aparece quando há um certificado HTTPS instalado. Desligue-o apenas se um proxy ou um cliente se comportar mal com conexões persistentes.

Escolher a rede pela busca

O botão Buscar lista as redes Wi-Fi ao alcance do aparelho, para você escolher sem digitar o nome.

1. Toque em Buscar. O botão muda para Buscando….
2. Espere a lista, normalmente em cerca de 1 s.
3. Toque na rede desejada. O nome vai para o campo SSID, a lista se fecha e o cursor vai para Senha.
4. Digite a senha e toque em Salvar e reiniciar.

Cada linha da lista mostra:

• um cadeado, se a rede é protegida; nada, se é aberta;
• o nome da rede;
• quatro barras de sinal;
• o sinal em dBm.

Pare o ponteiro sobre a linha para ver Rede protegida ou Rede aberta e o sinal.

A lista tem no máximo 12 redes, da mais forte para a mais fraca. Uma rede com vários pontos de acesso, como uma rede mesh, aparece uma vez só, com o sinal do ponto mais forte. Redes ocultas não aparecem: digite o nome delas no campo SSID.

A busca funciona também de dentro do ponto de acesso de configuração. O aparelho liga a interface de estação ao lado do AP só para buscar, e o AP continua no ar.

Mensagens possíveis:

A mesma busca está disponível para integradores em GET /api/wifi/scan, com a permissão Rede: a primeira chamada, com ?again=1, dispara a busca e responde {"scanning":true}; as seguintes devolvem a lista quando ela fica pronta (capítulo 26).

Quando a rede cai: a escada de reconexão

O aparelho nunca desiste da rede configurada. Quando não consegue entrar, ele tenta de novo com intervalos crescentes, e descansa quando as tentativas se esgotam. É a escada de reconexão.

Os degraus

Uma tentativa de entrar na rede leva até 20 s. Antes de cada tentativa, o aparelho busca a rede para conferir se ela está no ar. Se a rede não aparece em duas buscas seguidas, o aparelho tenta entrar assim mesmo: é assim que uma rede oculta, que nunca aparece em busca, volta a conectar. Cada busca tem 15 s de prazo.

Depois de cada tentativa que falha, a espera até a próxima dobra:

O intervalo tem teto de 120 s, que a escada não chega a atingir: a 5ª falha já leva à dormência.

Na dormência, a espera antes de cada busca passa a ser de 10 min. O aparelho cumpre três dormências. Se a rede não voltar, ele volta ao primeiro degrau e registra Dormancy over — back to fast retries. Uma conexão bem-sucedida, a qualquer momento, zera a escada.

Durante a escada, o aparelho continua medindo, gravando o histórico e atendendo o painel. A telemetria pendente espera a rede voltar (capítulo 21). A escada não abre o AP de configuração: o aparelho tenta a rede configurada pelo tempo que for preciso, e o AP só abre quando alguém pede (Quando o AP abre). Da v2.7.1 à v2.8.0, a escada também abria o AP sozinha.

Quando o rádio recusa o pedido

Um sinal fraco não impede o pedido de conexão: o rádio aceita o pedido, e a associação falha depois, como uma tentativa comum da escada. Mas o rádio pode recusar o próprio pedido, quando o chip ou o driver entra num estado do qual um pedido novo não o tira. Cada recusa vira o evento Conectando WiFi (10) com contexto 2, e a escada segue.

Três recusas seguidas, com o aparelho ligado há mais de 30 min, fazem o aparelho reiniciar para recuperar o rádio. Antes, ele grava o evento 10 com contexto 3. Nos primeiros 30 min depois de um boot, ele não reinicia por esse motivo, então um rádio que continua quebrado custa no máximo um reinício a cada meia hora.

Até a v2.8.0, uma recusa prendia o aparelho por até 15 s dentro do pedido, e o watchdog, que reinicia o aparelho depois de 8,4 s sem resposta, o reiniciava. O log mostrava só a autópsia de um travamento no módulo WIFI, contexto 202 (Como ler um travamento).

Quando o rádio não responde à busca

A escada mede quanto tempo o pedido de busca leva para voltar. Num rádio que responde, ele volta em milissegundos. Num rádio que parou de responder, só volta depois do tempo-limite do driver, perto de 1 s. Uma busca assim que passa do prazo de 15 s é de um rádio mudo.

Logo depois de o rádio emudecer, os primeiros pedidos ainda voltam em milissegundos, com erro. Por isso, quando uma busca que voltou rápido passa do prazo, o aparelho faz uma leitura curta ao rádio. Se o rádio responde, a busca só se perdeu e a escada segue como sempre. Se não responde, é um rádio mudo.

Depois de uma busca de rádio mudo, a escada não tenta entrar na rede às cegas: num rádio mudo, esse pedido de conexão prendia o aparelho além dos 8,4 s do watchdog.

Duas buscas seguidas de um rádio mudo, com o aparelho ligado há mais de 30 min, fazem o aparelho reiniciar para recuperar o rádio. Antes, ele grava o evento 10 com contexto 4. Nos primeiros 30 min depois de um boot, ele segue buscando, sem reiniciar e sem tentar entrar na rede.

Até a v2.11.1, a escada tentava entrar às cegas depois de duas buscas sem resposta, e o watchdog reiniciava o aparelho. O log mostrava só a autópsia de um travamento no módulo WIFI, contexto 202 (Como ler um travamento).

Outros motivos para reconectar

Conectado, o aparelho confere o sinal uma vez por minuto. Um sinal impossível, 0 dBm ou mais, ou abaixo de −120 dBm, ou uma leitura que o rádio não responde, indica que o rádio parou de responder de verdade, mesmo que o Wi-Fi ainda se diga conectado. Duas leituras assim seguidas fazem o aparelho derrubar a conexão e entrar na escada, com o evento Implausible RSSI twice — link presumed dead, reconnecting.

Como ler a escada no log de eventos

A página Histórico e Logs mostra os eventos (capítulo 16). Os que contam a história da rede:

O log de eventos não grava cada repetição. Uma falha que se repete, como Retry in <n>s, é gravada na primeira vez e depois só a cada hora, enquanto durar. A volta da rede (IP: ...) é gravada porque encerra a falha. Por isso, uma escada longa aparece no log como poucas linhas. O filtro está explicado no capítulo 16.

O AP de configuração durante a operação

release alpha

O ponto de acesso de configuração é uma rede Wi-Fi que o próprio aparelho cria, quando alguém pede, para ser configurado sem outra rede: num aparelho novo, ou num que não consegue entrar na sua rede. O primeiro uso, num aparelho novo, está no capítulo 4.

A rede do AP:

A chave é derivada da identidade do chip e é sempre a mesma para aquele aparelho, mesmo depois de um reset de fábrica. Ela usa letras maiúsculas e algarismos, sem O, 0, I e 1, para ser lida em voz alta sem confusão. A chave aparece:

• no console serial, quando o AP abre;
• no painel, quando o AP abre: no boot, pelo gesto, ou em operação, pelo menu ou pelo comando ap;
• no LCD do alpha, na terceira das páginas do AP (capítulo 12);
• na resposta do comando ap do console (capítulo 14).

Anote a chave do seu aparelho na primeira configuração.

Quando o AP abre

O AP só abre quando alguém pede:

O aparelho nunca troca a rede dele pelo AP sozinho. Sem rede configurada, ele liga, mede e grava como sempre, e a release pergunta a data e a hora no fim do boot (capítulo 10). Com a rede fora do ar, ele segue a escada de reconexão até ela voltar (Quando a rede cai).

Da v2.7.1 à v2.8.0, a release e o alpha também abriam o AP sozinhos: no boot de um aparelho sem rede configurada, e pela escada de reconexão. A escada abria o AP na primeira dormência de um aparelho que nunca tinha obtido IP desde que ligou, cerca de 6 a 7 min depois de ligar (medido em bancada em 22/09/2026, com uma rede que não existe), ou ao fim de uma volta inteira da escada num aparelho que já tinha obtido IP, cerca de 68 min pela aritmética da escada.

O log de eventos registra quem pediu no contexto do evento 403: 0 para o comando ap ou o painel, 1 para o gesto no boot. Os contextos 2 (aparelho sem rede configurada) e 3 (a escada) só aparecem em logs gravados da v2.7.1 à v2.8.0.

Enquanto o AP está aberto

Com o AP aberto, o aparelho continua medindo. Ele lê os sensores, confere os limites dos alarmes e grava o histórico com o AP de configuração no ar. Só a telemetria e o syslog esperam a rede voltar; a linha de alarmes guarda os eventos na fila e os envia depois. O painel fica na tela do AP, com a rede, a chave e o endereço: um alarme soa pelo buzzer, mas não aparece no vidro enquanto essa tela estiver aberta. No alpha, o LCD mostra as páginas do AP: o endereço, a rede e a chave (capítulo 12).

• A telemetria e o syslog esperam a rede voltar.
• O aparelho não tenta a rede configurada enquanto o AP está aberto.
• Num aparelho com rede configurada, o AP dura 15 min, aberto pelo painel, pelo comando ap ou pelo gesto no boot. Depois disso o aparelho reinicia para tentar a rede de novo, com ou sem alguém conectado ao AP. O evento é Timeout na conexão WiFi (525) com o texto AP mode timeout, rebooting to STA. Se a rede ainda não estiver lá, o aparelho segue a escada de reconexão, e o AP só volta se alguém o abrir de novo.
• Num aparelho sem rede configurada, o AP fica aberto até alguém gravar uma rede ou reiniciar o aparelho.
• Até a v2.11.0, o prazo do AP aberto pelo gesto no boot lia um nome de rede que nada tinha gravado. Esse AP podia ficar aberto para sempre num aparelho com rede, ou fechar em 15 min num aparelho sem rede, conforme o que estivesse na memória. Na bancada, em 04/10/2026, ele fechou em 15 min num aparelho com rede.

Para sair do AP com a rede certa:

1. Conecte o celular ou o computador à rede <nome>_SETUP, com a chave.
2. Abra http://192.168.4.1 e entre com uma conta que tenha a permissão Rede.
3. Na página Rede, toque em Buscar, escolha a rede e digite a senha.
4. Toque em Salvar e reiniciar.

O aparelho reinicia e tenta a rede nova.

air O Air não tem painel: o AP dele só abre pelo comando ap, e ele nunca o abriu sozinho, nem da v2.7.1 à v2.8.0. O rádio do Air só existe durante um despertar, e ninguém está diante de um aparelho hibernando para usar o AP. O jeito indicado de configurar a rede do Air é o console, por USB ou Bluetooth (capítulo 19).

mDNS: o endereço pelo nome

release

Na imagem release, o aparelho responde pelo nome <nome>.local na rede local, como http://simut.local. O nome é o campo Nome da página Configurações (capítulo 5). Não há nada a configurar.

O aparelho também se anuncia como um serviço _simut._tcp, para que um programa descubra todos os aparelhos da rede sem saber os endereços. O anúncio leva a porta do servidor web e quatro campos de texto:

Com HTTPS na porta padrão, o anúncio leva a porta 443.

O nome e o serviço passam a responder quando o aparelho termina de entrar na rede. Com o NTP ligado, isso inclui o primeiro acerto do relógio (capítulo 10). Uma falha registra Falha ao iniciar mDNS (528).

Para procurar os aparelhos num computador com Linux:

avahi-browse -rt _simut._tcp

As imagens alpha e Air não têm mDNS. Use o endereço IP.

HTTPS

release

Só a imagem release tem servidor HTTPS. Sem certificado instalado, ela atende em HTTP, como as outras. Com um par de certificado e chave instalado, ela passa a atender só em HTTPS a partir do reinício seguinte.

Como o HTTPS se comporta

• Porta: com a Porta HTTP em 80, o HTTPS atende na 443, e https://192.0.2.10 funciona. Com outra porta configurada, o HTTPS atende nela.
• Um protocolo só: o endereço http:// deixa de responder. O aparelho nunca serve os dois ao mesmo tempo.
• Um cliente seguro por vez: o aparelho atende uma conexão TLS por vez. As páginas enfileiram as próprias consultas (capítulo 13).
• Protocolo e cifras: só TLS 1.2, com troca de chaves ECDHE e cifra AES-GCM de 128 ou 256 bits. Um cliente que só fale TLS 1.1 ou menos, ou só cifras CBC ou ChaCha20, não conecta.
• Sessão: o cookie de sessão ganha a marca Secure (capítulo 13).
• AP: ligado já no AP, o aparelho atende em HTTP (Enquanto o AP está aberto).
• Falha segura: se o par está ausente, vazio, maior que 8 KB ou não pode ser lido, o aparelho sobe em HTTP na porta configurada e registra Certificado web inválido (HTTP) (576). Um certificado ruim nunca tranca você do lado de fora.

Gerar um par autoassinado

Gere um par para cada aparelho, num computador com OpenSSL 1.1.1 ou mais novo. Ponha no certificado os nomes pelos quais o aparelho será acessado: o IP e, se usar mDNS, o nome .local. Sem isso, o navegador trata o certificado como de nenhum endereço, mesmo depois de você confiar nele.

Com chave EC P-256, a recomendada:

openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 \
  -keyout web_key.pem -out web_cert.pem -days 3650 -nodes \
  -subj "/CN=simut" \
  -addext "subjectAltName=IP:192.0.2.10,DNS:simut.local"

Com chave RSA de 2048 bits:

openssl req -x509 -newkey rsa:2048 \
  -keyout web_key.pem -out web_cert.pem -days 3650 -nodes \
  -subj "/CN=simut" \
  -addext "subjectAltName=IP:192.0.2.10,DNS:simut.local"

Troque 192.0.2.10 e simut pelo IP e pelo nome do seu aparelho. -days 3650 dá dez anos de validade.

O aparelho aceita:

• chave EC ou RSA; a EC precisa ser de uma curva que o firmware conheça, e a P-256 é a recomendada;
• a chave nos três formatos PEM: PRIVATE KEY, EC PRIVATE KEY e RSA PRIVATE KEY;
• uma cadeia de certificados de uma autoridade certificadora, com o certificado do aparelho primeiro.

A chave não pode ter senha. Para tirar a senha de uma chave:

openssl pkey -in key.pem -out plain_key.pem

Instalar o par

O par se instala pela rota POST /api/tls. Nenhuma página da interface web usa essa rota, e a página Arquivos recusa enviar qualquer arquivo para /config, onde o par fica. Há dois caminhos: o script do repositório ou o curl.

A rota exige uma conta de administrador completo, com todas as permissões. Outra conta recebe 403.

Pelo script tools/install_tls_cert.py, que entra no aparelho, envia o par e, com --reboot, reinicia:

export SIMUT_WEB_USER=admin
read -rsp 'Senha do admin: ' SIMUT_WEB_PASS; echo; export SIMUT_WEB_PASS
python3 tools/install_tls_cert.py --host 192.0.2.10 \
  --cert web_cert.pem --key web_key.pem --reboot

Pelo curl. Primeiro abra uma sessão, depois envie os dois blocos PEM juntos no corpo do pedido, em qualquer ordem, com um tipo de conteúdo que não seja de formulário:

H=192.0.2.10
NONCE=$(curl -s -c jar http://$H/api/login_init | sed 's/.*"nonce":"\([^"]*\)".*/\1/')
HASH=$(printf '%s' 'sua-senha' | sha256sum | cut -d' ' -f1)
curl -s -b jar -c jar -X POST http://$H/api/login \
  --data-urlencode user=admin --data-urlencode pass=$HASH \
  --data-urlencode nonce=$NONCE
cat web_cert.pem web_key.pem | curl -s -b jar -X POST --data-binary @- \
  -H 'Content-Type: application/x-pem-file' http://$H/api/tls

A página de entrada envia a senha já resumida em SHA-256, e o curl precisa fazer o mesmo. Este exemplo vale para senhas só com caracteres ASCII. O processo de entrada está no capítulo 26.

Com o par aceito, a resposta é:

{"ok":true,"installed":true,"key":"EC (curve 23)","serving":"http","nextBoot":"https","rebootRequired":true,"note":"setup AP mode always serves HTTP"}

key descreve a chave: EC (curve 23) é a P-256, e uma chave RSA aparece como RSA (2048 bits). serving é o protocolo em uso agora e nextBoot, o do próximo boot. O servidor em execução não muda: o par vale a partir do próximo reinício. Para reiniciar:

curl -s -b jar -X POST "http://$H/api/action?op=reboot"

Depois do reinício, abra https://192.0.2.10. O log de eventos registra Par de certificados web instalado (579) na instalação e, no boot seguinte, Cert SSL carregado (34) com o texto HTTPS server (provisioned cert) e a porta no contexto.

O aparelho confere o par antes de gravar qualquer coisa: ele deriva a chave pública da chave privada e a compara com a do certificado. Um par trocado é recusado agora, com o par anterior intacto, em vez de subir quebrado no próximo boot. A gravação usa arquivos temporários e só depois os renomeia, para que uma falha no meio não apague um par que funcionava.

Respostas de erro:

Um par recusado registra Certificado web inválido (HTTP) (576) com o contexto 3.

O que o navegador mostra

Um certificado autoassinado não foi emitido por uma autoridade que o navegador conheça. No primeiro acesso, o navegador mostra uma página de aviso dizendo que a conexão não é particular ou que o certificado não é confiável. Para seguir:

1. Confira que o endereço é o do seu aparelho.
2. Abra os detalhes do aviso, geralmente em Avançado.
3. Escolha continuar para o endereço.

O navegador lembra a exceção por um tempo, conforme o navegador. Para não ver mais o aviso, importe o web_cert.pem como certificado confiável no sistema operacional ou no navegador de cada computador que acessa o aparelho. Isso só funciona se o certificado tiver o IP e o nome no campo subjectAltName.

Voltar para HTTP

Para desligar o HTTPS, use o console serial (capítulo 14):

system https off confirm

O aparelho apaga o par, registra HTTPS disabled via serial (cert deleted) com o código 303 e reinicia em HTTP. O comando existe também no console de emergência da release. Ele é a saída quando um par entra, mas toda negociação TLS falha e a interface fica inalcançável.

Depois de voltar para HTTP, o primeiro acesso pelo mesmo navegador pode voltar direto para a página de entrada, por causa do cookie Secure antigo. A página avisa e diz o que fazer (capítulo 13).

O par e a atualização de firmware

A atualização de firmware reformata o sistema de arquivos e só preserva a configuração principal (/config/system.bin). O par de certificados não é preservado pela atualização: depois dela, o aparelho volta a atender em HTTP.

O backup .bkp, que a página Arquivos baixa antes de atualizar, contém todos os arquivos, inclusive o par. Para voltar ao HTTPS depois de atualizar, restaure esse backup ou instale o par de novo (capítulo 17).

O comando system format também apaga o par. A chave privada nunca é servida pela rota de download de arquivos.

CORS para o gestor de frota

O gestor de frota é uma página que roda no navegador do operador e fala com vários aparelhos ao mesmo tempo (capítulo 27). O navegador bloqueia essas chamadas, a menos que o aparelho autorize a origem da página: é o CORS.

A origem se configura pelo console serial, inclusive no console de emergência da release:

system cors http://gestor.exemplo.com.br:8080
reload confirm

A origem vale depois do reinício. Para desligar:

system cors off
reload confirm

Regras da origem:

• começa com http:// ou https://;
• tem só o nome ou IP e, opcionalmente, :porta;
• não tem barra no fim, caminho nem *;
• tem no máximo 64 caracteres.

A origem fica em /config/cors.txt. No boot, o aparelho registra CORS ligado para a origem (577) ou, se o arquivo for inválido, Origem CORS inválida (CORS desligado) (578). Um integrador também pode gravar a origem pela chave cors da seção sys de POST /api/commit_all; ela também só vale depois do reinício.

Referência rápida

Os campos da página Rede, na seção net de POST /api/commit_all:

Os limites de sinal que o aparelho usa:

As barras de sinal do painel usam limites próprios (capítulo 11), e o ícone do LCD, os seus (capítulo 12).

Voltar ao sumário

Capítulo 10

Data e hora

Este capítulo explica de onde vem a hora do aparelho: o NTP, o fuso horário, o acerto manual, pela web, pelo painel ou pelo console, e o relógio provisório que vale até o primeiro acerto. Mostra também o que acontece com o histórico quando o relógio é corrigido. É para quem instala o aparelho, sobretudo numa rede sem acesso à internet ou num lugar sem Wi-Fi.

De onde vem a hora

O aparelho não guarda a hora quando é desligado ou reiniciado; o Air é uma exceção parcial (O relógio do Air através do sono). Toda vez que liga, ele precisa descobrir que horas são. Há três fontes, nesta ordem de preferência:

1. NTP: a hora certa, pela rede. É o padrão de fábrica (NTP).
2. Acerto manual: a hora que alguém digitou, pela interface web, pelo painel ou pelo console (Acerto manual).
3. Relógio provisório: uma estimativa feita a partir do histórico, usada até uma das duas primeiras chegar (O relógio provisório).

Internamente, o aparelho conta o tempo em UTC. O fuso horário só entra na hora de mostrar a hora e de decidir em qual arquivo diário do histórico cada registro cai (Fuso horário).

NTP

O NTP vem ligado de fábrica. Ele se liga e desliga na página Configurações, seção Data e Hora, pelo interruptor Sincronizar automaticamente via NTP, e o servidor se escolhe na página Rede, seção Servidor de Hora (NTP), campo Endereço do Servidor. As duas alterações exigem Salvar e reiniciar (capítulo 5, capítulo 9).

Os servidores

O aparelho consulta dois servidores:

O servidor pode ser um nome ou um IP, com até 31 caracteres. Um nome exige DNS funcionando (capítulo 9). O NTP usa a porta UDP 123: numa rede com firewall, libere essa porta até o servidor escolhido.

Tentativas e troca de servidor

O aparelho pede a hora assim que entra na rede. Se ela não chega, ele pede de novo, e a espera entre os pedidos triplica até o teto de 15 min:

Depois de três esperas sem resposta, cerca de 4 min 20 s depois do primeiro pedido, o aparelho troca o primeiro servidor por pool.ntp.org, se ele já não for esse. A troca vale até o próximo reinício. O log de eventos registra NTP fallback: <servidor> -> pool.ntp.org.

Uma queda da rede Wi-Fi zera a contagem: na volta, as esperas recomeçam de 20 s.

Sem servidor NTP alcançável

O que o log mostra

Os eventos do relógio, na página Histórico e Logs (capítulo 16):

O log grava só o código e o contexto, não o texto (capítulo 16). No evento 13, o contexto separa as origens: 0 é NTP OK ou o NTP desligado; de 1 a 4, um acerto à mão; a troca de servidor é um aviso (WRN), com o número de falhas. Até a v2.8.0, o acerto à mão também gravava o contexto 0.

Uma correção maior que 1 h aparece como aviso, e não como informação. Depois de uma falta de energia, uma correção grande é normal: ela mede quanto tempo o aparelho ficou desligado (O relógio provisório). Uma correção grande com o aparelho sempre ligado indica um relógio provisório mal semeado. O contexto do evento 408 vai até 32.767 s, cerca de 9 h; um valor travado nesse número indica uma correção ainda maior.

Fuso horário

O fuso se configura na página Configurações, seção Identidade, campo Fuso Horário (capítulo 5).

O fuso é um número fixo. Não há horário de verão nem fusos com meia hora ou 45 min, como os da Índia (+5:30) ou do Nepal (+5:45). Onde há horário de verão, mude o Fuso Horário nas datas de troca. Desde a v2.4.9-beta, o aparelho guarda o fuso só como esse número; nada no firmware lê a variável de ambiente TZ.

O fuso decide:

• a hora mostrada no painel e no console;
• o arquivo diário do histórico em que cada registro entra, pela data local (capítulo 15);
• a conversão da data e da hora digitadas no acerto manual pela web.

Os registros do histórico guardam o instante em UTC. Mudar o fuso não altera os registros já gravados.

Acerto manual

Com o NTP desligado, ou sem rede, a hora do aparelho vem do acerto manual. Há três caminhos: a interface web, o painel da release e o console, em todas as imagens. Os três valem na hora, sem reinício, e o primeiro acerto depois do boot corrige a hora dos blocos do histórico que o boot começou sob o relógio provisório (Quando o primeiro acerto corrige o relógio).

Com o NTP ligado, um acerto manual vale até a próxima sincronização.

Pela interface web

1. Abra Configurações e vá até Data e Hora.
2. Preencha Data e Hora, na hora local do fuso configurado.
3. Toque em Aplicar Agora.

O aviso Hora aplicada. aparece abaixo do botão. O acerto vale na hora, sem reinício e sem passar pelos botões da barra de topo (capítulo 5). O seletor de data começa em 01/01/2026.

Para integradores, a rota é POST /api/set_time com o corpo {"epoch": <segundos UTC>}, com a permissão Sistema (capítulo 26).

No painel

release A tela Data e hora abre de dois jeitos:

• No fim do boot, sozinha, num aparelho sem rede configurada e com o relógio provisório. Sem rede não há NTP, e o histórico leva a hora do relógio provisório, que perde o tempo em que o aparelho ficou desligado (O relógio provisório).
• Pelo menu, no item 4, Data e hora, a qualquer momento, com a permissão Sistema PERM_SYS_CONFIG no painel, a mesma da rota POST /api/set_time (capítulo 11).

A tela tem cinco colunas, dd / mm / aaaa hh : mm, que começam na data e na hora do relógio em uso. Acima de cada valor há uma seta que soma 1; abaixo, uma seta que subtrai 1. Segurada, a seta repete a cada 300 ms. O dia fica dentro do mês: mudar o mês ou o ano ajusta o dia, e 31/03 menos um mês dá 28/02, ou 29/02 num ano bissexto. O dia, o mês, a hora e o minuto dão a volta; o ano para em 2026 e em 2099. Os segundos ficam em zero.

Na pergunta do boot, a linha Sem Wi-Fi, os dados levam esta hora. aparece em âmbar acima dos botões. A tela está na figura do capítulo 4.

• Quem pode salvar. Pelo menu, o aparelho confere a permissão Sistema da conta identificada no painel. A pergunta do boot não pede conta nem PIN: o aparelho aceita SALVAR sem conta enquanto não houver rede configurada nem relógio acertado. O primeiro acerto, por qualquer caminho, encerra essa exceção; depois dele, um SALVAR sem conta toca o som de erro e não muda nada.
• Ninguém responde. Depois de 30 s sem toque, o painel volta à tela inicial, como em qualquer tela (capítulo 11), e o relógio continua o provisório. Um aparelho que volta de uma falta de energia sem ninguém por perto mostra as leituras, não uma pergunta.
• A pergunta volta a cada boot. O acerto à mão não sobrevive a um reinício, então um aparelho sem rede pergunta de novo sempre que liga.

No mesmo boot, toda imagem escreve no console Sem rede, relogio provisorio: conf time AAAA-MM-DD HH:MM:SS ou, com o aparelho em inglês, No network, provisional clock: conf time YYYY-MM-DD HH:MM:SS. O Air escreve a linha num boot acordado (M0), não num despertar do ciclo. O comando que a linha cita funciona em todas as imagens (No console); no alpha e no Air, que não têm painel, é o jeito de responder à pergunta.

No console

O console de todas as imagens acerta o relógio, pelo USB ou pelo Bluetooth, com time <AAAA-MM-DD> <HH:MM:SS> na hora local; conf time é o mesmo comando (capítulo 14). No console completo, ele vale no modo EXEC e no privilegiado. O comando confere a data como um calendário: o ano vai de 2026 a 2099, e o dia tem de existir no mês. Uma data que o calendário não tem é recusada, e o relógio não muda:

SIMUT> time 2026-02-31 12:00:00
ERROR: Data ou hora invalida (ano >= 2026)

Até a v2.8.0, o comando existia só no console completo, o do Air e das imagens de teste, e conferia cada campo só pela faixa: aceitava qualquer dia de 1 a 31 e levava 2026-02-31 a 03/03/2026, sem aviso. Um campo fora da faixa respondia Valores fora de range (ano >= 2026).

O relógio provisório

Até o primeiro acerto, o aparelho precisa de uma hora para carimbar as medições. Ele usa um relógio provisório:

• No boot: o relógio parte do carimbo do registro mais recente do histórico. O log registra Hora provisória do flash (524) com a data e a hora escolhidas.
• Sem nenhum registro no histórico (aparelho novo ou histórico apagado): o relógio parte de uma data fixa gravada no firmware, 30/07/2026 às 00:00, hora de Brasília.
• Depois: o relógio provisório anda com o oscilador do próprio aparelho.

O relógio provisório fica atrasado pelo tempo em que o aparelho ficou desligado, mais o intervalo entre o último registro gravado e o desligamento. Para um reinício de poucos segundos, o erro é pequeno. Para uma falta de energia de horas, é de horas, e o primeiro acerto corrige (Quando o primeiro acerto corrige o relógio).

Na cópia em flash do bloco aberto, o arquivo /history/.wip, o aparelho guarda se o relógio que carimbou aquele bloco estava acertado ou era provisório. Os blocos selados nos arquivos do dia não guardam essa marca, e a página de histórico, o CSV e os gráficos não distinguem as duas horas. No boot seguinte, um bloco aberto carimbado com o relógio acertado é aceito como semente. Um carimbado com o relógio provisório só é aceito se o carimbo couber no dia do arquivo dele. Isso impede que um relógio provisório errado semeie o próximo e o erro se acumule de um boot para outro.

release Enquanto o relógio em uso é o provisório, o painel marca a data e a hora da barra de cima com ? e as pinta de âmbar (Onde a hora aparece).

Quando o primeiro acerto corrige o relógio

No primeiro acerto depois de um boot, pelo NTP ou à mão (pela interface web, pelo painel ou pelo console), o aparelho compara a hora certa com a do relógio provisório. Se a diferença passa de 5 s:

1. Registra NTP corrigindo timestamps (408), com a diferença em segundos. O texto diz NTP também num acerto à mão.
2. Corrige a hora de cada bloco do histórico que este boot começou, no arquivo do dia e, se um bloco atravessou a meia-noite, no do dia anterior.
3. Registra Timestamps corrigidos (409), com o número de blocos corrigidos. Um número negativo indica falha, e aparece como aviso.
4. Registra Caches de gráfico invalidados (410): gráficos e mínimos e máximos são refeitos com as horas corrigidas.

O resultado é um histórico sem buraco e sem salto: as medições feitas antes do acerto aparecem na hora em que realmente aconteceram.

Detalhes:

• Blocos gravados em sessões anteriores não são tocados: o relógio que os carimbou já tinha sido acertado naquela sessão.
• O bloco aberto que o boot retomou da sessão anterior, a partir do .wip, é selado antes da correção e não é deslocado, nem nos registros que este boot acrescentou a ele: deslocar só uma parte do bloco poderia desordená-lo. A correção vale para os blocos que este boot começou.
• Se alguém está usando o painel, a correção espera 5 s sem toques para começar.
• Se a correção acontece ainda durante o boot, o painel mostra Corrigindo timestamps (NTP)….
• Só o primeiro acerto depois do boot corrige. Um acerto seguinte, à mão ou pelo NTP, muda o relógio dali em diante e não mexe no que já foi gravado.
• Até a v2.8.0, o acerto à mão não corrigia o histórico: os registros gravados antes dele ficavam com as horas do relógio provisório, e só o NTP corrigia.

Com o NTP ligado, a telemetria só começa depois do primeiro acerto, porque o aparelho só termina de entrar na rede depois dele (Sem servidor NTP alcançável).

Onde a hora aparece

O painel marca o relógio provisório. Enquanto nem o NTP nem uma pessoa acertaram o relógio desde o boot, o separador entre a data e a hora passa de - a ?, e a data e a hora ficam em âmbar, como 01/10/26 ? 09:58:12. A marca some no primeiro acerto. Até a v2.8.0, o painel mostrava o relógio provisório do mesmo jeito que o acertado.

Se o fuso do computador é diferente do fuso do aparelho, a hora da interface web difere da do painel. Para comparar, use um computador no mesmo fuso do aparelho.

O relógio do Air através do sono

air

O Air passa a maior parte do tempo hibernando, e o rádio só liga em alguns despertares (capítulo 19). Nos despertares sem rádio, não há NTP: a hora que o histórico grava é a que o próprio Air reconstrói.

Desde a v2.7.2, o Air carrega o relógio através do sono. Ao dormir, ele guarda o instante em que armou o alarme, com milissegundos. Ao acordar, soma a esse instante a duração do sono, medida pelo relógio de hardware, e o tempo de boot já decorrido, incluindo cerca de 140 ms antes de o firmware começar a contar. A hora sai com erro de cerca de ±0,09 s por despertar (medido em bancada em 23/09/2026). Isso vale também no boot com o carregador conectado.

Na v2.7.1, e quando o sono não trouxe uma hora plausível, o Air reconstrói a hora a partir do registro mais recente mais a duração do sono. Esse método perde o fim do despertar anterior e até cerca de 1 s por despertar, e o erro se acumula até o próximo acerto por NTP.

Nos despertares com rádio, o NTP acerta o relógio e corrige o histórico como em qualquer imagem (Quando o primeiro acerto corrige o relógio).

Voltar ao sumário

Capítulo 11

O painel

release Este capítulo percorre o painel de toque da imagem release, tela por tela: a tela inicial, os gestos, o gráfico, o menu de configurações, as telas de boot e as mensagens. É para quem opera o aparelho na bancada ou no laboratório.

O painel em resumo

O painel é uma tela de 320 × 240 pixels com toque resistivo. Ele mostra as leituras, os alarmes e o histórico sem exigir conta nem PIN. O menu de configurações pede a identificação de quem está no painel (capítulo 8).

Três regras valem para todas as telas:

• Um toque é uma ação. Quase tudo responde ao encostar do dedo; a exceção é o toque curto no cartão de cima, que age ao soltar, porque o mesmo dedo pode estar começando o gesto de 3 s. Para repetir, levante o dedo e toque de novo. As setas dos rodapés e do gráfico repetem a cada 300 ms enquanto você segura.
• Um toque pertence à tela onde começou. Se a tela muda com o dedo ainda encostado, o resto do toque é ignorado até você levantar o dedo.
• Sem toque, o painel volta à tela inicial. Depois de 30 s sem nenhum toque, qualquer tela volta à tela inicial (A volta à tela inicial).

O painel não existe nas imagens alpha, que têm um LCD de 16 × 2 (capítulo 12), nem no Air, que não tem tela (capítulo 19).

A tela inicial

A tela inicial tem quatro faixas, de cima para baixo:

A barra de cima

Da esquerda para a direita:

Pendentes. A contagem aparece só quando há registros esperando envio. Até 999 ela mostra o número; de 1.000 em diante, os milhares com um k: 1.500 registros aparecem como 1k. O aparelho atualiza a contagem a cada 10 s. A cor diz como foi o último envio:

A telemetria está no capítulo 21.

Sinal do Wi-Fi. O número de barras acesas segue a intensidade do sinal (RSSI):

O que substitui a data e a hora. Dois avisos ocupam o lugar do relógio enquanto duram:

• Silenciado: e os segundos que faltam, como Silenciado: 97s, durante os 120 s de silêncio de um alarme (capítulo 7).
• Web: e o nome da conta, como Web: admin, por 5 s depois de uma entrada bem-sucedida na interface web. O silêncio tem prioridade sobre esse aviso.

Os cartões

Cada cartão mostra um sensor. O nome dele fica no alto, centralizado; um slot sem nome aparece como Sensor seguido do número do slot. O conteúdo depende do tipo do sensor:

O BME280 mede umidade, mas o cartão mostra a pressão no lugar dela; a umidade dele aparece no gráfico, no detalhe e na interface web. Enquanto não há leitura, o valor aparece como --.-. Um sensor em erro mostra Erro (Error) em letras grandes (capítulo 6).

Mínimo e máximo. Um toque no cartão troca o valor atual pelo mínimo e o máximo do dia: MIN e MAX da temperatura e, no DHT22 e no BME280, também da umidade. No DS18B20 e no BMP280, só da temperatura. À direita aparece o botão de gráfico, com o desenho de três barras, que abre o histórico do sensor (O gráfico). Outro toque fora do botão volta ao valor atual, e o cartão volta sozinho depois de 30 s sem toque.

Os valores de mínimo e máximo vêm do histórico do dia, lido quando o aparelho liga, e das leituras seguintes. Eles não zeram à meia-noite: continuam contando desde o começo do dia em que o aparelho ligou, até o próximo reinício.

O cartão de cima: fixado ou em seleção. O cartão de cima tem dois modos:

• Fixado: mostra sempre o mesmo sensor, que some da barra de botões para não aparecer duas vezes. De fábrica, o cartão de cima fica fixado no slot 0.
• Em seleção: fica cinza, com texto e borda brancos, e mostra o mesmo sensor do cartão de baixo. Serve para escolher qual sensor fixar.

Para fixar outro sensor:

1. Segure o dedo no cartão de cima por 3 s. O painel toca o som de toque e o cartão fica cinza.
2. Toque no botão do sensor na barra de botões.
3. Segure o dedo no cartão de cima por 3 s de novo. O cartão volta à cor normal com o sensor escolhido, e o cartão de baixo passa para outro sensor.

Depois do gesto de 3 s, o cartão de cima ignora toques por 600 ms, enquanto o dedo sobe. O aparelho grava o sensor fixado e o selecionado alguns segundos depois da mudança, e os dois voltam depois de um reinício.

Cartões em alarme. Um sensor em alarme pisca: em vermelho para limite e em âmbar para falha, com a borda alternando. Tocar no cartão que pisca abre a tela de alarme em vez do mínimo e máximo (A tela de alarme). Durante o silêncio de 120 s, os cartões param de piscar e o toque volta ao normal. Com dois ou mais sensores em alarme, o cartão de baixo passa de um para outro a cada 3 s, sem contar o sensor fixado no cartão de cima; essa rotação percorre os slots de 0 a 9. As figuras estão no capítulo 7.

A barra de botões

A barra de botões tem até cinco posições, da esquerda para a direita:

Um sensor ativo ganha um botão, menos o fixado no cartão de cima. CFG vem logo depois do último sensor, então a posição dele muda com o número de sensores. Com mais de cinco botões, a barra se divide em páginas de quatro, e o botão de página fica sempre na quinta posição, à direita.

Nos alarmes, o botão do sensor pisca junto com o cartão. Se um sensor em alarme está noutra página, o botão de página pisca em vermelho; durante o silêncio, ele fica parado, com a borda vermelha.

Quando a web ocupa o aparelho

Algumas operações da interface web leem a memória por vários segundos: os gráficos do histórico, a exportação em CSV, a leitura e a exportação do log de eventos. Enquanto uma delas corre, a barra de cima mostra, em âmbar, WEB ' e o nome da conta, seguidos de ' - toque bloqueado, e a tela inicial ignora os toques. As leituras continuam atualizando. O aviso some sozinho, até um segundo depois de a operação terminar.

O texto desse aviso está sempre em português, seja qual for o idioma do painel.

Gestos e navegação

Na tela inicial:

O toque curto no cartão de cima vale no cartão inteiro e nos dois modos. Enquanto o sensor do cartão de cima está em alarme sem silêncio, o toque abre a tela de alarme e o gesto de 3 s não começa.

O botão de gráfico abre o histórico dos slots 0 a 10. Nos slots 11 a 15, ele só volta o cartão ao valor atual.

Nas outras telas, a navegação segue o mesmo padrão:

• Listas (menu, temas, idiomas): toque numa linha para selecioná-la. As setas do rodapé movem a seleção e dão a volta no fim da lista.
• Rodapé padrão: seta para cima, seta para baixo, SAIR e o botão de ação à direita (ENTRAR, APLICAR ou SALVAR).
• Telas de consulta (gráfico, detalhe, calendário): o X no canto de cima, à direita, fecha.

O gráfico

O gráfico mostra o histórico de um sensor numa janela de tempo. Para abri-lo, ponha o cartão em mínimo e máximo e toque no botão de gráfico. Ele abre na janela de 1 hora que termina agora.

Ao abrir, o painel mostra Carregando… (Loading…) enquanto lê o histórico. Dentro do gráfico, trocar de janela não apaga a tela: uma linha fina na cor de destaque, no alto, avisa que a leitura está em curso, e o gráfico novo substitui o antigo.

O cabeçalho

Um toque no centro do cabeçalho mostra o nome do sensor por 3 s. Sem dados na janela, o texto do centro fica apagado.

A área do gráfico

O aparelho divide a janela em intervalos iguais de tempo, até 200 por janela e nunca menos de 40. Com o histórico gravado a cada minuto, a janela de 1H tem 60 intervalos. Em cada intervalo, ele calcula a média, o mínimo e o máximo das leituras. Na tela:

• Faixa sombreada: vai do mínimo ao máximo de cada intervalo. É a variação real da temperatura dentro dele.
• Linha grossa: a média da temperatura.
• Linha fina: a segunda grandeza, com a escala à direita. É a umidade, no DHT22 e no BME280, ou a pressão, no BMP280.
• Lacunas: um intervalo sem leitura fica em branco, com a largura real do tempo sem dados. Uma leitura isolada entre duas lacunas aparece como um ponto.
• Losangos: um marca o máximo da janela, no alto da faixa, e outro o mínimo, embaixo.
• Círculo no fim: o último valor da temperatura.
• Eixo da esquerda: o máximo, no alto, e o mínimo, embaixo.
• Eixo de baixo: três horários (começo, meio e fim) em hh:mm, ou datas em dd/mm na janela de 7D.