AMX grants to Licensee the non-exclusive right to use the AMX Software in the manner described in this License. The AMX Software
is licensed, not sold. The AMX Software consists of generally available programming and development software, product
documentation, sample applications, tools and utilities, and miscellaneous technical information. Please refer to the README.TXT
file on the compact disc or download for further information regarding the components of the AMX Software. The AMX Software is
subject to restrictions on distribution described in this License Agreement. YOU MAY NOT LICENSE, RENT, OR LEASE THE AMX
SOFTWARE. You may not reverse engineer, decompile, or disassemble the AMX Software.
INTELLECTUAL PROPERTY.
The AMX Software is owned by AMX and is protected by United States copyright laws, patent laws, international treaty provisions,
and/or state of Texas trade secret laws. Licensee may make copies of the AMX Software solely for backup or archival purposes.
Licensee may not copy the written materials accompanying the AMX Software.
TERMINATION. AMX RESERVES THE RIGHT, IN ITS SOLE DISCRETION, TO TERMINATE THIS LICENSE FOR
ANY REASON AND UPON WRITTEN NOTICE TO LICENSEE.
In the event that AMX terminates this License, the Licensee shall return or destroy all originals and copies of the AMX Software to
AMX and certify in writing that all originals and copies have been returned or destroyed.
PRE-RELEASE CODE.
Portions of the AMX Software may, from time to time, as identified in the AMX Software, include PRE-RELEASE CODE and such
code may not be at the level of performance, compatibility and functionality of the final code. The PRE-RELEASE CODE may not
operate correctly and may be substantially modified prior to final release or certain features may not be generally released. AMX is
not obligated to make or support any PRE-RELEASE CODE. ALL PRE-RELEASE CODE IS PROVIDED "AS IS" WITH NO
WARRANTIES.
LIMITED WARRANTY.
AMX warrants that the AMX Software will perform substantially in accordance with the accompanying written materials for a period of
ninety (90) days from the date of receipt. AMX DISCLAIMS ALL OTHER WARRANTIES, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE, WITH REGARD TO THE AMX SOFTWARE. THIS LIMITED WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS.
Any supplements or updates to the AMX SOFTWARE, including without limitation, any (if any) service packs or hot fixes provided to
you after the expiration of the ninety (90) day Limited Warranty period are not covered by any warranty or condition, express, implied
or statutory.
LICENSEE REMEDIES.
AMX's entire liability and your exclusive remedy shall be repair or replacement of the AMX Software that does not meet AMX's
Limited Warranty and which is returned to AMX. This Limited Warranty is void if failure of the AMX Software has resulted from
accident, abuse, or misapplication. Any replacement AMX Software will be warranted for the remainder of the original warranty period
or thirty (30) days, whichever is longer. Outside the United States, these remedies may not available.
NO LIABILITY FOR CONSEQUENTIAL DAMAGES. IN NO EVENT SHALL AMX BE LIABLE FOR ANY DAMAGES
WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF
OR INABILITY TO USE THIS AMX SOFTWARE, EVEN IF AMX HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
BECAUSE SOME STATES/COUNTRIES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR
CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATION MAY NOT APPLY TO YOU.
U.S. GOVERNMENT RESTRICTED RIGHTS. The AMX Software is provided with RESTRICTED RIGHTS. Use, duplication, or
disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and
Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software
Restricted Rights at 48 CFR 52.227-19, as applicable.
This Agreement replaces and supercedes all previous AMX Software License Agreements and is governed by the
laws of the State of Texas, and all disputes will be resolved in the courts in Collin County, Texas, USA. Should you
have any questions concerning this Agreement, or if you desire to contact AMX for any reason, please write: AMX
Corporation, 3000 Research Drive, Richardson, TX 75082.
Design XPress - Professional (DXP-PRO)™ is a software package developed to assist AMX
dealers in quickly designing, installing, and programming a control system. The type of control
system created using DXP-PRO allows the selection and control of audio/video sources,
audio/video switchers, display devices, room lighting, and audio/video conference equipment
(among other functions).
DXP-PRO allows control from AMX's CV6 (6" wired touch panel), CA10, CV10 (10.4" wired
touch panels), as well as the entire line of Modero (G4) touch panels (refer to the Supported Touch
Panel s section on page 5). A wizard-based graphic user interface (GUI) helps a dealer quickly step
through the process of entering information specific to the system being created.
The DXP-PRO Project Wizard also allows you to specify the type of NetLinx Master Controller
used to control the system. DXP-PRO supports NetLinx Integrated Controllers such as: NI-700,
NI-2000, NI-3000, NI-4000, and the NXI equipped with an NXC-ME260/64 Master card. The
wizard only allows you to choose a NetLinx Master that is able to accommodate the devices and
functions specified within your project.
Introduction
Once the steps outlined in the wizard are completed, it automatically generates all NetLinx program
files, touch panel files, and a comprehensive report file for the system. While these
auto-generated program files can be used as-is, they can also be modified using NetLinx Studio™
and TPDesign4. These applications allow you to customize the NetLinx code and touch panel files
to accommodate specific client desires as well as those unique requirements always found in
custom installations.
You can have multiple instances of DXP-PRO generated projects open in NetLinx
Studio at any time.
This manual will take you through the steps required to generate a system using the DXP-PRO
wizard.
New Features available within version 1.1
Enhanced Automation
This new feature is added as a selectable option within the Touch Panel Interfaces dialog
page. Enhanced Automation allows you to exclude specific buttons from the Navigation
menu, such as Display, Lights, Macros, and Relay buttons. It also allows you to
customize the DXP-PRO generated touch panel file information by copying buttons from
the underlying pages and providing that functionality onto the current page.
De-selecting these (Display, Lights, Macros, and Relay) radio boxes specifies which
buttons will be excluded from the output touch panel pages (within the project file) for
the chosen touch panel.
DXP-PRO v1.1 - Programmer’s Guide
1
Introduction
Support for NI-700 NetLinx Integrated Controller
This new controller is treated the same as any of the other NI Series of Integrated
Controllers. If the project calls for more ports than the NI-700 can provide (2 Serial and
1 IR), it is not selectable as a system controller via the DXP-PRO wizard.
Support for Cameras
This new far-end control of external cameras (using Serial control ports) is possible by
supporting them as a Source type (external to a video conferencing unit) using a remote
serial interface operating on a selected port. Their selection is added as a choice from a
drop-down selection list within the Camera Control section of the Device Data tab. These
cameras must first be added as a Source type within the same Device Data tab of the
Device Configuration dialog page before they can be used by other sources such as a
video display. This feature is only supported within G4 touch panels.
Support of remote serial interface usage (Display devices and External cameras)
This new support is added as way of providing far-end control of external cameras and
display devices using Serial control ports. This is accomplished by allowing you to
choose either Camera or Display as a selectable Source Types within the Device Data
tab of the Device Configuration dialog page. This feature allows you to extend their
"reach" and control an external camera directly by parsing out Send Commands to the
external Serial control ports. Local control of cameras is done indirectly via the use of
AXB-PT15 camera controllers.
If either a Camera or Video Display (such as a Projector/Plasma and TV) are chosen
to be controlled via Serial (RS-232), two new fields become available within the
Device Data section. Place a checkmark in the Use remote serial interface field to
indicate you are using an external serial interface or leave it unchecked to use a
Serial port on the Master.
If this option is checked, you can choose which port on the serial interface to use by
choosing a port from the drop-down list. This was implemented to communicate to
some cameras and display devices that are not located near the Master.
Support for MeetingManger
This new support is added as a selectable option within the Integrated Applications
dialog page. Enabling this option, provides the ability to enable touch panel pages to
support the on-screen display of room scheduling and appointments. All queriable
devices within the target environment such as: source/display/switching devices, and
AMX devices (touch panels and NXA-UPSs) can be monitored via the MeetingManager
application.
No scheduling capabilities are available through the DXP-PRO touch panels and must be
done through the actual RMS (Resource Manager Suite) application interface.
To enable online/offline notification, the programmer would need to write custom
Resource Manager NetLinx code within the DXP-PRO project file that is downloaded
to the target Master. This custom code is written within the custom.axi file.
2
DXP-PRO v1.1 - Programmer’s Guide
Support for i!-TimeManager
This new support is added as a selectable option within the Integrated Applications
dialog page. Enabling the Use i!-TimeManager option prompts you to select a time zone
and apply Daylight Savings Time rules.
Support for i!-Weather
This new support is added as a selectable Source Type within the Device Data tab of the
Device Configuration dialog page. i!-Weather is treated as a source type and not a
controlled source. Only one instance of i!-Weather is allowed within the Source list.
Support for G4 Computer Control
This new support is added as a selectable Source Type within the Device Data tab of the
Device Configuration dialog page. G4 Computer Control (G4CC) can be configured as a
source type within a system and also available for use within every touch panel that
resides within the same system.
DXP-PRO natively supports G4 Computer Control from AMX. DXP-PRO is not
intended to support 3rd party (free) VNC clients that are downloadable from the
Internet.
When using G4 Computer Control, it is important to understand that DXP-PRO does
not setup the USB stick applications for you. It is necessary to configure the
corresponding configCC and amxCC application information fields (regarding the
Master and touch panels) prior to compiling the DXP-PRO project. Any Master code
alterations and configCC field entries must be done prior to launching the amxCC
executable.
Introduction
Support for PictureFrame
This new support is added as a selectable option within the Touch Panel Interfaces dialog
page. Selecting this radio box specifies that the output project file for the chosen touch
panel will support the use of PictureFrame application on the panel's inactivity page.
Support for TakeNote!
This new support is added as a selectable option within the Touch Panel Interfaces dialog
page. Selecting this radio box specifies that the output project file for the chosen touch
panel will support TakeNote!
System Startup and Shutdown Macros
These new macros are added to the already existing list within the Navigation and
Routing Macros dialog page. These macros add their corresponding buttons to the initial
logo page and allow users to specify a series of actions (macro steps) that are performed
upon execution of the shutdown or startup macro buttons. These can be zero step macros;
if zero steps are used, the buttons are then removed from the touch panel interface.
Volume Level Adjustment for a Macro Step
This new feature is added as an available tab within the Macro Steps dialog page. This
feature allows you to set a volume level appropriate to the specific macro's function.
DXP-PRO v1.1 - Programmer’s Guide
3
Introduction
Supported Operating Systems
Windows 2000® (Service Pack 4 or greater)
Windows XP® Professional (Service Pack 1)
If you are installing NetLinx Studio on a Windows XP or 2000 machine, you must
have Administrator rights to install and run all required System files.
A VGA monitor running at a minimum resolution of 800 x 600
Windows-compatible CD-ROM drive
Mouse (or equivalent pointing device)
Minimum free disk space: 2 GB
Internet Access (for Web Update functionality)
Minimum System Software Requirements
Verify that you have downloaded the latest versions of these applications to your computer prior to
launching DXP-PRO.
Microsoft MDAC v2.6
NetLinx Studio 2.2
TPDesign 3.16
TPDesign4 2.3 (build 353 or higher)
DXP-PRO Image File - If the application fails to detect at least one valid set of
background images and at least on valid set of button images, a separate installation of
the Image File is required. This image installation is available on the DXP-PRO section
of the Application Files page on www.amx.com. If the application fails to detect at least
one valid set of background images and at least on valid set of button images the
following message box will be displayed and the application terminated.
Downloading the Application
Design XPress - Professional (DXP-PRO) can be downloaded from the AMX web site only after
you have successfully logged-in as a registered user. Upon entry to the site, navigate to the Software
Center (Tech Center > Application Files) to download the application. You must download all of
the files in the Design XPress - Professional section, or you may download the compressed file,
which contains all of the other files in the directory.
4
DXP-PRO v1.1 - Programmer’s Guide
The two Adobe Acrobat files included (in addition to this one) are:
The On-Site Installer’s Guide is intended for the equipment installer.
The User-Interface Guide describes the Touch Panel UI, and is provided as a reference
for designers, installers, and end-users.
Select Help > Web Update to automatically check for program updates. The
program prompts you to download and install any updates that are available.
Supported Touch Panels
G4 Touch Panels
DXP-PRO (version 1.1 or higher) supports the following AMX (G4) touch panel types:
Modero CV7: 7" Modero Touch Panel (with video capabilities)
MVP-7500: 7.5" Modero ViewPoint Touch Panel
MVP-8400: 8.4" Modero ViewPoint Touch Panel
Modero CA12: 12" Modero Touch Panel
Introduction
Modero CV12: 12" Modero Touch Panel (with video capabilities)
Modero CA15: 15" Modero Touch Panel
Modero CV15: 15" Modero Touch Panel (with video capabilities)
Modero CV17: 17" Modero Touch Panel (with video capabilities)
Unless otherwise specified, these panels encompass both NXD and NXT models
(when available). The nomenclature "NXD" represents the Wall Mount version and
"NXT" indicates the Table Top (tilt) model.
G3 Touch Panels
Supported G3 touch panel types:
CV6: 6" touch panel with video
CA10: 10.4" touch panel (both NXD and NXT models)
CV10/CG10: 10.4" touch panel with video (both NXD and NXT models)
G3 Touch Panel Considerations
The AXD/AXT CA10, CG10, and CG10 panels do not support the following devices:
MAX Integrated Content Server
Video Conferencing devices
Cameras
G4 Computer Control
Take Note
DXP-PRO v1.1 - Programmer’s Guide
5
Introduction
Resource Management (RMS)
PictureFrame
The AXD-CV6 has the same considerations as the other G3 panels, but it also does not
support the following devices:
Audio Conferencing
Supported Subsystems and Equipment
DXP-PRO (v1.1) supports the following subsystems and equipment:
Audio/Video Switchers
• ADASuite 16
• Autopatch1YDM
• AutopatchHalf-Y
• AutopatchModula
• AutopatchPrecis
• ExtronCrosspoint 124
• ExtronCrosspoint 128
• ExtronCrosspoint 1616
• ExtronCrosspoint 168
• ExtronCrosspoint 84
• ExtronCrosspoint 88
• ExtronCrosspoint Plus 124
• ExtronCrosspoint Plus 128
• ExtronCrosspoint Plus 1616 HV
• ExtronCrosspoint Plus 1616 HVA
• ExtronCrosspoint Plus 168
• ExtronCrosspoint Plus 84
• ExtronCrosspoint Plus 88
• ExtronMAV 128
•ExtronMAV 84
• ExtronMaxtrix 3200
• ExtronMaxtrix 50
• ExtronMaxtrix 6400
• ExtronMSV Series (Inline)
•ExtronSW Series
• Key Digital SystemsKDMSW8x3
• Key Digital SystemsKDSW4x1
• Network CommunicationsVikinx Media8
6
DXP-PRO v1.1 - Programmer’s Guide
Audio Conferencing Devices
• ClearOneXAP400
• ClearOneXAP800
• ClearOneXAP800/ XAPTH2
• PolycomVortex EF2241
• PolycomVortex EF2280
• PolycomVortex EF2280/EF2201
The supported Audio conference units are controlled only via Serial (RS-232).
AMX NetLinx Integrated Controllers
• NI-700
• NI-2000
• NI-3000
• NI-4000
• NXI equipped with a NXC-ME260/64 Master card
Introduction
Cameras
• CanonVC-C4
• EpsonELPDC202
• KalatelCyberdome
• SonyDXC-990/390
• SonyDXC-950/970
• SonyEVI-D100
• SonyEVI-D70
• WolfvisionVZC10
CD (Compact Disc) Players
• DenonDN-C635
• DenonDN-T625
• DenonDN-T645
• MarantzPMD325
DVD (Digital Video Disc) Players
• AdcomGDV850
• DenonDVD2900
• DenonDVD3800
• DenonDVD9000
• FaroudjaDVP-1500
• IntegraDPS9.1
DXP-PRO v1.1 - Programmer’s Guide
7
Introduction
Lighting
• IntegraRDV1
• KenwoodDV5900M
• MarantzDV8400
• MarantzPMD930
• MarantzVC5400
• OnkyoDVS939
• PhilipsPro DVD 175
• SonyDVP-CX777ES
• YamahaDVD-C940
• YamahaDVD-S2300MK2
•AMX ALD-D48
• AMX Radia
• Clipsal C-BusNote: The Clipsal C-Bus and Dynalite lighting systems
• DynaLite - Any DTK Series
• Lehigh DX2
• LiteTouch 5000LC
• Lutron GRAFIK Eye
• Lutron Homeworks Interactive
• Lutron RadioRA
• Vantage Qlink
• Tridonic DALINote: The Tridonic Lighting System type does not have
• Other Ethernet - user supplied/modified light
• Other Serial - user supplied/modified lights.axi
(DXP-PRO v1.1 or higher) are primarily used outside the U.S.
feedback; therefore, the buttons in DXP will not depress to
reflect feedback.
MAX - Integrated Content Servers by AMX
MAX-MMS and MAX-IMS media servers are supported for G4 touch panels only, via Ethernet
• MAX-IMS Integrated Music Servers (MAX-IMS500/1000/1500/2500)
DXP-PRO treats these devices essentially the same as any other Ethernet-controlled device (such as
MP3 players). To add MAX servers to a DXP-PRO project be aware that:
The MAX-MMS and MAX-IMS servers are controlled only by Ethernet and must be
used with AMX G4 touch panels.
The MAX-AVM A/V Module(s) connected to a MAX-MMS server must each be set to a
unique zone number (per server).
Refer to the MAX-MMS and MAX-IMS Installation Guides (available online at
www.amx.com) for details.
8
DXP-PRO v1.1 - Programmer’s Guide
If multiple MAX-MMS or MAX-IMS servers are used in a project, each server must
have its own unique IP Address.
An identical IP Address can't be assigned to more than one device, with the exception
of a MAX. A MAX unit can ONLY have an identical IP only if it uses different zones
per display name entry. Ex: A MAX-IMS assigned to IP Address 1.1.1.1 - Zone 1 can
exist in the same project as another MAX-IMS assigned to IP Address 1.1.1.1 Zone 2. If you assign to max units with the same IP Address and Output Zone, you
will receive an error message.
MP3 Players
• Audio ReQuestARQ2
• ImergeSoundServer·
• IntegraNAS-2.3 Net-Tune
• Marantz DH9300·
Plasma Displays
• HitachiCMP4201
• HitachiCMP5000
• Marantz PD5020D
• NEC42VP4
• RuncoPL43HDX
• RuncoPL50HDX
• RuncoPL61GX
• SamsungSyncMaster 403T
• SharpLCM3700
Introduction
Serial-Interface Devices
For a more concise list of supported A/V Switchers, Audio Conferencing, Video Conferencing,
Compact Disc Players, DVD Players, Plasma Displays, VCRs and Video Projectors, refer to the
DXP-PRO Supported Devices document, available online at www.amx.com.
User Interfaces
AMX Touch Panels (see the listing in the previous section).
Video Cassette Recorder (VCR)
• JVCSR-S365U
• Marantz MV8300
DXP-PRO v1.1 - Programmer’s Guide
9
Introduction
Video Conferencing Devices
• PolycomVS4000
• PolycomVSX8000
• TandbergTandberg 2500
• TandbergTandberg 6000
The supported Polycom Videoconference units are controlled only via Serial
(RS-232). Tandbergs have RS-232 and IP control available.
Video Projection Devices
• BarcoIQG300
• BarcoIQR300
• ChristieDigitalDS30
• ChristieDigitalRoadRunnerL6
• ChristieDigitalVistaS3
• Digital ProjectioniVision SXGA
•EikiLCXG200
• EpsonPowerLite7800p
• EpsonPowerLite811P
• EpsonPowerLite 8150i
• EpsonPowerLite8300i
• Hewlett PackardXP8010
• InfocusSP7200
• MarantzVP12S1
• MarantzVP12S2
• NECGT Series
•NECLT Series
• NECMT Series
• NECSX Series
• OptomaEzPro H55
• OptomaEzPro750
• OptomaEzPro753
• OptomaEzPro755
• RuncoCL710
• RuncoDTV1200
• RuncoVX1000ci
• RuncoVX5000c
• SharpPGA10S
• Sharp ElectronicsPGC45X
• Sharp ElectronicsXGV10XU
• Sharp ElectronicsXGC50X
• Sharp ElectronicsXGC60X
• SIM2HT300
• YamahaDPX1000
10
DXP-PRO v1.1 - Programmer’s Guide
Introduction
User Information Splash-screen
This dialog appears the first time DXP-PRO is launched, and prompts you to enter the user
information that will be used to identify the designer of the DXP-PRO project (Created By,
Company Name, Phone, and E-mail Address).
Once the information is entered, this dialog will not automatically be shown again at startup, but
can always be accessed via the Edit menu.
The checkbox at the bottom of this dialog can be selected to prevent the dialog from automatically
appearing when the program is started, even if no data has been entered.
This dialog is used by the Design XPress Professional software application to fill-in
some data within the project.
This means that if you do an initial installation of DXP-PRO you will be asked to enter
your information into the User Information dialog. Once this data has been entered,
you will not be asked for it again. Consecutive launches of the application display the
User Information dialog already populated with the pre-entered data.
If the application is at some point un-installed and then re-installed, you will be
prompted to re-enter you information.
If the No longer show on startup selection has been chosen/enabled, you will no
longer be asked to enter any user data into the User Information dialog.
DXP-PRO Main Screen
When Design XPress - Professional (DXP-PRO) is initially launched, the second dialog displayed
is the Main Screen (FIG. 1). Use the Main Screen as the starting point for creating new projects and
opening existing projects. The Main Screen also contains command buttons for copying projects
and deleting projects.
There are three main areas on the Main Screen: the Menu Bar, the Project Selection List, and the
Project Maintenance - Command buttons.
FIG. 1 Design XPress - Professional Main Screen
Version and build information for this version of DXP-PRO is listed in the lower right
corner of the Main Screen.
Before creating a new project, you should consider opening the sample project and
quickly going through the various Wizard dialogs to become familiar with the program.
DXP-PRO v1.1 - Programmer’s Guide
11
Introduction
Project Selection List
The Project Selection List is displayed on the DXP-PRO Main Screen (FIG. 1), along with the
Main menu and the Create New Project, Open Project, Copy Project, Delete Project, and Exit
command buttons.
Each Project is listed by Job Name, Revision, Description, and the date the project was Last
Updated. The projects can be sorted in ascending or descending order for each column. Sorting the
projects makes it easier to locate the current revision of a project or the last modified project. To
sort a column, click on the header cell for the desired column.
Clicking on the header cell will toggle the sort order between ascending and descending orders.
You can also set the sort order by selecting View > Sort Projects.
To open a project, select the project and click on the Open Project command button or
double-click on the selected project.
To delete a project, click on the project then press the Delete Project command button, or
the delete key on the keyboard. The Confirm Delete Request dialog requires you to
confirm deletion.
If a project is not exported before deleting, you will not be able to bring the project
back into DXP-PRO for modifications at a later date.
Right-click anywhere in the Project Selection List to open the Project Selection List
context menu (page 13), and select Sort to access the Project Sorting feature. The listed
projects can be sorted by up to four criteria in either ascending or descending order.
• None:By default, the sort options are all set to none (no sorting).
• Job Name:Sorts the projects by their Job Names.
• Revision:Sorts the projects by their Revision numbers.
• Description:Sorts the projects alphabetically based on the first character of the project
• Last Updated: Sorts the projects by their most recent save date and time.
Use the four sets of radio buttons to specify up to four sorting operations, in
description.
sequential order.
After the desired settings have been selected click the Sort button to return to the
sorted project list.
Each of the sort criteria options is based on project data that is either entered or
displayed on the System Information dialog.
Once a project has been selected, you can use the File menu or the Command buttons to Open,
Copy or Delete the project.
12
DXP-PRO v1.1 - Programmer’s Guide
Introduction
Project Selection List Context Menu
Right-click anywhere inside the Project Selection List (on the Main Screen) to open the Project
Selection List context menu, containing shortcuts to several project-related operations:
•New: Launches the Design XPress - Professional Project Wizard to create a new project. This
•Open: Opens an existing project. This is the same as clicking the Open Project command but-
•Copy: Launches the Copy Project dialog, which allows you to save a copy of the selected
• Delete: Deletes the selected Project file. The program prompts you to confirm this action before
•Import: Invokes the Select Import Design XPress Professional File dialog, which allows you to
•Export: Invokes the Export Project dialog, which allows you to specify a name and target
•Sort: Displays the Sort Options window, containing the various sort criteria that can be used
is the same as clicking the Create New Project command button (or selecting File >
New).
ton (or selecting (File > Open).
Project file under a new name. Use the options in the Copy Project dialog to specify a
Job Name and enter a description of the file copy. This is the same as clicking the Copy Project command button (or selecting File > Copy).
the project file is deleted. This is the same as clicking the Delete Project command
button (or selecting File > Delete).
• Note: If a project is not exported before deleting, you will not be able to bring the
project back into Design XPress - Professional for modifications at a later date.
locate and select a Project file to import. This is the same as selecting File > Import Project.
location for the exported Project file. This is the same as selecting File > Export Project.
to sort the Project Selection List. This is the same as selecting View > Sort Projects.
Main Screen Command Buttons
Create New Project: Click this command button to launch the Design XPress -
Professional Project Wizard. Use the Project Wizard to step through the process of
designing and configuring the system.
Open Project: Click to highlight a project in the Project Selection List, and click the
Open Project command button to open the selected Project. When a project is opened, the
first Wizard dialog (System Information) is displayed.
Copy Project: This option creates a copy of an existing Project, and allows you to give
the copy a new name (via the Copy Project dialog).
Delete Project: This option allows you to delete a Project from the Project Selection List,
and from your hard drive.
To remove a Project from the Project Selection List, without deleting the file
from your hard drive, export the file before deleting. Once exported, you can import the file back into DXP-PRO later. To export a DXP-PRO project, select File > Export
Project.
If a project is not exported before deleting, you will not be able to bring the project
back into DXP-PRO for modifications at a later date.
Exit: Click to exit the application.
DXP-PRO v1.1 - Programmer’s Guide
13
Introduction
Copy Project dialog
Click on the Copy Project command button (on the Main Screen) to invoke the Copy Project
dialog and save a copy of the selected file under a new name. Use the fields in this dialog to specify
a name for the copied project file (in the Job Name field), and to enter a description of the project if
desired (in the Description field).
Job Name is required, the Job Description is optional.
Version Information
Program version information is located on the DXP-PRO Main screen (under the Exit button). It is
important to have the version information when calling AMX Technical Support. The version
information will allow Tech Support to determine if software updates or patches may be available.
The top number (for example, c1.1.6) is the version number of the Configuration
Database. The Configuration Database determines what options are available in wizard
for different pieces of equipment.
The lower number (for example, v1.1 Build 103) is the version and build number of the
actual DXP-PRO application. A change in the Version number indicates a change in the
functionality of the application. A change in the Build number indicates an enhancement
in the current functionality of the current revision. Every change to the Version number
will also change the build number, but not every change to the Build number will change
the Version number.
DXP-PRO Menu Bar
There are four items in the menu bar (on the Main Screen):
File menu
Edit menu
View menu
Help menu
File Menu
The Design XPress - Professional (DXP-PRO) File menu contains several file control options:
•New:Launches the Project Wizard, to create a new DXP-PRO project file.
•Open:Opens an existing DXP-PRO project file.
•Copy:Allows you to copy the active project file. This option launches the Copy
Project dialog (see the above section for more information).
• Delete:Allows you to delete the selected Project from your hard drive.
• Import Project: Allows you to import a file into the Project Selection List.
• Export Project: Allows you to export the active Project.
•Exit:Exits the DXP-PRO application.
14
DXP-PRO v1.1 - Programmer’s Guide
Introduction
DXP-PRO maintains all of its projects in a single database. To move a project from one DXP-PRO
installation to another (for example moving a project from your desktop computer to your laptop),
you must Export the project from one computer and import the project on the other computer.
The New, Open, Copy, Delete and Exit options are also available via the command
buttons along the bottom of the Main Screen.
Edit Menu
The Edit menu provides several customizable settings for DXP-PRO:
• User
Information:
• CD Titles
Maintenance:
• Preferences:Opens the Preferences dialog, containing various global preference settings for
Opens the User Information dialog, where you can enter and save basic user
information for the active Project (User Name, Company Name, Phone and
E-mail Address).
The user's name and company are used to auto complete the Name and
Company fields within the Project Information dialog. The user's phone number
and e-mail address are not currently used, but are included for future DXPPRO features.
Opens the CD Titles Maintenance dialog, where you can add/remove and edit
CD information (Artist and Title), as well as automatically retrieve CD
information from an on-line CD database (via freedb.org, on an
Internet-enabled computer).
For more information on this dialog, refer to the Using the CD Titles Mainte-nance dialog section on page 58.
DXP-PRO, including enable/disable warning messages within the wizard,
setting a default NetLinx Master IP Address, selecting a progress bar style, and
selecting default folders for Projects and IR files.
View Menu
The View menu contains options for sorting the Project list:
•Sort
Projects:
Click to access the Project Sorting window. The listed projects can be sorted by
up to four criteria in either ascending or descending order.
Help Menu
The Help menu contains the following options:
• Contents:Opens the online help file.
•Web
Update:
• About:Displays the DXP-PRO splash screen. This screen displays the version and build
DXP-PRO v1.1 - Programmer’s Guide
Launches the Web Update application to search the AMX site for an update to the
DXP-PRO software. Selecting Yes will close DXP-PRO, begin the download of
the update, and run the installation of the update.
You must have an active Internet connection for Web Update to work.
numbers for DXP-PRO. The version and build numbers can also be found in the
lower right hand corner of the Main Screen.
15
Introduction
Before You Begin
The first step in defining the system is to run the Design XPress - Professional (DXP-PRO)
application. This Windows
site. With this wizard you define the locations of all equipment, the number of user interface
devices, lighting scenes, source equipment, etc.
There is one important note related to the use of lighting addresses. Lighting addresses consist of
both a keypad address and button. The keypad address is the address of the keypad for the lighting
system being used and must be represented in the format for that lighting system. The formats for
the supported lighting systems are listed below:
Lighting Address Formats
Lighting ControllerAddress FormatDXP-PRO Example
AMX ALD-D48 Lighting System N/A1 (greyed-out)
AMX RadiaAXlink Device ID (1-255)96
Clipsal C-BusGroup Address:Network Address (using a
based wizard should be run in the office well in advance of going on-
C1:00
hexadecimal value and a local network
address)
12
Note: Keypad address 12 is reserved as
the Serial RadioRA interface. This
interface is a virtual keypad, and does not
contain any buttons.
(3-digit hexadecimal value)
(valid range is 0 - 15)
1AD
0
16
Once the application entries are completed, the touch panel files, source code, NetLinx Studio
project file, text files (CD titles, etc.), and report file are all created.
Configuring your Program Preferences
Select Edit > Preferences to open the Preferences dialog, where you can specifically set various
user preferences for DXP-PRO. The options in this dialog include:
Show Splash Screen on Startup: A toggling option to show the DXP-PRO splash screen
when the program is started. If this item is not checked the splash screen can be viewed
by selecting Help > About.
Warning on duplicate Channel Preset Names and Channels: Alerts you to the creation
of duplicate channel preset names and channels. All Channel Preset names and channels
must be unique.
DXP-PRO v1.1 - Programmer’s Guide
Introduction
Warning on duplicate IP Addresses: Alerts you to the assignment of duplicate IP
Address to a device being controlled via an Ethernet connection. All IP Addresses being
used by Ethernet-capable devices must be unique.
Warn on duplicate IR Functions and Channels: Alerts you to the creation of duplicate
IR functions and Channels. All IR Function and Channel assignments must be unique.
Warn on duplicate Lighting Scene Names: Alerts you to the creation of duplicate
Lighting Scene names. All Lighting Scene names must be unique.
Auto Map IR Function on File Selection: With this option enabled, the Auto Map IR
Functions option (in the IR Mapping tab of the Device Configuration dialog) is enabled
by default.
Progress Status Size: Use the radio buttons to select the size and style of the progress
bar:
Small (animated progress list): By default, the program uses the small progress
bar.
Large (gears): This option displays an animated graphic (representing working
gears) instead of the progress bar.
Detailed Import/Export Status: This option displays the name of each file as it is being
imported or exported, along the bottom of the progress bar window.
Project Folder: Click the Browse button to navigate to the desired target folder for all
Project saves. By default, the Project Folder is set to:
Program Files\AMX Control Disc\Design XPress Professional\Projects.
If you select a root directory (i.e. C:\) as the target directory, DXP-PRO automatically
creates a "Projects" folder for the project files. This folder is only created if you target
a root directory (as apposed to any other existing directory).
IRLib Path: Click the Browse button to navigate to the desired target folder for all IR
(*IRL) files. By default, the IR Folder is set to:
Program Files\Common Files\AMXShare\IRLs.
Default NetLinx Master: The IP Address field allows you to enter the IP Address of the
target NetLinx Master receiving the Project Files.
Getting Started with the Sample Project
To launch the DXP-PRO Project Wizard:
1. Select the sample project (highlight "DXP-PRO Sample" in the Project Selection List (on the
Main Screen).
2. Click the Open Project command button. This invokes the first Project Wizard dialog: System
Information, containing a summary of the system information for this project.
Once all the required information is entered in this dialog, you can proceed to the next dialog by
selecting the Next>> button. When no additional dialogs are required this button will be inactive.
DXP-PRO v1.1 - Programmer’s Guide
17
Introduction
When creating a new project it is important to go through each dialog in order, using the Next>>
button. This helps to insure that no information is missed and that the project configuration is
complete. Later, when editing the project, the Jump to list allows quicker and easier access to
specific dialogs.
When you create a new project, the Wizard dialogs become available as selections in
the Jump To list only after they have been populated with the required data. In this
case of the sample project, all Wizard dialogs are available since the project is
complete.
To Create a New Project:
1. Click on the Create New Project command button. This launches the Design XPress -
Professional Project Wizard, which steps you through the process of designing and configuring
a control system. Refer to the Launching the DXP-PRO Project Wizard section on page 20 for
more information.
18
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Design Xpress - Professional (DXP-PRO) uses a Project Wizard to step you through the process of
designing a control system. To launch the Wizard, click the Create New Project button on the
Main Screen.
Required Information for Building a System
Before you can begin to use Design XPress - Professional (DXP-PRO) to build a system you must
first gather information about the installation. The most obvious is the project name and a
description of the project. Additionally, you will need the following information:
A list of user interfaces (Touch Panels) models being used.
A list of the audio and/or video sources that will be used (along with a list of their
input/output locations on the switcher(s)). The type of DSS system and a list of channel/
music favorites, if a DSS receiver is included in the system. (DXP-PRO can include
either a DirecTV or Dish Network system.)
If a CD changer is included in the system a list of the installed CDs or the CD collection
should be available while creating the system.
Using the DXP-PRO Wizard
The following information is needed for each type of lighting system supported by
DXP-PRO: system type, baud rate (if applicable), system address, and button or preset
numbers.
The lighting system should be configured and programmed before button or preset
numbers are entered into DXP-PRO.
This information can be collected in multiple lists or in some instances can be drawn on a floor
plan. Several worksheets are included in the DXP-PRO help file to assist you in collecting this
information.
Common Mistakes
The most common mistake made is modifying the software and then using the application to make
changes. As mentioned before, all software changes outside of the special CUSTOM.AXI file will
be overwritten. Only modify the source code generated by DXP-PRO if there is a strong desire to
alter the behavior of the code. To add features, new subsystems, etc. make the changes in the
custom file to avoid the frustration.
DXP-PRO is not a "simple" NetLinx program. Because of the scope and number of features
designed into the system, the code can be quite daunting to someone looking at it, even an
experienced NetLinx programmer. Installers with NetLinx experience should not expect to be able
to modify the software the first time they see it. Most of the features are tied into another feature or
affect another part of the software. The architecture of the system design and the function of the file
being modified should be understood prior to proceeding with changes.
Another common mistake is forgetting to properly address a device. Unless all devices are
addressed as defined in the report file the system will not work as desired.
XP-PRO v1.1 - Programmer’s Guide
19
Using the DXP-PRO Wizard
Launching the DXP-PRO Project Wizard
Design XPress - Professional (DXP-PRO) uses a Project Wizard to step you through the process of
designing and configuring a business-room oriented control system. This is done through the use of
configuration dialogs (described in the following sections).
There are three ways to approach launching the DXP-PRO Project Wizard:
This invokes the first Project Wizard dialog: System Information, containing a summary of the
system information for this project. If you are starting a new project, the Created By and Company
fields are pre-populated with the information entered in the User Information dialog at startup.
Also, there are two default devices (an A/V Switcher and a Video Projector) present in the Device
Information table, ready for you to configure (see the System Information topic for details).
To create a new project, click on the Create New Project command button. This launches the
Project Wizard, which steps you through the process of designing a control system.
Select File > New.
Click the Create New Project command button (in the lower-left corner of the Main
Screen).
Double-click on the sample project ("DXP-PRO Sample Project") in the Project Selection
List.
At the lower-left corner of this and all Wizard dialogs is a drop-down list titled Jump To.
Click the down-arrow to open a list of all Wizard dialogs, and select any dialog from this
list to jump to that dialog.
Additionally, all of the dialogs in the Project Wizard have a set of Navigation Control
buttons along the bottom of the dialog to allow you move back and forth through the
wizard dialogs, and save or cancel your changes.
When you create a new project, the Wizard dialogs become available as selections in
the Jump To list only after they have been populated with the required data. In this
case of the sample project, all Wizard dialogs are available since the project is
complete.
Some of the Project Wizard configuration dialog include:
System Information (page 22)
Which Screens? (page 41)
Integrated Applications (page 42)
Lighting Presets (page 44)
Touch Panel Interfaces (page 46)
Choose Touch Panel Theme (page 49)
20
Selecting a custom touch panel theme adds 3 more Choose Touch Panel…options to the Which
Screens dialog and to the Jump to drop-down menu
Choose Touch Panel Background (page 50)
Choose Touch Panel Buttons (page 50)
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Choose Touch Panel Text Colors (page 51)
Input Names (page 51)
Switcher Inputs/Outputs (page 52)
Channel Preset Categories (page 55)
Channel Presets (page 56)
CD Titles (page 57)
DVD Titles (page 59)
Relay Control (page 59)
Navigation and Routing Macros (page 61)
System Macros (page 65)
At the bottom of each Wizard dialog is a set of Navigation Controls. The results of the DXP-PRO
project are placed in "Projects\Job Name\Rev #", within the application directory.
Project Wizard Navigation Controls
As dialogs in the DXP-PRO project are completed, those dialog names are added to the Jump to
list.
The Cancel button will cancel the current session and return to the Main Screen. You will
be prompted to save your changes or exit without saving.
You can also go to the previous dialog by selecting the <<Back button. The only time this
button is not active is at the System Information dialog.
Once all the required information is entered you can proceed to the next dialog by
selecting the Next>> button. When no additional dialogs are required this button will be
inactive.
When creating a new project it is important to go through each dialog in order, using the
Next>> button. This helps to insure that no information is missed and that the project
configuration is complete. Later, when editing the project, the Jump to list allows quicker
and easier access to specific dialogs.
When DXP-PRO has collected all the information necessary to program the project the
Finish button will be activated. When this button is selected you will be prompted to save
the project. The Finish button initiates the generation of the Touch Panel files and the
NetLinx code, and should only be selected when all of the project information and
configuration is complete.
The results of the DXP-PRO project are placed in "Projects\Job Name\Rev #", in the application
directory.
XP-PRO v1.1 - Programmer’s Guide
21
Using the DXP-PRO Wizard
System Information Dialog
The first dialog in the Project Wizard is the System Information dialog (FIG. 2). This dialog
contains the information used by Design XPress Professional (DXP-PRO) version 1.1 to create and
program the control system. Double-click on any device in the list to access the Device
Configuration dialog, containing all control information associated with the device.
FIG. 2 System Information dialog
The following list describes the items in the System Information dialog:
Note that since the Job Name, Created By and Company names are also used in the NetLinx
program, the characters that you are allowed to use are A-Z, a-z, 0-9, - and _. These fields are all
limited to 40 characters.
•Job Name:Enter the name of the project here. Each new project should be given a
• Created By:This field is pre-populated, if this information was entered in the User
•Company:This field is also pre-populated, if this information was entered in the User
• Description:Enter a description of the project here (8190 characters maximum). Any
• Lighting System:Click the down-arrow to open a drop-down list of lighting systems
unique Job Name and Description.
Information dialog. Otherwise, enter or edit the name of the project author
here.
Information dialog. Otherwise, enter or edit the name of the company here.
alphanumeric character (including punctuation) can be used. Each new
project should be given a unique Job Name and Description.
supported by DXP-PRO. Select the lighting system you are using, or select
No Lighting Control (at the top of the list) if your project does not include
any lighting control.
Additional fields may be displayed depending upon the device configuration requirements of the selected lighting system. For example, the
LiteTouch 5000LC displays a combo box to select the baud rate for communications with the LiteTouch controller. However, the AMX Radia system does not have a Baud Rate combo box because it communicates via
AXlink.
In addition to selecting the lighting system, DXP-PRO will automatically
select the default baud rate if applicable. You can manually set the baud
rate for non-standard systems.
22
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
• Volume Control
Display Names:
•Device
Information
(Maximum of 32):
Enter a descriptive label for each of the two different sets of controllable
volume popup pages. Any alphanumeric character (including punctuation)
can be used. Each new project should be given a unique Primary and
Secondary Volume Control Display name.
The Primary and Secondary Volume controls allow you to control
2 separate volume zones. They are represented as two separate touch
panel popup pages within the touch panel project.
• Primary Volume control field - A descriptive field that labels the control of
the primary volume levels coming out from Port 1 on the NXC-VOL4 card
(device address 5500). These audio signals could come from a source
device such as program speakers.
• Secondary Volume control field - A descriptive field that labels the control
of the secondary volume levels coming out from Port 2 on the
NXC-VOL4 card (device address 5500). These audio signals could
come from a series of ceiling speakers carrying the conference volume.
• Note: If you want to use an NI-4000 card slot for the NXC-VOL4, all
Device addressing DIP switches must be turned On. This will put the first
card slot address at 3061, which is the device address the wizard will
print out if you select an NI-4000 as the Master controller. Because the
NI-700 does not have an ICSNet connector, it cannot use an
NXC-VOL4 but can use an AXB-VOL3.
This table displays a list of all controlled devices currently in this system
(maximum of 32 devices). The devices defined here determine the dialogs
and information required by the rest of the Project Wizard.
Every device that will be controlled by the DXP-PRO system needs to be
defined within the Device Information list. The setup and configuration of
the devices is handled on subsequent dialogs in the Project Wizard, but
each device will be listed along with its Display Name, Control Method and
Control Logic, if any.
Note: In addition, any uncontrolled devices, such as computers, that have
a switcher input or output should be defined in the Device Information list.
The Device Information List can be sorted by clicking on the column's
header cell. Clicking on the header cell will toggle between sorting in
ascending or descending order.
Click the Add button to add a device to the list, via the Device Configuration dialog.
The Device Configuration dialog is used to add or edit devices in the Device Information
List. Use the options in this dialog to select the device type, the display name, control
method and other information specific to the control method.
Select a device from the list and click the Edit button to edit the control information
associated with that device. You can also edit a device by double clicking on a device.
Click the Duplicate button to duplicate a selected source and its current settings.
Select a device from the list and click the Delete button to delete that device from the list
and remove it from the project.
Certain device types, such as audio or videoconference, support just one instance they can not be duplicated. Therefore, the Duplicate button will be disabled when a
device of this type is selected.
XP-PRO v1.1 - Programmer’s Guide
23
Using the DXP-PRO Wizard
Adding a Device to the Project
To add a device to your system, click the Add button in the System Information dialog. This opens
the Device Configuration dialog - Device Data tab.
In the Device Data tab:
1. Select the type of equipment you are adding from the Source Type drop-down list.
2. Enter a name for the device in the Display Name field. This is the name for the device that will
appear on the touch panel.
3. If the device is a Compact Disc Player or Digital Video Disc player, specify the size of the disc
changer (if applicable; by default this field is set to 1).
4. Use the radio buttons to select the Control Method associated with the new device (IR,
Serial, IP, or AXlink).
The control methods available for selection depend on the device type specified.
For example, if you select DVD Player, the only available control method options are
IR and Serial (the remaining radio buttons are disabled).
If IR is selected, you must locate the associated IRL file by using the Browse button
from the IR Data section. If you are using Serial as a Control Method, choose the
device from the Control Logic drop-down list.
Adding IR-Controlled Devices to the Project
To add a device to your system, click the Add button in the System Information dialog. This opens
the Device Configuration dialog - Device Data tab.
In the Device Data tab:
1. Select the type of equipment you are adding from the Source Type drop-down list.
2. Enter a name for the device in the Display Name field. This is the name for the device that will
appear on the touch panel.
3. If the device is a Compact Disc Player or Digital Video Disc player, specify the size of the disc
changer (if applicable; by default this field is set to 1).
4. Use the radio buttons to select IR as the Control Method associated with the new device.
The control methods available for selection depend on the device type specified.
For example, if you select a Digital Satellite System, the only control method option is
IR (the remaining radio buttons are disabled).
5. Associate an IR code file (*IRL) to the new device (IR-controlled devices only):
Click the Browse button to locate and select the appropriate IR file via the Select IR File
dialog.
Click the Search button (binoculars) to search for the appropriate IR file, via the Search
for IR File dialog.
24
6. Once an IR file has been selected, note that the Manufacturer, Hand Control Model #, Device
Model # and Info fields are automatically updated to show any property-level file information
that was associated with the selected IR file when it was created.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
7. Use the up and down arrows to adjust the IR pulse time (in .10-second increments) in the IR
Pulse field. The default setting is .5 seconds.
8. Open the IR Mapping tab of the Device Configuration dialog to assign IR function/channels
to Touch Panel functions:
a. Click the Auto Assign button to automatically assign IR Functions to Touch Panel
functions. In most cases, this should be sufficient. However, you can use the IR Mapping
tab to manually assign IR Functions to Touch Panel functions.
b. Select the Touch Panel function that you want to associate an IR Function to (in the right-
hand table).
c. Select the IR Function that you want to assign to the selected Touch Panel function (in the
left-hand table), and click the right arrows button to copy the selected IR Function to the
selected Touch Panel function.
Inversely, you can manually remove any IR functions from Touch Panel functions by
selecting a Touch Panel function (from the right-hand table), and click the left-arrows
button.
When adding multiple devices of similar type to a Project, in some cases the devices
could have very different requirements in terms of functionality and associated Touch
Panel pages/buttons. For example you could set up a high-end model DVD player
with full functionality and a second one with only basic DVD transport control. The
Design XPress - Professional TPD pages for both devices will show the same
number of buttons, but many buttons for the second DVD will not work, because
functions weren't mapped to them.
Try to keep the number of functions for multiple same-type devices as close as
possible, for ease-of-use for the end user.
Adding Serial-Controlled Devices to the Project
To add a Serial-controlled (RS-232) device to your system, click the Add button in the System
Information dialog. This opens the Device Configuration dialog - Device Data tab.
Be aware that the target NetLinx Master device being used by the project should be able to support
the number of Serial devices being added to the system. For example, if 4 Serial devices were
added to a System (where they directly connect to the Master), then an NI-700 would be greyed-out
out during the final compile process because an NI-700 only support 2 Serial connections. But if
the Serial devices (such as a Camera and Projector) were communicating to the Master via external
serial interfaces, then an NI-700 could be used in conjunction with an AXB-232++. The following
graphics provides a visual example of these scenarios:
XP-PRO v1.1 - Programmer’s Guide
25
Using the DXP-PRO Wizard
COM 1 Port 1
AXlink # 96
External Serial
Interface
CAM 1
FIG. 3 External serial interface usage
It is first necessary to understand that the NI-700 is limited to direct communication via
Screen 1
PROJ 1
COM 3 Port 1
AXlink # 98
Distance is so close - you could use same serial interface
COM 3 Port 2
AXlink # 98
Screen 2
PROJ 2
COM 2 Port 2
AXlink # 97
External Serial
CAM 2
2 available Serial ports. If more Serial devices are added to a project that requires direct
communication to a Master, the NI-700 option is then greyed-out from the list of
available choices during the final project build process (using the Finish button).
Interface
If the cable run distance from the COM port and the external Serial device is too far, it is
recommended that you assign a different COM port within the Use remote serial
interface drop-down list (as seen in the FIG. 3 with CAM1 and CAM2).
If the cable run distance from the serial interface and the external Serial device is close
enough, you can use both ports on the serial interface (as seen in FIG. 3 with Projector 1
and Projector 2).
These external Serial devices communicate via the external serial interfaces to an
AXB-232++ and are not directly communicating with a Master (NI-700); therefore, these
interfaces do not consume Serial communication ports on the Master. This device
configuration can function with an NI-700 when all of the Serial communications are
routed from the external serial interfaces through an AXB-232++ RS232/422/485.
The AXB-232++ provides a way to bridge the gap between an NI-700 (with no ICSNet
port) and the external serial interfaces, but when working with the RS232/422/485
device, the end-user must use the AXlink device IDs generated by DXP-PRO (as seen
below each COM port assignment).
This device ID information is saved along with the COM port assignments and if another
Master device is later chosen as the target Master, the COM port assignments will be
reflected within the project report and used by the project wizard.
26
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
The above example uses 3 NXC-COM2 cards for communication to the external Serial
devices. If any of the other Master devices (NI-Series and ME260/64) are selected, then
there will be no need to aquire an AXB-232++ or utilize the AXlink Device IDs, as these
other Masters contain an ICSNet communication port. So to change the need to use an
AXB-232++, simply choose a Master other than the NI-700.
To add the Serial device within the Device Data tab:
1. Select the type of equipment you are adding from the Source Type drop-down list.
2. Enter a name for the device in the Display Name field. This is the name for the device that will
appear on the touch panel.
3. Use the radio buttons to select Serial as the Control Method associated with the new device.
When you select a desired CD/DVD model from the Control Logic field, the changer size is
automatically filled and no longer alterable (greyed-out).
The control methods available for selection depend on the device type specified.
For example, if you select a Camera, the only control method options are Serial and AXlink (the remaining radio buttons are both disabled).
4. Select the required baud rate for the Serial device from the Baud Rate drop-down list.
Adding Ethernet-Controlled Devices to the Project
To add a device to your system, click the Add button in the System Information dialog. This opens
the Device Configuration dialog - Device Data tab.
In the Device Data tab:
1. Select the type of equipment you are adding from the Source Type drop-down list.
2. Enter a name for the device in the Display Name field. This is the name for the device that will
appear on the touch panel.
3. Select the number of desired Output Zones.
Good examples of Ethernet capable devices are the MAX units.
4. Use the radio buttons to select IP as the Control Method associated with the new device.
The control methods available for selection depend on the device type specified.
For example, if you select an MP3 player, the only control method option is IP (the
remaining radio buttons are disabled).
If the option to "Warn on duplicate IP Addresses" has been selected from the Edit > Preferences dialog, anytime you try to assign a duplicate IP Address to an Ethernetcontrollable device, you will be prompted with a pop-up dialog.
5. Select the specific device from the Control Logic drop-down list.
6. Enter the IP Address of the Ethernet-controlled device.
XP-PRO v1.1 - Programmer’s Guide
27
Using the DXP-PRO Wizard
Adding a MAX-IMS or MMS Server to the Project
To add the MAX device to your system, click the Add button in the System Information dialog.
This opens the Device Configuration dialog - Device Data tab.
In the Device Data tab:
1. Select AMX MAX from the Source Type drop-down list.
2. Enter a name for the device in the Display Name field. This is the name for the device that will
appear on the touch panel.
3. Select the Control Logic, based on which type of MAX server you are adding (either IMS or
MMS).
4. In the IP Data field, enter the MAX server's IP Address.
The default IP Address for the IMS and MMS servers is 192.168.1.30.
5. Select an Output Zone number, which must be unique per each server used in a project.
For example, if a system has two MMS servers, each MMS could have an Output Zone 1.
An identical IP Address can't be assigned to more than one device, with the exception
of a MAX. A MAX unit can ONLY have an identical IP only if it uses different zones
per display name entry. Ex: A MAX-IMS assigned to IP Address 1.1.1.1 - Zone 1 can
exist in the same project as another MAX-IMS assigned to IP Address 1.1.1.1 Zone 2. If you assign to max units with the same IP Address and Output Zone, you
will receive an error message.
Working with MAX Servers
DXP-PRO supports MAX-MMS and MAX-IMS media servers.
DXP-PRO treats these devices essentially the same as any other Ethernet-controlled device (such as
MP3 players). There are just a few points to understand in order to add MAX servers to a
DXP-PRO project:
The MAX-MMS and MAX-IMS servers are Ethernet-control only.
They must be used with AMX G4 touch panels (refer to the Supported Touch
Panel s section on page 5).
The MAX-AVM A/V Module(s) connected to the MAX server must each be set to a
unique zone number (per server).
If multiple MAX-MMS or MAX-IMS servers are used in a project, each server must have
a unique IP Address.
Refer to the MAX-MMS and MAX-IMS Installation Guides (available online at
www.amx.com) for details.
28
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Duplicating a Device
DXP-PRO supports duplicating existing source devices and their settings via the Duplicate button
on the System Information dialog. Use the Duplicate feature to make a copy of the currently
selected device, to allow for quick configuration for systems with multiple identical devices.
The Duplicate button is only enabled once a device (DVD, CDP, MP3 player etc.) is
added to the project, and only if DXP-PRO supports multiple devices of that type.
The program will not allow you exceed the maximum number of instances of the selected
device type. For example, if the system contains two switchers, the maximum number of
A/V Switchers allowed is two. In this case, the Duplicate button is disabled.
To duplicate an existing source device and its current settings:
1. Select a source device in the System Information dialog.
2. Click the Duplicate button
3. A duplicate of the selected source device is added to the Device Information table in the row
below the selection.
4. When a source is duplicated its "Display Name" will be truncated to 13 characters and "_00"
added, where 00 is next sequential number for that display name. For example, if you
duplicated a source with the Display Name "DSS", the resulting duplicate source would have
the Display Name "DSS_1".
Device Configuration Dialog
The Device Configuration dialog (FIG. 4) is used to add or edit devices in the Device Information
List. Use the options in this dialog to select the device type, the display name, control method and
other information specific to the control method.
Click the Add button in the System Information dialog to open the Device Configuration
dialog to configure a new device.
Select a device from the Device Information table (in the System Information dialog) and
click the Edit command button (or double-click on a device in the table) to open the
Device Configuration dialog and begin editing.
When a non-IR controlled device is selected, only the Device Data tab is displayed.
When a device using IR Control is selected for editing, the Device Configuration screen divides out
into four tabs: Device Data, IR Mapping, Control Configuration and Pow e r Con t rol :
Device Data tab: Contains fields that specify the device type, device display name,
control method, and control data for a controlled device in the project.
IR Mapping tab: The options in this tab help to insure that the button you press on the
touch panel does what you expect. This tab is where you specify the IR Mapping for the
selected device.
XP-PRO v1.1 - Programmer’s Guide
29
Using the DXP-PRO Wizard
Device Configuration dialog - Device Data tab
Control Configuration tab: The options in this tab are used to configure the AMX IR
port to properly transmit the IR signal to the AV equipment. This tab requires that you
know how your equipment operates. Note that the Control Configuration tab is only
applicable if:
The selected device is IR-controlled (IR was selected as the Control Method in the
Device Data tab).
An IR file has been associated with the device (via the IR Data options in the Device
Data tab).
Power Control tab: The options in this tab allow you to configure power control for the
AV equipment. This tab requires that you know how your equipment operates.
30
FIG. 4 Device Configuration dialog (Device Data tab)
These options in the Device Data tab allow you to associate a control method to a new device in the
system. The options in this tab include:
The Device Data section is used when defining a source you must first define the type of
the source. The Source Type determines what pages are added to the touch panel file and
what control functions are assigned to the device. The Display Name is used with the
touch panel menus to reference the device. Each Display name should be unique to
differentiate the devices in the wizard and on the touch panel.
There are several devices that have device specific options that become visible when the device is
selected.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Source Type: Click the down-arrow to open a drop-down list of available device
types (Compact Disc Player, Digital Satellite System, Digital Video Disc Player,
etc). Click to select the device type that matches the device you are adding to the
project.
The User Defined Input and AUX/PC options (from the Source Type drop-down list)
are intended for use with auxiliary devices that can be accessed, but not controlled by
the Design XPress - Professional system (i.e. computers, security cameras, etc). If
you select User Defined Input or AUX/PC as the Source Type, the Control Method
and Data options are disabled, since the device is not controlled by the system.
Either of these options will perform the same function; they allow for the switching of an
uncontrolled device. Using the AUX/PC option provides a menu button for the device, and a touch
panel page alerting the user that the current device is uncontrollable. Selecting User Defined Input
allows the switching to occur without the menu item and a touch panel page.
This new version of DXP-PRO now supports external cameras, G4 Computer Control, and
i!-Weather as available Source Types. For more information refer to the following sections:
How to setup external cameras (page 33)
How to configure G4 Computer Control (G4CC) (page 34)
How to configure i!-Weather (page 35)
Display Name: Enter the name that you want to appear on the Touch Panel for this
device (15 characters max).
If you are designing for a CV6 panel, limit the text characters to 10 characters to avoid
text overflow on the button.
The control methods available for selection depend on the device type specified. For
example, if you select DVD Player, the only control method option is IR (the Serial
and IP radio buttons are both disabled).
Changer Size: Enter the value of the disc capacity available from the DVD/CD
player (450 max). If using a Serial connection, the Changer Size field is greyed-out.
Using Macro for Menu Navigation and Device Routing: This radio box option
enables the use of macros for menu navigation and device routing for the selected
device (within the Device Data tab). By selecting this option, an entry is added to the
Navigation and Routing Macros dialog. This entry can then later be modified if
necessary.
The Control Method section enables its options based upon the selected Source Type.
Most devices currently support IR, however, some devices support Serial (RS-232) or IP
communications through different Control Logics.
Control Logics are specific device behaviors that have been programmed into the
NetLinx Code either through Modules, System Calls or Include files. A list of the
applicable Control Logics will appear in the Control Logics combo box.
Control Method radio buttons: Use the radio buttons to specify the method of
XP-PRO v1.1 - Programmer’s Guide
control for this device (IR, Serial, IP/Ethernet, or AXlink). This selection determines
the other options that are enabled in this tab).
31
Using the DXP-PRO Wizard
The only Source Type that enables the AXlink Control Method are Cameras.
If either a Camera or Video Display (such as a Projector/Plasma and TV) are chosen
to be controlled via Serial (RS-232), two new fields become available within the
Device Data section. Place a checkmark in the Use remote serial interface field to
indicate you are using an external serial interface or leave it unchecked to use a
Serial port on the Master. If this option is checked, you can choose which port on the
COM card to use by choosing a port from the drop-down list. This was implemented
to communicate to some cameras and display devices that are not located near the
Master.
If IR is selected, you must locate the associated IRL file by using the Browse or
Search buttons. If you are using Serial as a Control Method, choose the device from
the Control Logic drop-down list.
Control Logic: Select a Control Logic option from this drop-down list, if applicable.
The IR Data section allows you to configure a number of settings for IR controlled
devices. The IR File field displays the currently selected IR file (read-only). You can
select an IR file using the Browse button or the Search button.
Search button (binoculars): Brings up the Search for IR File dialog, which allows
you to search by Manufacturer, Hand Control Model # or Device Model #.
Once an IR file has been selected the information about the IR file is extracted and is
displayed in the text fields below the IR File area (at the bottom of the Search for IR Files
dialog).
IR File: Use the Browse and/or Search buttons to locate and select the IR file to be
associated with this IR-controlled device. All options in the IR Data section of this
tab are disabled if Serial or IP were selected as the Control Method.
Manufacturer, Hand Control Model #, Device Model #, Info: These read-only
fields are populated with information, once an IR file has been associated with this
device. When any IR-controlled device is selected, three additional tabs become
available on Device Configuration dialog (IR Mapping, Control Configuration, and
Power Control).
The Serial Data section allows you to select the Baud Rate from a combo box. This
section will only be active when Serial is selected as the Control Method. The Power
Control tab appears depending on whether the device's control specification supports
power control.
Click the down-arrow to open a drop-down list of all supported baud rates for
Serial (RS-232) control.
Click to select the appropriate baud rate for the Serial-controlled device. This field is
only enabled if Serial was selected as the Control Method, and the baud rate used in
the Control Method does not have a default setting.
32
The IP Data section allows you to enter the IP Address of the device in the IP Address
field. The IP Port number is set within the Control Method and is not accessible. This
field is only enabled if IP was selected as the Control Method.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
An identical IP Address can't be assigned to more than one device, with the exception
of a MAX. A MAX unit can ONLY have an identical IP only if it uses different zones per
display name entry. Ex: A MAX-IMS assigned to IP Address 1.1.1.1 - Zone 1 can
exist in the same project as another MAX-IMS assigned to IP Address 1.1.1.1 Zone 2. But if you assign to max units with the same IP Address and Output Zone,
you will receive an error message.
How to setup external cameras (using Camera and Video Conference source types)
The development of an external camera type is used in tandem with a video conferencing unit. You
must first add a camera (directly or indirectly controlled) as a source type before that camera can
become available for later use. When later developing a Video Conference Source Type, the
previously entered cameras can now be selected as available controlled cameras from within the
Camera Control drop-down lists. This feature is only available on G4 touch panels.
For detailed information on using external Serial-controlled devices
communicating with an NI-700, refer to the Adding Serial-Controlled Devices to
the Project section on page 25.
1. From the System Information dialog, click the Add button to add a device to the list via the
Device Configuration dialog page.
2. From the Source Type field of the Device Data tab, click the Source Type down-arrow to open
a drop-down list of available device types.
3. Select Camera. Once complete, a series of user-configurable fields appear.
4. Enter a unique name for this camera within the Display Name field.
5. Select the Control Method.
A Serial connection implies direct communication to the target camera and can be done
via the use of an available COM port on a remote serial interface. This method is known
as a direct connection.
An AXlink connection implies an indirect connection to the external camera via an
AXB-PT Camera Controller. The Control Logic for this type of connection is limited to
an AXB-PT with servo or serial zoom. This method is known as an indirect connection.
6. For a direct connection type, select Serial for the Control Method.
Click the down-arrow adjacent to the Control Logic field.
Select from the list of available externally controlled cameras.
Choose whether you are using an external serial interface to control that camera by
placing a checkmark in the Use remote serial interface radio box.
Assign a port on the serial interface for use with the target camera.
If you want to use Macros, place a checkmark within the Use Macro for Menu
Navigation and Device Routing radio box.
XP-PRO v1.1 - Programmer’s Guide
33
Using the DXP-PRO Wizard
7. For an indirect connection type, select AXlink for the Control Method.
8. Click OK to complete the development of the new camera device.
9. From the System Information dialog, click the Add button to add a Video Conference device to
the list via the Device Configuration dialog page.
Click the down-arrow adjacent to the Control Logic field.
Select from the list of indirect camera control options: AMX AXB-PT w/servo zoom or
AMX AXB-PT w/serial zoom. The selected choice is dependent on both the camera
controller and the mounted camera.
Use of an externally located serial interface is not available when this form of
indirect communication is selected.
If you want to use Macros, place a checkmark within the Use Macro for Menu
Navigation and Device Routing radio box.
If the Power Control tab becomes available (camera specific), select whether you want
the System to constantly monitor power to the device (through the Govern Power radio
box) or the device to provide power state information (via the Device/Power Feedback
radio box).
Select the Power Sensing Method (if available).
10. From the Source Type field of the Device Data tab, click the Source Type down-arrow to open
a drop-down list of available device types and select Video Conference.
11. Enter a unique name for this video conferencing unit within the Display Name field.
12. Select whether the Control Method is either Serial (RS-232) or IP. An IP Control Method
allows you to enter information into the IP Data field relating to the location of the target
conferencing unit. Both types of Control Methods require that you use the down-arrow to
select an associated Control Logic for the conferencing unit.
13. If you want to use Macros, place a checkmark within the Use Macro for Menu Navigation
and Device Routing radio box.
14. From the Camera Control section, use the down-arrows to select a Primary and/or Secondary
Camera used by the conferencing unit. If an IP Control Method was previously selected, the IP
Data field now becomes user-editable and can have any IP Address entered within it.
15. Click OK to enter the information and return to the System Information dialog page.
How to configure G4 Computer Control (G4CC)
When using G4 Computer Control, it is important to understand that the DXP-PRO application
does not setup the stick applications for you. It is necessary to configure the corresponding
configCC and amxCC application information fields (regarding the Master and touch panels) prior
to compiling the DXP-PRO project. Any Master code alterations and configCC field entries must
be done prior to launching the amxCC executable.
34
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
When using G4 Computer Control, it is important to understand that DXP-PRO does
not setup the USB stick applications for you. It is necessary to configure the
corresponding configCC and amxCC application information fields (regarding the
Master and touch panels) prior to compiling the DXP-PRO project. Any Master code
alterations and configCC field entries must be done prior to launching the amxCC
executable.
Selecting a G4CC Source Type only configures the DXP-PRO application to be enabled to function
with G4CC-enabled touch panels. To configure:
1. From the System Information dialog, click the Add button to add a device to the list via the
Device Configuration dialog page.
If TakeNote was selected in the wizard, by default, TakeNote becomes enabled within
the G4CC panel page even before it is selected. To disable TakeNote, you must
navigate to the G4CC touch panel page, press the TakeNote Controls button, toggle
the Activate Annotation button (from within the TakeNote popup menu) to the Off
state, and press the Close button. To re-establish the TakeNote feature, return to the
TakeNote popup menu, toggle the Activate Annotation button back to the On state,
and press the Close button.
2. From the Source Type field of the Device Data tab, click the Source Type down-arrow to open
a drop-down list of available device types.
3. Select G4 Computer Control. Once selected, the Display name is greyed-out and reads
G4CC.
4. Click OK to enter the information and return to the System Information dialog page. For
further detailed information regarding the use of the G4CC USB stick, visit the www.amx.com
website.
How to configure i!-Weather
If the i!-Weather application is installed on a Master without a weather account, only AMX-related
locations are viewable within the i!-Weather setup page on the touch panel. To gain access to any
zip code's weather information, you must purchase a subscription from AMX.
To obtain this subscription, all you need is the serial number of your target Master. This appears on
the i!-Weather page on the panel (once the project is loaded). Another method of obtaining the
Master's serial number is by going into a Terminal session and typing 'show device'.
To configure:
1. From the System Information dialog, click the Add button to add a device to the list via the
Device Configuration dialog page.
2. From the Source Type field of the Device Data tab, click the Source Type down-arrow to open
a drop-down list of available device types.
3. Select i!-Weather. Once selected, the Display name is greyed-out and reads Weather.
4. From within the i!-Weather Data section, select from among the three different types of
available weather data (temperature, wind speed, and pressure).
5. Click OK to enter the information and return to the System Information dialog page.
XP-PRO v1.1 - Programmer’s Guide
35
Using the DXP-PRO Wizard
Device Configuration dialog - IR Mapping tab
The options in the IR Mapping tab (FIG. 5) help to insure that the button you press on the touch
panel does what you expect. IR files, especially custom IR files, do not always use the same
channel numbers for the same IR functions. As a result you must map each IR function for each IR
device in the system. If irregular functions occur in the finished system, it is a good idea to revisit
this tab.
FIG. 5 Device Configuration dialog - IR Mapping tab
It is also important to note that changing the IR mapping will affect subsequent configuration
dialogs. The IR Mapping tab is divided into two main areas: IR Function List and the Program
Function List.
The IR Function List is on the left side of the window. The IR file selected on the Device
Data tab is opened and all functions and their associated names and channel numbers are
listed.
The Program Function List is listed on the right side of the dialog. The Program
Function List is populated with the supported functions for the Device Type selected on
the Device Data tab.
Mapping a Function
1. Click on the desired IR function in the IR Function List and click on the associated function in
the Program Function List.
2. Then, click on the button with the three right facing arrows, ">>>", and the IR Function Name
and the Channel are copied across to the Program Function List.
36
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Removing a Mapped Function
1. Click on the button with the three left facing arrows, "<<<", and the IR Function Name will be
deleted and the Channel will be returned to its default.
The four command buttons across the bottom of the window are used to speed up the IR mapping
process:
Un-Map All - Returns all functions in the Program Function List to their default settings
and clears all IR Function Names.
Auto Map IR Functions - Pairs matching Channel numbers on the IR Function List and
the Program Function List; as well as copy across the IR Function Names.
The auto map IR function DOES NOT use text names to map. This feature maps the
expected channel number to the IRL channel number.
Un-Map Current Selection - Removes the IR Function Name for the selected item in the
Program Function List and resets the channel to the default channel number.
Function Not Used - Sets the IR Function Name to "Not Used" and zeros the channel
number for the item selected in the Program Function List. Any IR functions that are
either labeled as "Not Used", or that are unmapped (left with the default value of zero)
will not appear anywhere in the functions list or anywhere else, since they are considered
to be unused by the system.
The OK button saves the IR Mapping and returns to the System Information Page. The Cancel
button discards all changes and returns to the System Information Page.
When adding multiple devices of similar type to a Project, in some cases the devices
could have very different requirements in terms of functionality and associated Touch
Panel pages/buttons. For example, you could set up a high-end model DVD player
with full IR functionality and a second one with only basic DVD transport control. The
Design XPress - Professional TPD pages for both devices will show the same
number of buttons, but many buttons for the second DVD will not work, because
functions weren't mapped to them.
Try to keep the number of functions for multiple same-type devices as close as
possible, for ease-of-use for the end-user.
Device Configuration dialog - Control Configuration tab
The options in the Control Configuration tab (FIG. 6) allow you to configure the AMX IR port to
properly transmit the IR signal to the target equipment. The options in this tab require that you
know how your equipment operates.
IR Timing Parameters - Sets the IR pulse times and the time gap between pulses. The
default time is .5 seconds. Occasionally, this pulse time is too long and results in two
commands being sent. This is most evident on numeric keypads and menu cursor
controls. Use the up/down arrows to adjust the values, or enter new values directly into
the text fields (range = 0 - 255, in 1/10 second increments).
XP-PRO v1.1 - Programmer’s Guide
37
Using the DXP-PRO Wizard
FIG. 6 Device Configuration dialog - Control Configuration tab
IR Pulse Time - the length of time the IR signal is on and is being transmitted
(CTON).
Time Gap Between IR Pulses - the length of time between IR pulses. This is usually
used only in macro functions (CTOF).
Tune Using XCH Command - XCH Send_Commands are used to recall station presets
for the TV Tuner, VCR and DSS. Different manufacturers require the channel numbers to
be entered differently. Select the mode that matches your equipment. When this option is
selected, the following XCH Modes are available. Select the mode you want to use with
this device:
• Mode 0The resulting IR for the Send_Command ’XCH-3’ would be: 3-Enter.
• Mode 1The resulting IR for the Send_Command ’XCH-3’ would be: 0-0-3-Enter.
• Mode 2The resulting IR for the Send_Command ’XCH-3’ would be: 0-0-3.
• Mode 3The resulting IR for the Send_Command ’XCH-3’ would be: 0-3.
• Mode 4Mode 4 should only be used for channels 0-199, and sends the same IR sequences
as the CH command.
IR Carrier - Some devices (i.e. Sony Control-S devices) use a wired IR signal, instead of
using an IR emitter. In some cases, the signal is the same as is transmitted by the IR
emitter, but it does not transmit a carrier signal. This check box will turn on or off the
carrier signal. The default setting is On.
38
Wired IR - Enable this option if the wired IR device requires Mode Serial signals.
TREDnet on the AMX website (www.amx.com) will give you information on whether
your device uses IR carrier/Mode Serial signals or not.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Device Configuration dialog - Power Control tab
The options in the Power Control tab (FIG. 7) allow you to configure power control to the AV
equipment. This tab requires that you know how your equipment operates.
FIG. 7 Device Configuration dialog - Power Control tab
Device Supports Discrete On/Off - If you have mapped Discrete On/Off functions for
this device, you can select to enable support of Discrete On/Off.
Govern Power - This option enables governing power to the device, which means that
the System constantly monitors power to the device (for use with power sensors) rather
than simply toggling power On/Off.
Device/Power Feedback - This option enables the display of power status of the device
on the touch panel. If this option is enabled, use the radio buttons to specify a Power Sensing Method, based on the type of power sensor being used with the device (PSS2,
VSS2 or TVS).
Power Sensing Method - Activated by enabling the Govern Power option (above). Use
the radio button to select the method of power sensing being used. This available power
sensors include: PCS2 (Dual Power Current Sensor), VSS2 (Video Sync Sensor), and
TVS (TV Sensor).
IR Timing Parameters (1/10 Second) - Use the up/down arrows to adjust the time gap
between Power On and Power Off IR pulses, in 1/10-second increments (default = 50).
XP-PRO v1.1 - Programmer’s Guide
39
Using the DXP-PRO Wizard
Device Considerations when using New Features
When working with several of the new features available within DXP-PRO version 1.1, it is
necessary to note some special device considerations:
When developing a Video Conference Source Type (within the Device Configuration -
Device Data tab), you can now select whether the camera being used is either a vendor's
integrated camera or a third-party camera. But note:
You will not be able to select a third-party camera unless you have previously
defined a camera device in your system (see How To: Setup External Cameras).
Once you have defined a camera within your system, it then becomes visible/
selectable from the Camera Control section drop-down lists.
At this time, Polycom does not support third-party cameras. You can select a third-party
camera, but be aware that the far end will have no control over this camera. Control of
this third-party will only be local if a Polycom unit is selected.
If you define a Sony EVI-D series camera and a Polycom conferencer, you do not
need to select it as a third-party camera. This is because the Polycom unit controls
the Sony EVI-D series of cameras as though they were a native device through a
setting within the menu system of the Polycom unit.
If the i!-Weather application is installed on a Master without a weather account, only
AMX-related locations are viewable within the i!-Weather page on the touch panel. To
gain access to any zip code's weather information, you must purchase a subscription from
AMX.
To obtain this subscription, you all need the serial number of your target Master.
This appears on the i!-Weather setup page on the panel (once the project is loaded).
Another method of obtaining the Master's serial number is by going into a Terminal
session and typing 'show device'.
You can define your own time server by opening the Main.axs file, scrolling to the
i!-TimeManager section, and filling in the time server variable with the target IP Address.
By default, the time information from the atomic clock in Boulder, Colorado is used.
When using G4 Computer Control, it is important to understand that the DXP-PRO
application does not setup the stick applications for you. It is necessary to configure the
corresponding configCC and amxCC application information fields (regarding the
Master and touch panels) prior to compiling the DXP-PRO project. Any Master code
alterations and configCC field entries must be done prior to launching the amxCC
executable.
To utilize the RMS (Resource Manager Suite) within the Integrated Application dialog
page, you MUST first have the latest RMS SDK (software Development Kit) installed
on the machine running the DXP-PRO application. If the RMS SDK is not installed prior
to running the DXP-PRO application, these fields will be greyed-out and you will not be
able to enter any information.
40
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Which Screens? Dialog
The Which Screens? dialog (FIG. 8) is available for selection from the Jump To drop-down list
after pressing the Next >> button from the System Information dialog page; once the project has
been finished and re-opened.
FIG. 8 Which Screens? dialog
Use this dialog to specify which Project Wizard dialog screens (ex: DVD Tile, Relay Control,
etc…) to include in the Jump To list, to further simplify using the application. By default, all dialog
screens in the Select Screens to Visit section are selected.
Click the checkboxes to disable any dialogs that you don't intend to revisit for editing. Some dialog
screens include:
Integrated Applications (page 42)
Lighting Presets (page 44)
Touch Panel Interfaces (page 46)
Choose Touch Panel Theme (page 49)
Selecting a custom touch panel theme adds 3 more Choose Touch Panel options to
the Which Screens? dialog and to the Jump to drop-down menu.
Choose Touch Panel Background (page 50)
Choose Touch Panel Buttons (page 50)
Choose Touch Panel Text Colors (page 51)
Input Names (page 51)
XP-PRO v1.1 - Programmer’s Guide
41
Using the DXP-PRO Wizard
Once you have made your selections, click Back or Next to close this dialog.
Note that you can't disable the System Information dialog.
Integrated Applications Dialog
The Integrated Applications dialog (FIG. 9) allows you to configure i!-TimeManager and/or
Resource Manager functionality.
Before being able to use the features available on this page, the Resource Manager
Suite (RMS) should already be installed. If the Software Development Kit (SDK) has
not been properly installed, all selectable fields within this dialog are greyed-out and a
message will appear at the top of the dialog stating, "SDK not installed".
The RMS SDK requires that the latest version of the following applications be loaded
prior to installation: NetLinx Studio 2, TPDesign4, and TPDesign3.
Switcher Inputs/Outputs (page 52)
Channel Preset Categories (page 55)
Channel Presets (page 56)
CD Titles (page 57)
DVD Titles (page 59)
Relay Control (page 59)
Navigation and Routing Macros (page 61)
System Macros (page 65)
The Resource Manager section allows you to enter the information corresponding to the target
RMS server and associated NXA-UPS device. All queriable devices within the target environment
such as: source/display/switching devices and NetLinx devices (touch panels and NXA-UPSs) can
be monitored via the MeetingManager application only.
No scheduling capabilities are available through the DXP-PRO touch panels and must be done
through the actual RMS (Resource Manager Suite) application interface.
To enable online/offline notification, the programmer would need to write custom Resource
Manager NetLinx code within the DXP-PRO project file that is downloaded to the target Master.
The RMS application provides a Welcome touch panel page that can be enabled from within the
Touch Panel Interfaces dialog page via the Resource Manager Welcome Panel radio button being
enabled for a selected panel.
The Use Resource Manager option provides the ability to enable touch panel pages to
support the on-screen display of room schedules and appointments associated with the
target RMS server. If this option is selected, navigate to the Touch Panel Interface dialog
page and identify whether a selected panel is used for control or as an RMS Welcome
panel. No RMS support is included in G3 panels, except for the use of Welcome Panels.
The Server Host Name or IP Address is the IP information or resolvable host name for
the target RMS server. The following characters are not supported within this field:
` ~ ! @ # $ ^ & * () = + [ ] {} \ | ; : '" < > / ? and space are not allowed characters.
42
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
FIG. 9 Integrated Applications dialog
The Room Name/Location/Owner fields must be populated with descriptive
information that better specifies the location being monitored and queried. Information
must be entered into these fields prior to continuing with the Wizard. The following
characters are not supported within these fields:
the " and ' characters are not allowed.
The Monitor AMX NXA-UPS radio button allows you to monitor any communicating
NXA-UPS power supply units.
The Nominal Voltage drop-down list allows you to select from up to 8 voltage settings
ranging from 100 to 240.
Use the Temperature Scale radio buttons to select between Celsius and Fahrenheit.
The i!-TimeManager section allows you to enable the use of the i!-TimeManager remote time
server application which updates the time information on any communicating Master running the
i!-TimeManager code.
The Use i!-TimeManager radio button allows you to select a time zone and apply
Daylight Savings Time rules.
The Time Zone drop-down list allows you to assign a time zone.
The Automatically adjust clock for daylight saving changes radio button allows you to
enable the application to adjust the time for daylight savings.
XP-PRO v1.1 - Programmer’s Guide
43
Using the DXP-PRO Wizard
Lighting Presets Dialog
The Lighting Presets dialog (FIG. 10) sets up the available presets for the Lighting system selected
on the System Information page. There is a maximum of nine presets available. DXP-PRO does not
allow for individual zone control or the setting of presets, only the recall of existing presets.
FIG. 10 Lighting Presets dialog
The defined lighting presets appear in the Lighting Presets table. You can sort the presets by
clicking on the header cell for any of the columns. Clicking the header cell toggles sorting to either
ascending or descending order.
Click on a cell within the Lighting Presets table to select the preset for editing.
Select a Preset and click the up/down arrows to the right of the Lighting Presets table to
rearrange the order of presets.
The identifier entered into the Preset Name text box is the name that will be displayed on
the touch panel. No duplicates allowed (8 characters maximum).
The Address and Button Number fields correspond to either the lighting controller
address and the preset number (as with AMX Radia), or the address of the keypad and the
keypad button that will be emulated (as with the LiteTouch controller).
For the AMX ALD-D48, the Address field value is fixed at a value of one (1) and
greyed-out. This value corresponds to the Device ID of the keypad.
For the AMX Radia the address is the AXlink address of the Radia MC.
The only valid keypad address characters are 0-9, A-F, and : (colon). For reference,
here are the formats for the various supported lighting systems:
44
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
• AMX ALD-D48:x, where x is one (the Device ID value of the keypad).
• AMX Radia:x, where x is a positive integer (the AXlink device ID)
• Clipsal C-Bus:x:y, where x,y are Hex values (ex. A1:D4)
• DynaLite:x, where x is a positive integer
• Lehigh DX2x, where x is the Lehigh area (valid range is 1 -16)
• LiteTouch 5000LC:abc, where abc is a 3 nibble Hex value (ex. A3E)
• Lutron GrafikEye:x, where x is a positive integer
• Lutron Homeworks Interactive: x:y:z, where x,y,z are positive integers
• Lutron RadioRA:x, where x is a positive integer
• Tridonic DALIx, where x is the Tridonic group address (valid range is 0 - 15)
• Vantage:x:y, where x,y are positive integers
The Button # refers to the button number or scene number the Design XPress system is
to emulate when communicating to the lighting system.
For the AMX Radia, the button # is the scene number to be recalled when this scene
is selected on the touch panel.
For Clipsal C-Bus and Dynalite systems (used primarily outside the U.S.), the button
# consists of the button number plus the fade rate, separated by a semicolon. For
example:
•(C-Bus): K:P:[A4:E1]:75:8 indicates network $E1, group address $A4, go to 75% at 8-second fade rate.
• (Dynalite): K:P:[14]:12:25 indicates area #14, go to preset scene #12 at 25-second fade rate.
When using AMX Radia - Scene 6 is always off. If you are not utilizing lighting scenes
with a DMS Keypad, leave it blank. If you are not utilizing the lighting scenes feature,
leave all of these fields blank. This does not apply to the ALD-D48.
Note for ALD-D48 Lighting Systems
The ALD-D48 is now a native NetLinx device that is controlled by Send Commands (commands,
strings, and channels), so each button on the touch panel or keypad corresponds to a specific
dimmer.
The D48 is not exactly an ICSNet device. It is connected to a standard Ethernet port and is
configured to point to the Master. The ALD-D48 is given a NetLinx Device ID so when the NetLinx
control system wants to manipulate the D48, a command is sent or a channel is changed on the
D48's NetLinx Device ID.
For instructions on developing NetLinx code to program scenes for the D48, refer to Tech Note #
TN 543, available via (www.amx.com > Dealers > Tech Center > Tech Notes).
For detailed configuration information on the ALD-D48, refer to the ALD-D48 Network Lighting
Solution Instruction Manual, also available via (www.amx.com > Dealers > Tech Center > Tech Docs > Instruction Manuals).
XP-PRO v1.1 - Programmer’s Guide
45
Using the DXP-PRO Wizard
Note for Radia Lighting Systems
On Radia lighting systems, channels 1-128 represent Radia lighting presets 1-128. If a channel is
on, then the corresponding preset is on. However, on startup NetLinx resets all channels to 0 (OFF).
Radia does not report the status of its channels when the Master comes up, and consequently the
software believes the state of all of the presets is OFF. Therefore, until a preset changes in the
system, the channel states are not reported.
It is important to have the Lighting Preset information prior to finishing the project.
Enter a new Preset Name, Address and Button Number, and click the Add button to add a
new preset to the bottom of the list.
Select a Preset in the list and click the Delete button to delete that preset from the list.
The Insert button inserts a new preset at the order number of the currently selected
preset.
Click the Apply button after editing a preset to apply the changes.
The Clear button clears the Preset Name, Address and Button Number information for a
selected preset.
Touch Panel Interfaces Dialog
Design XPress - Professional (DXP-PRO) requires that at least one touch panel is defined within
the system (FIG. 11). You can define up to 8 touch panels in the system.
The default
panel Device
ID is 10501.
Each
consecutive
panel that is
added to the
project
increments
this value by
a value of 1.
Determines
the menu
bar on the
panel
Excludes
these menu
items from
being
displayed
on the panel
46
FIG. 11 Touch Panel Interfaces dialog
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
These choices dictate the touch panel files that are created by DXP-PRO and then
later available for download to the desired touch panel via the TPD4 application.
These touch panel files are later listed within the User Interface folder of active
DXP-PRO project shown within the NetLinx Studio Workspace tab.
The Touch Panel Interfaces table can be sorted by clicking on any of the three column header cells
(Panel ID, Display Name and Ty pe). Clicking the header cells toggles between sorting the column
in ascending or descending order. Clicking on any of the cells within the list selects the touch panel
for editing.
The Panel ID is an arbitrary reference to the touch panel and is not the Device ID. You
can find the Device ID in the report generated by DXP-PRO.
The Display Name is the reference to the touch panel that is used in the installation
report.
The PanelType determines which touch panel files get modified and added to the
NetLinx Studio Project. There are several supported panel types (see the Supported
Touch Panels section on page 5 for details).
The Resource Manager Welcome Panel checkbox enables the Resource Manager
welcome screen on the selected touch panel. Note that Resource Manager must be
enabled, via the Integrated Applications dialog page, for this feature to work. This
Resource Manager Welcome panel sits on the outside of a conference room that would
display the meetings scheduled within. This would allow people to view what meetings
are scheduled for the day and if one is currently in progress. Enabling this feature
disables all other Menu Style selections for the selected panel.
If the Use Resource Manager option is selected, you may identify whether a
selected panel is used for control or as an RMS Welcome panel. No RMS support is
included in G3 panels, except for the use of Welcome Panels.
To edit the Display Name and Panel Type fields
1. Select a panel from the list, and make any necessary changes in the Display Name and Panel
Type fields.
2. Click the Apply button to apply your changes.
To add a new Touch Panel Interface field
1. Select a panel from the list, make the necessary alterations to the properties such as: Display
Name and Panel Type.
2. Click the Add button to add your newly configured panel.
Each Modero panel is shipped with a factory default panel Device ID value of 10001.
Each consecutive panel added to the project (within this dialog of the DXP-PRO
wizard) adds a value of one to the initial (default) panel device ID value of 10501. The
value of the panel must be reset to correspond to the Device ID value assigned
by the created DXP-PRO panel project. Refer to the Report.html file for more
information (Understanding the Report File section on page 70).
Use the Menu Style radio buttons to select the menu style to be displayed on all touch panels in the
system.
XP-PRO v1.1 - Programmer’s Guide
47
Using the DXP-PRO Wizard
Scrolling - allows you to scroll through the menu buttons using left and right-arrow
buttons.
Static - all menu buttons are displayed - no scrolling involved.
Use PopUp Page Effects - allows you to enable popup page effects within the touch
panel project pages.
Use Picture Frame for Inactivity - allows you to enable the PictureFrame application
when the touch panel becomes inactive. If this box is checked, you will need to later open
the touch panel file created by the DXP-PRO wizard and setup the dynamic image
properties to pull its information from the PC running the PictureFrame application. This
option tells the PRO wizard to no longer use the DXP-PRO Logo page when the panel
times-out but to rather use the PictureFrame page.
PictureFrame must be running on the specified PC to be displayed on the target panel.
If the panel timeout is set to zero, the panel will never go to the PictureFrame page.
Use TakeNote! - allows you to enable the TakeNote functionality within a pre-selected
G4 Computer Control (G4CC) page. G4 Computer Control MUST first be selected as a
Source Type within the Device Data tab of the Device Configuration dialog page before
being able to select TakeNote. If you wish to use TakeNote in conjunction with G4CC,
this option must be selected.
Two conditions must be met for the TakeNote! radio box to be selectable:
G4CC and/or AUX/PC must be defined as Source Types within the Device
Configuration dialog AND a Modero panel must be added to the list of
available panels. If both of these conditions are met, the TakeNote! radio box is
selectable. If either of these conditions is not met, the radio box is greyed-out.
To disable TakeNote, you must first press the TakeNote Controls button, toggle
the Activate Annotation button (FIG. 35) to the Off state, and press Close.
To re-establish the TakeNote feature, return to the TakeNote popup menu,
toggle the Activate Annotation button back to the On state, and press Close.
By default, when you select the TakeNote option, from within the Touch Panel
Interface dialog, TakeNote becomes enabled within the G4CC panel page even
before it is selected.
The Exclude from Navigation Menu selections allow you to exclude these menu items
(Source Types) from the menu (no buttons with which to access these pages). This
might be used if the developer doesn't want an end-user accessing or altering settings for
these sources. The sources which can be omitted are:
Display Button
Lights Button
48
Macros Button
Relay Button
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
All of these selections are dependent on these devices first being defined. As an
example, if no lighting was previously defined, the Lights Button checkbox will be
greyed-out and unavailable.
Choose Touch Panel Theme Dialog
The Choose Touch Panel Themes dialog allows you to select from a list of predefined layouts (or
themes) for your touch panels. Each touch panel in the system will get the same settings whether
you are using a predefined or a custom theme.
FIG. 12 Choose Touch Panel Theme dialog
To select a theme, select one of the theme names by clicking on the choices located on the left side
of the screen. A small-scale preview image of the selected theme is displayed in this dialog.
Click on the Preview button to see a full size preview of the panel page. If you are using
a predefined theme, you will skip the next three dialogs in the Project Wizard.
If you select Custom (as the Theme), you will need to define the background, button colors and
text colors within three additional dialogs (Choose Touch Panel Background, Choose Touch
Panel Buttons, and Choose Touch Panel Text Colors) and once completed, then proceed directly
to the Input Names dialog.
Click Next to continue creating a custom Touch Panel Theme.
Choosing Custom adds the Choose Touch Panel Background/Buttons/Text Color
screens to the Which Screens? dialog and to the Jump To drop-down menu.
XP-PRO v1.1 - Programmer’s Guide
49
Using the DXP-PRO Wizard
Choose Touch Panel Background dialog
To select a background for your custom touch panel theme:
1. Click on one of the background names in the list on the left side of the screen.
2. Click on the Modero Preview button to see a full size preview of the panel page.
A small-scale preview image of the selected theme is displayed in this dialog (FIG. 13).
FIG. 13 Choose Touch Panel Background dialog
Because of the amount of possible color combinations between backgrounds,
buttons and text, some combinations may be difficult to read on-screen. Be sure to
select color combinations with enough contrast (especially between text and
background color or image) that will be easy for the end-user to read. In some cases
you may need to make manual adjustments to ensure readability.
Choose Touch Panel Buttons dialog
To select a button style:
1. Expand the lists on the left side of the dialog and click on a button family style.
2. Click and drag a button color from the sample buttons across the top of the dialog.
3. Drag the sample button and drop it on the image that says Drag here to Update.
Because of the amount of possible color combinations between backgrounds,
buttons and text, some combinations may be difficult to read on-screen. Be sure to
select color combinations with enough contrast (especially between text and
background color or image) that will be easy for the end-user to read. In some cases
you may need to make manual adjustments to ensure readability.
4. The button preview will update accordingly.
50
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
FIG. 14 Choose Touch Panel Buttons dialog
Choose Touch Panel Text Colors dialog
To select the touch panel text colors:
1. Select Text On and Text Off state colors from the top color palette.
2. Click and drag each color selection from the top color palette to the "Drag Here to Update"
section of each Text Off State or Text On State window (FIG. 14).
Input Names dialog
This dialog table (FIG. 15) allows you to label the input names of the display devices in the system;
this is done to aid the user in selecting the desired input on the finished panel.
For example, the default name for an input might be "Component 1"; this may not provide the user
with a clear understanding of what is actually connected to that input of the display device. Using
the Input Names table, you could rename this input to "DSS" so the user can then easily send the
intended input command to the display device.
The Input Names table can also be used to simply shorten the names that are displayed
on the touch panel.
For example, rather than displaying "HD Component YpbPr 1", you might label the
input "HD Comp 1".
The Default Name is the reference to the touch panel that is used in the installation report
The Display Text is the reference to the touch panel that is used in the installation report.
XP-PRO v1.1 - Programmer’s Guide
51
Using the DXP-PRO Wizard
FIG. 15 Input Names dialog
To edit the Display Text field information
1. Select a Default Input Name from the list and make any necessary changes within the Display
Text field (lower portion of the page).
2. Click the Apply button to apply your changes.
Switcher Inputs/Outputs Dialog
These dialog tables (FIG. 16) allow you to assign the inputs and outputs of the switcher(s) in your
system. There are two distinct sections in this dialog - Inputs and Outputs.
Switcher Inputs tab
Within the Inputs section, in addition to assigning devices to inputs of the switcher, you can
provide a display name and the input type for each device (Audio/Video, Audio Only, or Video
Only). The number of inputs available in this section is based on the information that was entered
on the System Information page.
Input Number - This column is a list of all available input values open for assignment to
the current list of source devices.
Display Name - This column is a list of the current source devices assigned to the Input
values on the Switcher. These can be found within the System Information page.
52
Input Type - This column differentiates between Audio/Video, Video Only, and Audio
Only inputs. This is important when using RS-232 Control Logic. These are selectable
from the Input Type radio buttons.
The lower part of this tab contains a series of selectable fields and radio buttons that allow you to
populate the available inputs to the Switcher:
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Switcher Inputs
Switcher Outputs
FIG. 16 Switcher Inputs/Outputs dialogs
Input Number - This is a read-only field that changes to reflect the currently selected
Switcher input number (from the upper table).
Source - This drop-down list provides you with a listing of available source devices.
These were previously entered and configured within the System Information page.
Display Name - This read-only (greyed-out) field reflects the display name associated
with the selected source. Making a change within the Source field results in a change of
the Display name associated with the selected Input Number on the Switcher.
Input Type - These radio buttons allow a chosen source to be differentiated as either an:
Audio/Video, Audio only, or Video only input.
1. Click the Apply button to apply the changes made to the selected Switcher Input Number
values.
2. Click the Clear button to clear the Display Name and Input Type information from the selected
Input Number value.
XP-PRO v1.1 - Programmer’s Guide
53
Using the DXP-PRO Wizard
Switcher Outputs tab
Within the Outputs section, in addition to assigning devices to outputs of the switcher, you can
assign a display device as the primary display. When selecting a source on the completed touch
panel, the corresponding input will be connected to the primary display's output by default. This
allows sources to connect to the primary display without having to visit the switcher page on the
touch panel, simplifying the user interface. The Outputs section also allows you to send a video
selection command to any display device when that output is chosen.
For example, if you have multiple input types connected to a display, you may want to assign an
output on the switcher for each type, and then issue a command to the display device to switch to
the corresponding input. The number of outputs available in this section is based on the information
that was entered on the System Information page.
Output Number - This column is a list of all available output values open for assignment
as outputs from the switcher.
Display Name - This column reflects a listing of user-defined Display name entries
assigned to the selected Switcher Output values. These names are entered within the
Display Name field located on the bottom of this page.
Input Select - This column displays a list of input commands that are sent to the display
device in order to switch the input on those selected display devices.
The lower part of this tab contains a series of selectable fields and radio buttons that allow you to
populate the available outputs from the Switcher:
Output Number - This is a read-only field that changes to reflect the currently selected
Switcher output field (from the upper table).
Destination - This drop-down list provides you with a listing of available devices that can
be assigned to outputs from the switcher. These were previously entered and configured
within the System Information page.
Display Name - This editable field provides you the ability to enter in an alphanumeric
string that is associated with the switcher output destination number. Altering this field
results in a change of the Display Name associated with the selected Output Number
from the Switcher.
Video Select - This drop-down list allows you to choose from a list of pre-defined input
commands that are sent to the selected display devices (to switch their input). A change
to this selection is reflected within the Input Select list (on the top of the page) after
clicking the Apply button.
1. Click the Apply button to apply the changes made to the selected Switcher Output Number
values.
2. Click the Clear button to clear the Display Name and Input Select information from the
selected Output Number value.
54
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Channel Preset Categories Dialog
This dialog (FIG. 17) allows you to create up to 8 different preset categories. For example, you
might create a presets category for Sports channels, one for Movies channels, another for Children's
channels, and so on. These categories appear within the bottom-right of the Channel Presets pages
(such as Channel Presets for DSS/TV/etc.).
FIG. 17 Channel Preset Categories dialog
By default, there is one entry in the table: All Presets. This system-defined preset category cannot
be edited or deleted.
To create new Preset Categories:
1. Enter the name for the new Preset Category in the Display Name text field. This is the name
that will be displayed on the panel.
2. Click the Add button to add the new Preset Category to the bottom of the list.
3. Select a Preset Category in the list, type in a new Display Name, and click the Insert button to
insert the new Preset Category in the row above the selection. The Insert button is greyed-out if
the first row is selected.
To edit the Display Name for an existing Preset Category:
1. Select one from the list, and enter the new name in the Display Name text field.
2. Click Apply to apply the change.
3. Use the up/down arrow buttons to change the order in which the Preset Category buttons will
occur on the touch panel.
4. To delete a Preset Category from the list, select one and click the Delete button.
XP-PRO v1.1 - Programmer’s Guide
55
Using the DXP-PRO Wizard
Channel Presets for...Dialogs
The Channel Preset dialogs are the same for any TV type channel preset. This includes TV tuners,
Cable TV tuners, DSS tuners, PVR tuners and VCR tuners. The previously configured Preset
Categories appear within the bottom-right of these Channel Presets pages.
Channel Presets dialogs are only included for devices that have been specified as
being "tuner capable". This is an option that must be manually selected, in the Device
Data tab of the Device Configuration dialog.
You can setup a maximum of 100 channel presets for each tuner. Each tuner carries it own set of
channel presets.
56
FIG. 18 Channel Preset dialog
The Channel Presets table can be sorted by clicking on any of the three column header
cells (Order, Preset Name, Uses Logo and Channel). Clicking the header cells toggles
between sorting the column in ascending or descending order. Clicking on any of the
cells within the list selects the channel for editing. The arrow buttons to the right of the
channel list will move the selected channel up or down in the list order.
The Copy from: drop-down list allows you to copy a previously configured channel
preset to the current device. Click the down arrow to view the list, and select the channel
preset you want to copy into the Channel Presets table.
The Button Image drop-down list contains all of the preset channels in the Design
XPress - Professional Wizard. When you select a button image, the image is previewed to
the left of the combo box. The wizard also automatically fills in the Preset Name field
with the same name as is in the Button Image field.
The Channel text box takes the channel number of the selected preset.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
You can also define your own custom presets. If you select None as the button image, the text
placed in the Preset Name text box will be displayed on the touch panel button.
CD Titles for CD Dialog
The CD Titles dialog (FIG. 19) allows you to setup the CD or DVD titles in multi-disc changers.
The number of title slots is determined by the changer size as set on the Source Data screen. This
dialog is only included in the Wizard if the Project includes a CD or DVD player with at least a
two-disc changer.
This dialog displays a set of tabs across the top of the screen to accommodate the
disc capacity of the device (if necessary). The tabs are numerated and each tab
displays a set of 25 title slots.
Each title slot is a combo box that lists the CD titles setup in the CD Titles Maintenance dialog
accessed through the main menu (Edit > CD Titles Maintenance). Next to each combo box is a
browse button that will extract the CD information from your CD-ROM drive and add it to the
combo box. You can also manually type in new CD titles in the Manually add CD to data store
section of this dialog.
FIG. 19 CD Titles dialog
Adding a new CD title:
Manually enter either Artist or Disc Title information to enable the Add button. Click the
Add button to add the new CD to the list.
Alternatively, you can select an existing CD title from the list, then edit the Artist and
Disc Title information, and click the Add as New button.
XP-PRO v1.1 - Programmer’s Guide
57
Using the DXP-PRO Wizard
Editing CD Information
1. Select a CD title from the list to populate the Artist and Disc Title fields, where you can enter
new information as desired.
2. Click the Update button to update that CD in the list.
Retrieving CD Information (from freedb.org)
1. Insert an audio CD into the CD player on your PC.
To prevent the CD from playing when it is inserted, hold down the shift key on the
keyboard while loading the CD.
2. Click the down-arrow (in the Setting to receive Disc data from freedb.org section of the
dialog) to view a list of available CD drives on your PC.
3. Select the drive that you placed the CD in, and click the Retrieve Disc Data from CD button.
If the disc has never been read before, DXP-PRO will attempt to download the data from
freedb.org.
Removing a CD Title
1. Select any CD in the list (Shift + click to select multiple CD Titles).
2. Click the Delete button to remove the CD(s) from the list.
The CD titles list must be downloaded using an FTP program. There are many of
these available on the web, most of them freeware. Connect to the Master and
download all of the required files into the root directory (top-most directory) of the
Master.
Using the CD Titles Maintenance dialog
1. Select Edit > CD Titles Maintenance to open the CD Titles Maintenance dialog.
2. Use the fields and options in this dialog to add/remove CD titles, edit Artist and Title
information, and automatically retrieve CD information from the freedb.org on-line database.
Adding a new Disc title (CD Titles Maintenance dialog)
1. Manually enter either Artist or CD Title information (into their corresponding fields on the
bottom left of the dialog) to enable the Add button.
2. Click the Add button to add the new CD to the list.
Editing Disc Information (CD Titles Maintenance dialog)
1. Double-click on a CD title from the list to populate the Artist and CD Title fields, where you
can enter new information as desired.
58
2. Click the Update button to update that CD in the list.
Retrieving CD Information from freedb.org (CD Titles Maintenance dialog)
1. Insert a CD into the CD player on your PC.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
To prevent the CD from playing when it is inserted, hold down the shift key on the
keyboard while loading the CD.
2. Click the down-arrow (in the Setting to receive CD data from freedb.org section of the
dialog) to view a list of available CD drives on your PC.
3. Select the drive that you placed the CD in, and click the Retrieve CD Data from CD button. If
the disc has never been read before, DXP-PRO will attempt to download the data from
freeDB.org.
Removing a CD Title (CD Titles Maintenance dialog)
1. Select any title in the list (Shift + click to select multiple titles).
2. Click the Delete button to remove the title(s) from the list.
DVD Titles for DVD Dialog
The DVD Titles dialog allows you to setup the DVD titles in multi-disc changers. The number of
title slots is determined by the changer size as set on the Source Data screen. This dialog is only
included in the Wizard if the Project includes a DVD player with at least a two-disc changer.
This dialog displays a set of tabs across the top of the screen to accommodate the
disc capacity of the device (if necessary). The tabs are numerated and each tab
displays a set of 25 title slots.
Each title slot is a combo box that lists the DVD titles setup in the CD Titles Maintenance dialog
accessed through the main menu (Edit > CD Titles Maintenance). Next to each combo box is a
browse button that will extract the information from your DVD-ROM drive and add it to the combo
box.
The procedures for altering the DVD title properties are identical to those previously outlined
within the CD Titles for CD Dialog section on page 57.
Relay Control Dialog
DXP-PRO can control up to three 3-relay controlled devices. The devices can be any low voltage
relay device such as screens, projector lifts, drapes, or shades. To control the devices, you'll need to
specify how the relays behave, how many relays are used in the control and what text needs to
appear on the touch panel buttons.
The Relay Control Declarations (maximum of 3) list (FIG. 20) at the top of the screen gives a
summary of the defined relay devices. Each Relay Control Declaration represents a group of up to
three relay functions.
The Relay Control Declarations list can be alphabetically sorted by toggling any of the
column header cells. This clicking of the headers toggles the sorting of the selected cells
between an ascending or descending order.
The Display Name, Control Logic, and Actions can also be moved (as a row) upwards/
downwards by selecting a row and using the adjacent Up/Down arrow buttons to move
the selection in a vertical direction.
XP-PRO v1.1 - Programmer’s Guide
59
Using the DXP-PRO Wizard
FIG. 20 Relay Control dialog
The Display Name text box is used to label the relay group on the touch panel. Changing a Display
Name can result in DXP-PRO displaying a warning pop-up message informing you that
"Deleting/Renaming this entry will affect the following Macros". If you accept the change those
macros could be negatively affected.
The Control Logic drop-down menu allows you to select from 3 control type options: Latching,
Momentary and Pulse Type:
Latching relays remain on until another relay is selected.
Momentary relays will remain on as long as the touch button is being pressed.
Pulse Type relays will turn On for ½ second and then will automatically turn Off.
Latching relays can use one, two or three relays to control a motor controller. DXP-PRO always
reserves 3 relays, but you can configure it to match the control method for your motor controller.
For motor controllers that use a single relay, define two relays, but only connect one.
For example, if relay 1 is engaged the screen goes down, when it is disengaged the screen goes up.
By defining two relays, when the down button is selected, relay 1 is disengaged and relay 2 is
engaged. Engaging relays two would of course do nothing.
Momentary and Pulse Type relays require a minimum of 2 relays to be defined. Momentary relay
control would be needed if the motor controller does not have limit switches to stop the motors.
DXP-PRO does not support timed closures in place of limit switches. Timed closure control has
historically been unreliable, and is therefore not supported.
60
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Adding a Relay Control Definition to the list
1. Enter a name for the Relay in the Display Name text field. Then select a type of Control
Logic.
2. Click the Add button to add the new Relay Control Definition to the bottom of the list.
3. Select a Relay Control Definition in the list and click the Insert button to insert the new Relay
Control Definition in the row above the selection.
Editing the Display Name for an existing Relay Control Definition
1. Select one from the list, and enter the new name in the Display Name text field.
2. Click Apply to apply the change.
Use the up/down arrow buttons to change the order in which the Relay Control Definition
buttons will occur on the touch panel.
Deleting a Relay Control Definition from the list
1. Select a relay from the list.
2. Click the Delete button.
Navigation and Routing Macros Dialog
A macro is a series of commands that are triggered by a single button on the touch panel, in this
case the Main menu buttons. You have access to the Navigation and Routing Macros page if you
selected the "Use Macro for Menu Navigation and Device Routing" check box on the Device
Configuration page. By choosing to activate this radio button option, you are placing a Navigation
and Routing Macro for that device onto the Navigation and Routing Macros dialog that can later be
edited.
On this page, two macros will always be visible. They are System Startup and
System Shutdown. These macros can be populated with the sequence of events
desired when (a user) enters the room and when the room is done being used. For
example, turn Off the projector, raise the screen, hit "stop" on all devices with
transport controls (DVD, VCR, CD, etc.), add a delay of 30 seconds (to allow people
time to exit the room), and then turn the lights Off.
These macros cannot be deleted, however, they can be set for zero steps. If the
macro has zero steps, the button will not be available on the touch panel.
Adding navigation and routing macros on the Main menu buttons allows you to set default actions
when a Main menu item is selected.
For example, when selecting "DVD" from the main menu, in addition to performing a
switch, a user may want lights to dim, window coverings to close, a projection screen to
come down, and a display device to switch to a specific input. Using navigation and
routing macros to accomplish these actions helps to create a system that more closely fits
the needs of the end user, as well as showcasing the power and ease of use of their control
system.
The Macros dialog (FIG. 21) lists up to 32 macros, with up to 50 steps in each macro.
The Macros table lists all macros currently in the Project.
XP-PRO v1.1 - Programmer’s Guide
61
Using the DXP-PRO Wizard
Each navigation and routing macro may contain up to 50 steps, the following sections
outlines more specific information on using macros.
These Macros would have been previously created within the Device Configuration -
Device Data tab by selecting the Use Macro for Menu Navigation and Device Routing
radio button (for a selected Source Type (if available)).
To modify the macro steps, click the Edit button at the bottom of this dialog. These
macros can be edited within the Macros Steps for… dialog but cannot be added unless
you return to the Device Configuration page for a selected product and choose the "Use Macro for Menu Navigation and Device Routing" check box.
62
FIG. 21 Navigation and Routing Macros dialog
Editing an existing Macro within the Project
1. Select a macro from the Macros table.
By previously selecting the Use Macro for Navigation and Device Routing radio box
(for a particular device from within the Device Configuration - Device Data tab), a
macro entry (for the selected device) is made into the Navigation and Routing Macros
dialog (FIG. 22). This entry can now be modified if necessary, but no new macros can be
added to the Navigation and Routing Macros dialog without first returning to the Device Data tab and selecting the radio box.
2. To edit these newly added Macros, either double-click on the macro entry (from the Macros
table) or select the entry and press the Edit button. These actions both open the Macro Steps
for…dialog wherein you can edit the various properties of the selected macro.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
FIG. 22 Adding a Macro to a Project
To see a good example of how a typical macro is structured, open the macro
included in the sample project (select the "Projector" macro from the Macros list, and
click the Edit command button).
Using the Macro Steps for....dialog to edit the macro steps
Select a macro and click the Edit button in the Macros section of the Navigation and Routing
Macros dialog to open the Macro Steps dialog (FIG. 23). Use the Macro Steps dialog to build the
macro by specifying each step according to the functional requirements of the macro. A macro can
contain up to 50 steps.
New tab
available in
version 1.1
FIG. 23 Macro Steps dialog
XP-PRO v1.1 - Programmer’s Guide
63
Using the DXP-PRO Wizard
The items in this dialog include:
Macro Steps table: This table lists all of the steps currently included in this macro. Use
the Up/Down arrow buttons to rearrange the order of the steps.
Macro Steps tabs: The set of tabs in the lower half of this dialog represent the different
system elements that can be incorporated into a macro. The tabs are described below:
Macro Name:This is the only visible tab when you add a new macro to the system (via the
Delay:Use the Delay tab to add delays to the macro. Use the up/down arrows but-
Device Function: Use this tab to add a device and device function to the macro. Click the down
Routing:Use this tab to add routing commands to the macro. If the project has
Lighting Presets: Use this tab to add a lighting preset to the macro. Select a defined lighting
Channel Presets: Use this tab to add a channel preset to the macro. Select a source tuner
Relays:Use this tab to add a relay function to the macro. Select a relay action
Volu me :Use this tab to set a volume level appropriate for the macros function.
Custom:This tab allows experienced NetLinx programmers to manually develop
Add command button in the Macros dialog).
Enter a name for the new macro in the Macro Name field. If there are other
existing macros in your project, you can select to copy one via the Copy
Macro drop-down list.
Click Apply to save the name, and access the other macro tabs.
tons to adjust the delay time, in 1/10-second increments (default = 5).
Click Add to add the delay to the bottom of the Macro Steps list. Generally,
you should insert a delay between each macro step.
arrow to access the Device drop-down list of devices defined in the System Information dialog.
Once a device has been selected, a second set of function-oriented dropdown lists becomes available. Select a device function to be added as a
macro step, and click Add to add the device function to the Macro Steps list.
multiple switchers, select a Switcher, then select an Input to route to an
Output. The inputs and outputs available in the drop down list are those that
were configured on the Switcher Input/Outputs dialog.
preset from the Lighting Presets drop-down list, and click Add to add the
preset to the Macro Steps list.
device from the Source Device drop-down list.
Once a source device has been selected, the Channel drop-down list
becomes available. Select a channel preset from the list and click Add to
add the selected channel preset to the Macro Steps list.
(Close, Open, or Stop) from the Action drop-down list and click Add to add
the selected relay function to the Macro Steps list.
custom macro functions. Select a CustomMacroFunction from the Execute
drop-down list (start with CustomMacroFunction01).
This adds the "shell" of a custom macro function to the Custom Macro
Function.AXI file. Custom macro functions require that you manually enter
the code for the custom macro function (in the NetLinx Studio application).
64
Add: Click to add the selected macro function to the bottom of the Macro Steps list.
Delete: Select a step in the Macro Steps list and click Delete to remove the selected step
from the macro.
Insert: Select a row in the Macro Steps list table, and click Insert to insert the selected
macro function to the Macro Steps list, in the row above the selection.
Apply: Click to apply any changes made to a selected macro step.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Clear: Click to clear the macro function from a selected macro step, without removing
the step from the list.
OK/Cancel: Click OK to accept the changes and return to the previous dialog. Click
Cancel to exit from this dialog without accepting any recent changes.
System Macros Dialog
A macro is a series of commands that are triggered by a single button on the touch panel. An
example of a simple macro would be one that (on a button press on the touch panel) turns the lights
on, turns on the TV and DSS tuner, and switches it to a specific channel.
The Macros dialog allows you to set up 32 macros, with up to 50 steps in each macro.
The Macros table lists all system macros currently in the Project.
FIG. 24 System Macros dialog
XP-PRO v1.1 - Programmer’s Guide
65
Using the DXP-PRO Wizard
Adding a New System Macro to the Project
1. Click the Add button to open the Macro Steps dialog.
2. Enter a name for the new macro in the Macro Name text field.
3. Click the Apply button to access the other macro steps tabs (Delay, Device Function, Routing,
Lighting Presets, Channel Presets, Relays, and Custom).
4. Select the tab associated with the first step in your macro. For example you might want to turn
on the receiver as the first step in the macro. In this case, select the Device Function tab, and
select Projector from the Device drop-down list.
Depending on the tab selected, and the device, preset or function selected within that tab, a
second set of options may become available. In the case of a projector, the additional options
include Serial (RS-232) commands and Video Inputs. If you had selected a CD player, the
additional options would include IR Commands and Functions.
Use these additional options to specify which function you want to include in this step of the
macro. To return to the Projector example, you could select Power On from the RS232
Commands drop-down list, to specify that the projector should turn on as the first step in this
macro.
5. Generally, when creating macros, you should insert a delay between each step (open the Delay
tab, adjust the delay time if necessary (in 1/10-second increments), and click OK).
6. When you've added all the desired steps to the new macro, click the OK button.
To see a good example of how a typical macro is structured, open the macro
included in the sample project (select the "Pan" macro from the Macros list and click
the Edit command button).
Using the Macro Steps for... dialog for System Macros
Refer to the Editing an existing Macro within the Project section on page 62 and Using the Macro
Steps for....dialog to edit the macro steps section on page 63 for information on using the Macro
Steps for dialog to edit and make changes to Macro steps.
Editing Your Project
Any modifications you need to make to your project should be done through the Design XPress -
Professional Project wizard. Remember that any changes to the IR file, either selecting a different
file or remapping functions, may affect other screens on the wizard.
All custom additions to the generated system need to be made to the Custom.axi include file. AMX
does not recommend making modifications to Main.axi or any other Include file.
Creating an Existing Design XPress - Professional Project
There are three ways to create a new Design XPress - Professional (DXP-PRO) project file. All
three methods work the same way; they each launch the Design XPress - Professional Project
Wizard, which steps you through the process of designing and configuring a DXP-PRO system:
66
Click the Create New Project button on the Main Screen.
Select File > New.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Select New from the Project Selection List context menu.
Opening an Existing Design XPress - Professional Project
There are three ways to open an existing Design XPress - Professional project file. All three
methods have the same result; they each open the Project selected (highlighted) in the Project
Selection list (on the Main Screen).
First select a Project from the Project Selection List, then:
Click the Open Project button on the Main Screen.
Select File > Open.
Select Open from the Project Selection List context menu.
Copying a Design XPress - Professional Project
There are three ways to copy an existing DXP-PRO project file under a new name. All three
methods have the same result; they allow you to rename a copy of the Project selected (highlighted)
in the Project Selection list (on the Main Screen), via the Copy Project dialog.
First select a Project from the Project Selection List, then:
Click the Copy Project button on the Main Screen.
Select File > Copy.
Select Copy from the Project Selection List context menu.
Use the fields in the Copy Project dialog to specify a name for the copied project file (in the Job
Name field), and to enter a description of the project if desired (in the Description field).
The Job Name is required, the Description is optional.
Importing a DXP-PRO Project
Once you have exported a DXP-PRO project, you can import it back in to the program via the
Import Project command.
There are two ways to import an existing DXP-PRO project file into the Project Selection list. Both
methods have the same result; they each invoke the Select Import Design XPress Professional file
dialog, where you can locate and select a Project (*.PRO) file to import.
Select File > Import Project.
Select Import from the Project Selection List context menu.
Note that importing a Project file does not affect the physical location of the imported file - it still
exists in the directory/location that you got it from, but it is now available for selection via the Main
Screen.
If you import a Project that already exists in the Project Selection List, DXP-PRO
automatically increments the Rev number for that Project File by one digit (as
indicated in the Rev column of the Project Selection List).
XP-PRO v1.1 - Programmer’s Guide
67
Using the DXP-PRO Wizard
Exporting a DXP-PRO Project
There are two ways to export an existing Design XPress - Professional project file. Both methods
have the same result; they each invoke the Export dialog, where you can specify a name and the
target directory for the exported Project (.PRO) file.
The DXP-PRO Project must be have first been exported before it can be imported
(refer to the previous Importing a DXP-PRO Project section).
Deleting a DXP-PRO Project
There are three ways to delete an existing Design XPress - Professional (DXP-PRO) project file.
All three methods have the same result; they each delete the Project selected (highlighted) in the
Project Selection list (on the Main Screen) from the hard drive.
First select a Project from the Project Selection List, then:
Select File > Export.
Select Export from the Project Selection List context menu.
Click the Delete Project button on the Main Screen.
Select File > Delete.
Select Delete from the Project Selection List context menu.
The program will ask you to confirm this action in the Confirm Delete Request dialog (click Ye s to
delete).
If a project is not exported before deleting, you will not be able to bring the project
back into DXP-PRO for modifications at a later date.
Before you’re Finished
It is recommended that before your finish your project you follow these steps to properly utilize the
DXP-PRO project files:
Finish your DXP-PRO project. After finishing the project, you are given the option to
view the Report file and open the output within NetLinx Studio.
Build your Active System, save the workspace, and then save the compiled Main.AXS
file.
Upload your touch panel files to their target panels via TPDesign4.
Transfer the remaining project files to the target NetLinx Master via NetLinx Studio
version 2.2 (or greater).
68
FTP transfer the CD/DVD Title Information to the target NetLinx Master.
The following sections are laid out in their recommended order of completion.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
Finishing a Project
Once you have gone through all of the configuration screens, it is time to build your project.
1. Click the Finish button at the bottom of any screen (A in FIG. 25). DXP-PRO then asks you if
you want to save your project as the current revision or as a new revision. New revisions will
always be 1 greater than the highest revision for the project.
2. Select the radio button (from the Select NetLinx Platform dialog) that corresponds to the
NetLinx Master being used to control this system (B in FIG. 25).
Select the type of NetLinx Master Controller that will be used from the available choices
(NI-700, NI-2000, NI 3000, NI 4000 and NXC-ME260/64).
3. Enter the IP Address of the target NetLinx Master and click OK. Although the IP Address is
not necessary to finish the project, this information is required by NetLinx Studio when
uploading the project to the target Master.
Some of these options may be disabled, based on the specifications and
requirements of the Project.
Once you have made your selection, DXP-PRO compiles all of the data from the wizard and builds
the NetLinx Program and touch panel files.
4. After having successfully completed; a Design XPress Professional dialog (C in FIG. 25) asks
if you want to automatically view the report file (in an HTML format) and/or open the
completed project within NetLinx Studio.
Place a checkmark adjacent to your choices and click OK to continue.
Your project files will be located in the Design XPress - Professional directory under the folder
projects. Typically the installed directory will be:
<drive:>\Program Files\AMX Control Disc\Design XPress Professional
5. We recommend that you view and print the project HTML report from within the web browser.
This report gives you information vital to properly installing the project. This report is saved in
the Projects folder of Design XPress - Professional.
6. The APW workspace file is then displayed within the Wor kspa ce tab in NetLinx Studio
(D in FIG. 25). Located below the project is a User Interface folder that contains the TPD4
panel files that were previously selected and created within the Touch Panel Interface dialog
(A in FIG. 25).
7. Click the Build Active System icon from the area just below the Main menu (D in FIG. 25).
This action starts the NetLinx compilation of the Main.AXS file into the following directory:
<drive:>\Program Files\AMX Control Disc\Design XPress Professional
8. Save the workspace file by navigating to the Main menu within NetLinx Studio and selecting
File > Save Workspace as...
9. Click Save from the Save Workspace dialog.
For more information on how to operate NetLinx Studio see the NetLinx Studio Tutorial on the
Training page of the AMX web site at www.amx.com, and consult the on-line help file and
NetLinx Studio Instruction Manual (also available via the AMX website).
XP-PRO v1.1 - Programmer’s Guide
69
Using the DXP-PRO Wizard
Understanding the Report File
The report file (Report.html), automatically generated by DXP-PRO (after the project is finished)
should be used as a step-by-step guide to installing the system. This HTML file is located into the
project directory that is specific to the generated project.
It is important to refer to the Report file and follow the device addressing instructions and to hook
up the A/V equipment to the proper IR and RS-232 ports. If the device addressing instructions are
not followed the system will not function properly.
The report is broken down into the following five sections:
• Installation Instructions: This section of the report indicates which files need to be
• Device Addressing:This section defines the device IDs of all the devices defined by
downloaded, and describes device mapping, working with IR
files, compile and download operations (via NetLinx Studio), how
to FTP externally, and how to reboot the NetLinx Master.
An example would be:
• Verify NetLinx Master Firmware is the latest available.
• Verify NXI Firmware is the latest available.
• Open project in NetLinx Studio.
• Address each device as specified in the Device Addressing
section of this report.
• Configure each Modero panel to communicate via Ethernet
• Compile the project.
• Go to the download screen. Make sure communications
settings are correct.
• Select all files in the project and download.
• Using an FTP program, FTP all .TXT files and .HTML files in
the project directory to the root directory on the NetLinx
Master.
• Reboot the Master for the changes to take effect.
Design XPress - Professional (DXP-PRO). The devices listed in
this section must be set to the given device IDs. If this is not done
the system will not behave properly. This section is divided up by
device type: touch panels and miscellaneous.
Most device IDs are set inside the NetLinx code. These devices
must be connected to the correct port of the NetLinx Controller to
operate properly. The exceptions to this are the touch panels.
Their device IDs must be set from the setup screen on the panel
itself. Make sure when the device ID is set on G3 panels so that
the number of devices used on the touch panel is also set.
DXP-PRO uses 4 devices on each G3 touch panel. So, if the
touch panel is set to use device ID 128 with 4 devices used, that
panel will actually occupy device IDs 128, 129, 130, and 131.
Note: When using G4 panels, you do not need to set the number
of devices used.
70
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
• Wiring/Connections:This section details the locations where all of the cables will
• General InformationThis section of the report details the user interface file names for
• Macros:This section of the report details all Macros added in the system,
• AMX Recommended
Equipment List:
connect. It will define the connections for all of the AMX
equipment as well as all source and display equipment, IR ports,
and any other connection that must be made.
Examples:
• CD Changer is connected to NetLinx using IR port 2, IR
pulse time 3/10 second
• DVD is connected to switcher input 1
Go through this section of the report one item at a time and
perform each connection. Use this section as a list of
connections to make and check them off as you go.
each touch panel, which files need to be transferred to the
Master, lighting scene addresses, file names of the generated
NetLinx software, etc.
An example is:
Lighting Scenes
• Lighting Address=1 Button=102 Scene=Room Off
• Lighting Address=1 Button=1 Scene=Scene 1
as well as a list of all steps contained in each Macro. Use this
section to ensure that all of the intended functionality for each
Macro has been added.
An example is:
Macro: MAX 1_1 Navigation and Routing
• Send Plasma command 'Power On'
• Execute delay of 1 second
• Send Plasma command 'BNC' of type Video Inputs
• Execute delay of 1 second
• MAX 1_1 Routes to Plsm BNC on Device Switcher
• Execute delay of 1 second
• Execute lighting scene 'Scene 5'
• Execute 'Close' using relay device Window, state = PUSH
• Execute delay of 2 seconds
• Execute 'Close' using relay device Window, state = RELEASE
This section of the report lists all of the AMX equipment that will
be needed to build, install, and run the system. Both model
numbers and descriptions are given to make ordering the
equipment a simple process.
An example is:
• NXT-CV17 - 17" Modero Widescreen [1]
Note: use NXD-CV17 for wall mount
• MAX-MMS - MAX MultiMedia Server [1]
Uploading a completed touch panel file to a target panel
1. Double-click on the desired touch panel file (listed in the User Interface folder of the
Work space tab (D in FIG. 25). This action launches the TPDesign4 application and opens the selected TPD4 file (E in FIG. 25).
2. Preconfigure the touch panel for communication by accessing the System Connection page and
entering the communication parameters for the target NetLinx Master used for communication
to the panel. Refer to the particular touch panel instruction manual for more detailed
configuration setup procedures.
XP-PRO v1.1 - Programmer’s Guide
71
Using the DXP-PRO Wizard
Build Active
System icon
72
FIG. 25 Finishing a project and downloading the created Touch Panel Pages
3. Note the IP Address and IP port values used by the NetLinx Master for communication.
4. From the TPD4 Main menu, select Tr ansf er > Connect to open the Connect dialog (FIG. 26).
5. Click New to open the Connection Settings dialog (FIG. 26) and begin entering the connection
properties for the NetLinx Master communicating with the target touch panel.
6. Enter the Name (assigned to this connection), Transport method (for communication), IP
Address, and IP Port used for communication to the panel through the Master.
7. Click OK to return to the Connect dialog (FIG. 26).
8. Click the Connect button to begin the communication process to the target panel.
9. From the TPD4 Main menu, select Trans fer > Send to Panel to open the Send to Panel dialog.
10. Select the target panel from within the listed G4 devices.
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
11. Click on the radio button next to the desired transfer option for the files being sent to the panel.
12. Click Send to return to the main TPD4 application, open the Transfer Status window pane
(along the lower half of the application window), and begin the transfer process. The files
upload progress is reflected on the touch panel LCD.
13. After a successful upload is completed, the touch panel displays an AMX Design XPress
If you did not select to automatically open the project file within NetLinx Studio (C in FIG. 25),
you will have to manually locate the file and open it within NetLinx Studio. Opening the AXS
project in NetLinx Studio allows you to download the program data and user interface files to the
NetLinx system.
Upon completion of the Design XPress application the next step is to use NetLinx Studio to open
the created project file. From this point on, this document will assume the installer has a good
understanding of NetLinx Studio (it can be a difficult installation if the installer is a first time
Design XPress user and a first time NetLinx Studio user).
To open the workspace, use the Open Workspace option in the File menu and traverse to the path
where your project file resides. Once the workspace is open, expand all branches of the Navigator
view to see the files that have been created in the project. There is also an option in DXP-PRO
(upon completion of a project) that provides a popup dialog that gives you the option to
automatically open the newly created workspace in NetLinx Studio.
There is only one file under the Source Code branch: Main.axs. This is the main file and contains
most of the system configuration information entered into the application/wizard. All other
NetLinx software files are under the Include branch of the tree. There are a lot of include files
because the software is broken up by function. For example, Lights_Tp.axi contains the software
for controlling lights via the touch panels. All of the touch panel files are located under the User Interface branch. The text files and report file are located under the Other branch.
To compile your project, open up the main source file and then select the Build Active System
option under the Build menu (or click on the Build Active System icon from the toolbar below the
Main menu). Any time changes are made the software has to be compiled.
XP-PRO v1.1 - Programmer’s Guide
73
Using the DXP-PRO Wizard
The CD titles list must be downloaded using an FTP program. There are many of
these available on the web, most of them freeware. Connect to the Master and
download all of the required files into the root directory (top-most directory) of the
Master.
The NetLinx Studio Project
Building the project can be accomplished by compiling Main.axs, or selecting Build Active
System. Be sure that you are compiling the project for NetLinx. The system should compile for
NetLinx by default. Download the NetLinx program to the NetLinx Master along with all IR files
and touch panel files, and reboot the Master.
Use the following steps:
1. Build the project. This can be accomplished by compiling Main.axs, or by selecting Build
Active System. Be sure that you are compiling the project for NetLinx. The system should
compile for NetLinx by default.
2. Transfer the NetLinx program to the NetLinx Master along with all IR files and touch panel
files by selecting Tools > Files Transfer (from the Main menu).
3. Click the Add button from the Send tab of the File Transfer dialog.
4. From within the Current Workspace tab of the Select Files for File Transfer dialog; place a
checkmark adjacent to the active project files that you want to add to the transfer.
5. Click OK to return to the Send tab.
6. Click Send to begin the upload process to the target Master. The application will open the File
Transfer Status tab from within the lower window on the application. The fields within that tab
show the progress of each file component and whether the transfer was successful.
7. After the last file has been uploaded to the Master, the Master should reboot. If it does not,
reboot the NetLinx Master by selecting Tools > Reboot the Master Controller (from the
Main menu).
Transferring CD/DVD Title Information to the Master via FTP
Anytime that you assign text to any type of preset button in your project, you must transfer the
button text that appears on the buttons in Design XPress to the NetLinx Master, in order to display
the button text on the panel(s) in the system. This is true for CD and DVD Titles. Use File Transfer
Protocol (FTP) to transfer the files.
It is recommended that you complete and then build your Project (in Design XPress)
and transfer it to the Master before you FTP the preset button text files to the Master.
The Master should be rebooted after a transfer.
If the FTP process was interrupted, some information might not be correctly
transferred. An example of this occurs when a "no CDs/DVDs are defined" message
appears on-screen when accessing the CD/DVD name listings. Try the FTP transfer
process again.
74
DXP-PRO v1.1 - Programmer’s Guide
Using the DXP-PRO Wizard
To use FTP to transfer these files to the system's NetLinx Master, you'll need to know the Master's
IP Address:
1. Launch Windows Explorer and navigate to the directory where your Design XPress project is
located.
2. Locate and select every TXT file in the project folder. Be sure to select every TXT file, and
only TXT files.
3. Copy the files to clipboard memory (right-click on the selection and select Copy).
4. Launch Internet Explorer.
5. In the Address box, enter FTP://, followed by the IP Address of the Master, and press Enter.
6. Assuming the IP Address was entered correctly, and the Master is connected properly, you are
presented with a dialog prompting you to enter the User Name and Pa ss wo rd for the Master.
The default User Name is NetLinx.
The default Password is password.
7. Enter the User Name and Password, and click the Log On button. Once you are logged on to
the Master, you should see directories associated with your Design XPress project.
8. Paste the copied TXT files into the root of this directory. Do not paste them into a folder or
create a new folder for them; they must reside at the root.
9. Reboot the Master.
XP-PRO v1.1 - Programmer’s Guide
75
Using the DXP-PRO Wizard
76
DXP-PRO v1.1 - Programmer’s Guide
DXP-PRO Touch Panel Channel Maps
DXP-PRO Touch Panel Channel Maps
The channel maps are generated in TPD4. Once you have created a touch panel project:
1. Open a TPD4 template file.
2. From the Main menu, click Panel to open a drop-down menu.
3. Select Generate Programmer's Report and choose the output file type for the information
(Comma Separated Format, Text-Only format, and Web Page Format). The report provides you
with function codes and just about anything else you'd ever want to know about the TPD4 file.