ioBroker.panasonic-comfort-cloud

⚠️ IMPORTANT: This adapter is for Air Conditioners only. It does NOT support Heat Pumps (Wärmepumpen).

!Logo

!Number of Installations !Number of Installations 



panasonic-comfort-cloud adapter for ioBroker

Adapter to control devices in the Panasonic Comfort Cloud. It uses REST calls which are extracetd from the official Comfort Cloud app.
To use the a adpter you need to enter your username and password in the configuration. They are used to authenticate access to the Comfort Cloud. Information of all devices is automatically retrieved and inserted as an object. The adpter polls the device information cyclically (see interval in the settings) and sends commands directly to the cloud.

With the method used, only one client can be logged on with the account at a time.
It is recommended that a second account, for which the devices have been shared, is used.

Configuration

1. Username: Your Panasonic Comfort Cloud username (email).
2. Password: Your Panasonic Comfort Cloud password.
3. Refresh Interval: Time in minutes between updates from the cloud.
4. Automatic Refresh Enabled: Enable/Disable automatic refreshing of device states.
5. Use App Version from App Store: Automatically fetch the latest app version from the App Store (recommended).
6. App Version: Manually specify the app version (if "Use App Version from App Store" is disabled).
7. History Enabled: Enable fetching of energy consumption history (Day/Month).

Object Structure

The adapter creates a hierarchy based on your Panasonic account structure:
panasonic-comfort-cloud.0.GroupId.DeviceId.StateId

Usage Examples

$3

You can control your devices using simple setState commands in scripts.

``javascript
/*
* Example: Controlling a Panasonic AC
* Replace 'YOUR_GROUP_ID' and 'YOUR_DEVICE_ID' with your actual IDs.
*/

const devicePath = 'panasonic-comfort-cloud.0.YOUR_GROUP_ID.YOUR_DEVICE_ID';

// Turn on the air conditioner
setState(${devicePath}.operate, 1); // 1 = On, 0 = Off

// Set target temperature to 22°C
setState(${devicePath}.temperatureSet, 22);

// Set operation mode to Cool
// 0=Auto, 1=Dry, 2=Cool, 3=Heat, 4=Fan
setState(${devicePath}.operationMode, 2);

// Set fan speed to Auto
// 0=Auto, 1=Low, 2=LowMid, 3=Mid, 4=HighMid, 5=High
setState(${devicePath}.fanSpeed, 0);

// Enable Eco Mode
// 0=Auto, 1=Powerful, 2=Quiet
setState(${devicePath}.ecoMode, 2);
`

$3

Access read-only states to get current environmental data.

`javascript
const devicePath = 'panasonic-comfort-cloud.0.YOUR_GROUP_ID.YOUR_DEVICE_ID';

// Log current temperatures
const insideTemp = getState(${devicePath}.insideTemperature).val;
const outsideTemp = getState(${devicePath}.outTemperature).val;

console.log(Inside: ${insideTemp}°C, Outside: ${outsideTemp}°C);
`

$3


If History Enabled is active, you can access energy consumption and temperature logs.
* Day Mode: history.day.00 to history.day.24 (Hours 00:00 to 24:00)
* Month Mode: history.month.01 to history.month.31 (Days 1 to 31)

`javascript
// Example: Get energy consumption for 12:00 PM (Day Mode)
const hour12 = getState('panasonic-comfort-cloud.0.YOUR_GROUP_ID.YOUR_DEVICE_ID.history.day.12.consumption').val;
console.log(Accumulated consumption at 12:00: ${hour12} kWh);

// Example: Get average outside temperature for the 15th of the month
const day15Temp = getState('panasonic-comfort-cloud.0.YOUR_GROUP_ID.YOUR_DEVICE_ID.history.month.15.averageOutsideTemp').val;
console.log(Avg Outside Temp on the 15th: ${day15Temp}°C);
``

Changelog

$3

* fixed history.current updates by using latest available data (handle API lag)
* increased history refresh rate to 15min
* improved history.current timestamp to show harvest time (minute precision)
* added history.lastHour to show values of the previously completed hour

$3

* fixed unit tests for history states
* fix eslint errors in test files
* improve documentation (configuration, examples)
* update dependencies and repository configuration
* fix CI issues
* cleanup devDependencies
* add history.current channel
* ensure correct roles for history objects
* fix history date format for current history
* fix undefined state value in history
* fix current history logic

$3

* re-enable history data fetching (month mode)
* implement improved history date format (YYYY-MM-DD HH:mm:ss)

$3

* implement history data fetching (day mode)
* add historyEnabled configuration
* add manual history refresh command
* fix eslint errors (indentation, unused vars)

$3

* update library panasonic-comfort-cloud-client to 2.1.4
* modernize code (remove lodash, use async/await, split state definitions)
* replace deprecated methods with modern equivalents
* improve unit tests and remove deprecated test wrapper
* add mocked client tests to verify connection logic

$3

* read app version from App Store.

$3

* panasonic-comfort-cloud-client updated to new version. CFC generator for header added.

$3

* Fixed bug in refreshing oauth token again.

$3

* Fixed bug in refreshing oauth token.

$3

* Added option to deactivate the automatic refresh.
* Added state to manual refresh device infos.
* Updated client version for OAuth support.

$3

* Updated packages
* Added connected state to devices

$3

* Fixed load AppVersion from Github.

$3

* Added support for admin 5 UI (jsonConfig).
* Updated packages.
* Fixed translation.

$3

* Fixed wrong version number.

$3

* panasonic-comfort-cloud-client updated to new version. New headers added.

$3

* Added feature to automatically load the app version from GitHub.

$3

* Added app version to settings.

$3

* panasonic-comfort-cloud-client updated to new version. (appVersion changed again)

$3

* Translation for news added.

$3

* New version of dependencies installed.

$3

* panasonic-comfort-cloud-client updated to new version. (appVersion changed again)

$3

* panasonic-comfort-cloud-client updated to new version.

$3

* Changed the type of some states from string to number.

$3

* Added js-controller 3 dependency.
* Added username and password to protectedNative and password to encryptedNative.
* Added connection info.
* Changed schdule to timeout for refresh.
* Fixes for async await pattern.

$3

* Error handling for get device added.

$3

* Fixed bug in Comfort Cloud client.

$3

* Comfort Cloud client updated.

$3

* Fixed bug that guid is null in device creation.

$3

Comfort Cloud client updated.

$3

* Fixed bug with undefined guid. Log messages added.

$3

* Set parameters only for writable states.

$3

Fixed error handling and added stack info.

$3

* Fixed bug in refesh device method.

$3

* States insideTemperature, outTemperature and Nanoe added.

License

MIT License

Copyright (c) 2025 marc

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.