lightbulg: add get power limit API

Author: YuanMingfu-star

components/led/lightbulb_driver/CHANGELOG.md

@@ -1,5 +1,11 @@
 # ChangeLog
 
+## v1.9.0 - 2025-08-11
+
+### Improve:
+
+- Add API for get power limit
+
 ## v1.8.3 - 2025-06-19
 
 ### Bug Fix:

components/led/lightbulb_driver/idf_component.yml

@@ -1,4 +1,4 @@
-version: "1.8.3"
+version: "1.9.0"
 description: Provide multiple dimming driver solutions to easily build lightbulb applications
 url: https://github.com/espressif/esp-iot-solution/tree/master/components/led/lightbulb_driver
 dependencies:

components/led/lightbulb_driver/include/lightbulb.h

@@ -680,6 +680,14 @@ bool lightbulb_get_switch(void);
  */
 lightbulb_works_mode_t lightbulb_get_mode(void);
 
+/**
+ * @brief Get the power limit of the lightbulb.
+ *
+ * @param power_limit A pointer to a `lightbulb_power_limit_t` structure where the power limit details will be stored.
+ * @return esp_err_t An error code indicating the success or failure of the operation.
+ */
+esp_err_t lightbulb_get_power_limit(lightbulb_power_limit_t *power_limit);
+
 /**
  * @brief Get all the status details of the lightbulb.
  *

components/led/lightbulb_driver/src/lightbulb.c

@@ -1939,6 +1939,18 @@ lightbulb_works_mode_t lightbulb_get_mode(void)
     return result;
 }
 
+esp_err_t lightbulb_get_power_limit(lightbulb_power_limit_t *power_limit)
+{
+    LIGHTBULB_CHECK(power_limit, "power_limit is null", return ESP_FAIL);
+    LIGHTBULB_CHECK(s_lb_obj, "not init", return ESP_ERR_INVALID_ARG);
+
+    LB_MUTEX_TAKE(portMAX_DELAY);
+    memcpy(power_limit, &s_lb_obj->power, sizeof(lightbulb_power_limit_t));
+    LB_MUTEX_GIVE();
+
+    return ESP_OK;
+}
+
 esp_err_t lightbulb_update_status(lightbulb_status_t *new_status, bool trigger)
 {
     LIGHTBULB_CHECK(new_status, "new_status is null", return ESP_FAIL);