add some code

managed_components/espressif__knob/examples/knob_power_save/CMakeLists.txt

@@ -0,0 +1,6 @@
+# The following five lines of boilerplate have to be in your project's
+# CMakeLists in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.5)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+project(knob_power_save)

managed_components/espressif__knob/examples/knob_power_save/README.md

@@ -0,0 +1,47 @@
+## Knob Power Save Example
+
+This example demonstrates how to utilize the `knob` component in conjunction with the light sleep low-power mode.
+
+* `knob` [Component Introduction](https://docs.espressif.com/projects/esp-iot-solution/en/latest/input_device/knob.html)
+
+## Hardware
+
+Any GPIO on any development board can be used in this example, for the default GPIO, please refer to the table below.
+
+|      Hardware       | GPIO  |
+| :-----------------: | :---: |
+| Encoder A (Phase A) | GPIO1 |
+| Encoder B (Phase B) | GPIO2 |
+
+## Build and Flash
+
+Build the project and flash it to the board, then run the monitor tool to view the serial output:
+
+* Run `. ./export.sh` to set IDF environment
+* Run `idf.py set-target esp32xx` to set target chip
+* 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 all the steps to configure and use the ESP-IDF to build projects.
+
+## Example Output
+
+```
+I (316) pm: Frequency switching config: CPU_MAX: 80, APB_MAX: 80, APB_MIN: 10, Light sleep: ENABLED
+I (322) sleep: Code start at 0x42000020, total 106515, data start at 0x3c020020, total 46384 Bytes
+I (331) gpio: GPIO[1]| InputEn: 1| OutputEn: 0| OpenDrain: 0| Pullup: 1| Pulldown: 0| Intr:0
+I (341) gpio: GPIO[2]| InputEn: 1| OutputEn: 0| OpenDrain: 0| Pullup: 1| Pulldown: 0| Intr:0
+I (350) Knob: Iot Knob Config Succeed, encoder A:1, encoder B:2, direction:0, Version: 0.1.4
+I (359) main_task: Returned from app_main()
+I (1503) knob_power_save: knob event KNOB_LEFT, -1
+I (1503) knob_power_save: Wake up from light sleep, reason 7
+I (1691) knob_power_save: knob event KNOB_LEFT, -2
+I (1691) knob_power_save: Wake up from light sleep, reason 7
+I (1860) knob_power_save: knob event KNOB_LEFT, -3
+I (1860) knob_power_save: Wake up from light sleep, reason 7
+I (1940) knob_power_save: knob event KNOB_LEFT, -4
+I (1940) knob_power_save: Wake up from light sleep, reason 7
+I (2017) knob_power_save: knob event KNOB_LEFT, -5
+I (2017) knob_power_save: Wake up from light sleep, reason 7
+```

managed_components/espressif__knob/examples/knob_power_save/main/CMakeLists.txt

@@ -0,0 +1,2 @@
+idf_component_register(SRCS "knob_power_save.c"
+                    INCLUDE_DIRS ".")

managed_components/espressif__knob/examples/knob_power_save/main/Kconfig.projbuild

@@ -0,0 +1,74 @@
+menu "Example Configuration"
+
+    choice EXAMPLE_MAX_CPU_FREQ
+        prompt "Maximum CPU frequency"
+        default EXAMPLE_MAX_CPU_FREQ_80 if !IDF_TARGET_ESP32H2
+        default EXAMPLE_MAX_CPU_FREQ_96 if IDF_TARGET_ESP32H2
+        depends on PM_ENABLE
+        help
+            Maximum CPU frequency to use for dynamic frequency scaling.
+
+        config EXAMPLE_MAX_CPU_FREQ_80
+            bool "80 MHz"
+        config EXAMPLE_MAX_CPU_FREQ_96
+            bool "96 MHz"
+            depends on IDF_TARGET_ESP32H2
+        config EXAMPLE_MAX_CPU_FREQ_120
+            bool "120 MHz"
+            depends on IDF_TARGET_ESP32C2
+        config EXAMPLE_MAX_CPU_FREQ_160
+            bool "160 MHz"
+            depends on !IDF_TARGET_ESP32C2
+        config EXAMPLE_MAX_CPU_FREQ_240
+            bool "240 MHz"
+            depends on IDF_TARGET_ESP32 || IDF_TARGET_ESP32S2 || IDF_TARGET_ESP32S3
+    endchoice
+
+    config EXAMPLE_MAX_CPU_FREQ_MHZ
+        int
+        default 80 if EXAMPLE_MAX_CPU_FREQ_80
+        default 96 if EXAMPLE_MAX_CPU_FREQ_96
+        default 120 if EXAMPLE_MAX_CPU_FREQ_120
+        default 160 if EXAMPLE_MAX_CPU_FREQ_160
+        default 240 if EXAMPLE_MAX_CPU_FREQ_240
+
+    choice EXAMPLE_MIN_CPU_FREQ
+        prompt "Minimum CPU frequency"
+        default EXAMPLE_MIN_CPU_FREQ_10M if !IDF_TARGET_ESP32H2
+        default EXAMPLE_MIN_CPU_FREQ_32M if IDF_TARGET_ESP32H2
+        depends on PM_ENABLE
+        help
+            Minimum CPU frequency to use for dynamic frequency scaling.
+            Should be set to XTAL frequency or XTAL frequency divided by integer.
+
+        config EXAMPLE_MIN_CPU_FREQ_40M
+            bool "40 MHz (use with 40MHz XTAL)"
+            depends on XTAL_FREQ_40 || XTAL_FREQ_AUTO || ESP32_XTAL_FREQ_40 || ESP32_XTAL_FREQ_AUTO || !IDF_TARGET_ESP32
+        config EXAMPLE_MIN_CPU_FREQ_20M
+            bool "20 MHz (use with 40MHz XTAL)"
+            depends on XTAL_FREQ_40 || XTAL_FREQ_AUTO || ESP32_XTAL_FREQ_40 || ESP32_XTAL_FREQ_AUTO || !IDF_TARGET_ESP32
+        config EXAMPLE_MIN_CPU_FREQ_10M
+            bool "10 MHz (use with 40MHz XTAL)"
+            depends on XTAL_FREQ_40 || XTAL_FREQ_AUTO || ESP32_XTAL_FREQ_40 || ESP32_XTAL_FREQ_AUTO || !IDF_TARGET_ESP32
+        config EXAMPLE_MIN_CPU_FREQ_26M
+            bool "26 MHz (use with 26MHz XTAL)"
+            depends on XTAL_FREQ_26 || XTAL_FREQ_AUTO || ESP32_XTAL_FREQ_26 || ESP32_XTAL_FREQ_AUTO
+        config EXAMPLE_MIN_CPU_FREQ_13M
+            bool "13 MHz (use with 26MHz XTAL)"
+            depends on XTAL_FREQ_26 || XTAL_FREQ_AUTO || ESP32_XTAL_FREQ_26 || ESP32_XTAL_FREQ_AUTO
+        config EXAMPLE_MIN_CPU_FREQ_32M
+            bool "32 MHz (use with 32MHz XTAL)"
+            depends on IDF_TARGET_ESP32H2
+            depends on XTAL_FREQ_32 || XTAL_FREQ_AUTO
+    endchoice
+
+    config EXAMPLE_MIN_CPU_FREQ_MHZ
+        int
+        default 40 if EXAMPLE_MIN_CPU_FREQ_40M
+        default 20 if EXAMPLE_MIN_CPU_FREQ_20M
+        default 10 if EXAMPLE_MIN_CPU_FREQ_10M
+        default 26 if EXAMPLE_MIN_CPU_FREQ_26M
+        default 13 if EXAMPLE_MIN_CPU_FREQ_13M
+        default 32 if EXAMPLE_MIN_CPU_FREQ_32M
+
+endmenu

managed_components/espressif__knob/examples/knob_power_save/main/idf_component.yml

@@ -0,0 +1,6 @@
+version: "0.0.1"
+dependencies:
+    idf: ">=4.4"
+    knob:
+      version: "*"
+      override_path: "../../../../components/knob"

managed_components/espressif__knob/examples/knob_power_save/main/knob_power_save.c

@@ -0,0 +1,101 @@
+/*
+ * SPDX-FileCopyrightText: 2023-2024 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <stdio.h>
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+#include "esp_log.h"
+#include "esp_pm.h"
+#include "iot_knob.h"
+#include "esp_sleep.h"
+#include "esp_idf_version.h"
+
+#define ENCODER_A_GPIO     1
+#define ENCODER_B_GPIO     2
+
+static const char *TAG = "knob_power_save";
+
+static knob_handle_t knob = NULL;
+
+const char *knob_event_table[] = {
+    "KNOB_LEFT",
+    "KNOB_RIGHT",
+    "KNOB_H_LIM",
+    "KNOB_L_LIM",
+    "KNOB_ZERO",
+};
+
+static void knob_event_cb(void *arg, void *data)
+{
+    ESP_LOGI(TAG, "knob event %s, %d", knob_event_table[(knob_event_t)data], iot_knob_get_count_value(knob));
+    esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
+    if (cause != ESP_SLEEP_WAKEUP_UNDEFINED) {
+        ESP_LOGI(TAG, "Wake up from light sleep, reason %d", cause);
+    }
+}
+
+static void knob_init(uint32_t encoder_a, uint32_t encoder_b)
+{
+    knob_config_t cfg = {
+        .default_direction = 0,
+        .gpio_encoder_a = encoder_a,
+        .gpio_encoder_b = encoder_b,
+#if CONFIG_PM_ENABLE
+        .enable_power_save = true,
+#endif
+    };
+
+    knob = iot_knob_create(&cfg);
+    assert(knob);
+    esp_err_t err = iot_knob_register_cb(knob, KNOB_LEFT, knob_event_cb, (void *)KNOB_LEFT);
+    err |= iot_knob_register_cb(knob, KNOB_RIGHT, knob_event_cb, (void *)KNOB_RIGHT);
+    err |= iot_knob_register_cb(knob, KNOB_H_LIM, knob_event_cb, (void *)KNOB_H_LIM);
+    err |= iot_knob_register_cb(knob, KNOB_L_LIM, knob_event_cb, (void *)KNOB_L_LIM);
+    err |= iot_knob_register_cb(knob, KNOB_ZERO, knob_event_cb, (void *)KNOB_ZERO);
+    ESP_ERROR_CHECK(err);
+}
+
+#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 1, 0)
+void power_save_init(void)
+{
+    esp_pm_config_t pm_config = {
+        .max_freq_mhz = CONFIG_EXAMPLE_MAX_CPU_FREQ_MHZ,
+        .min_freq_mhz = CONFIG_EXAMPLE_MIN_CPU_FREQ_MHZ,
+#if CONFIG_FREERTOS_USE_TICKLESS_IDLE
+        .light_sleep_enable = true
+#endif
+    };
+    ESP_ERROR_CHECK(esp_pm_configure(&pm_config));
+}
+#else
+void power_save_init(void)
+{
+#if CONFIG_IDF_TARGET_ESP32
+    esp_pm_config_esp32_t pm_config = {
+#elif CONFIG_IDF_TARGET_ESP32S2
+    esp_pm_config_esp32s2_t pm_config = {
+#elif CONFIG_IDF_TARGET_ESP32C3
+    esp_pm_config_esp32c3_t pm_config = {
+#elif CONFIG_IDF_TARGET_ESP32S3
+    esp_pm_config_esp32s3_t pm_config = {
+#elif CONFIG_IDF_TARGET_ESP32C2
+    esp_pm_config_esp32c2_t pm_config = {
+#endif
+        .max_freq_mhz = CONFIG_EXAMPLE_MAX_CPU_FREQ_MHZ,
+        .min_freq_mhz = CONFIG_EXAMPLE_MIN_CPU_FREQ_MHZ,
+#if CONFIG_FREERTOS_USE_TICKLESS_IDLE
+        .light_sleep_enable = true
+#endif
+    };
+    ESP_ERROR_CHECK(esp_pm_configure(&pm_config));
+}
+#endif
+
+void app_main(void)
+{
+    power_save_init();
+    knob_init(ENCODER_A_GPIO, ENCODER_B_GPIO);
+}

managed_components/espressif__knob/examples/knob_power_save/sdkconfig.defaults

@@ -0,0 +1,9 @@
+# Enable support for power management
+CONFIG_PM_ENABLE=y
+# Enable tickless idle mode
+CONFIG_FREERTOS_USE_TICKLESS_IDLE=y
+# Put related source code in IRAM
+CONFIG_PM_SLP_IRAM_OPT=y
+CONFIG_PM_RTOS_IDLE_OPT=y
+# Use 1000Hz freertos tick to lower sleep time threshold
+CONFIG_FREERTOS_HZ=1000