|This page was written by Pluto and imported with their permission when LinuxMCE branched off in February, 2007. In general any information should apply to LinuxMCE. However, this page should be edited to reflect changes to LinuxMCE and remove old references to Pluto.|
These instructions have been tested working under VMWare 1.0.1-29996 using FC4 (18.104.22.168) as host operating system.
Howto install and use ZWave
Let's assume that you have pluto installed with IP: 10.0.2.128 (these instructions are also done by assuming that you have "hybrid" pluto installation).
Once you have succesfully installed the ZWave USB controller and it is seen on Pluto (media:zwave_homepro_interface.png), you can proceed by populating the ZWave network information to Pluto.
- Add your ZWave devices to your master ZWave master remote controller (like ZTH200)
- Once the devices are added to remote and verified they are working (you can control them with your remote controller), you need to copy the ZWave network information to Pluto.
- Go to pluto admin page ("http://10.0.2.128/pluto-admin/"), then choose "Wizard -> Devices -> Interfaces -> [your ZWave controller] -> Advanced".
- On the device page select "Send command to device".
- Select command "Download Configuration" and choose "Send Message".
- Leave the data and file fields as blank
- Now the pluto is waiting for the ZWave information and you should send a copy of the ZWave network with your master remote controller to pluto.
- If you are using HomePro remote controller this is done by selecting: "Setup -> Copy Remote Ctrl. -> Send Information -> Identical Copy". Once you have done that, the remote will show "Sending information..." and after succesfull sending it will return to clock screen (this shouldn't take more than couple of minutes).
- You can monitor the process by watching the Zwave log file on pluto (usually "/var/log/pluto/*ZWave.log"). Unfortunately the admin page doesn't give much information of what is being done and is everything going smoothly. If the process is successfull, you should see the pluto communicating with the USB controller
- Make sure the sending remote controller is near enough the USB receiver, othervise nothing will happen.
- Go to device tree (Show devices tree) and you should see (Media:zwave_devices_tree.png) the newly added ZWave modules/devices on the tree under "CORE -> ZWave".
You should do quick reload (Wizard -> Restart -> Quick Reload Router) in order to use the newly added devices with pluto. Once you have done that you should be able to control (like switching on/off) the devices under the Light (Media:zwave_lights.png).
HomePro USB ZWave controller
If the ZWave controller is not seen (or it's not working) by pluto, check that linux sees the USB device. The HomePro USB receiver uses USB serial device converter (it's not really a "true" USB device).
Once you plug in the device you should see the following kernel messages ("dmesg") when the correct modules are loaded:
usbcore: registered new driver usbserial drivers/usb/serial/usb-serial.c: USB Serial support registered for generic usbcore: registered new driver usbserial_generic drivers/usb/serial/usb-serial.c: USB Serial Driver core drivers/usb/serial/usb-serial.c: USB Serial support registered for FTDI USB Serial Device ftdi_sio 1-1:1.0: FTDI USB Serial Device converter detected drivers/usb/serial/ftdi_sio.c: Detected FT232BM usb 1-1: FTDI USB Serial Device converter now attached to ttyUSB0 usbcore: registered new driver ftdi_sio drivers/usb/serial/ftdi_sio.c: v1.4.3:USB FTDI Serial Converters Driver
Then you should have the following kernel modules loaded:
dcerouter_6722:/var/log/pluto# lsmod Module Size Used by ftdi_sio 32584 1 usbserial 32488 3 ftdi_sio
On the admin page (Interfaces -> Advanced) the ZWave interface COM port should point to USB device:
Device data: COM Port on PC pci0000:00/0000:00:07.2+1
dcerouter_6722:/var/log/pluto# lspci |grep USB 0000:00:07.2 USB Controller: Intel Corp. 82371AB/EB/MB PIIX4 USB
If the controller is seen by pluto, try sending some commands ("Wizard -> Devices -> Interfaces -> [your ZWave controller] -> Advanced") and watching the log files ("tail -f /var/log/pluto/*ZWave.log") at the same time.
You can try command like "Report Child Devices" which in my case (since I have 5 ZWave appliances supported by pluto) gives the following results:
36 11/05/06 10:45:51.358 ZWave::ReportChildDevices got: 36 11/05/06 10:45:51.358 1 37 4 37 5 37 6 37 7 37
In order to get these results you should already have downloaded the ZWave network configuration to pluto from master (remote) controller.
PIR (Binary Sensor) support
PIR (Passive Infra Red) sensor, a type of motion detector which uses invisible infra red light to detect movement in a room. PIR is sending "Sensor Tripped" events, so that you can use it in security scenarious.
All the tests were made using HomePro ZIR000 (RF Transmitter PIR) model.
HowTo install PIR
1) Open the PIR box so that you have access to Z-Wave button, it is used to remove/add (reset) the PIR from/to Z-Wave network 2) Use your Z-Wave Master Controller to add PIR 3) Copy the new Z-Wave network configuration to your Z-Wave USB device (see command "Download Configuration") 4) Reload Router 5) You should see the PIR device available as a child device of ZWave (see Pluto admin web pages), but the setup isn't ready yet. 6) Power off PIR, then power on again (remove a batery for few seconds). This step is important because PIR is in awake state only for 10 min after it's powered up. 7) After 2-3 min from step 6, PIR will send the wake up notification and PIR will be able to set its configuration. 8) You should receive the events from PIR
1) PIR needs 2 min of 'silence' to get to Trigger Off 2) Z-Wave has some new commands to support PIR :
- Assign Return Route - Set Association - Set Configuration Parameter - Set Wake Up
The configuration commands are sent automaticaly by Pluto's ZWave device. But if you are using a different PIR device and you need another setup parameters, you can use the new commands. 3) The PIR wake up notification is important, no commands are sent to PIR if the notification wasn't received. We must be sure that PIR is able to communicate with Z-Wave network.