feat(led_indicator): Update docs, examples

Author: zhongchaoesp

docs/en/display/led_indicator.rst

@@ -238,7 +238,7 @@ Create an indicator by specifying an IO and a set of configuration information.
         .blink_lists = led_indicator_get_sample_lists(),
         .blink_list_num = led_indicator_get_sample_lists_num(),
     };
-    led_indicator_handle_t led_handle  = iot_led_new_gpio_device(&config, &led_indicator_gpio_config);
+    esp_err_t ret = led_indicator_new_gpio_device(&config, &led_indicator_gpio_config, &led_handle);
 
 
 Start/stop blinking: control your indicator to start/stop a specified type of blink by calling corresponding functions. The functions are returned immediately after calling, and the blink process is controlled by the internal timer. The same indicator can perform multiple blink types in turn based on their priorities.

docs/zh_CN/display/led_indicator.rst

@@ -234,7 +234,7 @@ LED 指示灯是最简单的输出外设之一，可以通过不同形式的闪
         .blink_lists = led_indicator_get_sample_lists(),
         .blink_list_num = led_indicator_get_sample_lists_num(),
     };
-    led_indicator_handle_t led_handle  = iot_led_new_gpio_device(&config, &led_indicator_gpio_config);
+    esp_err_t ret = led_indicator_new_gpio_device(&config, &led_indicator_gpio_config, &led_handle);
 
 
 开始/停止闪烁：控制指示灯开启/停止指定闪烁类型，函数调用后立刻返回，内部由定时器控制闪烁流程。同一个指示灯可以开启多种闪烁类型，将根据闪烁类型优先级依次执行。

examples/indicator/gpio/main/main.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
  */
@@ -11,7 +11,7 @@
 #include "cmd_led_indicator.h"
 #include "esp_idf_version.h"
 #include "esp_log.h"
-#include "led_indicator.h"
+#include "led_indicator_gpio.h"
 
 #define GPIO_LED_PIN       CONFIG_EXAMPLE_GPIO_NUM
 #define GPIO_ACTIVE_LEVEL  CONFIG_EXAMPLE_GPIO_ACTIVE_LEVEL
@@ -124,7 +124,8 @@ void app_main(void)
         .blink_list_num = BLINK_MAX,
     };
 
-    led_handle = iot_led_new_gpio_device(&config, &gpio_config);
+    esp_err_t ret = led_indicator_new_gpio_device(&config, &gpio_config, &led_handle);
+    ESP_ERROR_CHECK(ret);
     assert(led_handle != NULL);
 
 #if CONFIG_EXAMPLE_ENABLE_CONSOLE_CONTROL

examples/indicator/ledc/main/main.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
  */
@@ -11,7 +11,7 @@
 #include "cmd_led_indicator.h"
 #include "esp_idf_version.h"
 #include "esp_log.h"
-#include "led_indicator.h"
+#include "led_indicator_ledc.h"
 
 #define GPIO_LED_PIN       CONFIG_EXAMPLE_GPIO_NUM
 #define GPIO_ACTIVE_LEVEL  CONFIG_EXAMPLE_GPIO_ACTIVE_LEVEL
@@ -152,7 +152,8 @@ void app_main(void)
         .blink_list_num = BLINK_MAX,
     };
 
-    led_handle = iot_led_new_ledc_device(&config, &ledc_config);
+    esp_err_t ret = led_indicator_new_ledc_device(&config, &ledc_config, &led_handle);
+    ESP_ERROR_CHECK(ret);
     assert(led_handle != NULL);
 
 #if CONFIG_EXAMPLE_ENABLE_CONSOLE_CONTROL

examples/indicator/rgb/main/main.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
  */
@@ -11,7 +11,7 @@
 #include "cmd_led_indicator.h"
 #include "esp_idf_version.h"
 #include "esp_log.h"
-#include "led_indicator.h"
+#include "led_indicator_rgb.h"
 
 #define GPIO_LED_RED_PIN       CONFIG_EXAMPLE_GPIO_RED_NUM
 #define GPIO_LED_GREEN_PIN     CONFIG_EXAMPLE_GPIO_GREEN_NUM
