View source for Polisy:User Guide

Welcome to our Polisy corner: your one place for anything Polisy! 

'''Please see [https://forum.universal-devices.com/topic/37257-polisy-update-process-use-admin-console-upgrade-packages-button/ this important update (July 2022)]'''

='''Some Definitions!'''=
==ISY on Polisy (IoP)==
IoP is shorthand notation for '''ISY on Polisy'''. For the old timers, ISY is the code that runs on the 994, now running as an optimized and fast service on Polisy.

==Node Servers==
As you might already know, in ISY, everything is represented as a Node. These are things (or devices) that show up in your left navigation bar under ISY. A long time ago, these nodes were limited to INSTEON,X10/A10, Z-Wave, and Zigbee. Basically, protocols for which ISY994 had native support. We designed and developed node servers so that developers could integrate their things into ISY as nodes. And, hence, Node Servers: they serve nodes to ISY. 

These nodes can be anything. They represent real devices such as Ring, Tesla, WiFi light bulbs, Ecobee, or they could be virtual such as calendars and climate services. Once a node is represented in ISY, then the whole ISY event based and programming environment are available to it. In short, Node Servers allow ISY to support pretty much any device or thing out there.

But, where do these node servers live? Well, you have come this far, so read on ...

==Polyglot==
Node servers have to run on some computing device. And, forcing each developer to have to come up with his/her own node server from scratch would be completely detrimental to our quest. So, we designed and developed Polyglot which is a framework that allows developers to develop their node servers with ease and confidence that all the plumbing/security and communications with ISY is handled automatically.

'''Polyglot version 3 (PG3)''' is the latest version of Polyglot which includes much enhanced functionality and, most importantly, enables the developers to charge for their node servers. PG3 is only available on Polisy.

==Polisy==
Polisy is our own shiny, beautiful, powerful hardware/OS preconfigured and optimized to run Polyglot (and other things). So, for those of you non-geeks out there, we have taken all the geekiness out of Polyglot and provided you with a ready to run box. So, now that we got you excited, let's continue with setting up and using your Polisy.

[[File:All new polisy-ANT.jpg | 600px | center]]

='''First Steps'''=

==Installation==
Installation is quite easy
* Make sure your network has DHCP auto enabled
* Connect one end of the included Cat5e cable to Polisy’s Network Port and the other to your network. You '''must''' use the port that’s closest to the '''right''' most edge of Polisy when the front of Polisy is facing you (closest to the db-9 serial port). '''Note''': the network must initially be DHCP auto enabled
* If you have the PRO version, attach the included antennas to the back of the unit.
* Connect the power supply
* Make sure the bootup sequence is as described below

