Descrição

Lê o valor de um pino analógico especificado. A placa Arduino contém um conversor analógico-digital de 10 bits com 6 canais (8 canais no Mini e no Nano). Com isto ele pode mapear voltagens de entrada entre 0 e 5 volts para valores inteiros entre 0 e 1023. Isto permite uma resolução entre leituras de 5 volts / 1024 unidades ou 0,0049 volts (4.9 mV) por unidade.

São necessários aproximadamente 100 μs (0.0001 s) para ler uma entrada analógica, portanto a velocidade máxima de leitura é de aproximadamente 10.000 vezes por segundo.

Sintaxe

analogRead(pin)

Parâmetros

pin: o número do pino analógico que se deseja ler (0 a 5 na maioria das placas, 0 ta 7 no Mini e no Nano)

Retorno

int (0 a 1023)

Note

Se o pino analógico não estiver conectado a nada o valor de retorno do analogRead() vai variar de acordo com uma grande quantidade de fatores (e.g. os valores de outras entradas analógicas, a distância de sua mão à placa, etc.). Na prática é um valor aleatório.

Exemplo

 
int analogPin = 3;     // perna do meio de um potenciómetro conectada ao pino analógico 3
                       // pernas externas conectadas ao terra e ao +5V
int val = 0;           // variável para armazenar o valor lido
void setup()
{
  Serial.begin(9600);          //  inicial a comunicação serial
}

void loop()
{
  val = analogRead(analogPin);    // lê o pino de entrada
  Serial.println(val);             // informa o valor lido 
}

See also

• analogWrite()
• Tutorial: Pinos de entrada analógica

Página de início da referência

Correções, sugestões, e nova documentação devem ser enviadas ao Forum.

O texto de referência do Arduino está baixo uma Licença Creative Commons Attribution-ShareAlike 3.0. Amostras de código utilizadas na referência foram deixados  ao domínio público.

O conteúdo desta página é uma tradução para o português a partir do site original do Arduino.