Stai collegando un sensore al Raspberry Pi 4 e il filo finisce accanto a due numeri diversi? Il connettore ha 40 pin: il numero fisico identifica la posizione, mentre il nome GPIO identifica il segnale usato nel codice, ma confonderli può portarti sul contatto sbagliato.

Il pin fisico indica la posizione, il GPIO indica il segnale
- Pin 11 = GPIO17: sono due nomi diversi per lo stesso contatto.
- I GPIO lavorano a 3,3 V e non tollerano segnali a 5 V.
- I pin 27 e 28 sono riservati all’identificazione EEPROM degli accessori HAT.
- Il Raspberry Pi 4 non ha ingressi analogici: per leggere un sensore analogico serve un convertitore esterno.
La mappa del connettore distingue subito posizione e funzione
Il connettore GPIO è disposto in due file da 20 contatti. Guardando la scheda nell’orientamento standard, i pin dispari occupano una fila e quelli pari l’altra; per trovare il pin 1, controlla la serigrafia o il diagramma del modello, invece di affidarti alla posizione apparente del cavo.
La tabella riporta insieme il numero fisico e il segnale. Le sigle 3V3, 5V e GND indicano rispettivamente alimentazione a 3,3 V, alimentazione a 5 V e massa; GPIO identifica invece un ingresso/uscita configurabile. La disposizione corrisponde al datasheet del Raspberry Pi 4 Model B.
| Pin fisico dispari | Segnale | Pin fisico pari | Segnale |
|---|---|---|---|
| 1 | 3V3 | 2 | 5V |
| 3 | GPIO2 / SDA | 4 | 5V |
| 5 | GPIO3 / SCL | 6 | GND |
| 7 | GPIO4 | 8 | GPIO14 / TXD |
| 9 | GND | 10 | GPIO15 / RXD |
| 11 | GPIO17 | 12 | GPIO18 |
| 13 | GPIO27 | 14 | GND |
| 15 | GPIO22 | 16 | GPIO23 |
| 17 | 3V3 | 18 | GPIO24 |
| 19 | GPIO10 / MOSI | 20 | GND |
| 21 | GPIO9 / MISO | 22 | GPIO25 |
| 23 | GPIO11 / SCLK | 24 | GPIO8 / CE0 |
| 25 | GND | 26 | GPIO7 / CE1 |
| 27 | ID_SD / GPIO0 | 28 | ID_SC / GPIO1 |
| 29 | GPIO5 | 30 | GND |
| 31 | GPIO6 | 32 | GPIO12 |
| 33 | GPIO13 | 34 | GND |
| 35 | GPIO19 | 36 | GPIO16 |
| 37 | GPIO26 | 38 | GPIO20 |
| 39 | GND | 40 | GPIO21 |
Le funzioni dopo la barra, come SDA o MOSI, sono modalità alternative del GPIO, non contatti aggiuntivi. Un pin può svolgere funzioni diverse in base alla configurazione, quindi controlla anche ciò che richiede il sensore o la scheda accessoria.
Il numero BCM evita un errore comune nel codice
Un filo sul contatto fisico 3 non va chiamato GPIO3: quel contatto porta GPIO2, usato come SDA per I²C. GPIO3 si trova invece sul pin fisico 5 e svolge la funzione SCL. La somiglianza dei nomi trae facilmente in inganno, soprattutto quando uno schema mostra i numeri fisici e un esempio di programma usa quelli BCM.
Il caso tipico: colleghi un pulsante al pin fisico 11. Nel codice, se la libreria usa la numerazione BCM, indichi GPIO17, non 11. Ritengo più chiari gli schemi che riportano entrambe le etichette, ad esempio «fisico 11 / GPIO17»: così cablaggio e codice restano leggibili anche quando li consulti separatamente.
Le sigle aiutano anche a riconoscere le interfacce seriali più usate. Per I²C trovi SDA e SCL sui pin fisici 3 e 5; per SPI0, MOSI, MISO e SCLK corrispondono ai pin 19, 21 e 23. La coppia TXD e RXD per UART si trova sui pin 8 e 10: prima di usarla, verifica che il dispositivo collegato accetti livelli logici a 3,3 V.Con Arduino UNO il collegamento diretto a 5 V può danneggiare il Pi
Il pin 2 o il pin 4 del connettore forniscono 5 V, ma questo non rende tolleranti a 5 V gli ingressi GPIO vicini. I segnali GPIO del Raspberry Pi 4 lavorano a 3,3 V; la documentazione ufficiale avverte che applicare direttamente 5 V può danneggiare il SoC.
Questo punto emerge spesso quando si collega un Arduino UNO R3: la scheda ha un’uscita logica a 5 V, mentre i GPIO del Pi richiedono livelli compatibili con 3,3 V. Se il segnale parte dall’UNO e arriva al Pi, inserisci un convertitore di livello logico; se il collegamento è I²C, scegli una soluzione bidirezionale adatta al bus e controlla anche le resistenze di pull-up. Il manuale hardware Raspberry Pi descrive i limiti elettrici e le funzioni dei pin.| Situazione | Possibile problema | Cosa fare |
|---|---|---|
| Un’uscita Arduino UNO R3 a 5 V entra in un GPIO del Pi | Il GPIO non è tollerante a 5 V | Interporre un convertitore di livello compatibile |
| Un sensore analogico è collegato a un GPIO | Il Pi non converte direttamente una tensione analogica in un valore digitale | Aggiungere un ADC, cioè un convertitore analogico-digitale, o leggere il sensore tramite un microcontrollore |
| Il componente è un motore o un relè | Il GPIO non è un’uscita di potenza per carichi induttivi | Usare un driver o un modulo adatto e alimentare il carico secondo le sue specifiche |
| Si vuole usare un HAT con EEPROM | I pin 27 e 28 sono dedicati all’identificazione dell’accessorio | Lasciarli riservati e seguire le indicazioni del produttore del HAT |
I pin 27 e 28 non sono contatti liberi per un progetto generico
La coppia identificata come ID_SD e ID_SC, sui pin fisici 27 e 28, serve a interrogare la memoria EEPROM di identificazione di una scheda HAT. Il datasheet del Pi 4 la riserva a questo scopo e indica di lasciarla scollegata quando non serve l’EEPROM.
La distinzione è più utile di una semplice lista di pin disponibili: un contatto può sembrare un normale GPIO, ma avere una funzione assegnata durante l’avvio. Se stai costruendo un accessorio HAT, segui la specifica del componente; per un circuito indipendente, scegli un altro GPIO e annota nel progetto sia il numero fisico sia quello BCM.
Per il cablaggio controlla prima orientamento e tensione
Un diagramma corretto non basta se lo guardi dal lato sbagliato: un flat cable osservato dall’estremità opposta può invertire la disposizione visiva. Prima di alimentare il circuito, individua pin 1 sulla scheda e confronta la numerazione con il diagramma, non con l’orientamento intuitivo dei fili.
Per un pulsante o un LED puoi partire da un GPIO libero e da GND, configurando il pin nel software; per un LED inserisci anche una resistenza in serie. Se il progetto coinvolge segnali a 5 V, ingressi analogici, motori o i pin ID, fermati prima del collegamento diretto e scegli l’interfaccia appropriata: sono proprio questi casi a trasformare una mappa utile in un cablaggio rischioso.