Hey everyone!
I’m excited to announce the Mysa custom integration for Home Assistant. This release adds full support for Mysa AC Controllers and includes comprehensive documentation.
Supported Devices
This integration works with all current Mysa devices:
| Device | Model | Status |
|---|---|---|
| Baseboard V1 | BB-V1 | |
| Baseboard V2 | BB-V2 | |
| Baseboard V2 Lite | BB-V2-L | |
| In-Floor Heating | INF-V1 | |
| AC Controller | AC-V1 | |
| Central HVAC | ? |
What’s New in v0.6.0
AC Controller (AC-V1) Support:
Temperature control
Full HVAC modes: Cool, Heat, Auto, Fan Only, Dry
Fan speed control (Auto, Low, Medium-Low, Medium, High, Sleep)
Vertical and Horizontal swing control
Climate+ thermostatic mode
New Entities for All Devices:
- Switch: Button Lock, Auto Brightness, Wake on Approach, Climate+
- Number: Min/Max Brightness controls
- Select: Horizontal Swing position (AC)
What’s New in v0.7.0
Codebase Improvements:
Merged mysotherm library into single mysa_auth.py (cleaner, easier to maintain)
Added CHANGELOG.md with full release history
Advanced Debug Menu (advanced command):
Lite-to-Full Conversion: Upgrade BB-V2-0-L to BB-V2-0 thermostats
Killer Ping: Reset device to pairing mode (MsgType 5)
Advanced features are experimental - use at your own risk!
Documentation:
Installation
Via HACS (custom repository):
Known Issues
- Slow UI updates for some settings: After changing certain settings (brightness, lock, etc.) from Home Assistant, the updated state may take a moment to reflect in the App. The physical device responds immediately - it’s just the state feedback that can be delayed. I’ll be investigating this further in a future update, but for now everything works correctly on the device side.
Call for Central HVAC Owners!
Mysa recently released a new Central HVAC thermostat and I’d love to add support for it. If you own one, I need your help gathering protocol data!
What to do:
- Clone the repo and navigate to the
tools/directory - Run the debug tool:
pip install websockets requests boto3 prompt_toolkit
python mysa_debug.py
- Enable sniff mode:
CMD> sniff
- Use the Mysa app to control your thermostat and observe the MQTT messages
- Run
state <device_number>to capture the full device state
What I need:
- The Model string (e.g., “HVAC-V1” or similar)
- Sample MQTT messages when changing: temperature, mode, fan speed
- The device’s SupportedCaps field from the state output
- Any unique fields in the device state
Please share your findings in a reply or open a GitHub issue. Screenshots or JSON dumps are very helpful!
Credits
Huge thanks to:
- @dlenski for mysotherm - the authentication and API reverse engineering that made this possible
- @jlitzingerdev for mqttpacket - the MQTT packet implementation
And thanks to everyone in this community for the feedback and testing!
Links:
Let me know if you have any questions or run into issues. Happy automating! ![]()
