Aprender

Leer un encoder rotatorio KY-040 con un Arduino

Principiante

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: encoder rotatorio KY-040en vivo0.000 s 0.00x
Arrastra la perilla para girarla, y haz clic en ella para cambiar de método
El ejemplo de encoder rotatorio en un ATmega328P simulado. Gira la perilla; presiónala para cambiar la tabla de estados por el método de flanco de bajada.

Un encoder rotatorio es una perilla que gira infinitamente, con un clic en cada paso. A diferencia de un potenciómetro, no tiene inicio ni fin. Tu sketch cuenta los clics y decide qué significan: volumen, una opción de menú o un número en una pantalla. El módulo KY-040 es el que viene en la mayoría de los kits, y también tiene un botón debajo de la perilla.

El circuito de arriba es un Arduino Uno con un KY-040 en los pines 2, 3 y 4, y una lámpara en el pin 9. Gira la perilla y el contador sube o baja, y la lámpara se hace más brillante o más tenue. Presiona la perilla para cambiar a una segunda forma de leerlo, la que imprimen la mayoría de los tutoriales, y observa cómo se equivoca en el conteo. Se ejecuta en tu navegador con el sketch de abajo.

Lo que necesitas

  • Un Arduino Uno
  • Un módulo de encoder rotatorio KY-040
  • Un LED y una resistencia de 220 ohms
  • Una protoboard mediana y cables dupont

Cableado

Componente y pinVa aNota
KY-040 CLKPin 2Una mitad del par en cuadratura
KY-040 DTPin 3La otra mitad
KY-040 SWPin 4El botón; se lee con INPUT_PULLUP
KY-040 +5 VAlimenta las resistencias pull-up del módulo
KY-040 GNDGNDTierra compartida
LEDPin 9A través de una resistencia de 220 ohms a GND

Dos interruptores, a un cuarto de clic de distancia

Dentro del encoder hay dos interruptores, CLK y DT. Al girar la perilla, se abren y cierran con un cuarto de paso de diferencia. Así, el par de lecturas recorre cuatro estados. Girar en sentido horario va 11, 01, 00, 10 y de vuelta a 11. Girar en el otro sentido recorre los mismos estados al revés. La perilla descansa en 11 entre clics.

La dirección en que avanza el par te dice hacia dónde giró la perilla. Esa es toda la idea. Lo único difícil es hacerlo de forma confiable.

Method 1: the state table

Cada vez que el par cambia, el sketch busca el movimiento en una tabla. La tabla contiene los dieciséis movimientos de un estado anterior a uno nuevo. Un cuarto de paso real vale +1 o -1. Un salto de dos estados a la vez vale 0 y se ignora, porque eso es lo que parece un contacto con rebote. Cuando la perilla vuelve a 11 tras cuatro cuartos de paso en un sentido, eso es un clic.

En el circuito de arriba, tres clics en sentido horario imprimen "count 1", "count 2", "count 3". Un clic hacia atrás imprime "count 2". Siempre.

El método de la tabla de estados, del ejemplo de encoder rotatorio
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

La mayoría de los tutoriales usan un método más corto: cuando CLK pasa de HIGH a LOW, lee DT. Si DT es distinto de CLK, cuenta hacia arriba; si no, cuenta hacia abajo. Con un encoder perfectamente limpio, eso funciona.

Los contactos reales de un encoder rebotan. Durante una fracción de segundo después de cerrarse, se abren y cierran de nuevo. Cada rebote en CLK es otro flanco de bajada, y el método corto lo cuenta. Presiona la perilla en el circuito de arriba para cambiar a este método, luego gírala tres clics en sentido horario. En nuestra ejecución imprimió 1, 2, 1, 2, 3, 2, 3, 4, 3: nueve conteos por tres clics, de ida y vuelta, y solo por suerte terminó en 3.

El KY-040 de Mokxi rebota a propósito, porque esa es la lección. Haz clic en las propiedades del encoder y desactiva el rebote, y el método corto contará 1, 2, 3 correctamente. La tabla de estados acierta en ambos casos.

El botón

SW es un botón simple a tierra. El módulo no tiene pull-up para él, así que el sketch usa INPUT_PULLUP. El pin lee LOW cuando se presiona. Aquí, presionarlo cambia de método y reinicia el contador. En tu propio proyecto podría seleccionar una opción de menú.

Errores comunes

Contar cada flanco. Usa la tabla de estados, o una biblioteca que lo haga, para que un rebote no pueda sumar un conteo.

Un loop lento. El sketch debe revisar los pines con frecuencia, cada milisegundo o dos. Un delay() largo en loop() pierde pasos. Las interrupciones en los pines 2 y 3 son otra forma de atrapar cada cambio.

Contar en el punto equivocado. Algunos encoders dan dos o cuatro cambios de estado por clic. Cuenta un clic solo cuando la perilla vuelve al reposo, como hace la tabla de estados.

Olvidar INPUT_PULLUP en SW. Sin él, el pin del botón queda flotando y lee presiones al azar.

Abre este circuito en el editor. Arduino Uno: encoder rotatorio KY-040, conectado tal como se ejecuta al inicio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Cómo conecto un KY-040 a un Arduino Uno?

CLK al pin 2, DT al pin 3, SW al pin 4, + a 5 V y GND a GND. Los pines 2 y 3 también son los pines de interrupción del Uno, lo cual es útil si luego quieres usar interrupciones.

¿Por qué mi encoder rotatorio salta o cuenta dos veces?

Los contactos rebotan, y un sketch que cuenta cada flanco de bajada en CLK cuenta también los rebotes. Usa una tabla de estados, como en esta página, que ignora los rebotes.

¿Encoder rotatorio o potenciómetro?

Un potenciómetro da una posición entre dos extremos. Un encoder da pasos que nunca se acaban. Usa un encoder para menús y para todo lo que deba seguir girando.

¿Qué no modela Mokxi en el KY-040?

La sensación de los clics, y la velocidad. Cada clic llega a una tasa fija sin importar qué tan rápido gires. El rebote es un flanco extra corto por cuarto de paso, siempre el mismo, mientras que un contacto real es menos regular.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.