This Limited Warranty and Disclaimer extends only to products purchased directly from AMX or an AMX Authorized Partner which
include AMX Dealers, Distributors, VIP’s or other AMX authorized entity.
AMX warrants its products to be free of defects in material and workmanship under normal use for three (3) years from the date of
purchase, with the following exceptions:
•Electroluminescent and LCD Control Panels are warranted for three (3) years, except for the display and touch overlay components are warranted for a period of one (1) year.
•Disk drive mechanisms, pan/tilt heads, power supplies, and MX Series products are warranted for a period of one (1) year.
•AMX lighting products are guaranteed to switch on and off any load that is properly connected to our lighting products, as long
as the AMX lighting products are under warranty. AMX also guarantees the control of dimmable loads that are properly con
nected to our lighting products. The dimming performance or quality there of is not guaranteed, impart due to the random combinations of dimmers, lamps and ballasts or transformers.
•AMX software is warranted for a period of ninety (90) days.
•Batteries and incandescent lamps are not covered under the warranty.
•AMX AutoPatch Epica, Modula, Modula Series4, Modula CatPro Series and 8Y-3000 product models will be free of defects in
materials and manufacture at the time of sale and will remain in good working order for a period of three (3) years following the
date of the original sales invoice from AMX. The three-year warranty period will be extended to the life of the product (Limited
Lifetime Warranty) if the warranty card is filled out by the dealer and/or end user and returned to AMX so that AMX receives it
within thirty (30) days of the installation of equipment but no later than six (6) months from original AMX sales invoice date. The
life of the product extends until five (5) years after AMX ceases manufacturing the product model. The Limited Lifetime Warranty
applies to products in their original installation only. If a product is moved to a different installation, the Limited Lifetime Warranty
will no longer apply, and the product warranty will instead be the three (3) year Limited Warranty.
All products returned to AMX require a Return Material Authorization (RMA) number. The RMA number is obtained from the AMX
RMA Department. The RMA number must be clearly marked on the outside of each box. The RMA is valid for a 30-day period. After
the 30-day period the RMA will be cancelled. Any shipments received not consistent with the RMA, or after the RMA is cancelled, will
be refused. AMX is not responsible for products returned without a valid RMA number.
AMX is not liable for any damages caused by its products or for the failure of its products to perform. This includes any lost profits,
lost savings, incidental damages, or consequential damages. AMX is not liable for any claim made by a third party or by an AMX
Authorized Partner for a third party.
This Limited Warranty does not apply to (a) any AMX product that has been modified, altered or repaired by an unauthorized agent or
improperly transported, stored, installed, used, or maintained; (b) damage caused by acts of nature, including flood, erosion, or earthquake; (c) damage caused by a sustained low or high voltage situation or by a low or high voltage disturbance, including brownouts,
sags, spikes, or power outages; or (d) damage caused by war, vandalism, theft, depletion, or obsolescence.
This limitation of liability applies whether damages are sought, or a claim is made, under this warranty or as a tort claim (including
negligence and strict product liability), a contract claim, or any other claim. This limitation of liability cannot be waived or amended by
any person. This limitation of liability will be effective even if AMX or an authorized representative of AMX has been advised of the
possibility of any such damages. This limitation of liability, however, will not apply to claims for personal injury.
Some states do not allow a limitation of how long an implied warranty last. Some states do not allow the limitation or exclusion of incidental or consequential damages for consumer products. In such states, the limitation or exclusion of the Limited Warranty may not
apply. This Limited Warranty gives the owner specific legal rights. The owner may also have other rights that vary from state to state.
The owner is advised to consult applicable state laws for full determination of rights.
EXCEPT AS EXPRESSLY SET FORTH IN THIS WARRANTY, AMX MAKES NO OTHER WARRANTIES, EXPRESSED OR
IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
AMX EXPRESSLY DISCLAIMS ALL WARRANTIES NOT STATED IN THIS LIMITED WARRANTY. ANY IMPLIED WARRANTIES
THAT MAY BE IMPOSED BY LAW ARE LIMITED TO THE TERMS OF THIS LIMITED WARRANTY. EXCEPT AS OTHERWISE LIMITED BY APPLICABLE LAW, AMX RESERVES THE RIGHT TO MODIFY OR DISCONTINUE DESIGNS, SPECIFICATIONS, WARRANTIES, PRICES, AND POLICIES WITHOUT NOTICE.
The TPI-PRO Total Presentation Interface - Pro Edition serves as a video switcher that allows users to
incorporate large-scale touch-screen technology from a variety of manufacturers into an AMX NetLinx
controlled system.
With the TPI-PRO, multiple video and RGB sources can be simultaneously delivered to a display, then
controlled and managed via a connected touch monitor or through send commands on the NetLinx
Controller. The combined image can be output in real time to video displays and projectors.
The TPI-PRO receives control and touch point information from a variety of pointing devices (i.e. touch
screen, mouse, or keyboard), and connects to the control system via Ethernet.
The TPI-PRO is available in two versions:
Overview
The TPI-PRO-4 (FG2275-104) supports up to four inputs.
FIG. 1 TPI-PRO-4
The TPI-PRO-2 (FG2275-102) supports up to two inputs.
FIG. 2 TPI-PRO-2
Both TPI-PROs support high resolution inputs/outputs:
Inputs (2 or 4): Composite, VGA (up to 1920x1200), Component (up to 1080p). Inputs can
be scaled to fit into independent windows or viewed full-screen.
Outputs (2): VGA up to 1920x1200 (WUXGA) 60 Hz.
Basic features of both include:
Up to 4 video or RGB windows can be simultaneously displayed and controlled
USB (wired and wireless) mouse pass-through allows the presenter to view and control up to
four computers from one display
TPI-PRO Total Presentation Interface - Pro Edition
1
Overview
TPI-PRO-4 Front and Rear Components
Input 1-4 LEDs
Button - TOUCH
Button - CALIBRATE
Button - SETUP
4 USB (Type-B)
Source Interface
ports
Power switch/LED
2 USB (Type-A)
Host Interface ports
(Configuration) port
VIDEO/VGA
Inputs 1-4
FIG. 3 TPI-PRO-4
Status LED
Button - RESOLUTION
Serial
VGA Outputs 1-2
TPI-PRO-2 Front and Rear Components
Status LED
Input 1-2 LEDs
RS-232 Touch Input port
Ethernet port (RJ-45)
2 USB
(Type-A)
ports
Power Connector
(Front)
(Rear)
Stereo
Output
(Front)
Power switch/LED
2 USB (Type-A)
Host Interface ports
(Configuration) port
VIDEO/VGA
Inputs 1-2
FIG. 4 TPI-PRO-2
Serial
VGA Outputs 1-2
Button - RESOLUTION
Button - TOUCH
Button - CALIBRATE
Button - SETUP
2 USB (Type-B)
Source Interface
ports
RS-232 Touch Input port
Ethernet port (RJ-45)
2 USB
(Type-A)
portsOutput
Power Connector
(Rear)
Stereo
2
TPI-PRO Total Presentation Interface - Pro Edition
Overview
TPI-PRO Specifications
The following table lists the specifications for the TPI-PRO-4 and TPI-PRO-2. Note that the primary
difference between the TPI-PRO-4 and TPI-PRO-2 is in the number of inputs. In terms of functionality
and specifications, they are otherwise identical. Therefore, the specifications listed below apply to both
versions, unless specifically noted.
TPI-PRO Specifications
Power Requirements:• Constant current draw: 2.6 A @ 12 VDC
Memory:• 256 MB SDRAM
Supported Video
Resolutions:
Supported Audio Sample
Rates:
Front Panel Components:
Power switch/LEDToggles the unit off and on.
USB Type-A Host ports2 USB ports that can be used for a keyboard, mouse, external storage unit, or
Serial (Programming) portDB9 connector (male) connects to a DB9 serial port on a PC, for serial
Status LED• Constant ON: No communication with the NetLinx Master
• The PSN6.5 Power Supply (FG423-40 - not included) is recommended, to
accommodate all possible configurations and respective power draws.
• 256 MB disk memory
• See the Other AMX Equipment: section on page 6 for component upgrade
information.
Input Composite Video and S-Video:
•NTSC M/J
• NTSC 4.43
• PAL B/D/I/G/H
•PAL 60
•PAL M
•PAL N
•PAL Nc
• SECAM B/D/G/K/L
Input Component Video:
• NTSC 480i, 480p
• PAL 576i, 576p, 720p, 1080i, 1080p
48000Hz, 44100Hz, 32000Hz, 24000Hz, 22050Hz, 16000Hz, 12000Hz,
11025Hz, and 8000Hz.
• Light Off: Power to the unit is either not plugged in, below approximately
10VDC, above approximately 19VDC, or cross-wired.
• Constant Green: Power to the unit is within nominal voltage limits (between
10VDC and 19VDC, approximately), the unit is on, and all internal power
supplies are operating normally.
• Constant Yellow: Power to the unit is within nominal voltage limits (between
10VDC and 19VDC, approximately) and the unit has been turned off by
pressing the power switch for more than two seconds.
• Flashing Yellow: Power to the unit is within nominal voltage limits (between
10VDC and 19VDC, approximately), but one or more of the internal power
supplies are not operating correctly. The unit needs to be serviced. Contact
AMX Technical Support for further instructions.
USB-capable touch panel interface.
• USB 2.0 support is required for all USB devices.
• Do not use a USB hub to connect multiple USB devices to the TPI-PRO.
communication.
• Blinking: In communication with the NetLinx Master
TPI-PRO Total Presentation Interface - Pro Edition
3
Overview
TPI-PRO Specifications (Cont.)
Input LEDsYellow LEDs indicate a valid input signal on each source input (1-4 on the
TPI-PRO-4, 1-2 on the TPI-PRO-2).
ButtonsFour white buttons provide access to the following configuration options:
• RESOLUTION: Opens a screen used to select the TPI-PRO output video
signal resolution, ranging from 640 x 480@60Hz to 1920 x 1200@60Hz.
This output resolution cannot be greater than the resolution on the
connected panel.
Refer to the Setting the Output Resolution on the TPI-PRO section on
page 26 for more information.
• TOUCH: Opens the Protected Setup page, where you can select (from a
series of touch panel drivers), and select the driver that corresponds to the
touch panel connected to the TPI-PRO (via the TOUCH INPUT connector.
Refer to the Setting the Touch Drivers section on page 27 for more
information.
• CALIBRATE: Opens the Calibration page, displaying a series of crosshairs.
These crosshairs are used to calibrate the touch device being used.
Refer to the Calibrating the TPI-PRO Using a USB Input section on page 28
for more information.
• SETUP: Opens the TPI-PRO firmware setup menu.
Refer to the Firmware Pages and Descriptions section on page 47 for more
information.
Rear Panel Components:
VIDEO/VGA InputsHD-15 connectors, one per input source (1-4 on the TPI-PRO-4, 1-2 on the
VGA Outputs2 HD-15 connectors:
Source TOUCH,
KEYBOARD/MOUSE USB
ports
Host USB Touch Monitor
KEYBOARD/MOUSE USB
ports
ETHERNET 10/100 portRJ-45 port provides 10/100 Mbps communication communicates with the
TOUCH INPUT portRS-232 (DB9) 9-pin serial port provides connectivity to a pointer device (i.e.
AUDIO OUT connector3.5mm mini-jack provides stereo output - for use with line-level (0.707 VRMS)
Power connector2-pin 3.5 mm mini-Phoenix connector.
TPI-PRO-2).
Each connector supports VGA graphics, S-video, composite video, and
component video.
• 1 connector for the touch-panel control display which displays the video
feeds, G4 graphics, external windowed video/graphics inputs, and
annotation graphics (G4 graphics can be turned off under program control).
• 1 connector for the public-view non-touch monitor which displays only the
video feeds, G4 graphics, external windowed video/graphics inputs, and
annotation graphics (G4 graphics can be turned off under program control).
Each output can send a maximum resolution of 1920 x 1200@60 Hz.
Note: Both output uses the same resolution settings.
2 or 4 USB Type-B device ports, one per source computer—for source USB
Touch Monitor, mouse/keyboard control (1-4 on the TPI-PRO-4, 1-2 on the
TPI-PRO-2).
• USB 2.0 support is required for all USB devices.
• Do not use a USB hub to connect multiple USB devices to the TPI-PRO.
2 USB Type-A ports that can be used for a keyboard, mouse, external storage
unit, or USB-capable touch panel interface.
• USB 2.0 support is required for all USB devices.
• Do not use a USB hub to connect multiple USB devices to the TPI-PRO.
NetLinx Master (via ICSP protocol over Ethernet).
• The Ethernet port automatically negotiates the connection speed (10 Mbps or
100 Mbps), and whether to use half duplex or full duplex mode.
• This communication is reflected via the front ICSP LED.
touch screen) that requires a serial connection.
non-amplified stereo output only.
4
TPI-PRO Total Presentation Interface - Pro Edition
Overview
TPI-PRO Specifications (Cont.)
Serial Touch Drivers:For an updated list of available serial touch input drivers that are selectable by
using the TOUCH button on the front panel of the TPI-PRO, visit
www.amx.com. Refer to the
Rates section on page 140 for a more detailed list of Touch Monitors that have
been tested with the TPI-Pro.
USB Drivers:USB Touch drivers are automatically loaded when the USB Touch Monitor is
detected. Refer to www.amx.com for latest list of supported USB touch
drivers.
Button Assignments:Button assignments can be modified in TPD4 (not on the TPI-PROs.)
• Button states range: 1 - 256 (General Button; 1 = Off State, 2 = On State)
• Level range: 1 - 600 (Default level value 0-255, can be set up to 1-65535)
• Address port range: 1 - 100
Communication/
Programming:
Enclosure:Metal with black matte finish
Operating/Storage
Environment:
Dimensions (HWD):• 2.24" x 17.00" x 10.27"
Weight:8.25 lbs (3.74 kg)
Certifications:• FCC (Class B)
Included Accessories:• 2-pin PWR connector (41-5025)
Master communication and programming is available via an Ethernet
connection. Refer to the
Typ e section on page 34 for more information.
There are several methods of TPI-PRO communication and programming
available:
• DHCP - Refer to the IP Settings section - Configuring a DHCP Address over Ethernet section on page 33 for more information.
• Static IP - Refer to the IP Settings section - Configuring a Static IP Address over Ethernet section on page 33 for more information.
• URL - Refer to the Master Connection section - NetLinx Master Ethernet IP Address - URL Mode section on page 35 for more information.
• Listen - Refer to the Master Connection section - NetLinx Master Ethernet IP Address - Listen Mode section on page 36 for more information.
• Auto - Refer to the Master Connection section - NetLinx Master Ethernet IP Address - Auto Mode section on page 37 for more information.
• NPD (UPD - Refer to the Master Connection section - NetLinx Master Ethernet IP Address - NDP (UDP) Mode section on page 37 for more
information.
• URL (UPD) - Refer to the Master Connection section - NetLinx Master Ethernet IP Address - URL (UDP) Mode section on page 38 for more
information.
• Operating Temperature: 0° C (32° F) to 40° C (104° F)
• Operating Humidity: 5% to 85% RH Non-Condensing
• Storage Temperature: -10° C (14° F) to 70° C (158° F)
• Storage Humidity: 0% to 85% RH Non-Condensing
• 5.69 cm x 43.18 cm x 26.09 cm
•CE
• IEC60950
• Assembly Kit (Four-#10-32 screws and Four-#10 washers) (KA0001)
• Rack Ear brackets for shelf, wall, and under-table mounting (60-0900-03)
• TPI-PRO Quick Start Guide (93-2275-101)
• NXA-USBTN, TakeNote USB Computer Control Stick (FG070-603)
List of Available Pixel Display and Refresh
Step 3: Configuring the Ethernet Connection
TPI-PRO Total Presentation Interface - Pro Edition
5
Overview
TPI-PRO Specifications (Cont.)
Other AMX Equipment:• PSN6.5: Power Supply with 3.5 mm mini-Phoenix connector (FG423-40)
• CC-HD15M-HD15M – HD-15 Male to HD-15 Male, 6’ cable (FG10-2170-01)
• CC-HD15M-RCAM3 – HD-15 to 3x Male RCA connectors for component or
composite sources (FG10-2170-03)
• CC-HD15M-SVIDM – HD-15 Male to S-Video Male connector, 6’ cable
(FG10-2170-04)
6
TPI-PRO Total Presentation Interface - Pro Edition
Installation
Overview
The TPI-PRO comes included with rack ears that can be rotated 90° in any direction to accommodate
several different mounting options, including tabletop, under/over the table, and vertical wall mounting.
Rotate the mounting brackets to mount the TPI-PRO on top of a flat surface, under-table, or vertically.
Mounting the TPI-PRO into an 19" Equipment Rack
The TPI-PRO occupies one rack unit in a standard 19" equipment rack. The included mounting brackets
can be rotated 90° in any direction to accommodate several different mounting options, including
tabletop, under/over the table, and vertical wall mounting.
The following steps apply to all of these mounting options.
1. Discharge any static electricity from your body by touching a grounded metal object.
2. Position and install the mounting brackets, as shown in FIG. 5, using the supplied mounting screws.
The mounting brackets can be rotated to accommodate your mounting needs.
Mounting screws
(2 per side)
Installation
Mounting holes
(2 per side)
Mounting Bracket
(front)
Mounting Bracket
FIG. 5 Rack-Mounting the TPI-PRO
Mounting holes
(2 per side)
Mounting screws
(2 per side)
3. Connect any applicable wires to the TPI-PRO. Refer to the Wiring and Device Connections section
on page 11 for wiring diagrams and pinout descriptions.
Connect the unit only to a properly-rated supply circuit.
DO NOT stand other units directly on top of the TPI-PRO when it is rack mounted, as
this will place excessive strain on the mounting brackets.
TPI-PRO Total Presentation Interface - Pro Edition
7
Installation
Ventilation
ALWAYS ensure that the rack enclosure is adequately ventilated.
The maximum operating ambient temperature is 40°C.
Sufficient airflow must be achieved (by convection or forced-air cooling) to satisfy the ventilation
requirements of all the items of equipment installed within the rack.
Never restrict the airflow through the device’s fan or vents.
When installing equipment into a rack, distribute the units evenly. Otherwise,
hazardous conditions may be created by an uneven weight distribution.
Reliable earthing (grounding) of rack-mounted equipment should be maintained.
8
TPI-PRO Total Presentation Interface - Pro Edition
Installation
TPI-PRO Total Presentation Interface - Pro Edition
9
Installation
10
TPI-PRO Total Presentation Interface - Pro Edition
Wiring and Device Connections
Overview
Most device connections are made via the ports on the rear panel of the TPI-PRO (FIG. 6).
Wiring and Device Connections
VIDEO/VGA INPUTS - These HD-15
connectors accept source video from
up to four Source devices.
Connect to the output ports on the
Source devices with the appropriate
cable according to the source
signal type.
VGA OUTPUTS - These HD-15
connectors distribute TPI-PRO video
to up to two display devices.
Connect to the HD-15 Input ports on
the display devices.
Note that the rear panel connectors on both versions of the TPI-PRO are identical, with the exception
of the number of HD-15 inputs for VIDEO/VGA (four on the TPI-PRO-4, two on the TPI-PRO-2),
and SOURCE KEYBOARD/MOUSE USB ports (four on the TPI-PRO-4, two on the TPI-PRO-2).
FIG. 6 TPI-PRO-4 - rear panel connectors
SOURCE TOUCH/KEYBOARD/
MOUSE USB Ports - These Type-B
USB ports provide touch, keyboard, and
mouse control from up to four PCs.
Connect to source PC that corresponds
to the corresponding source
VIDEO/VGA connector.
USB Ports - These Type-A ports
are used for USB Touch Monitor,
keyboard, and mouse connections.
For detailed descriptions of the rear panel connectors, refer to the Connector Details and Pinout
Configurations section on page 17.
The only connectors on the front panel are two USB (Type A) ports, which allow the TPI-PRO to
connect an input device like a USB touch monitor, mouse, or keyboard, and a RS-232 SERIAL
(Configuration) port (
FIG. 7).
USB Ports (Type A)SERIAL Configuration Port (DB-9)
Note that the front panel connectors on both versions of the TPI-PRO are identical.
FIG. 7 TPI-PRO-4 - front panel connectors
See the Programming section on page 75 for a detailed description of the front panel RS-232 SERIAL
port and a listing of supported NetLinx Send_Commands
TPI-PRO Total Presentation Interface - Pro Edition
11
Wiring and Device Connections
System Diagrams
The following System Diagrams illustrate the most common applications for the TPI-PRO. For detailed
pinout descriptions for each connector on the TPI-PRO, refer to the
Configurations section on page 17.
Example 1 (TOUCH INPUT)
The example below displays a typical installation using a touch panel to display output from a video
source (in this case, a PC.)
Signal video feed
from the computer
to the touch panel
through the
TPI-PRO.
Connector Details and Pinout
PC
NetLinx Master
Ethernet
USB-compatible touch
panel connected to
Type-A USB port.
Connect VGA Output
to touch panel
FIG. 8 System Installation Example 1 (TOUCH INPUT)
Serial touch input
from serial touch panel.
Touch Panel
Follow these steps to configure the TPI-PRO for touch panel input:
1. Discharge any acquired static electricity by touching a grounded metal object.
2. Disconnect any incoming power connector from the rear of the TPI-PRO.
3. If connecting a serial touch monitor, attach the DB9 touch panel cable (male) to the 9-pin TOUCH
INPUT connector (male) on the rear of the TPI-PRO. Refer to the
TOUCH INPUT (DB9)
Port section on page 21 for a description of the TOUCH INPUT connector pinouts. If connecting a
USB touch monitor, attach the cable to the USB Type A port. Touch panels can connect to either the
TOUCH INPUT connector or one of the Type-A USB ports, depending on the compatibility of the
touch panel.
4. Connect the touch panel’s HD-15 video cable to one of the VGA OUTPUT port on the rear of the
TPI-PRO.
5. Connect an HD-15 cable from the rear video port (on the computer) to one of the VGA/RGB 15-pin
male HD-15 input connectors on the rear of the TPI-PRO unit.
12
TPI-PRO Total Presentation Interface - Pro Edition
Wiring and Device Connections
6. Cycle power the unit. Cycle powering the unit allows it to detect the new configuration.
Example 2 (Mouse Pass-Thru Control)
The example below displays a typical installation for using a touch panel for mouse pass-thru control.
PC
Signal video feed
from the computer
to the monitor
through the
TPI-PRO.
Connect VGA Output
to CRT Monitor
CRT Monitor
FIG. 9 System Installation Example 2 (Mouse Pass-Thru Control)
Type-B USB cable
between PC and
TPI-PRO (control
is on panel pages
on the computer
and displayed on
the monitor)
From USB Mouse/
keyboard input
device (controls
actions on
computer pages
routed for viewing
through monitor)
Ethernet
NetLinx Master
To enable a touch response on a panel page routed through a computer, you must enable pass-thru
control. Pass-thru control enables the TPI-PRO to act as a control bridge between a computer and a
monitor (typically with no touch features, such as a CRT computer monitor.)
If you experience problems introducing new devices, you can install the drivers on a
remote PC according to manufacturer suggestions with the device connected directly
to the remote PC.
TPI-PRO Total Presentation Interface - Pro Edition
13
Wiring and Device Connections
The two USB connectors on the rear of the TPI-PRO are used to provide signals from a keyboard and/or
mouse. The Type-B USB connection on the TPI-PRO is used for communication between the TPI-PRO
and the computer.
Using a USB hub may cause functionality issues with all USB ports on the TPI-PRO.
AMX recommends you do not use a USB hub to connect multiple USB devices to the
TPI-PRO.
USB 2.0 support is required for all USB devices.
Removing and reconnecting USB devices from the TPI-PRO front panel may result in
a loss of connectivity. If this occurs, resetting the unit will allow the devices to
re-establish connectivity.
When disconnecting a USB device, please wait 5-10 seconds before reconnecting or
connecting a new device to allow the TPI-PRO to recognize that the first device is
disconnected. If connectivity is lost, reset the TPI-PRO to allow re-establishment of
the connection.
Pass-thru must be enabled when using control devices that are connected to the
USB connectors on the rear of the TPI-PRO unit.
You can control a computer by routing the Mouse control through the TPI-PRO and displaying the
results on a CRT or non-touch enabled panel. In this scenario, the TPI-PRO is virtually non-existent as it
is akin to connecting the monitor and mouse directly to the rear of the computer.
The computer views the TPI-PRO as an adapter connected to a USB mouse device (as seen in FIG. 9).
Follow these steps to configure the TPI-PRO for mouse pass-thru control:
1. Discharge any acquired static electricity by touching a grounded metal object.
2. Disconnect any incoming power connector from the rear of the TPI-PRO.
3. Connect a USB mouse to one of the Type-A USB ports on the TPI-PRO unit.
4. Connect a USB cable from a USB connector port (on the computer) to one of the Type-B USB
device port input connectors on the rear of the TPI-PRO unit
5. Connect an HD-15 cable from the rear video port (on the computer) to the VGA/RGB 15-pin male
HD-15 input connector on the rear of the TPI-PRO unit that corresponds to the Type-B USB port to
which you connected the USB cable in step 4.
6. Connect the monitor’s HD-15 video cable to one of the VGA OUTPUT port on the rear of the
TPI-PRO.
7. Cycle power the unit. Cycle powering the unit allows it to detect the new configuration.
8. Code a button on the touch panel page to enable the pass-thru feature on a selected source input.
Refer to the
command. Toggling this coded panel button can enable/disable the pass-thru feature.
You first must set the TPI-PRO to match the resolution of the computer’s video output
resolution, and then you must adjust the TPI-PRO to fit the available screen on the
CRT monitor. It is possible the image generated from the TPI-PRO could be slightly
"off", in which case you should adjust the image using the CRT’s on-board video
adjustment buttons.
.
^PPS section on page 120 for the specific command parameters to enable the pass-thru
14
9. Setup the TPI-PRO output resolution using the procedures in the Setting the Output Resolution on
the TPI-PRO section on page 26.
If the TPI-PRO is turned off and then has power re-applied (power cycling), video
alignment settings established through the Video and/or RGB pages could be reset
unless the adjusted values have been previously saved. Refer to the
Page section on page 54 for more information.
TPI-PRO Total Presentation Interface - Pro Edition
Video Settings
Wiring and Device Connections
10. Use the CRT’s video adjust buttons to align the incoming video signal to fit into the available screen
area. Initially positioning the TPI-PRO incoming video can reduce any later adjustments of the
video through the RGB Setup page (H-position, V-position, H-size, etc.)
Example 3 (Using a Touch Panel for Mouse / Touch Pass-Thru Control)
The example below displays a typical installation for using a touch panel for mouse and touch pass-thru
control.
Signal video feed
from the computer
to the touch panel
through the
TPI-PRO.
PC
NetLinx Master
Ethernet
Type-B USB cable between
PC and TPI-PRO (control is
on panel pages on the
computer and displayed on
the touch panel)
Connect VGA Output
to touch panel
From USB Mouse input
device (controls actions on
computer pages routed
for viewing through touch
panel)
Touch Input from touch panel.
Can be either serial or USB.
USB-compatible touch panels
connect to Type-A USB port.
Touch Panel
FIG. 10 System Installation Example 3 (Using a Touch Panel for Mouse / Touch Pass-Thru Control)
To enable a touch response on a panel page being routed through a computer, you must establish
pass-thru enabling. Pass-thru control allows the TPI-PRO to act as a control bridge between a computer
and a touch panel.
The touch panel control option is available by either selecting a Video Fill (select Ye s from the Windows
>> Properties >> States TPD4 drop-down menu to enable the option) or by enabling pass through via
the ^PPS command. With Video Pass-Thru enabled, the panel's touch coordinates are passed as USB
commands from the HD-15 connector on a TPI-PRO to the connected PC. This feature works only if the
HD-15 connector is connected directly to the PC via the HD-15 port on the rear of the TPI-PRO. The
touch coordinates are scaled to fit the resulting window. This allows you to "synch" the touch actions
from the panel to those on the connected computer.
Computer control can be established by routing the Mouse and touch panel input control through the
TPI-PRO. In this scenario, the TPI-PRO is virtually non-existent and is akin to connecting the touch
panel and mouse directly to the rear of the computer. The computer views the TPI-PRO and the HD-15
and USB connectors as an adapter connected to a USB mouse device. This method allows for both mouse and touch panel input control of the computer (as seen in
FIG. 10).
TPI-PRO Total Presentation Interface - Pro Edition
15
Wiring and Device Connections
Follow these steps to configure the TPI-PRO to use a touch panel for touch and mouse pass-thru control:
1. Discharge any acquired static electricity by touching a grounded metal object.
2. Disconnect any incoming power connector from the rear of the TPI-PRO.
3. Connect a USB mouse to the TPI-PRO unit.
4. Connect a USB cable from a rear USB connector port (on the computer) to the Type-B USB device
port input connector on the rear of the TPI-PRO
5. Connect a HD-15 cable from the rear video port (on the computer) to one of the HD-15 source input
connectors on the rear of the TPI-PRO.
6. Connect a DB9 touch input cable from the touch panel to the DB9 TOUCH INPUT connector on
the rear of the TPI-PRO unit, or connect the cable from a USB touch monitor to the USB Type-A
port on the TPI-PRO unit. Touch panels can connect to either the TOUCH INPUT connector or one
of the Type-A USB ports, depending on the compatibility of the touch panel.
7. Connect the touch panel’s HD-15 video cable to one of the VGA OUTPUT ports on the rear of the
TPI-PRO.
8. Cycle power the unit. Cycling the unit allows it to detect the new configuration.
9. Code a button on the touch panel page to enable the pass-thru feature on a selected input card slot.
Refer to the
Pass-thru command on the TPI-PRO. Toggling this coded panel button can enable/disable the
pass-thru feature.
You must set the TPI-PRO to match the resolution of the touch panel’s video output
resolution, then select a touch driver. The video should automatically fill-in the
available screen area on the touch panel. It is possible the image generated from the
TPI-PRO could be slightly "off", in which case you should adjust the image using the
CRT’s on-board video adjustment buttons.
.
^PPS section on page 120 for the specific command parameters to enable the Mouse
10. Setup the TPI-PRO output resolution using the procedures in the Setting the Output Resolution on
the TPI-PRO section on page 26.
If the TPI-PRO is turned off and then has power re-applied (power cycling), video
alignment settings established through the Video and/or RGB pages could be reset
unless the adjusted values have been previously saved. Refer to the
Page section on page 54 for more information.
Video Settings
11. Setup the touch drivers for the connected touch panel by using the procedures in the Setting the
Touch Drivers section on page 27.
12. If necessary, use the panel’s video adjust buttons to align the incoming video signal to fit into the
available screen area. Initially positioning the TPI-PRO incoming video can reduce any later
adjustments of the video through the RGB Setup page (H-position, V-position, H-size, etc.)
16
TPI-PRO Total Presentation Interface - Pro Edition
Wiring and Device Connections
Connector Details and Pinout Configurations
The following sections describe in detail each of the connectors on the the TPI-PRO:
VIDEO/VGA INPUT Connectors
FIG. 11 VIDEO/VGA INPUT Connectors
The Video/VGA Input connectors are used for source input devices (4 on the TPI-PRO-4, 2 on the
TPI-PRO-2). Each connector supports VGA graphics, S-video, composite video, and component video.
The TPI-PRO routes the video from the connected input devices to any connected output devices.
VGA OUTPUT (HD-15) Connectors
FIG. 12 VGA Output Connectors
Each TPI-PRO has two VGA Output connectors. You can connect the VGA source equipment HD-15
(male) connector (from the touch device) to the VGA OUT HD-15 high-density connector (female) on
the rear panel of the TPI-PRO. The output devices display video from source input devices routing
through the TPI-PRO.
TPI-PRO Total Presentation Interface - Pro Edition
17
Wiring and Device Connections
The following tables list the VGA OUT HD-15 connector pinouts.
VGA OUT HD-15 Connector Pinouts
Pin Signal Function
1RedRed signals
2Green Green signals
3BlueBlue signals
4Sense 2 Monitor ID bit 2
5GNDSignal Ground
6RAGND Red analog ground
7GAGND Green analog ground
8BAGND Blue analog ground
9N/ANot used
10SAGND Synchronization analog ground
11Sense 0 Monitor ID bit 0
12Sense 1 Monitor ID bit 1
13HSYNC Horizontal synchronization signal
14VSYNC Vertical synchronization signal
15Sense 3 Monitor ID bit 3
5
1
VGA HD-15 (male)
connector
10
15
11
6
The following table lists the pinout configuration for HD-15 connector to S-Video connectors:
The following table lists the pinout configuration for HD-15 connector to Composite (BNC) connectors:
VGA IN to Composite Pinouts
VGA
Pin
10SAGNDVSync Returnshield
11Sense 0
12Sense 1
13HSYNCHSync Signalcenter pin
14VSYNCVSync Signalcenter pin
15Sense 3
VGA
Signal
1RedRed Signalcenter pin
2GreenGreen Signalcenter pin
3BlueBlue Signalcenter pin
4Sense 2
5GNDHSync Returnshield
6RAGNDRed Returnshield
7GAGNDGreen Returnshield
8BAGNDBlue Returnshield
9N/A
Composite
Signal
Red BNC Green BNC Blue Coax Black BNC Grey Coax
TPI-PRO Total Presentation Interface - Pro Edition
19
Wiring and Device Connections
SOURCE KEYBOARD/MOUSE (USB-Type B) Ports
FIG. 13 SOURCE KEYBOARD/MOUSE (USB-Type B) Ports
You can connect up to four USB Type-B Host PC connections for TOUCH, Mouse and Keyboard
pass-through to the PC (two on the TPI-PRO-2, four on the TPI-PRO-4) via the SOURCE KEYBOARD/
MOUSE USB connectors.
If you experience problems introducing new devices, you can install the drivers on a
remote PC according to manufacturer suggestions with the device connected directly
to the remote PC.
To connect a host touch monitor, mouse, or keyboard to the TPI-PRO, insert the host PC USB connectors
into the appropriate USB Type-B connector on the TPI-PRO.
Notes on USB Device Connections
USB-connected input devices are detected and recognized by the unit upon connection. Removing and
reconnecting USB devices from the TPI-PRO may result in a loss of connectivity. If this occurs, resetting
the unit will allow the devices to re-establish connectivity.
When disconnecting a USB device, wait 5-10 seconds before reconnecting or connecting a
Using a USB hub may cause functionality issues with all USB ports on the TPI-PRO.
USB 2.0 support is required for all USB devices.
new device to allow the TPI-PRO to recognize that the first device is disconnected. If
connectivity is lost, reset the TPI-PRO to allow re-establishment of the connection.
Do not use a USB hub to connect multiple USB devices to the TPI-PRO.
20
TPI-PRO Total Presentation Interface - Pro Edition
Wiring and Device Connections
TOUCH INPUT (DB9) Port
FIG. 14 TOUCH INPUT (DB9) Port
The RS-232 (DB9) 9-pin serial port provides connectivity to a pointer device (i.e. touch screen) that
requires a serial connection.
The following table lists the RS-232 connector pinouts.
(DB9) RS-232 Connector Pinouts
Pin Signal Function
1N/ANot used
2RXDReceive data
3TXDTransmit data
4DTRData terminal ready
5GNDSignal ground
6DSRData set ready
7RTSRequest to send
8CTSClear to send
9N/ANot used
9
8
7
6
Female
from TPI-PROfrom touch device
5
4
3
2
1
Male
9
8
7
6
TPI-PRO Total Presentation Interface - Pro Edition
21
Wiring and Device Connections
ETHERNET (RJ-45) Port
FIG. 15 ETHERNET (RJ-45) Port
The RJ-45 port provides 10/100 Mbps communication communicates with the NetLinx Master (via
ICSP protocol over Ethernet). The Ethernet port automatically negotiates the connection speed (10 Mbps
or 100 Mbps), and whether to use half duplex or full duplex mode. This communication is reflected via
the front ICSP LED.
FIG. 16 describes the blink activity for the ETHERNET 10/100 Base-T RJ-45 connector and cable.
A - Activity LED (yellow)
lights when receiving or
transmitting Ethernet
data packets
FIG. 16 ETHERNET connector / LEDs
AL
L - Link LED (green) lights when
the Ethernet cables are connected
and terminated correctly.
The following table lists the pinouts, signals, and pairing associated with the ETHERNET connector.
FIG. 17 diagrams the RJ-45 pinouts and signals for the ETHERNET RJ-45 connector and cable.
22
FIG. 17 RJ-45 wiring diagram
TPI-PRO Total Presentation Interface - Pro Edition
Wiring and Device Connections
Power (2-Pin Captive Wire) Connector
FIG. 18 Power (2-Pin Captive Wire) Connector
The TPI-PRO requires a 12 VDC-compliant power supply to provide power to the TPI-PRO via the
2-pin 3.5 mm mini-Phoenix PWR connector. The incoming PWR and GND wires from the power supply
must be connected to the corresponding locations within the PWR connector.
Do not connect power to the TPI-PRO until wiring is complete. These units should
only have one source of incoming power. Using more than source of power to the
panel can result in damage to the internal components and a possible burn out.
Apply power to the panels only after installation is complete.
To use the 2-pin 3.5 mm mini-Phoenix connector for use with a 12 VDC-compliant power supply, the
incoming PWR and GND wires from the external source must be connected to their corresponding
locations on the connector (
FIG. 19).
PWR +
GND -
To the TPI-PRO
FIG. 19 NetLinx power connector wiring diagram
Power Supply
Never pre-tin wires for compression-type connections.
1. Strip 0.25 inch (6.35 mm) of insulation off all wires.
2. Insert the PWR and GND wires on the terminal end of the 2-pin 3.5 mm mini-Phoenix cable. Match
the wiring locations of the +/- on both the power supply and the terminal connector.
3. Tighten the clamp to secure the two wires. Do not tighten the screws excessively; doing so may strip
the threads and damage the connector.
4. Verify the connection of the 2-pin 3.5 mm mini-Phoenix to the external 12 VDC-compliant power
supply.
TPI-PRO Total Presentation Interface - Pro Edition
23
Wiring and Device Connections
24
TPI-PRO Total Presentation Interface - Pro Edition
TPI-PRO and Panel Interface Setup
TPI-PRO and Panel Interface Setup
The information contained within this section refers to the procedures necessary to set up the TPI-PRO
resolution, assign a touch driver, and calibrate the driver for use with a connected touch panel.
Verify you are using the latest NetLinx Master firmware.
Verify you are using the latest TPI-PRO firmware.
Verify the NetLinx Studio program you are using is version 2.4 or higher.
Verify the TPDesign4 program you are using is version 2.8 or higher.
The TPI-PRO has been factory setup with specific touch panel pages. The first splash screen that appears
indicates the TPI-PRO is receiving power, loading firmware, and preparing to display the default touch
panel page. When the panel is ready, the AMX Splash Screen is replaced by the Initial Panel Setup page.
TPI-PRO Startup Routine and Initial Panel Response
1. Discharge any acquired static electricity by touching a grounded metal object.
2. Verify the rear connections are secure and active. Refer to the Wiring and Device
Connections section on page 11for more detailed cable connector information.
3. Connect the terminal-end of the PSN into an outlet to begin powering-up the unit and initializing the
startup routine.
4. After the startup routine, the connected touch panel displays one of two possible screens:
If the resolution of the TPI-PRO matches the supported resolution of the panel, continue by
setting the touch drivers associated with the LCD (if any). Refer to the
Drivers section on page 27.
If the TPI-PRO output resolution does not match the resolution of the connected panel, an
OUT OF RANGE message appears, and you must use the following steps to adjust the
output resolution of the TPI-PRO to match the panel.
This feature is monitor dependant and the range message is generated by the monitor (not by
the TPI-PRO). Some monitors do not display a message, but instead appear blank.
Setting the Touch
TPI-PRO Total Presentation Interface - Pro Edition
25
TPI-PRO and Panel Interface Setup
Setting the Output Resolution on the TPI-PRO
To correct the problem of an OUT OF RANGE message, the TPI-PRO output resolution must be set to
match the same output pixel resolution and refresh rate set on the connected panel/monitor.
The default TPI-PRO output resolution is 1280 x 1024@60Hz. Use the front panel RESOLUTION
button to alter the outgoing resolution (for a maximum of 1920 x 1200@60 Hz).
1. Press the RESOLUTION button on the front panel. This single press opens the Resolution Setup
Setting the resolution begins by displaying a comparison of the current/original output
resolution of the TPI-PRO (on one line) and then displaying the first selectable
display resolution and refresh rate (on the next line). The selection process originates
at a 1280x1024@60Hz display option and with every consecutive single push of the
RESOLUTION button, the TPI-PRO resolution increases to a maximum output of
1920x1200@60Hz.
2. Firmly press the RESOLUTION button again to cycle through the available resolution settings.
Every consecutive button push cycles the output resolution to the next highest available setting. A
double-push of the RESOLUTION button adjusts the resolution to previous setting. For a listing
of available pixel display and refresh rates, see the
List of Available Pixel Display and Refresh
Rates section on page 140.
If your panel does not match the initial TPI-PRO output resolution, you must perform these manual
setting procedures to "sync-up" both device settings.
Once your resolution is selected, you can use the outer screen area lines on the
Resolution Setup page to adjust your CRT monitor’s visible screen area. This could
involve using the monitor’s video control to stretch and move the incoming video so
that the borders follow the edges of the screen without disappearing. There are
normally 60 seconds before the resolution times-out, but you can press the front
panel Resolution button to continue.
3. After choosing the desired resolution, use the monitor’s video controls to stretch and move the
incoming video so the borders of the desired resolution pattern follow the edges of the screen
without disappearing. There are normally 60 seconds before the resolution times-out, but you can
press the front panel RESOLUTION button again to return to the previous resolution pattern and
continue setting-up the monitor.
26
TPI-PRO Total Presentation Interface - Pro Edition
TPI-PRO and Panel Interface Setup
4. Press and hold-down firmly the RESOLUTION button to save the resolution setting. A message
stating: "Please wait, loading new resolution..." appears to indicate the new resolution being is
saved. The Resolution Setup page then displays and exits the resolution setup process. There is then
some shifting of the defaulted Main page (which was developed for a 1280 x 1024 resolution).
5. Press the front panel TOUCH button to proceed with setting the Touch Drivers (see the Setting the
Touch Drivers section on page 27).
You set the touch drivers when you connect the TPI-PRO to a touch panel.
If you are using a CRT monitor, set the touch drivers to NullTouch.
Setting the Touch Drivers
This step only applies to serial touch montors. USB monitors are automatically detected. After matching
the resolution between the TPI-PRO and panel/monitor, the next step is to select the necessary touch
drivers from the available series provided through the TPI-PRO.
1. Press the TOUCH button on the front panel of the TPI-PRO to set the touch driver and open the
on-screen Panel Information page (
FIG. 21). The default Touch Input Driver is EloTouch®.
Select Nulltouch when using a CRT
or other non-touch monitor.
FIG. 21 Panel Information page
2. Press the front panel TOUCH button to cycle through a series of available touch input drivers. For a
list of current compatible touch drivers, visit www.amx.com.
Verify that the selected touch driver matches the connected touch panel or monitor. Refer to the List of Available Pixel Display and Refresh Rates section on page 140 for a comprehensive list of Touch
Monitors that have been tested with the TPI-PRO.
TPI-PRO Total Presentation Interface - Pro Edition
27
TPI-PRO and Panel Interface Setup
Calibrating the TPI-PRO Using a USB Input
1. Connect a USB cable from a touch panel to one of the Type-A USB ports on the front or back of the
TPI-PRO.
2. Reboot the TPI-PRO by pressing the power button on the unit so the unit can detect the new
hardware.
3. Press the CALIBRATE button on the front panel. This process opens a calibration page that uses a
series of crosshair coordinate intersections to calibrate the touch panel (using the newly selected
touch driver).
If the wrong touch driver is selected prior to the calibration process, press any
front-panel button to exit the calibration process and re-select another touch driver. If
you are using a CRT monitor, DO NOT PRESS THE CALIBRATE BUTTON. Refer to
Setting the Output Resolution on the TPI-PRO section on page 26 for CRT
the
screen adjustment procedures.
4. Press the crosshairs (on the Calibration page) to set the calibration points on the LCD.
5. After the "Calibration Successful." message appears, press anywhere to return to the Setup page. If
the calibration fails, attempt to calibrate again. If unsuccessful, call AMX Tech Support.
It is recommended that you calibrate the TPI-PRO before its initial use, after
completing a firmware download, and after switching touch input drivers (and touch
devices.)
6. Press the Protected Setup button (located on the lower-left of the panel page) to open the Protected
Setup page.
7. Enter 1988 into the Keypad’s password field and press Done when finished.
8. Press the on-screen Reboot button to cycle power to the TPI-PRO and incorporate the new settings.
The touch monitor goes blank for a few seconds during the reboot process. You can also use a
mouse to press the on-screen Reboot button.
Calibrating the TPI-PRO Using a Serial Touch Panel
1. Connect a DB9 cable from a touch panel to the DB-9 touch input connector on the back of the
TPI-PRO.
2. Reboot the TPI-PRO by pressing the power button on the unit so the unit can detect the new
hardware.
3. Press the CALIBRATE button on the front panel. This process opens a calibration page that uses a
series of crosshair coordinate intersections to calibrate the touch panel (using the newly selected
touch driver).
If the wrong touch driver is selected prior to the calibration process, press any
front-panel button to exit the calibration process and re-select another touch driver. If
you are using a CRT monitor, DO NOT PRESS THE CALIBRATE BUTTON. Refer to
Setting the Output Resolution on the TPI-PRO section on page 26 for CRT
the
screen adjustment procedures.
4. Press the crosshairs (on the Calibration page) to set the calibration points on the LCD.
5. After the "Calibration Successful." message appears, press anywhere to return to the Setup page. If
the calibration fails, return to the Protected Setup page and select another touch input driver.
28
It is recommended that you calibrate the TPI-PRO before its initial use, after
completing a firmware download, and after switching touch input drivers (and touch
devices.)
TPI-PRO Total Presentation Interface - Pro Edition
TPI-PRO and Panel Interface Setup
6. Press the Protected Setup button (located on the lower-left of the panel page) to open the Protected
Setup page.
7. Enter 1988 into the Keypad’s password field and press Done when finished.
8. Press the on-screen Reboot button to cycle power to the TPI-PRO and incorporate the new settings.
The touch monitor goes blank for a few seconds during the reboot process. You can also use a
mouse to press the on-screen Reboot button.
9. Upon start-up, press anywhere on the screen to return to the Protected Setup page and begin
defining the communication properties.
TPI-PRO Total Presentation Interface - Pro Edition
29
TPI-PRO and Panel Interface Setup
30
TPI-PRO Total Presentation Interface - Pro Edition
Configuring Communication
Communication between the TPI-PRO and the NetLinx Master consists of using an Ethernet connection
(DHCP or Static IP).
If you are currently using a static IP Address, continue with the IP Settings section Configuring a Static IP Address over Ethernet section on page 33.
Configuring Communication
Before commencing, verify you are using the latest NetLinx Master firmware.
Verify the NetLinx Studio program being used is version 2.4 or higher.
Setting up the TPI-PRO Device Number
1. Press the front panel SETUP button to open the Setup page.
Connection Status
Red Connection Status icon -
indicates no connection to
a Master
Green Connection Status icon -
indicates active
communication to a Master
Yel low Connection Status icon -
indicates an unreliable
network connection
FIG. 22 Setup page
2. Press the Protected Setup button (located on the lower-left of the page) to open the Protected Setup
page and display an on-screen keypad.
3. Enter 1988 into the Keypad’s password field and press Done when finished.
Clearing Password #5, from the initial Password Setup page, removes the need for
you to enter the default password before accessing the Protected Setup page.
4. Press the red Device Number field to open the Device Number keypad (FIG. 23).
5. Enter a Device Number value for the panel into the Device Number Keypad.
The default value is 10001, and the range is from 1 - 32000.
When using multiple TPI-PROs within a NetLinx System, remember to assign unique
Device Number values to each panel so that all assigned panels appear in the
System listing for the target Master.
6. Press Done to close the keypad, assign the number, and return to the Protected Setup page.
TPI-PRO Total Presentation Interface - Pro Edition
31
Configuring Communication
FIG. 23 Protected Setup page with Keypad
7. Use the Baud Rate Up/Down arrows to cycle through the available baud rates for TPI-PRO serial
communication to the connected PC. The default is 38400.
Before continuing, open NetLinx Studio. This program assists in developing a System
Number, Master IP/URL, and Master Port number. Refer to your NetLinx Master’s
instruction manual for more information.
8. Obtain the System Number and Master IP Address from NetLinx Studio. This information must be
specific for the system used with the configured TPI-PRO.
9. Press the System Settings button (located on the Protected Setup page) to open the System Settings
FIG. 24) and begin configuring the communication settings on the TPI-PRO to match those of
page (
the target Master.
FIG. 24 System Settings page
10. Press the on-screen Reboot button to restart the TPI-PRO and incorporate any changes.
32
TPI-PRO Total Presentation Interface - Pro Edition
Configuring Communication
Configuring a Wired Ethernet Connection
It is necessary to tell the panel with which Master it should be communicating. "Pointing to a Master" is
configured via the System Connection page where you configure the IP Address, System Number, and
Username/Password information assigned to the target Master. Until you configure these parameters,
your Connection Status icon remains red, indicating there is no current connection to a Master.
Step 1: Configuring the Panel’s IP Settings
You can only configure the connection parameters for the TPI-PRO through the System Connection
page. You can configure this type of communication via either a Dynamic IP Address (DHCP) or via a
pre-reserved Static IP Address (typically provided by your System Administrator).
IP Settings section - Configuring a DHCP Address over Ethernet
1. Select Protected Setup > System Connection (located on the lower-left) to open the System
Connection page.
2. Locate the IP Settings section of this page.
3. Toggle the DHCP/Static field in the IP Settings section until the choice cycles to DHCP.
DHCP registers the unique MAC address (factory assigned) on the TPI-PRO. Once
the communication setup process is complete, reserves an IP Address, Subnet
Mask, and Gateway values from the DHCP Server.
4. Press the optional Host Name field to open a Keyboard and enter the Host Name information.
5. Press Done after you are finished assigning the alpha-numeric string of the host name.
6. Do not alter any of the remaining greyed-out fields in the IP Settings section. Once the TPI-PRO is
rebooted, these values are obtained by the unit and displayed in the DNS fields after power-up.
7. Press the Back button to return to the Protected Setup page.
8. Press the on-screen Reboot button to both save any changes and restart the TPI-PRO.
IP Settings section - Configuring a Static IP Address over Ethernet
1. Select Protected Setup > System Connection (located on the lower-left) to open the System
Connection page.
2. Locate the IP Settings section of this page.
Check with your System Administrator for a pre-reserved Static IP Address assigned
to the TPI-PRO. You must obtain this address before continuing to assign it to the
TPI-Pro.
3. Toggle the DHCP/Static field in the IP Settings section)until the choice cycles to Static.
4. Press the IP Address field to open a Keyboard and enter the static IP address provided by your
System Administrator.
5. Press Done after you are finished entering the IP information.
6. Repeat the same process for the Subnet Mask and Gateway fields.
7. Press the optional Host Name field to open the Keyboard and enter the Host Name information.
8. Press Done after you are finished assigning the alpha-numeric string of the host name.
9. Press the Primary DNS field to open a keyboard, enter the Primary DNS address provided by your
System Administrator, and press Done when compete. Repeat this process for the Secondary DNS
field.
TPI-PRO Total Presentation Interface - Pro Edition
33
Configuring Communication
10. Press the Domain field to open a keyboard, enter the resolvable domain address (this is provided by
your System Administrator and equates to a unique Internet name for the TPI-PRO.) Press Done
when complete.
11. Press the Back button to return to the Protected Setup page.
12. Press the on-screen Reboot button to both save any changes and restart the TPI-PRO.
13. Navigate to the Master Connection section of this page to begin configuring the communication
parameters for the target Master.
Step 2: Choosing a Master Connection Mode Setting
There are five Ethernet MODE settings used in the Master Connection section of the System Connection
page. URL is the most common method. The following table describes the master connection mode
options.
Master Connection Mode Options
URL (Uniform Resource Locator) is the address that defines the route to a file on the Web or any
other Internet facility. In this system, the panel acts as a "Client" and the Master acts as a Server (in
that Clients attach to it).
LISTEN sets the TPI-PRO to "listen" for connections from the Master (using the panel IP from its
URL list). In this system, the TPI-PRO acts as a "Server" (in that Clients attach to it) and the Master
acts as a "Client".
AUTO is used to instruct the TPI-PRO to search for a Master that uses the same System Number
(assigned within the Master Connection section) and resides on the same Subnet as itself.
NDP (UDP) uses multicasting to allow devices to discover each other. The devices must be on a
network that allows multicasting and is setup so that if the device and the Master are on separate
subnets, the multicasting allows them to discover each other.
URL (UDP) is the address that defines the route to a file on the Web or any other Internet facility. In
this system, the panel acts as a "Client" and the Master acts as a Server (in that Clients attach to it).
In this case, the Master has its UDP feature enabled.
Step 3: Configuring the Ethernet Connection Type
When using Ethernet as your communication method, the NetLinx Master must first
be setup with either a static IP or DHCP Address obtained from either NetLinx Studio
or your System Administrator.
Before beginning:
1. Verify the TPI-PRO has been configured to communicate through an Ethernet cable connected from
the rear of the TPI-PRO to a valid Ethernet Hub.
Before commencing, verify you are using the latest NetLinx Master firmware.
2. Verify that the NetLinx Master is receiving power and is communicating via an Ethernet connection
with the PC running NetLinx Studio.
3. Connect the terminal end of the PSN power cable to the 12 VDC power connector on the rear of the
TPI-PRO unit.
If you have not yet connected power and turned on TPI-PRO, continue with steps 4 -
7. These steps allow the panel to cycle through its available ports and detect any
attached connectors. Otherwise, skip to step 8.
34
TPI-PRO Total Presentation Interface - Pro Edition
Configuring Communication
4. Connect the terminal end of the PSN power cable to the 12 VDC power connector on the rear of the
TPI-PRO.
5. Verify the green Ethernet LED on the rear Ethernet port on both the Master and TPI-PRO are
illuminated, indicating a proper connection.
6. Verify the green Ethernet LED on the rear Ethernet port on the Master is illuminated, indicating a
proper connection.
7. Verify the yellow LED on the rear Ethernet port on the Master is blinking, indicating
communication.
8. After the TPI-PRO powers-up, press the front panel SETUP button to continue with the setup
process by proceeding to the Setup page.
9. Select Protected Setup > System Settings located on the lower-left section of the page to open the
In this mode, enter the System Number (zero for an unknown System Number) and the IP/URL of the
Master (Master Port Number is defaulted to 1319).
1. Press the Mode field until the option cycles to URL. By selecting URL, the System Number field
becomes read-only (grey) because the panel pulls this value directly from the communicating target
Master.
If the TPI-PRO does not appear within the Online Tree tab of the Workspace window
of NetLinx Studio, check to make sure that the NetLinx Master System Number (from
the Device Addressing dialog box) is correctly assigned.
2. Press the Master IP/URL field to open an on-screen keyboard, and enter the Master IP address or
URL (obtained from the Diagnostics - Networking Address dialog box in the NetLinx Studio
application).
3. Click Done to accept the new value and return to the System Configuration page.
4. Do not alter the Master Port Number value (this is the default value used by NetLinx).
5. Enter a username and password in their respective fields if the target Master has been previously
secured.
6. Press the Back button to open the Protected Setup page.
TPI-PRO Total Presentation Interface - Pro Edition
35
Configuring Communication
7. Press the on-screen Reboot button to both save any changes and restart the TPI-PRO.
In this mode, you must add the TPI-PRO IP address into the URL List of the Master (using NetLinx
Studio). This mode sets the TPI-PRO to "listen" for connections from the Master (using the TPI-PRO’s
IP from its URL list).
1. Obtain either a Static IP for the TPI-PRO from your System Administrator or a DHCP Address
from the IP Settings of the System Connection page. The DHCP/Static field in the IP Settings
section of the System Connection page must be set to DHCP to get Dynamic IP information for the
TPI-PRO.
2. Press the on-screen Reboot button on the Protected Setup page to both save any changes and restart
the TPI-PRO.
3. After power-up, press the front panel SETUP button to access the Setup page.
4. Navigate to the Setup > Protected Setup > System Settings page and note the newly obtained
Dynamic IP Address information from the IP Settings section. This information is then entered into
the URL List for the connected NetLinx Master.
5. Press the Type field in the Master Connection section until the option cycles to Ethernet.
6. To set the connection mode, press the Mode field until the option cycles to Listen.
7. Enter a username and password in their respective fields if the target Master has been previously
secured.
8. Select the Online Tree tab from the Workspace window.
9. Select Diagnostics > URL Listing from the Main menu (FIG. 26).
System Address
reflects the value
set in the Device
Addressing tab
Used to obtain an
existing URL
List from Master
Used to set the
URL List
on Master
FIG. 26 URL List dialog
10. Enter the System and Device number for the specific Master associated with your TPI-PRO, as seen
in the Online Tree tab.
11. Click Add, and enter the IP address of the TPI-PRO into the Add URL dialog box.
12. Click OK to enter your IP address and add it to the list.
13. Click Done once you are finished adding your TPI-PRO information to the list.
14. Press the on-screen Reboot button to save any changes and restart the TPI-PRO.
36
TPI-PRO Total Presentation Interface - Pro Edition
Configuring Communication
Master Connection section - NetLinx Master Ethernet IP Address - Auto Mode
In this mode, enter the System Number of the NetLinx Master. This mode instructs the TPI-PRO to
search for a Master that uses the same System Number (assigned within the Master Connection section)
and resides on the same Subnet as the TPI-PRO.
1. Press the Mode field until the option cycles to Auto.
2. Press the System Number field to launch an on-screen keypad, and enter the value for the system
number of the NetLinx Master. You can obtain this value from the NetLinx Studio program >
OnLine Tree of the Workspace window.
3. Do not alter the IP settings on the System Connection page, as this field is not applicable to this
connection mode.
4. Enter a username and password into their respective fields if the target Master has been previously
secured.
5. Press the on-screen Reboot button to both save any changes and restart the TPI-PRO.
6. Press the front panel SETUP button to open the Setup page and confirm there is an active
connection.
The NetLinx Master and the TPI-PRO must both be on the same Subnet.
In this mode, you must make a connection through the Master’s web page to bind the TPI-PRO to the
Master.
1. Press the ICSNET/Ethernet field in the Master Connection section until the option cycles to
Ethernet.
2. Press the Mode field until the option cycles to NDP (UDP).
3. Press the on-screen Reboot button to both save any changes and restart the TPI-PRO.
4. Open a web browser on a PC that has access to the Master to which you want to connect, type the IP
address of the Master in the Address bar, and press Enter. The Master Configuration Manager page
for the Master opens.
5. Click System on the Master Configuration Manager page.
6. Click Manage NetLinx on the System page.
7. Locate the TPI-PRO you want to connect to the Master, and click Bind. The Bind button is located
on the same line as the TPI-PRO. The Master refreshes and shows that the TPI-PRO is bound to it.
The TPI-PRO remains bound to the Master and will connect to it whenever you reboot the TPIPRO.
If the TPI-PRO does not appear within the OnLine Tree tab of the Workspace window
of NetLinx Studio, check to make sure that the NetLinx Master System Number (from
the Device Addressing dialog box) is correctly assigned.
TPI-PRO Total Presentation Interface - Pro Edition
In this mode, enter the System Number (zero for an unknown System Number) and the IP/URL of the
Master (Master Port Number is defaulted to 1319).
1. Press the Mode field until the option cycles to URL (UDP). By selecting URL (UDP), the System
Number field becomes read-only (grey) because the panel pulls this value directly from the
communicating target Master.
2. Press the Master IP/URL field to open an on-screen keyboard, and enter the Master IP Address
(obtained from the Diagnostics - Networking Address dialog in the NetLinx Studio application).
3. Click Done to accept the new value and return to the System Configuration page.
4. Do not alter the Master Port Number value. (This is the default value used by NetLinx).
5. Enter a username and password into their respective fields if the target Master has been previously
secured.
6. Press the Back button to open the Protected Setup page.
7. Press the on-screen Reboot button to both save any changes and restart the TPI-PRO.
If the TPI-PRO does not appear within the OnLine Tree tab of the Workspace window
of NetLinx Studio, check to make sure that the NetLinx Master System Number (from
the Device Addressing dialog box) is correctly assigned.
Using G4 Web Control® to Interact with a G4 Panel
The G4 Web Control feature allows you to use a PC to interact with a G4 enabled device via the web.
This feature works in tandem with the new browser-capable NetLinx Security firmware update (build
300 or higher). G4 Web Control is only available with the latest TPI-PRO firmware.
Refer to the G4 Web Control Page section on page 61 for more detailed information.
Verify your NetLinx Master (ME260/64 or NI-Series) has been installed with the latest
firmware KIT file from www.amx.com. Refer to your NetLinx Master Instruction
Manual for more detailed information on the use of the new web-based NetLinx
Security.
1. Press the front panel SETUP button to access the Setup page.
2. Press the Protected Setup button (located on the lower-left of the firmware page) to open the
Protected Setup page and display an on-screen keypad.
3. Enter 1988 into the keypad’s password field (1988 is the default password).
Clearing Password #5, from the initial Password Setup page, removes the need for
you to enter the default password before accessing the Protected Setup page.
4. Press Done when finished.
38
TPI-PRO Total Presentation Interface - Pro Edition
Configuring Communication
5. Press the G4 Web Control button to open the G4 Web Control page (FIG. 27).
FIG. 27 G4 Web Control page
6. Press the Enable/Enabled button until it toggles to Enabled (light blue color).
7. The Network Interface Select field is read-only for the TPI-PRO and uses Wired as the default
method of communication to the web.
Wired is used when a direct Ethernet connection is being used for communication to the web.
This is the default setting if either no wireless interface card is detected or if both an Ethernet
and wireless card connection is detected by the panel.
The Wireless option is unavailable within TPI-PRO.
8. Press the Web Control Password field to open the Web Password keyboard.
9. From the Web Password keyboard, enter a unique alpha-numeric string to be assigned as the G4
Authentication session password associated with VNC web access of this TPI-PRO.
10. Press Done after you are finished assigning the alpha-numeric string for the Web Control password.
11. Press the Web Control Port field to open the Web Port Number keypad.
12. Within the keypad, enter a unique numeric value to be assigned to the port the VNC Web Server is
running on. The default value is 5900.
13. Press Done when you are finished entering the value. The remaining fields within the G4 Web
Control Settings section of this page are read-only and cannot be altered.
14. Press the Up/Down arrows on either sides of the G4 Web Control Timeout field to increase or
decrease the amount of time the panel can remain idle (no cursor movements) before the session is
closed and the user is disconnected.
15. Press the Back button to open the Protected Setup page.
16. Press the on-screen Reboot button to save any changes and restart the TPI-PRO.
Verify your NetLinx Master’s IP Address and System Number have been properly
entered into the Master Connection section of the System Connection page.
TPI-PRO Total Presentation Interface - Pro Edition
39
Configuring Communication
Using your NetLinx Master to Control the Unit
Refer to your particular NetLinx Master’s instruction manual for detailed information on how to
download the latest firmware from www.amx.com.
Once the Master’s IP Address has been set through NetLinx Studio (version 2.4 or higher):
1. Launch your web browser.
2. Enter the IP address of the target Master (ex: http://198.198.99.99) into the web browser’s Address
field.
3. Press the Enter key on your keyboard to begin the communication process between the target
Master and your computer.
4. Click OK to enter the information and proceed to the Master’s Manage WebControl Connections
window.
5. You can access the Manage WebControl Connections page (FIG. 28) by clicking on the Manage
connections link (within the Web Control section within the Navigation frame). Once activated, this
page displays links to G4 panels running the latest G4 Web Control feature (previously setup and
activated on the panel).
Initially, the Master Security option is disabled (from within the System Security page) and
no username and password is required for access or configuration.
Both HTTP and HTTPS Ports are enabled by default (via the Manage System > Server
page).
If the Master has been previously configured for secured communication, click OK to accept
the AMX SSL certificate (if SSL is enabled) and then enter a valid username and password
into the fields within the Login dialog.
40
Compatible
G4 panels
Compression
options
FIG. 28 Manage WebControl Connections page (populated with compatible panels)
6. Click Ye s from the Security Alert popup window to agree to the installation of the G4 WebControl
application on your computer. This application contains the necessary Active X and VNC client
applications necessary to properly view and control the unit’s pages from your computer.
TPI-PRO Total Presentation Interface - Pro Edition
Configuring Communication
7. Click on the G4 panel name link associated with the target panel. A secondary web browser window
then appears on the screen (
The G4 Web Control application is sent by the TPI-PRO to the computer that is used
for communication. Once the application is installed, this popup will no longer appear.
This popup will only appear if you are connecting to the target panel using a different
computer.
FIG. 29 Web Control VNC installation and Password entry screens
FIG. 29).
8. In some cases, you might get a Connection Details dialog box (FIG. 30) requesting a VNC Server
IP address. This is not the IP address of the Master, but the IP address of the target touch panel.
Depending on which method of communication you are using, you can find the IP address in the IP
Address field in the Wired Ethernet - System Connection > IP Settings section. If you do not see
this field continue to step 9.
IP Address of touch panel
- obtained from IP Settings section of
the System Connection page
FIG. 30 Connection Details dialog
9. If you setup a WebControl password on the G4 WebControl page, a G4 Authentication Session
password dialog box appears on the screen within the secondary browser window.
10. Enter the Web Control session password into the Session password field (FIG. 29). This password
was previously entered into the Web Control Password field within the G4 Web Control page on the
TPI-PRO.
11. Click OK to send the password to the TPI-PRO and begin the session. A confirmation message
TPI-PRO Total Presentation Interface - Pro Edition
41
Configuring Communication
The secondary window becomes populated with the same G4 page being displayed on the target G4
panel. A small circle appears within the on-screen G4 panel page and corresponds to the location of the
mouse cursor. A left-mouse click on the computer-displayed panel page equates to an actual touch on the
target G4 panel page.
42
TPI-PRO Total Presentation Interface - Pro Edition
Upgrading TPI-PRO Firmware
Before beginning the Upgrade process:
Setup and configure your NetLinx Master. Refer to your particular NetLinx Master instruction
manual for detailed setup procedures.
Select the correct resolution, touch drivers, and calibrate the TPI-PRO. Refer to the
Calibrating the TPI-PRO Using a USB Input section on page 28.
Refer to the NetLinx Studio version 2.4 or higher Help file for more information on uploading
files via Ethernet.
Configure your TPI-PRO for direct communication. Refer to the Configuring
Communication section on page 31 for more detailed information about Ethernet
communication.
The process of updating firmware involves the use of a communicating NetLinx Master. The required
steps for updating firmware to a TPI-PRO are virtually identical to those necessary for updating .kit files
to a NetLinx Master (except the target device is a panel instead of a Master). Refer to either your
Master’s literature or Studio 2.4 Help file for those procedures.
A TPI-PRO which is not using a valid username and password will not be able to
communicate with a secured Master. If you are updating the firmware on a TPI-PRO
which is not using a username or password field, you must first remove the Master
Security feature to establish an unsecured connection.
Upgrading TPI-PRO Firmware
Upgrading the TPI-PRO Firmware through an IP Address
Before beginning with this section, verify that your TPI-PRO unit is powered and connected to the
NetLinx Master through either an Ethernet connection.
Step 1: Prepare the Master for communication through an IP address
1. Obtain the IP Address of the NetLinx Master from your System Administrator, if you do not have
an IP address for the Master, refer to your particular Master’s instruction manual for more
information on obtaining an IP address using NetLinx Studio 2.4 or higher.
From the Online Tree tab of the Workspace window, select the NetLinx Master.
Follow steps outlined in either the Obtaining or Assigning the Master’s IP Address sections
from your NetLinx Master instruction manual to use an address.
Note the IP address and gateway information.
2. Launch NetLinx Studio 2 (default location is Start > Programs > AMX Control Disc > NetLinx
Studio 2 > NetLinx Studio 2).
3. Select Settings > Master Communication Settings from the Main menu to open the Master
Communication Settings dialog box (
FIG. 31).
TPI-PRO Total Presentation Interface - Pro Edition
43
Upgrading TPI-PRO Firmware
FIG. 31 Assigning Communication Settings and TCP/IP Settings
4. Click the Communications Settings button to open the Communications Settings dialog box.
5. Click on the NetLinx Master option button in the Platform Selection section to indicate that you
are working with a NetLinx Master (such as the NXC-ME260/64 or NI-Series of Integrated
Controllers).
6. Click on the Authentication Required option button if the Master is secured, then enter a username
and password.
7. Click on the TCP/IP option button in the Transport Connection Option section to indicate you are
connecting to the Master through an IP address.
8. Click the Edit Settings button in the Communications Settings dialog box to open the TCP/IP
Settings dialog box (
9. In the TCP/IP Settings dialog box, click New to enter the IP information for a new IP address or
select from the list of previously entered IP addresses, and alter their properties by clicking Edit
and making your changes.
10. Enter the IP address into the TCP/IP Address field. This information is obtained from either your
System Administrator or obtained from the Master.
11. Click OK when you are done adding or editing the IP address from the New/Edit TCP/IP Setting
dialog box.
12. Click OK three more times to close the open dialog boxes and save your settings.
13. Click Ye s to interrupt the current communication from the Master and apply the new settings.
14. Select To ol s > Reboot the Master Controller to access the Reboot the Master dialog box, then
click Reboot to reboot the Master and incorporate any changes.
15. When the dialog box replies with "Reboot of system complete", press Done.
16. Click the OnLine Tree tab in the Workspace window to view the devices on the System. The
default System value is one.
17. Right-click the Empty Device Tree/System entry, and select Refresh System to re-populate the
list.
List of previously saved IP addresses
FIG. 31).
44
TPI-PRO Total Presentation Interface - Pro Edition
Upgrading TPI-PRO Firmware
Step 2: Prepare the TPI-PRO for communication via an IP address
1. Press the Mode field until the choice cycles to URL. By selecting URL, the System Number field
becomes read-only (grey) because the panel pulls this value directly from the communicating target
Master (virtual or not). A virtual Master system value can be set within the active AMX software
applications such as: NetLinx Studio, TPD4, or IREdit.
2. Press the blue Master IP/URL field to open a Keyboard and enter the NetLinx Master’s IP Address
(obtained from the Diagnostics - Networking Address dialog box of the NetLinx Studio application).
3. Click Done to accept the new value and return to the System Configuration page.
4. Do not alter the Master Port Number value. This is the default value used by NetLinx.
5. Press the on-screen Reboot button, on the Protected Setup page, to restart the TPI-PRO and save
any changes.
Step 3: Verify and Upgrade the TPI-PRO firmware via an IP address
1. Click the OnLine Tree tab in the Workspace window to view the devices on the System. The default
System value is one.
2. Right-click the associated System number on the Workspace window, and select Refresh System to
detect all devices on the current system, establish a new connection to the Master, and refresh the
System list with devices on the system.
3. After the Communication Verification dialog box verifies active communication between the PC
and the Master, verify the panel appears in the OnLine Tree tab of the Workspace window
FIG. 32). The default TPI-PRO panel value is 10001.
(
Showing Master firmware version
and device number
Showing current firmware version
and device number of the TPI-PRO
The TPI-PRO firmware is shown on the right of the listed unit.
4. If the firmware version is not the latest available, locate the latest firmware file from the
www.amx.com > Tech Center > Download Updates > Firmware Files > TPI-PRO section of the
website.
5. Download the appropriate .kit file to your computer.
6. Verify you have downloaded the latest TPI-PRO firmware (.kit) file to a known location.
TPI-PRO Total Presentation Interface - Pro Edition
45
Upgrading TPI-PRO Firmware
7. Select To ol s > Firmware Transfers > Send to NetLinx Device from the Main menu to open the
Send to NetLinx Device dialog box (
values match those values listed within the System folder in the OnLine Tree tab of the Workspace
window.
FIG. 33). Verify the TPI-PRO’s System and Device number
Selected firmware file
Device number and System number
must match the values
listed in the Workspace window.
FIG. 33 Select to NetLinx Device dialog box (showing TPI-PRO firmware update via IP)
Description field
for selected .kit file
Firmware
download status
8. Select the TPI-PRO’s .kit file from the Files section (FIG. 33).
9. Enter the Device value associated with the TPI-PRO and the System number associated with the
Master (listed in the OnLine Tree tab of the Workspace window). The Port field is greyed-out.
10. Click the Reboot Device checkbox. This causes the TPI-PRO to reboot after the firmware update
process is complete. The reboot of the unit can take up 30 seconds after the firmware process has
finished.
11. Click Send to begin the transfer. The file transfer progress is indicated on the bottom-right of the
dialog box (
FIG. 33).
12. Click Close after the unit reboots to return to the main program.
13. Right-click the associated System number, and select Refresh System. All project systems refresh,
a new connection to the Master is established, and the System list populates with devices on your
system.
46
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
This section describes each G4 firmware page and their specific functional elements. The TPI-PRO is a
G4 device that utilizes specific G4 pages.
Setup Navigation Buttons
The G4 Setup Navigation Buttons (FIG. 34) appear on the left of the panel screen when the Setup page is
currently active.
Firmware Pages and Descriptions
FIG. 34 G4 Setup Navigation Buttons
These Navigation Buttons are specific to the TPI-PRO and include the device specific elements
described in the following table:
G4 Setup Navigation Button Elements
Protected SetupPress the Protected Setup button to access the Protected Setup page section
that provides access to the TPI-PRO’s Web Control, calibration features, and
connection settings.
• Refer to the Protected Setup Page section on page 59 for more detailed
information.
InformationPress the Panel Information button to access the Panel Information page and
view device specific information such as resolution, memory, etc. (read-only).
• Refer to the Panel Information Page section on page 51 for more detailed
information.
TimePress the Time Adjustment button to access the Time Adjustment page where
AudioPress the Audio Adjustment button to access the Volume page where you can
you can alter the time and date settings on the Master.
• Refer to the Time & Date Setting Page section on page 52 for more detailed
information.
alter the audio parameters on the TPI-PRO.
• Refer to the Audio Settings section on page 53 for more detailed information.
TPI-PRO Total Presentation Interface - Pro Edition
47
Firmware Pages and Descriptions
G4 Setup Navigation Button Elements (Cont.)
VideoPress the Video Adjustment button to access the main video page where you
Setup Page
The page (FIG. 35) centers around the basic properties used by the touch device connected to the
TPI-Pro such as: Connection Status of the TPI-PRO, Display Timeout, Inactivity Page Flip Time, and
Inactivity page file information for the TPI-PRO device.
can set the video properties for incoming signal.
• The displayed page is associated to the HD-15 port being used.
• The TPI-PRO-4 can use any combination of up to four (4) source inputs. The
TPI-PRO-2 can use any combination of up to two (2) source inputs.
• Refer to the Video Settings Page section on page 54 for more detailed
information.
Connection Status
Red Connection Status icon -
indicates no connection to
a Master
Green Connection Status icon -
indicates communication
to a Master
Yel low Connection Status icon -
indicates an unreliable
network connection
FIG. 35 Setup page
The elements of the Setup page are described in the table below:
Setup Page Elements
ExitReturns you to the Main touch panel page. In this case, the previous page is the
Connection Status iconThis visual display of the connection status allows the user to have a current
default Main page.
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
48
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
Setup Page Elements (Cont.)
Connection StatusDisplays whether the G4 device is communicating externally, the encryption
status of the communicating Master, what connection type is being used
(Ethernet), and of which System the unit is a part.
This visual display of the connection status is also reflected at the upper-right of
each firmware page. This allows the user to have a current visual update of the
panel’s connection status regardless of what page is currently active.
• The message displayed is ’Connected via Ethernet’.
• If no connection can be established by the TPI-PRO, it will continue to try and
establish a connection while displaying: "Attempting via ....".
• The word "Encrypted" appears only when an encrypted connection is
established with a target Master.
• The G4 device must be rebooted before incorporating any panel
communication changes and detecting any active Ethernet connections.
The Ethernet connection is not detected until after a reboot.
Display/Panel TimeoutSets the length of time the TPI-PRO can remain idle before activating the sleep
mode. When the device goes into sleep mode, the LCD is powered-down.
• Press the UP/DN buttons to increase/decrease the time until the TPI-PRO
times out. Range = 0 - 240 minutes.
• Use this button to set the timeout value to zero and disable the sleep mode.
Inactivity Page Flip
Timeout
Sets the number of minutes of inactivity before the G4 device automatically flips
to a pre-selected touch panel page. When the device goes into this inactivity
mode, the LCD does not power-down.
• Press the UP/DN buttons to increase/decrease the time the panel can remain
inactive before it flips to the preset page. Range = 0 - 240 minutes.
• Use this button to set the timeout value to zero and disable the inactivity page
flip mode.
• The touch panel page used for the Inactivity page flip is shown within a small
Inactivity Page field.
TPI-PRO Total Presentation Interface - Pro Edition
49
Firmware Pages and Descriptions
Project Information Page
The Project Information page displays the TPDesign4 (TPD4) project file properties currently loaded on
the selected TPI-PRO (
more specific information on uploading TPDesign4 files to a panel.
FIG. 36 Project Information page
The elements of the Project Information page are described in the table below:
FIG. 36). Refer to the TPDesign4 Touch Panel Program instruction manual for
Sample TPD4 Project Properties dialog box
Project Information Page Elements
BackReturns you to the previously active touch panel page.
Connection Status iconThis visual display of the connection status allows the user to have a current
File NameDisplays the name of the TPDesign4 project file downloaded to the TPI-PRO.
Designer IDDisplays the designer information.
File RevisionDisplays the revision number of the file.
Dealer IDDisplays the dealer ID number (unique to every dealer and entered in TPD4).
Job NameDisplays the job name.
Sales OrderDisplays the sales order information.
Purchase OrderDisplays the purchase order information.
Build NumberDisplays the build number information of the TPD4 software used to create the
Creation DateDisplays the project creation date.
Revision DateDisplays the last revision date for the project.
Last Save DateDisplays the last date the project was saved.
Blink RateDisplays the feedback blink rate (10th of second).
Job CommentsDisplays any comments associated to the job. These comments are taken from
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
project file.
the TPD4 project file.
50
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
Panel Information Page
The Panel Information page (FIG. 37) centers around TPI-PRO properties such as resolution used,
on-board memory, firmware, address/channel information, and string information.
This information is retrieved from
the TPI-PRO unit
FIG. 37 Panel Information page (takes its information from the TPI-PRO device)
The elements of the Panel Information page are described in the table below:
Panel Information Page Elements
BackReturns you to the previously active touch panel page.
Connection Status iconThis visual display of the connection status allows the user to have a current
Panel TypeDisplays the type of G4 device being used.
Firmware VersionDisplays the G4 firmware version being used by the G4 device.
Setup PortDisplays the setup port information/value being used by the TPI-PRO.
High PortDisplays the high port (port count) value for the TPI-PRO.
High AddressDisplays the high address (address count) value for the TPI-PRO.
High ChannelDisplays the high channel (channel count) value for the TPI-PRO.
High LevelDisplays the high level (level count) value being used by the TPI-PRO.
Serial NumberDisplays the specific serial number value assigned to the TPI-PRO.
Setup Pages VersionDisplays the type and version of the Setup pages being used by the TPI-PRO.
Touch Input DriverDisplays the driver used for the touch panel.
Screen WidthDisplays the pixel width being used to display the incoming video signal on the
Screen HeightDisplays the pixel height being used to display the incoming video signal on the
Screen Refresh RateDisplays the video refresh rate applied to the incoming video signal from the G4
Screen RotationDisplays the degree of rotation applied to the on-screen image.
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
• Verify you have the latest version from www.amx.com.
G4 device.
• Maximum available screen width on a TPI-PRO is 1920 pixels.
G4 device.
• Maximum available screen height on a TPI-PRO is 1200 pixels.
device.
TPI-PRO Total Presentation Interface - Pro Edition
51
Firmware Pages and Descriptions
Panel Information Page Elements (Cont.)
Power Up PageDisplays the first touch panel page assigned for display after the device is
Start Up StringDisplays the start-up string.
Wake Up StringDisplays the wake up string used after an activation from a timeout.
Sleep StringDisplays the sleep string used during the device’s sleep mode.
File SystemDisplays the amount of Compact Flash memory available on the TPI-PRO.
RAMDisplays the available RAM (or Extended Memory module) on the TPI-PRO.
Time & Date Setting Page
The Time & Date Settings page (FIG. 38) allows you to alter or set the time and date information on the
NetLinx Master. If either the time or date is modified on this page and then updated to the Master by
pressing the Set Time button, all devices communicating to that target Master are updated to reflect the
new information.
powered-up.
• This information is taken from the TPD4 project file.
• Most projects begin with a Main page.
FIG. 38 Time and Date Settings page (takes its information from the TPI-PRO device)
The only way to modify a TPI-PRO’s time, without altering the Master, is to use
NetLinx Code.
The elements of the Time & Date Setup page are described in the table below:
Time & Date Settings Page Elements
BackReturns you to the previously active touch panel page without saving changes.
(To save changes, use the Set Time button.)
Connection Status iconThis visual display of the connection status allows the user to have a current
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
Time Date Refresh/SetThis section provides you with two options:
• The Get Time/Date button retrieves the Time and Date information from the
Master.
• The Set Time/Date button sets the Master to retain and save any time or date
modifications made on the Time and Date Setup page.
52
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
Time & Date Setup Page Elements (Cont.)
Time Display fieldsThese fields display the time in three formats: STANDARD, STANDARD
AM/PM, and 24 HOUR.
Date Display fieldsThese fields display the calendar date information in several different formats.
Set Date/TimeThis section provides a user with both UP/DN arrow buttons to alter the
Master’s calendar date and time. The blue circle indicates which field is
currently selected.
• Select the Year field and use the UP/DN buttons to alter the year value
(range = 2000 - 2037).
• Select the Month field and use the UP/DN buttons to alter the month value
(range = 1 - 12).
• Select the Day field and use the UP/DN buttons to alter the day value
(range = 1 - 31).
• Select the Hour field and use the UP/DN buttons to alter the hour value
(24-hour military).
• Select the Minute field and use the UP/DN buttons to alter the minute value
(range = 0 - 59).
• Select the Second field and use the UP/DN buttons to alter the second value
(range = 0 - 59).
The TPI-PRO does not have an on-board clock. This page both receives and sets the
time/date of the NetLinx Master.
Audio Settings
The Audio Settings page (FIG. 39) (accessed by pressing the Audio button on the Setup page) allows
you to adjust the master volume parameters and default panel sounds on the TPI-PRO.
FIG. 39 Volume configuration page
The elements of the Audio Settings page are described in the table below:
Audio Settings Page Elements
BackSaves the changes and returns you to the previously active touch panel page.
Connection Status iconThis visual display of the connection status allows the user to have a current
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
TPI-PRO Total Presentation Interface - Pro Edition
53
Firmware Pages and Descriptions
Audio Settings Page Elements (Cont.)
Master VolumeThis section allows you to adjust the current sound level on the unit’s internal
Default Panel SoundsSets the unit to play either the default Button Hit sound (when you touch an
Supported sampling rates for WAV
The following is a listing of supported sampling rates associated for WAV files played on this G4 unit.
Some WAV files currently played on other devices may not work on this unit. The supported sampling
rates for WAV files are:
Supported WAV Sampling Rates
• 48000 Hz• 16000 Hz
• 44100 Hz• 12000 Hz
• 32000 Hz• 11025 Hz
• 24000 Hz• 8000 Hz
• 22050 Hz
speaker:
• Use the UP/DN buttons to adjust the volume output on the internal speakers
(range = 0 - 100).
• The Internal Sound Level bargraph indicates the current sound level.
• The Mute button mutes the volume.
• The Play Test button plays a test WAV/MP3 file over the internal speakers.
active button) and/or the default Button Miss sound (when you touch a
non-active button or any area outside of the active button).
Protected Setup Page
This button opens the Protected Setup page which centers around the properties used by the panel to
properly communicate with the NetLinx Master. Refer to the
Protected Setup Navigation Buttons section
on page 58 for more detailed information.
Video Settings Page
The Video Settings page (FIG. 40) sets the Video properties of the incoming video signal. You can
access this page by pressing the Video button on the Setup page. This page contains four tabs across the
top for each source input on the unit. If you are using a TPI-PRO-2, slots 3 and 4 appear greyed out.
These source inputs are labeled at the rear of the unit. For each source input, you must manually set the
Input type. The TPI-PRO does not detect the type of connection for you. You can choose from
Composite, S-Video, Computer (VGA), and Component (YPrPb).
These video settings may
change depending on the
source input type.
Incoming video signal
When finished making your
screen adjustment, click Save Settings.
54
FIG. 40 Video Adjustment page (showing default values)
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
The elements of the Video Settings page are described in the table below:
Video Settings Page Elements
BackSaves the changes and returns you to the previously active touch panel page.
Connection Status iconThis visual display of the connection status allows the user to have a current
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
InputAllows you to cycle through a choice of available video inputs (Composite 1,
Composite 2, Composite 3, S-Video, Computer (VGA), and Component
(YPrPb)).
Default = Composite 1
StatusDisplays whether a video-sync signal is detected.
VersionDisplays the firmware version currently used by the TPI-PRO.
Auto AdjustThe Auto Adjust button toggles between auto detection and manual setup. It is
only valid on VGA and Component Input signals..
Default = Auto
Black & WhiteThe Black & White button toggles the Black & White display mode. It is only
valid on Composite and S-Video inputs.
Default = Off
BrightnessUse the UP/DN buttons to alter the brightness level of the incoming signal. This
option does not appear if you select Computer (VGA) as the input type or
progressive scan component input signals.
• Range = 0 - 255, default = 128
ContrastUse the UP/DN buttons to alter the contrast level of the incoming signal. This
option does not appear if you select Computer (VGA) as the input type or
progressive scan component input signals.
• Range = 0 - 255, default = 128
SaturationUse the UP/DN buttons to alter the color saturation level of the incoming signal.
This option does not appear if you select Computer (VGA) as the input type or
progressive scan component input signals.
• Range = 0 - 255, default = 128
HueUse the UP/DN buttons to alter the hue level of the incoming signal. This option
does not appear if you select Computer (VGA) as the input type or progressive
scan component input signals.
• Range = 0 - 255, default = 128
PhaseUse the UP/DN buttons to alter the phase level of the incoming signal. This
option only appears if you select Computer (VGA) or Component (YPrPb) as
the input type.
• Range = 0 - 255, default = 128
H PositionUse the UP/DN buttons to alter the horizontal position of the incoming signal.
This option only appears if you select Computer (VGA) or Component (YPrPb)
as the input type.
Range = 0 - 255, default = 128
H SizeUse the UP/DN buttons to alter the horizontal size of the incoming signal. This
option only appears if you select Computer (VGA) or Component (YPrPb) as
the input type.
Range = 0 - 255, default = 128
V PositionUse the UP/DN buttons to alter the vertical position of the incoming signal. This
option only appears if you select Computer (VGA) or Component (YPrPb) as
the input type.
Range = 0 - 255, default = 128
Default SettingsThe Default Settings button sets the video settings to their default values (indi-
cated in this table).
TPI-PRO Total Presentation Interface - Pro Edition
55
Firmware Pages and Descriptions
Video Settings Page Elements (Cont.)
Undo ChangesThe Undo Changes button disregards any changes made on the page since
Save SettingsThe Save Settings button saves any changes made to this page.
Video Settings - RGB Adjustment Page
The RGB Adjustment page (FIG. 41) sets the RGB properties of the incoming signal. You can access
this page by pressing the incoming signal area on the Video Adjustment page as long as an RGB signal is
currently displaying.
the last settings were saved.
Firmware version
Output resolution
Incoming video signal
FIG. 41 RGB Adjustment page
The elements of the RGB Adjustment page are described in the table below:
RGB Adjustment Page Elements
BackSaves the changes and returns you to the previously active touch panel page.
Connection Status iconThis visual display of the connection status allows the user to have a current
Default SettingsThe Default Settings button sets the video settings to their default values
Undo ChangesThe Undo Changes button disregards any changes made on the page since
Save SettingsThe Save Settings button saves any changes made to this page.
Sync on GreenThe Sync on Green button sets the source port to search for the signal on
VersionDisplays the firmware version currently used by the TPI-PRO.
StatusDisplays whether a video-sync signal is detected.
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
(indicated in this table).
the last settings were saved.
Green signal.
56
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
Adjusting the Incoming Image on the Video Adjustment Page
After opening the Video Adjustment page, you can select any of the available source inputs by selecting
the corresponding tab at the top of the screen. If the selected source input is receiving an image, this
image is displayed in the incoming signal area. You can adjust the incoming image by using the video
setting on the right side of the screen.
Perform the following steps to adjust these settings:
1. Press the appropriate Slot tab on the Video Adjustments page.
One of the first things to look at when trying to adjust your RGB image, is the Phase
value. Adjustments to this value can help troubleshoot most image issues.
2. Press the Input button to select the source input type for this slot. If you select Computer (VGA) or
Component (YPrPb) as the input type, proceed to
The incoming TPI-PRO image must be first be adjusted (especially if using a CRT
monitor) to fit into the visible screen area. Refer to the
Setup section on page 25 for more detailed information on adjusting the position and
size on a CRT monitor. When using a touch panel, the TOUCH DRIVER selected
should compensate for the visible area, if not, continue with these steps.
step 3. Otherwise, skip to step 7.
TPI-PRO and Panel Interface
3. Use the UP/DN Phase buttons to alter the RGB tracking/signal level of the incoming image/video.
These values cycle back thru 0 and on after reaching 31.
4. Use the UP/DN H Position buttons to adjust the horizontal location and move the image (left-right)
on the screen. These values cycle back thru 0 and on after reaching 255.
5. Use the UP/DN H Size buttons to adjust the horizontal height and stretch the image on the screen.
These values cycle back thru 0 and on after reaching 255.
6. Use the UP/DN V Position buttons to adjust the vertical location and move the image (up-down) on
the screen. These values cycle back thru 0 and on after reaching 255. If you selected
Computer (VGA) in step 2, skip to step 11.
7. Use the UP/DN Brightness buttons to adjust either the overall or individual Red, Green, and Blue
brightness of the incoming image/video.
8. Use the UP/DN Contrast buttons to adjust the overall or individual Red, Green, and Blue contrast
of the incoming image/video. Increasing the value can increase the sharpness of the image.
9. Use the UP/DN Saturation buttons to adjust the overall or individual Red, Green, and Blue
saturation of the incoming image/video. Increasing the value can increase the brightness of the
colors in the image.
10. Use the UP/DN Hue buttons to adjust the overall or individual Red, Green, and Blue hue of the
incoming image/video.
11. Press the Save Settings button to save your changes for the source input. Cycling power to the panel
before saving your settings can cause your pages to shift back to their original locations.
12. Press the Back button to return to the Setup page.
TPI-PRO Total Presentation Interface - Pro Edition
57
Firmware Pages and Descriptions
Protected Setup Navigation Buttons
The Protected Setup Navigation Buttons (FIG. 42) appear on the left of the screen when the Protected
Setup page is currently active.
FIG. 42 G4 Protected Setup Navigation Buttons
These Navigation Buttons are specific to the TPI-PRO device and include the device specific elements
described in the following table:
G4 Protected Setup Navigation Button Elements
System SettingsPress the System Connection button to access the System Settings page
CalibratePress the Calibrate button to access the Calibration page where you can use
G4 Web ControlPress the G4 Web Control button to access the G4 Web Control page where
Other SettingsPress the Other Settings button to open a slide bar with the following options:
Too lsPress the Tools button to open a slide bar with the following options:
where you can alter the communication parameters of both the NetLinx Master
and TPI-PRO.
• Refer to the System Settings Page section on page 64 for more detailed
information.
the displayed set of crosshairs to calibrate a touch screen/panel.
• Refer to the Calibration Page section on page 63 for more detailed
information.
you can enable or disable display and control of your panel (via the web) by a
PC running a VNC client.
• Refer to the Using G4 Web Control® to Interact with a G4 Panel section on
page 38 for more detailed information.
• Press the Cache button to open the Cache page where you can adjust your
Flash Cache settings. Refer to the for more detailed information.
• Press the Passwords button to access the Password Setup page where you
can specify up to five security passwords The default password is 1988.
Refer to the
information.
• Press the Panel Logs button to open the Panel Logs page where you can
view your panel’s connection history. Refer to the
on page 68 for more detailed information.
• Press the Panel Statistics button to open the Panel Statistics page where you
can view the connection statistics for your panel. Refer to the
Page section on page 70 for more detailed information.
• Press the Connection Utility button to open the Connection Utility page where
you can view connection statistics and information for your panel. Refer to the
Connection Utility Page section on page 72 for more information.
Password Setup Page section on page 63 for more detailed
Panel Logs Page section
Panel Statistics
58
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
Protected Setup Page
The Protected Setup page (FIG. 43) centers around the properties used by the TPI-PRO to communicate
with the NetLinx Master. Enter the factory default password (1988) into the password keypad to access
this page.
FIG. 43 Protected Setup page
The elements of the Protected Setup page are described in the table below:
Protected Setup Page Elements
BackSaves the changes and returns you to the previously active touch panel page.
Connection Status iconThis visual display of the connection status allows the user to have a current
Device NumberOpens a keypad that is used to set and display the current device number.
OptionsAllows you to select various TPI-PRO features:
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
• The Function Show button enables the display of the channel port and
channel code in the top left corner of the button, the level port and level code
in the bottom left corner, and the address port and address code in the
bottom right corner (see
• Use the Page Tracking button to toggle page tracking. When enabled, the
TPI-PRO sends page data back to the NetLinx Master, or vice versa
depending on the touch panel settings.
• Use the Tel net button to enable or disable the telnet server on the TPI-PRO.
This feature focuses on direct telnet communication to the TPI-PRO.
FIG. 45 for an example of the function locations).
TPI-PRO Total Presentation Interface - Pro Edition
59
Firmware Pages and Descriptions
Protected Setup Page Elements (Cont.)
System RecoveryAllows you to either reset the TPI-PRO to factory default settings and/or wipe
RebootPressing this on-screen button causes the TPI-PRO to restart after saving any
Keyboard LayoutUse the Keyboard Layout UP/DN buttons to select the type of keyboard you
Serial Port Baud RateUse the Baud Rate UP/DN buttons to alter the baud rate for the front serial port.
out all existing touch panel pages:
• The Reset System Settings button allows a user to wipe out all current
configuration parameters on the TPI-PRO (such as IP Addresses, Device
Number assignments, Passwords, and other presets).
- Pressing this button launches a confirmation dialog box (FIG. 44) which
asks you to confirm your selection.
- This dialog box is configured with a delay timer that does not enable the
YES button for 5 seconds. This delay provides an additional amount of time
for the user to confirm his decision.
• The Remove User Pages button allows you remove all current TPD4 touch
panel pages currently on the TPI-PRO (including the pre-installed AMX Demo pages).
- Pressing this button launches a Confirmation dialog box (FIG. 44) which
asks you to confirm your selection.
- This dialog box is configured with a delay timer that does not enable the
YES button for 5 seconds. This delay provides an additional amount of time
for the user to confirm their decision.
TPI-PRO Total Presentation Interface - Pro Edition
You have a wait time of 5 seconds
before the YES option is enabled.
Channel Code
Number
7,10
Slider
4,9
Number
Address
Por t
1,8
Address Code
Number
Firmware Pages and Descriptions
G4 Web Control Page
The G4 Web Control page (FIG. 46) centers around enabling and disabling both the display and control
of your TPI-PRO (via the web). An external PC running a VNC client (installed during the initial communication to the G4 device) makes this possible.
FIG. 46 G4 Web Control page
Each G4 device supports the open standard Virtual Network Computing (VNC) interface. This device
contains a VNC server which allows it to accept a connection from any other device running a VNC
client. Once a connection is established to that target device, the client can control the TPI-PRO
remotely. The elements of the G4 Web Control page are described in the table below:
G4 Web Control Page Elements
BackSaves the changes and returns you to the previously active touch panel page.
Connection Status iconThis visual display of the connection status allows the user to have a current
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
TPI-PRO Total Presentation Interface - Pro Edition
61
Firmware Pages and Descriptions
G4 Web Control Page Elements (Cont.)
G4 Web Control SettingsSets the IP communication values for the TPI-PRO and contains:
Enable/Enabled• The Enable/Enabled button allows you to toggle between the two G4
Network Interface Select A read-only field that displays the method of communication to web.
Web Control NameThe unique alpha-numeric string that is used as the display name of the
Web Control PasswordAllows you to enter the G4 Authentication session password associated for
Web Control PortAllows you to enter the port value that the VNC Web Server runs on. Default
Max Number of
Connections
Current Connection
Count
G4 Web Control TimeoutSets the length of time (in minutes) the TPI-PRO can remain idle (no cursor
activation settings:
- Enable - deactivates the G4 Web Control feature on the TPI-PRO.
- Enabled - activates the G4 Web Control feature on the TPI-PRO and allows
an external PC running a VNC client to access the unit, after the remaining
fields are configured.
• Wired is selected because it is the only method of communication to the web
(via a direct Ethernet connection). This is a default setting since no wireless
interface is available.
TPI-PRO within the Web Control tab of the new NetLinx Security browser
window. You set the name through the Device Name field on the Protected
Setup Page. This Web Control tab displays a G4 icon alongside the link to the
Web Control Name given to this TPI-PRO.
VNC web access of this TPI-PRO.
value is 5900.
This field displays the maximum number of users that can be simultaneously
connected to the target TPI-PRO via the web. You can set up to 4 connections.
Default value is 1.
This read-only field displays the current number of users connected to the
target TPI-PRO via the web. This value cannot exceed the Maximum number
field.
movements) before the session is closed and the user is disconnected.
• Minimum value = 0 minutes (panel never times-out)
• Maximum value = 240 minutes (panel times-out after 240 minutes/4hours)
Refer to the Using G4 Web Control® to Interact with a G4 Panel section on page 38 for more detailed
instructions on how to use the G4 Web Control page with the new web-based NetLinx Security
application.
62
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
Password Setup Page
The Password Setup page (FIG. 47) centers around the properties used to assign passwords for the panel
pages.
FIG. 47 Password Setup page
The elements of the Password Setup page are described in the table below:
Password Setup Page Elements
BackSaves the changes and returns you to the previously active touch panel page.
Connection Status iconThis visual display of the connection status allows the user to have a current
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
In Panel Password Change Accesses the alphanumeric values associated to particular password sets.
• PASSWORD 1, 2, 3, 4, 5 (protected) buttons open a keyboard where you can
enter alphanumeric values associated to a selected password group.
• Clearing Password #5 removes the need to enter a password before
accessing the Protected Setup page.
Calibration Page
This page (FIG. 48) allows you to calibrate the input touch device (touch panel) using the pre-selected
touch driver.
The request to touch the crosshairs
is the first on-screen message
Calibration successful is the second
on-screen message that appears
after the calibration process is
completed
FIG. 48 Calibration page (actually 3 separate screens)
TPI-PRO Total Presentation Interface - Pro Edition
On-screen crosshairs used for
calibration of the touch device
63
Firmware Pages and Descriptions
t
Press and hold the front panel CALIBRATE button to access the Calibration page.
Press the crosshairs to calibrate the panel and return to the last open firmware page.
System Settings Page
The System Settings page (FIG. 49) sets the DNS Address information with its corresponding IP
communication parameters, NetLinx Master communication settings, and reads the device number
assigned to the G4 device.
IP Settings section
Master Connection section
(NetLinx Master properties)
Master Connection features are no
saved until the panel is rebooted.
Red fields are user-editable
Blue fields cycle through choices
Grey fields are read-only
FIG. 49 System Connection page (showing default values)
The elements of the System Settings page are described in the table below:
System Settings Page Elements
BackSaves the changes and returns you to the previously active touch panel page.
Connection Status iconThis visual display of the connection status allows the user to have a current
update of the TPI-PRO’s connection status regardless of what page is currently
active.
• A Lock only appears on the icon if the TPI-PRO has established a connection
with a currently secured target Master (requiring a username and password).
IP SettingsSets the IP communication values for the TPI-PRO and contains:
DHCP/StaticSets the G4 device to either DHCP or Static communication modes.
• DHCP (Dynamic Host Configuration Protocol) assigns IP Addresses from
client stations logging onto a TCP/IP network via a DHCP server.
• Static IP is a permanent IP Address that is assigned to a node in a TCP/IP
network.
IP AddressSets the IP Address assigned to the TPI-PRO.
Subnet MaskSets a subnetwork address to the TPI-PRO.
• Subnetwork mask is the technique used by the IP protocol to filter messages
into a particular network segment (Subnet).
GatewaySets a gateway value to the TPI-PRO.
• Gateway is a computer that either performs protocol conversion between
different types of networks/applications or acts as a go-between two or more
networks that use the same protocols.
Host NameSets the host name of the TPI-PRO.
64
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
System Settings Page Elements (Cont.)
IP Settings (Cont.)
Primary DNSSets the address of the primary DNS server being used by the TPI-PRO for
Secondary DNSSets the secondary DNS value to the TPI-PRO.
DomainSets the unique name on the Internet to the TPI-PRO for DNS look-up.
Ethernet ModeSets the speed of the Ethernet connection to the TPI-PRO.
MAC AddressDisplays a read-only field that is factory set by AMX for the built-in Ethernet
Master ConnectionSets the NetLinx Master communication values:
Ethernet TypeSets the NetLinx Master to communicate to the TPI-PRO via Ethernet. Ethernet
TypeCycles between the different connection modes (URL, Listen, Auto, NDP
System NumberAllows you to enter a system number.
Master IP/URLSets the Master IP or URL of the NetLinx Master.
Master Port NumberAllows you to enter the port number used with the NetLinx Master.
Username/PasswordIf the target Master has been previously secured, enter the alpha-numeric string
NDP Name
host name lookups.
• DNS (Domain Name System) is software that lets users locate computers on
a local network or the Internet (TCP/IP network) by host and domain. The
DNS server maintains a database of host names for its’ domain and their
corresponding IP Addresses.
• The TPI-PRO belongs to the DNS domain.
• Choices are: Auto, 10 Half Duplex, 10 Full Duplex, 100 Half Duplex, or 100 Full Duplex.
interface.
uses a CAT-5 cable (10/100Base T terminated in an RJ-45 connector) to
network computers together and is used in most LAN (local area networks).
This description is also used to refer to both wired and wireless communication.
(UDP), and URL (UDP))
• URL - In this mode, enter the IP/URL, Master Port Number, and
username/password (if used) on the Master.
- The System Number field is read-only because the TPI-PRO obtains this
information from the communicating Master.
• Listen - In this mode, add the TPI-PRO address into the URL List in NetLinx
Studio and set the connection mode to Listen. This mode allows the TPI-PRO
to "listen" for the Master’s communication signals.
- The System Number and Master IP/URL fields are read-only.
• Auto - In this mode, enter the System Number and a username/password (if
applicable). This mode is used when both the TPI-PRO and the NetLinx
Master are on the same Subnet and the Master has its UDP feature enabled.
- Master IP/URL field is read-only.
• NDP (UDP) - In this mode, enter the IP/URL, Master Port Number, and
username/password (if used) on the Master.
• URL (UDP) - In this mode, enter the IP/URL, Master Port Number, and
username/password (if used) on the Master.
• Default value is 0 (zero).
• Default value is 1319.
(into each field) assigned to a pre-configured user profile on the Master. This
profile should have the pre-defined level of access/configuration rights.
Refer to the Step 2: Choosing a Master Connection Mode Setting section on page 34 and Step 3:
Configuring the Ethernet Connection Type section on page 34 for more detailed information on using the
System Settings page.
TPI-PRO Total Presentation Interface - Pro Edition
65
Firmware Pages and Descriptions
Cache Page
The Cache page (FIG. 50) configures the allocation of memory for image caching. The G4 graphics
engine caches images to decrease load time of previously viewed images. RAM caching is always
enabled, and images (both static and dynamic) are stored in the RAM cache as they are viewed. The size
of RAM cache is automatically configured to take into account available memory versus memory that
may be needed by the panel later. As the RAM cache approaches its maximum size, the oldest items in
the cache may be discarded to make room for newer items. If Flash caching is enabled, dynamic images
that would have been discarded will be moved to Flash, since it is typically faster to retrieve images on
Flash than across a network (although it is slower than RAM cache). Note that since static images are
already stored on Flash, they are never moved to the Flash cache, so Flash caching applies only to
dynamic images. Images in Flash cache are moved back to RAM cache the next time they are viewed. As
the Flash cache approaches its maximum size, the least recently used items may be discarded to make
room for new items.
Flash memory can be allocated for image caching, but RAM cache is always enabled. Flash memory is a
secondary cache and is much slower than RAM cache, as it uses Compact Flash to store images. Flash
memory should not be used frequently, but it may be appropriate to use Flash memory in some
environments that are dynamic image intensive, at times when RAM cache is easily exhausted and the
time taken to access Flash memory would be faster than network latency. For example, when large
dynamic images are being used over slow wireless links, putting the images into Flash memory can help
the situation, as the panel could spend more resources processing information rather than continuously
waiting on images to arrive from a slow network.
66
FIG. 50 Cache page
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
The elements of the Cache page are described in the following table:
Image Caching Page Elements
BackSaves all changes and returns to the previous page.
Connection Status iconThe icon in the upper-right corner of each Setup page shows online/offline state
of the panel to the master.
• Bright red - disconnected
• Bright green - connected. Blinks when a blink message is received to dark
green every 5 seconds for half a second then go back to bright green.
• Bright yellow - panel missed a blink message from the master. It will remain
yellow for 3 missed blink messages and then turn red. It will return to green
when a blink message is received.
Note: A Lock appears on the icon if the panel is connected to a secured
NetLinx Master.
Image Cache SettingsAllocates Flash memory for image caching.
Flash Cache SizePress the Up and Down arrows to add and remove memory. Flash memory
Flash/RAM Cache
Expires
EnablePress this button to toggle the image Flash cache option On and Off.
Clear CachePress this button to clear both the Flash and RAM cache of all stored images.
Image Cache StatusThe status of the memory available versus in use.
RAM Max SizeThe maximum amount of memory available for all image caching.
RAM Current SizeThe memory that is currently in use for caching static and dynamic images.
RAM Hit RateThe percentage of image requests (static and dynamic) satisfied by accessing
Items in Cache (RAM)The number of images that are currently stored in the RAM cache.
Flash Current SizeThe maximum flash space allocated for image caching. Flash space is used for
Flash Hit RateThe percentage of image requests (dynamic only) that are satisfied by
Items in Cache (Flash)The number of images that are currently stored in the Flash cache.
allocation cannot exceed the amount of Flash memory on the panel.
Press the Up and Down arrows to change the amount of time the images stay
in cache memory. The options are:
•Never
• 2 Hours
• 8 Hours
•1 Day
•2 Days
•5 Days
the cache.
100 * (# of cache hits) / (# of cache hits + # of cache misses)
# of cache hits - the number of times an image was requested that the image
was found in the cache. If your hit rate is low, you may want to consider
enabling Flash cache.
# of cache misses - the number of times an image was requested that the
image could not be found in the cache, and the image had to either be loaded
from flash or obtained via the network (for dynamic images). It is considered a
RAM Cache Miss even if the image is subsequently found in flash cache.
caching only when there is not enough available memory in the RAM cache for
a newly requested image (it is used only for dynamic images).
accessing the flash cache.
100 * (# of flash cache hits) / (# of flash cache hits + # of flash cache misses)
# of flash cache hits - # of times a dynamic image could not be found in RAM
cache but was found in flash cache
# of flash cache misses - # of times a dynamic image could not be found in
either RAM or flash cache. RAM cache hits are not relevant in this calculation.
TPI-PRO Total Presentation Interface - Pro Edition
67
Firmware Pages and Descriptions
Setting the image cache
In the Protected Setup page:
1. Press the Other Settings button to open an options slide bar.
2. Press the Cache button in the slide bar. The Cache page opens.
3. Set the cache expiration in the field Flash/RAM Cache Expires. The Up and Down arrows increment
through the available time frames.
4. Press the Enable button to turn on image caching. The button appears illuminated when enabled.
Select the Up and Down arrows for the field Flash Cache Size to increase or reduce the amount of Flash
memory used; the maximum amount of flash that can be allocated for caching is 75% of available flash.
Clearing the image cache
In the Protected Setup page:
1. Press the Other Settings button to open an options slide bar.
2. Press the Cache button in the slide bar. The Cache page opens.
3. Press Clear Cache. This clears all image cache currently stored on the panel (both Flash and
RAM).
Checking image cache status
In the Protected Setup page:
1. Press the Other Settings button to open an options slide bar.
2. Press the Cache button in the slide bar. The Cache page opens. All status information is located in
the Image Cache Status section of the page.
Panel Logs Page
The Panel Logs page allow you to view and track the connection history of the panel.
FIG. 51 Panel Logs page
68
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
The elements of the Panel Logs page are described in the following table:
Panel Logs Page
BackSaves all changes and returns to the previous page.
Connection Status iconThe icon in the upper-right corner of each Setup page shows online/offline state
of the panel to the master.
• Bright red - disconnected
• Bright green - connected. Blinks when a blink message is received to dark
green every 5 seconds for half a second then go back to bright green.
• Bright yellow - panel missed a blink message from the master. It will remain
yellow for 3 missed blink messages and then turn red. It will return to green
when a blink message is received.
Note: A Lock appears on the icon if the panel is connected to a secured
NetLinx Master.
Connection LogsA history of all connections, attempts, and failures for the panel.
ClearClears the Connection Logs history.
RefreshRefreshes the Connection Logs history.
PageIndicates the current page of the Connection Logs.
Use the Up and Down arrows to move from one page to the next.
Checking the Panel Connection Logs
1. Press the Tools button in the Protected Setup Navigation Buttons section. This opens the Too l s
menu.
2. Within the Too l s menu, press the Panel Logs button. All connection data is contained in the section
Connection Logs.
Refreshing the Panel Connections Log
1. Press the Tools button in the Protected Setup Navigation Buttons section. This opens the Too l s
menu.
2. Within the Too l s menu, press the Panel Logs button.
3. Push the Refresh button.
Clearing the Panel Connections Log
1. Press the Tools button in the Protected Setup Navigation Buttons section. This opens the Too l s
menu.
2. Within the Too l s menu, press the Panel Logs button.
3. Push the Clear button.
4. Confirm your selection.
TPI-PRO Total Presentation Interface - Pro Edition
69
Firmware Pages and Descriptions
Panel Statistics Page
The options on the Panel Statistics page allow you to track the connection status for the panel. The Pa nel
Statistics page tracks ICSP messages, Blink messages, Ethernet connection statistics, and Wireless
connection statistics (
FIG. 52 Panel Statistics page
The elements of the Panel Statistics page are described in the following table:
Panel Statistics Page
BackSaves all changes and returns to the previous page.
Connection Status icon The icon in the upper-right corner of each Setup page shows online/offline state of
ICSP MessagesMessages sent between the master and the touch panel; it is the protocol they use
Total• Received - The total ICSP messages received by the panel.
Last 15 Minutes• Received - The total ICSP messages received by the panel in the last 15
Blink MessagesThe master sends this message once every 5 seconds to all connected devices.
Total• Received - The total Blink messages received by the panel.
Last 15 Minutes• Received - The total Blink messages received by the panel in the last 15 minutes.
Ethernet StatisticsThe Ethernet connection statistics for the panel.
ClearClears all panel connection statistics.
RefreshRefreshes all panel connection statistics.
FIG. 52).
the panel to the master.
• Bright red - disconnected
• Bright green - connected. Blinks when a blink message is received to dark green
every 5 seconds for half a second then go back to bright green.
• Bright yellow - panel missed a blink message from the master. It will remain
yellow for 3 missed blink messages and then turn red. It will return to green
when a blink message is received.
Note: a Lock appears on the icon if the panel is connected to a secured NetLinx
Master.
to communicate to each other.
• Processed - The total ICSP messages processed by the panel.
• Dropped - The total ICSP messages dropped by the panel.
minutes.
• Processed - The total ICSP messages processed by the panel in the last 15
minutes.
• Dropped - The total ICSP messages dropped by the panel in the last 15 minutes.
• Missed - The total Blink messages missed by the panel.
• Missed - The total Blink messages missed by the panel in the last 15 minutes.
70
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
Checking the Panel Statistics
1. Press the Tools button in the Protected Setup Navigation Buttons section. This opens the Too l s
menu.
2. Within the Too l s menu, press the Panel Statistics button. All connection statistics are contained on
this page, e.g., Received, Processed, and Dropped ICSP Messages.
Refreshing the Panel Statistics
1. Press the Tools button in the Protected Setup Navigation Buttons section. This opens the Too l s
menu.
2. Within the Too l s menu, press the Panel Statistics button.
3. Push the Refresh button.
Clearing the Panel Statistics
1. Press the Tools button in the Protected Setup Navigation Buttons section. This opens the Too l s
menu.
2. Within the Too l s menu, press the Panel Statistics button.
3. Push the Clear button.
4. Confirm your selection.
TPI-PRO Total Presentation Interface - Pro Edition
71
Firmware Pages and Descriptions
Connection Utility Page
The options on the Connection Utility page allows you to view query and response statistics for your
connection.
FIG. 53 Connection Utility page
The elements of the Connection Utility page are described in the following table:
Connection Utility Page
CloseSaves all changes and returns to the previous page.
Connection Status icon The icon in the upper-right corner of each Setup page shows online/offline state of
Connection Information
Master IPDisplays the IP address of the network’s Master.
Panel IPDisplays the IP address of the touch panel.
Wireless Information
WAP MACThe MAC Address for the WAP currently in use.
SSIDDisplays the currently used SSID of the target WAP.
ChannelThe RF channel being used for connection to the WAP (read-only).
Data RateThe data rate (in Mbps) at which the panel is currently communicating with the
Link QualityDisplays the quality of the link from the wireless NIC to the Wireless Access Point
the panel to the master.
• Bright red - disconnected
• Bright green - connected. Blinks when a blink message is received to dark green
every 5 seconds for half a second then go back to bright green.
• Bright yellow - panel missed a blink message from the master. It will remain
yellow for 3 missed blink messages and then turn red. It will return to green
when a blink message is received.
Note: A Lock appears on the icon if the panel is connected to a secured NetLinx
Master.
If the MAC Address changes, it means the panel has switched/roamed to a
different access point. This can be used to determine coverage for each access
point and help isolate "brown" areas where coverage is minimal or non-existent,
and thus require another access installed.
target WAP.
Note: Data rates for 802.11b communication are: 1, 2, 5.5, and 11 Mbps.
(direct sequence spread spectrum) in real time (None, Poor, Fair, Good, Very
Good, and Excellent).
• Even when link quality is at its lowest you still have a connection, and the ability
to transmit and receive data, even if at lower speeds.
Note: “Link Quality” and “Signal Strength” are applicable to RF connections only. It
is possible to have an RF signal to a WAP, but be unable to communicate with it
because of either incorrect IP or encryption settings.
72
TPI-PRO Total Presentation Interface - Pro Edition
Firmware Pages and Descriptions
Connection Utility Page (Cont.)
Signal StrengthThis indicator displays a description of the signal strength from the Wireless
Access Point connection in real time (None, Poor, Fair, Good, Very Good, and Excellent).
SNR (Signal Noise Ratio) is a measure of the relative strength of a wireless RF
connection. Given this value and the link quality above, you can determine the
noise level component of the SNR. For example, if signal strength is high but the
link quality is low, then the cause of the link degradation is noise. However, if signal
strength is low and link quality is low the cause would simply be signal strength.
Connection Statistics
Query Messages Sent Displays the number of query messages sent from the panel to the Master.
Responses ReceivedDisplays the number of responses the panel has received from the Master.
Responses MissedDisplays the number of expected responses from the Master that the panel
missed.
Using the Connection Utility
1. Press the Tools button in the Protected Setup Navigation Buttons section. This opens the Tools
menu.
2. Within the Tools menu, press the Connection Utility button. This launches the Connection Utility
page.
3. Move the panel throughout your wireless network, and changes within the utility. The Connection
Information notes the IP of the connected master and the IP of your panel. The Wireless Information
indicates the current wireless connection method for the panel, e.g., the MAC Address for the WAP
currently in use. The Connection Statistics show the current quality of the panel connection.
4. Push Close when you are done using the site survey tool.
TPI-PRO Total Presentation Interface - Pro Edition
73
Firmware Pages and Descriptions
74
TPI-PRO Total Presentation Interface - Pro Edition
Programming
You can program a touch panel using the commands in this section to perform a wide variety of
operations using Send_Commands and variable text commands. Refer to the NetLinx Programming Language instruction manual for complete information.
Verify you are using the latest NetLinx Master firmware. Verify the NetLinx Studio
program being used is version 2.4 or higher and TPD4 is version 2.8 or higher.
• Button States Range: 1 - 256
(0 = All states, for General buttons 1 = Off state and 2 = On state).
• Level Range: 1 - 600 (Default level value 0 - 255, can be set up to 1 - 65535)
• Address port Range: 1 - 100
Button assignments can only be adjusted in TPD4, not on the panels themselves.
You can program the TPI-PRO using the commands described in this section to perform a wide variety
of operations.
A device must first be defined in the NetLinx programming language with values for the Device:
Port: System (in all programming examples - Panel is used in place of these values and represents all
compatible G4 devices).
Page Commands
The following NetLinx Page Commands are supported by the TPI-PRO, and are not case sensitive.
Page Commands
@APG
Add a specific
popup page to a
specified popup
group.
Add the popup page to a group if it does not already exist. If the new popup is added to a
group which has a popup displayed on the current page along with the new pop-up, the
displayed popup will be hidden and the new popup will be displayed.
Syntax:
"'@APG-<popup page name>;<popup group name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
popup group name = 1 - 50 ASCII characters. Name of the popup group.
Example:
SEND_COMMAND Panel,"'@APG-Popup1;Group1'"
Adds the popup page ’Popup1’ to the popup group ’Group1’.
TPI-PRO Total Presentation Interface - Pro Edition
75
Programming
Page Commands (Cont.)
@CPG
Clear all popup
pages from
specified popup
group.
@DPG
Delete a specific
popup page from
specified popup
group if it exists.
@PDR
Set the popup
location reset flag.
@PHE
Set the hide effect
for the specified
popup page to the
named hide effect.
@PHP
Set the hide effect
position.
Syntax:
"'@CPG-<popup group>'"
Variable:
popup group = 1 - 50 ASCII characters. Name of the popup group.
Example:
SEND_COMMAND Panel,"'@CPG-Group1'"
Clears all popup pages from the popup group ’Group1’.
Syntax:
"'@DPG-<popup page name>;<popup group name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
popup group name = 1 - 50 ASCII characters. Name of the popup group.
Example:
SEND_COMMAND Panel,"'@DPG-Popup1;Group1'"
Deletes the popup page ’Popup1’ from the popup group ’Group1’.
If the flag is set, the popup will return to its default location on show instead of its last drag
location.
Syntax:
"'@PDR-<popup page name>;<reset flag>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
reset flag = 1 = Enable reset flag
0 = Disable reset flag
Example:
SEND_COMMAND Panel,"'@PDR-Popup1;1'"
Popup1 will return to its default location when turned On.
Syntax:
"'@PHE-<popup page name>;<hide effect name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
hide effect name = Refers to the popup effect names being used.
Example:
SEND_COMMAND Panel,"'@PHE-Popup1;Slide Left'"
Sets the Popup1 hide effect name to ’Slide Left’.
Only 1 coordinate is ever needed for an effect, however, the command will specify both.
This command sets the location at which the effect will end at.
popup page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
Example:
SEND_COMMAND Panel,"'@PHP-Popup1;75,0'"
Sets the Popup1 hide effect x-coordinate value to 75 and the y-coordinate value to 0.
76
TPI-PRO Total Presentation Interface - Pro Edition
Page Commands (Cont.)
@PHT
Set the hide effect
time for the
specified popup
page.
@PPA
Close all popups
on a specified
page.
@PPF
Deactivate a
specific popup
page on either a
specified page or
the current page.
@PPG
Toggle a specific
popup page on
either a specified
page or the
current page.
Syntax:
"'@PHT-<popup page name>;<hide effect time>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
hide effect time = Given in 1/10ths of a second.
Example:
SEND_COMMAND Panel,"'@PHT-Popup1;50'"
Sets the Popup1 hide effect time to 5 seconds.
If the page name is empty, the current page is used. Same as the ’Clear Page’ command
in TPDesign4.
Syntax:
"'@PPA-<page name>'"
Variable:
page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
Example:
SEND_COMMAND Panel,"'@PPA-Page1'"
Close all popups on Page1.
If the page name is empty, the current page is used (see example 2). If the popup page is
part of a group, the whole group is deactivated. This command works in the same way as
the ’Hide Popup’ command in TPDesign4.
Syntax:
"'@PPF-<popup page name>;<page name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
Example:
SEND_COMMAND Panel,"'@PPF-Popup1;Main'"
Deactivates the popup page ’Popup1’ on the Main page.
Example 2:
SEND_COMMAND Panel,"'@PPF-Popup1'"
Deactivates the popup page ’Popup1’ on the current page.
If the page name is empty, the current page is used (see example 2). Toggling refers to the
activating/deactivating (On/Off) of a popup page. This command works in the same way
as the ’Toggle Popup’ command in TPDesign4.
Syntax:
"'@PPG-<popup page name>;<page name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
Example:
SEND_COMMAND Panel,"'@PPG-Popup1;Main'"
Toggles the popup page ’Popup1’ on the ’Main’ page from one state to another (On/Off).
Example 2:
SEND_COMMAND Panel,"'@PPG-Popup1'"
Toggles the popup page ’Popup1’ on the current page from one state to another (On/Off).
Programming
TPI-PRO Total Presentation Interface - Pro Edition
77
Programming
Page Commands (Cont.)
@PPK
Kill a specific
popup page from
all pages.
@PPM
Set the modality
of a specific
popup page to
Modal or
NonModal.
@PPN
Activate a specific
popup page to
launch on either a
specified page or
the current page.
Kill refers to the deactivating (Off) of a popup window from all pages. If the pop-up page is
part of a group, the whole group is deactivated. This command works in the same way as
the 'Clear Group' command in TPDesign4.
Syntax:
"'@PPK-<popup page name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
Example:
SEND_COMMAND Panel,"'@PPK-Popup1'"
Kills the popup page ’Popup1’ on all pages.
A Modal popup page, when active, only allows you to use the buttons and features on that
popup page. All other buttons on the panel page are inactivated.
Syntax:
"'@PPM-<popup page name>;<mode>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
mode = NONMODAL converts a previously Modal popup page to a NonModal.
MODAL converts a previously NonModal popup page to Modal.
Example:
SEND_COMMAND Panel,"'@PPM-Popup1;Modal'"
Sets the popup page ’Popup1’ to Modal.
SEND_COMMAND Panel,"'@PPM-Popup1;1'"
Sets the popup page ’Popup1’ to Modal.
If the page name is empty, the current page is used (see example 2). If the popup page is
already on, do not re-draw it. This command works in the same way as the ’Show Popup’
command in TPDesign4.
Syntax:
"'@PPN-<popup page name>;<page name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
Example:
SEND_COMMAND Panel,"'@PPN-Popup1;Main'"
Activates ’Popup1’ on the ’Main’ page.
Example 2:
SEND_COMMAND Panel,"'@PPN-Popup1'"
Activates the popup page ’Popup1’ on the current page.
modal = 1 and non-modal = 0
78
TPI-PRO Total Presentation Interface - Pro Edition
Page Commands (Cont.)
@PPT
Set a specific
popup page to
timeout within a
specified time.
@PPX
Close all popups
on all pages.
@PSE
Set the show
effect for the
specified popup
page to the
named show
effect.
@PSP
Set the show
effect position.
@PST
Set the show
effect time for the
specified popup
page.
If timeout is empty, popup page will clear the timeout.
Syntax:
"'@PPT-<popup page name>;<timeout>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
timeout = Timeout duration in 1/10ths of a second.
Example:
SEND_COMMAND Panel,"'@PPT-Popup1;30'"
Sets the popup page ’Popup1’ to timeout within 3 seconds.
Same as a 'Clear All' command in TPDesign 4.
Syntax:
"'@PPX'"
Example:
SEND_COMMAND Panel,"'@PPX'"
Close all popups on all pages.
Only 1 coordinate is ever needed for an effect, however the command will specify both.
This command sets the location at which the effect will begin at.
Syntax:
"'@PSE-<popup page name>;<show effect name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
show effect name = Refers to the popup effect name being used.
Example:
SEND_COMMAND Panel,"'@PSE-Popup1;Slide from Left'"
Sets the Popup1 show effect name to ’Slide from Left’.
Only 1 coordinate is ever needed for an effect; however, the command will specify both.
This command sets the location at which the effect will begin at.
popup page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
Example:
SEND_COMMAND Panel,"'@PSP-Popup1;100,0'"
Sets the Popup1 show effect x-coordinate value to 100 and the y-coordinate value to 0.
Syntax:
"'@PST-<popup page name>;<show effect time>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
show effect time = Given in 1/10ths of a second.
Example:
SEND_COMMAND Panel,"'@PST-Popup1;50'"
Sets the Popup1 show effect time to 5 seconds.
Programming
TPI-PRO Total Presentation Interface - Pro Edition
79
Programming
Page Commands (Cont.)
PAG E
Flip to a specified
page.
PPOF
Deactivate a
specific popup
page on either a
specified page or
the current page.
PPOG
Toggle a specific
popup page on
either a specified
page or the
current page.
Flips to a page with a specified page name. If the page is currently active, it will not redraw
the page.
Syntax:
"'PAGE-<page name>'"
Variable:
page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
Example:
SEND_COMMAND Panel,"'PAGE-Page1'"
Flips to page1.
If the page name is empty, the current page is used (see example 2). If the popup page is
part of a group, the whole group is deactivated. This command works in the same way as
the ’Hide Popup’ command in TPDesign4.
Syntax:
"'PPOF-<popup page name>;<page name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
Example:
SEND_COMMAND Panel,"'PPOF-Popup1;Main'"
Deactivates the popup page ’Popup1’ on the Main page.
Example 2:
SEND_COMMAND Panel,"'PPOF-Popup1'"
Deactivates the popup page ’Popup1’ on the current page.
If the page name is empty, the current page is used (see example 2). Toggling refers to the
activating/deactivating (On/Off) of a popup page. This command works in the same way
as the ’Toggle Popup’ command in TPDesign4.
Syntax:
"'PPOG-<popup page name>;<page name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
Example:
SEND_COMMAND Panel,"'PPOG-Popup1;Main'"
Toggles the popup page ’Popup1’ on the Main page from one state to another (On/Off).
Example 2:
SEND_COMMAND Panel,"'PPOG-Popup1'"
Toggles the popup page ’Popup1’ on the current page from one state to another (On/Off).
80
TPI-PRO Total Presentation Interface - Pro Edition
Programming
Page Commands (Cont.)
PPON
Activate a specific
popup page to
launch on either a
specified page or
the current page.
If the page name is empty, the current page is used (see example 2). If the popup page is
already On, do not re-draw it. This command works in the same way as the ’Show Popup’
command in TPDesign4.
Syntax:
"'PPON-<popup page name>;<page name>'"
Variable:
popup page name = 1 - 50 ASCII characters. Name of the popup page.
page name = 1 - 50 ASCII characters. Name of the page on which the popup is
displayed.
Example:
SEND_COMMAND Panel,"'PPON-Popup1; Main'"
Activates the popup page ’Popup1’ on the Main page.
Example 2:
SEND_COMMAND Panel,"'PPON-Popup1'"
Activates the popup page ’Popup1’ on the current page.
Programming Numbers
The following information provides the programming numbers for colors, fonts, and borders.
Colors can be used to set the colors on buttons, sliders, and pages. The lowest color number represents
the lightest color-specific display; the highest number represents the darkest display. For example,
0 represents light red, and 5 is dark red. The following table lists the RGB color values and names for
standard 88 colors.
RGB triplets and names for basic 88 colors
RGB Values for all 88 Basic Colors
Index No. NameRedGreenBlue
00Very Light Red255 00
01Light Red22300
02Red19100
03Medium Red15900
04Dark Red12700
05Very Dark Red9500
06Very Light Orange2551280
07Light Orange22311 20
08Orange191960
09Medium Orange159800
10Dark Orange127640
11Very Dark Orange95480
12Very Light Yellow2552550
13Light Yellow2232230
14Yellow1911910
15Medium Yellow1591590
16Dark Yellow1271270
17Very Dark Yellow95950
18Very Light Lime1282550
19Light Lime11 22230
TPI-PRO Total Presentation Interface - Pro Edition
81
Programming
RGB Values for all 88 Basic Colors (Cont.)
Index No. NameRedGreenBlue
20Lime961910
21Medium Lime801590
22Dark Lime641270
23Very Dark Lime48950
24Very Light Green02550
25Light Green02230
26Green01910
27Medium Green01590
28Dark Green01270
29Very Dark Green0950
30Very Light Mint0255128
31Light Mint0223112
32Mint019196
33Medium Mint015980
34Dark Mint012764
35Very Dark Mint09548
36Very Light Cyan0255255
37Light Cyan0223223
38Cyan0191191
39Medium Cyan0159159
40Dark Cyan0127127
41Very Dark Cyan09595
42Very Light Aqua0128255
43Light Aqua0112223
44Aqua096191
45Medium Aqua080159
46Dark Aqua064127
47Very Dark Aqua04895
48Very Light Blue00255
49Light Blue00223
50Blue00191
51Medium Blue00159
52Dark Blue00127
53Very Dark Blue0095
54Very Light Purple1280255
55Light Purple1120223
56Purple960191
57Medium Purple800159
58Dark Purple640127
59Very Dark Purple48095
60Very Light Magenta2550255
61Light Magenta2230223
62Magenta1910191
63Medium Magenta1590159
82
TPI-PRO Total Presentation Interface - Pro Edition
RGB Values for all 88 Basic Colors (Cont.)
Index No. NameRedGreenBlue
64Dark Magenta1270127
65Very Dark Magenta95095
66Very Light Pink2550128
67Light Pink2230112
68Pink191096
69Medium Pink159080
70Dark Pink127064
71Very Dark Pink95048
72White255255255
73Grey1238238238
74Grey3204204204
75Grey5170170170
76Grey7136136136
77Grey9102102102
78Grey4187187187
79Grey6153153153
80Grey8119119119
81Grey10858585
82Grey12515151
83Grey13343434
84Grey2221221221
85Grey11686868
86Grey14171717
87Black000
255TRANSPARENT995399
Programming
Font styles and ID numbers
Font styles can be used to program the text fonts on buttons, sliders, and pages. The following chart
shows the default font type and their respective ID numbers generated by TPDesign4.
Default Font Styles and ID Numbers
Font ID #Font typeSizeFont ID # Font typeSize
1Courier New919Arial9
2Courier New1220Arial10
3Courier New1821Arial12
4Courier New2622Arial14
5Courier New3223Arial16
6Courier New1824Arial18
7Courier New2625Arial20
8Courier New3426Arial24
9AMX Bold1427Arial36
10AMX Bold2028Arial Bold10
11AMX Bold3629Arial Bold8
TPI-PRO Total Presentation Interface - Pro Edition
32 - Variable Fonts start at 32.
83
Programming
You must import fonts into a TPDesign4 project file. The font ID numbers are
assigned by TPDesign4. These values are also listed in the Generate Programmer’s Report.
Border styles
The TPDesign4 Touch Panel Design program has pre-set border styles that are user selectable. TPD4
border styles can ONLY be changed by using the name.
TPD4 Border Styles by Name
Border stylesBorder styles
NoneDiamond 55
AMX Elite -LDiamond 65
AMX Elite -MDiamond 75
AMX Elite -SDouble Bevel -L
Bevel -LDouble Bevel -M
Bevel -MDouble Bevel -S
Bevel -SDouble Line
Circle 15Fuzzy
Circle 25Glow-L
Circle 35Help Down
Circle 45Help Down Reversed
Circle 55Menu Bottom Rounded 15
Circle 65Menu Bottom Rounded 25
Circle 75Menu Bottom Rounded 35
Circle 85Menu Bottom Rounded 45
Circle 95Menu Bottom Rounded 55
Circle 105Menu Bottom Rounded 65
Circle 115Menu Bottom Rounded 75
Circle 125Menu Bottom Rounded 85
Circle 135Menu Bottom Rounded 95
Circle 145Menu Bottom Rounded 105
Circle 155Menu Bottom Rounded 115
Circle 165Menu Bottom Rounded 125
Circle 175Menu Bottom Rounded 135
Circle 185Menu Bottom Rounded 145
Circle 195Menu Bottom Rounded 155
Cursor BottomMenu Bottom Rounded 165
Cursor Bottom with HoleMenu Bottom Rounded 175
Cursor TopMenu Bottom Rounded 185
Cursor Top with HoleMenu Bottom Rounded 195
Cursor LeftMenu Left Rounded 15
Cursor Left with HoleMenu Left Rounded 25
Cursor RightMenu Left Rounded 35
Cursor Right with HoleMenu Left Rounded 45
Custom FrameMenu Left Rounded 55
84
TPI-PRO Total Presentation Interface - Pro Edition
TPD4 Border Styles by Name (Cont.)
Diamond 15Menu Left Rounded 65
Diamond 25Menu Left Rounded 75
Diamond 35Menu Left Rounded 85
Diamond 45Menu Left Rounded 95
Menu Left Rounded 105Menu Top Rounded 65
Menu Left Rounded 115Menu Top Rounded 75
Menu Left Rounded 125Menu Top Rounded 85
Menu Left Rounded 135Menu Top Rounded 95
Menu Left Rounded 145Menu Top Rounded 105
Menu Left Rounded 155Menu Top Rounded 115
Menu Left Rounded 165Menu Top Rounded 125
Menu Left Rounded 175Menu Top Rounded 135
Menu Left Rounded 185Menu Top Rounded 145
Menu Left Rounded 195Menu Top Rounded 155
Menu Right Rounded 15Menu Top Rounded 165
Menu Right Rounded 25Menu Top Rounded 175
Menu Right Rounded 35Menu Top Rounded 185
Menu Right Rounded 45Menu Top Rounded 195
Menu Right Rounded 55Neon Active -L
Menu Right Rounded 65Neon Active -S
Menu Right Rounded 75Neon Inactive -L
Menu Right Rounded 85Neon Inactive -S
Menu Right Rounded 95Oval V 30x60
Menu Right Rounded 105Oval V 50x100
Menu Right Rounded 115Oval V 75x150
Menu Right Rounded 125Oval V 100x200
Menu Right Rounded 135Oval H 60x30
Menu Right Rounded 145Oval H 100x50
Menu Right Rounded 155Oval H 150x75
Menu Right Rounded 165Oval H 200x100
Menu Right Rounded 175Picture Frame
Menu Right Rounded 185Quad Line
Menu Right Rounded 195Single Line
Menu Rounded Spacer - VerticalWindows Style Popup
Menu Rounded Spacer - HorizontalWindows Style Popup (Status Bar)
Menu Top Rounded 55
Programming
TPI-PRO Total Presentation Interface - Pro Edition
85
Programming
"^" Button Commands
These Button Commands are not case sensitive.
All commands that begin with "^" have the capability of assigning a variable text address range and
button state range. A device must first be defined in the NetLinx programming language with values for the Device: Port : System (in all programming examples - Panel is used in place of these values).
Variable text ranges allow you to target one or more variable text channels in a single
command.
Button State ranges allow you to target one or more states of a variable text button state with
a single command.
The "." character is used for 'through' notation, and the "&" character is used for 'And'
notation.
"^" Button Commands
^ANI
Run a button
animation (in 1/10
second).
^APF
Add page flip
action to a button
if it does not
already exist.
page flip action = Stan[dardPage] - Flip to standard page
Prev[iousPage] - Flip to previous page
Show[Popup] - Show Popup page
Hide[Popup] - Hide Popup page
Tog g[lePopup] - Toggle popup state
ClearG[roup] - Clear popup page group from all pages
ClearP[age] - Clear all popup pages from a page with the
specified page name
ClearA[ll] - Clear all popup pages from all pages
page name = 1 - 50 ASCII characters.
Example:
SEND COMMAND Panel,"'^APF-400,Stan,Main Page'"
Assigns button address 400 to a standard page flip with page name 'Main Page'.
86
TPI-PRO Total Presentation Interface - Pro Edition
"^" Button Commands (Cont.)
^BAT
Append
non-unicode text.
^BAU
Append unicode
text.
^BCB
Set the border
color to the
specified color.
Syntax:
"'^BAT-<vt addr range>,<button states range>,<new text>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
new text = 1 - 50 ASCII characters.
Example:
SEND_COMMAND Panel,"'^BAT-520,1,Enter City'"
Appends the text 'Enter City' to the button’s OFF state.
Same format as ^UNI.
Syntax:
"'^BAU-<vt addr range>,<button states range>,<unicode text>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
unicode text = 1 - 50 ASCII characters. Unicode characters must be entered in Hex
format.
Example:
SEND_COMMAND Panel,"'^BAU-520,1,00770062'"
Appends Unicode text '00770062' to the button’s OFF state.
Only if the specified border color is not the same as the current color.
Note: Color can be assigned by color name (without spaces), number or R,G, B value
(RRGGBB or RRGGBBAA).
Syntax:
"'^BCB-<vt addr range>,<button states range>,<color value>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
color value = Refer to the RGB Values for all 88 Basic Colors table on page 81 for more
information.
Example:
SEND_COMMAND Panel,"'^BCB-500.504&510,1,12'"
Sets the Off state border color to 12 (Yellow). Colors can be set by Color Numbers, Color
name, RGB alpha colors (RRGGBBAA) and RG & B color values (RRGGBB). Refer to the
RGB Values for all 88 Basic Colors table on page 81.
Programming
TPI-PRO Total Presentation Interface - Pro Edition
87
Programming
"^" Button Commands (Cont.)
^BCF
Set the fill color to
the specified
color.
^BCT
Set the text color
to the specified
color.
This command works only if the specified fill color is not the same as the current color.
Note: Color can be assigned by color name (without spaces), number or R,G,B value
(RRGGBB or RRGGBBAA).
Syntax:
"'^BCF-<vt addr range>,<button states range>,<color value>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
color value = Refer to the RGB Values for all 88 Basic Colors table on page 81 for more
information.
Sets the Off state fill color by color number. Colors can be set by Color Numbers, Color
name, RGB alpha colors (RRGGBBAA) and R G & B color values (RRGGBB).
This command works only if the specified text color is not the same as the current color.
Note: Color can be assigned by color name (without spaces), number or R,G,B value
(RRGGBB or RRGGBBAA).
Syntax:
"'^BCT-<vt addr range>,<button states range>,<color value>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
color value = Refer to the RGB Values for all 88 Basic Colors table on page 81 for more
information.
Example:
SEND_COMMAND Panel,"'^BCT-500.504&510,1,12'"
Sets the Off state border color to 12 (Yellow). Colors can be set by Color Numbers, Color
name, RGB alpha colors (RRGGBBAA) and R G & B colors values (RRGGBB).
88
TPI-PRO Total Presentation Interface - Pro Edition
"^" Button Commands (Cont.)
^BDO
Set the button
draw order.
^BFB
Set the feedback
type of the button.
Determines what order each layer of the button is drawn.
Syntax:
"'^BDO-<vt addr range>,<button states range>,<1-5><1-5><1-5><15><1-5>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
Note: The layer assignments are from bottom to top. The default draw order is
Example:
SEND_COMMAND Panel,"'^BDO-530,1&2,51432'"
Sets the button’s variable text 530 ON/OFF state draw order (from bottom to top) to
Border, Fill, Text, Icon, and Image.
Example 2:
SEND_COMMAND Panel,"'^BDO-1,0,12345'"
Sets all states of a button back to its default drawing order.
This command only works on General-type buttons.
Syntax:
"'^BFB-<vt addr range>,<feedback type>'"
Variable:
variable text address range = 1 - 4000.
feedback type = (None, Channel, Invert, On (Always on), Momentary, and Blink).
Example:
SEND_COMMAND Panel,"'^BFB-500,Momentary'"
Sets the Feedback type of the button to 'Momentary'.
Programming
12345.
TPI-PRO Total Presentation Interface - Pro Edition
89
Programming
"^" Button Commands (Cont.)
^BIM
Set the input
mask for the
specified address.
^BLN
Set the number of
lines removed
equally from the
top and bottom of
a composite video
signal.
Syntax:
"'^BIM-<vt addr range>,<input mask>'"
Variable:
variable text address range = 1 - 4000.
input mask = Refer to the
types.
Example:
SEND_COMMAND Panel,"'^BIM-500,AAAAAAAAAA'"
Sets the input mask to ten ’A’ characters, that are required, to either a letter or digit (entry
is required).
The maximum number of lines to remove is 240. A value of 0 will display the incoming
video signal unaffected. This command is used to scale non 4x3 video images into non
4x3 video buttons.
Syntax:
"'^BLN-<vt addr range>,<button states range>,<number of lines>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
number of lines = 0 - 240.
Example:
SEND_COMMAND Panel,"'^BLN-500,55'"
Equally removes 55 lines from the top and 55 lines from the bottom of the video button.
Text Area Input Masking
section on page 136 for character
90
TPI-PRO Total Presentation Interface - Pro Edition
"^" Button Commands (Cont.)
^BMC
Button copy
command. Copy
attributes of the
source button to
all the destination
buttons.
Note that the source is a single button state. Each state must be copied as a separate
command. The <codes> section represents what attributes will be copied. All codes are 2
character pairs that can be separated by comma, space, percent or just ran together.
Syntax:
"'^BMC-<vt addr range>,<button states range>,<source
port>,<source address>,<source state>,<codes>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
source port = 1 - 100
source address = 1 - 4000
source state = 1 - 256
codes: BM - Picture/Bitmap
BR - Border
CB - Border Color
CF - Fill Color
CT - Text Color
EC - Text effect color
EF - Text effect
FT - Font
IC - Icon
JB - Bitmap alignment
JI - Icon alignment
JT - Text alignment
LN - Lines of video removed
OP - Opacity
SO - Button Sound
TX - Text
VI - Video slot ID
WW - Word wrap on/off
Example:
SEND_COMMAND Panel,"'^BMC-425,1,1,500,1,BR'"
or
SEND_COMMAND Panel,"'^BMC-425,1,1,500,1,%BR'"
Copies the OFF state border of button with a variable text address of 500 onto the OFF
state border of button with a variable text address of 425.
Copies the OFF state border, font, Text, bitmap, icon, fill color and text color of the button
with a variable text address of 315 onto the OFF state border, font, Text, bitmap, icon, fill
color, and text color of the button with a variable text address of 150.
Programming
TPI-PRO Total Presentation Interface - Pro Edition
91
Programming
"^" Button Commands (Cont.)
^BMF
Set any/all button
parameters by
sending
embedded codes
and data.
Syntax:
"'^BMF-<vt addr range>,<button states range>,<data>'"
Variables:
variable text address char array = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
level range = 1 - 600 (level value is 1 - 65535).
data:
’%B<border style>’ = Set the border style name. See the Border styles table on page 84.
’%B’,<border 0-27,40,41> = Set the borer style number. See the Border styles table on
page 84.
’%DO<1-5><1-5><1-5><1-5><1-5> = Set the draw order. Listed from bottom to top.
Refer to the ^BDO command on
’%F’,<font 1-8,10,11,20-29,32-xx> = Set the font. See the Default Font Styles and ID
Numbers table on page 83.
’%F<font 01-08,10,11,20-29,32-xx>’ = Set the font. See the Default Font Styles and ID
Numbers table on page 83.
’%MI<mask image>’ = Set the mask image. Refer to the ^BMI command on page 94 for
more information.
’%T<text >’ = Set the text using ASCII characters (empty is clear).
’%P<bitmap>’ = Set the picture/bitmap filename (empty is clear).
’%I’,<icon 1-9900, 0-clear> = Set the icon using values of 1 - 9900 (icon numbers are
assigned in the TPDesign4 Resource Manager tab - Slots section).
’%I<icon 01-9900, 0-clear>’ = Set the icon using values of 01 - 9900 (icon numbers are
assigned in the TPDesign4 Resource Manager tab - Slots section).
’%J’,<alignment of text 1-9> = As shown the following telephone keypad alignment chart:
0
1
2
4
5
7
8
page 89 for more information.
3
6
9
Zero can be used for an absolute position
’%JT<alignment of text 0-9>’ = As shown the above telephone keypad alignment chart,
BUT the 0 (zero) is absolute and followed by ’,<left>,<top>’
’%JB<alignment of bitmap/picture 0-9>’ = As shown the above telephone keypad
alignment chart BUT the 0 (zero) is absolute and followed by ’,<left>,<top>’
’%JI<alignment of icon 0-9>’ = As shown the above telephone keypad alignment chart,
BUT the 0 (zero) is absolute and followed by ’,<left>,<top>’
92
TPI-PRO Total Presentation Interface - Pro Edition
"^" Button Commands (Cont.)
^BMF
(Cont.)
For some of these commands and values, refer to
Colors table on page 81.
’%CF<on fill color>’ = Set Fill Color.
’%CB<on border color>’ = Set Border Color.
’%CT<on text color>’ = Set Text Color.
’%SW<1 or 0>’ = Show/hide a button.
’%ST<style>’ = Button style.
’%SO<sound>’ = Set the button sound.
’%EN<1 or 0>’ = Enable/disable a button.
’%WW<1 or 0>’ = Word wrap On/Off.
’%GH<bargraph hi>’ = Set the bargraph upper limit.
’%GL<bargraph low>’ = Set the bargraph lower limit.
’%GN<bargraph slider name>’ = Set the bargraph slider name/Joystick cursor name.
’%GC<bargraph slider color>’ = Set the bargraph slider color/Joystick cursor color.
’%GI<bargraph invert>’ = Set the bargraph invert/noninvert or joystick coordinate
(0,1,2,3). See the
’%GU<bargraph ramp up>’ = Set the bargraph ramp up time in intervals of 1/10 second.
’%GD<bargraph ramp down>’ = Set the bargraph ramp down time in 1/10 second.
’%GG<bargraph drag increment> = Set the bargraph drag increment. Refer to the ^GDI
command on
’%VI<video on/off>’ = Set the Video either On (value=1) or Off (value=0).
’%OT<feedback type>’ = Set the Feedback (Output) Type to one of the following: None,
Channel,Invert, On (AlwaysOn), Momentary, or Blink.
’%SM’ = Submit a text for text area button.
’%SF<1 or 0>’ = Set the focus for text area button.
’%OP<0-255>’ = Set the button opacity to either Invisible (value=0) or Opaque
(value=255).
’%OP#<00-FF>’ = Set the button opacity to either Invisible (value=00) or Opaque
(value=FF).
’%UN<Unicode text>’ = Set the Unicode text. See the
text format.
’%LN<0-240>’ = Set the lines of video being removed. See the
for more information.
’%EF<text effect name>’ = Set the text effect.
’%EC<text effect color>’ = Set the text effect color.
’%ML<max length>’ = Set the maximum length of a text area.
’%MK<input mask>’ = Set the input mask of a text area.
’%VL<0-1>’ = Log-On/Log-Off the computer control connection
’%VN<network name>’ = Set network connection name.
’%VP<password>’ = Set the network connection password.
Example:
SEND_COMMAND Panel,"'^BMF-500,1,%B10%CFRed%CB Blue
%CTBlack%Ptest.png'"
Sets the button OFF state as well as the Border, Fill Color, Border Color, Text Color, and
Bitmap.
^GIV
section on page 100 more information.
page 100 for more information.
Programming
the RGB Values for all 88 Basic
^UNI
section on page 105 for the
^BLN
section on page 90
TPI-PRO Total Presentation Interface - Pro Edition
93
Programming
"^" Button Commands (Cont.)
^BMI
Set the button
mask image.
^BML
Set the maximum
length of the text
area button.
^BMP
Assign a picture to
those buttons with
a defined address
range.
^BNC
Clear current
TakeNote
annotations.
Mask image is used to crop a borderless button to a non-square shape. This is typically
used with a bitmap.
Syntax:
"'^BMI-<vt addr range>,<button states range>,<mask image>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).
mask image = Graphic file used.
Example:
SEND_COMMAND Panel,"'^BMI-530,1&2,newMac.png'"
Sets the button with variable text 530 ON/OFF state mask image to 'newmac.png'.
If this value is set to zero (0) there is no max length. The maximum length available is
2000. This is only for a Text area input button and not for a Text area input masking button.
Syntax:
"'^BML-<vt addr range>,<max length>'"
Variable:
variable text address range = 1 - 4000.
max length = 2000 (0=no max length).
Example:
SEND_COMMAND Panel,"'^BML-500,20'"
Sets the maximum length of the text area input button to 20 characters.
Syntax:
"'^BMP-<vt addr range>,<button states range>,<name of bitmap/
picture>'"
Variable:
variable text address range = 1 - 4000.
button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons
1 = Off state and 2 = On state).