``json
{
"platforms": [
{
"platform": "Panasonic AC Platform",
"name": "Homebridge Panasonic AC Platform",
"email": "mail@example.com",
"password": "**",
"key2fa": "GVZCKT2LLBLV2QBXMFAWFXKFKU5EWL2H",
"suppressOutgoingUpdates": false,
"logsLevel": 1,
"devices": [
{
"name": "CS-Z50VKEW+4942673181",
"excludeDevice": true,
"minHeatingTemperature": 8,
"exposeOutdoorTemp": false,
"exposeNanoe": true,
"exposeInsideCleaning": false,
"exposeEcoNavi": false,
"exposeDryMode": false,
"exposeQuietMode": true,
"exposePowerfulMode": false,
"swingDefaultUD": "CENTER",
"swingDefaultLR": "CENTER"
},
{
"name": "Bedroom AC",
"excludeDevice": false,
"exposeOutdoorTemp": true,
"exposeNanoe": false,
"exposeInsideCleaning": true,
},
]
}
]
}
`
#### General

- platform (string): Tells Homebridge which platform this config belongs to. Leave as is.

- name (string): Name of the plugin displayed in Homebridge log and as plugin bridge name.

- email (string): The username of your Comfort Cloud (Panasonic ID) account.

- password (string): The password of your Comfort Cloud (Panasonic ID) account.

* key2fa (string):
2FA key received from Panasonic (32 characters). Example: GVZCKT2LLBLV2QBXMFAWFXKFKU5EWL2H. Note: This field is currently not required to make this plugin work, but Panasonic already requires 2FA (code or SMS, recommended code) to log in to Comfort Cloud, so it may be required soon.

* suppressOutgoingUpdates (boolean):
When enabled, 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.

* overWriteVersion (string):
Must be equal to newest Panasonic Comfort Cloud app version from App Store or Play Store. E.G: 2.1.0. Leave empty to automaticaly detect version.

* logsLevel (integer):
Logs level. 0 - only errors and important info, 1 - standard, 2 - all (including debug). Note: to see debug messages in logs it is also required to enable Debug in Homebridge Settings.

#### Individual for each device

* name (string):
Device name (as it is in Comfort Cloud account) or serial (E.G.: CS-Z50VKEW+2462503161). Devices names and serial numbers are displayed in Homebridge log after restart, names can be also found in Panasonic Comfort Cloud app, serial numbers can be also found on the stickers on the devices.

* excludeDevice (boolean):
Exclude device from Homebridge and HomeKit (it will stay in Comfort Cloud).

* refreshWhenOn (integer):
Refresh interval when device is turned on. In minutes. 0 = disabled.

* refreshWhenOff (integer):
Refresh interval when device is turned off. In minutes. 0 = disabled.

* 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. You can use this setting to adjust the minimum value. Leave it empty to use the default value.

* exposeInsideTemp (boolean):
When enabled it will create a virtual temperature sensor which will display the temperature from inside unit. This can be used for monitoring or automation purposes. Note: It is recomended to use external temperature sensor (not built-in in AC).

* exposeOutdoorTemp (boolean):
When enabled it will create a dummy temperature sensor which will display the temperature from outdoor unit. This can be used for monitoring or automation purposes. Note: It may be required for the device to be turned on to retrieve the current temperature from the outdoor unit.

* exposePower (boolean): When enabled it will create a switch to control Power (on/off).

* exposeNanoe (boolean): When enabled it will create a switch to control Nanoe.

* exposeInsideCleaning (boolean): When enabled it will create a switch to control Inside Cleaning.

* exposeEcoNavi (boolean): When enabled it will create a switch to control Eco Navi.

* exposeEcoFunction (boolean): When enabled it will create a switch to control Eco Function.

* exposeCoolMode (boolean): When enabled it will create a switch to control Cool Mode.

* exposeHeayMode (boolean): When enabled it will create a switch to control Heat Mode.

* exposeDryMode (boolean): When enabled it will create a switch to control Dry Mode.

* exposeFanMode (boolean): When enabled it will create a switch to control Fan Mode.

* exposeNanoeStandAloneMode (boolean): When enabled it will create a switch to control Nanoe Stand Alone Mode.

* exposeQuietMode (boolean): When enabled it will create a switch to control Quiet Mode. Quiet Mode can also be enabled by setting the speed slider (rotation) to 1.

* exposePowerfulMode (boolean): When enabled it will create a switch to control Powerful Mode. Powerful Mode can also be enabled by setting the speed slider (rotation) to 7.

* exposeSwingUpDown (boolean): When enabled it will create a switch to control Swing Up Down.

* exposeSwingLeftRight (boolean): When enabled it will create a switch to control Swing Left Right.

* exposeFanSpeed (boolean): When enabled it will create a switch to control Fan Speed. Value 0 will turn device off, value from 1 to 20 = speed 1, value from 21 to 40 = speed 2, value from 41 to 60 = speed 3, value from 61 to 80 = speed 4, value from 81 to 99 = speed 5 and value 100 = speed auto. Note: changing value will turn off Quiet / Powerful mode.

* swingDefaultUD (string):
Desired position of the Up-Down flaps when swing is switched off.

* swingDefaultLR` (string):
Desired position of the Left-Right flaps when swing is switched off.

