Difference between revisions of "Polisy:User Guide"

From Universal Devices, Inc. Wiki
Jump to: navigation, search
(Requesting for ISY Portal Extension)
 
(93 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
Welcome to our Polisy corner: your one place for anything Polisy!  
 
Welcome to our Polisy corner: your one place for anything Polisy!  
  
='''First Steps'''=
+
='''Some Definitions!'''=
==Requirements==
+
==ISY on Polisy (IoP)==
* Make sure your ISY is on 5.0.16+
+
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.
* Make sure your network has DHCP enabled
+
* Make sure your ISY has either the ISY Portal or the Network Module (Polisy comes with two years of ISY Portal free of charge)
+
===Requesting for ISY Portal Extension===
+
* If you have never had ISY Portal installed on your ISY, please go to [https://my.isy.io ISY Portal], register for a 30 day trial, then send your UUID and a copy of your Polisy invoice to [mailto://sales@universal-devices.com&subject=Polisy%20ISY%20Portal%20Extension  sales@Universal-devices.com]
+
* If you already have ISY Portal installed, please send your UUID and a copy of your Polisy invoice to [mailto://sales@universal-devices.com&subject=Polisy%20ISY%20Portal%20Extension  sales@Universal-devices.com]
+
  
==Installation==
+
==Node Servers==
Installation is quite easy
+
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.  
* Connect one of the included Cat5e cable to Polisy’s Network Port and to your network hub. You must use the port that’s closest to the right most edge of Polisy when the front of Polisy is facing you. '''Note''': the network must initially be DHCP enabled
+
* If you have the PRO version, attach the included antennas to the back of the unit
+
* Connect the power supply
+
'''Note''': once Polisy is up and running, it will automatically look for your ISY on the network. As such, it's best to make sure your Polisy and your ISY are on the same network.
+
  
===First Ever Bootup Sequence===
+
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.
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 up to 2 minutes:
+
* All three lights on the front light up when powered on
+
* After a few seconds, only the left most stays lit for up to a minute
+
* All three lights start blinking and a beeping sequence starts
+
* The beeping stops within 25 seconds. If beeping does not stop, make sure the network cable is connected to the correct jack on Polisy and that your network is DHCP enabled
+
* Everything is operational once only the left most light is lit
+
  
===Normal Bootup Sequence===
+
But, where do these node servers live? Well, you have come this far, so read on ...
* All three lights on the front light up when powered on
+
* After a few seconds, only the left most stays lit for up to a minute
+
* All three lights start blinking and a beeping sequence starts which lasts about 5 seconds
+
* Everything is operational once only the left most light is lit
+
  
==Accessing Polisy==
+
==Polyglot==
If you have a modern router, Polisy advertises itself as '''polisy''' on your network. As such, and in most cases, simply open your browser to [https://polisy https://polisy].
+
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.
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]]
+
'''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.
  
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.
+
==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:Login button.png]]
+
[[File:All new polisy-ANT.jpg | 600px | center]]
  
 +
='''First Steps'''=
  
[[File:Login dialog.png]]
+
==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
  
And that's it! And, since we are always improving Polisy, the first thing you should do is to check for updates (it's always good to reboot after each update):
+
==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
  
[[File:Pcheckforupdate.png]]
+
==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]]
  
==Troubleshooting==
+
'''Admin Console (LAN)'''
===Can't Find Polisy===
+
This menu item downloads the ISY Admin Console directly from Polisy
If you are having a hard time finding your Polisy using https://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]]
+
'''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]].
  
===Polisy Keeps Beeping===
+
'''Polyglot V2 (Deprecated)'''
====Networking Issue====
+
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.
* 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 the unit has Internet connectivity since, in some cases, it must download the latest packages upon first installation
+
* Make sure your ISY is running firmware 5.0.16+ and is on the same network as Polisy
+
  
