Skip to content

cjaliaga/home-assistant-aquarea

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Manage Panasonic Aquarea Smart Cloud devices from Home Assistant

hacs_badge GitHub Release (latest SemVer including pre-releases)

Panasonic Aquarea Smart Cloud is a cloud service that allows you to control your Panasonic Aquarea heat pump from your smartphone. This integration allows you to control your heat pump from Home Assistant.

The integration uses aioaquarea to communicate with the Panasonic Aquarea Smart Cloud service.

This integration is currently in beta. Please report any issues you find and any feedback you may have. Thanks!

⚠️ As of March 18th, 2024 Panasonic changed the way to log into Aquarea Smart Cloud

  • Changes has been merged and released with version > 0.7.0 thanks to priceless bimusiek help.
  • Please report any issue regarding the new auth changes in the pinned issue: #105
  • The investigation was peformed in the aioaquarea repository: cjaliaga/aioaquarea#44

Features

  • Climate entity per device zone that allows you to control the operation mode, read the current temperature of the water in the device/zone and (if the zone supports it), change the target temperature.
  • Sensor entity for the outdoor temperature.
  • Water heater entity for the hot water tank (if the device has one), that allows you to control the operation mode (enabled/disabled) and read the current temperature of the water in the tank.
  • Diagnostic sensor to indicate if the device has any problem (such not enough water flow).
  • Energy consumption sensors (accumulated and sensors that reset the cycle every hour)
  • Quiet mode select entity
  • Request defrost
  • Powerful mode select entity
  • Holiday timer
  • Force DHW
  • Force heater
  • Set the device in eco mode/comfort mode (if the device supports it).

Features in the works

  • Weekly schedule.
  • Improve translations
  • Rework of the water tank entity
  • Additional sensors/switches for the device.

Remarks

Panasonic only allows one connection per account at the same time. This means that if you open the session from the Panasonic Confort Cloud app or the Panasonic Confort Cloud website, the session will be closed and you will be disconnected from Home Assistant. The integration will try to reconnect automatically, clossing the session from the app or the website. If you want to use the app or the website, you will have to temporarily disable the integration.

A possible solution to this behaviour is to create a second account specifically for home assistant.

  1. Go to https://csapl.pcpf.panasonic.com/ and create a new account.
  2. Then login with your new account into https://aquarea-smart.panasonic.com/.
  3. You will be asked to enter your device id and your password. Enter the device id which is label on your Wifi Module (e.g. CZ-TAW1) and your password which you already created with your main account.
  4. Now you will get a user request to your main account. It should be somewhere under Users -> Userlist. Accept this user request.
  5. Use the new panasonic acount to setup your "Panasonic Aquarea Smart Cloud" home assistant integration.

Now it should be possible to access the aquarea smart cloud website and also use the home assistant integration at the same time.

Minimum Home Assistant version required

The minimum supported version of Home Assistant is 2024.2

Installation

Using HACS (recommended)

  1. Download the integration via (one of them):

    • Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.
    • Go to HACS > Integrations > Look for "Aquarea"
  2. Restart Home Assistant

  3. Add integration via (one of them):

    • Open your Home Assistant instance and start setting up a new integration.
    • Go to "Settings" >> "Devices & Services", click "+ ADD INTEGRATION" and select "Aquarea Smart Cloud"
  4. Follow the configuration steps. You'll need to provide your Panasonic ID and your password. The integration will discover the devices associated to your Panasonic ID.

Manual installation

  1. Copy the folder named aquarea from the latest release to the custom_components folder in your config folder.
  2. Restart Home Assistant
  3. Add integration via (one of them):
    • Open your Home Assistant instance and start setting up a new integration.
    • Go to "Settings" >> "Devices & Services", click "+ ADD INTEGRATION" and select "Aquarea Smart Cloud"
  4. Follow the configuration steps. You'll need to provide your Panasonic ID and your password. The integration will discover the devices associated to your Panasonic ID.

⚠️ Update to v0.2.0 from v0.1.X

If you are updating from a version prior to v0.2.0, the recommendation is for you to remove the integration and add it again before updating. This is because v0.2.0 introduces a breaking change in the unique id generation for the entities. If you don't remove the integration and add it again, you will end up with duplicate entities.

This is a one time thing during the beta that was needed in order to support multiple devices and zones. From now on, the unique id generation will be stable and you won't need to remove the integration and add it again.

Warning

This integration is currently in beta. It supports several devices but it has been tested with a single device. If you have multiple devices under the same Panasonic ID, please test it and report any issue you find.

The integration also supports devices with several zones, but it has not been tested with multiple zones. If you have a device with multiple zones, please test it and report any issue you find.

The integration has been tested with a heat pump with a hot water tank, but it has not been tested with a heat pump without a hot water tank. If you have a heat pump without a hot water tank, please test it and report any issue you find.

Disclaimer

THIS PROJECT IS NOT IN ANY WAY ASSOCIATED WITH OR RELATED TO PANASONIC. The information here and online is for educational and resource purposes only and therefore the developers do not endorse or condone any inappropriate use of it, and take no legal responsibility for the functionality or security of your devices.

Acknowledgements and alternatives

  • Big thanks to ronhks for his awesome work on the Panasonic Aquaera Smart Cloud integration with MQTT. You can use his integration if you want to use MQTT instead.
  • Panasonic introduced authentication breaking changes on March 18th 2024. A heartfelt thank you to bimusiek for generously sharing their implementation in the Homebridge plugin. Their contribution played a crucial role in having the integration working back, and I am truly grateful for their remarkable help.