encoder: HW timer-based driver for incremental rotary encoders

Enums

enum rotary_encoder_btn_state_t

Button state.

Values:

enumerator RE_BTN_RELEASED

Button currently released.

enumerator RE_BTN_PRESSED

Button currently pressed.

enumerator RE_BTN_LONG_PRESSED

Button currently long pressed.

enum rotary_encoder_event_type_t

Event type.

Values:

enumerator RE_ET_CHANGED

Encoder turned.

enumerator RE_ET_BTN_RELEASED

Button released.

enumerator RE_ET_BTN_PRESSED

Button pressed.

enumerator RE_ET_BTN_LONG_PRESSED

Button long pressed (press time (us) > RE_BTN_LONG_PRESS_TIME_US)

enumerator RE_ET_BTN_CLICKED

Button was clicked.

Functions

esp_err_t rotary_encoder_init(QueueHandle_t queue)

Initialize library.

Parameters:

queue – Event queue to send encoder events

Returns:

ESP_OK on success

esp_err_t rotary_encoder_add(rotary_encoder_t *re)

Add new rotary encoder.

Parameters:

re – Encoder descriptor

Returns:

ESP_OK on success

esp_err_t rotary_encoder_remove(rotary_encoder_t *re)

Remove previously added rotary encoder.

Parameters:

re – Encoder descriptor

Returns:

ESP_OK on success

esp_err_t rotary_encoder_enable_acceleration(rotary_encoder_t *re, uint16_t coeff)

Enable acceleration on the rotary encoder.

Parameters:

re – Encoder descriptor

coeff – Acceleration coefficient. Higher value means faster acceleration

Returns:

esp_err_t

esp_err_t rotary_encoder_disable_acceleration(rotary_encoder_t *re)

Disable acceleration on the rotary encoder.

Parameters:

re – Encoder descriptor

Returns:

ESP_OK on success

struct rotary_encoder_acceleration_t

#include <encoder.h>

Public Members

int64_t last_time

uint16_t coeff

struct rotary_encoder_t

#include <encoder.h>

Rotary encoder descriptor.

Public Members

gpio_num_t pin_a

gpio_num_t pin_b

gpio_num_t pin_btn

Encoder pins.

pin_btn can be >= GPIO_NUM_MAX if no button used

uint8_t code

uint16_t store

size_t index

uint64_t btn_pressed_time_us

rotary_encoder_btn_state_t btn_state

rotary_encoder_acceleration_t acceleration

struct rotary_encoder_event_t

#include <encoder.h>

Event.

Public Members

rotary_encoder_event_type_t type

Event type.

rotary_encoder_t *sender

Pointer to descriptor.

int32_t diff

Difference between new and old positions (only if type == RE_ET_CHANGED)