HOWTO · Arduino

Resistor Pull-Down do Arduino

Aprenda a ligar um resistor pull-down e um interruptor no Arduino, escolher um valor de resistor e ler a entrada num sketch.

Nesta página

Para ligar um resistor pull-down num Arduino, conecte um resistor entre um ponto de junção da entrada digital e o GND, e depois conecte um interruptor entre esse ponto de junção e uma tensão de alimentação compatível com o pino de entrada da placa. A entrada lê LOW enquanto o interruptor está aberto e HIGH enquanto está fechado. Use 5V apenas quando a entrada da placa tolerar 5V; uma entrada apenas de 3,3V precisa de uma alimentação compatível de 3,3V. Este guia explica a ligação, a escolha do resistor e o código para ler o interruptor.

Por que é necessário um resistor pull-down

Uma entrada de microcontrolador consome muito pouca corrente. Quando um interruptor deixa a entrada desconectada, o ruído elétrico pode alterar a sua tensão e produzir leituras imprevisíveis; isto chama-se entrada flutuante. Um resistor pull-down conecta a entrada ao GND enquanto o interruptor está aberto, mantendo-a em LOW. Fechar o interruptor conecta o mesmo ponto de junção da entrada à alimentação da placa, por isso o pino lê HIGH.

Ligar um resistor pull-down externo a uma entrada digital

Monte o circuito de forma que o pino de entrada, um terminal do interruptor e um terminal do resistor se encontrem num único ponto de junção:

  1. Escolha uma tensão de alimentação que o pino de entrada da placa possa aceitar com segurança. Conecte um terminal de um botão de pressão ou interruptor a essa alimentação. Use o pino de 5V da placa apenas se a entrada tolerar 5V; para uma entrada apenas de 3,3V, use uma alimentação compatível de 3,3V.
  2. Conecte o outro terminal do interruptor ao pino digital 2. Este ponto é o ponto de junção da entrada.
  3. Conecte um resistor desse ponto de junção ao GND.

O artigo de origem indica 1 kΩ a 100 kΩ como intervalo inicial. O valor adequado depende da placa e do circuito, por isso verifique as especificações elétricas da placa e tenha em conta os requisitos de ruído e de corrente. Uma resistência muito baixa pode permitir uma corrente excessiva através do interruptor quando este fecha. O resistor pertence entre o ponto de junção da entrada e o GND; não conecte a alimentação diretamente ao GND. No diagrama abaixo, o rótulo +5V aplica-se apenas quando a entrada da placa tolera 5V. Caso contrário, use nessa conexão do interruptor uma tensão de alimentação compatível com a placa.

Circuit diagram showing a switch from a board-compatible supply to the input junction and a pull-down resistor from the junction to GND; the diagram’s +5V label is for 5V-tolerant inputs only

Ler o interruptor num sketch do Arduino

Defina o modo do pino como INPUT e leia o interruptor com digitalRead. Este sketch completo imprime uma mensagem para cada estado do interruptor. A pequena secção de compatibilidade permite que o mesmo código-fonte seja compilado como uma demonstração do lado do anfitrião; no IDE do Arduino, o núcleo da placa fornece esses nomes e o IDE fornece o ponto de entrada do programa. A demonstração do lado do anfitrião usa uma leitura fixa HIGH, por isso a linha impressa ilustra o ramo do interruptor fechado; não testa hardware.

#ifndef ARDUINO
#include <iostream>
constexpr int INPUT = 0;
constexpr int LOW = 0;
constexpr int HIGH = 1;
struct SerialPort {
  void begin(long) {}
  void println(const char* message) { std::cout << message << '\n'; }
} Serial;
void pinMode(int, int) {}
int digitalRead(int) { return HIGH; }
void delay(unsigned long) {}
#endif

const int switchPin = 2;

void setup() {
  pinMode(switchPin, INPUT);
  Serial.begin(9600);
}

void loop() {
  int switchState = digitalRead(switchPin);
  if (switchState == HIGH) {
    Serial.println("Switch closed");
  } else {
    Serial.println("Switch open");
  }
  delay(200);
}

#ifndef ARDUINO
int main() {
  setup();
  loop();
}
#endif
Switch closed

Com o pull-down externo ligado conforme descrito, digitalRead retorna LOW para um interruptor aberto e HIGH para um interruptor fechado. Coloque a ação de cada estado no seu ramo correspondente. Para mais lógica condicional, consulte Declaração if do Arduino. Se o seu sketch precisar de esperar por uma ação do utilizador, consulte Como esperar por uma entrada no Arduino.

Usar uma entrada analógica com um resistor pull-down externo

Pode conectar o mesmo circuito a uma entrada analógica como A0 em vez de um pino digital. Mantenha o resistor entre o ponto de junção da entrada e o GND, e conecte o interruptor entre esse ponto de junção e uma tensão de alimentação compatível com a entrada analógica. Use 5V apenas se essa entrada tolerar 5V. A leitura analógica fica perto da extremidade de terra da gama com o interruptor aberto e sobe em direção à leitura da alimentação da placa quando o interruptor fecha. As contagens exatas dependem do conversor analógico-digital da placa e da tensão de referência.

Num sketch do Arduino, leia o pino com analogRead e compare o resultado com um limiar escolhido para a placa e o circuito. Por exemplo, a condição reading >= threshold representa o interruptor fechado quando o interruptor conecta o ponto de junção à alimentação. Escolha o limiar a partir de medições; um valor como 512 não é adequado para todas as configurações. Este exemplo analógico é específico da placa e não está incluído na demonstração do lado do anfitrião acima.

Usar o pull-up interno como alternativa

Um pull-up interno é um circuito alternativo, e não um pull-down externo. Usa o resistor incorporado do microcontrolador. Conecte o interruptor entre a entrada digital e o GND, e depois configure o pino com INPUT_PULLUP. O interruptor aberto lê HIGH; pressioná-lo conecta o pino ao GND e lê LOW, invertendo a lógica do pull-down externo.

No sketch do Arduino, use pinMode(switchPin, INPUT_PULLUP) e trate digitalRead(switchPin) == LOW como o estado pressionado. Este comportamento depende do núcleo do Arduino e da ligação física, pelo que não é representado pela demonstração do lado do anfitrião acima.