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, limited to the fan speeds the unit supports (ducted/commercial units may have only Low/Mid/High or a fixed fan speed)
- Preset modes (Quiet, Powerful, +8/15°C heat), where the unit supports them
- 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) with the current tank temperature, operation modes (Schedule, PV Timer, Holiday — as supported by the unit), away mode (Holiday) and the weekly schedule as the
weekly_scheduleattribute
- 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)
- Holiday Timer — Switch between Holiday and Schedule mode (HWS)
- Weekly Timer — Turn the weekly schedule of an air conditioner on/off; the schedule is in the
scheduleattribute (where available) - Weekly Timer — Turn the weekly schedule of an Aquarea heat pump on/off; the schedule is in the
scheduleattribute and the allowed setpoint ranges inzone1_limits,zone2_limitsandtank_limits(where available)
- 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 — Whether the heat pump unit is running: on, off or unknown (HWS, diagnostic)
- Outside Temperature — Outdoor temperature reading (HWS)
- Tank Consumption Today — Tank energy consumption for today, in kWh (HWS, optional)
- Tank Cost Today — Tank cost for today (HWS, optional, disabled by default)
- Boost Mode Status — Whether boost mode is active (HWS, diagnostic)
- Operation Mode — Schedule, PV Timer or Holiday (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: AutoThe panasonic_cc.set_weekly_timer_day service replaces the patterns of one or more days of an air conditioner's weekly timer. Target the device's Weekly Timer switch. Like the Comfort Cloud app, saving turns the weekly timer on unless enabled is false.
| Field | Description | Required |
|---|---|---|
weekdays |
Days to replace: monday … sunday |
Yes |
patterns |
Up to 6 patterns. Each has start_time (HH:MM) and optionally power (on/off), mode (auto, dry, cool, heat, fan), temperature (°C) and fan_speed (auto, low, low_mid, mid, high_mid, high). An empty list clears the days. |
Yes |
enabled |
Whether the weekly timer is on after saving (default true) |
No |
The switch's schedule attribute uses the same format, so a day can be copied from it.
service: panasonic_cc.set_weekly_timer_day
target:
entity_id: switch.living_room_ac_weekly_timer
data:
weekdays: [monday, tuesday, wednesday, thursday, friday]
patterns:
- start_time: "06:30"
power: "on"
mode: heat
temperature: 21.5
fan_speed: auto
- start_time: "22:00"
power: "off"The panasonic_cc.set_aquarea_weekly_timer_day service replaces the patterns of one or more days of an Aquarea heat pump's weekly timer. Target the Aquarea device's Weekly Timer switch. Like the Comfort Cloud app, saving turns the weekly timer on unless enabled is false.
| Field | Description | Required |
|---|---|---|
weekdays |
Days to replace: monday … sunday |
Yes |
patterns |
Up to 6 patterns. Each has start_time (HH:MM) and optionally mode (heat, cool, auto), zone1/zone2 (on/off) with zone1_heat, zone1_cool, zone2_heat, zone2_cool setpoints (whole °C), and tank (on/off) with tank_temperature (whole °C). Leave out zones or the tank the unit doesn't have. An empty list clears the days. |
Yes |
enabled |
Whether the weekly timer is on after saving (default true) |
No |
The switch's schedule attribute uses the same format, so a day can be copied from it. Keep setpoints within the ranges in the switch's zone1_limits, zone2_limits and tank_limits attributes. This follows the Comfort Cloud app's requests but hasn't been tested against a real unit yet.
service: panasonic_cc.set_aquarea_weekly_timer_day
target:
entity_id: switch.aquarea_weekly_timer
data:
weekdays: [monday, tuesday, wednesday, thursday, friday]
patterns:
- start_time: "06:00"
mode: heat
zone1: "on"
zone1_heat: 22
tank: "on"
tank_temperature: 50
- start_time: "22:00"
mode: heat
zone1: "on"
zone1_heat: 18The panasonic_cc.set_hws_weekly_schedule service replaces the weekly schedule of a standalone HWS hot water tank. It takes weekly_schedule, a list of days in the same format as the water heater's weekly_schedule attribute (every day needs a weekday and a mode), so copy the attribute, edit it, and send it back.
- 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