homebridge-knx-easy

# Changelog for Version 0.3.x ## 0.3.27 - @CyberChris79 found a breaking change in HAP-nodeJS (the HAP protocol implementation which homebridge is build on) which broke the tiny web server that can display HAP Services and such (see https://github.com/snowdd1/homebridge-knx#looking-up-service-types-and-characteristics) *Note to self: the webserver implementation is ugly and has grown too much for kind-of inline code in index.js* ## 0.3.26 - @giase82 updated the ThermostatMode handler in #169 to be able to update the Bus value also from HomeKit - Found another glitch in the knxaccess.js library where KNXJS was used even if it was not specified (regression from 0.3.24) ## 0.3.25 - martijndierkx contributed an MDTJalousieActuator handler in PR #167 - Big thanks to him! - I updated the SimpleGarageDoor handler to accept two new local constants: "ResetOpenDoorContactTime" and "ResetCloseDoorContactTime" in Milliseconds if you want to issue an KNX "0" after a givin time, in case you don't want or must not have a relay powered all the time. Fixes German issue 65 from homebridge-knx-de at [https://github.com/snowdd1/homebridge-knx-de/issues/65] - And I updated the handler API doc to reflect the changes from v0.3.21; Actually the SimpleGarageDoor handler uses the new init event. ## 0.3.24 - patched configuration to default to knxd again. Fixes [#162](https://github.com/snowdd1/homebridge-knx/issues/162). See also changed documentation in [knx_config.json.md](https://github.com/snowdd1/homebridge-knx/blob/master/knx_config.json.md) ## 0.3.23 - With PR [#160](https://github.com/snowdd1/homebridge-knx/pull/161) Luehrsen added the ability to have local add-in directories. I hope that you all still continue to share your add-ins ("handler"s) via PRs here, so that all of us can benefit from the developments. - Homebridge made a leap to version 1.0.0 - with **bracking changes**: - you all need to change your config.json and add the KNX platform manually! See updated sample file [https://github.com/snowdd1/homebridge-knx/blob/master/KNX-sample-config.json](https://github.com/snowdd1/homebridge-knx/blob/master/KNX-sample-config.json) and issue [#163](https://github.com/snowdd1/homebridge-knx/issues/163) - node version needs to be at least 10.0 now! - Dependency bump to current versions ## 0.3.22 - thanks to [Paul](https://github.com/c-o-m-m-a-n-d-e-r)'s PR #152, now knxd is not mandatory any more. Documentation will follow! - And he also fixed the typo in the GarageDoorAdvanced handler in #158. ## 0.3.21 - new call hooks for custom handlers. Invented by [ctschach](https://github.com/ctschach/homebridge-knx/commit/5829bf2a1ccf2fa34e37b4d55d87c763a0d5e786), the custom handlers now get informed when the service is ready - `onServiceInit()` and when all devices are loaded and initialized - `onHomeKitReady()` ## 0.3.20 - thanks to hints in #149 I found another glitch in the dimmer handler, which was there for ... well, let's settle for "a long time" :-) ## 0.3.19 - new feature: [EIBHomeControl](https://github.com/EIBHomeControl) contributed a simple security system handler. ## 0.3.18 - bugfix for shutter state (opening/closing) being shown in home app reversed (yes, home app now uses the PositionState value in ios12.1+) ## 0.3.17 - bugfix for an issue in which external KNX switching off of a dimmable light was not recognized by the dimmer handler. Thanks to [Michael](https://github.com/misc2000) for his [PR 136](https://github.com/snowdd1/homebridge-knx/pull/136) ## 0.3.16 - bugfix for a scaling issue with the new handler in 0.3.15 ## 0.3.15 - new handler for Dimmers to avoid Apple's **Home**(c) app's disastrous handling of On and Brightness events. Thanks [dlt-](https://github.com/dlt-) for [pointing that out](https://github.com/snowdd1/homebridge-knx/issues/47#issuecomment-325161018). I rewrote it to make it more customizable, and to avoid flickering of the slider in the app due to knx responses. - new Readme design :-) ## 0.3.14 - fix [bug #122](https://github.com/snowdd1/homebridge-knx/issues/122) with wrongly spelled service reference in custom API - fix [bug #123]() with missing integer typer UINT12 and UINT32 which are now used in Homekit(c) types - bump dependencies to actual versions ## 0.3.13 - bump required packages to new versions: - node-eibd to 0.3.9 (regression!) - debug to 3.1.0 ## 0.3.12 - changed logging of KNX value changes: [type INFO changed to DEBUG to avoid filling the logs, #93](https://github.com/snowdd1/homebridge-knx/issues/93) - commented out the code stub [throwing an exception at homebridge start, #89](https://github.com/snowdd1/homebridge-knx/issues/89) - ~~allow **Reverse keyword** for UINT8 homekit types that have only 0,1 as valid values [(treat as boolean) #91](https://github.com/snowdd1/homebridge-knx/issues/91#issuecomment-305266948)~~ *Had to be skipped for complete rework of data value validation in HAP-nodeJS v.0.4.32 and beyond* - The parameter "AllowWebserver" now has a companion "WebserverPort" if you want to use something different than 18081 (or want to run two instances in parallel as I did) - requires homebridge 0.4.28 - [merged fix](https://github.com/snowdd1/homebridge-knx/pull/103) from [gkuehn001](https://github.com/gkuehn001) for [true/false vs. 1/0 responses from Siri and home app](https://github.com/nfarina/homebridge/commit/b6f382950ceba1b640808ffdc1de358c4738ec09) for OneWaySwitch handler ## 0.3.11 - tiny internal web server has new pages: - /availservices shows the services from hap-nodejs - /availcharacteristics shows the characteristics from hap-nodejs - these pages are linked - localization is prepared but not implemented yet - properties of the characteristics are listed but not explained ### 0.3.10-b - Just pushing dependency to eibd to beyond 0.3.8, which was faulty (and it was my fault.) ## 0.3.10 - New Add-in - From the German [knx-user-forum.de](https://knx-user-forum.de/forum/projektforen/knxd/1068186-zentral-aus) the idea of having a one-way switch to shut off central functions such as switching lights off all at once was voiced, so here it is: [**OneWaySwitch** handler](https://github.com/snowdd1/homebridge-knx/blob/master/lib/addins/OneWaySwitch.js) - Ignore Option - For those who want to (for whatever reason) run multiple homebridge instances on the same machine whilst having them globally installed, now a file named `**knx-ignore.txt**` in the homebridge-configuration folder (of the respective instance, defaults to `~/.homebridge` ) prevents the loading of homebridge-knx. ## 0.3.9 - New Add-in! - for CO2Sensors, thanks to [Matevz Gacnik](https://github.com/matevzg)! He was so kind to put it in [Issue 85](https://github.com/snowdd1/homebridge-knx/issues/85) for me to publish it. - Translates definable limits to HomeKit specific status values. See the [example in the code](https://github.com/snowdd1/homebridge-knx/blob/master/lib/addins/AirQualityCO2.js#L44) ## 0.3.8 - Documentation of knx_config.json changed: [Recommend to place all services in a room into one device](https://github.com/snowdd1/homebridge-knx/blob/master/knx_config.json.md#devices). [Issue 83](https://github.com/snowdd1/homebridge-knx/issues/83) Thanks to [Matevž Gačnik](https://github.com/matevzg) for pointing that out. - Version bumped to 0.3.8 as npm does not like 0.3.7-a (no update on `npm update homebridge-knx, see #82) ### 0.3.7-a - Fixed the dependency to homebridge, which was already somewhat futuristic: - Current is 0.4.16 - Required 0.4.19 did not work, fixed now. ## 0.3.7 - Enhancements - Does not send values to homekit that haven't changed. Might take some pressure from the Lightbulb with dimmer-going-havoc issue, though it doesn't solve it completely. ## 0.3.6 - Bugfixes - #79 Wrong assumption about FORMAT and UNIT of homekit types referring to PERCENTAGES ### 0.3.5-a - Enhancements - #60 Experimental RBG light controller updated. Should now convert from HomeKit to RGB and from KNX RGB to Homekit HSB. Untested. Have no hardware. ## 0.3.5 - Enhancements - #72 Allow 16 bit addresses (extended address structure, might be incompatible with older devices; in case of doubt restrict your address range to (15/7/255) as in ETS 3 and before) ## 0.3.4 - Bugfixes - #66 Invalid values returned for enumerated-code characteristics - #67 `Reverse` keyword did not work at all - #69 group address validation is wrong - New *mini* feature - new keyword "ValidValues" allows to restrict the options in homekit apps such as Apple's **Home**. Others might not yet support that (Elgato Eve 2.5.1 does not, e.g.) ## 0.3.3 - included new addins - **WindowCoveringTilt** by giase82/Christof - **GiaseGarageDoorOpener** by giase82/Christof - RGB light test addin - some code cleaning - Known Issues - `Reverse` not working reliably in some cases https://github.com/snowdd1/homebridge-knx/issues/67 - Not filtering invalid responses before answering to homekit https://github.com/snowdd1/homebridge-knx/issues/66 ## 0.3.2 - Fixed `-U <path> not being used for knx_config.json path - added new getProperty() method to add-in API ### 0.3.1-a Updated README only ## 0.3.1 ###maintenance/patch release - Updated [`homebridge`](https://github.com/nfarina/homebridge) dependency to >=0.4.9, as an important bug has been fixed in that version, that especially KNX users with a lot of services (and we all have, don't we?) could affect. - Updated `eibd` dependency to latest version 0.3.5 - Updated `debug` dependency to latest stable version 2.3.0 - Removed a legacy line of code that was never executed ## 0.3.0 initial release # Version numbering conventions **First digit** - Major version; if =0 then software is assumed to be not production ready (in this case - it's open source non-commercial and therefore use at own risk!) **Second digit** - Minor version number; Increase of minor version should not break compatibility, unless **first digit was 0** **Third digit** - Patch number, unless **first digit was 0**; then minor version **Appendices** - Sub-Patch; usually no code change; documentation changes only! Will usually **not** be published to **NPM**