Merge branch 'feat/fan_rainmaker_supports_reset_factory' into 'master'

feat(bldc_fan): support resetting RainMaker by long-pressing the start button

See merge request ae_group/esp-iot-solution!1411

Author: YanKE01

examples/motor/bldc_fan_rainmaker/README.md

@@ -21,4 +21,8 @@ The `bldc_fan_rainmaker` example connects a brushless motor-driven fan to the ES
     * Overcurrent, over/under-voltage protection [feature]
     * Phase loss protection [feature]
 
-* [esp_rainmaker](https://components.espressif.com/components/espressif/esp_rainmaker) is a complete and lightweight AIoT solution that enables private cloud deployment for your business in a simple, cost-effective, and efficient manner.
+* [esp_rainmaker](https://components.espressif.com/components/espressif/esp_rainmaker) is a complete and lightweight AIoT solution that enables private cloud deployment for your business in a simple, cost-effective, and efficient manner.
+
+## Hardware Overview
+
+You can click [here](https://dl.espressif.com/AE/esp-iot-solution/bldc_fan_rainmaker_sch.pdf) to download the hardware schematic. By using the corresponding buttons, you can control the fan's start and stop, rotate the stepper motor, enable natural wind mode, and reset Rainmaker.

examples/motor/bldc_fan_rainmaker/main/Kconfig.projbuild

@@ -64,3 +64,28 @@ menu "ESP RainMaker App Wi-Fi Provisioning"
             Provisioning Name Prefix.
 
 endmenu
+
+menu "Example Configuration"
+
+    config FAN_RAINMAKER_LONG_PRESS_RESET_SECONDS
+        int "Long press reset timeout (seconds)"
+        default 5
+        range 3 15
+        help
+            Set the duration in seconds for long press to reset RainMaker configuration.
+
+    config FAN_RAINMAKER_RESET_SECONDS
+        int "RainMaker reset timeout (seconds)"
+        default 3
+        range 2 10
+        help
+            Set the timeout in seconds for RainMaker reset operation.
+
+    config FAN_RAINMAKER_REBOOT_SECONDS
+        int "RainMaker reboot timeout (seconds)"
+        default 3
+        range 2 10
+        help
+            Set the timeout in seconds for RainMaker reboot operation.
+
+endmenu

examples/motor/bldc_fan_rainmaker/main/app/include/app_rainmaker.h

@@ -8,6 +8,7 @@
 
 #include "esp_err.h"
 #include "esp_rmaker_core.h"
+#include "esp_rmaker_utils.h"
 
 #ifdef __cplusplus
 extern "C" {

examples/motor/bldc_fan_rainmaker/main/hal/hal_fan_button.c

@@ -1,5 +1,5 @@
 /*
- * SPDX-FileCopyrightText: 2023-2024 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Apache-2.0
  */
@@ -106,6 +106,11 @@ static void hal_fan_button_signle_click_cb(void *arg, void *data)
     }
 }
 
+static void hal_fan_button_long_press_hold_cb(void *arg, void *data)
+{
+    ESP_ERROR_CHECK(esp_rmaker_factory_reset(CONFIG_FAN_RAINMAKER_RESET_SECONDS, CONFIG_FAN_RAINMAKER_REBOOT_SECONDS));
+}
+
 static void hal_fan_oneshot_timer_cb(void *arg)
 {
     ESP_LOGI(TAG, "Count is over");
@@ -134,7 +139,7 @@ esp_err_t hal_fan_button_init(gpio_num_t start_pin, gpio_num_t mode_pin, gpio_nu
 
     button_config_t cfg = {
         .type = BUTTON_TYPE_GPIO,
-        .long_press_time = 5000,
+        .long_press_time = CONFIG_FAN_RAINMAKER_LONG_PRESS_RESET_SECONDS * 1000,
         .short_press_time = 200,
         .gpio_button_config = {
             .gpio_num = pin[0],
@@ -148,6 +153,8 @@ esp_err_t hal_fan_button_init(gpio_num_t start_pin, gpio_num_t mode_pin, gpio_nu
         iot_button_register_cb(hal_fan_button_handle[i], BUTTON_SINGLE_CLICK, hal_fan_button_signle_click_cb, NULL);
     }
 
+    iot_button_register_cb(hal_fan_button_handle[SETTING_START], BUTTON_LONG_PRESS_HOLD, hal_fan_button_long_press_hold_cb, NULL);  /*!< Support reset rainmaker */
+
     hal_fan_button.fan_timing_count = 0;
     const esp_timer_create_args_t oneshot_timer_args = {
         .callback = &hal_fan_oneshot_timer_cb,