Skip to main content

Panasonic Comfort Cloud smart home integration, free and open source

Panasonic Comfort Cloud integration for Gladys Assistant

Panasonic air conditioners and heat pumps via Comfort Cloud: mode, setpoint, fan, swing, energy.

View on GitHubAll integrations

Control your Panasonic air conditioners and air-to-air heat pumps from Gladys, through the Panasonic Comfort Cloud: on/off, mode, setpoint, fan speed, louvers, Powerful and Quiet modes, nanoe, ECONAVI and AI Eco, indoor and outdoor temperature, and the energy consumed.

Developed without the hardware: feedback welcome. This integration was written and tested against recorded answers of the Comfort Cloud API and the reference open-source client, not against a real account or unit. Please report what works and what does not on GitHub.

This integration is not affiliated with Panasonic.

Compatible hardware​

Every Panasonic air conditioner or air-to-air heat pump (Etherea, TZ, Z, ducted and cassette units...) set up in the Panasonic Comfort Cloud app, with its Wi-Fi adapter (built in, or CZ-TACG1 / CZ-CAPWFC1). Each indoor unit becomes one Gladys device.

Not supported: the Aquarea air-to-water heat pumps and the hot water tanks, even when they appear in the same app (the search counts them as "not supported").

Requirements​

  • Gladys 5.2.0 or later.
  • A Panasonic ID (e-mail and password) with the units in its Comfort Cloud app.
  • Internet access for Gladys: everything goes through the Panasonic cloud, nothing is local.
  • If your account uses two-factor authentication, your authenticator app at hand for the first sign-in.

Installation and configuration​

  1. In Gladys, open Integrations → Install from GitHub and enter https://github.com/guim31/gladys-panasonic-cc.
  2. Open the integration's Configuration tab. The settings:
    • Panasonic ID (e-mail) and Password: those of the Comfort Cloud app. Tip: Panasonic lets you share the units with a second account in the app; a dedicated account for Gladys keeps your own sessions apart.
    • Refresh interval: how often each unit is read (2 minutes by default, like the Home Assistant integration).
    • Language of the feature names: language of the feature names of the new devices (French by default). The devices themselves keep the names given in the app.
    • Advanced, Comfort Cloud app version: leave empty. Panasonic only answers recent versions of its app; the integration reads the current one from Google Play by itself. Fill it in only if the connection status says the version is refused.
  3. Open the Discovery tab: every indoor unit of the account appears under its name in the app. Add the ones you want to Gladys.

The Search for air conditioners button (Configuration tab) reads the account again and lists every unit, its model and whether it answers.

Two-factor authentication​

If Panasonic asks for a code, the connection status says so. Open the authenticator app, then run Sign in with a 2FA code (Configuration tab) with the 6-digit code shown, within 30 seconds. The session is then kept in Gladys: the code is only needed again if Panasonic asks for a new sign-in.

What is stored​

The integration keeps in its own volume (/data, readable by the container only) the Comfort Cloud session (access and refresh tokens), the app version and the energy counter of each unit. The password stays in the Gladys configuration and is only sent to Panasonic when the session cannot be renewed. Neither the password nor the tokens are ever written in the logs.

Devices and features​

Each indoor unit is one Gladys device. Its features depend on what the unit announces:

