Skip to content

Device and Firmware

WikiZell edited this page Aug 11, 2026 · 1 revision

Device and Firmware

HA Proxy Panel is an ESP32 Bluetooth proxy with a local 128x64 OLED climate and status display.

Supported display and wiring

The tested display is the ZHONG JING YUAN 1.29 inch PMOLED, 128x64, monochrome white, CH1115 driver, IIC interface, address 0x3C, module size 20 x 45.8 x 2.7 mm. ESPHome drives it in SH1106 128x64 compatibility mode.

OLED ESP32 Purpose
VCC 3.3V Display power
GND GND Ground
SDA GPIO21 I2C data
SCL GPIO22 I2C clock

Power off before wiring. Use female-to-female or female-to-male Dupont wires according to the headers you soldered.

Display features

  • Climate, Temperature, Humidity, and Proxy Status modes
  • Home Assistant temperature and humidity sources
  • Normal and 180 degree rotation, with 180 degrees as the enclosure-friendly default
  • Brightness from 10 to 100 percent, restored after restart
  • Reserved top title row with scrolling for long names
  • Climate values kept clear of the separator
  • CH1115 edge-wrap correction in both orientations

OLED Care

OLED Care is enabled by default. It shifts safe content by one pixel and runs a short full-screen animation every six hours. The animation uses black, white, sweeping columns, and checkerboard patterns so all pixels participate. It can also be started from Home Assistant or the Manager.

Firmware and ESPHome updates

The panel checks the official project version and reads its Home Assistant ESPHome update entity. A blinking dot announces an available update. The bottom-up tray shows PANEL FW UPDATE, ESPHOME UPDATE, or 2 FW UPDATES without covering climate values.

Connectivity and diagnostics

  • Active ESPHome Bluetooth proxy
  • Automatic ESPHome and Home Assistant discovery
  • Encrypted Home Assistant API and password-protected OTA support
  • Wi-Fi fallback access point with an OLED QR and responsive captive portal
  • IP address, Wi-Fi signal, uptime, connection source, project firmware, ESPHome version, proxy state, and data availability
  • Restart, manual OLED Care animation, and test update notification controls

The ESP32 RESET or EN button resets the board electrically as soon as it is pressed. It cannot distinguish a click from a hold. A separate momentary button on a safe GPIO is required for custom click and hold actions.

Clone this wiki locally