ZWave Serial Controller
The Serial Controller is a USB device which plugs into the Virtual Wiring System. It provides access to all the Z-Wave devices on a Z-Wave network. When creating a Z-Wave network for a Virtual Wiring system, the Serial Controller Device is the first Z-Wave Device added.
Installing a Serial Controller
The Serial Controller Device has no terminals - its only function is as a controller of a Z-Wave network. A Controller is physically installed by plugging it into a USB port on the Virtual Wiring System.
After plugging in the Serial Controller, create a Serial Controller Device by running the ControllerSerial Script. The parameters for the ControllerSerial Script are:
To add a Serial Controller Device with ID "controller" and port_location "/dev/ttyUSB0", run the ControllerSerial Script with the following parameters:
Useful Controller Commands and Utilities
Hard Resetting the Serial Controller
The Serial Controller maintains a list of all the Z-Wave devices and addresses it has included into its Z-Wave network. You can remove devices from the network by unincluding them one at a time, but the controller may continue to assign addresses from where it left off or use seemingly random values. If you want to clear all the included device information from the controller and make it assign Z-Wave addresses like it did when you first started using it, run the hard reset command.
To run the hard reset command, go to your Console. If your controller is named "controller", enter the following command:
Learning the Addresses of All Included Z-Wave Devices
Each time you include a device into a Z-Wave network, the Serial Controller assigns it a Z-Wave address. If you don't know what address was assigned or want to be sure, you can run the
To run the
If your controller had included 4 devices, its response would be something like:
If you have included the 4 devices cleanly (no devices were unincluded), address 5 was the last device included.
Learning about a Particular Z-Wave Device
If you know the address of a Z-Wave device, but are not sure what the device is, you can learn more about it by running the
To run the
Low Level Controller Commands
You can query and configure the Controller using a set of low level commands using the
As an example, the controller's version number information is accessible using the "get version" command, which is command number 0x15 (or 21 decimal). To ask a controller with ID "controller" for its version information, go to the Console and type:
Your response will be a Z-Wave packet expressed as an array of bytes:
Byte 4 is where your return message starts - it echos your command of 21. Bytes 11 through 15 are an ASCII string with the version. This string is " 2.78".