Skip to content

Commit

Permalink
Bumped default appVersion to 1.17.0
Browse files Browse the repository at this point in the history
  • Loading branch information
seime committed Jan 23, 2023
1 parent 2db4fb8 commit 1ec41d3
Show file tree
Hide file tree
Showing 2 changed files with 30 additions and 27 deletions.
55 changes: 29 additions & 26 deletions bundles/org.openhab.binding.panasoniccomfortcloud/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,27 +23,26 @@ See full example below for how to configure using thing files.
* `username` = Same as you use in the mobile app (_mandatory_)
* `password` = Same as you use in the mobile app (_mandatory_)
* `appVersion` = The version of your Panasonic Comfort Cloud mobile app. You can find this information in the
application section of your phone (_mandatory_ with default value)
application section of your phone (_mandatory_ with default value). Current default appVersion is `1.17.0`.
* `refreshInterval` = Number of seconds between refresh calls to the server (_optional_)

NOTE: If your account refuses to go online with error message 'New app version published - check the version number of
your mobile app and enter the value as account config parameter (currently using <current version>)', update
the `appVersion` config field. This _may_ work if the API has not changed too much
NOTE: If your account refuses to go online with error message `New app version published - check the version number of
your mobile app and enter the value as account config parameter (currently using <current version>)`, update
the `appVersion` config field. This _may_ work if the API has not changed too much.

### aircondition

* `deviceId` = id of air condition device (_mandatory_)

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
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_.
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

Expand All @@ -58,30 +57,34 @@ and [report back](https://community.openhab.org/t/panasonic-comfort-cloud-bindin
* CS-TZ20WKEW
* CS-TZ25WKEW & CU-3Z68TBE (multisplit: 3 indoor units with 1 outdoor unit)
* CS-TZ35WKEW & CU-TZ35WKE
* CS-Z20XKEW (multisplit)
* CS-TZ42WKEW
* CS-Z20XKEW (multi-split)
* CS-Z25VKEW
* CS-Z25XKEW (multisplit)
* CS-Z35XKEW (multisplit)
* CS-Z25XKEW (multi-split)
* CS-Z35XKEW (multi-split)
* CS-Z42VKEW
* CS-Z50VKEW (under test)
* CS-Z50VKEW
* CU-5Z90TBE (multi-split)

> 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) |
| 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](https://community.openhab.org/t/panasonic-comfort-cloud-binding/133848)
Expand All @@ -95,7 +98,7 @@ Some channels are still missing like iAutoX and ecoNavi. If you have a device th
panasoniccomfortcloud.things:

```
Bridge panasoniccomfortcloud:account:accountName "Panasonic Comfort Cloud account" [ username="[email protected]", password="XXXXXXX", refreshInterval="120" ] {
Bridge panasoniccomfortcloud:account:accountName "Panasonic Comfort Cloud account" [ username="[email protected]", password="XXXXXXX", refreshInterval="120", appVersion="Defaults to 1.17.0, check current mobile app version and bump to this if trouble" ] {
Thing aircondition bedroom1 "AC Bedroom" [ deviceId="CS-TZ25WKEW+XXXXXXXX" ]
}
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ https://openhab.org/schemas/config-description-1.0.0.xsd">
<description>Your Panasonic Comfort Cloud app version code, ie '1.16.0'. You can find this information in the apps
section of your mobile phone. If no value provided, it will use the current binding default.
</description>
<default>1.16.0</default>
<default>1.17.0</default>
</parameter>

<parameter name="refreshInterval" type="integer" min="30" unit="s">
Expand Down

0 comments on commit 1ec41d3

Please sign in to comment.