🌡️ Mysa Integration - Call for New Mysa Central HVAC Testers

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 :white_check_mark: Supported
Baseboard V2 BB-V2 :white_check_mark: Supported
Baseboard V2 Lite BB-V2-L :white_check_mark: Supported(Also support upgraded Lite)
In-Floor Heating INF-V1 :white_check_mark: Supported
AC Controller AC-V1 :white_check_mark: New in v0.6.0
Central HVAC ? :magnifying_glass_tilted_left: Looking for testers

What’s New in v0.6.0

AC Controller (AC-V1) Support:

  • :thermometer: Temperature control
  • :snowflake: Full HVAC modes: Cool, Heat, Auto, Fan Only, Dry
  • :dashing_away: Fan speed control (Auto, Low, Medium-Low, Medium, High, Sleep)
  • :counterclockwise_arrows_button: Vertical and Horizontal swing control
  • :thermometer: 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:

  • :broom: Merged mysotherm library into single mysa_auth.py (cleaner, easier to maintain)
  • :memo: Added CHANGELOG.md with full release history

Advanced Debug Menu (advanced command):

  • :unlocked: Lite-to-Full Conversion: Upgrade BB-V2-0-L to BB-V2-0 thermostats
  • :skull: Killer Ping: Reset device to pairing mode (MsgType 5)

:warning: Advanced features are experimental - use at your own risk!

Documentation:

Installation

Via HACS (custom repository):


:warning: 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.

:loudspeaker: 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:

  1. Clone the repo and navigate to the tools/ directory
  2. Run the debug tool:

pip install websockets requests boto3 prompt_toolkit

python mysa_debug.py

  1. Enable sniff mode:

CMD> sniff

  1. Use the Mysa app to control your thermostat and observe the MQTT messages
  2. 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!


:folded_hands: Credits

Huge thanks to:

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! :house:

5 Likes

Hey everyone! It’s been a busy few weeks, and I’m excited to share some major updates to the Mysa Home Assistant integration. We’ve moved from v0.7.0 to v0.8.1, bringing several requested features and stability improvements.

:rocket: Highlights in v0.8.x
:lock: Reauthentication Support: No more deleting and re-adding your devices! If you change your Mysa password, Home Assistant will now prompt you to re-authenticate directly.

:zap: Simulated Energy Tracking: For all Baseboard V2 Lite (BB-V2-0-L) owners, you can now enable simulated current and power sensors. By setting your heater’s estimated max wattage in the integration options, the integration will calculate real-time energy usage based on the device’s duty cycle.

:hammer_and_wrench: New Diagnostic Tools:
Diagnostics Downloads: You can now download a sanitized JSON dump of your device state to help with troubleshooting.

:satellite: Improved Connectivity: We’ve overhauled the MQTT token renewal logic, fixing the “ghosting” issue where devices would stop responding after ~10 hours.
:label: Smarter Zone Names: Zones now use their friendly names (e.g., “Master Bedroom”) from the Mysa app instead of UUIDs. Plus, they can automatically sync to Home Assistant Areas during setup.

:sparkles: “Magic Upgrade” Support: If you’ve used the Mysa Debug app to upgrade your Lite hardware to “Full” firmware, there’s now an option in the configuration to support this properly.

:test_tube: Still Calling for Central HVAC Testers!
I am still actively looking for testers who own the new Mysa for Central HVAC (HVAC-V1) units. If you have one, I’d love to get some protocol data to bring it into the fold!

You can use the built-in mysa_debug.py tool in the tools/ directory to capture the state. If you can help, please reach out here or on the GitHub issues page.

:package: How to Update
The latest version is available now via HACS. Simply head to the HACS panel and check for updates.

Thanks again to everyone who has been testing and providing feedback. It’s making a huge difference in making this integration robust!

:rocket: Highlights in v0.8.2

:battery: Native Energy Tracking
We’ve added a Virtual Energy (kWh) entity for all devices. This sensor performs a Riemann sum integration of the power sensor (real or simulated) to track your energy usage over time directly in Home Assistant. This is perfect for the Energy Dashboard!

:thermometer: Improved Floor Heating Support
Floor Sensor Enabled: The “Infloor Temperature” sensor is now enabled by default.

:sparkles: “Magic Upgrade” for Lite Devices
For users with Mysa Baseboard V2 Lite devices, we’ve introduced a new service: mysa.upgrade_lite_device.

This service unlocks the “Full” feature set by updating the device firmware model ID.
Note: This is primarily for users who use the official Mysa App. The Lite thermostat works perfectly in HA without this upgrade.
A revert service mysa.downgrade_lite_device is also available.

:hammer_and_wrench: Robustness & Testing
Optimistic UI: Controls now feel snappier with instant feedback in the Lovelace UI.

just installed this… seems to be pretty dang nice! was previously looking at the mysa2mqtt, but this will not work if you are running HAOS. This integretion leverages user creds and is seamless! nice work!

Can you confirm which device you have?

I do have AC and BB v2 I know someone is using infloor.

The rest is mainly from mysotherm great project who provided source for protocol and got me to kickstart this integration.

If you or someone have BB v1 , BB lite or a AC with fan mode only and confirm it’s working. This would be great :slightly_smiling_face:

believe mine is a BB v1
Model: v1
Device Version: 3.16.2.3

its been offline for over a year now.
I bought it in 2020-2021 time period

