Homebridge platform plugin providing HomeKit support for Panasonic air conditioners.
npm install homebridge-panasonic-cloud-platformThis is a fork of embee8 original repository which was not maintained anymore.



homebridge-panasonic-ac-platform is a dynamic platform plugin for Homebridge that provides HomeKit support for Panasonic single and multi-split air conditioning systems.
All devices that are set up on your Comfort Cloud account will appear in your Home app. If you remove a device from your Comfort Cloud account, it will also disappear from your Home app after you restart Homebridge.
In the past, using the same account on multiple devices often resulted in being logged out of one of them. This made it necessary to create a secondary account in order for the plugin to operate reliably.
Recent improvements to Panasonic's token management should now allow you to simply use your main login details for the Homebridge plugin as well (see Comfort Cloud app release notes for 1.14.0).
In case you are still experiencing random logouts, refer to this guide for instructions on how to create a dual-account setup. It explains how devices can be shared with a dedicated account that can be used for Homebridge.
``json`
{
"platforms": [
{
"platform": "Panasonic AC Platform",
"name": "Homebridge Panasonic AC Platform",
"email": "mail@example.com",
"password": "**",
"exposeOutdoorUnit": true,
"debugMode": false,
"appVersionOverride": "1.18.0",
"suppressOutgoingUpdates": false,
"minHeatingTemperature": 16
}
]
}
Required:
* platform (string):
Tells Homebridge which platform this config belongs to. Leave as is.
* name (string):
Will be displayed in the Homebridge log.
* email (string):
The username of your Comfort Cloud account.
* password (string):
The password of your account.
Optional:
* exposeOutdoorUnit (boolean):true
If , the plugin will create a separate accessory for your outdoor unit which will display the (outdoor) temperature it measures. This can be used for monitoring and automation purposes.
* debugMode (boolean):true
If , the plugin will print debugging information to the Homebridge log.
* appVersionOverride (string):
The plugin will automatically use the last known working value when this setting is empty or undefined (default). This setting allows you to override the default value if needed. It should reflect the latest version on the App Store, although older clients might remain supported for some time.
* suppressOutgoingUpdates (boolean):true
If , changes in the Home app will not be sent to Comfort Cloud. Useful for testing your installation without constantly switching the state of your AC to minimise wear and tear.
* minHeatingTemperature (integer):
The default heating temperature range is 16-30°C. Some Panasonic ACs have an additional heating mode for the range of 8-15°C. If you own such a model, you can use this setting to adjust the minimum value. Leave it empty or undefined to use the default value.
The Home app only has one 'Oscillate' switch, but most Panasonic air conditioning units have two swing directions. To make the two compatible, you can use the following settings:
* The setting Swing Directions (swingModeDirections in the JSON config) controls which swing direction(s) will be activated when 'Oscillate' is switched on.
* The setting Swing Mode Default Position (Left-Right) (swingModeDefaultPositionLeftRight in the JSON config) controls the desired position of the Left-Right flaps when 'Oscillate' is switched off or the swing directions setting (see above) is "Up-Down only".
* The setting Swing Mode Default Position (Up-Down) (swingModeDefaultPositionUpDown` in the JSON config) controls the desired position of the Up-Down flaps when 'Oscillate' is switched off or the swing directions setting (see above) is "Left-Right only".
The Home app offers no extra buttons for the Quiet and Powerful Modes. All settings related to a unit's fan speed are controlled through the fan speed slider. The following mapping applies:
| Home app slider position | Comfort Cloud setting |
| ------------------------: | --------------------- |
| (leftmost) 0 | Device off |
| 1 | Quiet mode |
| 2 | Fan speed: 1 |
| 3 | Fan speed: 2 |
| 4 | Fan speed: 3 |
| 5 | Fan speed: 4 |
| 6 | Fan speed: 5 |
| 7 | Powerful mode |
| (rightmost) 8 | Auto |
- If you have any issues with this plugin, enable the debug mode in the settings (and restart the plugin). This will print additional information to the log. If this doesn't help you resolve the issue, feel free to create a GitHub issue and attach the available debugging information.
- If you run into login errors despite using the correct login details, make sure you accepted the latest terms and conditions after logging into the Comfort Cloud app.
- If the plugin affects the general responsiveness and reliability of your Homebridge setup, you can run it as an isolated child bridge.
You can contribute to this project in the following ways:
* Test/use the plugin and report issues and share feedback.
* Review source code changes before and after they are published.
* Contribute with your own bug fixes, code clean-ups, or additional features (pull requests are accepted).
* Thanks to the team behind Homebridge. Your efforts do not go unnoticed.