v3.11.0

3.11.0 (2024-01-10)

Special thanks to the amazing uswong for executing these new features!

Make sure to run the ConfigCreator again to update your config and take advantage of the new features!

Notable Changes

• Accessory names can now handle a single quote ', for example Mitch's Room. You must also update homebridge-cmd4 to v7.0.2 to take advantage of this feature.
• For users with myZone taking advantage of the 'Fan' Zone Control setup, since iOS 17 the SwingMode characteristic we were using to be the myZone switch has disappeared from the accessory's Homekit primary page but hidden deep inside the accessory's Homekit settings. Now we are using the RotationDirection characteristic rather than SwingMode as a proxy for the myZone switch. RotationDirection characteristic will show as a round button switch on the Homekit accessory's primary page.

Other Changes

• Performance Update: MyPlace lights and things will now use ID instead of Name as a parameter in state_cmd_suffix during the ConfigCreator process, requiring less parsing in AdvAir.sh.
• Dev: Added unit tests to for lights and things ID as a parameter in state_cmd_suffix and also added unit tests to test for RotationDirection characteristics.

Bug Fixes

• Fixed: Broken url path to the homebridge logo on the README.

v3.10.0

3.10.0 (2023-07-28)

Special thanks to the amazing uswong for executing these new features!

Notable Changes

Some great Zone Control customisation options have come to the ConfigCreator based on how different people would like to use this plug-in! All you have to do is run the ConfigCreator to try them out or update your config! As always, take a copy of your existing config first just in case you would like to quickly revert back to what you already had.

• "Lightbulb/Switch" * accessory with standalone temperature sensor and myZone switch (legacy).
• "Lightbulb/Switch" * accessory with integrated temperature sensor but standalone myZone switch (new).
• "Lightbulb" only accessory with integrated temperature sensor but standalone myZone switch (new).
• "Fan" accessory with integrated temperature sensor and integrated myZone switch (new - recommended).

* will use a Switch for temperature sensor zones and a Lightbulb for those without.

Read more about these options in Step 10 of the README. If you have ideas for further config options, let us know!

Other Changes

• Support for Fujitsu anywAIR systems, which seem to be a rebranded AdvantageAir System using port 10211. As such, the PORT option has been added to the ConfigCreator and can be left as default for all AdvantageAir users and changed for anywAIR users.
• Added an optional performance enhancement by doing the necessary rounding in Cmd4 module.
• Dev: Dependency updates.
• Dev: Added unit tests for the additional characteristics Active and SwingMode.

Bug Fixes

• Fixed: A vulnerability was found in ConfigCreator.sh for use in terminal. It would fail if an optional retries parameter was added in the config.json.
• Fixed: A bug was found in AdvAir.sh such that when the aircon system is offline, the plugin still registers it as online.

v3.9.0

3.9.0 (2023-03-09)

Special thanks to the amazing uswong and ztalbot2000 for adding these new features!

Notable Changes

• myZone - Will no longer blanket set the 'Target Temperature' from the Thermostat across all zones for myZone users. This functionality has been good for non-myZone users but should not be the case for myZone users; only the 'Target Temperature' of the zone defined as myZone is changed. This change will not affect non-myZone users.
• Fancy Timers - New 'switch to mode timers' can be added from the ConfigCreator (needs to be run again to added to your config). These timers will add the functionality to change from one mode to the next after the timer is complete.
  • Cool: Switch to Cool mode once the timer is completed.
  • Heat: Switch to Heat mode once the timer is completed.
  • Vent (fan): Switch to Fan mode once the timer is completed.
• No Response - Previously if the Advantage Air device could not be reached, it would show the status as Off, but with homebridge-cmd4 v7.0.0 (currently available via beta version v7.0.0-beta2) it will now display as No Response. This particularly usefull for users with the MyPlace smart extra modules which can go offline seperate of the main control unit.

Other Changes

• Various under the hood quality of life and error handling improvements.

Bug Fixes

• Yellow log warning 'requires Node.js version' fixed. Node.js dependancy updated.
• Red log error 'No plugin was found' fixed. If you still see this error, clear the area of your config that contains the following and run ConfigCreator again:

        {
            "name": "cmd4AdvantageAir",
            "devices": [
                {
                    "name": "Aircon",
                    "ipAddress": "192.168.0.159"
                }
            ],
            "platform": "cmd4AdvantageAir"
        }

v3.8.0

3.8.0 (2022-09-26)

Special thanks to the amazing uswong for executing these new features!

Notable Changes

• Support added for myZone. For users that have access to myZone, this will expose a series of switch accessories that will allow the user to set which room is currently being used as myZone for temperature feedback to the Advantage Air controller.
  • To add the myZone switches to you system, please run the ConfigCreator to add them to your config (Step 8 of the README).
  • More information on what myZone is can be found here.

Other Changes

• All defined Constant Zones are now used by AdAvir.sh when before it would only use the first defined Constant Zone.
• Better handling of systems that are a mix of zones with and without temperature sensors.

v3.7.0

3.7.0 (2022-09-04)

Special thanks to the amazing uswong for executing this new feature! And happy birthday to my cat Pumpkin, the Red Menace!

Notable Changes

• Much like how the new ConfigCreator can be run from the terminal for HOOBS users and Homebridge users without access to the web UI; the existing CheckConfig web UI button can now also be called from the terminal. Instructions can be found here.
• The CheckConfig script when called, will run through all the requirements of the plug-in installation steps and your config to make sure you are all set!

Other Changes

• The ConfigCreator script will now prompt you to call the CheckConfig script in the very last steps.

