---
title: analogRead()
categories: [ "Functions" ]
subCategories: [ "Analog I/O" ]
---

= analogRead()

// OVERVIEW SECTION STARTS
[#overview]
--

[float]
=== Description
Reads the value from the specified analog pin. Arduino boards contain a multichannel, 10-bit analog to digital converter. This means that it will map input voltages between 0 and the operating voltage(5V or 3.3V) into integer values between 0 and 1023. On an Arduino UNO, for example, this yields a resolution between readings of: 5 volts / 1024 units or, 0.0049 volts (4.9 mV) per unit. See the table below for the usable pins, operating voltage and maximum resolution for some Arduino boards.

The input range can be changed using link:../analogreference[analogReference()], while the resolution can be changed (only for Zero, Due and MKR boards) using link:../../zero-due-mkr-family/analogreadresolution[analogReadResolution()].

On ATmega based boards (UNO, Nano, Mini, Mega), it takes about 100 microseconds (0.0001 s) to read an analog input, so the maximum reading rate is about 10,000 times a second.

[options="header"]
|===================================================
|Board                            |Operating voltage |Usable pins |Max resolution
|UNO R3                           |5 Volts           |A0 to A5    |10 bits
|UNO R4 (Minima, WiFi)            |5 Volts           |A0 to A5    |14 bits**
|Mini                             |5 Volts           |A0 to A7    |10 bits
|Nano, Nano Every                 |5 Volts           |A0 to A7    |10 bits
|Nano 33 (IoT, BLE, RP2040, ESP32)|3.3  Volts        |A0 to A7    |12 bits**
|Mega, Mega2560, MegaADK          |5 Volts           |A0 to A14   |10 bits
|Micro                            |5 Volts           |A0 to A11*  |10 bits
|Leonardo                         |5 Volts           |A0 to A11*  |10 bits
|Zero                             |3.3 Volts         |A0 to A5    |12 bits**
|Due                              |3.3 Volts         |A0 to A11   |12 bits**
|GIGA R1                          |3.3 Volts         |A0 to A11   |16 bits**
|MKR Family boards                |3.3 Volts         |A0 to A6    |12 bits**
|===================================================

*A0 through A5 are labelled on the board, A6 through A11 are respectively available on pins 4, 6, 8, 9, 10, and 12 +
**The default `analogRead()` resolution for these boards is 10 bits, for compatibility. You need to use link:../../zero-due-mkr-family/analogreadresolution[analogReadResolution()] to change it to a higher resolution.

[%hardbreaks]

[float]
=== Syntax
`analogRead(pin)`


[float]
=== Parameters
`pin`: the name of the analog input pin to read from.


[float]
=== Returns
The analog reading on the pin. Although it is limited to the resolution of the analog to digital converter (0-1023 for 10 bits or 0-4095 for 12 bits). Data type: `int`.

--
// OVERVIEW SECTION ENDS


// HOW TO USE SECTION STARTS
[#howtouse]
--

[float]
=== Example Code
// Describe what the example code is all about and add relevant code   ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄
The code reads the voltage on analogPin and displays it.

[source,arduino]
----
int analogPin = A3; // potentiometer wiper (middle terminal) connected to analog pin 3
                    // outside leads to ground and +5V
int val = 0;  // variable to store the value read

void setup() {
  Serial.begin(9600);           //  setup serial
}

void loop() {
  val = analogRead(analogPin);  // read the input pin
  Serial.println(val);          // debug value
}
----
[%hardbreaks]

[float]
=== Notes and Warnings
If the analog input pin is not connected to anything, the value returned by `analogRead()` will fluctuate based on a number of factors (e.g. the values of the other analog inputs, how close your hand is to the board, etc.).

--
// HOW TO USE SECTION ENDS


// SEE ALSO SECTION
[#see_also]
--

[float]
=== See also

[role="language"]
* #LANGUAGE# link:../../zero-due-mkr-family/analogreadresolution[analogReadResolution()]
* #EXAMPLE# http://arduino.cc/en/Tutorial/AnalogInputPins[Description of the analog input pins^]
--
// SEE ALSO SECTION ENDS