= ActiveRFID = == Description == This plugin is intended to provide affordable RFID support to Vera, using ActiveRFID Hardware. Currently, this plugin has only been tested using multiple transmitters and one USB RSSI receiver plugged directly into Vera. It is fully functional on UI2, and has been verified on UI4 beta. This has also been tested using multiple receivers connected to vera, locally and over IP using the IPSerial plugin. Check this Description and the Roadmap for current status and upcoming milestones for this project. [[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. Please note that I am not affiliated with Cliste Electronics in any way. I'm just a customer. I will say that they are responsive, and they deliver within 5 days in the US. == 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. 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 2. Log into Vera using any web browser. 3. In the Toolbox, click the "MiOS developers" icon. [[Image(1-Toolbox.PNG)]] 4. A new window will pop up; select the "Luup Files" tab. Scroll to the bottom, and load all six files. Check the box labeled "Restart Luup after upload", and click "GO". Close out of this window by clicking the X in the top right corner. [[Image(2-Upload.PNG)]] === Receiver Setup === At this point, please note 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. 5. Plug your RFID receiver into one of Vera's USB ports, or if none are available, plug in a USB hub and plug the RFID receiver into that. 6. Once again, in the Toolbox, click the "MiOS developers" icon, but this time select "Create device". Under "UpnpDevFilename", type "D.ActiveRFID.xml" (no quotes). Select a room and click "Create device". Then, close this window by clicking the X in the top right corner. [[Image(3-CreateReceiver.PNG)]] 7. Back at the dashboard, scroll down to your new device. Click the wrench beside your device name, and select the "Advanced" tab. Name your receiver, then close this window. Scroll up to the top of the dashboard, and click "Save". [[Image(4-NameReceiver.PNG)]] 8. Once again, click the "MiOS developers" icon, but this time select the "Serial Port configuration" tab. Here you should find your new serial device, named "pl2303". Rename this if you'd like. At the "Used by device" field, select the new device you created in steps 6-7. [[Image(5-SerialPortConfig.PNG)]] 9. Once you select the device, you will automatically be redirected to your device config screen. Close out of this by clicking the X in the top right corner. [[Image(6-SerialPortAssign.PNG)]] 10. Click Save. === Transmitter Setup === As mentioned above, at this point you should only have one transmitter with batteries in it. This makes identifying each transmitter easier. 11. At this point, just wait. Your transmitter should be identified. You will see the "Server Busy" dialog once for the save process in step 10, and once for each transmitter found. [[Image(7-Wait.PNG)]] 12. Once your transmitter is found, put batteries into each additional transmitter, one at a time, and note which transmitter is associated with each device created. The rule of thumb is to wait approximately 1-2 minutes between adding each transmitter. Once complete, you should see all of your identified transmitters. [[Image(8-TransmittersFound.PNG)]] 13. Name your transmitters by clicking the wrench beside each one and clicking the "Advanced" tab. [[Image(9-NameTransmitter.PNG)]] 14. Click "Save". === 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. 15. Back at the dashboard, find your RFID receiver device created in step 6-7, and click the wrench beside it. Click the "Advanced" tab. Scroll down to the "Expire Time" variable, and enter the desired time in seconds. [[Image(10-AdjustExpire.PNG)]] 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. === 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. Back at the dashboard, click the "Add Scene" icon at the top left. Name your scene by clicking the bold "New Scene" at the top of this window. 17. Select the "Events" tab, and click "Add event". Select one of your transmitters. Choose the type of event, and name it. Select tripped "yes" or "no". [[Image(11-SceneEvents.PNG)]] 18. Select the "Commands" tab, then pick a room, and choose the actions you'd like to execute as part of this scene. Close this window by clicking the X at the top right, and click "Save". [[Image(12-SceneCommands.PNG)]] ----