Changelog

This project follows Semantic Versioning.

v0.22.2 - 2021-10-12

Fixes

  • Incorrect parsing of :motion type from a SensorBinaryReport

v0.22.1 - 2021-10-4

Added

Fixes

v0.22.0 - 2021-10-01

This release brings Grizzly up to speed to support command classes that have been updated to support extended node ids. This allows Grizzly to support zipgateway versions that have Z-Wave Long Range support. That is zipgateway >= v7.15.

Changed

  • Removed Grizzly.ZWave.Commands.NodeAddStatus.status() type
    • Now is Grizzly.ZWave.CommandClasses.NetworkManagementInclusion.node_add_status()
  • Changed return type of Grizzly.ZWave.CommandClasses.ThermostatSetpoint.decode_type/1 function from {:ok, Grizzly.ZWave.CommandClasses.ThermostatSetpoint.type()} to Grizzly.ZWave.CommandClasses.ThermostatSetpoint.type()

Added

Fixed

  • Parsing thermostat setpoint types that are considered NA by the specification
  • Version report command parsing for zipgateway >= 7.14

v0.21.1 - 2021-9-21

Fixed

  • Transmission stats
    • Ensure :rssi_4bars and :rssi_dbm accurately calculate no signal when :rssi_hops are nil

v0.21.0 - 2021-9-20

Added

  • Transmission stats
    • Added :rssi_4bars and :rssi_dbm

Changed

  • Transmission stats
    • :rssi is now :rssi_hops and has been changed from a tuple to a list
    • :last_working_route and :transmission_speed have been separated
    • :last_working_route is now a list
    • :route_changed is now a boolean

Fixed

v0.20.2 - 2021-8-11

Changed

  • Turn off TLS warning for connecting with zipgateway server

v0.20.1 - 2021-7-1

Added

Thank you to those who contributed to this release:

  • Grace Yanagida

Fixed

v0.20.0 - 2021-6-14

The release breaks the return value of Grizzly.ZWave.CommandClasses.NodeProvisioning.optional_dsk_to_binary/1 from returning nil to returning a DSK filled will 0s if an empty binary string is passed into the function.

If you have not called this function directly then it is safe to upgrade to v0.20.0.

Changed

v0.19.1 - 2021-4-23

Added

  • Configuration option for setting the RF region
  • Configuration option for setting power level settings
  • Allow passing send command options to functions in Grizzly.SwitchBinary module

Thank you to djantea for testing out the RF configuration changes!

v0.19.0 - 2021-4-19

Breaking change in regards to how meta extensions are passed to Grizzly.Network.set_node_provisioning/3.

The meta extension were once structs that need to be built and passed to the function, but now they are a keyword list. Please see Grizzly.ZWave.SmartStart.MetaExtension module for more details on the keyword keys and their values.

Added

  • Added Grizzly.SwitchBinary has a higher level helper module to control
  • binary switches
  • Added basic support for including Z-Wave LR devices
  • Added LR command class support for NetworkManagementInclusion
  • Support version 2 of User Number Report command
  • Better handling of RSSI channel reports
  • Better handling of Association Group Name Report command

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.18.3 - 2021-3-11

Added

Fixed

  • Ensure that the DSK binary is 128 bits

v0.18.2 - 2021-2-18

Added

  • Use cerlc library for Grizzly.ZWave.CRC
  • Clean up inspects from tests
  • Ensure zipgateway files are usable by system utils for zipgateway

v0.18.1 - 2021-2-10

Fixed

  • Fix up dialyzer types

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.18.0 - 2021-2-10

This release breaks the DSK API and other supporting APIs. If you have not supported S2 inclusions, smart start, or use the DSK API for any reason then it should be safe to upgrade.

The break to DSKs is the new Grizzly.ZWave.DSK.t() struct. All inclusion and node provisioning commands now expect a Grizzly.ZWave.DSK.t(). There are two times you will need to get a DSK.t():

  1. User input of a DSK pin (the nicely formatted representation)
  2. The binary (<<>>) representation.