For the built-in slider (not additional), 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 |

- Activation of Oscilate switch from HomeKit will set swing to auto (for up-down and left-right).
- Deactivation of the Oscilate switch from HomeKit will set desired positions - you can set them in plugin config.
- When refreshing data, it will activate switch if at least one of the swing modes be enabled (up-down or left-right or both), otherwise it will be turned off.
- For more control you can add additional switches for up-down swing and left-right swing.

- The data is refreshed automatically (you can set time in config). Data is also refreshed every time the state of the device is changed using HomeKit / Apple Home.
- Why isn't refreshing more often? Each refresh is a connection to the Panasonic server and too many connections result in IP blocking.
- Temperature from outdoor unit is only available when device is on.

If everything works properly and you can control devices using the Apple Home application, you can also control it using Siri. Commands fully depend on Apple.

Examples of commands:
- Hey Siri, turn on [device name]
- Hey Siri, [device name] , turn off
- Hey Siri, [device name] , set [auto, heat, cool] mode
- Hey Siri, [device name] , set rotation speed to [value from 1 to 8]

You can also combine several commands into one:
- Hey Siri, [device name] , set [auto, heat, cool] mode and rotation speed to [value from 1 to 8]

- Make sure that you can successfully log in and control each device via Panasonic Comfort Cloud application.
- Accept all terms, conditions, etc in Panasonic Comfort Cloud app.
- Update plugin, Homebridge and all its components and Apple hubs to the newest versions.
- Disable other Homebridge plugins to make sure that they are not causing the problem.
- Disconnect each Comfort Cloud device (like AC) from the power and turn it on again (or restart WiFi in them).
- Restart Internet routers.
- Restart Homebridge or plugin bridge.
- Remove one or more plugin devices from Homebridge cache (Homebridge settings > remove one device from cache).
- Set Logs Level to All (in plugin config) and enable Homebridge Debug or Accessory Debug (in Homebridge settings) - this will include more detailed information in the log.

https://www.panasonic.com/global/hvac/products/comfort-cloud/how-to-set-up-comfort-cloud.html

- Link Comfort Cloud to Google Assistant (manual).

- Link Comfort Cloud to Amazon Alexa (manual).

- Official Panasonic Comfort Cloud app for iOS / Android

- Dedicated remote controller.

- Local access, but this requires reworking of the equipment, which will lose the warranty, so rather not recommended (manual).

- Control by IR (imitates an IR remote control), but it only allows you to send commands (not possible to read the state). Examples:

- Aqara Hub M2 or M3. This Hub will directly exposes IR to Homekit. For Hub M2 you need to create scene in Aqara app for every IR command, for IR commands scenes are the only way to sync to HomeKit.

- Broadlink RM4 Mini or Pro. They work as WiFi devices. You need to install Homebridge plugin (homebridge-broadlink-rm) to work with this. For every command there will be separate accessory in HomeKit.

- Any Zigbee IR blaster. You can easily add Zigbee support to Homebridge. Just connect the Conbee stick, enable the support in hb-config (Extra packages / deCONZ), install the appropriate plugin (E.G.: homebridge-deconz) and add the selected IR blaster.

TIP: You can turn off the beep sound in the internal unit that appears on every IR signal receive. In most air conditioning, to do this, hold down the auto on/off button in the internal unit until you hear 4 beeps, then release the button, single press AC reset button on remote, single press the auto on/off button again on the air conditioning - short signal means a sound turned off, a long one means a sound turned on.