= UI4 Installation and Setup =

1. Download these files on your computer:
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/tags/2.44_UI4/D_VistaAlarmPanel1.json | D_VistaAlarmPanel1.json]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/tags/2.44_UI4/D_VistaAlarmPanel1.xml | D_VistaAlarmPanel1.xml]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/tags/2.44_UI4/D_VistaAlarmPartition1.json | D_VistaAlarmPartition1.json]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/tags/2.44_UI4/D_VistaAlarmPartition1.xml | D_VistaAlarmPartition1.xml]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/tags/2.44_UI4/I_VistaAlarmPanel1.xml | I_VistaAlarmPanel1.xml]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/tags/2.44_UI4/J_VistaAlarmPanel1.js | J_VistaAlarmPanel1.js]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/tags/2.44_UI4/L_VistaAlarmPanel1.lua | L_VistaAlarmPanel1.lua]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/tags/2.44_UI4/S_AlarmPartition2.xml | S_AlarmPartition2.xml]]
* [[http://code.mios.com/svn_public/mios_vista-alarm-panel-ad2usb/tags/2.44_UI4/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 Vera UI.
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 be added to the keypad addresses list for the partition it is assigned to.

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

'''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'''.

'''NOTE:''' If the port is not on the serial port list, first make sure that the AD2USB is connected to Vera, then restart Luup. After restart, try this step again.

11. Restart Luup. After Luup has restarted, reload the Vera UI. If everything works OK you should see the partition status updating.