AMX NXA-USBCC User manual

Quick Start Guide
NXA-USBCC G4 Computer Control (MAC/PC)
Introduction
AMX Modero Touch Panels, TPI/4 Touch Monitors and TPDesign4 software
include Computer Control, an innovative G4 features exclusively from AMX.
Connect any laptop computer to the control network, plug in the NXA-USBCC
AMX Computer Control USB stick (FG070-602) into the laptop, and experience
complete access to your PC directly on the Touch Panel.
The NXA-USBCC contains everything that you need to implement Computer
Control functionality including:
• The amxCC server application
• The configCC configuration utility
• NetLinx cc-GuestPC Code Module
• Sample Code and Programming/Configuration Pages
•RoHScompliant
Specifications
Note: G4 Computer Control has been modified to address security issues
identified in conjunction with Windows XP Service Pack 2 and the placement of
the application within the Windows Startup group.
• This modification includes a new command line argument in the form of /
wait=X, where Xrefers to a number of seconds (valid range = 5 to 120)
used to delay the G4 Computer Control application’s startup. An argument
outside of this range will default the wait to 20 seconds.
• This modification must be used to ensure proper application startup when
placed within the Windows Startup group.
The addition of this argument to the G4 Computer Control shortcut (FIG. 2)
(found within the Startup group) delays the execution of the application for the
specified amount of time, ensuring that G4CC is capable of sending it's
initialization to known Masters after Windows XP has completed its startup
procedures after which communication is then allowed.
Installing Computer Control
Step 1: Update AMX Hardware and Software
• Using NetLinx Studio v2.2 (or higher), transfer the most current product
firmware to your Touch Panels and NetLinx Masters. Visit www.amx.com
for the latest firmware files.
• Use the WebUpdate feature integrated in the TPDesign4 and NetLinx
Studio software to update the applications if necessary. Alternatively, you
could navigate to www.amx.com and download the latest versions of the
programs.
Step 2: Develop a TPD4 project with G4CC Support
1. Launch TPDesign4 and open an existing project, or create a new one.
Refer to the online help for instructions on using TPDesign4.
2. Create or open a panel page and draw a button that covers most or all of
that panel page.
3. In the General tab of the Button Properties window, set the button’s Type to
Computer Control.
4. Either leave this field blank (preferred) or enter the IP Address of the
Netlinx master in the Remote Host field.
FIG. 1 NXA-USBCC - G4 Computer Control
NXA-USBCC (FG070-602) Specifications
Dimensions (HWD): • 0.32" x 0.87" x 2.87" (8.0 mm x 22.0 mm x 73.0
mm)
Recommended Windows®
Operating Requirements:
• Windows XP and Windows 2000
• 1 GHz (or higher) Pentium®processor
•USBPort
• 256 MB of RAM
Note: Other configurations may experience some
performance impact while remote clients are con-
nected.
Recommended Macintosh©
Operating Requirements:
• MAC OS 10.2 (or greater) operating system
• G4 machine or higher
• 256 MB of RAM
Features:
Port Compatibility • USB 1.1 / 2.0
Read/write speed • 1000 Kb/sec and 900 Kb/sec
LED • Blue LED indicates the drive connection status
Operating /Storage
Environments:
• Operating Temperature: 0° C (32° F) to 40° C
(104° F)
• Operating Humidity: 20% - 85% RH
• Storage Temperature: -20° C (-4° F) to 60° C
(140° F)
• Storage Humidity: 5% - 85% RH
Included Accessories • Lanyard (neck strap)
• 64 MB USB stick
• USB extension cable
• Quick Start Guide (93-070-602)
FIG. 2 amxCC shortcut dialog (showing new command line argument)
FIG. 3 G4 Computer Control Configuration
This
modification
is intended for
Windows XP SP2
users only
This example
shows a delay
of 12 seconds
before the G4CC
application
launches
Command Line
Argument