For the first case you can use Grizzly.ZWave.DSK.parse/1 and for the second case you can use Grizzly.ZWave.DSK.new/1.

A common use case for DSKs is using the DSK pin (the first 5 digits in the DSK) to do S2 inclusion. This was done by calling Grizzly.Inclusions.set_input_dsk/1. Where the input DSK was an non_neg_integer(). This API has been changed to take a DSK.t().

Example

dsk_pin = "12345"
{:ok, dsk} = Grizzly.ZWave.DSK.parse(dsk_pin)

Grizzly.Inclusions.set_input_dsk(dsk)

This API is more useful for taking user input (which the DSK pin is), parsing it, and passing the DSK to the inclusion process. Also this pushes validation of DSK to the Grizzly.ZWave.DSK.parse/1 function.

dsk_pin = "123456"
{:error, :invalid_dsk} = Grizzly.ZWave.DSK.parse(dsk_pin)

The DSK.t() has the String.Chars protocol implemented so if you want to a pretty representation of the DSK, say for logging or displaying the DSK to the user, you call the to_string/1 function on the DSK.t(). Also, see Grizzly.ZWave.DSK.to_string/2 for more details.

If you need to access the raw binary form of the DSK you the DSK.t() exposes the :raw field, so you can access that via dsk.raw.

This release also added support S2/SmartStart QR code generation. See the Grizzly.ZWave.QRCode module for more details.

Changed

Added

v0.17.7 - 2021-2-4

Fixed

  • An issue when zipgateway sends an invalid FirmwareMDReport packet causing invalid hardware version errors during firmware updates.

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.17.6 - 2021-2-3

Fixed

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.17.5 - 2021-1-26

Added

  • Docs on operating indicator light

Fixed

  • Crash when indicator handler is nil
  • Math for MeterReport

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.17.4 - 2021-1-21

Added

  • Support for handling indicator events via the :indicator_handler option to the Grizzly.Supervisor.

v0.17.3 - 2021-1-14

Added

  • Grizzly.Trace module for logging Z/IP packets that are sent from and received by Grizzly.

Fixed

  • No match error when trying to encode a node id list

v0.17.2 - 2021-1-13

Added

  • Decoding the NodeInfoCacheGet command

Fixed

  • Incorrect return value for NodeInfoCacheGet when decoding the params
  • Issues around firmware updates and zipgateway versions >= 7.14.2

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.17.1 - 2021-1-12

Added supported for using zipgateway versions >= 7.14.2.

When upgrading from a zipgateway version less than 7.14.2 you should provide the zgw_eeprom_to_sqlite utility in your system or firmware. The utility should be located in /usr/bin. Grizzly will try to run the utility if we detected it.

You can configure the database file and eeprom file via :database_file and :eeprom_file options for the Grizzly.Supervisor. These are optional and no changes are necessary for how you start Grizzly if you have already been using Grizzly.

Added

  • Support for zipgateway versions >= 7.14.2
  • :eeprom_file to supervisor args (optional)
  • :database_file to supervisor args (optional)

Thank you to those who contributed to this release:

  • Frank Hunleth

v0.17.0 - 2021-1-8

Breaking change with how Grizzly reports water alarms.

If you are listening for water alarm notifications you will need to update from :water to :water_alarm. This change was made to align better with the Z-Wave specification.

Added

  • Complete support for all notification events
  • Support for version 2 of the Antitheft command class
  • Support for SceneActuatorConf command class
  • Support for SceneActivation command class
  • More support for Erlang 23.2 DSL messages

Changed

  • :water is not :water_alarm notification

Fixed

  • When receiving the supervision command class with a command encapsulated Grizzly was not actually processing the encapsulated command.

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.16.2 - 2020-12-23

Added

v0.16.1 - 2020-12-22

Added

Fixed

  • Data structure change in the associations file when deleting all associations
  • Wrong MultiChannelAssociation version number being reported to devices
  • Ensure ack responses are sent when extra commands are received
  • Force bind to fd00::aaaa::2 since zipgateway forces that all acks come from this address
  • Crash when receiving errors other than timeouts when trying to establish connections to zipgateway

