Harman AMX MXT/D-2000XL-PAN Programming Manual

Harman AMX MXT/D-2000XL-PAN Programming Manual

G4 touch panels, hyd raport touch connection ports
Table of Contents

Advertisement

Quick Links

CO N F IG U RATI O N & P RO G RA M M IN G M A NU A L
M O DE RO S S E R I ES G 4 TO U CH PA N E L S
M O DE RO X S E R I ES G 4 TO U C H PA N E L S
H YD RA PO R T TO U C H C O N N E C T I O N PO R TS
MXT/D-2000XL-PAN 20. 3" MODE RO X SER IES G4 P ANORA MI C TOUCH PAN ELS
MXT/D-1900L-PAN 1 9.4 " MODE RO X SER IES G4 P ANORA MI C TOUCH PAN ELS
MXT/D-1000 10. 1 " MODE RO X SER IES G4 TOUCH PA NELS
MXT/D-700 7" MODE RO X SERIES G4 TOUCH PA NELS
MXD-430 4.3" MODERO X SERIES G4 WALL MOUNT TOUCH PANEL
MST/D-1001(-L/-L2) 10 .1 " MODERO S SERI ES G4 TOUCH PAN ELS
MST/D-701(-L/-L2) 7 " MODERO S SERI ES G4 TOUCH PAN ELS
MST/D-431(-L/-L2) 4. 3" MODERO S SE RI ES G4 TOUCH PAN ELS
HPX-MSP-10 10 MODULE CONN ECTION POR T WI TH 1 0. 1" P ANE L
HPX-MSP-7 HYDR APOR T 8 MODULE CONNE CTION POR T WI TH 7 " PAN EL

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the AMX MXT/D-2000XL-PAN and is the answer not in the manual?

Questions and answers

