CRESTRON-APP-ANDROID Control App for Android™

1 Introduction

The CRESTRON-APP-ANDROID app from Crestron® provides a Smart Graphics™ touch screen user interface on Android™ devices. It is fully integrated with Crestron programming software including Crestron Studio™, VT Pro-e®, and SIMPL Windows. This Crestron app is available for download from the Google Play™ store.

NOTE: This Crestron app is available for free from Google Play. This free app provides a limited number of pages. Upgrade to the Pro version via an in-app purchase for unlimited pages and the ability to insert streaming video objects on a screen.

NOTE: Crestron recommends that an authorized Crestron installer downloads the app and configures the device for the customer according to the instructions in this guide. If it is not practical that the download and configuration be performed for the customer, the installer should complete the form at www.crestron.com/crestronmobilesetup. Instructions are e-mailed to the customer to provide assistance with the installation and startup of the app from the customer's device.

2 Download the App

This section provides instructions for downloading the app from the Google Play store, which is available on an Android device. Alternatively, the application can be downloaded from the Google Play website (play.google.com) on a computer.

Prerequisites

Cellular data network (cellular-equipped devices only) or Wi-Fi network that is connected to the Internet.
Google Play account (refer to support.google.com/googleplay for details on setting up a Google Play account).

Download the App from Google Play

Tap the ▶️ Play Store icon.
Search for the app:
1. Tap the ? magnifying glass.
2. Tap the search field and enter the search term "Crestron".
3. Tap the ? magnifying glass. The app is listed.
Tap the desired app and follow the prompts to download it. The app downloads to the device. The app icon ▶️ appears on the home screen when the download is complete.

3 Upgrade the App

The free version of the app has limits on the size and complexity of the project. For complete functionality, upgrade to the Pro version via an in-app purchase.

NOTE: A Google Play account is required to upgrade to the Pro version.

To upgrade to the Pro version, perform the following:

On the device, tap ▶️ to start the app. A list of systems is displayed.
Tap ⚙️. The Settings screen is displayed.
Tap "Upgrade to Pro" and follow the instructions.

4 Upload the Crestron Studio/SIMPL Windows Program

Upload the Crestron Studio or SIMPL Windows program to the control system(s).

Locate the appropriate sample Crestron Studio or SIMPL Windows program for the device at www.crestron.com/exampleprograms, and download it to the computer.
Modify the program as required (refer to the Crestron Studio or SIMPL Windows online help for information).
Use Crestron Toolbox™ to upload the program:
1. From the Tools menu, select "System Info".
2. In the Address Book's drop-down list, select the control system to which the program is to be loaded.
3. Click the [Quick Function Button] button (7), and select "SIMPL Program".
4. Browse for the program, select the program, and click "Open".
5. Click "Send". The Confirmation window opens, asking to overwrite the default IP table of the control system with the default IP table of the SIMPL Windows program.
6. Click "Yes".
7. In the SIMPL Program window, click "Close".

NOTE: Do not close Crestron Toolbox. It is required in section 5.

5 Upload the VT Pro-e Project

Locate the sample VT Pro-e project for the device at www.crestron.com/exampleprograms, and download it to the computer.
Modify or create a project and compile the project.
NOTE: Select the following when creating the project in VT Pro-e:
- For Panel Type, select "Crestron App".
- For Device, select the target device that is to run the app.
- For Orientation, select the orientation of the completed project.
- For Version, select the version of the app that is installed on the device.
Use Crestron Toolbox to load the project to the control system or the device:
- Load the project to the control system.
  1. Establish communication with the control system as described in the control system's operations guide.
  2. From the Functions menu of the System Info tool, select "Web Pages and Mobility Projects". The "Web Pages and Mobility Projects" window is displayed.
  3. Verify that "Enable Web Server" is selected.
  4. Browse for the project folder, select the folder, and click "OK".
  5. In the "Web Pages and Mobility Projects" window, click "Send", and click "OK".
- Load the project to the device (Wi-Fi only).
  1. On the device, tap ▶️ to start the app. A list of systems is displayed. Tap ⚙️ to view the device's Wi-Fi IP address.
  2. In Crestron Toolbox, use the System Info tool to establish communication with the Wi-Fi IP address from step a.
  3. Select "Functions" | "Project" to display the "Project" window.
  4. Browse for the project file, select the project, and click "OK".
  5. In the "Project" window, click "Send" and click "Close".

NOTE: When used with the free app, the VT Pro-e project is limited to two pages. Upgrading to the Pro version removes this limit and allows the use of embedded streaming video objects.

NOTE: Do not close Crestron Toolbox. It is required in section 6.

6 Configure a Connection to the Control System(s)