Thank you to those who contributed to this release:

  • Frank Hunleth

v0.16.0 - 2020-12-21

This release introduces a breaking change to the naming of the command class get and command class report modules. If you are using those modules directly, you will need to update to the use the new module names.

Changed

Added

  • Added support for forcing the Z-Wave cache to update when fetching node information. See Grizzly.Node.get_info/2 for more information.
  • Support for OTP 23.2

Fixed

  • In some GenServers an exception would cascade

Changed

  • Easier to read stack traces when some GenServers crash

v0.15.11 - 2020-12-11

Added

  • Support for DoorLock command class version 4

Fixed

  • Querying command class versions for extra commands on the LAN will return the version report correctly now.

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.15.10 - 2020-12-8

Added

  • Support for querying the gateway about the command class versions it supports when querying extra supported command classes.

Fixed

  • Spelling error fix for the WakeUpNoMoreInformation command name

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.15.9 - 2020-12-4

Added

  • Sending commands directly to the Z-Wave Gateway by passing Grizzly.send_command/4 :gateway as the node id.
  • How to get DSK for a device in the cookbook docs

Fixed

  • Spelling, whitespace and markdown issues in docs

Thank you to those who contributed to this release:

  • Frank Hunleth

v0.15.8 - 2020-12-1

Added

  • Support for ZwavePlusInfo command class

Fixed

  • No function clause matching error when a connection closes
  • Missing support for :undefined indicator

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.15.7 - 2020-11-30

Added

Fixed

  • Error when handling older Z-Wave devices that use CRC16 checksums over any security schema
  • Internal typo

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.15.6 - 2020-11-19

Added

Changed

  • Drop support for Elixir 1.8 and 1.9

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.15.5 - 2020-11-12

Added

  • Support multi-channel associations in the unsolicited destination

Fixed

  • Add the :aggregated_endpoints params to the MultiChannelEndpointReport

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.15.4 - 2020-11-5

Added

  • Network management installation and maintenance command class
  • Clock command class
  • Unsolicited server support for the extra command classes:
    • Association group command class list
    • Association group name get
    • Association group info get
    • Device reset locally notification

Changed

  • When a supervision get command is received in the unsolicited destination we send the supervision report for that command back to the sender.
  • Dev deps updates
  • Code clean up

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.15.3 - 2020-10-27

Fixed

  • Documentation fixes
  • Internal firmware update runner bug

Changed

  • Updates in internal association persistence

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.15.2 - 2020-10-23

Added

  • Support for the unknown_event notification event for the access_control notification type

Fixed

  • Support SupervisionGet command for notifications.
  • Tried to send :ack_response via unsolicited server which the unsolicited server should not be sending anything directly.
  • Fix typo in code

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.15.1 - 2020-10-09

Added

  • Support for getting association grouping report via the Z-Wave PAN
  • Support for setting associations via the Z-Wave PAN
  • Support for removing associations via the Z-Wave PAN
  • Support for getting specific associations via the Z-Wave PAN
  • Added option to Grizzly.Supervisor for where to store data used by the
  • unsolicited server for support of extra command classes

Changed

  • When getting the associations via the Z-Wave PAN, Grizzly will now look at the stored data and respond accordingly.

Fixed

v0.15.0 - 2020-10-08

This release does a major overhaul on the Grizzly.Transport behaviour. If you haven't implemented a custom transport this release should not effect you and you should be able to update with out too many issues, see the "Removed" section of this release to note any other breaking changes. If you have created a custom transport please see the documentation for Grizzly.Transport to see how transports are now implemented.

Added

Changed

  • Refactored the Grizzly.Transport behaviour - please see documentation to see how to use the behaviour now.

Removed

  • Grizzly.Node.get_node_info/1

Fixed

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier
  • Jon Wood

v0.14.8 - 2020-09-29

Added

  • Support for power management notifications

v0.14.7 - 2020-09-25

Added

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.14.6 - 2020-09-18

Added

  • Cookbook documentation for common uses of Grizzly

