Breaking changes · Migration guide
- Logging can now be configured through driver options. However, the environment variables for logging are no longer evaluated lazily, so they now need to be set before requiring
zwave-js
. - The second (string) parameter of the
"interview failed"
event handler was removed - The type
ValueMetadataBase
has been renamed toValueMetadataAny
. The old typeValueMetadataAny
was merged intoValueMetadataBase
. - The retry strategy for sending commands to nodes has been revised. By default, a message is no longer re-transmitted when the node has acknowledged its receipt, since it is unlikely that the retransmission will change anything. The old behavior can be restored by setting the
attempts.retryAfterTransmitReport
driver option totrue
.
To compensate for the change and give the response enough time to reach the controller, the default fortimeouts.response
has been increased from1600
to10000
. - The driver now distinguishes between stateful and event values. The latter are now exclusively exposed through the
"value notification"
event. - The deprecated
nodeInterviewAttempts
option was removed - The options
fs
andcacheDir
have been renamed tostorage.driver
andstorage.cacheDir
. - Loggers are now managed on a per-driver basis. This means you can use zwave-js to talk to different controllers and have separate logs for each.
- The
lookupXYZ
methods are no longer exposed by@zwave-js/config
. Use theconfigManager
property of your driver instance instead.
Config file changes
- The index file was removed from the repo and is now generated on demand
- Several improvements for GE dimmers and switches
- Added missing config parameters to IDLock 150
- Added Innovelli LZW36 and First Alert ZCOMBO-G
- Added Technisat Dimmer and series switch
- Added Lifeline association to Danfoss MT 2649
- Added product id/type to NAS-WR01ZE
- Added Inovelli LZW31 Black Series Dimmer
- Added Aeotec ZW187 Recessed Door Sensor 7
- Added checks for partial parameters
- Added Aeotec ZWA009 aerQ Temperature and Humidity Sensor
- Added Honeywell 39348/ZW4008
- Added Zooz zst10-700 z-wave usb stick
- New versions of
@zwave-js/config
are now automatically released every night if only config files were changed since the last release.
You can runnpm update @zwave-js/config
in thezwave-js
install dir to pull the latest config files. For now, a driver restart is required afterwards.
Features
- Added basic support for 700-series controllers
- Added a compatibility option to disable the
Basic CC
mapping - An option was added to enable logging to the console, even if it is not a TTY
- An option was added to control the filesystem access throttling
- Improved the
label
forLevel low
property inBatteryCC
- Unimplemented CCs may now be sent
- The version of
zwave-js
is now exported aslibVersion
from the main entry point - Implemented
Battery CC V3
- Added support for
Hail CC
Bugfixes
- Fixed an off-by-one error in the
Binary Sensor Supported Report
bitmask.
Note: If your devices are affected by this bug, re-interview them to remove corrupted values. - Expire nonces for
keepS0NonceUntilNext
devices until after the next nonce was received by the device - The interview is no longer aborted when a device does not respond to the Wakeup Capability query
- Fixed a crash that could happen when compressing the value DB with an existing backup file.
- Fixed a wrong value ID for
Multilevel Switch CC
targetValue
Changes under the hood
- Test releases for PRs can now be created with a command
- PRs titles are now enforced to comply with conventional commits
- Config json files are now automatically formatted in VSCode and linted
- We've added @zwave-js-bot to help us manage the repo and to help you contribute