{
  "platforms": [
    {
        "platform": "Panasonic AC Platform",
        "name": "Homebridge Panasonic AC Platform",
        "email": "mail@example.com",
        "password": "********",
        "key2fa": "GVZCKT2LLBLV2QBXMFAWFXKFKU5EWL2H",
        "appVersionOverride": "1.21.0",
        "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,
                    "swingModeDirections": "LEFT-RIGHT-UP-DOWN",
                    "swingModeDefaultPositionUpDown": "CENTER",
                    "swingModeDefaultPositionLeftRight": "CENTER"
                },
                 {
                    "name": "Bedroom AC",
                    "excludeDevice": false,
                    "exposeOutdoorTemp": true,
                    "exposeNanoe": false,
                    "exposeInsideCleaning": true,
                },
            ]
    }
  ]
}

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

• appVersionOverride (string): Leave this field empty to automatically fetch the latest version from the App Store and if that fails, it will use the last known working value which is hard-coded. Filling in this field will make the entered version used (automatic overwriting of versions from the App Store will not work).

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

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

• 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).

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

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

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

• exposeDryMode (boolean): When enabled it will create a switch to control Dry Mode. Note: disabling this switch will set Auto Mode.

• exposeFanMode (boolean): When enabled it will create a switch to control Fan Mode. Note: disabling this switch will set Auto 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.

• swingModeDirections (string): Desired swing direction(s) activated when swing is switched on.

• swingModeDefaultPositionUpDown (string): Desired position of the Up-Down flaps when swing is switched off or the swing directions setting is Left-Right only.

• swingModeDefaultPositionLeftRight (string): Desired position of the Left-Right flaps when swing is switched off or the swing directions setting is Up-Down only.

• Enable additional sensor for outdoor temp. and/or switches for: Nanoe, Inside Cleaning, Eco Navi, Dry Mode, Fan mode, Quiet Mode, Powerful Mode, Swing Up Down, Swing Left Right.
• Sensor / Switch will work only if device support this function.
• Some values can be changed only when device is on (E.G.: Quiet Mode, Powerful mode, Swing Up Down, Swing Left Right).
• These switches will be available in HomeKit, directly in your main device or in device / settings (wheel icon) / accessories.
• If you add at least one sensor or switch, the appearance of the air conditioning will change - rotation speed and swing will not be available in the main view, only after entering the device / settings (wheel icon) / accessories / device / settings (wheel icon).
• You can also use the option 'show as separate tiles' to separate the accessories.

All settings related to a unit's fan speed are controlled through the fan speed slider. The following mapping applies:

• The data is refreshed automatically: every 10 minutes when the device is turned on and every 60 minutes when it is turned off. Data is also refreshed every time the state of the device is changed using HomeKit / Apple Home.
• Temperature from outdoor unit is only available when device is on.

• 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.
• Field Comfort Cloud app version (in plugin settings) should be empty or have newest Comfort Cloud app version (same as in Apple App Store).
• 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 move device from Homebridge cache (Homebridge settings > remove one device from cache).
• Set Logs Level to all (in plugin config) and enable debug mode (in Homebridge settings). This will include more detailed information in the log.

• It's recommended you run this plugin as a child bridge.

Remove device from Homebridge cache (Homebridge settings > remove one device from cache).

• Built-in temperature sensors (in the internal and external unit) give only approximate values (as the manufacturer himself indicates).
• Values from outdoor sensors are shown and updated only when the device is turned on.
• Comfort Cloud updates data only from time to time, the same plugin, which is why the temperature in the Panasonic Comfort Cloud application may be different than in HomeKit / Apple Home. You can force refresh in Panasonic app by pulling down the screen.
• For these reasons, it is not recommended to use built-in sensors for automation. Instead, it is advisable to use an external sensor.
• So what are these built-in sensors for? Internal sensor is for two simple automations that every AC have built-in: for cooling mode turn off cooling when the room temperature (internal sensor) is equal to or lower than the set, and for heating mode when it is equal or higher. Outdoor sensor is for detecting when AC should run defrost.

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]

• Local access, but this requires reworking of the equipment, which will lose the warranty, so rather not recommended.

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