codyc1515 / homebridge-panasonic-air-conditioner

Panasonic Air Conditioner / Heat Pump plugin for HomeBridge using the Panasonic Comfort Cloud API to expose Panasonic Air Conditioners to Apples HomeKit

Update

This plug-in is now archived and it is advised to use the homebridge-panasonic-ac-platform plug-in instead. It is based on this plug-in. This plug-in provides support for the devices as a platform (instead of just individual accessories).

homebridge-panasonic-air-conditioner

Panasonic Air Conditioner / Heat Pump plugin for HomeBridge using the Panasonic Comfort Cloud API to expose Panasonic Air Conditioners to Apples HomeKit.

Things to know

• Supports only a single Air Conditioner per Comfort Cloud account
• Tested only with the CZ-TACG1 adapter but may support built-in Wi-Fi adapter & CZ-CAPWFC1 adapter
• Supports Air Conditioner and may support Commercial Air Conditioner, however I don't think Air to Water Heat Pump is supported as these use the Panasonic AQUAREA app which is separate

Getting started

Supported devices

Panasonic Air Conditioner that has a CZ-TACG1 adapter installed

Setup the app

1. Download, install & setup the Panasonic Comfort Cloud app on your mobile device
2. Create a login & add your Air Conditioner to the Comfort Cloud

Caution! It is recommended to setup another login for the Comfort Cloud and share your home to that login, as opposed to using your regular login for this plugin. Otherwise the Comfort Cloud app will log you out each time that you use this plugin (as only one user can be logged into the Comfort Cloud per login). If you plan to use multiple accessories, create separate accounts for every accessory.

3. Share your login to another user setup specifically for HomeBridge. For instructions on how to do this, see Sharing Panasonic aircon with another account section below.

Sample configuration for a single AC

	"accessories": [
		{
		"accessory": "PanasonicAirConditioner",
		"name": "Bedroom AC",
		"email": "<YOUR_EMAIL_HERE>",
		"password": "<YOUR_PASSWORD_HERE>"
	}]

Sample configuration for multiple ACs

	"accessories": [{
		"accessory": "PanasonicAirConditioner",
		"name": "Bedroom AC",
		"email": "<YOUR_EMAIL_HERE>",
		"password": "<YOUR_PASSWORD_HERE>",
		"devicenumber": 1
	},{
		"accessory": "PanasonicAirConditioner",
		"name": "Living Room AC",
		"email": "<YOUR_OTHER_EMAIL_HERE>",
		"password": "<YOUR_OTHER_PASSWORD_HERE>",
		"devicenumber": 2
	}]

Sharing Panasonic aircon with another account

Panasonic really needs to improve this experience, nonetheless, here it is:

1. Create a new panasonic account here: Panasonic ID Registration
2. Verify email using the link sent to the email id specified
3. Sign into the Panasonic Comfort Cloud app on your smart device using the newly created Panasonic ID
4. Agree to the terms and conditions displayed in app
5. Agree to the privacy notice displayed in app
6. You should now be on the home screen of the App
7. Click the "+" button
8. Choose "Air Conditioner"
9. Use the device ID from the original device package
10. Enter the device password you used when originally setting up the device
11. In step 3: Enter a name for the aircon, a message="HomeBridge account" and note="HomeBridge account")
12. Click Send Request
13. Log out of the app
14. Sign in with the original email account in the Panasonic Comfort Cloud App
15. Click the Device you've requested sharing for
16. Click the hamburger menu and expand the "Owner" menu item, click "User list"
17. You should now see an id with a waiting approval status
18. Click the "Waiting Approval" button
19. Select the "Allow both monitoring and controlling air conditioner" permission
20. Confirm
21. The waiting for approval button should have disappeared and replaced with a blue check icon
22. Use the newly created id in the homekit accessory configuration

Legal

• Licensed under MIT
• This is not an official plug-in and is not affiliated with Panasonic in any way