feat(oled): make auto-power save optional and fix brightness control

- Add CONFIG_OLED_AUTO_POWER_SAVE Kconfig option (default off) for bread-compact-wifi to make screen auto-off optional per maintainer request
- Make Backlight::SetBrightness virtual to allow OledBacklight to skip the PWM gradual transition, applying brightness changes immediately

Author: parkghost

main/Kconfig.projbuild

@@ -510,6 +510,13 @@ choice DISPLAY_OLED_TYPE
         bool "SH1106 128*64"
 endchoice
 
+config OLED_AUTO_POWER_SAVE
+    bool "Enable OLED Auto Power Save"
+    depends on BOARD_TYPE_BREAD_COMPACT_WIFI
+    help
+        Automatically turn off the OLED display after a period of inactivity.
+        The screen wakes up on button press or voice activity.
+
 choice DISPLAY_LCD_TYPE
     depends on BOARD_TYPE_BREAD_COMPACT_WIFI_LCD || BOARD_TYPE_BREAD_COMPACT_ESP32_LCD || BOARD_TYPE_CGC || BOARD_TYPE_WAVESHARE_P4_NANO || BOARD_TYPE_WAVESHARE_P4_WIFI6_TOUCH_LCD_XC || BOARD_TYPE_BREAD_COMPACT_WIFI_CAM
     prompt "LCD Type"

main/boards/bread-compact-wifi/compact_wifi_board.cc

@@ -9,7 +9,9 @@
 #include "lamp_controller.h"
 #include "led/single_led.h"
 #include "assets/lang_config.h"
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
 #include "power_save_timer.h"
+#endif
 
 #include <esp_log.h>
 #include <driver/i2c_master.h>
@@ -22,6 +24,8 @@
 
 #define TAG "CompactWifiBoard"
 
+static constexpr int kPowerSaveTimeoutSeconds = 60;
+
 class CompactWifiBoard : public WifiBoard {
 private:
     i2c_master_bus_handle_t display_i2c_bus_;
@@ -32,10 +36,11 @@ class CompactWifiBoard : public WifiBoard {
     Button touch_button_;
     Button volume_up_button_;
     Button volume_down_button_;
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
     PowerSaveTimer* power_save_timer_;
 
     void InitializePowerSaveTimer() {
-        power_save_timer_ = new PowerSaveTimer(-1, 60, -1);
+        power_save_timer_ = new PowerSaveTimer(-1, kPowerSaveTimeoutSeconds, -1);
         power_save_timer_->OnEnterSleepMode([this]() {
             GetDisplay()->SetPowerSaveMode(true);
         });
@@ -44,6 +49,7 @@ class CompactWifiBoard : public WifiBoard {
         });
         power_save_timer_->SetEnabled(true);
     }
+#endif
 
     void InitializeDisplayI2c() {
         i2c_master_bus_config_t bus_config = {
@@ -115,7 +121,9 @@ class CompactWifiBoard : public WifiBoard {
 
     void InitializeButtons() {
         boot_button_.OnClick([this]() {
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
             power_save_timer_->WakeUp();
+#endif
             auto& app = Application::GetInstance();
             if (app.GetDeviceState() == kDeviceStateStarting) {
                 EnterWifiConfigMode();
@@ -124,16 +132,22 @@ class CompactWifiBoard : public WifiBoard {
             app.ToggleChatState();
         });
         touch_button_.OnPressDown([this]() {
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
             power_save_timer_->WakeUp();
+#endif
             Application::GetInstance().StartListening();
         });
         touch_button_.OnPressUp([this]() {
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
             power_save_timer_->WakeUp();
+#endif
             Application::GetInstance().StopListening();
         });
 
         volume_up_button_.OnClick([this]() {
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
             power_save_timer_->WakeUp();
+#endif
             auto codec = GetAudioCodec();
             auto volume = codec->output_volume() + 10;
             if (volume > 100) {
@@ -144,13 +158,17 @@ class CompactWifiBoard : public WifiBoard {
         });
 
         volume_up_button_.OnLongPress([this]() {
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
             power_save_timer_->WakeUp();
+#endif
             GetAudioCodec()->SetOutputVolume(100);
             GetDisplay()->ShowNotification(Lang::Strings::MAX_VOLUME);
         });
 
         volume_down_button_.OnClick([this]() {
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
             power_save_timer_->WakeUp();
+#endif
             auto codec = GetAudioCodec();
             auto volume = codec->output_volume() - 10;
             if (volume < 0) {
@@ -161,7 +179,9 @@ class CompactWifiBoard : public WifiBoard {
         });
 
         volume_down_button_.OnLongPress([this]() {
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
             power_save_timer_->WakeUp();
+#endif
             GetAudioCodec()->SetOutputVolume(0);
             GetDisplay()->ShowNotification(Lang::Strings::MUTED);
         });
@@ -180,7 +200,9 @@ class CompactWifiBoard : public WifiBoard {
         volume_down_button_(VOLUME_DOWN_BUTTON_GPIO) {
         InitializeDisplayI2c();
         InitializeSsd1306Display();
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
         InitializePowerSaveTimer();
+#endif
         InitializeButtons();
         InitializeTools();
     }
@@ -210,12 +232,14 @@ class CompactWifiBoard : public WifiBoard {
         return &backlight;
     }
 
+#ifdef CONFIG_OLED_AUTO_POWER_SAVE
     virtual void SetPowerSaveLevel(PowerSaveLevel level) override {
         if (level != PowerSaveLevel::LOW_POWER) {
             power_save_timer_->WakeUp();
         }
         WifiBoard::SetPowerSaveLevel(level);
     }
+#endif
 };
 
 DECLARE_BOARD(CompactWifiBoard);

main/boards/common/backlight.h

@@ -13,7 +13,7 @@ class Backlight {
     ~Backlight();
 
     void RestoreBrightness();
-    void SetBrightness(uint8_t brightness, bool permanent = false);
+    virtual void SetBrightness(uint8_t brightness, bool permanent = false);
     inline uint8_t brightness() const { return brightness_; }
 
 protected:

main/display/oled_display.cc

@@ -1,4 +1,5 @@
 #include "oled_display.h"
+#include "settings.h"
 #include "assets/lang_config.h"
 #include "lvgl_theme.h"
 #include "lvgl_font.h"
@@ -413,6 +414,25 @@ OledBacklight::OledBacklight(OledDisplay* display) : display_(display) {
     brightness_ = 50;
 }
 
+void OledBacklight::SetBrightness(uint8_t brightness, bool permanent) {
+    if (brightness > 100) {
+        brightness = 100;
+    }
+    if (brightness_ == brightness) {
+        return;
+    }
+
+    if (permanent) {
+        Settings settings("display", true);
+        settings.SetInt("brightness", brightness);
+    }
+
+    brightness_ = brightness;
+    target_brightness_ = brightness;
+    SetBrightnessImpl(brightness);
+    ESP_LOGI(TAG, "Set OLED brightness to %d", brightness);
+}
+
 void OledBacklight::SetBrightnessImpl(uint8_t brightness) {
     if (brightness <= 5) {
         display_->SetPowerSaveMode(true);

main/display/oled_display.h

@@ -43,7 +43,8 @@ class OledDisplay : public LvglDisplay {
 class OledBacklight : public Backlight {
 public:
     OledBacklight(OledDisplay* display);
-    virtual void SetBrightnessImpl(uint8_t brightness) override;
+    void SetBrightness(uint8_t brightness, bool permanent = false) override;
+    void SetBrightnessImpl(uint8_t brightness) override;
 
 private:
     OledDisplay* display_;