====Latest Packages Not Installed====
+
'''Polyglot V3 (PG3)'''
If the above does not work, you will need an ssh utility (such as putty) to connect to Polisy over the network:
+
This takes you to [[Polisy:User_Guide#Polisy_.28PG3.29_Dashboard | Polyglot V3 (PG3) Dashboard]].
1. ssh admin@polisy (you can change polisy to the IP address of your unit)
+
2. Default password is admin. Once this process is done, please change it
+
3. Run the following commands:
+
* sudo service polyglot stop
+
* sudo service udx stop
+
* sudo pkg update
+
* sudo pkg upgrade
+
* sudo service polyglot start
+
* sudo service udx start
+
  
====Corrupted Database====
+
==Default Username and Password==
* ssh admin@polisy (you can change polisy to the IP address of your unit)
+
'''admin | admin''' is the default username/password for everything in Polisy.
* Default password is admin. Once this process is done, please change it
+
* Run the following commands
+
sudo service mongod status. If it's not running, then:
+
* sudo rm -rf /var/db/mongodb
+
* sudo reboot
+
  
='''Some Definitions!'''=
 
==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 ISY 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 can be representing real devices in the world such as Ring, Tesla, WiFi light bulbs, Ecobee .. or they could be completely 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 device or thing out there.
+
==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
  
[[File::Nodes.png]]
+
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]].
  
But, where do these node servers live? Well, you have come this far, so read on ...
+
==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.
  
==Polyglot==
+
='''Mobile App'''=
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.
+
[[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].
  
And, of course, being geeks ourselves, we developed Polyglot to run on geeky things such as Raspberry Pi. If you are a geek and at home with ssh, ifconfig, pip, npm, and Linux system admin you will be right at home installing Polyglot on a Raspberry Pi and enjoying it.  
+
[[File:UDMobile_Featured.jpg]]
  
And, here comes the punchline for those who are not geeks:
 
  
==Polisy==
+
='''Device Support'''=
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]]
+
==Z-Wave Support==
 +
# Connect your [https://www.universal-devices.com/product/zooz-z-wave-700-series-usb-stick/ Zooz Z-Wave 700 Series Stick] to one of the USB ports in the back of Polisy
 +
# 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!
  
='''Polisy Dashboard'''=
+
 +
==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]]
  
Once you have successfully logged into Polisy, you will get the Polisy Dashboard which is designed to be simple and functional. If your ISY is on the same network, Polisy will try to find it and login to it using default username/password (1 in the picture below). If ISY is not found, don't despair! You can configure Polisy with [[#ISY Settings | ISY's connection parameters]].
+
==Migrating from 994 to Polisy==
 +
'''Note''' Z-Wave nodes are '''not automatically''' migrated:
 +
# Make sure 994 is already upgraded to [https://forum.universal-devices.com/topic/33287-release-534-test-build-is-now-available 5.3.4]
 +
# Backup your 994 (Admin Console | Help | Backup ISY)
 +
# If you have Z-Wave nodes, print '''Tools | Topology''' so that you can add your Z-Wave later in the same sequence
 +
# 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.
 +
# Restore the backup on Polisy (Admin Console | Help | Restore ISY)
 +
# Log back in and make sure [[Polisy:User_Guide#INSTEON_Support | INSTEON Support is enabled]]
 +
## 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 enabbled]]
 +
## Use the Topology (step 3) and '''Exclude''' then '''Include''' your Z-Wave devices in the same ascending order as the Z-Wave addresses in the topology. i.e., ZW_001, ZW_002, etc ...
 +
# 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
  
