feat(esp_lcd_sh8601): add brightness control to the panel

Goes with IDF espressif/esp-idf#18273

Author: ldab

components/display/lcd/esp_lcd_sh8601/esp_lcd_sh8601.c

@@ -35,6 +35,7 @@ static esp_err_t panel_sh8601_mirror(esp_lcd_panel_t *panel, bool mirror_x, bool
 static esp_err_t panel_sh8601_swap_xy(esp_lcd_panel_t *panel, bool swap_axes);
 static esp_err_t panel_sh8601_set_gap(esp_lcd_panel_t *panel, int x_gap, int y_gap);
 static esp_err_t panel_sh8601_disp_on_off(esp_lcd_panel_t *panel, bool off);
+static esp_err_t panel_sh8601_set_brightness(esp_lcd_panel_t *panel, int brightness);
 
 typedef struct {
     esp_lcd_panel_t base;
@@ -121,6 +122,7 @@ esp_err_t esp_lcd_new_panel_sh8601(const esp_lcd_panel_io_handle_t io, const esp
     sh8601->base.mirror = panel_sh8601_mirror;
     sh8601->base.swap_xy = panel_sh8601_swap_xy;
     sh8601->base.disp_on_off = panel_sh8601_disp_on_off;
+    sh8601->base.set_brightness = panel_sh8601_set_brightness;
     *ret_panel = &(sh8601->base);
     ESP_LOGD(TAG, "new sh8601 panel @%p", sh8601);
 
@@ -345,3 +347,19 @@ static esp_err_t panel_sh8601_disp_on_off(esp_lcd_panel_t *panel, bool on_off)
     ESP_RETURN_ON_ERROR(tx_param(sh8601, io, command, NULL, 0), TAG, "send command failed");
     return ESP_OK;
 }
+
+static esp_err_t panel_sh8601_set_brightness(esp_lcd_panel_t *panel, int brightness)
+{
+    sh8601_panel_t *sh8601 = __containerof(panel, sh8601_panel_t, base);
+    esp_lcd_panel_io_handle_t io = sh8601->io;
+
+    // Clamp brightness to 0-1023 range (10-bit)
+    uint16_t brightness_val = (brightness < 0) ? 0 : (brightness > 1023) ? 1023 : (uint16_t)brightness;
+    // Send as 2 bytes: MSB and LSB
+    return tx_param(sh8601, io, LCD_CMD_WRDISBV, (uint8_t[]) { (brightness_val >> 8) & 0xFF, brightness_val & 0xFF }, 2);
+}
+
+esp_err_t esp_lcd_sh8601_set_brightness(esp_lcd_panel_handle_t panel, uint16_t brightness)
+{
+    return esp_lcd_panel_set_brightness(panel, brightness);
+}

components/display/lcd/esp_lcd_sh8601/include/esp_lcd_sh8601.h

@@ -55,6 +55,17 @@ typedef struct {
  */
 esp_err_t esp_lcd_new_panel_sh8601(const esp_lcd_panel_io_handle_t io, const esp_lcd_panel_dev_config_t *panel_dev_config, esp_lcd_panel_handle_t *ret_panel);
 
+/**
+ * @brief Set the brightness level of the SH8601 panel
+ *
+ * @param[in] panel LCD panel handle
+ * @param[in] brightness Brightness level (0-1023, where 0 is lowest and 1023 is highest)
+ * @return
+ *      - ESP_OK: Success
+ *      - Otherwise: Fail
+ */
+esp_err_t esp_lcd_sh8601_set_brightness(esp_lcd_panel_handle_t panel, uint16_t brightness);
+
 /**
  * @brief LCD panel bus configuration structure
  *