This is a custom integration to control Panasonic Comfort Cloud devices in Home Assistant. It supports Panasonic air conditioners/heat pumps, Panasonic Aquarea air-to-water heat pump systems, and standalone HWS heat pump hot water tanks.
Important
Before installing this integration, please ensure the following steps have been completed in the Panasonic Comfort Cloud App:
- Set Up Two-Factor Authentication (2FA): Complete the entire 2FA setup process.
- Select the SMS Option: It is crucial to choose the SMS option for 2FA. Failing to do so will result in the error "Missing required parameter: code."
For optimal operation, it is also recommended that you use separate accounts for Home Assistant and the Comfort Cloud App.
- Full climate entity for Panasonic air conditioners and heat pumps
- Full climate entity for Panasonic Aquarea zones
- Support for Heat, Cool, Auto, Dry, and Fan modes
- Target temperature control
- Fan mode selection
- Preset modes (Quiet, Powerful, +8/15°C heat)
- Aquarea Hot Water Tank — Water heater entity with target temperature control (40–65°C), operation modes (Heat Pump, Off)
- HWS Hot Water Tank — Water heater entity for standalone HWS heat pump hot water tanks (e.g. HE-UM40CR), target temperature control, operation modes (Heat Pump, Off)
- Horizontal swing mode via Select entity
- Vertical swing mode via Select entity
- Legacy
set_horizontal_swing_modeservice for automations
- Nanoe — Toggle Nanoe air purification (where available)
- ECONAVI — Toggle ECONAVI energy-saving mode (where available)
- AI ECO — Toggle AI ECO mode (where available)
- iAUTO-X — Toggle iAUTO-X intelligent auto mode (where available)
- Zone controls — Toggle individual zone on/off (where available)
- Force DHW — Force domestic hot water mode (Aquarea, where available)
- Force Heater — Force heater mode (Aquarea)
- Holiday Timer — Enable/disable holiday timer (Aquarea)
- Boost Mode — Toggle boost mode (HWS)
- Inside Temperature — Indoor temperature reading
- Outside Temperature — Outdoor temperature reading (where available)
- Daily Energy — Daily energy consumption in kWh (optional)
- Daily Heating Energy — Daily heating energy consumption in kWh (optional)
- Daily Cooling Energy — Daily cooling energy consumption in kWh (optional)
- Current Extrapolated Power — Current power consumption in W (calculated from energy readings)
- Cooling Extrapolated Power — Cooling power consumption in W (calculated from energy readings)
- Heating Extrapolated Power — Heating power consumption in W (calculated from energy readings)
- Zone Temperature — Per-zone temperature reading (where zones are available)
- Connection Status — Current connection status: connected, degraded, disconnected, or authentication_error (diagnostic)
- Last Updated — Timestamp of last device data update (diagnostic)
- Cached Data Age — Timestamp of cached data when device is offline (diagnostic)
- Data Mode — Current data mode: LIVE, CACHED, or OFFLINE (diagnostic)
- Outside Temperature — Outdoor temperature reading (Aquarea)
- Tank Temperature — Hot water tank temperature (Aquarea and HWS, where available)
- Direction — Current operating direction (Aquarea)
- Pump Status — On/Off pump status (Aquarea)
- Consumption Today — Heating, cooling, tank, and total energy consumption for today, in kWh (Aquarea, optional)
- Cost Today — Heating, cooling, and tank cost for today (Aquarea, optional, disabled by default)
- DHW/Zone/Defrost Cycles Today — Daily cycle counters (Aquarea, diagnostic)
- Heat Pump Status — On/Off status of the heat pump unit (HWS, diagnostic)
- Operation Mode (raw) — Raw, unconfirmed operation mode value (HWS, diagnostic, disabled by default)
- Zone Damper Position — Slider control for zone damper (0–100%, in steps of 10)
- Zone Mode — Switch to enable/disable individual zones
- Quiet Mode — Select quiet mode level: level1, level2, level3, or off (Aquarea)
- Powerful Time — Select powerful mode duration: on-30m, on-60m, on-90m, or off (Aquarea)
- Error Status — Indicates if the Aquarea device is in an error state, with a raw fault status attribute (Aquarea)
- Defrost — Indicates if the Aquarea device is in defrost mode (Aquarea)
- Fetch latest data — Manually refresh device data from the cloud
- Fetch latest energy data — Manually refresh energy data from the cloud
- Fetch latest app version — Refresh the app version information
- Request Defrost — Request the Aquarea device to start the defrost process (Aquarea)
- Install HACS, if you haven't already
- Press the Download button
- Restart Home Assistant
- Clone or download this repository
- Copy the
custom_components/panasonic_ccfolder into<homeassistant config>/custom_components/panasonic_cc - Restart Home Assistant
- Add the integration via Settings → Devices & Services → Add Integration and search for "Panasonic Comfort Cloud"
Once installed, add the integration via the Home Assistant UI and enter your Panasonic ID and password:
The initial setup form includes the following options:
| Option | Description | Default |
|---|---|---|
| Panasonic ID | Your Panasonic Comfort Cloud account ID | — |
| Password | Your Panasonic Comfort Cloud password | — |
| Enable daily energy sensors | Create daily energy and current power sensors | Disabled |
| Enable Nanoe switch for all devices | Force the Nanoe switch to appear even if the device doesn't report Nanoe support | Disabled |
| Use Panasonic preset names | Use "Quiet" and "Powerful" instead of "Eco" and "Boost" preset names | Enabled |
| Device fetch interval | How often to poll device data (5–300 seconds) | 120s |
| Energy fetch interval | How often to poll energy data (10–600 seconds) | 300s |
After initial setup, you can modify the following options from the integration's configuration:
| Option | Description | Default |
|---|---|---|
| Force outside sensor | Force the outside temperature sensor to appear even if no reading is available | Disabled |
| Enable daily energy sensors | Create daily energy and current power sensors | Disabled |
| Enable Nanoe switch for all devices | Force the Nanoe switch to appear on all devices | Disabled |
| Use Panasonic preset names | Use "Quiet" and "Powerful" instead of "Eco" and "Boost" | Enabled |
| Device fetch interval | How often to poll device data (5–300 seconds) | 120s |
| Energy fetch interval | How often to poll energy data (10–600 seconds) | 300s |
Tip
Some options require a Home Assistant restart to take effect. The integration will indicate which options need a restart.
The panasonic_cc.set_horizontal_swing_mode service allows you to set the horizontal swing mode for a climate entity.
Service data:
| Field | Description | Required |
|---|---|---|
entity_id |
The climate entity to control | Yes |
swing_mode |
The horizontal swing mode to set | Yes |
Available swing modes: Auto, Left, LeftMid, Mid, RightMid, Right
Example automation:
service: panasonic_cc.set_horizontal_swing_mode
data:
entity_id: climate.living_room_ac
swing_mode: Auto- Account has 2FA enabled — The setup/reconfigure flow shows an extra "Verification code" step after your Panasonic ID and password. Enter the current one-time code from your authenticator app to continue.
- Authentication fails repeatedly — Try resetting your MFA by logging in and out of the Panasonic Comfort Cloud app, then try again.
- Session expired — The integration will notify you when authentication expires. Use the reconfigure option from the integration settings to re-authenticate.
- Cached data — If your device is offline, the integration will show cached data. Check the "Data Mode" diagnostic sensor to see if data is LIVE, CACHED, or OFFLINE.
- Stale readings — Use the "Fetch latest data" button to manually refresh device data.
- No outside temperature — Not all devices report outside temperature. Use the "Force outside sensor" option if you want the sensor entity to always appear.
- Energy data not updating — Ensure "Enable daily energy sensors" is checked in the integration options. Note that energy data resets daily.
- Current power seems inaccurate — Current power is extrapolated from the daily energy reading and may not reflect instantaneous power accurately.
This integration uses the following Python package:
aio-panasonic-comfort-cloud— For Panasonic air conditioners/heat pumps, Aquarea air-to-water heat pumps, and standalone HWS hot water tanks
- Report issues: GitHub Issues
- Contribute: See CONTRIBUTING.md
- Buy me a coffee: ☕ Buy Me a Coffee