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
- Added Fibaro Smart Switch FGS-214 and FGS-224
- Added Fortrezz fts05p
- Added an additional product type to Aeotec Range Extender 7
- Added iblinds V3
- Added Zooz ZEN31 RGBW Dimmer
- Change manufacturer Jasco Products to GE/Jasco
- Changed ZDB5100 config to expand on parameter 1
- Renamed config param #11 in Q-Light Puck
- Removed an unsupported parameter from GE 14294
- Root endpoint values are no longer hidden for Philip PAN06, Aeotec ZW095 energy meter
- 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 - Added a compatibility option to treat
Basic CC::Set
commands as events instead ofReport
s - Added a compatibility option
skipConfigurationInfoQuery
to work around a firmware issue inHeat-It Z-TRM2fx
- A driver option was added to enable logging to the console, even if it is not a TTY
- A driver 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
- ValueIDs that use a
Duration
instance as the value now have the metadata type"duration"
- Added a workaround for devices that return an invalid response when finding the first configuration param
- Added a
hexColor
property to theColor Switch CC
- Added the properties
ready
andallNodesReady
to the driver to read the status after the corresponding events were emitted - The node neighbor lists now get updated when a node is removed
- The
refreshValues
method is now exposed on node instances, which allows polling all actuator and sensor values of a node. Note: Please read the warnings in the documentation!
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
- The driver no longer assumes that a sleeping node falls asleep after a certain time
- The name and location of a node is no longer deleted when the node gets re-interviewed and does not support
Node Naming And Location CC
- The
propertyKeyName
ofMeter CC
values now contains the Meter type name Configuration CC
: empty Name and Info are now accepted as valid commandsstopInclusion
/stopExclusion
now always return aboolean
- Successful pings now correctly change the node status
- Messages from previous interview attempts are now dropped when an interview is restarted
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
- While editing device config files, supporting IDEs can now use a JSON schema to help you
- We've added @zwave-js-bot to help us manage the repo and to help you contribute
Older changelog entries