seime / openhab-panasoniccomfortcloud

Panasonic Comfort Cloud binding for openHAB
1 stars 0 forks source link

Panasonic Comfort Cloud Binding

This binding integrates most Panasonic Comfort Cloud air conditioners. It should work with any model supported by the Panasonic Comfort Cloud mobile app. It does not support the Aquarea line.

Supported Things

This binding supports Panasonic Air Conditioners/heat pumps that are connected to the internet via WiFi and can be controlled via the Panasonic Comfort Cloud app.

Discovery

In order to do discovery, add a thing of type Panasonic Comfort Cloud API (account) and add username and password.

Thing Configuration

See full example below for how to configure using thing files.

account

Advanced configuration:

aircondition

DeviceId can be found printed on side or back of the device. Or you can find it during discovery.

Devices with built-in WiFi support appears to use format 'MODEL+SERIAL' while devices with a separate WiFi dongle usually only uses the 'SERIAL' part.

Finding the correct deviceId for use in thing files

If you are using thing files: Device discovery will create a modified thingUID that follows the openHAB requirements. In order to find the correct deviceId to use in thing files, check discovered thing properties.

Tested devices

The following devices have been tested by users and found to be working. Currently no devices are not known to work (except for the Aquarea line that has a different API).

If your device is not listed, please test and report back so I can add it to the list.

Air-to-water pumps are currently not supported.

Channels

Note: Possible values for most String channels are reported as a thing property!

Channel Read/write Item type Description
masterSwitch R/W Switch Switch AC ON or OFF
currentIndoorTemperature R Number:Temperature Measured indoor temperature
currentOutdoorTemperature R Number:Temperature Measured outdoor temperature
targetTemperature R/W Number:Temperature Target temperature / setpoint
operationMode R/W String Current mode (COOL, HEAT, etc, see thing properties)
airSwingAutoMode R/W String Current auto air swing mode (AUTO, LEFT_RIGHT etc, see thing properties)
airSwingHorizontal R/W String Current horizontal air swing mode (LEFT, CENTER etc, see thing properties)
airSwingVertical R/W String Current vertical air swing mode (TOP, BOTTOM etc, see thing properties)
ecoMode R/W String Current eco mode (AUTO, POWERFUL, QUIET, see thing properties)
nanoe R/W String Nanoe mode (UNAVAILABLE, OFF, ON, MODE_G, ALL)
actualNanoe R String Actual Nanoe mode (UNAVAILABLE, OFF, ON, MODE_G, ALL)

Some channels are still missing like iAutoX and ecoNavi. If you have a device that supports these functions, please contact me on the forum

Reported issues

Full Example

panasoniccomfortcloud.things:

Bridge panasoniccomfortcloud:account:accountName "Panasonic Comfort Cloud account" [ username="XXX@XXX.COM", password="XXXXXXX", refreshInterval="120", appVersion="1.21.0" // Optional ] {
  Thing aircondition bedroom1 "AC Bedroom" [ deviceId="CS-TZ25WKEW+XXXXXXXX" ]
}

panasoniccomfortcloud.items:

Switch masterSwitch "AC on/off" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:masterSwitch"}
String operationMode "Mode" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:operationMode"}
Number:Temperature targetTemperature "Target temperature" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:targetTemperature"}
String ecoMode "Eco mode" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:ecoMode"}

String airSwingAutoMode "Air swing auto mode" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:airSwingAutoMode"}
String airSwingVertical "Vertical air direction" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:airSwingVertical"}
String airSwingHorizontal "Horizontal air direction" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:airSwingHorizontal"}
String fanSpeed "Fan speed" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:fanSpeed"}

Number:Temperature currentIndoorTemperature "Inside temperature" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:currentIndoorTemperature"}
Number:Temperature currentOutdoorTemperature "Outside temperature" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:currentOutdoorTemperature"}

String nanoe "Nanoe" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:nanoe"}
String actualNanoe "Actual Nanoe" {channel="panasoniccomfortcloud:aircondition:accountName:bedroom1:actualNanoe"}