Changed

  • Reduced the amount of logging

v0.14.5 - 2020-09-02

Fixed

  • Commands with aggregated reports did not aggregate the results as expected
  • Commands with aggregated reports would crash if that device was also handling another command due to the aggregate handler assuming that only one command was being processed at one time

v0.14.4 - 2020-09-01

Added

  • Full support for ThermostatFanMode mode types

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.14.3 - 2020-08-31

Fixed

  • Fix the start order of the connection supervisor and Z-Wave ready checker to ensure the supervisor process is alive before trying to test the connection

v0.14.2

Added

Removed

  • crc dependency

v0.14.1

Enhancements

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.14.0

This breaking change has to do with how Grizzly is started. It is no longer an application. Grizzly exposes the Grizzly.Supervisor module for a consuming application to add to its supervision tree. All other APIs are backwards capable.

See the upgrade guide for more specifics on how to upgrade.

Breaking Changes

  • Grizzly is not an OTP application anymore and will need to be started manually via the new Grizzly.Supervisor module
  • All application config/mix config options are not used
  • Removed the Grizzly.Runtime module

Enhancements

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.13.0

This update breaks the main Grizzly.send_command/4 API as Grizzly use to respond with different tuples but now it will return with the new Grizzly.Report.t() data structure. A full guide on the breaking changes and what needs to be updated can be found here.

This change allows us to gather more information about a response from Grizzly. For example, with this change you can get transmission stats about network properties when sending a command now:

{:ok, report} = Grizzly.send_command(node_id, command, command_args, transmission_stats: true)

report.transmission_stats

See the Grizzly.Report module for full details.

Enhancements

  • Add Grizzly.Report
  • Add getting transmission stats for sent commands
  • Docs and type spec updates

v0.12.3

Fixes

  • Handle multichannel commands that are not appropriately encapsulated

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.12.2

Enhancements

v0.12.1

Enhancements

Fixes

  • Some devices send alarm reports that do not match the specification in a minor way. So, we allow for parsing of these reports now.
  • Fixed internal command class name to module implementation mapping issue for :switch_multilevel_set and :switch_multilevel_get commands.

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.12.0

There is a small breaking change that will only effect you if you hard have :water_leak_detected_known_location and :water_leak_dropped_known_location hard coded into your application for any reason. These are notifications about water leaks, and so if you have not directly tried to match on or handle logic about water leak notifications then this breaking change should not effect you.

From a high level this release provides updates to Z-Wave notifications in terms of command support and package parsing, extra tooling for better introspection, a handful of new commands and command classes, and helpful configuration items.

Enhancements

Fixes

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.11.0

Grizzly now supports parsing alarm/notification parameters as a keyword list of parameters. This change is breaking because the event parameters use to be the raw binary we received from the Z-Wave network and now it is a keyword list.

We only support lock and keypad event parameters currently, but this puts into place the start of being able to support event parameters.

Enhancements

  • Support parsing event parameters for lock and keypad operations

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.10.3

Enhancements

Fixes

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v.0.10.2

Enhancements

Fixes

  • Sensor types returned from the support sensors report
  • Broken link in docs

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v.0.10.1

Enhancements

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.10.0

Removed the parameter :secure_command_classes from Grizzly.ZWave.Command.NodeInfoCacheReport. Also updated the param :command_classes to be a keyword list of the various command classes that the node can have.

The fields in the keyword list are:

  • :non_secure_supported
  • :non_secure_controlled
  • :secure_supported
  • :secure_controlled

If you are using :secure_command_classes for checking if the device is securely added you can update like this:


{:ok, node_info} = Grizzly.Node.get_info(10)

Keyword.get(Grizzly.ZWave.Command.param!(node_info, :command_classes), :secure_controlled)

Enhancements

Fixes

  • Internal command class name discrepancies

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.9.0

The official v0.9.0 release!

If you trying to upgrade from v0.8.x please see Grizzly v0.8.0 -> v0.9.0 guide and follow the Changelog from the initial v0.9.0-rc.0 release.

Changes from the last rc are:

