= ActiveRFID = == Description == This plugin is intended to provide affordable RFID support to Vera, using ActiveRFID Hardware. Currently, this plugin has only been tested using one 40m transmitter and one USB RSSI receiver plugged directly into Vera. [[Image(ActiveRFID.PNG)]] == Where to Buy == The ActiveRFID hardware, formerly known as cheaperRFID, can be purchased from [http://cliste.sailwhatcom.com/catalog/1 Cliste Electronics]. I recommend purchasing the USB RSSI receiver, as eventually I intend to provide signal strength based events; and the difference in cost is negligible. I also recommend purchasing transmitters without any sealant, especially if you are purchasing multiple 40m transmitters. It's much easier to identify each transmitter if you pull all the batteries, and put them back in, one transmitter at a time. It's easy enough to seal them yourself using plastic dip or liquid electrical tape. == Setup == === First Time Installations === Before getting started setting up the plugin, a little effort is required to get the USB Receiver supported by Vera. 1. Plug your RFID receiver into one of Vera's USB ports. 2. Log in to your Vera using SSH. If you have never done this, you can refer to the instructions provided in the Luup Somfy Walkthrough [http://wiki.micasaverde.com/index.php/Luup_Somfy_Walkthrough#Step_1:_SSH_into_Vera here]. 3. Enter the following at the command prompt: {{{ echo "vendor:067b product:2303" >> /etc/cmh/serproxy.ports }}} 4. Now the hardware is set up. Keep your SSH session open. 5. Download the latest ActiveRFID plugin from this site. This should include all of the following files: * D_ActiveRFID.xml * D_RFIDTransmitter.json * D_RFIDTransmitter.xml * I_ActiveRFID.xml * S_ActiveRFID.xml * S_RFIDTransmitter.xml 6. Log into Vera using any web browser. Navigate to Devices > Luup plugins > Luup files. 7. Load all six of the plugin files, check the box labeled "Restart Luup after upload", and click "GO". [[Image(7-Upload.PNG)]] === Receiver Setup === 8. Navigate to Devices > Luup plugins. Scroll down to "Add device" at the bottom of the page, type "D_ActiveRFID.xml", select the room for your RFID receiver, and click "Add Device". [[Image(8-AddReceiver.PNG)]] 9. Scroll up to your new device, type in a name, confirm the room, and click "Save". [[Image(9-NameReceiver.PNG)]] 10. Navigate to Devices > Luup plugins > Serial Port configuration. Find the new serial device that has been created for your receiver. Under "Used by device", select the device you created in step 8. [[Image(10-Serial.PNG)]] 11. Click Save. === Transmitter Setup === If you are installing more than one transmitter, setup is much easier if you pull the batteries from all your transmitters, and put them back in, one transmitter at a time. 12. Navigate back to Devices > Luup plugins, and find the device you created. Expand it by clicking the "+" to the right. For "Transmitters", enter the number of transmitters you wish to add. Then, click "Save". This should create a child device for each transmitter you will add. [[Image(12-NumTransmitters.PNG)]] 13. Back at your SSH session, type the following: {{{ tail -f /var/log/cmh/LuaUPnP.log | grep RFID }}} You should see something like this: {{{ root@HomeControl:~# tail -f /var/log/cmh/LuaUPnP.log | grep RFID 50 07/01/10 15:04:39.601 luup_log:68: RFID tag 1iW9 found by receiver 68, but not assigned to a device. <0x3c10> 50 07/01/10 15:04:41.556 luup_log:68: RFID tag 1iW9 found by receiver 68, but not assigned to a device. <0x3c10> 50 07/01/10 15:04:43.747 luup_log:68: RFID tag 1iW9 found by receiver 68, but not assigned to a device. <0x3c10> }}} Please note the 4-character tag ID that is returned. 14. At your web browser, expand the child device created for your transmitter by clicking the "+" beside it. For "TagID", enter the 4-character ID found in the previous step. Click Save. [[Image(14-NameTransmitter.PNG)]] 15. Your new child device should now be tripped. Repeat steps 13-14 for each transmitter. === Creating Scenes === Now that you have your RFID Transmitters working, it's time to add some scenes. You may want to lock the doors when you leave, open the garage door when you come home, or set the thermostats to Energy Saving Mode only when you're gone. 16. Navigate to Scenes. Scroll down to the room to which you'd like to add your scene, and click "Add scene". 17. Name your scene, and click "Add event". 18. For "Device", select a transmitter device. For "Event type", select "Home/Away" or "Armed Home/Away". Name your event and select "Home" or "Away". 19. Expand "Commands" and select the commands you'd like to be associated with the scene. Click "Save". [[Image(19-Scene.PNG)]] === Adjusting === By default, a signal (transmission) received from a transmitter expires in 15 seconds. What this means is that when the transmitter is out of range, the plugin will "untrip" after 15 seconds. This is adjustable by editing the "Expire Time" variable in the RFID receiver device. 20. Navigate to Device > Luup plugins, and locate your RFID receiver device. Expand it, and for the "Expire Time" value, enter the number of seconds in which your transmissions will expire. Please note that the plugin will calculate the number of timers or "buffer" variables based on your Expire Time. What this means is at the default value of 15 seconds, there are a total of 7 timers created, that will represent the first transmission received, and the next six transmissions that will be received during the following 15 seconds. When a timer expires, it will start back up with the next transmission that is received. For this reason, the longer the time, the less likely you will experience false "trips". I'd recommend setting your Expire Time to no less than 10 seconds, but find the balance of reliability and response that works best for you.