Skip to main content

A rotary encoder library for the raspberry pi that "just works"

Project description

Rotary Encoder

A rotary encoder package for the Raspberry pi that "just works".

Tested with a KY-040 Rotary Encoder on a Raspberry pi 3 B+

Installation

Install via pip:

pip install rpi-rotary-encoder

Example

import rotary_encoder


counter = 0

def increment():
    global counter
    counter += 1
    print(counter)


def decrement():
    global counter
    counter -= 1
    print(counter)


with rotary_encoder.connect(
    clk_pin=20,
    dt_pin=21,
    on_clockwise_turn=increment,
    on_counter_clockwise_turn=decrement,
):
    input("press enter to quit\n")

Advanced Usage

When calling connect you can pass in an optional callback_handling argument. This controls how the callbacks are executed. The options are:

  • CallbackHandling.GLOBAL_WORKER_THREAD: The default. Callbacks are called in a global worker thread. This means all callbacks across all rotary encoders are called in the same thread. This ensures that all callbacks are executed sequentially. This is the least likely to cause problems with race conditions.
  • CallbackHandling.LOCAL_WORKER_THREAD: Similar to the above, except that each individual rotary encoders callbacks are executed on a different thread. This means that sequential execution of the callbacks of one encoder is still guaranteed, but not across several encoders. The responsiveness of the individual encoders may be slightly improved.
  • CallbackHandling.SPAWN_THREAD: Spawn a new thread for every callback. The execution of your callbacks is no longer sequential, and you will have to make sure that your callbacks are thread safe.
  • CallbackHandling.GPIO_INTERUPT_THREAD: Not recommended. Similar in behavior to CallbackHandling.SPAWN_THREAD except that the threads are spawned by the underlying C extension library.

Similar Projects:

The pigpio-encoder is a similar library based on pigpio.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rpi_rotary_encoder-0.1.0.tar.gz (3.9 kB view hashes)

Uploaded Source

Built Distribution

rpi_rotary_encoder-0.1.0-py3-none-any.whl (4.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page