Enhancements

  • Support Erlang 23.0 with Elixir 1.10
  • Dep updates and tooling enhancements

Fixes

  • miss spellings of command names

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.9.0-rc.4

Enhancements

Fixes

  • When resetting the controller we were not closing the connections to the nodes. This caused some error logging in zipgateway and also left open unused resources. This could cause problems later when reconnecting devices to resources that were already in the system.

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.9.0-rc.3

Enhancements

  • Some Z-Wave devices report the wrong value for the switch multilevel report so we added support for those values.

Fixes

  • When two processes quickly sent the same command to the same device only one process would receive the response

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.9.0-rc.2

Deprecated

Added

Enhancements

  • Support for DoorLockOperationReport >= V3 parsing

Fixes

  • Bad parsing of NodAddStatus :failed value

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier

v0.9.0-rc.1

Breaking Changes

  • Grizzly.ZWave.IconTypes removed icon_type from the atom values of the icon name.
  • Grizzly.ZWave.DeciveTypes.icon_name() -> Grizzly.ZWave.DeviceTypes.name()
  • Grizzly.ZWave.DeciveTypes.icon_integer() -> Grizzly.ZWave.DeviceTypes.value()

Enhancements

  • Doc updates
  • Internal code quality
  • Deps updates
  • Better types around DSKs
  • CI support for elixir versions 1.8, 1.9, and 1.10
  • Support all versions of the meter report
  • Support a low battery report

v0.9.0-rc.0

For more detailed guide to the breaking changes and how to upgrade please see our Grizzly v0.8.0 -> v0.9.0 guide.

This release presents a simpler API, faster boot time, more robustness in Z-Wave communication, and resolves all open issues on Grizzly that were reported as bugs.

Removed APIs

  • Grizzly.Node struct
  • Grizzly.Conn module
  • Grizzly.Notifications module
  • Grizzly.Packet module
  • Grizzly.close_connection
  • Grizzly.command_class_versions_known?
  • Grizzly.update_command_class_versions
  • Grizzly.start_learn_mode
  • Grizzly.get_command_class_version
  • Grizzly.has_command_class
  • Grizzly.connected?
  • Grizzly.has_command_class_names
  • Grizzly.config
  • Grizzly.Network.busy?
  • Grizzly.Network.ready?
  • Grizzly.Network.get_state
  • Grizzly.Network.set_state
  • Grizzly.Network.get_node
  • Grizzly.Node.new
  • Grizzly.Node.update
  • Grizzly.Node.put_ip
  • Grizzly.Node.get_ip
  • Grizzly.Node.connect
  • Grizzly.Node.disconnect
  • Grizzly.Node.make_config
  • Grizzly.Node.has_command_class?
  • Grizzly.Node.connected?
  • Grizzly.Node.command_class_names
  • Grizzly.Node.update_command_class_versions
  • Grizzly.Node.get_command_class_version
  • Grizzly.Node.command_class_version_known?
  • Grizzly.Node.update_command_class
  • Grizzly.Node.put_association
  • Grizzly.Node.get_association_list
  • Grizzly.Node.configure_association
  • Grizzly.Node.get_network_information
  • Grizzly.Node.initialize_command_versions

Moved APIs

  • Grizzly.reset_controller -> Grizzly.Network.reset_controller
  • Grizzly.get_nodes -> Grizzly.Network.get_node_ids
  • Grizzly.get_node_info -> Grizzly.Node.get_node_info
  • Grizzly.Notifications.subscribe -> Grizzly.subscribe_command and Grizzly.subscribe_commands
  • Grizzly.Notifications.unsubscribe -> Grizzly.unsubscribe
  • Grizzly.add_node -> Grizzly.Inclusions.add_node
  • Grizzly.remove_node -> Grizzly.Inclusions.remove_node
  • Grizzly.add_node_stop -> Grizzly.Inclusions.add_node_stop
  • Grizzly.remove_node_stop -> Grizzly.Inclusions.remove_node_stop
  • Grizzly.Client -> Grizzly.Transport
  • Grizzly.Security -> Grizzly.ZWave.Security
  • Grizzly.DSK -> Grizzly.ZWave.DSK
  • Grizzly.Node.add_lifeline_group -> Grizzly.Node.set_lifeline_association

