legacy pcnt driver is deprecated

[farTooOld]

#warning "legacy pcnt driver is deprecated, please migrate to use driver/pulse_cnt.h"

Arduino IDE 2.3.2
#include <ESP32Encoder.h>

Using Two Encoders 600ppr. The Example codes give the same Warning. But the Encoders seem to be working (except of dropping some pulses when going from Positive direction to Negative direction.

I've searched and searched for solution but haven't found any solution. Is something Not working? How to stop the Warning if noting is wrong?

What do I need to do (and how to do it)?

(otherwise, it's the Best Encoder lib).

Thank you

[anthonyjclark]

Here is some information on the change and the migration:
https://docs.espressif.com/projects/esp-idf/en/stable/esp32/migration-guides/release-5.x/5.0/peripherals.html#pulse-counter-driver

I'll try to submit a PR if I have the time, but I do not expect that I will anytime soon.

[whogarden]

It's just a warning. Question : can we use V0.11.7 with no pb?

[stevempotter]

I have been using and enjoying this library for a few years. On making some updates to my code, I get the compile warning that Espressif has changed its PCNT stuff in a way that is "breaking". What are the implications? If it is "breaking" why is it just a warning?
Is the new one better in some way?
Will this repo migrate to the new PCNT?

Here is what I see on their website as of 6 Aug 2025:

Pulse Counter Driver
Pulse counter driver has been redesigned (see PCNT), which aims to unify and simplify the usage of PCNT peripheral.

Although it is recommended to use the new driver APIs, the legacy driver is still available in the previous include path driver/pcnt.h. However, including driver/pcnt.h triggers the build warning below by default. The warning can be suppressed by the Kconfig option CONFIG_PCNT_SUPPRESS_DEPRECATE_WARN.

legacy pcnt driver is deprecated, please migrate to use driver/pulse_cnt.h
The major breaking changes in concept and usage are listed as follows:

Breaking Changes in Concepts
pcnt_port_t, pcnt_unit_t and pcnt_channel_t which used to identify the hardware unit and channel are removed from user's code. In the new driver, PCNT unit is represented by pcnt_unit_handle_t, likewise, PCNT channel is represented by pcnt_channel_handle_t. Both of them are opaque pointers.

pcnt_evt_type_t is not used any more, they have been replaced by a universal Watch Point Event. In the event callback pcnt_watch_cb_t, it is still possible to distinguish different watch points from pcnt_watch_event_data_t.

pcnt_count_mode_t is replaced by pcnt_channel_edge_action_t, and pcnt_ctrl_mode_t is replaced by pcnt_channel_level_action_t.

Breaking Changes in Usage
Previously, the PCNT unit configuration and channel configuration were combined into a single function: pcnt_unit_config. They are now split into the two factory APIs: pcnt_new_unit() and pcnt_new_channel() respectively.

Only the count range is necessary for initializing a PCNT unit. GPIO number assignment has been moved to pcnt_new_channel().

High/Low control mode and positive/negative edge count mode are set by stand-alone functions: pcnt_channel_set_edge_action() and pcnt_channel_set_level_action().

pcnt_get_counter_value is replaced by pcnt_unit_get_count().

pcnt_counter_pause is replaced by pcnt_unit_stop().

pcnt_counter_resume is replaced by pcnt_unit_start().

pcnt_counter_clear is replaced by pcnt_unit_clear_count().

pcnt_intr_enable and pcnt_intr_disable are removed. In the new driver, the interrupt is enabled by registering event callbacks pcnt_unit_register_event_callbacks().

pcnt_event_enable and pcnt_event_disable are removed. In the new driver, the PCNT events are enabled/disabled by adding/removing watch points pcnt_unit_add_watch_point(), pcnt_unit_remove_watch_point().

pcnt_set_event_value is removed. In the new driver, event value is also set when adding watch point by pcnt_unit_add_watch_point().

pcnt_get_event_value and pcnt_get_event_status are removed. In the new driver, these information are provided by event callback pcnt_watch_cb_t in the pcnt_watch_event_data_t.

pcnt_isr_register and pcnt_isr_unregister are removed. Register of the ISR handler from user's code is no longer permitted. Users should register event callbacks instead by calling pcnt_unit_register_event_callbacks().

pcnt_set_pin is removed and the new driver no longer allows the switching of the GPIO at runtime. If users want to change to other GPIOs, please delete the existing PCNT channel by pcnt_del_channel() and reinstall with the new GPIO number by pcnt_new_channel().

pcnt_filter_enable, pcnt_filter_disable and pcnt_set_filter_value are replaced by pcnt_unit_set_glitch_filter(). Meanwhile, pcnt_get_filter_value has been removed.

pcnt_set_mode is replaced by pcnt_channel_set_edge_action() and pcnt_channel_set_level_action().

pcnt_isr_service_install, pcnt_isr_service_uninstall, pcnt_isr_handler_add and pcnt_isr_handler_remove are replaced by pcnt_unit_register_event_callbacks(). The default ISR handler is lazy installed in the new driver.