v3.6.0

3.6.0 (2022-08-28)

Special thanks to the amazing uswong for adding this new feature!

Notable Changes

The new ConfigCreator can now be run from Homebridge UI! Once the Advantage Air device(s) is/are defined (note that only a maximum of 3 devices can be processed by ConfigCreator) and saved, click the CONFIG CREATOR button to auto-create the cmd4 configuration file required to run the homebridge-cmd4-AdvantageAir plugin. Make sure you check the checkbox if you want the fan to be setup as FanSwitch instead of a 'Fan' accessory before you click the CONFIG CREATOR button.

This can be run by existing users if they want to update to the newest (and best!) config options available. You can always inspect or edit the configuration created in homebridge-cmd4 (not homebridge-cmd4-AdvantageAir) JASON Config editor if you want after the fact; for example if you do not like the naming convention used. Once the configuration is created, you can then use the CHECK CONFIGURATION button to check whether the configuration meets all the requirements.

NOTE: HOOBS users and users without access to Homebridge UI have to run the ConfigCreator from their terminal and follow the prompts. Instructions can be found here.

Other Changes

• Addition of FanSwitch config option. For users who would rather have the Advantage Air fan as a Switch accessory instead of a Fan accessory. Fan speed will still be coupled and controlled with the FanSwitch accessory like it is with the Thermostat.
• Terminal mode of ConfigCreator.sh now has improved instructions in coloured form.

Bug Fixes

• Dev: All lint errors resolved.
• Dev: Removed prepare script for husky

v3.6.0-beta.2

3.6.0-beta.2

Special thanks to the amazing uswong for adding this new feature!

Notable Changes

The new ConfigCreator can now be run from Homebridge UI! Once the Advantage Air device(s) is/are defined (note that only a maximum of 3 devices can be processed by ConfigCreator) and saved, click the CONFIG CREATOR button to auto-create the cmd4 configuration file required to run the homebridge-cmd4-AdvantageAir plugin. Make sure you check the checkbox if you want the fan to be setup as FanSwitch instead of a 'Fan' accessory before you click the CONFIG CREATOR button.

This can be run by existing users if they want to update to the newest (and best!) config options available. You can always inspect or edit the configuration created in homebridge-cmd4 (not homebridge-cmd4-AdvantageAir) JASON Config editor if you want after the fact; for example if you do not like the naming convention used. Once the configuration is created, you can then use the CHECK CONFIGURATION button to check whether the configuration meets all the requirements.

NOTE: HOOBS users and users without access to Homebridge UI have to run the ConfigCreator from their terminal and follow the prompts. Instructions can be found here (instructions to come).

Other Changes

• Addition of FanSwitch config option. For users who would rather have the Advantage Air fan as a Switch accessory instead of a Fan accessory. Fan speed will still be coupled and controlled with the Thermostat accessory.
• Terminal mode of ConfigCreator.sh now has improved instructions in coloured form.

Bug Fixes

• Dev: All lint errors resolved.
• Dev: Removed prepare script for husky

v3.6.0-beta.1

3.6.0-beta.1

Special thanks to the amazing uswong for adding this new feature!

Notable Changes

The new ConfigCreator can now be run from Homebridge UI! Once the Advantage Air device(s) is/are defined (note that only a maximum of 3 devices can be processed by ConfigCreator) and saved, click the CONFIG CREATOR button to auto-create the cmd4 configuration file required to run the homebridge-cmd4-AdvantageAir plugin. Make sure you check the checkbox if you want the fan to be setup as FanSwitch instead of a 'Fan' accessory before you click the CONFIG CREATOR button.

This can be run by existing users if they want to update to the newest (and best!) config options available. You can always inspect or edit the configuration created in homebridge-cmd4 (not homebridge-cmd4-AdvantageAir) JASON Config editor if you want after the fact; for example if you do not like the naming convention used. Once the configuration is created, you can then use the CHECK CONFIGURATION button to check whether the configuration meets all the requirements.

NOTE: HOOBS users and users without access to Homebridge UI have to run the ConfigCreator from their terminal and follow the prompts. Instructions can be found here (instructions to come).

Other Changes

• Addition of FanSwitch config option. For users who would rather have the Advantage Air fan as a Switch accessory instead of a Fan accessory. Fan speed will still be coupled and controlled with the Thermostat accessory.

Bug Fixes

• Dev: All lint errors resolved.
• Dev: Removed prepare script for husky

v3.6.0-beta.0

3.6.0-beta.0

Special thanks to the amazing uswong for adding this new feature!

Notable Changes

The new ConfigCreator can now be run from Homebridge UI! Once the Advantage Air device(s) is/are defined (note that only a maximum of 3 devices can be processed by ConfigCreator) and saved, click the CONFIG CREATOR button to auto-create the cmd4 configuration file required to run the cmd4-AdvantageAir plug-in. Make sure you check the checkbox if you want the fan to be setup as FanSwitch instead of a 'Fan' accessory before you click the CONFIG CREATOR button.

Once the configuration is created, you can then use the CHECK CONFIGURATION button to check whether the configuration meets all the requirements.

You can always inspect or edit the configuration created in Cmd4 (not cmd4-AdvantageAir) JASON Config editor if you want.

Bug Fixes

• Dev: All lint errors resolved.
• Dev: Removed prepare script for husky

v3.5.1

3.5.1 (2022-08-02)

Special thanks to the amazing uswong for adding this new feature!

Bug Fixes

• Replaced use of command tac to sort -nr in new ConfigCreator (see v3.5.0). Command tac is not available on macOS.