We moved all the commands and command classes to be under the the Grizzly.ZWave module namespace and refactored the command behaviour.

Grizzly.send_command Changes

The main API function to Grizzly has changed in that it only takes a node id, command name (atom), command args, and command options.

Also it no longer returns a plain map when there is data to report back from a Z-Wave node but it will return {:ok, %Grizzly.ZWave.Command{}}.

Please see Grizzly and Grizzly.ZWave.Command docs for more information.

Connections

Grizzly uses the zipgateway binary under the hood. The binary has its own networking stack and provides a DTLS server for us to connect to. Prior to Grizzly v0.9.0 we greatly exposed that implementation detail. However, starting in Grizzly v0.9.0 we have hidden that implementation detail away and all connection functionally is handle by Grizzly internally. This leaves the consumer of Grizzly to just work about sending and receiving commands.

If you are using %Grizzly.Conn{} directly this is no longer available and you should upgrade to just using the node id you were sending commands to.

When Grizzly is Ready

We use to send a notification to let the consumer to know when Grizzly is read. Staring in v0.9.0 the consumer needs to configure Grizzly's runtime with the on_ready module, function, arg callback.

config :grizzly,
  runtime: [
    on_ready: {MyApp, :some_function, []}
  ]

See Grizzly.Runtime for more details

Inclusion Handler Behaviour

Adding and removing a Z-Wave node can be a very interactive process that involves users being able to talk to the including controller and device. The way Grizzly < v0.9.0 did it wasn't vary useful or robust. By adding the the inclusion handler behaviour we allow the consumer to have full control over the inclusion process, enabling closer to Z-Wave specification inclusion process.

See Grizzly.InclusionHandler and Grizzly.Inclusions for more information.

Command Handler Behaviour

If you need to handle a Z-Wave command lifecycle differently than the default Grizzly implementation you can make your own handler and pass it into Grizzly.send_command as an option:

Grizzly.send_command(node_id, :switch_binary_set, [value: :on], handler: MyHandler)

See Grizzly.CommandHandler for more information.

Supporting Commands

At the point of the rc.0 release are not fully 100% supporting the same commands as in < v0.8.8, but we are really close. The commands that we haven't pulled over are not critical to average Z-Wave device control. We will work to get all the commands back into place.

Thank you to Jean-Francois Cloutier for contributing so much to this release.

v0.8.8

  • Enhancements
    • Make Z-Wave versions standard version formatting
  • Fixes
    • Paring the FirmwareMD report for version 5
    • Fix spec for queued commands

v0.8.7

  • Enhancements
    • Support FIRMWARE_UPDATE_MD meta data report command v5

v0.8.6

v0.8.5

  • Fixes
    • various spelling and documentation fixes
    • dialzyer fixes

v0.8.4

  • Fixes
    • Handle when there are no nodes in the node provisioning list when requesting all the DSKs.

v0.8.3

  • Enhancements
    • Support Wake Up v2 and Multi Channel Association v3

v0.8.2

  • Enhancements
    • Support SWITCH_BINARY_REPORT version 2

v0.8.1

  • Enhancements
    • Update docs and resources
  • Fixes
    • An issue when the unsolicited message server would cause a no match error that propagated up the supervision tree

Thank you to those who contributed to this release:

  • Ryan Winchester

v0.8.0

Adds support for handling SmartStart meta extension fields.

These fields give more information about the current status, inclusion methods, and product information for the SmartStart device.

There are two breaking changes:

  1. All SmartStart meta extensions were moved from Grizzly.CommandClass.NodeProvisioning namespace into the Grizzly.SmartStart.MetaExtension namespace.
  2. Upon finalizing the meta extension behaviour and API we made changes to how previously supported meta extensions worked. Namely, we added a new/1 callback that does parameter validation, and returns {:ok, MetaExtension.t()}. This breaks the pervious behaviour of to_binary/1 functions in perviously implemented meta extensions.
  • Enhancements
    • Full support for SmartStart meta extensions
    • Add meta_extensions field to Grizzly.CommandClass.NodeProvisioning commands that can handle meta extensions
    • Update Grizzly.Conn.Server.Config docs
  • Fixes
    • Invalid keep alive (heart beat) interval
    • Set correct constraints on Time command offset values