FeatureWhat it does
On/offTurns the unit on or off.
ModeAuto, Cool, Heat, Dry, Fan (only the modes the unit has). Choosing a mode turns the unit on.
Target temperatureThe setpoint, by half degrees, from 16 to 30 °C (from 8 °C on the units with the 8/15 °C frost protection).
Fan speedAuto, Low, Low-Med, Medium, Med-High, High.
Vertical swing, Horizontal swingSwing (Panasonic's "Auto"), or one of five fixed positions; the horizontal one only on the units with a left/right louver.
Indoor temperatureThe temperature measured by the indoor unit.
Outdoor temperatureThe temperature measured by the outdoor unit, when it reports one.
Powerful mode, Quiet modePanasonic's special modes; they exclude each other. Only on the units that have them.
nanoe, ECONAVI, AI EcoThe air purification and the eco sensors of the units that have them.
Energy todayWhat the unit consumed today (kWh), from the Comfort Cloud history.
Energy consumedA counter (kWh) that only goes up, built from the daily history, for Gladys' energy monitoring. It starts with the current month.

A setpoint, louver position or special mode asked while the unit is off does not turn it on: it is shown at once, kept, and sent with the next power-on (like the reference client without automatic power-on). A scene preparing the night setpoint therefore never starts the unit by surprise. The fan speed, nanoe, ECONAVI and AI Eco are sent at once.

The changes made with the remote or the app are picked up at the next reading.

Widget​

The Air conditioner widget (choose the unit in its settings) shows the room temperature, the setpoint and the outdoor temperature (or the energy of the day), then the mode, the fan speed, the special mode and the energy of the day. Its buttons:

  • Turn on / Turn off;
  • −0.5 °C and +0.5 °C;
  • Mode and fan: a small form to choose the mode, the fan speed and the special mode together, sent in one call; the unit is switched on.

Scene trigger​

  • Panasonic sign-in needed: Comfort Cloud no longer accepts the session. The reason is available to the scene as a variable (reason): password (password refused), two_factor (a code is needed) or terms (new terms of use to accept in the app). It fires once per problem, not at every attempt: useful to send yourself a message rather than discover days later that the air conditioning no longer answers.

Scene action​

  • Apply an air conditioning preset: turns the unit on with its mode, setpoint, fan speed and special mode in one Comfort Cloud call, where the standard Gladys actions would send one call per feature (each takes several seconds). An empty field keeps the current setting. The setpoint accepts half degrees (22,5 or 22.5). The setpoint applied is returned to the scene.

Turning the unit off, or changing a single setting, uses the standard "Control a device" action of Gladys.

Scene examples​

  • Warm the living room before waking up: at 6:30 am on weekdays, "Apply an air conditioning preset" in Heat at 21 °C, fan Auto, special mode Normal.
  • Cool the bedroom quietly: at 10 pm, if the bedroom is above 26 °C, "Apply an air conditioning preset" in Cool at 25 °C, fan Low, special mode Quiet.
  • Nobody home: when the last person leaves, turn off every air conditioner.
  • Sign-in alert: on "Panasonic sign-in needed", send a message "Panasonic needs attention: {{triggerEvent.data.reason}}".

Refresh and quotas​

  • Panasonic publishes no quota, but Comfort Cloud is slow (a reading takes a few seconds) and throttles accounts that call it too often. The integration therefore makes one call at a time, reads only the units added to Gladys, every 2 minutes by default (the pace of the Home Assistant integration), and the energy history at most every 5 minutes.
  • The integration reads the units itself; Gladys' own polling is only a fallback.
  • After a command, the unit is read again 3 seconds later to confirm the state.
  • When Comfort Cloud fails, the pace slows down (up to 10 minutes) until it answers again. A unit the cloud cannot reach is read from the cloud's last copy for a while, then marked as not answering.
  • The unit list is read again every 30 minutes (new or renamed units).
  • Only the values that changed are sent to Gladys, plus a reminder every 6 hours so that a stable value never looks stale.

Troubleshooting​

  • "Panasonic refuses this e-mail address or password": check that you can sign in to the Comfort Cloud app with them, then fix them in the configuration. The integration never retries a refused password by itself (that could lock the account): saving the configuration or running Search for air conditioners tries again.
  • "Panasonic asks for a two-factor code": run Sign in with a 2FA code with a fresh code.
  • "Panasonic has new terms of use": open the Comfort Cloud app and accept them; the integration tries again every 30 minutes.
  • "Comfort Cloud refuses the app version announced": look up the version of the Comfort Cloud app in its store and enter it in Comfort Cloud app version.
  • A unit does not answer: check it in the app; the Wi-Fi adapter may have lost its connection.
  • More details: set the LOG_LEVEL environment variable of the container to debug.

Limits​

  • Developed without the hardware: feedback welcome on GitHub.
  • Cloud only: no local control, and the integration stops working if Panasonic changes its sign-in or its API until it is updated.
  • The energy values come from the Comfort Cloud history, which lags behind by up to an hour or so; units without energy measurement have no energy features.
  • Not handled: the iAuto-X mode, the 8/15 °C frost protection preset (the setpoint range allows it), the weekly timers, the zones of ducted units, the inside cleaning.
  • Aquarea heat pumps and hot water tanks are not supported.

Configuration settings​

These are the settings Panasonic Comfort Cloud asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
Your Panasonic accountsectionNoThe air conditioners set up in the Panasonic Comfort Cloud app are found automatically: enter the e-mail address and password of the Panasonic ID you use in the app, then open the Discovery tab. Gladys talks to them through the Panasonic cloud.
Panasonic ID (e-mail)stringYes
PasswordsecretYes
Refresh intervalselectNoHow often each air conditioner added to Gladys is read. Comfort Cloud is slow and limits the calls: 2 minutes is the pace of the Home Assistant integration.
Language of the feature namesselectNoNames given to the features of new devices (Mode, Fan speed...). The devices keep the names given in the Comfort Cloud app.
AdvancedsectionNoPanasonic only answers recent versions of its app. The integration reads the current version from Google Play by itself; fill this in only if the connection status says the version is refused.
Comfort Cloud app versionstringNo

How to install Panasonic Comfort Cloud in Gladys​

  1. In Gladys, open Integrations: Panasonic Comfort Cloud appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/guim31/gladys-panasonic-cc:1.0.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/guim31/gladys-panasonic-cc.

Panasonic Comfort Cloud requires Gladys >=5.2.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

Panasonic Comfort Cloud is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by guim31, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂
Last updated on