NOTE: To use the app with a cellular data connection, a DNS host name must be obtained from the customer's ISP or a service such as mycrestron.com. For information on setting up a host name, refer to Answer ID 4863 in the Online Help section of the Crestron website (support.crestron.com).

Use Crestron Toolbox to configure the Ethernet addressing parameters of the control system:
1. From the Functions menu of the System Info tool, select "Ethernet Addressing". The "Ethernet Addressing" window is displayed.
2. Enter a static IP address and related network information.
3. Note the values in the HTTP Port and CIP Port fields. They are needed in the following steps.
4. Click "OK".
If a cellular data connection is to be used, configure the router using the router's configuration utility.
1. Open and map a TCP control port to the control system using the following values:
  - For the External Port, use the CIP Port value of the control system listed in step 1c, or another port value.
  - For the Internal Port, use the CIP Port value of the control system listed in step 1c.
2. Open and map an HTTP port to the control system using the HTTP Port field listed in step 1c.
  - The External Port should be a port value other than 80, which most ISPs block. Port number 8081 is the suggested value.
  - The Internal Port should be the CIP Port value listed in step 1c.

NOTE: The router configuration screen shown above is a sample screen only. The screen that appears for a particular router may differ from the sample screen shown.

If using a Wi-Fi connection, verify that the device can connect to the wireless access point in the home. To do so, browse web pages on the Internet using the web browser while connected to the home network. If web pages can be viewed, proceed to step 3. Otherwise, refer to the router documentation for configuration information.

Configure the app:
NOTE: The form at www.crestron.com/crestronmobilesetup should be completed by an authorized Crestron installer if the customer is to configure the device. Upon completion, the instructions in this guide are e-mailed to the customer to provide assistance with the installation and startup of the app from the device.
1. On the home screen, tap ▶️ to start the app. A list of systems is displayed. When configuring the device for the first time, the screen appears empty.
  NOTE: Tap "Demo" to run a demo project.
2. Tap + to configure a system. The "Add Location" screen is displayed.
  NOTE: A system configuration can be imported from a system on another device. For details, refer to section 6.
3. In the "Address 1 (Typically Local LAN)" section, enter the configuration information for a Wi-Fi connection.
  - Tap the "Friendly Name / Location" field and enter the name or location of the control system to be connected. The field is for user reference only and is not a host name.
  - If the device is to host the project, tap "Use Local Project" until "ON" is displayed. If using the control system to host the project, tap "Use Local Project" until "OFF" is displayed.
  - Tap the "Host Name or IP Address" field, and enter the host name or IP address of the control system.
    NOTE: If using DHCP, use a host name rather than an IP address as a DHCP server may change the IP address periodically. If using a DNS server, a fully qualified host name may be required. For example: "controlsystem.yourdomain.com" instead of "controlsystem".
  - Tap the "HTTP Port" field and enter the HTTP Port value used in step 1c. Otherwise, the app assigns the default value 80.
  - Tap the "IP ID" field and enter an IP ID to identify the device to the control system. The IP ID must match the IP ID specified in the control system program.
  - Tap the "CIP" field and enter the CIP Port value used in step 1c. Otherwise, the app assigns the default value 41794.
4. If using a cellular data connection, it must be configured in the "Address 2 (Typically Internet/Mobile)" section of the setup screen.
  1. Enter the connection parameters entered in step 3c.
  2. Tap the "Enabled" field to display "ON".
5. If using a password or Secure Sockets Layer (SSL) encryption between the device and the control system, perform the following procedure.
  1. Tap the "Enable SSL" field to display "ON".
  2. If authentication is set on the control system side, enter a user name and password in the "User Name" and "Password" fields.
  3. Enable SSL on the control system. For details, refer to the control system's operations guide.
    NOTE: If using SSL, the HTTP Port and CIP values automatically change to 443 and 41796, respectively.
6. Tap "Save". The setup screen is displayed, listing the control system that has been added.

For instructions on connecting to the control system or previewing the system, refer to section 7.

7 Select a System for Use

Once a system is saved, it can be selected for operation by the app. If the system's project file is stored on the device (Use Local Project is set to ON), the system can be previewed on the device.

NOTE: The following assumes that either a) a system has only been configured on the device (not connected) or b) the Auto Reconnect function (described in section 11) has not been enabled.

Select a System

On the home screen, tap ▶️. A list of systems is displayed.
Tap the configuration to be used. When the device connects to the control system, it is ready for use as a Crestron touch screen.

NOTE: When multiple control systems are configured, the systems are displayed in a list. When the app is restarted, it automatically connects to the last connected control system (default setting). To allow the customer to select a system from the list of systems when the app is restarted, refer to section 11.

Preview a System

