Operation/Reference Guide NXV-300 Modero© Virtual Touch Panel Touch Panels Last Revised: 12/19/2012
AMX Limited Warranty and Disclaimer This Limited Warranty and Disclaimer extends only to products purchased directly from AMX or an AMX Authorized Partner which include AMX Dealers, Distributors, VIP’s or other AMX authorized entity.
Table of Contents Table of Contents Overview ............................................................................................................1 Product Specifications .............................................................................................. 1 Installation ..........................................................................................................3 Wiring and Connections ...........................................................................................
Table of Contents @PPA...................................................................................................................................... @PPF ...................................................................................................................................... @PPG ..................................................................................................................................... @PPK.......................................................................
Table of Contents ^FON ..................................................................................................................................... ^GDI....................................................................................................................................... ^GIV ....................................................................................................................................... ^GLH ....................................................................
Table of Contents Input Commands..................................................................................................... 61 ^KPS ...................................................................................................................................... 61 ^VKS ...................................................................................................................................... 61 Embedded codes ........................................................................
Overview Overview The NetLinx NXV-300 Modero Virtual Touch Panel (FG2263-01) is a small rack-mountable device (similar in size to an NI-700 NetLinx Controller) that allows users to access a network via any PC or Macintosh computer via Virtual Network Connection (VNC). Instead of using an actual touch screen to interface with a network, users navigate to the device using a browser (Internet Explorer, Firefox and Safari for PCs and Firefox and Safari for Macs) and login with a username and password.
Overview NXV-300 Specifications (Cont.) Certifications: • FCC Class B • CE • IEC60950 • RoHS Other AMX Equipment: • PS-POE-AF PoE Injector (FG423-80) • AC-DIN-CS3 DIN Rail Mounting Bracket (FG532-01) • AC-RK Accessory Rack Kit (FG515) The NXV-300 can be used in most AMX networks as a controlling touch panel, as shown in FIG. 2: FIG.
Installation Installation Wiring and Connections To avoid any damage to the electronic component, installation must be performed in an ESD safe environment. The NXV-300 is installed to the NetLinx Master, and passes NetLinx control commands to the Master via Ethernet 10/ 100 cable, as indicated in FIG. 3: NetLinx Master Ethernet 10/100 Ethernet Switch Ethernet 10/100 NXV-300 PoE injector To Touch Panel To Laptop FIG.
Installation 4 NXV-300 Modero Virtual Touch Panel
Setup Pages and Descriptions Setup Pages and Descriptions Overview NXV-300 devices allow updates and changes to Setup and Protected Setup pages in the same way as any other AMX touch panel. The main difference is you may make various configuration settings via a web browser on any PC that has access to the NXV-300 device.
Setup Pages and Descriptions 3. The browser will bring up the main touch panel page. To open the Setup pages, press and hold the Reset Button on the front of the device for 5 seconds. 4. Access the Protected Setup pages, using your password if necessary. The unit’s IP Address is displayed in the System Settings - IP page in the Protected Setup pages. At this point, you can assign a static IP Address if necessary.
Setup Pages and Descriptions Status The Status page (FIG. 6) is the first page viewed when entering the Setup page interface from the main touch panel pages. The Status page may be reached by pressing and holding down the Reset button on the front of the device for six seconds. Display Current time Info Date Protected Setup FIG.
Setup Pages and Descriptions Display The Display Page (FIG. 7), accessed by pressing the Display button on the Status page, allows adjustment of the default panel settings. FIG. 7 Display Page The elements of the Display page are described in the table below: Display Page Elements Connection Status icon: This visual display of the connection status allows the user to have a current visual update of the panel’s connection status regardless of what page is currently active.
Setup Pages and Descriptions Panel Information The Project Information page displays the TPDesign4 (TPD4) project file properties currently loaded on the selected Modero panel (FIG. 8). Refer to the TPDesign4 Touch Panel Program instruction manual for more specific information on uploading TPDesign4 files to a panel. Select between the Info, Config, File, and Project tabs to view the appropriate information. Panel Information - Info Tab FIG.
Setup Pages and Descriptions Panel Information Page - Config Tab FIG. 9 Panel Information Page - Config Tab The elements of the Panel Information page Config tab are described in the table below: Project Information Page - Config Tab Elements Connection Status icon: This visual display of the connection status allows the user to have a current visual update of the panel’s connection status regardless of what page is currently active.
Setup Pages and Descriptions Panel Information Page - File Tab FIG. 10 Panel Information Page - File Tab The elements of the Panel Information page File tab are described in the table below: Project Information Page - File Tab Elements Connection Status icon: This visual display of the connection status allows the user to have a current visual update of the panel’s connection status regardless of what page is currently active.
Setup Pages and Descriptions Project Information Page - File Tab Elements Connection Status icon: This visual display of the connection status allows the user to have a current visual update of the panel’s connection status regardless of what page is currently active. • A Lock only appears on the icon if the panel has established a connection with a currently secured target Master (requiring a username and password). Designer ID: Displays the designer information for the panel.
Setup Pages and Descriptions Protected Setup Page Elements (Cont.) Bonjour: Press this button to enable or disable broadcast of any Zero Config information. Note: The device must be rebooted for the change to take effect. Function Show: Press this button to enable the display of the channel port and channel code in the top left corner of the button, the level port and level code in the bottom left corner, and the address port and address code in the bottom right corner (FIG. 14).
Setup Pages and Descriptions Pressing the Function Show button once displays the function information on each button and slider in the Setup and Protected Setup pages (FIG. 13). Press the button again to hide the function information. FIG. 14 Button/slider Function Show example Protected Settings Page Icons The interface for the Protected Settings page includes buttons featuring icons instead of text.
Setup Pages and Descriptions System Settings Page The System Settings page (FIG. 16) sets Primary and Secondary DNS Address information with its corresponding IP communication parameters, sets NetLinx Master communication settings, and reads the device number assigned to the Modero panel. Select between the IP and Master tabs to view the appropriate information. Changes made on any tab of this page are not saved until the panel is rebooted.
Setup Pages and Descriptions System Settings Page - IP Tab Elements (Cont.) Domain Sets the unique name on the Internet to the panel for DNS look-up. • The panel belongs to the DNS domain. Ethernet Mode Sets the speed of the Ethernet connection to the panel. • Choices are: Auto, 10 Half Duplex, 10 Full Duplex, 100 Half Duplex, or 100 Full Duplex. MAC Address Displays a read-only field that is factory set by AMX for the built-in Ethernet interface.
Setup Pages and Descriptions System Settings Page - Master Tab Elements System Number: Allows you to enter a system number. Default value is 0 (zero). Master IP/URL: Sets the Master IP or URL of the NetLinx Master. This field is only enabled when selecting either the URL or the URL(UDP) Modes. Master Port Number: Enters the port number used with the NetLinx Master. • Default value is 1319.
Setup Pages and Descriptions G4 Web Control Page Elements (Cont.) Control Name The Control Name is the same name as the Device Name set in the Protected Setup Pages. The Control Name cannot be changed. This Web Control tab displays a G4 icon alongside the link to the Web Control Name given to this panel (FIG. 18). Control Password Allows entry of the G4 Authentication session password associated for VNC web access of this panel. Control Port Allows entry of the VNC Web Server’s port value.
Setup Pages and Descriptions Panel Statistics Page The options on the Panel Statistics page allow you to track the connection status for the panel. The Panel Statistics page tracks ICSP messages and Blink messages statistics (FIG. 20). Select between the ICSP and Blinks tabs to view the appropriate information. Panel Statistics - ICSP Tab FIG.
Setup Pages and Descriptions Panel Statistics - Blinks Tab FIG. 21 Panel Statistics Page - Blinks Tab The Blinks Tab tracks blinks, which are messages sent by the master once every 5 seconds to all connected devices. Features on this tab are as follows: Panel Statistics Page - Blinks Tab Elements Connection Status icon: The icon in the upper-right corner of each Setup page shows online/offline state of the panel to the master. • Bright red - disconnected • Bright green - connected.
Setup Pages and Descriptions Connection Utility The Connection Utility Page (FIG. 22) opens directly over the Protected Setup Page. Use this page to access the connection information for the panel, such as the panel IP address. FIG. 22 Connection Utility Page Features on this page are as follows: Connection Utility Page Connection Status icon: The icon in the upper-right corner of the utility provides a constant visual indication of current connection status.
Setup Pages and Descriptions 22 NXV-300 Modero Virtual Touch Panel
NetLinx Programming NetLinx Programming The NXV-300 may be programmed, using the commands in this section, to perform a wide variety of operations using Send_Commands and variable text commands. A device must first be defined in the NetLinx programming language with values for the Device: Port: System (in all programming examples - Panel is used in place of these values and represents all Modero panels).
NetLinx Programming Page Commands (Cont.) @DPG Delete a specific popup page from specified popup group if it exists. Syntax: "'@DPG-;'" Variable: popup page name = 1 - 50 ASCII characters. Name of the popup page. popup group name = 1 - 50 ASCII characters. Name of the popup group. Example: SEND_COMMAND Panel,"'@DPG-Popup1;Group1'" Deletes the popup page ’Popup1’ from the popup group ’Group1’. @PDR Set the popup location reset flag.
NetLinx Programming Page Commands (Cont.) @PPA Close all popups on a specified page. If the page name is empty, the current page is used. Same as the ’Clear Page’ command in TPDesign4. Syntax: "'@PPA-'" Variable: page name = 1 - 50 ASCII characters. Name of the page the popup is displayed On. Example: SEND_COMMAND Panel,"'@PPA-Page1'" Close all popups on Page1. @PPF Deactivate a specific popup page on either a specified page or the current page.
NetLinx Programming Page Commands (Cont.) @PPM Set the modality of a specific popup page to Modal or Non Modal. A Modal popup page, when active, only allows use of the buttons and features on that popup page. All other buttons on the panel page are inactivated. Syntax: "'@PPM-;'" Variable: popup page name = 1 - 50 ASCII characters. Name of the popup page. mode = NONMODAL converts a previously Modal popup page to a Non Modal.
NetLinx Programming Page Commands (Cont.) @PSE Set the show effect for the specified popup page to the named show effect. Syntax: "'@PSE-;'" Variable: popup page name = 1 - 50 ASCII characters. Name of the page the popup is displayed On. show effect name = Refers to the popup effect name being used. Example: SEND_COMMAND Panel,"'@PSE-Popup1;Slide from Left'" Sets the Popup1 show effect name to ’Slide from Left’. @PSP Set the show effect position.
NetLinx Programming Page Commands (Cont.) PPOG Toggle a specific popup page on either a specified page or the current page. If the page name is empty, the current page is used (see example 2). Toggling refers to the activating/deactivating (On/Off) of a popup page. This command works in the same way as the ’Toggle Popup’ command in TPDesign4. Syntax: "'PPOG-;'" Variable: popup page name = 1 - 50 ASCII characters. Name of the popup page. page name = 1 - 50 ASCII characters.
NetLinx Programming RGB Triplets and Names For Basic 88 Colors RGB Values for all 88 Basic Colors Index No.
NetLinx Programming RGB Values for all 88 Basic Colors (Cont.) 30 Index No.
NetLinx Programming RGB Values for all 88 Basic Colors (Cont.) Index No. Name Red Green Blue 87 Black 0 0 0 255 TRANSPARENT 99 53 99 Font Styles and ID Numbers Font styles can be used to program the text fonts on buttons, sliders, and pages. The following chart shows the default font type and their respective ID numbers generated by TPDesign4.
NetLinx Programming The TPDesign4 Touch Panel Design program has pre-set border styles that are user-selectable. The following number values may not be used for programming purposes when changing border styles. TPD4 border styles may ONLY be changed by using the name. TPD4 Border Styles by Name 32 No. Border styles No.
NetLinx Programming TPD4 Border Styles by Name (Cont.) No. Border styles No.
NetLinx Programming "^" Button Commands These Button Commands are used in NetLinx Studio and are case insensitive. All commands that begin with "^" have the capability of assigning a variable text address range and button state range. A device must first be defined in the NetLinx programming language with values for the Device: Port: System (in all programming examples - Panel is used in place of these values). Variable text ranges allow you to target 1 or more variable text channels in a single command.
NetLinx Programming "^" Button Commands (Cont.) ^BAU Append unicode text. Same format as ^UNI. Syntax: "'^BAU-,
NetLinx Programming "^" Button Commands (Cont.) ^BCT Set the text color to the specified color. Only if the specified text color is not the same as the current color. Note: Color can be assigned by color name (without spaces), number or R,G,B value (RRGGBB or RRGGBBAA). Syntax: "'^BCT-,
NetLinx Programming "^" Button Commands (Cont.) ^BMC Button copy command. Copy attributes of the source button to all the destination buttons. Note that the source is a single button state. Each state must be copied as a separate command. The section represents what attributes will be copied. All codes are 2 char pairs that can be separated by comma, space, percent or just ran together.
NetLinx Programming "^" Button Commands (Cont.) ^BMF Set any/all button parameters by sending embedded codes and data. Syntax: "'^BMF-,
NetLinx Programming "^" Button Commands (Cont.) ^BMF (Cont.) ’%OT’ = Set the Feedback (Output) Type to one of the following: None, Channel,Invert, ON (Always ON), Momentary, or Blink. ’%SM’ = Submit a text for text area button. ’%SF<1 or 0>’ = Set the focus for text area button. ’%OP<0-255>’ = Set the button opacity to either Invisible (value=0) or Opaque (value=255). ’%OP#<00-FF>’ = Set the button opacity to either Invisible (value=00) or Opaque (value=FF).
NetLinx Programming "^" Button Commands (Cont.) ^BML Set the maximum length of the text area button. If this value is set to zero (0) there is no max length. The maximum length available is 2000. This is only for a Text area input button and not for a Text area input masking button. Syntax: "'^BML-,'" Variable: variable text address range = 1 - 4000. max length = 2000 (0=no max length).
NetLinx Programming "^" Button Commands (Cont.) ^BOP Set the button opacity. The button opacity can be specified as a decimal between 0 - 255, where zero (0) is invisible and 255 is opaque, or as a HEX code, as used in the color commands by preceding the HEX code with the # sign. In this case, #00 becomes invisible and #FF becomes opaque. If the opacity is set to zero (0), this does not make the button inactive, only invisible.
NetLinx Programming "^" Button Commands (Cont.) ^BRD Set the border of a button state/states. Only if the specified border is not the same as the current border. The border names are available through the TPDesign4 border-name drop-down list. Syntax: "'^BRD-,
NetLinx Programming "^" Button Commands (Cont.) ^BVP Set the network password for the specified address. Syntax: "'^BVP-,'" Variable: variable text address range = 1 - 4000. network password = 1 - 50 ASCII characters. Example: SEND_COMMAND Panel,"'^BVP-500,PCLOCK'" Sets the password to PCLOCK for the specific PC control button. ^BVT Set the computer control network port for the specified address.
NetLinx Programming "^" Button Commands (Cont.) ^DPF Delete page flips from button if it already exists. Syntax: "'^DFP-,,'" Variable: variable text address range = 1 - 4000.
NetLinx Programming "^" Button Commands (Cont.) ^GIV Invert the joystick axis to move the origin to another corner. Parameters 1,2, and 3 will cause a bargraph or slider to be inverted regardless of orientation. Their effect will be as described for joysticks. Syntax: "'^GIV-,'" Variable: variable text address range = 1 - 4000. joystick axis to invert = 0 - 3.
NetLinx Programming "^" Button Commands (Cont.) ^GSC Change the bargraph slider color or joystick cursor color. A user can also assign the color by Name and R,G,B value (RRGGBB or RRGGBBAA). Syntax: "'^GSC-,'" Variable: variable text address range = 1 - 4000. color value = Refer to theRGB Values for all 88 Basic Colors table on page 29. Example: SEND_COMMAND Panel,"'^GSC-500,12'" Changes the bargraph or joystick slider color to Yellow.
NetLinx Programming "^" Button Commands (Cont.) ^JSI Set icon alignment using a numeric keypad layout for those buttons with a defined address range. The alignment of 0 is followed by ',,'. The left and top coordinates are relative to the upper left corner of the button. Syntax: "'^JSI-,
NetLinx Programming "^" Button Commands (Cont.) ^TEF Set the text effect. The Text Effect is specified by name and can be found in TPD4. Syntax: "'^TEF-,
NetLinx Programming Text Effect Names The following is a listing of text effects names. This list is associated with the ^TEF command on page 48.
NetLinx Programming Button Query Commands Button Query commands reply with a custom event. Each button/state combination has one custom event. Each query is assigned a unique custom event type.
NetLinx Programming Button Query Commands ?BCB Get the current border color. Syntax: "'?BCB-,
NetLinx Programming Button Query Commands (Cont.) ?BCT Get the current text color. Syntax: "'?BCT-,
NetLinx Programming Button Query Commands (Cont.) ?BOP Get the overall button opacity. Syntax: "'?BOP-,
NetLinx Programming Button Query Commands (Cont.) ?BWW Get the current word wrap flag status. Syntax: "'?BWW-,
NetLinx Programming Button Query Commands (Cont.) ?ICO Get the current icon index. Syntax: "'?ICO-,
NetLinx Programming Button Query Commands (Cont.) ?JSI Get the current icon justification. Syntax: "'?JSI-,
NetLinx Programming Button Query Commands (Cont.) ?TEC Get the current text effect color. Syntax: "'?TEC-,
NetLinx Programming Button Query Commands (Cont.) ?TXT Get the current text information. Syntax: "'?TXT-,
NetLinx Programming Panel Runtime Operation Commands (Cont.) AKEYP Pop up the keypad icon and initialize the text string to that specified. The keypad string is set to null on power up and is stored until power is lost. Syntax: "'AKEYP-'" Variables: number string = 0 - 9999. Example: SEND COMMAND Panel,"'AKEP-12345'" Pops up the Keypad and initializes the text string '12345'. AKEYR Remove the Keyboard/Keypad.
NetLinx Programming Panel Runtime Operation Commands (Cont.) @PKP Present a private keypad. Pops up the keypad icon and initializes the text string to that specified. Keypad displays a '*' instead of the numbers typed. The Prompt Text is optional. Syntax: "'@PKP-;'" Variables: initial text = 1 - 50 ASCII characters. prompt text = 1 - 50 ASCII characters.
NetLinx Programming Input Commands These Send Commands are case insensitive. Input Commands ^KPS Set the keyboard passthru. Syntax: "'^KPS-'" Variable: pass data: = Disables the keyboard. 0 = Pass data to G4 application (default). This can be used with VPC or text areas. 1 - 4 = Not used. 5 = Sends out data to the Master. Example: SEND COMMAND Panel,"'^KPS-5'" Sets the keyboard passthru to the Master.
NetLinx Programming Embedded codes The following is a list of G4-compatible embedded codes: Embedded Codes Decimal numbers 62 Hexadecimal values Virtual keystroke 8 ($08) Backspace 13 ($0D) Enter 27 ($1B) ESC 128 ($80) CTRL key down 129 ($81) ALT key down 130 ($82) Shift key down 131 ($83) F1 132 ($84) F2 133 ($85) F3 134 ($86) F4 135 ($87) F5 136 ($88) F6 137 ($89) F7 138 ($8A) F8 139 ($8B) F9 140 ($8C) F10 141 ($8D) F11 142 ($8E) F12 143 ($8F) N
NetLinx Programming Panel Setup Commands These commands are case insensitive. Panel Setup Commands @PWD Set the page flip password. @PWD sets the level 1 password only. Syntax: "'@PWD-'" Variables: page flip password = 1 - 50 ASCII characters. Example: SEND COMMAND Panel,"'@PWD-Main'" Sets the page flip password to 'Main'. ^PWD Set the page flip password. Password level is required and must be 1 - 4.
NetLinx Programming Dynamic Image Commands (Cont.) ^RMF Modify an existing resource. Syntax: "'^RMF-,'" Variable: resource name = 1 - 50 ASCII characters data = Refer to the table in the RAF command for more information. Example: SEND_COMMAND Panel,"'^RMF-Sports_Image,%ALab_Test/Images%Ftest.jpg'" Changes the resource ’Sports_Image’ file name to ’test.jpg’ and the path to ’Lab_Test/Images’. ^RSR Change the refresh rate for a given resource.
Appendix A: Telnet Commands Appendix A: Telnet Commands Overview The NXV-300 supports Telnet communications. This type of terminal communication can be accessed remotely, via TCP/IP. Telnet is an insecure form of terminal communication, since it does not require a physical connection to the device to connect. Further, the Telnet interface exposes information to the network (which could be intercepted by an unauthorized network client).
Appendix A: Telnet Commands Terminal Commands The Terminal commands listed in the following table can be sent directly to the NXV-300 via Telnet terminal session. In your terminal program, type "Help" or a question mark ("?") and to access the Help Menu, and display the Program port commands described below: Terminal Commands Command Description ----- Help ----- (Extended diag messages are OFF) ? or Help Displays this list of commands.
Appendix A: Telnet Commands Terminal Commands (Cont.) Command PING [ADDRESS] Description Pings an address (IP or URL), to test network connectivity to and confirms the presence of another networked device. The syntax is just like the PING application in Windows or Linux. Example: >ping 192.168.29.209 192.168.29.209 is alive. REBOOT Reboots the NXV-300. Example: >REBOOT Rebooting... RELEASE DHCP Releases the current DHCP lease for the NXV-300.
Appendix A: Telnet Commands Terminal Commands (Cont.) Command SET IP Description Sets the IP configuration. Enter a Host Name, Type (DHCP or Fixed), IP Address, Subnet Mask, and Gateway IP Address. Note: For NetLinx Central Controllers, the "Host Name" can only consist of alphanumeric characters. • Enter Y (yes) to approve/store the information into the NXV-300. • Enter N (no) to cancel the operation. Note: The NXV-300 must be rebooted to enable new settings.
Appendix A: Telnet Commands Terminal Commands (Cont.) Command SHOW LOG Description Displays the log of messages stored in the NXV-300's memory. The NXV-300 logs all internal messages and keeps the most recent messages. The log contains:· • Entries starting with first specified or most recent • Date, Day, and Time message was logged • Which object originated the message • The text of the message: SHOW LOG [start] [end] SHOW LOG ALL - specifies message to begin the display.
Appendix A: Telnet Commands 70 NXV-300 Modero Virtual Touch Panel
Appendix B - Troubleshooting Appendix B - Troubleshooting This section describes the solutions to possible hardware/firmware issues that could arise during the common operation of a Modero touch panel. Troubleshooting Information Symptom When using G4 WebControl to communicate with a target panel, a VNC Server dialog appears on my screen. Solution • During a WebControl connection to a target panel, a G4 Authentication dialog will ask you to enter the assigned password for the panel before allowing access.
Appendix B - Troubleshooting Troubleshooting Information (Cont.) Symptom Solution I have more that one Modero panel connected to my System Master and only one shows up. Multiple NetLinx Compatible devices (such as Modero panels) can be associated for use with a single Master. Each Modero panel comes with a defaulted Device Number value of 10001. When using multiple panels, it can become very easy to overlook the need to assign different Device Number values to each panel.
Appendix B - Troubleshooting NXV-300 Modero Virtual Touch Panel 73
12/12 ©2012 AMX. All rights reserved. AMX and the AMX logo are registered trademarks of AMX. AMX reserves the right to alter specifications without notice at any time. It’s Your World - Take Control™ 3000 RESEARCH DRIVE, RICHARDSON, TX 75082 USA • 800.222.0193 • 469.624.8000 • 469-624-7153 fax • 800.932.6993 technical support • www.amx.
