Analog ports can operate at a range of voltages between 0 and 3.3V, which is especially useful when reading analog sensors that supply their data as a voltage reading, rather than a digital signal which is represented as binary on or off.
Analog signals are written or read with a 10-bit resolution, which means that they can have value of 0 to 1023.
While the Analog IO is meant for up to 3.3V, the ports are actually 5V tolerant, meaning that they can take up to 5v of input without burning out the port. However, any voltage above 3.3V will simply read as the max value (1023). In order to use 5V peripherals, a special resistor circuit known as a Voltage Divider should be used. Voltage divider circuits are very simple to make with two resistors.
Reading Analog Input
The Potentiometer Controlled RGB LED sample illustrates how to use an analog input to read the value of a potentiometer.
The salient code is as follows; first, an
AnalogInput port is created with the appropriate pin:
var pot = new SecretLabs.NETMF.Hardware.AnalogInput(Pins.GPIO_PIN_A1);
The input port value can be automatically transformed to return a value within a particular range. In the case of the sample, the analog input will represent a degree of Hue, so the range is set to 0 to 360:
The port value is then accessed via the
hue = pot.Read();
These docs are open source. If you find an issue, please file a bug, or send us a pull request. And if you want to contribute, we'd love that too!