Thank you to those who contributed to this release:

  • Jean-Francois Cloutier
  • Ryan Winchester

v0.7.0

Introduces SmartStart support!

SmartStart will allow you to pair a device to a Z-Wave controller with out turning the device on. Devices that support SmartStart will have a device specific key (DSK) that you can provide to the controller prior to turning on the device.

iex> Grizzly.send_command(Grizzly.Controller, Grizzly.CommandClass.NodeProvisioning.Set, dsk: dsk)
:ok

After running the above command you can plug in your SmartStart device and the controller will try to join the Z-Wave network automatically.

As a note, your controller might not have the necessary firmware to have SmartStart.

To verify this you can use RingLogger to read zipgateway logs which at the start will log if the controller supports SmartStart.

Breaking Changes

Breaking change to the return value of sending Grizzly.CommandClass.ZipNd.InvNodeSolicitation.

When using that function send_command would return {:ok, {:node_ip, node_id, ip_address}} but now it returns {:ok, %{ip_address: ip_address, node_id: node_id, home_id: home_id}}.

  • Enhancements
    • SmartStart support through the NodeProvisioning command class
    • Added home_id field to Grizzly.Node.t()
    • Support fetching home_id of the Z-Wave nodes when fetching Z-Wave information about the node

v0.6.6

  • Fixes
    • Application start failure when providing the correct data structure to the zipgateway_cfg configuration field

v0.6.5

  • Enhancements
    • Support GetDSK command
    • Support FailedNodeRemove command
    • Allow zipgateway_path configuration
    • Generate the zipgateway.cfg to allow device specific information to be passed into the zipgateway runtime.

v0.6.4

  • Enhancements
    • Validation of UserCode arguments to help ensure usage of Grizzly follows the Z-Wave specification

v0.6.3

  • Enhancements
    • Supports AssociationGroupInformation Command Class

v0.6.2

  • Enhancements
    • Remove the dependence on pidof allowing grizzly to work on any nerves device without the need of busybox

v0.6.1

  • Enhancements
    • Update commands IntervalGet and ManufacturerSpecificGet to be more consistent
    • Better handling of invalid ManufacturerSpecific info received from devices

v0.6.0

Changed Grizzly.CommandClass.CommandClassVersion to Grizzly.CommandClass.Version and changed Grizzly.ComamndClass.CommandClassVersion.Get to Grizzly.CommandClass.Version.CommandClassGet as these names reflect the Z-Wave specification better.

If you only have used Grizzly.get_command_class_version/2 and the related function in Grizzly.Node module this change should not effect you.

  • Enhancements
    • Add support for:
      • MultiChannelAssociation Command Class
      • WakeUp Command Class NoMoreInformation command
      • Complete Association Command Class
      • ZwaveplusInfo Command Class
      • Version Get Command
    • Clean up docs
    • Renamed Grizzly.CommandClass.CommandClassVersion to Grizzly.CommandClass.Version
    • Renamed Grizzly.CommandClass.CommandClassVersion.Get to Grizzly.CommandClass.Version.CommandClassGet

v0.5.0

Introduces Grizzly.Command.EncodeError exception and updates encoding and decoding functions to return tagged tuples. We now use these things when trying to send a command via Grizzly.send_command/3 so if you have invalid command arguments we can provide useful error handling with {:error, Grizzly.Command.EncodeError.t()}. The EncodeError.t() implements Elixir's exception behaviour so you can leverage the standard library to work with the exception.

