DEVICE

Manage Profiles

Profiles provide the ability to define independent connection-based information for the device, which can easily and quickly be recalled. API commands support the manipulation of all aspects of each profile definition, essentially providing limitless combinations for profile configurations.

Selecting the Manage Profiles option will present 5 profile selection options, an option to define a Default profile, and an option to always use the last selected profile.

Profile 1, 2, 3, 4, or 5

Choosing a profile to edit will present the following options:

Host
 The Host field is used to enter the primary address of the controller for this profile connection. Supports: IP address and Fully Qualified Domain Name (FQDN), e.g., 'amx.touchpanelcontrol.com'.

Profile 1, 2, 3, 4, or 5

Choosing a profile to edit will present the following options:

Host
 The Host field is used to enter the primary address of the controller for this profile connection. Supports: IP address and Fully Qualified Domain Name (FQDN), e.g., 'amx.touchpanelcontrol.com'.

Use Mobile Data

The following options are available for establishing a connection to the controller:

• None - Device will only use the WiFi adapter to establish a connection
• With WiFi - Device will use the WiFi adapter to establish a connection if a connection is present. If no WiFi is available, Mobile Data will be used to establish a connection
• Without WiFi - Device will use only Mobile Data to establish a connection

NOTE: Mobile Data may not be supported by the device when an active WiFi connection is in use.

Profile Name

This option provides the ability to name a profile.

Naming a profile is only necessary if you would like TPControl to present the profile as an option within the built-in Connect using profile connection window. This is particularly useful when multiple connection profiles are configured. Some example names would be: Profile 1: Room A, Profile 2: Room B, etc.

UI Filename

Indicates the File Slot number and associated TP4/TP5 file name currently assigned to the profile. Changing the File Slot assigned to the profile is provided via the Connect using profile window (refer to Prompt for Profile) or using TPC API commands.

Set Default Profile

Choose from any 1 of the 5 available profiles to define the default.

The default profile determines which profile TPControl will use at startup. The default profile is used only when starting TPControl if it was not previously running in multi-tasking mode (Home screen). If TPControl is running in multi-tasking mode, the active profile will remain operational.

NOTE: The current active profile will not be affected when setting the default profile.

Use last selected profile

This setting defines whether the last selected profile or the default profile is used for reconnection when returning to TPControl.

• Disabled: the default profile will be used to reconnect
• Enabled: the last selected or previously active profile will be used to reconnect

Apply Profile

Choose from any of the 5 available profiles to activate the chosen profile.

NOTE: The profile will be applied once you exit Settings, relaunch TPControl, and, if applicable, answer 'OK' to the 'Settings were changed' dialog.

Prompt for Profile

When enabled, independent of whether an active profile connection exists or not, TPControl will present the Connect using profile window at application launch, or whenever returning from the device Home screen or multi-tasking mode. The following named or unnamed profiles will be shown:

• the current active profile
• the current default profile
• any named profile

NOTE: The Not Connected dialog will automatically present the Connect using profile window, independent of the Prompt for Profile setting.

Keep WiFi Active

When enabled, TPControl will continue to keep a connection live with the controller when the device goes to sleep or another application takes device focus, e.g. the device home screen.

NOTE: iOS 5 introduced an enforced a 2.5 minutes application timeout, which overrides the 'Keep WiFi Active' and 'Multitasking Timeout’ features. If the device is running iOS 5+, TPControl will be forced to disconnect after ~2.5 minutes when running in multi-tasking/background mode.

Multitasking Timeout

Assuming 'Keep WiFi Active' is enabled, when TPControl is no longer in application focus, this timeout determines if and when TPControl will disconnect ICSP communication with the controller, and in doing so, preserving battery life.

NOTE: If the device is running iOS 5+, TPControl will disconnect after ~2.5 minutes when running in multi-tasking/background mode.

Gestures

Enable Auto-Lock

When enabled, this will allow the Device to run the OS screen lock feature as set in "General Settings" on the device. If Enable Auto-Lock is set to "Off", the screen will stay active until the Power button is pressed.

NOTE: Battery life may be significantly reduced if this feature is not enabled.

Lock Rotation

