Retrieve current pin mode

There is currently no function to get the current pin mode. A possible implementation is:

```
int pinMode(uint8_t pin)
{
if (pin >= NUM_DIGITAL_PINS) return (-1);

uint8_t bit = digitalPinToBitMask(pin);
uint8_t port = digitalPinToPort(pin);
volatile uint8_t *reg = portModeRegister(port);
if (*reg & bit) return (OUTPUT);

volatile uint8_t *out = portOutputRegister(port);
return ((*out & bit) ? INPUT_PULLUP : INPUT);
}
```

The return value is the pin mode or error code (-1) for illegal pin number.

Cheers!

Inizia con l’API pinMode esistente e con gli entry point digitalPinToBitMask, digitalPinToPort, portModeRegister e portOutputRegister mostrati nell’issue. Verifica in che modo l’API indipendente dall’hardware espone le operazioni sui pin e in che modo i core le implementano. Il lavoro è completo quando è possibile recuperare la modalità corrente di un pin, vengono restituite le modalità specificate e viene restituito -1 per un pin non valido.

Scritto dal modello di indicizzazione a partire dal testo della issue.