Summary of Contents for Harman AMX MXT/D-2000XL-PAN

  • Page 1 CO N F IG U RATI O N & P RO G RA M M IN G M A NU A L M O DE RO S S E R I ES G 4 TO U CH PA N E L S M O DE RO X S E R I ES G 4 TO U C H PA N E L S H YD RA PO R T TO U C H C O N N E C T I O N PO R TS MXT/D-2000XL-PAN 20.
  • Page 2 IMPORTANT SAFETY INSTRUCTIONS READ these instructions. KEEP these instructions. HEED all warnings. FOLLOW all instructions. DO NOT use this apparatus near water. CLEAN ONLY with dry cloth. DO NOT block any ventilation openings. Install in accordance with the manufacturer's instructions. DO NOT install near any heat sources such as radiators, heat registers, stoves, or other apparatus (including amplifiers) that produce heat.
  • Page 3: Table Of Contents

    Table of Contents Table of Contents Modero G4 Configuration & Programming .............10 Overview ......................... 10 Additional Documentation....................10 HPX-MSP-7/10 HydraPort® Connection Ports ..........11 Overview ......................... 11 Opening and Closing HPX-MSP-7/10 Touch Panel ............11 Touch Panel State - Raised or Lowered....................11 Panel State Reporting...........................
  • Page 4 Table of Contents Bluetooth Device Search............................. 27 Searching For New Bluetooth Devices........................ 28 NFC (Modero X Series Panels only) ...................... 30 Smart Card................................30 Breakout Box ..............................31 Configuration Menu......................32 Panel Configuration ..........................32 Changing the Device Number ..........................33 Changing the Device Name..........................
  • Page 5 Table of Contents ^DTO ...................................... 50 ?DTO....................................... 50 @EKP ..................................... 51 ^KPS ...................................... 51 PKEYP..................................... 51 @PKP ..................................... 51 @PWD ....................................51 ^PWD ..................................... 51 SETUP ..................................... 52 SHUTDOWN..................................... 52 SLEEP ...................................... 52 @SOU...................................... 52 @TKP ...................................... 52 TPAGEON ....................................52 TPAGEOFF ....................................
  • Page 6 Table of Contents ^BOP ....................................... 65 ?BOP ....................................... 66 ^BOR ....................................... 66 ^BOS ....................................... 66 ^BPP ....................................... 66 ^BRD ...................................... 67 ?BRD ...................................... 67 ^BSF....................................... 67 ^BSM...................................... 67 ^BSO ....................................... 68 ^BSP ....................................... 68 ^BVL......................................68 ^BVN ....................................... 68 ^BVP ....................................... 68 ^BVT .......................................
  • Page 7 Table of Contents $SY......................................82 $IP ......................................82 $HN ......................................82 $MC......................................82 $ID ......................................82 $PX ......................................82 $PY......................................82 $ST......................................82 $AC ......................................82 $AP ......................................82 $CC ......................................82 $CP ......................................82 $LC......................................82 $LP ......................................82 $BX ......................................
  • Page 8 Table of Contents ^PHN-SETUP-USERNAME ............................... 89 ?MUT...................................... 90 ^MUT ..................................... 90 ?VOL ....................................... 90 ^VOL....................................... 90 Panel-to-Panel Video Communication ................91 ?CAM...................................... 91 ^VCE ...................................... 91 ^VCS ...................................... 91 Streaming Video, MXA-MP, and MXA-MPL Commands ........... 92 ^DMM...................................... 92 ^SDM....................................... 92 ^SLT......................................
  • Page 9 Table of Contents Touch Gesture Recognition..................105 ^AFP ....................................105 Gesture Velocity..........................106 Gesture Prioritization ......................... 106 Gesture VNC/Mouse Support ......................106 Gesture Custom Event ........................106 Enabling or Disabling the Gesture Custom Event................107 ^GCE ....................................107 Appendix A: Text Formatting ............... 108 Text Formatting Codes for Bargraphs/Joysticks ............
  • Page 10: Modero G4 Configuration & Programming

    Modero G4 Configuration & Programming Modero G4 Conf iguration & Programming Overview This document focuses on programming information for Modero G4 touch panels, including Modero S Series panels, Modero X Series panels, and HydraPort Touch Connection Ports. For more information on designing touch panel pages intended to optimize the Modero G4 Series experience, please refer to the TPDesign4 Operation Reference Guide and the User Interface Design Guide, both available at www.amx.com.
  • Page 11: Hpx-Msp-7/10 Hydraport® Connection Ports

    HPX-MSP-7/10 HydraPort® Connection Ports ® HPX-MSP-7/10 HydraPort Connection Ports Overview The HPX-MSP-7 HydraPort Touch Connection Port with 7" Panel, and HPX-MSP-10 HydraPort Touch Connection Port with 10.1" Panel are HydraPort Connection Ports with either a 7" or 10.1" Modero S Series Touch Panel built into the cover. When open, the unit provides easy access to the HydraPort modules and a full-featured Modero S Series Touch Panel.
  • Page 12: Settings Pages

    Settings Pages Settings Pages Overview Modero G4 Touch panels do not have separate Setup and Protected Setup pages. All touch panel settings and functionality are now controlled through one Settings page. The Connection & Networks and Conf iguration sections are accessible with the correct password.
  • Page 13: Using The Settings Pages

    Settings Pages Using the Settings Pages When opened, the Settings pages appear in the center of the panel display. Please note that many of the pages may be longer than they initially appear. To reach additional functions on a given page, the page itself may be scrolled up and down, much like a smart- phone display, to reveal those functions.
  • Page 14: Settings Menu

    Settings Pages Settings Menu The Settings menu (FIG. 6) controls access to all other settings pages within Modero G4 touch panels Settings menu FIG. 6 Settings Menu Status: Select this to go to the Status page (page 15). Display: Select this to go to the Display page (page 17) Sounds: Select this to go to the Sounds page (page 19).
  • Page 15: Status Menu

    Settings Pages Status Menu The Status page (FIG. 7) displays basic touch panel information, such as currently available memory and the screen resolution dimensions. Scroll down to see all menu items Status menu FIG. 7 Status Menu Device Number: Displays the panel’s device number. Connection: Displays the panel’s connection type.
  • Page 16 Settings Pages File Information Page Configuration: This section contains information on the panel’s configuration. Power Up Page: Displays the page assigned to display after the panel is powered-up. Inactivity Page: Displays the page assigned to display when the panel is in Sleep Mode. High Port: Displays the high port (port count) value for the panel.
  • Page 17: Display Menu

    Settings Pages Display Menu The Display menu (FIG. 9) controls the basic functions of the touch panel display, including the panel brightness. Display menu FIG. 9 Display Menu Brightness: Sets the display brightness and contrast levels of the panel. • Move the slidebar to the left or right to adjust the brightness level. Auto Dim: Press this button to enable automatic dimming of the panel display if the Display Timeout setting is enabled.
  • Page 18: Testing Touch Panel Calibration

    Settings Pages Panel calibration FIG. 11 Follow the instructions, touching the crosshairs in order across the screen. The page will read "Calibration Successful. Touch to continue." Touch anywhere on the screen to return to the Calibration page. NOTE: If the screen is not touched at that point, the device will automatically return to the Calibration page within 10 seconds. Testing Touch Panel Calibration In certain circumstances, you may wish to test the calibration of a panel without actually recalibrating it.
  • Page 19: Sounds Menu

    Settings Pages Sounds Menu The Sounds menu (FIG. 13) allows adjustment of volume levels and panel sounds settings. Scroll down to see all menu items Sounds menu FIG. 13 Sounds Menu Panel Volume: • Move the slidebar to the left or right to adjust the panel volume. •...
  • Page 20: Audio Devices

    Settings Pages Audio Devices The Audio Devices page (FIG. 14) allows control of audio input and output both from the touch panel’s internal microphone (in a Modero G4 touch panel with microphone functionality) and speaker, or from external USB or Bluetooth devices. Audio Devices page FIG.
  • Page 21: Date & Time Page

    Settings Pages Date & Time Page The Date & Time page (FIG. 16) allows setting and adjusting of time and date information on the Modero G4 touch panel. If the time and/or date on the Master is modified, all connected devices will be updated to reflect the new information Date &...
  • Page 22: Connection & Networks Menu

    Settings Pages Connection & Networks Menu The Connections & Networks menu (FIG. 17) is the center for several networking functions, including connecting the touch panel to a Master, connecting it to a network, allowing Bluetooth functionality, and controlling video functionality. Connection &...
  • Page 23: Scanning For Masters

    Settings Pages Master Connection Page (Cont.) System Number: Allows entry of a system number. Default value is 0 (zero). NOTE: Available in Auto Mode Only - disabled when URL or Listen is selected. Master IP/URL: Sets the Master IP or URL of the NetLinx Master. NOTE: Available in URL Only - disabled when Listen or Auto is selected.
  • Page 24: Changing The Master Port Number

    Settings Pages Master IP Address keyboard FIG. 20 Enter the IP address or the URL in the keyboard field and press OK. The new IP address/URL is now displayed in the Master IP/URL field. When finished, press Back to return to the Settings page. Changing the Master Port Number To change the Master Port Number from its default: From the Master Connection page, press the Master Port Number field to open the Master Port Number keypad (FIG.
  • Page 25: Changing The Password

    Settings Pages Changing the Password From the Master Connection page, press the Password field to open the Master Password keyboard (FIG. 23). Master Password keyboard FIG. 23 Enter the new password in the keyboard field and press OK. When finished, press Back to return to the Settings page. Network Connection The Network Connection page (FIG.
  • Page 26: Setting Static Ip Information

    Settings Pages Setting Static IP Information When using DHCP settings for a panel, the DHCP server will automatically populate almost all of the Network Connections page fields, with the exception of Hostname. When setting the panel for Static, however, this information must be entered manually. To enter the network connection information: In DHCP/Static, press the field until the entry reads “Static”.
  • Page 27: Bluetooth

    Settings Pages Bluetooth The Bluetooth page (FIG. 27) controls whether a touch panel allows access to previously selected Bluetooth devices, as well as allowing new devices’ access. Bluetooth page FIG. 27 Bluetooth Page Bluetooth: Click this button to enable or disable Bluetooth device access to the touch panel. Set up new device...: Select to open the Bluetooth Device Search page (FIG.
  • Page 28: Searching For New Bluetooth Devices

    Settings Pages Searching For New Bluetooth Devices Modero G4 touch panels have the capability of detecting active Bluetooth devices connected to their network through a MXA-BT Bluetooth USB Adaptor (FG5968-19). Once paired with the panel, a Bluetooth device may go out of range of the MXA-BT and lose a connection, but automatically reconnect once it returns within range.
  • Page 29 Settings Pages Enter Pincode keypad FIG. 31 NOTE: You must enter the pincode within 30 seconds. If a pincode needs to be entered from the device, a System Message popup window appears, requesting that this be done (FIG. 32). System Message: Please enter the pincode FIG.
  • Page 30: Nfc (Modero X Series Panels Only)

    Settings Pages NFC (Modero X Series Panels only) The NFC page toggles Near Field Communications™ (NFC) access on the X Series touch panel, and displays the last NFC tag read by the device (FIG. 35): NFC page FIG. 35 NFC Page (Modero X Series only) NFC: Click this button to enable or disable NFC functionality.
  • Page 31: Breakout Box

    Settings Pages Breakout Box To use the MXA-MP Multi Preview or MXA-MPL Multi Preview Live devices for video stream display, the Modero G4 touch panel to which it is connected needs to be configured to receive its signals. If a Breakout Box is not connected to the panel’s network, all fields but the Breakout Box button will be empty.
  • Page 32: Configuration Menu

    Settings Pages Conf iguration Menu The Conf iguration menu (FIG. 38) allows confirmation of and changes to panel configuration information. Configuration menu FIG. 38 Conf iguration Menu Panel: Select this to open the Panel Conf iguration page (page 32). Admin: Select this to open the Admin Conf iguration page (page 37).
  • Page 33: Changing The Device Number

    Settings Pages Panel Conf iguration Page (Cont.) Synchronize Device Click this button to synchronize the Device Name, Hostname, and G4 Web Control Names (page 35). If this is Names: enabled, only the Device Name can be modified, but this will be populated to the other names as well. Telnet/SSH: Click this button to enable or disable remote access to the panel via Telnet.
  • Page 34: G4 Webcontrol

    Settings Pages Power Management Page (Cont.) Panel Shutdown: This value determines the number of seconds, minutes, or hours that need to pass before the panel automatically shuts down. Use the Up/Down arrows to change the settings; a value of Off disables this feature. Once the touch panel is shut down, the Sleep button must be pressed to wake up the panel.
  • Page 35: Function Show

    Settings Pages Function Show When the Function Show feature is enabled, function information is displayed for each button on the panel: the Channel Port and Code will appear in yellow, the Address Port and Code in blue, and the Level Port and Code in purple. Function Show FIG.
  • Page 36: Sensor Settings (Modero X Series Panels Only)

    Settings Pages Sensor Settings (Modero X Series Panels only) The Sensor Settings page (FIG. 46) allows activation and optimization of the touch panel’s motion and light sensors. Scroll down to see all menu items Sensor Settings page FIG. 46 Sensor Settings Page (Modero X Series only) Motion Detection: •...
  • Page 37: Admin Configuration

    Settings Pages Admin Conf iguration The Admin Conf iguration page (FIG. 47) allows control of access to the Settings pages, passwords, security settings, and the ability to install firmware or touch panel pages from various sources Scroll down to see all menu items Admin Configuration page FIG.
  • Page 38: Changing An Admin Password

    Settings Pages Changing an Admin Password In the Passwords page, select the appropriate entry for the particular password to be changed. This opens a password keyboard (FIG. 49). Password 1 keyboard FIG. 49 In the Password keyboard, enter the new alphanumeric password. Press OK when complete.
  • Page 39: Security Profile Features

    Settings Pages Security Prof ile Features Each of the settings on this page has different features for touch panel security: Security Prof ile Features Standard: • Factory default, shipped in this configuration. • Default Password is 1988. • Remote login uses Telnet. Secure: •...
  • Page 40 Settings Pages Install Factory Firmware system message FIG. 52 Within five seconds, the Yes button will be enabled. At that time, select Yes to install the factory firmware and No to return to the Install Firmware page. If you choose Yes, the touch panel will reboot and restart with the factory default firmware. To reset the touch panel to its original factory firmware from the panel bootup: Immediately after the touch panel boots up, the device’s splash page appears on the screen (FIG.
  • Page 41: Installing Previous Firmware

    Settings Pages Installing Previous Firmware In certain circumstances, it may be necessary to revert to a previously installed version of the touch panel firmware.To reset the touch panel to its previously installed firmware via the Settings pages: From the Install Firmware page, select the Previous field. A System Message window appears, asking “Are you sure you want to install the following firmware?”, with the previous firmware version listed below (FIG.
  • Page 42: Sip (Modero X Series Only)

    Settings Pages Upgrade In Progress screen FIG. 57 Once the upgrade is complete, the touch panel will automatically reboot with the new firmware. You may remove the USB stick from the USB A port once the dots in the splash page (FIG. 53) start moving. If you do not remove the USB stick, the update initiation screen will appear again.
  • Page 43: Changing The Sip Proxy Address

    Settings Pages NOTE: A sample UI module is provided in the module package. It is not intended to cover every possible application, but can be expanded as needed by a dealer to meet the requirements of a particular installation. Changing the SIP Proxy Address To change the SIP proxy address: From the SIP page, select the Port Number field to open the SIP Proxy Address keyboard (FIG.
  • Page 44: Advanced Config

    Settings Pages Enter the STUN server address and click OK. Click Save to save your changes to the SIP page and return to the Conf iguration page. Advanced Conf ig The Advanced Conf ig page (FIG. 62) displays options for more advanced configuration options, such as running diagnostics or modifying the options for streaming video.
  • Page 45: Diagnostics

    Settings Pages Cache Settings Page (Cont.) RAM Max Size: Displays the maximum RAM size for this panel before the least recently used items are discarded. RAM Hit Rate: The percentage of recent image requests satisfied by accessing the RAM cache. RAM Items: The total number of cached images in the RAM cache.
  • Page 46: Network Statistics

    Settings Pages Network Statistics The Network Statistics page (FIG. 66) displays received and transmitted IP packets. Touch the Refresh button to return the counters to their placement before the latest update. Network Statistics page FIG. 66 Network Statistics Page Refresh: Refreshes all data on this page.
  • Page 47: Connection Utility

    Settings Pages Connection Utility The Connection Status page (FIG. 68) displays the current connection information, including the latest Master and panel IP address information. Connection Utility page FIG. 68 Connection Utility Page Status: Click this button to enable the Connection Utility page. Master IP: The IP address for the network’s Master.
  • Page 48: Entering A Streaming Video Url

    Settings Pages Entering a Streaming Video URL To enter a URL for a video stream: From the Streaming Video page, select Enter URL to open the Set URL keyboard (FIG. 70). Set URL keyboard FIG. 70 Enter the URL for the camera and click OK. The camera feed will now appear in the Streaming Video page window.
  • Page 49: Programming

    Programming Programming Overview You can program Modero G4 touch panels, using the commands in this section, to perform a wide variety of operations using Send Commands and variable text commands. These commands are used in NetLinx Programming Language and are case insensitive. A device must f irst be def ined 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).
  • Page 50: Akp

    Programming Panel Commands (Cont.) @AKP Pop up the keypad icon and initialize the text string to that specified. Keypad string is set to null on power up and is stored until power is lost. The Prompt Text is optional. • Syntax: "'@AKP-<initial text>;<prompt text>'"...
  • Page 51: Ekp

    Programming Panel Commands (Cont.) @EKP Extend the Keypad.Pops up the keypad icon and initializes the text string to that specified. The Prompt Text is optional. • Syntax: "'@EKP-<initial text>;<prompt text>'" • Variables: initial text = 1 - 50 ASCII characters. prompt text = 1 - 50 ASCII characters.
  • Page 52: Setup

    Programming Panel Commands (Cont.) SETUP Send panel to SETUP page. • Syntax: "'SETUP'" • Example: SEND COMMAND Panel,"'SETUP'" Sends the panel to the Setup Page. SHUTDOWN Shut down the batteries providing power to the panel. • Syntax: "'SHUTDOWN'" • Example: SEND COMMAND Panel,"'SHUTDOWN'"...
  • Page 53: Page Commands

    Programming Panel Commands (Cont.) ^VKS Send one or more virtual key strokes to the G4 application. Key presses and key releases are not distinguished except in the case of CTRL, ALT, and SHIFT. Refer to theEmbedded Codes table on page 99 that define special characters which can be included with the string but may not be represented by the ASCII character set.
  • Page 54: Phe

    Programming Page Commands (Cont.) @PHE Set the hide effect for the specified popup page to the named hide effect. • Syntax: "'@PHE-<popup page name>;<hide effect name>'" • Variables: popup page name = 1 - 50 ASCII characters. Name of the page the popup is displayed On. hide effect name = Refers to the popup effect names being used.
  • Page 55: Ppk

    Programming Page Commands (Cont.) @PPK Kill a specific popup page from all pages. Kill refers to the deactivating (Off) of a popup window from all pages. If the pop-up page is part of a group, the whole group is deactivated. This command works in the same way as the 'Clear Group' command in TPDesign 4.
  • Page 56: Psp

    Programming Page Commands (Cont.) @PSP Set the show effect position. Only 1 coordinate is ever needed for an effect; however, the command will specify both. This command sets the location at which the effect will begin. • Syntax: "'@PSP-<popup page name>;<x coordinate>,<y coordinate>'" •...
  • Page 57: Button Commands

    Programming Page Commands (Cont.) PPON Activate a specific popup page to launch on either a specified page or the current page.If the page name is empty, the current page is used (see example 2). If the popup page is already On, do not re-draw it. This command works in the same way as the ’Show Popup’...
  • Page 58: Ani

    Programming Button Commands ^ANI Run a button animation (in 1/10 second). • Syntax: "'^ANI-<vt addr range>,<start state>,<end state>,<time>'" • Variables: variable text address range = 1 - 4000. start state = Beginning of button state (0= current state). end state = End of button state. time = In 1/10 second intervals.
  • Page 59: Bau

    Programming Button Commands (Cont.) ^BAU Append unicode text. Same format as ^UNI. • Syntax: "'^BAU-<vt addr range>,<button states range>,<unicode text>'" • Variables: variable text address range = 1 - 4000. button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and 2 = On state). unicode text = 1 - 50 ASCII characters.
  • Page 60: Bcf

    Programming Button Commands (Cont.) ?BCF Get the current fill color. • Syntax: "'?BCF-<vt addr range>,<button states range>'" • Variables: variable text address range = 1 - 4000. button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and 2 = On state). custom event type 1012: Flag - Zero Value1 - Button state number...
  • Page 61: Bdo

    Programming Button Commands (Cont.) ^BDO Determines what order each layer of the button is drawn. • Syntax: "'^BDO-<vt addr range>,<button states range>,<1-5><1-5><1-5><1-5><1-5>'" • Variables: variable text address range = 1 - 4000. button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and 2 = On state). layer assignments = Fill Layer Image Layer = 2...
  • Page 62: Bmc

    Programming Button Commands (Cont.) ^BMC Copy attributes of the source button to all the destination buttons. Note that the source is a single button state. Each state must be copied as a separate command. The <codes> section represents what attributes will be copied. All codes are 2 char pairs that can be separated by comma, space, percent or just ran together.
  • Page 63 Programming Button Commands (Cont.) ^BMF Note: This parameter should be always used in its own BMF command, and should not be combined with other BMF (Cont.) subcommands. ’%EN<1 or 0>’ = Enable/disable a button. ’%F’<font 1-8,10,11,20-29,32-xx> = Set the font. See the Default Font Styles and ID Numbers table on page 101. ’%GC<bargraph slider color>’...
  • Page 64: Bmi

    Programming Button Commands (Cont.) ^BMF ’%VL<0-1>’ = Log-On/Log-Off the computer control connection (Cont.) ’%VN<network name>’ = Set network connection name. ’%VP<password>’ = Set the network connection password. ’%WW<1 or 0>’ = Word wrap ON/OFF. • Example: SEND_COMMAND Panel,"'^BMF-500,1,%B10%CFRed%CB Blue %CTBlack%Ptest.png'" Sets the button OFF state as well as the Border, Fill Color, Border Color, Text Color, and Bitmap.
  • Page 65: Bnc

    Programming Button Commands (Cont.) ^BNC Clear current TakeNote annotations. • Syntax: "'^BNC-<vt addr range>,<command value>'" • Variables: variable text address range = 1 - 4000. command value = (0= clear, 1= clear all). • Example: SEND_COMMAND Panel,"'^BNC-973,0'" Clears the annotation of the TakeNote button with variable text 973. ^BNN Set the TakeNote network name for the specified Addresses.
  • Page 66: Bop

    Programming Button Commands (Cont.) ?BOP Get the overall button opacity. • Syntax: "'?BOP-<vt addr range>,<button states range>'" • Variables: variable text address range = 1 - 4000. button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and 2 = On state). custom event type 1015: Flag - Zero Value1 - Button state number...
  • Page 67: Brd

    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. Refer to theTPD4 Border Styles by Name table on page 102.
  • Page 68: Bso

    Programming Button Commands (Cont.) ^BSO Set the sound played when a button is pressed. If the sound name is blank, the sound is then cleared. If the sound name is not matched, the button sound is not changed. • Syntax: "'^BSO-<vt addr range>,<button states range>,<sound name>'"...
  • Page 69: Bww

    Programming Button Commands (Cont.) ^BWW Set the button word wrap feature to those buttons with a defined address range. By default, word-wrap is Off. • Syntax: "'^BWW-<vt addr range>,<button states range>,<word wrap>'" • Variables: variable text address range = 1 - 4000. button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and 2 = On state).
  • Page 70: Dvs

    Programming Button Commands (Cont.) ^DVS Delete Video Snapshot. Deletes any stored video snapshot associated with the button(s) with the given address(es) and state(s). When sent, the affected button(s) will display a black screen in the video button until the button becomes active and video starts again.
  • Page 71: Giv

    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. •...
  • Page 72: Gsn

    Programming Button Commands (Cont.) ^GSN Change the bargraph slider name or joystick cursor name. Slider names and cursor names can be found in the TPDesign4 slider name and cursor drop-down list. • Syntax: "'^GSN-<vt addr range>,<bargraph slider name>'" • Variables: variable text address range = 1 - 4000.
  • Page 73: Irm

    Programming Button Commands (Cont.) ^IRM Set the IR channel - Pulse the given IR channel for onTime in tenths of seconds. Delay offTime in tenths of a second before the next IR pulse is allowed. ^IRM allows the command itself to specify the port number. ^IRM is needed because commands programmed on the panel itself can only be sent to a single port number.
  • Page 74: Jsi

    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 ',<left>,<top>'. The left and top coordinates are relative to the upper left corner of the button. •...
  • Page 75: Jst

    Programming Button Commands (Cont.) ?JST Get the current text justification. • Syntax: "'?JST-<vt addr range>,<button states range>'" • Variables: variable text address range = 1 - 4000. button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and 2 = On state). custom event type 1004: Flag - Zero Value1 - Button state number...
  • Page 76: Skt

    Programming Button Commands (Cont.) ^SKT Receive touch information on specified socket. • Syntax: "'^SKT-<socket>'" • Variable: socket = <0=disable socket, greater than 1023=enable socket on specified port> Only socket values equal to or greater than 1024 are valid. The panel will open up a TCP listening socket on the port specified.
  • Page 77: Tef

    Programming Button Commands (Cont.) ?TEF Get the current text effect name. • Syntax: "'?TEF-<vt addr range>,<button states range>'" • Variables: variable text address range = 1 - 4000. button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and 2 = On state). custom event type 1008: Flag - Zero Value1 - Button state number...
  • Page 78: Txt

    Programming Button Commands (Cont.) ?TXT Get the current text information. • Syntax: "'?TXT-<vt addr range>,<button states range>,<optional index>'" • Variables: variable text address range = 1 - 4000. button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and 2 = On state). optional index = This is used if a string was too long to get back in one command.
  • Page 79: Text Effects Names

    Programming Text Effects Names The following is a listing of text effects names associated with the ^TEF command on page 76. Text Effects • Glow -S • Medium Drop Shadow 1 • Hard Drop Shadow 1 • Glow -M • Medium Drop Shadow 2 •...
  • Page 80: Dynamic Image Commands

    Programming Dynamic Image Commands The following table describes Dynamic Image Commands. Dynamic Image Commands ^BBR Set the bitmap of a button to use a particular resource. Syntax: "'^BBR-<vt addr range>,<button states range>,<resource name>'" Variables: variable text address range = 1 - 4000. button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and 2 = On state).
  • Page 81: Raf, ^Rmf - Embedded Codes

    Programming Dynamic Image Commands (Cont.) ^RMF Modifies any and all resource parameters by sending embedded codes and data. Since the embedded codes are preceded by a '%' character, any '%' character contained in the URL must be escaped with a second '%' character (see example).
  • Page 82: Escape Sequences

    Programming ^RAF, ^RMF - Embedded Codes Parameter Embedded Code Description dynamo Enable/disable Fast Dynamo. ’%D’ Panel will attempt to accelerate this resource in hardware. Notification setting Indicates whether a notification is required when a Dynamic Image is loaded/ '%C<on,off,once>' refreshed. The string following the %C can be: 1.
  • Page 83: Intercom Commands I

    Programming Intercom Commands Intercom Commands ^MODEL? Sets model name. If the panel supports intercom hardware it will respond with its model name as shown in the response below. Older hardware or newer hardware that has intercom support disabled with not respond to this command.
  • Page 84: Icm-Speakerlevel

    Programming Intercom Commands (Cont.) ^ICM-SPEAKERLEVEL Sets the speaker level during an intercom call (0 to 100). Syntax: SEND_COMMAND <DEV>, "^ICM-SPEAKERLEVEL,<value>" Variable: Level = 0-100 Example: SEND_COMMAND TP1, "^ICM-SPEAKERLEVEL,55" ^ICM-TALK Intercom modify command. Syntax: "'^ICM-TALK'" Example: SEND_COMMAND TP1,"'^ICM-TALK'" ^IIC Intercom incoming call. Syntax: “’^IIC’...
  • Page 85: Sip Commands

    Programming SIP Commands Panel to Master The following table lists and describes SIP commands that are generated from the touch panel. SIP Commands - Panel to Master ^PHN-AUTOANSWER SIP auto answer status - Provides the state of the auto-answer feature. •...
  • Page 86: Master To Panel

    Programming SIP Commands - Panel to Master ^PHN-PRIVACY SIP call privacy status - Indicates the state of the privacy feature. • Syntax: "'^PHN-PRIVACY,<state>'" • Variables: state = 0 (Disable) or 1 (Enable) new message count = The number of new messages. old message count = The number of old messages.
  • Page 87: Phn-Call

    Programming SIP Commands - Master to Panel (Cont.) ^PHN-CALL SIP call command - Calls the provided number. • Syntax: "'^PHN-CALL,<number>'" • Variable: number = The provided phone number • Example: SEND_COMMAND Panel,"'^PHN-CALL,2125551000'" Call the number 2125551000. ^PHN-DECLINE Decline (send to voice mail if configured) the incoming call on <CallID> as indicated from the previous PHN-INCOMING message.
  • Page 88: Phn-Privacy

    Programming SIP Commands - Master to Panel (Cont.) ?PHN-PRIVACY Get SIP privacy state command - Queries the state of the privacy feature. The panel responds with the ^PHN-PRIVACY, <state> message. • Syntax: "'?PHN-PRIVACY'" • Example: SEND_COMMAND Panel,"'?PHN-PRIVACY'" Get the current SIP privacy status. ^PHN-REDIAL SIP call redial command - Redials the last number.
  • Page 89: Audio Commands

    Programming SIP Commands - Master to Panel (Cont.) ^PHN-SETUP-PORT Setup port for SIP Server connection command - Sets the port number for the proxy server. • Syntax: "'^PHN-SETUP-PORT,<port>'" • Variable: port: The port for the proxy server • Example: SEND_COMMAND Panel,"'^PHN-SETUP-PORT,5060'" Set this extension to connect to the SIP server (SIP proxy address) to port 5060.
  • Page 90: Mut

    Programming Audio Commands (Cont.) ?MUT Queries the panel mute status (returned in custom event). • Syntax: "'?MUT-[device]'" • Variables: 0 = Active device (default if none specified) 1 = Built-in Speaker 2 = USB Headset 3 = Bluetooth Headset CUSTOM.TYPE = EVENTID = 1305 CUSTOM.ID = ADDRESS = 0 CUSTOM.FLAG = 0 CUSTOM.VALUE1 = 0 (unmuted)/1 (muted)
  • Page 91: Panel-To-Panel Video Communication

    Programming Panel-to-Panel Video Communication All camera-enabled Modero G4 panels are AMX Videocom-enabled. Videocom is a new feature that is supported on Modero G4 panels, where the output from the camera can be remotely viewed from any other Modero G4 panel. The camera output from one panel can be sent to one or many Modero G4 panels.
  • Page 92: Streaming Video, Mxa-Mp, And Mxa-Mpl Commands

    Programming Streaming Video, MXA-MP, and MXA-MPL Commands The following are NetLinx commands that control streaming video output, as well as coordinate video output to a Modero G4 touch panel from an MXA-MP Multi Preview or MXA-MPL Multi Preview Live video breakout box. NOTE: The command pref ix for all MXA-MP/L commands is "^SLT-1"...
  • Page 93: Notes On Using The ^Sdm And ^Slt Commands

    Programming Streaming Video, MXA-MP/MPL Commands ^SLT ^SLT-1,videoinput=<on|off> (Cont.) Note: It is highly recommended that the ^SDM commands be used to start and stop video from the MXA-MPL rather than the commands below. The SDM command will issue the start/stop to the MXA-MPL, as well as starting/stopping the decoding side on the panel.
  • Page 94: Subpages Commands

    Programming Subpages Commands Subpages Commands ^EPR Execute Push on Release. • Syntax: ^EPR-<addressArray>,<state> This sets the subpage viewer in a mode where a push will not be sent to the master until a touch release is received. Any movement of the finger during the screen press will cause neither the press nor the release to be sent. State 0 is off, State 1 is on.
  • Page 95: Led Commands (Mxd-430 Only)

    Programming Subpages Commands (Cont.) ^SHD Hides subpage • Syntax: "'^SHD-<vt addr range>,<name>,<optional time>'" This command will hide named subpage and relocate the surrounding subpages as necessary to close the gap. If the subpage to be hidden is currently offscreen then it is removed without any other motion on the subpage viewer button. Parameter definitions are the same as for the subpage show command.
  • Page 96: Hpx-Msp-7/10 Send Commands

    Programming HPX-MSP-7/10 Send Commands HPX-MSP-7/10 panels support existing G4 Send Commands. Additionally, there is a new Send Command that queries the position (Raised or Lowered) of the touch panel: HPX-MSP-7/10 Send Commands ?POS Panel Position Query - Requests the current position of the panel. Syntax: "'?POS-<optional id>'"...
  • Page 97: Dynamic Images

    Programming Dynamic Images Custom Events for Dynamic Images Resource Load Received when a resource for which notification is enabled is loaded. Notif ication CUSTOM.TYPE = EVENTID = 1400 custom event CUSTOM.ID = 0 CUSTOM.FLAG = 0 CUSTOM.VALUE1 = 0 CUSTOM.VALUE2 = 0 CUSTOM.VALUE3 = 0 CUSTOM.TEXT = String containing the resource name Example:...
  • Page 98: Smart Cards

    Programming Custom Events for Popups (Cont.) ?PUS Queries the size of a popup on the current page. Notifications happen via a custom event (1324) sent to the master from port 1 of the device. If the popup name is invalid, no custom event is sent to the master.
  • Page 99: Nfc Commands

    Programming NFC Commands Custom Events for NFC NFC Read tag Reported to the master when the panel reads an NFC Tag. custom event Custom event type - 700 ID - 1 Flag - 0 Value1 - Tag Type Value2 - Data Type Value3 - Length of data in the Text field Text - NFC Data (of type specified by Value2) Where Tag Type is:...
  • Page 100: Programming Numbers

    Programming Programming Numbers The following information provides the programming numbers for colors, fonts, and borders. Colors can be used to set the colors on buttons, sliders, and pages. The lowest color number represents the lightest color-specific display; the highest number represents the darkest display. For example, 0 represents light red, and 5 is dark red. RGB Triplets and Names For Basic 88 Colors RGB Values for all 88 Basic Colors Index No.
  • Page 101: Font Styles And Id Numbers

    Programming Font Styles And ID Numbers Font styles can be used to program the text fonts on buttons, sliders, and pages. The following chart shows the default font type and their respective ID numbers generated by TPDesign4. Default Font Styles and ID Numbers Font ID # Font type Size...
  • Page 102: Tpd4 Border Styles By Name

    Programming TPD4 Border Styles by Name TPD4 Border Styles by Name Border styles Border styles Border styles Border styles None Diamond 55 Windows Style Popup (Status Bar) Menu Right Rounded 15 AMX Elite -L Diamond 65 Menu Bottom Rounded 15 Menu Right Rounded 25 AMX Elite -M Diamond 75...
  • Page 103: Transitions And Gestures (X Series Panels Only)

    Transitions and Gestures (X Series Panels Only) Transitions and Gestures (X Series Panels Only) Overview You can program Modero X Series touch panels using the commands in this section to perform a wide variety of operations using Send Commands and variable text commands. A device must f irst be def ined 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).
  • Page 104 Transitions and Gestures (X Series Panels Only) Transition Classes (Cont.) Transition Transition Description Origins Default The new page opens, like the slats in a window blind, from its origin to its programmed Left Slats Right location. Right Bottom Left Squish The previous page compresses in the direction of the origin, revealing the new page.
  • Page 105: Touch Gesture Recognition

    Transitions and Gestures (X Series Panels Only) Transition Commands ^AFP Flips to a page with the specified page name using an animated transition. If the page is active, do not redraw the current page. Syntax: "'^AFP-<page name>,<animation>,<origin>,<time>'" Variable: • page name = 1 - 50 ASCII characters. If the page name is blank, flips to the previous page. •...
  • Page 106: Gesture Velocity

    Transitions and Gestures (X Series Panels Only) The Modero X Series introduces new multi-touch gestures as well: 2 Finger Swipe up  2 Finger Swipe down  2 Finger Swipe right  2 Finger Swipe left  Gesture Velocity A gesture “velocity” is calculated to represent the speed of the gesture. This is done by measuring the time from when the user first presses the screen until the user releases.
  • Page 107: Enabling Or Disabling The Gesture Custom Event

    Transitions and Gestures (X Series Panels Only) The Modero X Series introduces new multi-touch gestures as well: 2 Finger Swipe up 2 Finger Swipe down 10. 2 Finger Swipe right 11. 2 Finger Swipe left Simplified gesture velocity values are: Fast Normal Slow...
  • Page 108: Appendix A: Text Formatting

    Appendix A: Text Formatting Appendix A: Text Formatting Text Formatting Codes for Bargraphs/Joysticks Text formatting codes for bargraphs provide a mechanism to allow a portion of a bargraphs text to be dynamically provided information about the current status of the level (multistate and traditional). These codes are entered into the text field along with any other text.
  • Page 109: Input Mask Character Types

    Appendix A: Text Formatting With this feature, it is not necessary to: • Limit the user to a choice of selections • Handle complex input tasks such as names, days of the week, or month by name • Perform complex validation such as Subnet Mask validation Input mask character types These character types define what information is allowed to be entered in any specific instance.
  • Page 110: Input Mask Literals

    Appendix A: Text Formatting Input mask literals To define a literal character, enter any character, other than those shown in the above table (including spaces, and symbols). A back-slash ('\') causes the character that follows it to be displayed as the literal character. For example, \A is displayed just as the letter A.
  • Page 111 Appendix A: Text Formatting Escape Sequences Sequence Panel Information Device Number System Number IP Address Host Name Mac Address Neuron ID X Resolution of current panel mode/file Y Resolution of current panel mode/file X Resolution of current button Y Resolution of current button Name of button Current state Address Code...
  • Page 112: Appendix B: Video Streaming Troubleshooting

    Appendix B: Video Streaming Troubleshooting Appendix B: Video Streaming Troubleshooting Optimizing Motion JPEG Video Presentation and Speed In some cases, multiple Motion JPEG streams may slow presentation of individual screen popups, or prevent all of the streams from showing at the same time. This may happen even though the Panel Preview in TPDesign 4 may show no issues. To minimize this and assure a smooth and non-sluggish stream, try these options: Limit the number of simultaneous Motion JPEG streams to eight or fewer streams at a time.
  • Page 113 Appendix B: Video Streaming Troubleshooting Video Performance (Cont.) Typical Typical Expected Expected A/V Sync A/V Sync Device Latency - Latency - Notes: (offset/ Restart Typical Rate MXA-MPL (Cont.) MPEG2 H.264 <100ms ~ every 1.5s 3s or more, The MXA-UENET video accelerator cable (FG5968-74/75/76) is strongly 1-2hrs depending recommended for this application.
  • Page 114 Appendix B: Video Streaming Troubleshooting Video Performance (Cont.) Typical Typical Expected Expected A/V Sync A/V Sync Device Latency - Latency - Notes: (offset/ Restart Typical Rate 3rd Party Solutions H.264 Note: Third-party encoders and digital television devices have not been tested with Modero X Series touch panels, and are not supported by AMX.
  • Page 115 © 2017 Harman. All rights reserved. Modero, AMX, AV FOR AN IT WORLD, HARMAN, and their respective logos are registered trademarks of HARMAN. Last Revised: Oracle, Java and any other company or brand name referenced may be trademarks/registered trademarks of their respective companies.

Table of Contents