Disable Multitouch

e.g. a release must be issued before the next press will be recognised.

Accessibility

Supports device Accessibility VoiceOver mode.

On your device, go to "Settings →  General →  Accessibility →  VoiceOver" and enable/disable the feature as required.

• left/right for sequential button selection
• up/down for per-character text readout within buttons, or increase/decrease the value of a level value when a bargraph/level is active.
  
  

Recommendation:

If your TP4/TP5 design includes popup pages, it is recommended that the popups are defined as "modal" to ensure that buttons from underlying pages/popups do not confuse navigation when gesture navigation is used.

NOTE: Buttons that are disabled or hidden are ignored.

Not Connected and Connect using profile dialogs are supported with full navigation. Modality for these dialogs is supported in iOS 5+

• Include buttons with no text
  • Disabled: gesture navigation left/right will ignore buttons that do not contain any text.
  • Enabled: gesture navigation left/right will include buttons that do not contain any text.
• Level Increment -  When a "bargraph/level" is selected within TPControl, the up and down gestures may be used to increment/decrement respectively the level value. The level of adjustment as a percentage can be changed using this option.

Dock / Undock notification

PROJECT

Inactivity Page Flip Time

Screen Resize

• None
  No resizing of the original TP4/TP5 project is applied and will be shown using the original aspect and resolution.
• Scale-to-fit (default on first install)
  The original TP4/TP5 file will be upsized or downsized, retaining the original aspect-ratio of the project, and may present black-filled areas beyond the project UI; left/right or top/bottom.
• Stretch-to-fit
  The original TP4/TP5 file will be upsized or downsized, stretching independently for the height and width of the project, i.e. the aspect ratio of the design may be affected as a result, but the project will fill the usable display area of the device.

SPEECH TO TEXT

Display Result

The result of Speech-to-Text analysis can be displayed via a brief notification on-screen. Options available are:

• Do Not Display: Results will not be displayed
• 1 result: 1 result will be displayed (default)
• 2 results: Up to 2 results will be displayed
• 3 results: Up to 3 results will be displayed

NOTE: Errors in processing will always solicit a notification independent of this setting.

Auto-hide pop-out

• Disabled: TPControl will hide the Speech-to-Text recording dialog only after a successful result is processed.
• Enabled: TPControl will hide the Speech-to-Text recording dialog once processing of recorded audio commences, irrespective of the result.

TEXT TO SPEECH

Use offline mode

Disabled - TPControl will utilise online resources to determine text-to-speech translation (default).

Enabled - TPControl will utilise device-defined language packs to determine text-to-speech translation.

NOTE: In order to operate properly while in offline mode, the device must have an appropriate language pack installed to complete the operation.

NOTE: Results are cached with each completed translation when operating in online mode

Clear cache

NOTIFICATION

Button Hit

Button Miss

Beep Volume Level

Intercom call notification

PASSWORDS

User passwords

SIP

SIP Settings

A general-purpose SIP softphone is integrated into TPControl and includes both video and audio SIP support. As such, TPControl will work with any VoIP operator or device that implements SIP. This includes, but is not limited to: door stations, IP phones, and Video conferencing systems.

At a minimum, the SIP Server, Username, and Password fields must be configured, based on your relevant SIP service.

Configure SIP-related settings within the subsequent TPControl Settings menus:

Advanced configuration settings are as follows:

• Display Name
  A "human" display name.
• SIP Proxy
  Sets the IP address for the Proxy Server. This field assumes the same value as the SIP Server unless otherwise specified. The function of a SIP Proxy server is to forward calls from a private network to the external network.
• Port
  The SIP port used (default is 5060).
• Connection Type
  Determines the transport method used based on:
  • UDP (default)
  • TCP
  • TLS - For TLS certificate installation, please refer to How to install TLS certificates for use with TPControl SIP devices.
• Outbound Proxy
  When enabled, the SIP Proxy will be used for all Outgoing calls. This is useful when needing to proxy your calls to an external network.
• Preferred Video Size
  The video size impacts the data bandwidth utilized during video calls. Lower quality options may better suit the network environment, and/or the encoding/decoding capability of the device. Options include:
  • HD
  • VGA (default)
  • QVGA
