mirror of https://github.com/espressif/esp-idf.git synced 2024-10-05 20:47:46 -04:00

History

bizhuangyang 835d1b0bac bugfix:rotary encoder example isr service install Fix the issue mentioned when using two or more encoders. Modify PCNT_CTRL_GND_IO to avoid the affect of USB JTAG(origin pin 19 is used for USB D-). Update esp32c3. peripherals.ld and docs for esp32s3. Closes https://github.com/espressif/esp-idf/issues/6889		2021-07-14 10:13:21 +08:00
..
components/rotary_encoder	bugfix:rotary encoder example isr service install	2021-07-14 10:13:21 +08:00
main	pcnt: add rotary encoder example	2020-10-19 11:56:18 +08:00
CMakeLists.txt	pcnt: add rotary encoder example	2020-10-19 11:56:18 +08:00
Makefile	Whitespace: Automated whitespace fixes (large commit)	2020-11-11 07:36:35 +00:00
README.md	CI: enable example builds for C3	2021-02-09 12:04:02 +08:00

README.md

Supported Targets	ESP32	ESP32-S2

Rotary Encoder Example

(See the README.md file in the upper level 'examples' directory for more information about examples.)

The PCNT peripheral is designed to count the number of rising and/or falling edges of an input signal. Each PCNT unit has two channels, which makes it possible to extract more information from two input signals than only one signal. This example shows how to make use of the HW features to decode the differential signals generated from a common rotary encoder -- EC11.

The signals a rotary encoder produces (and what can be handled by this example) are based on a 2-bit gray code available on 2 digital data signal lines. The typical encoders use 3 output pins: 2 for the signals and one for the common signal usually GND.

Typical signals:

A      +-----+     +-----+     +-----+
             |     |     |     |
             |     |     |     |
             +-----+     +-----+
B         +-----+     +-----+     +-----+
                |     |     |     |
                |     |     |     |
                +-----+     +-----+

 +--------------------------------------->
                CW direction

How to Use Example

Hardware Required

An ESP development board
EC11 rotary encoder (or other encoders which can produce quadrature waveforms)

Connection :

      +--------+              +---------------------------------+
      |        |              |                                 |
      |      A +--------------+ GPIO_A (internal pull up)       |
      |        |              |                                 |
+-------+      |              |                                 |
|     | |  GND +--------------+ GND                             |
+-------+      |              |                                 |
      |        |              |                                 |
      |      B +--------------+ GPIO_B (internal pull up)       |
      |        |              |                                 |
      +--------+              +---------------------------------+

Build and Flash

Run idf.py -p PORT flash monitor to build, flash and monitor the project.

(To exit the serial monitor, type Ctrl-].)

See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.

Example Output

I (181323) example: Encoder value: 0
I (182323) example: Encoder value: 0
I (183323) example: Encoder value: -12
I (184323) example: Encoder value: -18
I (185323) example: Encoder value: -24
I (188323) example: Encoder value: 4
I (189323) example: Encoder value: 8
I (190323) example: Encoder value: 8
I (191323) example: Encoder value: 8

This example enables the 4X mode to parse the rotary signals, which means, each complete rotary step will result PCNT counter to increase/decrease by 4, depending on the direction of rotation.

Troubleshooting

For any technical queries, please open an [issue] (https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.