If the system's project files are stored on the device (Use Local Project is set to ON), the system can be previewed for troubleshooting.

NOTE: This feature foregoes a connection to the control system and simply displays the project that is loaded. There is no control system functionality when previewing a system.

Preview a system on the device:

On the home screen, tap ▶️. A list of systems is displayed.
Tap ⚙️ to enable system editing.
Tap the system to be edited. The system's configuration screen is displayed.
Scroll to the bottom of the configuration screen.
Tap "Preview" to preview the system.
Tap the device's back button [Back Button] to exit the preview.

8 Edit a System

A configured system can be deleted or edited.

Delete a System

On the home screen, tap ▶️. A list of systems is displayed.
Tap ⚙️ to enable system editing.
Tap the delete icon - next to the system that is to be deleted.
Tap "Delete" to confirm deletion or "Cancel" to cancel.

Edit a System

On the home screen, tap ▶️. A list of systems is displayed.
Tap ⚙️ to enable system editing.
Tap the system to be edited. The system's configuration screen is displayed.
Make any desired changes.
Tap "Save" to save the changes or "Back" to cancel.

9 Voice over IP (VoIP) Setup (Optional)

The device can be used as an intercom within a Crestron system (peer network) or as a VoIP phone that is part of a VoIP network. Perform the following to configure the device for use as a Rava® intercom device or VoIP phone:

NOTE: The following assumes that either a) a system has only been configured on the device (not connected) or b) the Auto Reconnect function (described in section 11) has not been enabled.

Configuration

On the home screen, tap ▶️. A list of systems is displayed. When configuring the device for the first time, the screen appears empty.
Tap ⚙️ to display the Settings screen.
Tap "VOIP". The "SIP Settings" screen is displayed.

Configure the device for intercom use.

In the "SIP Ext" field, enter a SIP extension (10 digits max). Each device must have a unique SIP extension.
In the "Local Port" field, enter a local port number to be used within the peer network.
NOTE: Port 4060 is the default port assignment. If another port is to be used, avoid using ports 4050 and 5060 as they are reserved for other functions.
In the "Display Name" field, enter the name that is displayed on other devices in the peer network when making calls.
In the "Paging Groups" field, enter the names of the paging groups to which the device is to be assigned. If a device belongs to multiple groups, the group names should be separated by commas.
Tap "Save" to save the configuration or "Save & Test" to save the configuration and display the test screen. For details, refer to "Test the Configuration" in the following column.

Configure the device for VoIP use via a SIP server.

In the "SIP Ext" field, enter an SIP extension (10 digits max). Each device must have a unique SIP extension.
In the "Local Port" field, enter the local port number to be used within the SIP network.
NOTE: Port 5060 is the default port used by most SIP servers. Check with the VoIP network administrator for port availability.
In the "Display Name" field, enter the name that is displayed on other devices when calling.
In the "SIP Server Name or IP" field, enter the host name or IP address of the SIP server.
NOTE: If left blank, the device acts as an intercom device.
Enter the port number used by the SIP server to communicate with VoIP devices in the "Server Port" field. The default port number is 5060, which is used by most SIP servers.
Enter the user name and password in the "SIP Server User Name" and "Password" fields.
Tap "Save" to save the configuration or "Save & Test" to save the configuration and display the test screen. For details, refer to "Test the Configuration" below.

Test the Configuration

Tap "Save & Test" to display the "SIP Test" screen. The "SIPMyaddress" field shows the device's SIP address. The bottom line shows the address of the inbound or outbound call.
In the "SIP address" field, enter the extension (intercom) or the full SIP address of the extension to be called (VoIP).
To make a call, tap "Dial" to call the extension or SIP address specified in the SIP address field. The "Active" indicator lights to show that a call is in progress.
To receive a call, tap "Answer".
To end a call, tap "Hangup".
Tap "Back" [Back Button] to return to the previous screen.

To test the intercom paging function, tap "Page All". Crestron devices on the intercom network's subnet indicate a page from the device.

During testing, the following indicators show the device's status:

Dialing indicates that the device is dialing the extension or address specified in the SIP address field.
Incoming indicates that the device is receiving a call.
Active indicates that a call is in progress.
Connected indicates that the device is connected to a SIP server.

10 Export and Import System Configurations

Export System Configurations

Once a device has been configured for use, the configured systems can be exported to other devices that use the app.

NOTE: Configured systems can be exported for use on Android devices running the CRESTRON-APP-ANDROID app and iOS® devices running the CRESTRON-APP or CRESTRON-APP-PAD apps.

Perform the following to export system configurations.

Tap ⚙️ to display the Settings screen.
Tap "Export Settings". An e-mail message opens with the settings attached in a CAS file.
Address the e-mail to the target device.
Send the e-mail message.