Unless you have implemented custom commands or used one of the many command encoders or decodes explicitly this update should not affect you too much. If you have used the encoder/decoders explicitly please see the documentation for the ones you have used to see the updated API. If you have written a command we encourage you to validate the arguments and return the {:error, EncodeError.t()} to improve the usability of and robustness your command. The new Grizzly.Command.Encoding module provides some useful functionality for validating specs for command arguments.

  • Enhancements
    • Provide command argument validation and error handling via Grizzly.Command.EncodeError.()
    • Update all the command arg encoder/decoder to use tagged tuples for better handling of invalid command arguments
    • Introduces new Grizzly.Command.Encoding modules for helping validate command arugment specifications
  • Fixes
    • Crashes when providing invalid command arguments

v0.4.3

v0.4.2

  • Enhancements
    • Support NoOperation command class

v0.4.1

  • Enhancements
    • Add support for Network Management Installation Maintenance
    • Updates to docs and examples

v0.4.0

Changed how configuration works.

Grizzly now requires the serial port to be configured:

config :grizzly,
  serial_port: "/dev/ttyACM0"

Also added the pidof_bin configuration option to allow official Nerves systems to work with some of the Grizzly scripts the call that utility by using the busybox package and pointing to the executable of pidof that is compiled with busybox.

If you are using a custom system you can add that utility to the busybox config, and not need to use this configuration option.

config :grizzly,
  pidof_bin: "/srv/erlang/lib/busybox-0.1.2/priv/bin/pidof"

Double check the version of busybox you are using and make sure that version matches the version in the pidof_bin path.

Changed run_grizzly_bin to run_zipgateway_bin.

v0.3.1

  • Enhancements
    • Implement multilevel sensor command to get supported sensor types

v0.3.0

The big change here is removing the in memory cache for devices on the network. Most common use cases will be for a consuming application to hold on to the network device information and apply some costume logic to now that is managed.

Also, we would have to keep both the external and internal cache in sync, which is really hard and was creating an odd event based system, which also lends itself to complexity.

Breaking Changes

Grizzly.list_nodes() -> Grizzly.get_nodes()

This is mostly because before we were listing nodes from a cache, and now we are getting nodes from the Z-Wave network.

Also with get_nodes we don't automatically connect to the nodes. So getting and connecting to all nodes on the Z-Wave network might look something like this:

def get_and_connect() do
  case Grizzly.get_nodes() do
    {:ok, nodes} -> Enum.map(nodes, &Grizzly.Node.connect/1)
    error -> error
  end
end

Grizzly.update_command_class_versions/2 -> Grizzly.update_command_class_versions/1

Before we would pass if the update would be async or not after reviewing how this gets used it made sense to always do it sync. Also it returns a Node.t() now with the command classes updated with the version.

This is the same change found in Grizzly.Node.update_command_class_versions

Grizzly.command_class_version/3 -> Grizzly.get_command_class_version/2

Removed the use_cache param as there is no longer a cache.

Same change found in Grizzly.Node.get_command_class_version

  • Enhancements
    • Support Grizzly.CommandClass.Time command class
    • Support Grizzly.CommandClass.TimeParameters GET and SET commands
    • Support Grizzly.CommandClass.ScheduleEntryLock command class
    • Grizzly.Notifications.subscribe_all/1 - subscribe to many notifications at once
    • Grizzly.CommandClass.name/1 - get the name of the command class
    • Grizzly.CommandClass.version/1 - get the version of the command class
    • Grizzly.Network.get_nodes/0 - get the nodes on the network
    • Grizzly.Network.get_node/1 - get a node by node id from the network
    • Grizzly.Network.get_node_info/1 - get node information about a node via node id
    • Grizzly.Node.get_ip/1 - can now take either a Node.t() or a node id
  • Updates
    • Docs and type clean up
  • Fixes
    • Timeout when getting command class versions

v0.2.1

  • Updates
    • Support for the time command class
  • Fixes
    • Time-boxing of getting a command class version

v0.2.0

  • Fixes
    • Logging with old ZipGateway label is now Grizzly
    • Fix queued API from {ZipGateway, :queued_response, ref, response} to {Grizzly, :queued_response, ref, response}
    • Fix timeout error when waiting for DTLS server from the zipgateway side