• Video Codecs
  All video codec options are enabled by default, with compatibility negotiation occurring during call initiation. If problems are experienced, enable only the option(s) known to be compatible with the endpoint. Options include:
  • H264
  • VP8
• Audio Codecs
  All audio codec options are enabled by default, with compatibility negotiation occurring during call initiation. If problems are experienced, enable only the option(s) known to be compatible with the endpoint. Options include:
  • Speex
  • Opus
  • Silk
  • AAC-ELD
  • G722
  • AMR
  • PCMU (U-Law)
  • PCMA (A-Law)
  • GSM
  • ILBC
• STUN Server
  STUN - Session Traversal Utilities for NAT. A protocol that assists devices with their packet routing when behind a NAT (Network Address Translation). Refer to RFC5389.
• Enable ICE
  ICE – Interactive Connectivity Establishment. A Protocol for Network Address Translator (NAT) Traversal for Offer/Answer Protocols. Refer to RFC5245.
• Enable Built-in SIP UI
  The built-in TPControl SIP UI is enabled by default for receipt and placement of SIP calls, as well as in-application SIP-related notifications and call status. Turning off this option relies on AMX integrator-defined GUI usage in conjunction with the AMX SIP API.
  NOTE: For SIP-related AMX API commands, refer to AMX PI.
• Enable Verbose Debug
  When enabled, simplified SIP Debug information will be parsed to the controller debug port. Future implementation changes may deprecate/replace the initial Debug functionality.

VERSION

Version

Token

TPC Device ID

Verify Device

This option provides the ability for the TPControl device to update its license information when changes have been applied at the Touch Panel Control servers. For example, trial-based licenses may be reset/refreshed by a TPC Team member, and then this option can be used to update the license for the device.

When enabled, the function is performed once you return to the main interface. The option is reset back to off after the changes have been applied, but can be re-enabled at any time to repeat the verification process.

If successful, a "Device successfully verified" message will be presented briefly within the main interface.

NOTE: Internet access is required from the device to complete the operation.

Token Registration

Select this option to register TPControl with an applicable TPC User ID and Token.

NOTE: Internet access is required from the device to complete the operation.

TPCloud update

Management of TP4 file resources and Settings is provided via an account login at TPCloud.

Within TPCloud, all TPControl "Tokens" have configurable TP4/TP5 files and Settings options:

• Select Tokens
• Select the Token, followed by the Settings and TP4 files tab
• Use the TPCloud update options: Enable/Disable buttons provided to specify resources available for update.

The information stored within TPCloud will be applied to the device when the TPCloud update option is enabled on the device, and TPControl is launched.

NOTE: Internet access is required from the device to complete the operation. Device registration will be automatically verified prior to any update being applied from TPCloud to the device.

TPCloud PIN

PIN codes can be generated specific to each Token that is stored within TPCloud at tpcloud.touchpanelcontrol.com.

PIN codes are used to complete device registrations and deauthorizations.

Select the TPCloud PIN option, then enter the unique PIN code as provided by TPCloud. Launch TPControl to initiate the TPCloud PIN process. Based on the TPCloud configuration, TPControl will validate the PIN code reference and act accordingly.

Supported PIN methods:

• Device registration:
  1. The PIN code will register the device with the Token assigned to the PIN code.
  2. The device will automatically perform a TPCloud update.

     i.e. the device will be issued the TP4/TP5 file (if enabled) and Settings (if enabled), as configured for the Token.

• Device deauthorization and registration:
  1. The PIN code, when entered into the currently registered device, will deauthorize the device, allowing the associated Token to be registered to a new device.

  2. Enter the same PIN code into the new device to complete registration.
     
     

NOTE: Internet access is required from the device to complete the operation. Device registration will be automatically verified prior to any update being applied from TPCloud to the device.

Developer Settings

• None
  Do nothing
• Clear User Pages
  When enabled, all design files will be removed, and the original Demo Pages will be loaded back onto the device.
• Reprocess UI file
  Clears any caching and reprocesses the installed TP4/TP5 file. This is the same process that runs whenever a file is transferred to the device.