This is a custom integration to control Panasonic Comfort Cloud devices in Home Assistant. It supports both Panasonic air conditioners/heat pumps and Panasonic Aquarea heat pump systems.
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)
- 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)
- 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, where available)
- Direction — Current operating direction (Aquarea)
- Pump Status — On/Off pump status (Aquarea)
- Accumulated Energy — Heating, cooling, tank, and total accumulated energy consumption in kWh (Aquarea)
- 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 error code and message attributes (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- "Missing required parameter: code" — You must use SMS-based 2FA. Other 2FA methods are not supported.
- 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 packages:
aio-panasonic-comfort-cloud— For Panasonic air conditioners and heat pumpsaioaquarea— For Panasonic Aquarea heat pump systems
- Report issues: GitHub Issues
- Contribute: See CONTRIBUTING.md
- Buy me a coffee: ☕ Buy Me a Coffee