If this is the first time you have logged into Polisy, and if you have the ISY Portal module, you might see ISY Portal listed as a node server. You can ignore this node server since it's not managed by Polisy.
+
='''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:Pdashboard.png]]
+
[[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.
  
==NodeServers Menu==
+
[[File:Login dialog.png]]
[[File:Nsmenu.png|Right]]
+
  
===NodeServer Store===
 
This is where all the available node servers are listed. In order to install one of these node servers into ISY, first, click on the Install button to import the node server into Polisy. Once the node server is installed into Polisy, the next step is to install it into ISY using '''Add NodeServer''' menu option.
 
  
[[File:Nstore.png|500px|center]]
+
Once you have successfully logged into Polisy, you will get the Polisy Dashboard which is designed to be simple and functional.
  
===Add NodeServer===
+
==ISYs==
Use this menu option to install the NodeServer that you have imported into Polisy into ISY.
+
  
[[File:Adns.png|500px|center]]
+
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
 +
[[File:Add_ISY.png]]
  
==Settings Menu==
 
[[File:Psettings.png|Right]]
 
  
Setting menu allows you to configure Polyglot and System settings.
+
==NodeServer Store Menu==
  
===Polisy Configuration===
+
This is where all the available node servers are listed. In order to install one of these node servers into ISY:
 +
# Click on the Install button next to your desired Node Server
 +
# In the Add Node Server dialog, choose the desired ISY to which this node server points to and make sure you choose a slot to which it's installed
  
Allows you to configure system wide time zone and network settings:
+
[[File:Install_ns.png]]
  
[[File:Pnet.png|center|500px]]
+
==Purchases==
 +
This is where all your node server purchases show up. These node servers are tied to your Polisy.
  
To change the Time Zone, you must click on the '''Change''' button!
+
='''Multi Function Button'''=
 +
[[File:Multifunction.png|right]]
  
You can also configure your WiFi if you have Polisy PRO.
+
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.
  
[[File:Pwifi.png|center|500px]]
+
If the button does not behave as described below, please [[Polisy:User_Guide#Update_Polisy | update Polisy]].
  
===Polyglot Configuration===
+
==Update and Upgrade All the Packages==
 +
Click the button '''once'''.
  
If you are not a geek, the only options in this page that are of importance are:
+
==Safely Reboot==
 +
Click the button '''twice'''.
  
====Backup and Restore Polyglot====
+
==Safely Shutdown==
 +
Click the button '''three times'''.
  
Yes, you can! If you have been running Polyglot on Raspberry Pi or something else, you can simply back it up and then restore it onto Polisy using these two self explanatory buttons.
+
==Reset Credentials==
 +
Press and hold the button till the '''first''' LED (from the left) starts blinking then release. This action resets Polyglot as well as SSH credentials back to the default '''admin/admin'''.
  
[[File:Backuprestore.png|center]]
+
==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
  
====ISY Settings====
+
==Can't Find Polisy==
If Polisy has not been able to find and commission your ISY, update this section with ISY parameters such as IP, username, and password.
+
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.
  
[[File:isysettings.png|center]]
+
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
  
==System Menu==
+
[[File:Add_Polisy.png]]
Use this menu to keep your Polisy, Polyglot, and ISY in tiptop shape!
+
  
[[File:Psystem.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'''.  
  
===Restart Polyglot ===
+
[[File:Dhclientlist.png]]
Restarts the Polyglot instance running inside Polisy.  
+
  
===Reboot ISY===
+
Once you find the IP address for Polisy, in this '''example''', 192.168.1.122, then
Self explanatory.
+
# 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
  
===Check for Polisy Updates===
+
==The Second or Third Light Is Blinking==
Use this menu regularly to make sure your Polisy is up to date.
+
* Signature failure
 +
* Old BIOS
 +
