Aprender

Leia um encoder rotativo KY-040 com um Arduino

Iniciante

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: encoder rotativo KY-040ao vivo0.000 s 0.00x
Arraste o botão giratório para girá-lo, e clique nele para trocar de método
O exemplo Rotary encoder em um ATmega328P simulado. Gire o botão; aperte-o para trocar a tabela de estados pelo método de borda de descida.

Um encoder rotativo é um botão que gira para sempre, com um clique a cada passo. Diferentemente de um potenciômetro, ele não tem começo nem fim. Seu sketch conta os cliques e decide o que eles significam: volume, uma escolha de menu ou um número em um display. O módulo KY-040 é o que vem na maioria dos kits, e também tem um botão de apertar embaixo do botão giratório.

O circuito acima é um Arduino Uno com um KY-040 nos pinos 2, 3 e 4, e uma lâmpada no pino 9. Gire o botão e a contagem sobe ou desce, e a lâmpada fica mais clara ou mais fraca. Aperte o botão giratório para mudar para uma segunda forma de leitura, a que a maioria dos tutoriais imprime, e veja a contagem sair errada. Ele roda no seu navegador com o sketch abaixo.

O que você precisa

  • Um Arduino Uno
  • Um módulo encoder rotativo KY-040
  • Um LED e um resistor de 220 ohms
  • Uma protoboard de meio tamanho e fios jumpers

Ligação

Componente e pinoVai paraNota
KY-040 CLKPino 2Uma metade do par em quadratura
KY-040 DTPino 3A outra metade
KY-040 SWPino 4O botão de apertar; lido com INPUT_PULLUP
KY-040 +5 VAlimenta os resistores de pull-up do módulo
KY-040 GNDGNDTerra compartilhado
LEDPino 9Por um resistor de 220 ohms até o GND

Dois interruptores, um quarto de clique de diferença

Dentro do encoder há dois interruptores, CLK e DT. Conforme você gira o botão, eles abrem e fecham com um quarto de passo de diferença. Assim, o par de leituras percorre quatro estados. Girar no sentido horário vai de 11, 01, 00, 10 e volta a 11. Girar no outro sentido percorre os mesmos estados na ordem inversa. O botão descansa em 11 entre os cliques.

O sentido em que o par percorre os estados diz o sentido em que o botão girou. Essa é toda a ideia. A única parte difícil é fazer isso de forma confiável.

Method 1: the state table

Toda vez que o par muda, o sketch procura o movimento em uma tabela. A tabela guarda os dezesseis movimentos possíveis de um estado antigo para um novo. Um quarto de passo de verdade vale +1 ou -1. Um salto de dois estados de uma vez vale 0 e é ignorado, porque é isso que um contato com bounce parece. Quando o botão volta a 11 com quatro quartos de passo no mesmo sentido, isso é um clique.

No circuito acima, três cliques no sentido horário imprimem "count 1", "count 2", "count 3". Um clique de volta imprime "count 2". Sempre.

O método da tabela de estados, do exemplo Rotary encoder
const int8_t STEP[16] = {
    0, -1, 1, 0,   // from 00
    1, 0, 0, -1,   // from 01
    -1, 0, 0, 1,   // from 10
    0, 1, -1, 0,   // from 11
};

uint8_t pair() {
  return (uint8_t)((digitalRead(CLK) << 1) | digitalRead(DT));
}

// in loop():
uint8_t now = pair();
if (now != state) {
  quarters += STEP[(state << 2) | now];
  state = now;
  if (now == 3) {
    if (quarters >= 4) count++;
    if (quarters <= -4) count--;
    quarters = 0;
  }
}

Method 2: the falling edge, and why it miscounts

A maioria dos tutoriais usa um método mais curto: quando CLK vai de HIGH para LOW, leia DT. Se DT for diferente de CLK, conte para cima; senão, conte para baixo. Em um encoder perfeitamente limpo, isso funciona.

Contatos de encoder reais têm bounce. Por uma fração de segundo depois de fecharem, eles abrem e fecham de novo. Cada bounce em CLK é mais uma borda de descida, e o método curto o conta. Aperte o botão giratório no circuito acima para mudar para esse método, depois gire três cliques no sentido horário. Na nossa rodada ele imprimiu 1, 2, 1, 2, 3, 2, 3, 4, 3: nove contagens para três cliques, indo e voltando, e só por sorte terminando em 3.

O KY-040 do Mokxi tem bounce de propósito, porque essa é a lição. Clique nas propriedades do encoder e desligue o bounce, e o método curto conta 1, 2, 3 corretamente. A tabela de estados acerta de qualquer jeito.

O botão de apertar

SW é um botão simples ligado ao terra. O módulo não tem pull-up para ele, então o sketch usa INPUT_PULLUP. O pino lê LOW quando apertado. Aqui, um aperto troca de método e zera a contagem. No seu próprio projeto, ele poderia selecionar um item de menu.

Erros comuns

Contar toda borda. Use a tabela de estados, ou uma biblioteca que faça isso, para que um bounce não possa somar uma contagem.

Um loop lento. O sketch precisa ler os pinos com frequência, a cada um ou dois milissegundos. Um delay() longo em loop() perde passos. Interrupções nos pinos 2 e 3 são outra forma de capturar cada mudança.

Contar no lugar errado. Alguns encoders dão duas ou quatro mudanças de estado por clique. Conte um clique só quando o botão voltar ao repouso, como a tabela de estados faz.

Esquecer o INPUT_PULLUP em SW. Sem ele, o pino do botão fica flutuando e lê apertos aleatórios.

Abra este circuito no editor. Arduino Uno: encoder rotativo KY-040, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Como faço para ligar um KY-040 a um Arduino Uno?

CLK no pino 2, DT no pino 3, SW no pino 4, + no 5 V e GND no GND. Os pinos 2 e 3 também são os pinos de interrupção do Uno, o que é útil se você quiser usar interrupções depois.

Por que meu encoder rotativo pula ou conta duas vezes?

Os contatos têm bounce, e um sketch que conta toda borda de descida em CLK conta os bounces também. Use uma tabela de estados, como nesta página, que ignora o bounce.

Encoder rotativo ou potenciômetro?

Um potenciômetro dá uma posição entre duas extremidades. Um encoder dá passos que nunca acabam. Use um encoder para menus e para tudo que devia continuar girando.

O que o Mokxi não modela no KY-040?

A sensação dos cliques, e a velocidade. Cada clique chega em um ritmo fixo, não importa o quão rápido você gire. O bounce é uma borda extra curta por quarto de passo, sempre igual, enquanto um contato real é menos regular.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.