3.- Definizione degli I/O

Abbiamo stabilito quale microcontroller intendiamo impiegare, ora può essere utile fornire qualche informazione su come è collegato il processore, l' uso degli I/O, ecc. Tutte queste informazioni servono non solo a chi legge, ma anche a se stessi per avere le idee chiare sulle risorse disponibili e su come usarle.

Una cosa che quasi sempre manca in un sorgente è: come sono collegati i pin. Non si tratta di una informazione trascurabile, in quanto può evitare di avere l' obbligo di accompagnare il tutto con uno schema elettrico o comunque rende chiaro perchè un pin sia programmato come uscita oppure come ingresso. 

Vediamo un esempio in forma "grafica" (per quanto possibile in editor di testo).
Siccome i pin solitamente hanno più funzioni assegnabile, sono riportate le alternative, il che evita la necessità di consultare il foglio dati.

Anche qui si tratta di un' area di solo testo di commento, indifferente per la compilazione, ma la cui presenza rende quasi superfluo uno schema elettrico. Anche qui, forma e struttura sono ampiamente modificabili.
La sua utilità sta nella possibilità di rendersi conto con una sola occhiata delle risorse disponibili, della loro collocazione e del loro impiego nel progetto.

Questa sezione può essere validamente completata da una mappatura degli I/O con relative label, che serviranno rendere più pratico il sorgente. Anche qui possiamo ricorre ad una forma semi-grafica che è ben esplicativa:

Qui si inizia a valutare l' utilità della colorazione del testo operata dagli editor adeguati: il template è, inizialmente, un foglio millimetrato vuoto, da adattare alla propria esigenza.

Qui, ad esempio, de-commentando le righe che si intendono usare ed aggiungendo quanto necessario, il testo base si trasformerà da un puro commento ad un un elemento della compilazione.

Ovviamente le parti inutilizzate potranno essere eliminate; in ogni caso, la presenza di linee ancora commentate rende visibile la disponibilità potenziale di altre possibilità.