==Bootup Sequence==
If this is Polisy's first bootup, please be patient as Polisy will go through an initial sequence of lights and sounds while it prepares itself for you. This process might take several minutes since it may have to update your BIOS:
* All three lights on the front light up when powered on
** If BIOS does not need to be updated, after a few seconds, only the left most stays lit for up to a minute and then, all lights turn off, you'll hear a couple of beeps
** If BIOS needs to be updated, the 2nd and 3rd light keep blinking while the BIOS is updated and the unit reboots and follows the normal process
** Everything is operational once only the left most light is lit either initially or after BIOS update
* If the 2nd or 3rd light keep blinking for more than 3 minutes, then there is an underlying issue. Please review the [[Polisy:User_Guide#Troubleshooting | Troubleshooting]] section

==Accessing Polisy==
ISY Launcher is the best method to find and access all of Polisy's features
* Install [[Main_Page#Installing_the_Admin_Console_Icon_on_Your_Desktop | ISY Launcher]]
* Click on the row of the discovered Polisy and you will see this menu
[[File:Launcher_Menu.png]]

'''Admin Console (LAN)'''
This menu item downloads the ISY Admin Console directly from Polisy

'''Admin Console (Cloud)'''
This menu item downloads the ISY Admin Console from the Universal Devices cloud servers

::Regardless of how you get to the ISY Admin Console (Cloud vs. LAN), the results are the same: Admin Console is brought up and connected directly to your Polisy. Admin Console allows you to add/remove/change Z-Wave/INSTEON devices, make programs, and make configuration changes. The best source for what you can do with the Admin Console is our [[Main_Page#ISY_Cookbook | ISY (994) Cookbook]].

'''Polyglot V2 (Deprecated)'''
This takes you to Polyglot V2 (PG2) Dashboard which allows you to add node servers (plugins for other devices) to your IoP. This site is deprecated in the favor or Polyglot V3.

'''Polyglot V3 (PG3)'''
This takes you to [[Polisy:User_Guide#Polisy_.28PG3.29_Dashboard | Polyglot V3 (PG3) Dashboard]].

==Default Username and Password==
'''admin | admin''' is the default username/password for everything in Polisy.


==Setup ISY Portal for Remote Access/Alexa/GoogleHome/IFTTT==
* Please go to [https://my.isy.io ISY Portal], register for a 30 day trial
* If you are migrating from 994, make sure you complete the [[Polisy:User_Guide#Migrating_from_994_to_Polisy | migration process]] from 994

Don't forget to check out all the things you can do with [[Main_Page#ISY_Portal:_Integration_with_Amazon_Echo.2FGoogle_Home.2FIFTTT | ISY Portal]].

==Helpful Tips From A Customer==
One of our valued customers created [https://www.universal-devices.com/docs/Polisy_Notes.pdf this very helpful document] filled with tips for getting Polisy up and running from a user's perspective.

='''Mobile App'''=
[[UD_Mobile | UD Mobile]] is everything you have ever dreamed of. It lets you control and monitor anything that's commissioned to your Polisy. And, it's FREE!<br />
UD Mobile is developed by Universal Devices. <br />
Forum support is available for [https://forum.universal-devices.com/forum/24-ud-mobile/ UD Mobile].

[[File:UDMobile_Featured.jpg]]


='''Device Support'''=

==Z-Wave Support==
'''Order ZMatter: 
[https://www.universal-devices.com/product/zmatter-z-wave-matter-module-for-polisy-beta/ Z-Wave Plus and Matter Module''']

# Ensure that '''ZMatter''' is installed properly. [https://www.universal-devices.com/docs/ZMatter-Assembly-%20Instructions.pdf Here are the instructions] 
# Go to the Admin Console | Configuration tab
# Check Z-Wave Support Checkbox
# Click the Save button
# Click on the Reboot button. Here's the [[Main_Page#Z-Wave_Plus.E2.84.A2_for_ISY-994_Series | User Guide for Z-Wave]].
[[File:Polisy_ZWave.png]]

==Node Servers==
Pick from anything in the [[Polisy:User_Guide#NodeServer_Store_Menu | Node Server Store]] and quench your thirst for integration!

 
==INSTEON Support==
# Connect the PLM to your Polisy
Polisy supports the following PLMs: 2412S and 2413S through the DB9 connector on the back. 2413U and [https://www.amazon.com/Insteon-2448A7-Portable-Adapter-White/dp/B0046V767Y 2448A7] through the USB port on the back. If you have a 2413S (serial), you will need a cable that [https://smartenit.com/shop/plm-serial-cable/ looks like this]
# Go to the Admin Console | Configuration tab
# Check INSTEON Support Checkbox
# Click the Save button
# Click on the Reboot button. Here's the [[ISY-99i/ISY-26_INSTEON:How-To_Guide | INSTEON User Guide]].
[[File:Polisy_INSTEON.png]]

==Migrating from 994 to Polisy==
'''Order ZMatter: 
[https://www.universal-devices.com/product/zmatter-z-wave-matter-module-for-polisy-beta/ Z-Wave Plus and Matter Module''']

'''Note''' Z-Wave nodes are '''not automatically''' migrated:
'''Note''' Z-Wave migration can only be done from 994/500 Series board or from Zooz ZStick
# Make sure the ISY994 is already upgraded to [https://forum.universal-devices.com/topic/33287-release-534-test-build-is-now-available 5.3.4], 
# The Polisy OS should be at level 13.1 or greater, if you are moving the SERIAL PLM from the ISY994 to the Polisy, locate the RS-232 cable that came with the SERIAL PLM, for USB PLM’s make sure the cable is long enough.  Just in case - Note the IP address of the ISY994 and the Polisy. 
# Backup your 994's Z-Wave dongle (Admin Console | Z-Wave | Utilities | Backup | Full)
# Backup your 994 (Admin Console | File| Backup ISY). Note where you placed the backup of the ISY994 it will be needed in step 7.
# Plugin the PLM to your Polisy 
## Polisy supports the following PLMs: 2412S and 2413S through the [https://smartenit.com/shop/plm-serial-cable/ DB9 connector] on the back. 2413U and 2448A7 through the USB port on the back.
# Connect to the ISY on Polisy (IoP) Admin Console.   Sign on using the default user/password of admin/admin
# Restore the backup of the ISY994 on the Polisy (Admin Console | Help | Restore ISY) from the location saved in step 2
# Log back in to IoP and make sure [[Polisy:User_Guide#INSTEON_Support | INSTEON Support is enabled]] (default username/pwd = admin/admin)
## If this is a new PLM, [[ISY-99i/ISY-26_INSTEON:File_Menu#Restore_Modem_.28PLM.29 | Restore the PLM]]
# If you have Z-Wave
## Make sure [[Polisy:User_Guide#Z-Wave_Support | Z-Wave Support is enabled]]
# Reconfigure any software utilizing the ISY994 to point to the IoP (From Step 4), restart the other software, if necessary.
# If you have ISY Portal on your 994, follow [[ISY_Portal_Migrate_configurations_to_a_new_ISY | '''these instructions''']] to migrate your account, license, and Alexa/Google Home settings
# If you have Network Resources, '''please make sure''' you open and save each and every one individually
# Make a backup of your newly configured IoP.

='''Polisy (PG3) Dashboard'''=

You will be prompted with a security warning by your browser because polisy uses a self-signed certificate. Please ignore the warning.

[[File:Notsecure.png]]

You are then presented with the login screen. The default username is '''admin''' and default password is '''admin'''. Please make sure you change your default username/password once you login.

[[File:Login dialog.png]]


Once you have successfully logged into Polisy, you will get the Polisy Dashboard which is designed to be simple and functional.

==ISYs==

You can add/remove ISYs or IoPs through this menu. The '''first''' thing you need to do is to add the local IoP to the list of ISYs.
# Click on the '''Add New ISY''' menu
# Fill out the entries as shown in the picture below
# Make sure you use HTTP and not HTTPS
[[File:Add_ISY.png]]

==NodeServer Store Menu==

This is where all the available node servers are listed. In order to install one of these node servers into ISY/IoP:
# Click on the name of the Node Server you wish to purchase/install
# Additional information about the Node Server will be displayed, including the purchase/install options available.

[[File:ns_purchase_options.png]]

There are 4 possible purchase options that may be available:
# Trial. Activating a trial license will make the Node Available for the trial period. When selected, the Activate button should change to an Install button.
# Free. Free Node Servers will simply show an Install button and are available to be immediately installed.
# Purchase.  Clicking the Purchase button will re-direct you to the Portal purchasing system where you can purchase an license for the Node Server (see steps below).
# Subscription. Click the Purchase button for a subscription will re-direct you to the Portal purchasing system where you can purchase a license for a specific time period.

[[File:ns_purchase_info.png]]

The Purchase Info displays basic info about the node server and which ISY/IoP is currently being manages.  Once you've confirmed this is what you wanted, click the Purchase button to re-direct to the Portal purchasing system.  You may be asked to log-in to the Portal to complete the following steps.

[[File:ns_purchase.png]]

The Portal purchasing system will give you the option to select the type of license you wish to purchase.  Use the drop down box to select the license and then click the button to continue with the payment options.

Once a node server license has been purchased, you will be re-directed back to PG3.  Navigate back to the node server store and again select the node server you just purchased. The node server details page will now show an Install button instead of a Purchase button.  Clicking the Install button will display the node server installation screen.

[[File:ns_install_details.png]]

If this is the first time installing this node server, you must select an empty slot before installing.  If you have previously installed this node server, you will be given the option to re-install it into the slot where it is currently installed.

Once installed, it should show up in the PG3 Dashboard.

==Purchases==
This is where all your node server purchases show up. These node servers are tied to your Polisy.

='''Multi Function Button'''=
[[File:Multifunction.png|right]] 

There's a little multi function button behind the very small hole on the front of the unit. 
This button has multiple purposes outlined below. Every click on the button will cause the unit to beep.

If the button does not behave as described below, please [[Polisy:User_Guide#Update_Polisy | update Polisy]].

==Update and Upgrade All the Packages==
Click the button '''once'''. '''Please consult [https://www.universal-devices.com/my-tickets/ support] before updating this route. See link below for suggested update/upgrade process.'''

Please see [https://forum.universal-devices.com/topic/37257-polisy-update-process-use-admin-console-upgrade-packages-button/ this important update (July 2022)]

==Safely Reboot==
Click the button '''twice'''.

==Safely Shutdown==
Click the button '''three times'''.

==Reset Credentials==
Press and hold the button till the '''first''' LED (from the left) starts blinking then release. 
This action resets the following passwords to the default ('''admin/admin'''): <br>
*SSH 
*Polyglot v2
*ISY on Polisy (IoP)<br>
Be sure to change the passwords for these sections after you log-in again.

==Reset Networking==
Press and hold the button till the '''first and second''' LEDs (from the left) start blinking then release. This action resets all network configuration back to DHCP on the Ethernet jack next to the serial port. All other network interfaces shall be disabled.

==Factory Reset==
Press and hold the button till '''all''' LEDs start blinking then release. This action resets the credentials, removes all configurations from Polyglot/Polisy, and resets networking.

='''Troubleshooting'''=
==First and Foremost==
* Make sure you have connected the network cable to the '''right''' jack on the back of the unit (the right most when Polisy is facing you)
* Make sure your router is initially DHCP enabled

==Can't Find Polisy==
First and foremost, all VPN software block discovery of Polisy on your network. As such, if you have a VPN software running, please turn it off.

If you have a modern router, Polisy advertises itself as '''polisy''' on your network. As such, and in most cases, you should be able to find Polisy at <nowiki>https://polisy:8443/desc</nowiki>. What you need to do is:
# In ISY Launcher, click on the '''Add''' button
# Enter '''<nowiki>https://polisy:8443/desc</nowiki>''' into the dialog
# Click on the '''OK''' button

[[File:Add_Polisy.png]]

If you are still having a hard time finding your Polisy, it's best to check your router's DHCP client list and look for a device that has the same MAC address as the one the label at the bottom of your Polisy. Polisy's MAC address starts with '''00:0d:b9'''. 

[[File:Dhclientlist.png]]

Once you find the IP address for Polisy, in this '''example''', 192.168.1.122, then 
# In ISY Launcher, click on the '''Add''' button
# Enter '''<nowiki>https://192.168.1.122:8443/desc</nowiki>''' into the dialog. '''Note''' 192.168.1.122 is an example. You should use the IP address for your Polisy
# Click on the '''OK''' button

==The Second or Third Light Is Blinking==
* Signature failure
* Old BIOS
Please [https://www.universal-devices.com/my-tickets contact support].

==The Third Light Is Constantly On While Everything Else Is Off==
* This means that that flash chip is corrupted
* Request a Flash Chip from support@universal-devices.com
* Once received, unplug Polisy, open the screws on the four corners, and install it as shown in the image below
* Plug Polisy back in
* '''Immediately''' after the unit is up and while still plugged in, '''unplug the Flash Chip''', then SSH to polisy and run the following commands:
** sudo pkg update && sudo pkg upgrade and wait for completion
** sudo /usr/local/etc/udx.d/static/udxops.sh update.bios.force 
** Wait for the unit to reboot

[[File:Flash.jpg]]

==Polisy OS Versions Below 13==
If the above process does not work, you will need an ssh utility (such as Putty) to connect to Polisy over the network:<br />
ssh admin@polisy-ip (you should change polisy-ip to the IP address of your unit). Default password is '''admin'''. Once this process is done, please change it<br />
Run the following commands:
* sudo uname -a<br />
If the OS is below 13, you have a few choices:
* '''If your Polisy is more than 2 years old'''
# You can purchase a brand new and updated SSD from [https://www.universal-devices.com/product/polisy-ssd-mpcie/ here]
# If you are a geek, you can reflash your SSD yourself. Please [https://www.universal-devices.com/my-tickets submit a ticket]
* '''If your Polisy is more than 1 and less than 2 years old'''
# Please ship to <br/>
Universal Devices<br/>
c/o Reflash <br/>
5435 Balboa Blvd. <br/>
Suite 205 <br/>
Encino, CA 91316 <br/>
Please make sure you include your return mailing address.
* '''If your Polisy is less than 1 year old''', please [https://www.universal-devices.com/my-tickets submit a ticket] and request for RMA


*Steps to change ssh password:<br />
:[[File:Polisy_SSH_ChangePass.jpg]]<br />

==Upgrade Process - As of July 2022==
Please see [https://forum.universal-devices.com/topic/37257-polisy-update-process-use-admin-console-upgrade-packages-button/ this important update (July 2022)]

Unless explicitly requested by Universal Devices, '''the SSH method of updating the Polisy should be avoided'''. Due to recent updates to the underlying operating system, unexpected consequences are being experienced when users force a full package upgrade and update using SSH.

To update/upgrade your Polisy, please only use the Admin Console to the ISY on Polisy (IoP).

Current suggested method for updating:

ISY Launcher to open the ISY Finder window.

Once logged in navigate to:
* Configuration tab
* System

Then click: “Upgrade Packages”

This updating/upgrading process through Admin Console has been developed to handle downloading the proper packages from Universal Devices servers to update UD specific libraries and dependencies needed to keep the Polisy operating efficiently and as designed. 



=Cool Integrations=
This section shares interesting and useful applications of the Polisy controller submitted by our users so that others can benefit from the work already done.  If you have an integration that you think other users would enjoy, please feel free to share it with us and we will work with you to add it to this section.

==Conserving Irrigation Water==
For a description of how to use Polisy to automatically adjust your landscaping watering times based upon the current weather conditions in your area, please click on the link below.  This can allow you to save up to 75% on your water bill and still provide your plants with all the water they actually need.

     [https://www.alphaengineeringlabs.com/gallery/Conserving%20Irrigation%20Water.pdf Conserving Irrigation Water]

==Collecting and Graphing Data==
For a description of how to use Polisy to collect data points about your house (ex: A/C run time every hour, #of minutes doors are left open, etc.) and produce a graph of data over time using Excel, please click on the link below.

     [https://www.alphaengineeringlabs.com/gallery/Polisy%20Data%20Collection.pdf Collecting and Graphing Data]


==Bridging Older Serial Based Systems to Polisy==
For a description of how to use Polisy to use sensor data from an older serial-based system (an older alarm system, etc.), please click on the link below.  For example, this would allow both your old alarm system and the Polisy to use the same door and window sensors that are already present on your alarm system - even though they are not Z-Wave.

     [https://www.alphaengineeringlabs.com/gallery/760015xx%20Alarm%20to%20Z-Wave%20Notes.pdf Bridging Older Serial Based Systems to Polisy]

==Optimizing A/C Power Usage==
For a description of how to use Polisy to automatically adjust your A/C cooling level based upon current weather conditions and time of day to reduce your power bill and extend the life of your A/C unit, please click on the link below.

     [https://www.alphaengineeringlabs.com/gallery/Optimizing%20AC%20Power%20Usage.pdf Optimizing A/C Power Usage]

==Making a Z-Wave Push Button==
It is surprisingly difficult to find a simple Z-Wave push button device to allow the user to trigger a set of actions when a button is pressed.  Here is a quick guide on how to make your own push button.

     [https://www.alphaengineeringlabs.com/gallery/Z-Wave%20Button.pdf Making a Z-Wave push button]