homebridge-ge-ac 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+All notable changes to this project are documented here. This project follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.1] - 2026-06-21
+
+### Fixed
+- Mode switches could show as generic "Switch 1/2/3" in the Home app after re-pairing. Switched
+  to the canonical `ConfiguredName` pattern (declare as optional + set a plain writable value, no
+  `onGet` override) so the Home app reliably reads the real names and user renames survive restarts.
+
+### Changed
+- The **Fan** tile now sits right after the thermostat (before the mode switches).
+
+## [1.2.0] - 2026-06-21
+
+### Added
+- **Dedicated Fan accessory** with an **Auto ⇄ Manual** toggle plus a Low/Med/High speed
+  slider, mirroring the GE app's Auto/Low/Medium/High fan settings.
+
+### Changed
+- Fan speed moved off the thermostat's rotation-speed slider — Apple's Home app never
+  rendered it there — onto its own Fan service on the same accessory (it groups with the AC).
+- Restored-accessory service changes are now persisted via `updatePlatformAccessories`, so
+  added services and removed characteristics survive Homebridge restarts.
+
+### Removed
+- The unused `RotationSpeed` characteristic on the HeaterCooler (the Home app never showed it).
+
+## [1.1.0] - 2026-06-19
+
+### Added
+- **Adaptive temperature range** read from the unit (`0x7B06`) instead of a hard-coded
+  64–86 °F, falling back to 64–86 °F when the unit doesn't report one.
+- **Experimental heat/cool support**: when a unit reports a heating setpoint (`0x7002`), the
+  plugin also exposes a Heat thermostat mode, a heating setpoint, and a Heat switch.
+  ⚠️ Untested on real heat hardware — please [open an issue](https://github.com/fabricore-eng/homebridge-ge-ac/issues) with results.
+
+### Changed
+- Honest compatibility scoping in the README/description: built and tested only on the
+  cooling-only GE Profile **AHTT06BC**; other GE Wi-Fi window ACs are likely but unverified.
+- The per-model "available modes" ERD (`0x7B00`) is deliberately ignored — GE window ACs
+  report a value that doesn't match the documented bitmask.
+
+## [1.0.0] - 2026-06-19
+
+### Added
+- Initial release: HomeKit control of GE SmartHQ Wi-Fi window air conditioners over GE's
+  realtime **WebSocket** channel — setpoint/mode/fan writes the appliance actually honors
+  (REST writes are accepted but silently dropped on this AC line).
+- **HeaterCooler** thermostat: on/off, target temperature, current temperature, with the
+  slider grid aligned to whole Fahrenheit degrees so both 64 °F and the maximum set cleanly.
+- **Named mode switches**: Cool, Fan Only, Energy Saver, Dry — each sets `ConfiguredName`, so
+  HomeKit never shows "Switch 1–5".
+- **Fan speed** control and **live state updates** pushed from the WebSocket subscription, so
+  changes made in the GE app or on the unit reflect in HomeKit in real time.
+- Resilience: app-level keepalive, OAuth token refresh ahead of expiry, and
+  exponential-backoff auto-reconnect.
+
+[1.2.1]: https://github.com/fabricore-eng/homebridge-ge-ac/releases/tag/v1.2.1
+[1.2.0]: https://github.com/fabricore-eng/homebridge-ge-ac/releases/tag/v1.2.0
+[1.1.0]: https://github.com/fabricore-eng/homebridge-ge-ac/releases/tag/v1.1.0
+[1.0.0]: https://github.com/fabricore-eng/homebridge-ge-ac/releases/tag/v1.0.0

package/README.md

@@ -103,6 +103,10 @@ The GE SmartHQ / Brillion protocol details (OAuth flow, WebSocket envelopes, ERD
 encodings) were derived from the excellent [`simbaja/gehome`](https://github.com/simbaja/gehome)
 Python library. This plugin is an independent JavaScript implementation.
 
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for per-release notes.
+
 ## License
 
 ISC — see [LICENSE](LICENSE).

package/lib/accessory.js

@@ -84,6 +84,27 @@ class ACAccessory {
     hc.getCharacteristic(this.Ch.TemperatureDisplayUnits)
       .onGet(() => (this.client.getState(this.mac, C.ERD.TEMP_UNIT) === '01') ? this.Ch.TemperatureDisplayUnits.CELSIUS : this.Ch.TemperatureDisplayUnits.FAHRENHEIT);
 
+    // ---- Fan (Fanv2): Auto/Manual toggle + Low/Med/High slider, bound to fan ERD 0x7A00 ----
+    // Built right after the thermostat so its tile sits second, before the mode switches.
+    // Apple Home renders this as a proper Fan tile (with an Auto switch), unlike a HeaterCooler's RotationSpeed.
+    const fan = accessory.getService(this.S.Fanv2) || accessory.addService(this.S.Fanv2, `${name} Fan`, 'GEAC_FANV2');
+    this.fan = fan;
+    this._configuredName(fan, 'Fan');
+    const TFS = this.Ch.TargetFanState, CFS = this.Ch.CurrentFanState, ACT = this.Ch.Active;
+    fan.getCharacteristic(ACT)
+      .onGet(() => this._power() ? ACT.ACTIVE : ACT.INACTIVE)
+      .onSet(this._wrap(async (v) => { await this.client.setErd(this.mac, C.ERD.POWER, v === ACT.ACTIVE ? C.POWER.ON : C.POWER.OFF); }));
+    fan.getCharacteristic(CFS)
+      .onGet(() => this._power() ? CFS.BLOWING_AIR : CFS.INACTIVE);
+    fan.getCharacteristic(TFS)
+      .onGet(() => this._fanIsAuto() ? TFS.AUTO : TFS.MANUAL)
+      .onSet(this._wrap(async (v) => {
+        await this.client.setErd(this.mac, C.ERD.FAN, v === TFS.AUTO ? C.FAN.AUTO : this._fanFromPct(this._fanSpeedPct()));
+      }));
+    fan.getCharacteristic(this.Ch.RotationSpeed) // continuous slider; onSet maps to Low(<=34)/Med(<=67)/High
+      .onGet(() => this._fanSpeedPct())
+      .onSet(this._wrap(async (pct) => { await this.client.setErd(this.mac, C.ERD.FAN, this._fanFromPct(pct)); }));
+
     // ---- mode switches ----
     const defs = [
       ['Cool', 'GEAC_COOL', C.MODE.COOL],
@@ -106,27 +127,6 @@ class ACAccessory {
       return { sw, modeHex };
     });
 
-    // ---- Fan (Fanv2): Auto/Manual toggle + Low/Med/High slider, bound to fan ERD 0x7A00 ----
-    // Apple Home renders this as a proper Fan tile (with an Auto switch), unlike a HeaterCooler's
-    // RotationSpeed. Same accessory, so it groups with the thermostat + mode switches.
-    const fan = accessory.getService(this.S.Fanv2) || accessory.addService(this.S.Fanv2, `${name} Fan`, 'GEAC_FANV2');
-    this.fan = fan;
-    this._configuredName(fan, 'Fan');
-    const TFS = this.Ch.TargetFanState, CFS = this.Ch.CurrentFanState, ACT = this.Ch.Active;
-    fan.getCharacteristic(ACT)
-      .onGet(() => this._power() ? ACT.ACTIVE : ACT.INACTIVE)
-      .onSet(this._wrap(async (v) => { await this.client.setErd(this.mac, C.ERD.POWER, v === ACT.ACTIVE ? C.POWER.ON : C.POWER.OFF); }));
-    fan.getCharacteristic(CFS)
-      .onGet(() => this._power() ? CFS.BLOWING_AIR : CFS.INACTIVE);
-    fan.getCharacteristic(TFS)
-      .onGet(() => this._fanIsAuto() ? TFS.AUTO : TFS.MANUAL)
-      .onSet(this._wrap(async (v) => {
-        await this.client.setErd(this.mac, C.ERD.FAN, v === TFS.AUTO ? C.FAN.AUTO : this._fanFromPct(this._fanSpeedPct()));
-      }));
-    fan.getCharacteristic(this.Ch.RotationSpeed) // continuous slider; onSet maps to Low(<=34)/Med(<=67)/High
-      .onGet(() => this._fanSpeedPct())
-      .onSet(this._wrap(async (pct) => { await this.client.setErd(this.mac, C.ERD.FAN, this._fanFromPct(pct)); }));
-
     // live updates
     this._onErd = (m) => { if (m === this.mac) this._pushAll(); };
     client.on('erd', this._onErd);
@@ -134,9 +134,13 @@ class ACAccessory {
   }
 
   _configuredName(svc, name) {
+    // Canonical pattern for naming multiple same-type services so the Home app shows real names
+    // (not "Switch 1/2/3"): declare ConfiguredName as optional and set it as a plain writable value.
+    // No onGet override — that both confuses some Home clients and would clobber a user rename.
+    // Seed our default only when empty so a user's rename survives restarts.
+    svc.addOptionalCharacteristic(this.Ch.ConfiguredName);
+    if (!svc.getCharacteristic(this.Ch.ConfiguredName).value) svc.setCharacteristic(this.Ch.ConfiguredName, name);
     svc.setCharacteristic(this.Ch.Name, name);
-    if (!svc.testCharacteristic(this.Ch.ConfiguredName)) svc.addCharacteristic(this.Ch.ConfiguredName);
-    svc.getCharacteristic(this.Ch.ConfiguredName).onGet(() => name).updateValue(name);
   }
 
   // ---- state helpers ----

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-ge-ac",
   "displayName": "GE Profile AC (SmartHQ WebSocket)",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Homebridge plugin for GE SmartHQ Wi-Fi window air conditioners over GE's realtime WebSocket channel (reliable setpoint/mode/fan control). Built and tested on the cooling-only GE Profile AHTT06BC; likely works on similar GE Wi-Fi window ACs (unverified).",
   "author": "Fabricore",
   "license": "ISC",
@@ -30,7 +30,8 @@
   "files": [
     "index.js",
     "lib/",
-    "config.schema.json"
+    "config.schema.json",
+    "CHANGELOG.md"
   ],
   "dependencies": {
     "axios": "^1.7.0",