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
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.