my neighbor has about 10-12 units online for his house (baseboard heating)… unsure which ones though. I’m getting him hooked up in HA, so will know this soon.

if V1 great to see it’s working fine :slight_smile:
2020-2021 is definitively in the V1 release date

you can see the info under devices and services , Mysa

This is fantastic. I’ve had so many issues with the Mysa to HomeKit to HA route and this was such an easy setup. A couple questions:

I don’t seem to see Current Temperature and Current Humidity as entities. Am I missing something?

Will it pull my electricity rate in from the Mysa app or do
I need to set that myself in the config or otherwise?

i just added these sensor with a major refactoring.
look for a release soon
out of curiosity which version you have?

Electricity rate is pulled from app info but you can override it with mysa_extended but otherwise you don’t need mysa_extended

Version 0.8.10. I have my electricity rate set in the Mysa app but I’m not seeing it in HA.

Hi !
I’m new to all of this, so I apologize if this isn’t the right place to ask questions, or discuss bugs I’ve encountered.

I’ve managed to install this Mysa HA integration through HACS, and first, I must say I was really impressed at how well everything just loaded up on the first try. As someone with basically no prior knowledge of HA or anything on how all of this works, the setup was a breeze.

I did notice a few glitches however, mainly with the AC-V1 and mode selections.

OFF : does nothing beside set the display in HA to “off” (while the minisplit continues doing its thing)
HEAT/COOL : works as expected (sets it to Auto)
HEAT : Turns the minisplit off
COOL : Sets it to Auto (Heat/Cool)
FAN : works as expected
DRY : sets it to cooling

The only other thing I’ve noticed was that while I can send commands through home assistant and the status changes according to commands sent, if anything changes after, (on device or via Mysa app) these changes won’t always be reflected in HA unless I restart it.

I don’t know if there is something I should be doing differently, and honestly don’t even know where to try to look to figure this out.

Anyways, props for the amazing work that’s already been done. If I can help in any way and learn at the same time, I’d love to !

Yeah just found out this.
I’m looking into this and fixing it right now.
That’s the last bug on my list for the next version

That is awesome news. Thank you so much.

:rocket: Release 0.9.0 is now live!

I’m excited to announce version 0.9.0. This release represents a massive effort to improve stability and reliability.

:glowing_star: Highlights

  • Refactoring: Major internal cleanup to better align with Home Assistant best practices.

:warning: Important: Breaking Change

As part of the refactoring, some entity names (IDs) may have changed. If you have automations or dashboard cards that rely on specific entity IDs, please verify them after updating, as they might need to be adjusted to match the new format.

Hopefully, this release fixes all known issues. Thank you for your support! :house::sparkles:

Update: I just pushed a fix for a bug where energy costs were being calculated incorrectly for users with currency symbols in their electricity rate. I will fix it in the next release soon!

:rocket: Release: Mysa for Home Assistant v0.9.1

I am excited to announce the release of v0.9.1! This update brings several important stability fixes, new features for In-Floor users, and improved diagnostic tools.

:glowing_star: What’s New?

In-Floor Thermostat Enhancements

  • Sensor Mode Selector: A new Sensor Mode select entity is now available for INF-V1 devices. You can now manually switch between “Ambient” and “Floor” modes directly from Home Assistant.

  • Improved Temperature Accuracy: Fixed an issue where In-Floor units could display the wrong temperature source. We’ve also added 0.5°C rounding to setpoint operations to prevent the UI from “snapping back” when adjusting temperatures.

  • Tracked Sensor Support: Better automatic detection of the active sensor mode (Ambient vs Floor).

AC Controller Stability

  • Dry Mode Fix: Resolved a bug where entering “Dry” mode would cause the target temperature to reset to 0.0. The integration now correctly maintains your setpoint.

Reliability & Performance

  • Ghost Device Filtering: Devices not assigned to a specific Home or Zone in the Mysa App (which previously disappeared) now show up in Home Assistant as “Unassigned.”

  • MQTT Stability: Resolved a persistent reconnection loop (Error 1005) and improved handling of complex JSON payloads. No more mysterious disconnects!

  • Consolidated Test Suite: Streamlined the internal testing to ensure better long-term reliability.

:hammer_and_wrench: How to Update

  • HACS: The update should appear automatically in HACS. If you don’t see it, go to the Mysa repository and select “Redownload” or “Update.”

  • Manual: Pull the latest code and copy the custom_components/mysa folder to your config/ directory.


Thank you to everyone who tested the beta releases and provided feedback! Your support helps make this integration better for the entire community.

If you encounter any issues, please report them on our GitHub Issues page.

Happy automating! :house::sparkles:

This is great, thanks for putting it together. I have 13 BB-V2-0-L which have all showed up. Only been running for a few hours but seems good so far. Thanks again!

Hello,
I have installed repository and added the integration
I have 3 baseboard lites working perfectly,
I have an HVAC thermostat as well that showed up but not reporting correctly, i see there are some extra steps but i am very new to home assistant so i am not familiar with them so i was wondering if you had a bit more in depth instructions on how to do these so i can get this working!

1 Like

Thank you for this integration. Is there a way to swap the modes so you can set Home/Away/Vacation?

Holy! didn’t know this integration existed! I’ve been goin nuts with homekit etc… Thanks fo the aweome work! So far works great! Installed with 5 baseboead thermostats and 3 mini splits. Nice!