Add Status Bar, text resize to src/components/display/drivers/dispDrvThinkInkGrayscale4T5.h

Author: brentru

src/components/display/drivers/dispDrvThinkInkGrayscale4T5.h

@@ -83,6 +83,119 @@ class dispDrvThinkInkGrayscale4T5 : public dispDrvBase {
     return true;
   }
 
+  /*!
+      @brief  Draws a status bar at the top of the display.
+        @param  io_username
+                The Adafruit IO username to display on the status bar.
+  */
+  virtual void drawStatusBar(const char *io_username) override {
+    if (!_display)
+      return;
+
+    // Clear the entire display buffer to remove splash screen
+    _display->clearBuffer();
+
+    // Draw status bar
+    _display->fillRect(0, 0, _display->width(), STATUS_BAR_HEIGHT, EPD_BLACK);
+    _display->fillRect(STATUS_BAR_BORDER, STATUS_BAR_BORDER,
+                       _display->width() - (2 * STATUS_BAR_BORDER),
+                       STATUS_BAR_HEIGHT - (2 * STATUS_BAR_BORDER), EPD_WHITE);
+
+    // Draw username on left side of the status bar
+    _display->setTextSize(1);
+    _display->setTextColor(EPD_BLACK);
+    _display->setCursor(5, 6);
+    _display->print(io_username);
+
+    // Calculate status bar icon positions and center vertically
+    _statusbar_icons_y =
+        STATUS_BAR_BORDER +
+        ((STATUS_BAR_HEIGHT - 2 * STATUS_BAR_BORDER - STATUS_BAR_ICON_SZ) / 2);
+    _statusbar_icon_battery_x =
+        _display->width() - STATUS_BAR_ICON_SZ - STATUS_BAR_ICON_MARGIN;
+    _statusbar_icon_wifi_x = _statusbar_icon_battery_x - STATUS_BAR_ICON_SZ -
+                             STATUS_BAR_ICON_SPACING;
+    _statusbar_icon_cloud_x =
+        _statusbar_icon_wifi_x - STATUS_BAR_ICON_SZ - STATUS_BAR_ICON_SPACING;
+    // Draw icons on right side of the status bar
+    _display->drawBitmap(_statusbar_icon_cloud_x, _statusbar_icons_y,
+                         epd_bmp_cloud_online, STATUS_BAR_ICON_SZ,
+                         STATUS_BAR_ICON_SZ, EPD_BLACK);
+    _display->drawBitmap(_statusbar_icon_wifi_x, _statusbar_icons_y,
+                         epd_bmp_wifi_full, STATUS_BAR_ICON_SZ,
+                         STATUS_BAR_ICON_SZ, EPD_BLACK);
+    _display->drawBitmap(_statusbar_icon_battery_x, _statusbar_icons_y,
+                         epd_bmp_bat_full, STATUS_BAR_ICON_SZ,
+                         STATUS_BAR_ICON_SZ, EPD_BLACK);
+
+    _display->display();
+  }
+
+  /*!
+  @brief  Updates the status bar with current information (battery level,
+  connectivity status, etc).
+  @param  rssi
+          The current WiFi RSSI (signal strength) in dB.
+  @param  bat
+          The current battery level as a percentage (0-100).
+  @param  mqtt_status
+          The current MQTT connection status.
+*/
+  void updateStatusBar(int8_t rssi, uint8_t bat, bool mqtt_status) override {
+    if (!_display)
+      return;
+
+    // Only update wifi icon if the RSSI has changed significantly (+/- 5dB)
+    bool update_rssi = abs(rssi - _statusbar_rssi) >= 5;
+    // Only update cloud icon if MQTT status has changed
+    bool update_mqtt = mqtt_status != _statusbar_mqtt_connected;
+
+    // No need to update if nothing has changed
+    if (!update_rssi && !update_mqtt)
+      return;
+
+    if (update_mqtt) {
+      // updating the RSSI occurs too frequently to be practical
+      _display->fillRect(_statusbar_icon_cloud_x, _statusbar_icons_y,
+                         STATUS_BAR_ICON_SZ, STATUS_BAR_ICON_SZ, EPD_WHITE);
+      if (mqtt_status) {
+        _display->drawBitmap(_statusbar_icon_cloud_x, _statusbar_icons_y,
+                             epd_bmp_cloud_online, STATUS_BAR_ICON_SZ,
+                             STATUS_BAR_ICON_SZ, EPD_BLACK);
+      } else {
+        _display->drawBitmap(_statusbar_icon_cloud_x, _statusbar_icons_y,
+                             epd_bmp_cloud_offline, STATUS_BAR_ICON_SZ,
+                             STATUS_BAR_ICON_SZ, EPD_BLACK);
+      }
+      _statusbar_mqtt_connected = mqtt_status;
+    }
+
+    // Update WiFi icon only if RSSI has changed significantly (+/-3dB)
+    if (update_rssi) {
+      const unsigned char *wifi_icon = epd_bmp_wifi_no_signal;
+      if (rssi >= -50) {
+        wifi_icon = epd_bmp_wifi_full;
+      } else if (rssi < -50 && rssi >= -60) {
+        wifi_icon = epd_bmp_wifi_fair;
+      } else if (rssi < -60 && rssi >= -70) {
+        wifi_icon = epd_bmp_wifi_weak;
+      } else if (rssi < -70 && rssi >= -80) {
+        wifi_icon = epd_bmp_wifi_no_signal;
+      } else {
+        wifi_icon = epd_bmp_wifi_no_signal;
+      }
+      // Clear and draw the new WiFi icon, based on RSSI
+      _display->fillRect(_statusbar_icon_wifi_x, _statusbar_icons_y,
+                         STATUS_BAR_ICON_SZ, STATUS_BAR_ICON_SZ, EPD_WHITE);
+      _display->drawBitmap(_statusbar_icon_wifi_x, _statusbar_icons_y,
+                           wifi_icon, STATUS_BAR_ICON_SZ, STATUS_BAR_ICON_SZ,
+                           EPD_BLACK);
+      _statusbar_rssi = rssi;
+    }
+
+    _display->display();
+  }
+
   /*!
       @brief  Writes a message to the display.
       @param  message
@@ -94,16 +207,22 @@ class dispDrvThinkInkGrayscale4T5 : public dispDrvBase {
     if (_display == nullptr)
       return;
 
-    // Start with a fresh display buffer
-    _display->clearBuffer();
-    int16_t y_idx = 0;
+    // Clear only the area below the status bar
+    _display->fillRect(0, STATUS_BAR_HEIGHT, _display->width(),
+                       _display->height() - STATUS_BAR_HEIGHT, EPD_WHITE);
+    // Add padding between status bar and text content
+    int16_t y_idx = STATUS_BAR_HEIGHT + 4;
     _display->setCursor(0, y_idx);
 
     // Calculate the line height based on the text size (NOTE: base height is
     // 8px)
     int16_t line_height = 8 * _text_sz;
     uint16_t c_idx = 0;
     size_t msg_size = strlen(message);
+
+    // Reset the text size to the configured value before we write
+    _display->setTextSize(_text_sz);
+
     for (size_t i = 0; i < msg_size && c_idx < msg_size; i++) {
       if (y_idx + line_height > _height)
         break;
@@ -127,6 +246,7 @@ class dispDrvThinkInkGrayscale4T5 : public dispDrvBase {
           i++;
         }
       } else if (message[i] == 0xC2 && message[i + 1] == 0xB0) {
+        // Degree symbol
         _display->write(char(248));
         i++;
       } else {

src/components/display/hardware.cpp

@@ -59,7 +59,7 @@ static const std::map<wippersnapper_display_v1_DisplayDriver,
     @brief  Creates a new E-Ink display driver instance based on the driver
    name.
     @param  driver
-            The name of the EPD display driver to create.
+            The name of the DisplayDriver.
     @param  dc
             Data/Command pin number.
     @param  rst
@@ -87,7 +87,7 @@ dispDrvBase *CreateDrvDispEpd(wippersnapper_display_v1_DisplayDriver driver,
     @brief  Creates a new SPI TFT display driver instance based on the driver
    name.
     @param  driver
-            The name of the SPI TFT display driver to create.
+            The name of the DisplayDriver.
     @param  cs
             Chip Select pin number.
     @param  dc
@@ -168,7 +168,7 @@ int16_t DisplayHardware::parsePin(const char *pinStr) {
 /*!
     @brief  Configures the EPD display with the provided configuration.
     @param driver
-            Pointer to the display driver configuration structure.
+            Pointer to a DisplayDriver enum value.
     @param  config
             Pointer to the EPD configuration structure.
     @param  spi_config
@@ -305,7 +305,7 @@ void DisplayHardware::removeSuffix(const char *suffix) {
 /*!
     @brief  Attempts to configure and initialize a TFT display
     @param driver
-            Pointer to the display driver configuration structure.
+            Pointer to a DisplayDriver enum value.
     @param  config
             Pointer to the TFT configuration structure.
     @param  spi_config