Please [https://www.universal-devices.com/my-tickets contact support].
  
===Update Polisy===
+
==The Third Light Is Constantly On While Everything Else Is Off==
Use this menu if you want to update your Polisy with the latest and greatest as reported by the previous menu.
+
* 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
  
===Reboot Polisy===
+
[[File:Flash.jpg]]
Reboots the whole system.
+
  
===Shutdown Polisy===
+
==Polisy OS Versions Below 13==
Shutdown the whole system.
+
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, run the following commands
 +
* curl -s <nowiki>https://pkg.isy.io/script/update121.sh | sudo bash</nowiki>
 +
* sudo shutdown -r now
 +
Wait for the unit to reboot, ssh to Polisy and run these commands:
 +
* cat /usr/local/etc/udx.d/static/update13.sh | sudo bash
 +
* sudo shutdown -r now
 +
'''Note:''' All commands are case sensitive. Allow system to completely reboot before each step.<br />
  
=Resetting Polisy=
+
*Steps to change ssh password:<br />
Click the reset button through the small hole on the front
+
:[[File:Polisy_SSH_ChangePass.jpg]]<br />

Latest revision as of 17:01, 17 May 2022

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

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.

All new polisy-ANT.jpg

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 Troubleshooting section

Accessing Polisy

ISY Launcher is the best method to find and access all of Polisy's features

  • Install ISY Launcher
  • Click on the row of the discovered Polisy and you will see this menu

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

Don't forget to check out all the things you can do with ISY Portal.

Helpful Tips From A Customer

One of our valued customers created this very helpful document filled with tips for getting Polisy up and running from a user's perspective.

Mobile App

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!
UD Mobile is developed by Universal Devices.
Forum support is available for UD Mobile.

UDMobile Featured.jpg


Device Support

Z-Wave Support

  1. Connect your Zooz Z-Wave 700 Series Stick to one of the USB ports in the back of Polisy
  2. Go to the Admin Console | Configuration tab
  3. Check Z-Wave Support Checkbox
  4. Click the Save button
  5. Click on the Reboot button. Here's the User Guide for Z-Wave.

Polisy ZWave.png

Node Servers

Pick from anything in the Node Server Store and quench your thirst for integration!


INSTEON Support

  1. Connect the PLM to your Polisy

Polisy supports the following PLMs: 2412S and 2413S through the DB9 connector on the back. 2413U and 2448A7 through the USB port on the back. If you have a 2413S (serial), you will need a cable that looks like this

  1. Go to the Admin Console | Configuration tab
  2. Check INSTEON Support Checkbox
  3. Click the Save button
  4. Click on the Reboot button. Here's the INSTEON User Guide.

Polisy INSTEON.png

Migrating from 994 to Polisy

Note Z-Wave nodes are not automatically migrated:

  1. Make sure 994 is already upgraded to 5.3.4
  2. Backup your 994 (Admin Console | Help | Backup ISY)
  3. If you have Z-Wave nodes, print Tools | Topology so that you can add your Z-Wave later in the same sequence
  4. Plugin the PLM to your Polisy
    1. Polisy supports the following PLMs: 2412S and 2413S through the DB9 connector on the back. 2413U and 2448A7 through the USB port on the back.
  5. Restore the backup on Polisy (Admin Console | Help | Restore ISY)
  6. Log back in and make sure INSTEON Support is enabled
    1. If this is a new PLM, Restore the PLM
  7. If you have Z-Wave
    1. Make sure Z-Wave Support is enabbled
    2. Use the Topology (step 3) and Exclude then Include your Z-Wave devices in the same ascending order as the Z-Wave addresses in the topology. i.e., ZW_001, ZW_002, etc ...
  8. If you have ISY Portal on your 994, follow these instructions to migrate your account, license, and Alexa/Google Home settings
  9. If you have Network Resources, please make sure you open and save each and every one individually

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.

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.

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.

  1. Click on the Add New ISY menu
  2. Fill out the entries as shown in the picture below

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:

  1. Click on the Install button next to your desired Node Server
  2. In the Add Node Server dialog, choose the desired ISY to which this node server points to and make sure you choose a slot to which it's installed

Install ns.png

Purchases

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

Multi Function Button

Multifunction.png

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 update Polisy.

Update and Upgrade All the Packages

Click the button once.

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 Polyglot as well as SSH credentials back to the default admin/admin.

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 https://polisy:8443/desc. What you need to do is:

  1. In ISY Launcher, click on the Add button
  2. Enter https://polisy:8443/desc into the dialog
  3. Click on the OK button

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.

Dhclientlist.png

Once you find the IP address for Polisy, in this example, 192.168.1.122, then

  1. In ISY Launcher, click on the Add button
  2. Enter https://192.168.1.122:8443/desc into the dialog. Note 192.168.1.122 is an example. You should use the IP address for your Polisy
  3. Click on the OK button

The Second or Third Light Is Blinking

  • Signature failure
  • Old BIOS

Please 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

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:
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
Run the following commands:

  • sudo uname -a

If the OS is below 13, run the following commands

  • curl -s https://pkg.isy.io/script/update121.sh | sudo bash
  • sudo shutdown -r now

Wait for the unit to reboot, ssh to Polisy and run these commands:

  • cat /usr/local/etc/udx.d/static/update13.sh | sudo bash
  • sudo shutdown -r now

Note: All commands are case sensitive. Allow system to completely reboot before each step.

  • Steps to change ssh password:
Polisy SSH ChangePass.jpg