updates

esphome/bambu-display/README.md

@@ -25,12 +25,16 @@ The configured swipe order is:
 
 Swipe left for the next printer or right for the previous printer. Navigation wraps
 from the last page to the first. Previous/Next buttons provide the same navigation.
-Swipes propagate through the metric cards and filament slots. A swipe consumes the
+Swipes propagate through the arc gauges and filament slots. A swipe consumes the
 rest of that touch so dragging across a navigation button does not also click it.
 
 Each page shows print status, job name, progress, nozzle and bed current/target
-temperatures, remaining time, current/total layers, print stage, part fan speed and
-filament colors/types. The active filament slot has a green outline. Print errors
+temperatures, remaining time, estimated finish time, current/total layers, print
+stage, fan speeds and filament colors/types. The layout follows BambuHelper's
+classic gauges: black background, bright green accents, six arc gauges and a
+vertical AMS column. Nozzle arcs are orange and the bed arc is cyan. For dual-nozzle
+printers the auxiliary-fan position becomes the right-nozzle gauge. The active
+filament slot has a green outline. Print errors
 and HMS alerts change the status badge to red; paused prints use amber. The display
 shows an alert badge rather than the detailed HMS diagnostic text.
 
@@ -39,6 +43,10 @@ to `--` rather than continuing to show cached values as live. Unknown individual
 values also show `--`. Remaining time respects the HA sensor's `h`, `min` or `s`
 unit, and temperature labels use the imported HA temperature unit. Only the visible
 page is refreshed each second; every printer's subscriptions remain connected.
+Auxiliary and exhaust fans are imported only for printers with those sensors;
+unsupported fan readings show `--`. Finish time is estimated from HA's remaining
+time and the HA-synchronized clock. Set `time.timezone` in the main YAML if your
+timezone differs from `America/New_York`.
 
 This version provides monitoring and local page navigation. Camera feeds, cover
 images, printer pause/stop controls, power switching, cloud login and automatic
@@ -67,6 +75,18 @@ this board. If GT911 is not found at `0x5D`, inspect the I²C scan and use its r
 address (some hardware revisions select `0x14`). Backlight is GPIO2; RGB data pins
 and timings are explicit in the main YAML rather than borrowed from a 5″ board.
 
+The display and LVGL both use **big-endian RGB565**. With `mipi_rgb`'s named
+`red`/`green`/`blue` pin groups, its generated bus pin map already exchanges the
+two bytes. Selecting little-endian pixels corrupts colors on the physical panel
+even though a host preview can look correct. Keep both byte-order settings aligned
+with the bus mapping; changing the RGB/BGR label alone is insufficient for this
+RPI panel's direct framebuffer path.
+
+To check the physical colors, open the device's **Display Color Test** diagnostic
+button in Home Assistant. It shows labeled red, green, blue, white, cyan and magenta
+blocks. Swipe to return to the printers. This test page is skipped during normal
+printer navigation. Its expected image is [previews/color_test.png](previews/color_test.png).
+
 CLI checks from the repository root:
 
 ```sh
@@ -106,7 +126,8 @@ is also tested with seven. Each printer's filament strip supports up to eight sl
 For a dual-nozzle printer add `dual_nozzle: true`. For external filament add
 `external_spools: [{label: EXT, entity: sensor.my_external_spool}]`. Per-metric
 `entities` overrides use the keys in `NUMERIC`, `DUAL`, `TEXT` and `BINARY` inside
-`generate.py`. A remaining-time override also updates its unit subscription.
+`generate.py`. Use `extra_fans: [aux_fan, exhaust_fan]` only where those HA entities
+exist; their mappings are in `EXTRA_FANS`. A remaining-time override also updates its unit subscription.
 Filament entries use the Bambu integration's `type`, `color` and `active` attributes.
 
 ## Development checks and screenshots