For full warranty information, refer to the AMX Instruction Manual(s) associated with your Product(s).
11/07
©2007 AMX. All rights reserved. AMX and the AMX logo are registered trademarks of AMX.
AMX reserves the right to alter specifications without notice at any time.
3000 RESEARCH DRIVE, RICHARDSON, TX 75082 • 800.222.0193 • fax [phone] • technical support 800.932.6993 • www.amx.com
93-070-602 REV: J
Step 3: Modify the Source Code on your Master
Before you can use the Computer Control application, you must first modify the
NetLinx Master Source Code to support the new (G4CC) functionality:
1. Insert the NXA-USBCC stick into a USB port on the PC to be
controlled (FIG. 3). Confirm that a new USB detection icon ( ) appears
in the windows taskbar. This icon does not appear on a MAC.
2. Launch NetLinx Studio, select File > Open, navigate to the assigned USB
stick drive and open the cc-GuestPC Test.axs file. This file acts as a
source for the various communication parameters needed by the Master
to allow the initial communication between the panel and the PC.
3. Scroll through the code in the cc-GuestPC TEST.axs file, and add the fol-
lowing information into your Master Source Code:
• Add a Telnet device connection to your device definitions by copying the
following information from the DEFINE_DEVICE section (of the
cc-GuestPC TEST.axs file) and pasting it into your source code:
• vdvGuestPC = 0:5:0
• Add the entire Module Definition:
DEFINE_MODULE 'cc-GuestPCMod' <myModuleName>
(<guestPcDevice>)
where:
<myModuleName> - local name for this instance of the cc-GuestPC
module
<guestPcDevice> - device for cc-GuestPC to use for internal data
events; this should be a DEFINE_DEVICE for the events to work properly
4. Save and close the cc-GuestPC Test.axs file.
5. Right-click the Module folder (in the Workspace containing your
current Project), and select Add Existing Module File.
6. Navigate to the Module folder on the USB stick, and select *.tko from the
Files of type field.
7. Select the cc-GuestPC.tko file and click Open > OK. This file needs to
be added to your Workspace and compiled with the source code.
8. Save your Workspace, verify that your source code is designated as the
Master source code file, and then press F7 to begin compiling your
Master Source Code and Module file. This process creates the .tkn file
that is transferred to the Master.
9. Verify that your Master is online and communicating and select Tools >
File Transfer to open the File Transfer dialog. Click the Add button to
open the Select Files for File Transfer dialog, open to the Current
Workspace tab.
10. Locate the compiled *.tkn file and select it for transfer. Click OK to return
to the File Transfer dialog.
11. Click Send to transfer the selected tkn file to the target Master.
Step 4: Configure Computer Control
configCC.exe (included on the USB stick) is the Configuration Utility for
G4CC. Use this application to designate up to four Modero or TPI/4 panels that
will be allowed to control this computer.
1. Use the computer’s file browser to navigate to the assigned USB stick
drive location and open the Computer Control > Config folder.
2. Use the configCC.exe application (on the USB stick) to configure the
G4CC application. Double-click the configCC.exe (AMX G4CC Config
on a MAC) to run the configuration utility.
The following information is needed by the Computer Control
Configuration Utility (FIG. 4) for each G4 panel or TPI/4 interface:
•NetLinx Master IP Address/DNS (Fixed IP/URL):____.____.____.____
(Acquire the IP Address of the Master via NetLinx Studio:
select Diagnostics > Network Addresses > Get IP Information).
•G4 Touch Panel Device ID: _______
(Acquire the panel device number in the online tree of NetLinx Studio).
•G4 Touch Panel System: _______
(Acquire the system number in the online tree of NetLinx Studio).
•Computer Control Button Address Port: _______
(Acquire this number via TPD4, in the Programming Tab of the Button
Properties window).
•Computer Control Button Address Code (Channel): _______
(Acquire this number via TPD4, in the Programming Tab of the Button
Properties window). This information was previously entered into the
Address Code field for the Computer Control button.
• Press the OK button when finished adding a single panel. This action
modifies the amxCC.cfg file and stores your settings until the values
within the configCC.exe file are altered. Once the USB Control Stick has
been configured, it can be used on any computer residing on the Ethernet
Network that can communicate with the NetLinx Control System.
• Add multiple panels using the Next button ( ) on the PC configuration
utility screen or Add ( ) on the MAC (maximum of four panels).
Step 5: Run the Computer Control Application
1. Once the configuration file has been created, double-click the
amxCC.exe file, located in the Computer Control folder, to begin your
G4CC session and display the G4CC icon ( ) in the taskbar. The icon
turns green ( ) when a Modero or TPI/4 panel is connected to the com-
puter.
2. Upon opening this file, your PC will be displayed on the touch panel.
3. To terminate your Computer Control session, right-click on the G4CC icon
and select Close Computer Control from the menu.
While you can have between 1 and 4 masters/panels connected to the PC you
should not connect more than one PC to any one master/panel.
Warranty Exception
AMX Corporation warrants this product to be free of defects in material and
workmanship under normal use for 30 days from the date of purchase from
AMX Corporation. This product is not eligible for credit return.
FIG. 4 G4 Computer Control Configuration screen
Config CC application - PC AMX G4CC Config app - MAC