Code Monkey home page Code Monkey logo

home-assistant-aquarea's Introduction

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!

⚠️ Make sure to read the 'Remarks' and 'Warning' sections

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 presets in the climate entity

Features in the works

  • Weekly schedule.
  • Set the device in eco mode/holiday mode (if the device supports it).
  • Set the device in away mode (if the device supports it).
  • Additional sensors/switches for the device.

⚠️ 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.

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.

Minimum Home Assistant version required

The minimum supported version of Home Assistant is 2023.4

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.

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.

home-assistant-aquarea's People

Contributors

cjaliaga avatar kuadam avatar lcavalli avatar drawgas avatar pjbaert avatar afharo avatar shajek avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.