UD Mobile

From Universal Devices, Inc. Wiki
Revision as of 18:41, 18 August 2021 by JRefuerzo (talk | contribs) (Added Toggle indicator info)
Jump to navigation Jump to search

Installation

Download on the App Store Get it on Google Play

Notes

UD Mobile works with firmware 5.0.16 and greater. Firmware lower than 5.0.16 may work but are not officially supported. The latest 5.x firmware now requires a 500 series Z-Wave board. If upgrading from 4.x to 5.x be sure to select firmware which is compatible with your system. Some information contained on this page may be specific to iOS or Android.

Quick Start Guides

Existing Portal Users

Upon Installation the app will prompt to setup using ISY Portal. Select Yes.

The app will prompt for ISY Portal login. Select Yes. If app prompts for Portal credentials enter your credentials and save. App may also show a dialog with existing Portal accounts. If this is initial installation select Add New Portal Account.

App will then show a list of ISYs on your portal account or a list of ISY Portal accounts. If a list of Portal Accounts is presented select the Portal account which contains the desired ISY. Select the desired ISY.

Select SAVE at the top right. Then select YES when prompted to synchronize. Wait for synchronization to complete. After synchronization the app will be ready to use on remote connections.


Adding Another ISY (Existing Portal Users)

These instructions assume the ISY is already linked to ISY Portal.

Select Settings-Tab > Systems > Add (top right).

The app will prompt for ISY Portal login. Select Yes. If the ISY is using the same Portal Account as your previously linked ISY(s) select the existing Portal Account from the list. If the ISY is using a different Portal account select Add New Portal Account.

After Portal Account has been selected the app will show a list of available ISYs. Select the desired ISY to add to the app.

Select SAVE at the top right. Then select YES when prompted to synchronize. Wait for synchronization to complete. After synchronization the app will be ready to use on remote connections.

Remote Connections

Remote connection on UD Mobile can be achieved in 3 scenarios.

First is our managed method using ISY Portal. ISY Portal has competitive prices of $23 for the first 2 years and renewals cost of $20 for two years (prices current as of 06/2021). If your ISY has not been associated with the ISY Portal in the past we offer a 30 day free trial. ISY Portal Installation instructions can be found here https://wiki.universal-devices.com/index.php?title=ISY_Portal_Installation_Instructions

Second is an unmanaged direct connection. The unmanaged method requires a Trusted CA Signed SSL Certificate. The Trusted SSL CERT is required for reasons stated below in App Transport Security. Instructions on adding a CERT to your ISY can be found here: https://www.universal-devices.com/docs/production/ISY994%20Series%20Network%20Security%20Guide.pdf . There are methods to add a Self Signed CERT to the Trusted Key Store on Android, however it is beyond the scope of our support and may require root on some devices.

Finally a local connection can be established on a remote network if running a VPN Server on the same local network as the ISY. To use this method select "Only use Local Connection" in the local connection settings. Setting this option will instruct the App to ignore remote connection settings and only use the local network.

App Transport Security (ATS) iOS

App Transport Security (ATS) is disabled by iOS for local loads (1), for this reason Local Connections do not need a Trusted CERT, ATS requires a Trusted CERT for Remote Connections. While it is possible for the apps to disable ATS it would make all connections less secure and we would have to meet the exception requirements (2) during app review which we likely do not meet.

(1) https://developer.apple.com/documentation/bundleresources/information_property_list/nsapptransportsecurity/nsallowslocalnetworking " ATS doesn’t block local loads by default in newer versions of the OS"

(2) https://developer.apple.com/documentation/security/preventing_insecure_network_connections#3138036

"The app must connect to a server managed by another entity that doesn’t support secure connections." Portals provided by UDI and Third parties support secure connections, and UDI controls the firmware. So, this does not apply. Apple has also mentioned this will be removed in the future.

"The app must support connecting to devices that cannot be upgraded to use secure connections, and that must be accessed using public host names.". ISY firmware does support secure connections, so this exception does not apply.


Favorites

Add New Favorite

Add (All Platforms)

Go to the Favorites Tab. Select add ("+") at the top of the screen. Select "New Favorite Node".

iOS

Navigate to the desired node. Note this will be changed to match Android in the future.

Android

Select the line item "Display Node" (Select Node). Navigate to the desired node.

Node Navigation (All Platforms)

Note that a menu (three dots) icon next to a node indicates that the node has grouped children (grouped nodes), to see the children either select the node or select the menu icon. Selecting the node will show status values along with grouped children. Selecting the menu icon will only show grouped children (grouped nodes).

Display Status (All Platforms)

After a node has been selected the "Select Display Status" screen will prompt to select a status to show on the favorites screen (i.e. Status, On-Level, Ramp-Rate, ect.). If this node has children (grouped nodes) selecting the groped node will show "Select Display Status" for the child (grouped node).

Node Toggle Indicator

The Node toggle indicator will only show for Favorites which have (#1) "Status" selected as the Display Status, and (#2) the selected node must accept on/off commands. Also (#3) if the App has NOT received a status for the node from the ISY the toggle indicator will not be show until the node's status has been received. Node status is needed to determine if an on or off command should be sent to the node. If the App has NOT received a status for the node, clicking the Favorite item will open the Node's Dashboard which shows all status values and controls for the selected node.

Program Toggle Indicator

The Program toggle indicator will only show for Favorites which have (#1) "Status" selected as the Display Status. Also (#2) if the App has NOT received a status for the program from the ISY the toggle indicator will not be show until the program's status has been received. Program status is needed to determine if the Run or Stop command should be sent to the program. If the App has NOT received a status for the program, clicking the Favorite item will open the Program's (Node's) Dashboard which shows all status values and controls for the selected program. To receive program status values on App startup go to Settings-Tab > Systems > Your-System-Name > Advanced-Settings > Program-and-Variable-Settings then toggle Request-Status-of-all-Programs.

Android

Select Save

Delete Favorite

iOS

Go to the Favorites Tab. Select edit (pencil icon) at the top of the screen. Click the add ("+") icon next to the favorite item. Select delete (trash icon) on the top right. Note this will be changed to match Android in the future.

Android

Go to the Favorites Tab. Select edit (pencil icon) at the top of the screen. Click the Favorite item. Select "Delete".