Import System Configurations

System configuration files are received via e-mail as an attached CAS file. To import a system configuration, open the e-mail, and then open the attachment. The system configurations are automatically imported into the app.

11 App Controls

Controls for the app are used to configure its operation.

The "Lock Configuration" setting prevents the user from changing the settings made in section 6.
The "Auto Reconnect" setting allows the app to automatically connect to the last control system that was connected. The default setting (enabled) is recommended when only one control system is configured. When multiple control systems are configured, Auto Reconnect should be disabled. When Auto Reconnect is disabled, the user can select the control system to be reconnected.
The "Check for Updates" setting allows the app to check for an updated VT Pro-e project on the control system upon startup. If an updated project is found, the project is automatically loaded to the device. If the function is disabled, the app uses the last project that was loaded.
NOTE: While developing and testing projects, the "Check for Update" function should be enabled (set to ON) so project changes can be viewed after a new project has been uploaded.
The "Use Full Screen" setting removes the device's status bar so the app can use the entire screen.
The "Keep Screen Awake" setting prevents the display from turning off. This setting should be enabled on devices that are connected to a power source.
The "Hide Demo Project" setting is used to hide or display the demo system in the system list.
The "Lock Orientation" setting specifies how the app is displayed (portrait, landscape, inverted portrait, inverted landscape, or no lock) when the device is rotated.
The "Log Level" setting enables, disables, and specifies the level of detail (fatal, error, warn, info, or verbose) recorded in the event log that is used for troubleshooting.
The "Console Settings" section specifies the CTP and HTTP ports that are used by VT Pro-e or Crestron Toolbox to upload projects for system configurations that use a local file.

Configure the app's operation:

While using the app, tap the device's menu button [Device Menu Button]. Controls for the app are displayed.
Adjust settings as required.
Tap the device's back button [Back Button] to return to the previous screen.

12 App Settings

The app's Settings screen is used to configure VoIP, export system configurations and eventlogs, upgrade the app, and view information about the device, local project, and software. Tap ⚙️ to display the Settings screen.

Tap "VOIP" to configure the device for use as a VoIP device or Rava intercom device. For details, refer to section 9.
Tap "Export Settings" to e-mail all of the system configurations that are stored on the device.
Tap "Export Logs" to e-mail the event log.
Tap "Upgrade to Pro" to upgrade the app to the professional version. For details, refer to section 3.

The Settings screen also contains information about the screen size, the device's IP address, the local project file (if present), and the software version.

	Crestron Fusion Programming Guide: Smart Building Integration & Enterprise Management Comprehensive programming guide for Crestron Fusion Software, detailing Smart Building Integration and Enterprise Management. Covers modules, symbols, and programming logic for advanced building control systems by Crestron Electronics, Inc.
	Crestron QM-RMC: Control System and Ethernet-to-Serial Interface Discover the Crestron QM-RMC, a versatile 2-Series control system and Ethernet-to-Serial Interface designed for efficient AV management in educational and corporate environments. Learn about its connectivity, programming capabilities, and network integration features.
	Prodigy System User Guide Comprehensive user guide for the Crestron Prodigy system, detailing controls for home theater, lighting, and climate. Covers operation of various touchpanels, keypads, tuners, amplifiers, and dimmers/switches.
	Crestron CP4 4-Series Control System: Features and Specifications Detailed overview of the Crestron CP4 4-Series Control System, highlighting its features, connectivity, specifications, and integration capabilities for modern automated environments.
	Crestron .AV Framework™ Software for MPC3 Operations Guide This guide provides comprehensive instructions for setting up and configuring Crestron's .AV Framework™ software on MPC3 devices. It covers essential functions like selecting sources and displays, configuring device control, adding touch screens and button panels, and integrating with Crestron Fusion® software. The document details the setup process, accessing the configuration utility, and managing A/V switchers, along with product features and compatibility information.
	Crestron TSW-770 7 in. Wall Mount Touch Screen The Crestron TSW-770 is a versatile 7-inch wall-mount touch screen control panel for homes, boardrooms, and classrooms. It offers an intuitive, customizable interface with advanced features like native app support for Crestron Home, Sonos, and Zoom Rooms, built-in voice recognition, and robust connectivity including PoE and Wi-Fi.
	Crestron Control with Amazon Alexa for Business: Getting Started Guide Learn how to integrate Crestron control systems with Amazon Alexa for Business to enhance conference room automation, voice control, and meeting management. This guide covers setup, skills, and device configuration.
	Fusion EM® Version 10 Energy Management Software Programming Guide Explore the Fusion EM® Version 10 Programming Guide from Crestron. Learn about energy management software, module integration, automation, and system programming for optimal facility control.