Debug di un sistema Embedded

Quante volte le cose non funzionano come vorremmo?
Nel tentare di trovare il problema entriamo in dettagli tali che in testa abbiamo l´intera soluzione nei minimi dettagli.
Quando però cerchiamo di spiegare cosa abbiamo fatto, l´esperienza e dettagli che abbiamo raggiunto sono tali per cui ci scordiamo che i nostri interlocutori non sanno nulla di quello che stiamo facendo e una frase che sembra racchiudere un problema in realtà ha meno dettagli di quanto non crediamo.

Quando si coinvolgono altre persone al fine di poter risolvere un problema e´ bene tenere a mente i seguenti punti e fare in modo che i dettagli necessari siano forniti.

Un esempio di domanda mal posta potrebbe essere:
Sto cercando di far lampeggiare un LED ma non funziona, cosa può essere?

Cerchiamo di dare le informazioni necessarie per coinvolgere e far comprendere agli altri cosa si sta facendo e gli strumenti che si stanno usando. Quanto segue non necessariamente deve essere fornito per intero ma vi dovrebbe far pensare su quello che e' necessario fornire.
Altri punti che non mi sono venuti in mente possono essere aggiunti e li aggiungerò...


Applicazione

• Qualche nota su quello che state facendo o cercate di fare.
• Se state cercando di riprodurre un lavoro di altri fornite il link al progetto/lavoro.

Hardware

• Usate un microcontrollore, quale? (Es. PIC18F4550, PIC16F877…)
• Usate altri integrati, quali …?
• Usate una scheda di sviluppo, quale …?
• Che versione della scheda di sviluppo? (Es. Freedom II ver. 3)
• Che alimentatore/tensione usate?
• Usate una Breadboard, una mille fori?
• Fornite lo schema elettrico di quello che state realizzando.

Software

• Che ambiente di sviluppo usate? (Es. MPLAB X, MPLAB IDE)
• Che versione dell´ambiente di sviluppo?
• Che sistema Operativo Usate? (Window XP, Windows 7, Linux, 32 64 bit …)
• Quale compilatore usate? (Es. C18, C30, XC8, X16, XC32)
• Che versione usate del compilatore?
• Usate una libreria software? (Es. LaurTec per PIC18)
• Che versione della libreria usate?
• Se avete errori di compilazione, fornite il testo dell´errore?
• Fornite il codice, segnalando dove avviene l´errore.

Note

• Evitate codici lunghi che non leggerà nessuno e cercate di riprodurre l´errore/problema in poche linee di codice.
• Quando montate manualmente un sistema embedded il problema potrebbe essere sia hardware che software, per cui non sottovalutate ne’ i punti Software che Hardware

Saluti,

Mauro