ericyeargan/esp32-rotary-encoder

ESP32-compatible rotary encoder driver

esp32-rotary-encoder

Introduction

This ESP32 component uses a debouncing state machine to track the position of an incremental rotary encoder such as the EC11 or LPD3806.

These encoders provide two outputs (typically "A" and "B") that have a quadrature relationship - that is, they oscillate between high and low as the shaft rotates, but with a 90 degree phase offset. Therefore the outputs AB may go through the following pattern: 00, 10, 11, 01, 00 ... The direction can be determined by observing the order of this pattern. This component uses a state machine to decode the sequence of quadrature states, and therefore provides a fairly glitch-free and accurate measurement of the encoder's movement.

Interrupts are registered on the A and B pins to detect edges. This component assumes that gpio_install_isr_service() has been called prior.

The direction event is placed into a FreeRTOS queue and can be used by a task to increment or decrement a counter that represents the encoder's absolute position.

Encoders that provide a push button are supported, however this component does not provide direct support for the button. Typically, the button is normally open and pushing it closes the contacts, which can be used to pull a GPIO pin high or low depending on arrangement. This can be detected with a normal GPIO poll or interrupt.

Dependencies

It is written and tested for v3.0-v3.2 of the ESP-IDF environment, using the xtensa-esp32-elf toolchain (gcc version 5.2.0). It may or may not work with older or newer versions.

Example

An example application that uses this component is available: esp32-rotary-encoder-example

Features

• Publication of an event into a user-supplied queue when the encoder moves to either a full or half step:
  • Full step mode, where the encoder must move through an entire sequence of four steps before an event is published.
  • Half step mode, where the encoder must move through half an entire sequence (two steps) before an event is published.

Documentation

Automatically generated API documentation is available here.

Source Code

The source is available from GitHub.

License

The code in this project is licensed under the GNU GPL Version 3, or (at your option) any later version. - see LICENSE for details.

Links

• esp32-rotary-encoder-example
• Espressif IoT Development Framework for ESP32

Acknowledgements

Thank you to Ben Buxton who provided the original Arduino code that this component is based upon.