diff --git a/.changeset/supported-hardware-table.md b/.changeset/supported-hardware-table.md new file mode 100644 index 0000000..19480fc --- /dev/null +++ b/.changeset/supported-hardware-table.md @@ -0,0 +1,14 @@ +--- +'mysa2mqtt': patch +--- + +Refresh the supported hardware table in the README. + +Several rows had drifted from the code: V2 (non-Lite) thermostats did not mention that their power figure is an +estimate derived from the duty cycle, in-floor thermostats gained ambient/floor sensor selection, and AC thermostats +gained fan-speed control. The ⚠️ markers and "in progress" wording described those caveats as pending work rather than +as characteristics of the hardware, so the supported families are now marked ✅. + +Central-HVAC thermostats (`ST-V1-0`) are listed for the first time, as not supported: they talk to the cloud over AWS +IoT Device Shadows instead of the protocol every other family uses. The row links to the tracking issue and to the +capture instructions, for anyone who owns one and wants to help. diff --git a/packages/mysa2mqtt/README.md b/packages/mysa2mqtt/README.md index 9f08af7..5aaa9ca 100644 --- a/packages/mysa2mqtt/README.md +++ b/packages/mysa2mqtt/README.md @@ -19,13 +19,14 @@ home automation platforms. ## Supported hardware -| Model Number | Description | Supported | -| ------------ | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `BB-V1-X` | Mysa Smart Thermostat for Electric Baseboard Heaters V1 | ✅ Tested and working | -| `BB-V2-X` | Mysa Smart Thermostat for Electric Baseboard Heaters V2 | ⚠️ Partially working, in progress | -| `BB-V2-X-L` | Mysa Smart Thermostat LITE for Electric Baseboard Heaters | ⚠️ Partially working, in progress; does not measure power, but can report an estimate (see [Power reporting](#power-reporting)) | -| `INF-V1-0` | Mysa Smart Thermostat for Electric In-Floor Heating | ⚠️ Partially working, in progress; controls and a floor-temperature sensor are supported, and power can be estimated (see [Power reporting](#power-reporting)) | -| `AC-V1-X` | Mysa Smart Thermostat for Mini-Split Heat Pumps & AC | ⚠️ Partially working, in progress; missing swing and position functions | +| Model Number | Description | Supported | +| ------------ | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `BB-V1-X` | Mysa Smart Thermostat for Electric Baseboard Heaters V1 | ✅ Tested and working | +| `BB-V2-X` | Mysa Smart Thermostat for Electric Baseboard Heaters V2 | ✅ Working; does not measure power, but can report an estimate (see [Power reporting](#power-reporting)) | +| `BB-V2-X-L` | Mysa Smart Thermostat LITE for Electric Baseboard Heaters | ✅ Working; does not measure power, but can report an estimate (see [Power reporting](#power-reporting)) | +| `INF-V1-0` | Mysa Smart Thermostat for Electric In-Floor Heating | ✅ Working; controls, a floor-temperature sensor and ambient/floor sensor selection are supported; does not measure power, but can report an estimate (see [Power reporting](#power-reporting)) | +| `AC-V1-X` | Mysa Smart Thermostat for Mini-Split Heat Pumps & AC | ✅ Working; fan-speed control is supported, but swing and position functions are not | +| `ST-V1-0` | Mysa Smart Thermostat for Central HVAC | 🚫 Not supported — these units talk to the cloud over AWS IoT Device Shadows instead of the protocol every other model uses ([#111](https://github.com/bourquep/mysa2mqtt/issues/111)). **Help wanted:** if you own one, [capture its traffic](#capturing-data-for-a-new-thermostat-type) and attach the file to the issue. | ## Disclaimer