analogRead()

Contenido

1 Descripción
2 Sintaxis
3 Parámetros
4 Retorno
5 Comentarios
6 Advertencias
7 Ejemplo 1
8 Ejemplo 2
9 Ejemplo 3
10 Vea también
11 Referencias externas

Descripción

Lee el valor de pines analógicos marcados en Arduino como A0~A5, con una resolución de 10 bits. Esta instrucción sólo funciona en los pines (A0~A5).

Tip: Los pines tanto analógicos como digitales de entrada no necesitan ser definidos con pinMode().

Sintaxis

analogRead(pin);

Parámetros

pin: un pin analogico. A0~A5 en Arduino UNO y NANO, A0~A15 en Arduino MEGA.

Retorno

El rango de valores devuelto puede estar entre 0~1023. Numero tipo int.

Comentarios

Si el pin de entrada analógica no está conectado (al aire o flotante), el valor devuelto por analogRead() fluctuará en base a una serie de factores (por ejemplo, los valores de las otras entradas analógicas, lo cerca que tu mano este a la placa, poner un multimetro en paralelo, etc.). Este fenómeno suele ser aprovechado para el valor de inicialización del generador pseudo-aleatorio de números randomSeed().
El rango de entrada y la resolución se pueden cambiar con analogReference().
Se tarda unos 100 microsegundos para leer y codificar una entrada analógica, por lo que la velocidad de lectura máxima es de alrededor de 10,000 veces por segundo.
La frecuencia máxima de lectura de un puerto análogo es de 1,5 Mhz (una cada 660 nano segundos). En comparación las entradas digitales pueden llegar a 15 Mhz (una cada 66 nano segundos), leyendo todas las entradas de forma simultánea.

Tip: Este comando tarda 1775 ciclos de CPU.

Advertencias

No debes dejar al aire estos pines porque generan ruido eléctrico.
La hoja de datos de ATmega también advierte contra el cambio de pines analógicos en proximidad a la realización de lecturas en otros pines analógicos ya que esto puede causar ruido eléctrico e introducir inestabilidad en el sistema analógico.
Puede ser deseable, después de manipular los pines analógicos (en modo digital), agregar un breve retraso antes de usar analogRead() para leer otros pines analógicos.
La placa Arduino UNO contiene 6 canales (8 canales para MINI y NANO, 16 para MEGA), analógicos con convertidor analógico a digital (ADC) de 10 bit. Esto significa que mapeará tensiones de entrada entre 0~5V en valores enteros entre 0~1023. Esto produce una resolución entre las lecturas de 4.9 mV por unidad.
El comando analogRead() no funcionará correctamente si un pin analogico se ha configurado previamente como salida con pinMode(14, OUTPUT), por lo que si este es el caso, configúrelo nuevamente como pinMode(14, INPUT) antes de usar analogRead(). De forma similar, si estando como salida se puso digitalWrite(14, HIGH), la resistencia pull-up se establecerá, cuando se vuelva a configurar como entrada con pinMode(14, INPUT).
Tenga en cuanta que activar la resistencia pull-up afecta las lecturas de analogRead().

pinMode(A0, INPUT_PULLUP);

Ejemplo 1

analogRead(A0);
analogRead(5);

const byte pin = 3;
int valor = analogRead(pin);

Ejemplo 2

void setup(){
   Serial.begin(9600);
}
void loop(){
   Serial.println(analogRead(A2));
}

Ejemplo 3

En este ejemplo medimos el valor de un sensor cada 15 segundos y promediamos las ultimas 5 lecturas.

const byte ventana = 5;
int circularBuffer[ventana];
int* indice = circularBuffer;

long suma;
byte elementos;

float meter(int dato){
   suma -= *indice;
   suma += dato;
   *indice = dato;
   indice++;
   if (indice >= circularBuffer + ventana){
      indice = circularBuffer;
   }
   if (elementos < ventana){
      elementos++;
   }
   return (float) suma / elementos;
}

void setup(){
   Serial.begin(115200);
}

void loop(){
   int x = analogRead(A0);
   Serial.print(x);
   float media = meter(x);
   Serial.print(" promedio\t");
   Serial.println(media);
   delay(15000);
}