@@ -186,7 +186,8 @@ void app_main(void)
         .blink_list_num = BLINK_MAX,
     };
 
-    led_handle = iot_led_new_rgb_device(&config, &rgb_config);
+    esp_err_t ret  = led_indicator_new_rgb_device(&config, &rgb_config, &led_handle);
+    ESP_ERROR_CHECK(ret);
     assert(led_handle != NULL);
 
 #if CONFIG_EXAMPLE_ENABLE_CONSOLE_CONTROL

examples/indicator/ws2812_strips/main/main.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
  */
@@ -11,7 +11,7 @@
 #include "cmd_led_indicator.h"
 #include "esp_idf_version.h"
 #include "esp_log.h"
-#include "led_indicator.h"
+#include "led_indicator_strips.h"
 
 #define WS2812_GPIO_NUM       CONFIG_EXAMPLE_WS2812_GPIO_NUM
 #define WS2812_STRIPS_NUM     CONFIG_EXAMPLE_WS2812_STRIPS_NUM
@@ -216,7 +216,8 @@ void app_main(void)
         .blink_list_num = BLINK_MAX,
     };
 
-    led_handle = iot_led_new_strips_device(&config, &strips_config);
+    esp_err_t ret = led_indicator_new_strips_device(&config, &strips_config, &led_handle);
+    ESP_ERROR_CHECK(ret);
     assert(led_handle != NULL);
 
 #if CONFIG_EXAMPLE_ENABLE_CONSOLE_CONTROL

examples/usb/host/usb_cdc_4g_module/main/app_main.c

@@ -18,7 +18,7 @@
 #include "nvs_flash.h"
 #include "nvs.h"
 #include "esp_netif.h"
-#include "led_indicator.h"
+#include "led_indicator_gpio.h"
 #include "led_indicator_blink_default.h"
 #include "usbh_modem_board.h"
 #include "usbh_modem_wifi.h"
@@ -113,23 +113,29 @@ static void _led_indicator_init()
         .is_active_level_high = LED_ACTIVE_LEVEL,
     };
 
-    led_indicator_config_t led_config ;
+    led_indicator_config_t led_config = {
+        .blink_lists = NULL,
+        .blink_list_num = 0,
+    };
 
     if (LED_RED_SYSTEM_GPIO) {
         led_indicator_gpio_config.gpio_num = LED_RED_SYSTEM_GPIO;
-        s_led_system_handle = iot_led_new_gpio_device(&led_config, &led_indicator_gpio_config);
+        esp_err_t ret = led_indicator_new_gpio_device(&led_config, &led_indicator_gpio_config, &s_led_system_handle);
+        ESP_ERROR_CHECK(ret);
         assert(s_led_system_handle != NULL);
     }
     if (LED_BLUE_WIFI_GPIO) {
         led_indicator_gpio_config.gpio_num = LED_BLUE_WIFI_GPIO;
-        s_led_wifi_handle = iot_led_new_gpio_device(&led_config, &led_indicator_gpio_config);
+        ret = led_indicator_new_gpio_device(&led_config, &led_indicator_gpio_config, &s_led_wifi_handle);
+        ESP_ERROR_CHECK(ret);
         assert(s_led_wifi_handle != NULL);
         led_indicator_stop(s_led_wifi_handle, BLINK_CONNECTED);
         led_indicator_start(s_led_wifi_handle, BLINK_CONNECTING);
     }
     if (LED_GREEN_4GMODEM_GPIO) {
         led_indicator_gpio_config.gpio_num = LED_GREEN_4GMODEM_GPIO;
-        s_led_4g_handle = iot_led_new_gpio_device(&led_config, &led_indicator_gpio_config);
+        ret = led_indicator_new_gpio_device(&led_config, &led_indicator_gpio_config, &s_led_4g_handle);
+        ESP_ERROR_CHECK(ret);
         assert(s_led_4g_handle != NULL);
         led_indicator_stop(s_led_4g_handle, BLINK_CONNECTED);
         led_indicator_start(s_led_4g_handle, BLINK_CONNECTING);