== Installation & Setup ==

1. Download these files on your computer:
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/trunk/D_VistaAlarmPanel1.json | D_VistaAlarmPanel1.json]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/trunk/D_VistaAlarmPanel1.xml | D_VistaAlarmPanel1.xml]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/trunk/D_VistaAlarmPartition1.json | D_VistaAlarmPartition1.json]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/trunk/D_VistaAlarmPartition1.xml | D_VistaAlarmPartition1.xml]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/trunk/I_VistaAlarmPanel1.xml | I_VistaAlarmPanel1.xml]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/trunk/L_VistaAlarmPanel1.lua | L_VistaAlarmPanel1.lua]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/trunk/S_AlarmPartition2.xml | S_AlarmPartition2.xml]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/trunk/S_VistaAlarmPanel1.xml | S_VistaAlarmPanel1.xml]]

2. On the Vera dashboard, go to ''MiOS Developers'' -> '''Luup Files''' and upload all 8 files you downloaded.
3. If ''Restart Luup after upload'' is checked, uncheck it, then click ''GO''.
4. Go to '''Create Device'''; in the '''!UpnpDevFilename''' field enter ''D_VistaAlarmPanel1.xml'' and in the '''Description''' field enter ''Honeywell Ademco Vista'' (or any name you want). Press the ''Create Device'' button.
5. Restart Luup by clicking the curving arrows in upper right corner in the dashboard. After restart, reload the web page.
6. In the created device's control panel open the '''Advanced''' tab and enter the number of active partitions in the '''!NumPartitions''' input field.

'''Warning:''' The plugin might not work correctly if this number is incorrect.

7. Restart Luup. After restart a device for each partition is created.
8. In the partition's control panel, open the '''Advanced''' tab and in the '''!KeypadAddresses''' input field enter the addresses of the keypads assigned to this partition. If there are more than one keypad for a partition, enter the addresses of each keypad separated by a comma (e.g. If the keypads at addresses 17, 19 and 23 are assigned to this partition, the ''!KeypadAddresses'' will be ''17,19,23''). Repeat this for all the partition devices.

'''NOTE !#1:''' The AD2USB's address should not be added to the keypad addresses list for any partition.

'''NOTE !#2:''' If the ''!KeypadAddresses'' field doesn't exist, reload the web page.

'''WARNING''': The plugin won't work correctly if these variables aren't correctly set.

9. Restart Luup.
10. Assign and configure the serial port to the panel device: in the panel device's control panel, open the '''Settings''' tab, click on the '''I/O''' button to open the '''Serial Port configuration''' panel and select the serial port connected to the AD2USB. Set the ''Baud'' to '''115200'''.
11. Restart Luup.
12. Enjoy using the plugin. :)