AMX Modero G4 Instruction Manual

AMX Modero G4 Instruction Manual

Configuration and programming
Table of Contents

Advertisement

Quick Links

I n s t r u c t i o n M a n u a l
Modero G4

Configuration and Programming

Modero X-Series G4 Touch Panels
Modero S-Series G4 Touch Panels
T o u c h P a n e l s
L a s t R e v is e d : 9 / 0 2 / 2 0 1 4

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Modero G4 and is the answer not in the manual?

Questions and answers

Summary of Contents for AMX Modero G4

  • Page 1: Configuration And Programming

    I n s t r u c t i o n M a n u a l Modero G4 Configuration and Programming Modero X-Series G4 Touch Panels Modero S-Series G4 Touch Panels T o u c h P a n e l s...
  • Page 2 AMX is not responsible for products returned without a valid RMA number. AMX is not liable for any damages caused by its products or for the failure of its products to perform. This includes any lost profits, lost savings, incidental damages, or consequential damages.
  • Page 3: Table Of Contents

    Searching for New Bluetooth Devices ................19 NFC ..........................21 Smart Card ........................22 Enabling a Touch Panel To Use a CAC Reader ................22 Breakout Box......................... 23 Configuring the Touch Panel..................... 23 Modero G4 Touch Panels - Configuration and Programming...
  • Page 4 Routing the Touch Panel’s Camera and Audio Input to a PC ............ 43 Transitions and Gestures ..................45 Overview ........................ 45 Animated Transitions ....................45 ^AFP ............................48 Touch Gesture Recognition..................49 Gesture Velocity......................49 Gesture Prioritization ....................49 Gesture VNC/Mouse Support..................50 Modero G4 Touch Panels - Configuration and Programming...
  • Page 5 Font Styles And ID Numbers ..................61 Border Styles and Programming Numbers ..............62 “^” Button Commands ................... 63 ^ANI............................63 ^APF ............................63 ^BAT ............................64 ^BAU............................64 ^BCB ............................64 ^BCF ............................65 Modero G4 Touch Panels - Configuration and Programming...
  • Page 6 ^JSB............................78 ^JSI ............................78 ^JST ............................78 ^MBT ............................. 79 ^MDC............................. 79 ^PIC ............................79 ^STF............................79 ^SHO ............................. 79 ^SKT ............................79 ^TEC ............................80 ^TEF............................80 ^TOP ............................80 Modero G4 Touch Panels - Configuration and Programming...
  • Page 7 @TKP ............................93 TPAGEON ..........................93 TPAGEOFF ..........................93 Panel Setup Commands ..................94 @PWD ............................ 94 ^PWD............................. 94 @VKB ............................. 94 WAKE............................. 94 Input Commands..................... 95 ^KPS ............................95 ^VKS ............................95 Modero G4 Touch Panels - Configuration and Programming...
  • Page 8 ^IIC ............................101 ^IOC............................. 101 SIP Commands ...................... 102 ^PHN-AUTOANSWER ......................102 ^PHN-CALL .......................... 102 ^PHN-DECLINE ........................102 ^PHN-INCOMING ........................ 102 ^PHN-LINESTATE......................... 102 ^PHN-MSGWAITING......................103 ^PHN-PRIVACY ........................103 ^PHN-REDIAL ........................103 ^PHN-TRANSFERRED ......................103 Modero G4 Touch Panels - Configuration and Programming...
  • Page 9 Notes on Using the ^SDM and ^SLT Commands ............112 Subpages Commands ................... 112 ^EPR ............................ 112 ^SCE ............................ 112 ^SDR ............................ 113 ^SHD............................ 113 ^SSH ............................ 114 ^STG ............................ 114 LED Commands..................... 115 ^WLD ........................... 115 Modero G4 Touch Panels - Configuration and Programming...
  • Page 10 Input mask output examples ..................122 URL Resources ...................... 122 Special Escape Sequences ................... 122 Appendix B: Video Streaming Troubleshooting ..........125 Optimizing Motion JPEG Video Presentation and Speed ........125 Transcoding Guidelines..................125 viii Modero G4 Touch Panels - Configuration and Programming...
  • Page 11: Modero G4 Configuration And Programming

    This document focuses on programming information for the Modero X and S Series G4 touch panels. For more information on designing touch panel pages intended to optimize the Modero G4 experience, please refer to the TPDesign4 Operation Reference Guide and the User Interface Design Guide, both available at www.amx.com.
  • Page 12 Modero G4 Configuration and Programming Modero G4 Touch Panels - Configuration and Programming...
  • Page 13: Settings Pages

    Settings Pages Overview Unlike previous AMX touch panels, Modero X/S Series G4 touch panels no longer have separate Setup and Protected Setup pages. All touch panel settings and functionality are now controlled through one Settings page. The Connection & Networks and Configuration sections are accessible with the correct password.
  • Page 14: Using The Settings Pages

    Connection Status - A green bar signifies that the panel Go to Previous has an active connection to the Master. Settings page Close this Settings page FIG. 5 Settings pages - Title bar Navigation Controls and Connection Status Modero G4 Touch Panels - Configuration and Programming...
  • Page 15: Saving Changed Settings

    The Connection & Networks and Configuration pages are password-protected. To open either of these pages: Select the appropriate page from the Settings page. In the Password keypad, enter the password and select OK. The default password is 1988. Modero G4 Touch Panels - Configuration and Programming...
  • Page 16: Status

    Displays the time when the panel was last started or restarted. Lamp Hours: Displays the number of hours elapsed with the display on full power. File Information: Select this to go to the File Information page (page 7). Modero G4 Touch Panels - Configuration and Programming...
  • Page 17: File Information

    Displays the feedback blink rate, in 5-second increments. Build Number: Displays the build number information of the TPD4 software used to create the project file. Job Comments: Displays any comments associated to the job (from the TPD4 project file). Modero G4 Touch Panels - Configuration and Programming...
  • Page 18: Display

    Calibration page To calibrate the touch panel: From the Settings page, select Display. From the Display page, select Calibration. To calibrate the touch panel, select Calibrate to open the Calibration page (FIG. 11). Modero G4 Touch Panels - Configuration and Programming...
  • Page 19: Calibration Test

    If the crosshairs do not match the places where you touch, then go back to calibrate the panel. Calibration Test Unlike previous AMX touch panels, the Modero X and S Series panels are self-calibrated on startup. The Calibration Test page (FIG. 13) may be used to verify the accuracy of that calibration.
  • Page 20: Sounds

    Press this button to enable the panel to play a default sound whenever a button on a page is selected. Button Hit Sound: Displays the information on the sound file associated with the Button Hit function. Press repeatedly to scroll through the 10 included sounds. Modero G4 Touch Panels - Configuration and Programming...
  • Page 21: Creating A Custom Sound Set

    For more information on how to export input from a microphone-enabled Modero X/S Series G4 panel, refer to the Routing the Touch Panel’s Camera and Audio Input to a PC section on page 43. Modero G4 Touch Panels - Configuration and Programming...
  • Page 22: Date & Time

    Master: From the Date & Time page, press the Get Time button. The new time and date will be added. Press the Back button to save the changes. Modero G4 Touch Panels - Configuration and Programming...
  • Page 23: Connection & Networks

    The Bluetooth and NFC options do not apply to Modero X/S Series G4 panels without Bluetooth or NFC functionality (including all "No Comm" panels). Master Connection The Master Connection page (FIG. 18) controls the method of connection to a NetLinx Master. FIG. 18 Master Connection page Modero G4 Touch Panels - Configuration and Programming...
  • Page 24: Scanning For Masters

    To change the Master Connection mode between URL, Listen, and Auto: From the Master Connection page, press the Mode field to change the mode. Keep pressing to bring up the desired mode. When finished, press Back to return to the Settings page. Modero G4 Touch Panels - Configuration and Programming...
  • Page 25: Changing The Master Ip/Url

    Changing the Master Username and Password To change the current username used by the touch panel to access the Master: From the Master Connection page, press the Username field to open the Master User keyboard (FIG. 22). Modero G4 Touch Panels - Configuration and Programming...
  • Page 26: Network Connection

    When finished, press Back to return to the Settings page. Network Connection The Network Connection page (FIG. 24) controls the configuration of settings for Ethernet communication with the touch panel FIG. 24 Network Connection page Modero G4 Touch Panels - Configuration and Programming...
  • Page 27: Setting Static Ip Information

    To add a new hostname, or to change an existing one: From the Connection & Networks page, select Network Connection to open the Network Connection page. From the Network Connection page, select Hostname to open the Host Name keyboard (FIG. 26). Modero G4 Touch Panels - Configuration and Programming...
  • Page 28: Bluetooth

    Use the Up/Down arrows to select the Bluetooth device currently connected to the touch panel. The Bluetooth options do not apply to Modero X/S Series G4 panels without Bluetooth functionality (including all "No Comm" panels). Modero G4 Touch Panels - Configuration and Programming...
  • Page 29: Bluetooth Device Search

    When the panel is finished scanning for Bluetooth devices, those devices still need to be paired with the touch panel if they have not done so before. In the search list, select the device to be paired and click Connect (FIG. 29). Modero G4 Touch Panels - Configuration and Programming...
  • Page 30 (FIG. 31). FIG. 31 System Message: Please enter the pincode Once the pincode has been entered, a new System Message popup window appears, noting that pairing is in progress (FIG. 32). Modero G4 Touch Panels - Configuration and Programming...
  • Page 31: Nfc

    NFC tag read by the device. For more information on the NFC capabilities of your panel, please refer to the Operation Reference Guide to the panel in question. These Operation Reference Guides are available at www.amx.com. FIG. 34...
  • Page 32: Smart Card

    (CAC) smart card readers.(FIG. 35) FIG. 35 Smart Card page Use of this feature requires the use of an AMX-approved CAC reader, as shown below. Smart Card Page Smart Card: Click this button to enable or disable the touch panel’s ability to use smart card readers Reader Name: Click this button to enable or disable displaying the smart card reader’s name and model.
  • Page 33: Breakout Box

    Breakout Box page will be blank other than the Breakout Box button. If an MXA-MP or MPL is not connected to the touch panel, the Breakout Box button MUST be disabled to prevent network conflicts. Modero G4 Touch Panels - Configuration and Programming...
  • Page 34: Configuration

    The Panel Configuration page (FIG. 38) allows configuration and updating of the touch panel’s device name and device number, access to power management and G4 Web control features, and configuration of the panel’s motion and light sensors. FIG. 38 Panel Configuration page Modero G4 Touch Panels - Configuration and Programming...
  • Page 35: Changing The Device Number

    The Device Number field in the Panel Configuration page will now display the new device number. Changing the Device Name To change the name associated with the touch panel: From the Panel Configuration page, select the Device Name field to open the Device Name keyboard (FIG. 40). Modero G4 Touch Panels - Configuration and Programming...
  • Page 36: Power Management

    An on-board VNC (Virtual Network Computing) server allows the panel to connect to any remote PC running a VNC client. Once connected, the client can view and control the panel remotely. FIG. 42 G4 WebControl page Modero G4 Touch Panels - Configuration and Programming...
  • Page 37: Sensor Settings

    VNC. Sensor Settings The Sensor Settings page (FIG. 43) allows activation and optimization of the touch panel’s motion and light sensors. FIG. 43 Sensor Settings page Modero G4 Touch Panels - Configuration and Programming...
  • Page 38: Calibrating The Light Sensor

    When the Function Show feature is displayed, the Channel Port and Code will appear in yellow, the Address Port and Code in blue, and the Level Port and Code in purple (FIG. 44). Modero G4 Touch Panels - Configuration and Programming...
  • Page 39: Synchronizing Device Names

    (FIG. 45). When a five-second timer ends, the Yes button will be enabled. FIG. 45 System Message: This will synchronize the following values to Device Name Click Yes when enabled. This will automatically synchronize all names to the current Device Name. Modero G4 Touch Panels - Configuration and Programming...
  • Page 40: Admin Configuration

    Select this to remove all currently loaded user pages from the panel. Admin Passwords The options on the Admin Passwords page allow assignment of passwords required for users to access the secured Settings pages. FIG. 47 Admin Passwords page Modero G4 Touch Panels - Configuration and Programming...
  • Page 41: Changing A Previously Established Password

    Password 5 (FIG. 47) is protected, and can only be changed by the Administrator. FIG. 49 Protected Password 5 keyboard In the Password keyboard, enter the new alphanumeric password. Press OK when complete. Modero G4 Touch Panels - Configuration and Programming...
  • Page 42: Security

    • DoD login banner is enabled. A transition from one security mode to another will reset the Protected/Web Control/remote login password to the default value for the current security mode (please refer to the default passwords above). Modero G4 Touch Panels - Configuration and Programming...
  • Page 43: Install Firmware

    Immediately after the touch panel boots up, the device’s splash page appears on the screen (FIG. 53). Press the three indicator dots within the first three seconds, before they start moving, to reset the firmware. Modero G4 Touch Panels - Configuration and Programming...
  • Page 44: Installing Previous Firmware

    Within five seconds, the Yes button will be enabled. At that time, select Yes to install the previous firmware version and No to return to the Install Firmware page. If you choose Yes, the touch panel will reboot and restart with the previously installed firmware. Modero G4 Touch Panels - Configuration and Programming...
  • Page 45: Installing New Firmware From An External Usb Stick

    Installing New Firmware From an External Disk Via the Settings Pages Download the latest Modero X/S Series G4 touch panel firmware from www.amx.com and save it to a USB stick. The firmware must be saved in a folder in the USB stick directory, corresponding with the touch panel model, in order to be recognized by the touch panel.
  • Page 46: Sip

    This option enables you to enter the IP address or DNS name of the proxy server used as the SIP gateway. Port Number: The option displays the port you use to connect to the proxy server. The standard SIP port is 5060, but some providers use different ports. Modero G4 Touch Panels - Configuration and Programming...
  • Page 47: Changing The Sip Proxy Address

    Click Save to save your changes to the SIP page and return to the Configuration page. Changing the SIP STUN Address To change the STUN address: From the SIP page, select the STUN Server field to open the SIP STUN Address keyboard (FIG. 62). Modero G4 Touch Panels - Configuration and Programming...
  • Page 48: Advanced Config

    The size of RAM cache is automatically configured to take into account available memory versus memory that may be needed by the panel later. As the RAM cache approaches its maximum size, the oldest items in the cache may be discarded to make room for newer items. Modero G4 Touch Panels - Configuration and Programming...
  • Page 49: Diagnostics

    Click this button to open the Network Statistics page (page 40). ICSP Statistics: Click this button to open the ICSP Statistics page (page 41). Connection Utility: Click this button to open the Connection Utility page (page 41). Modero G4 Touch Panels - Configuration and Programming...
  • Page 50: Logs

    The Network Statistics page (FIG. 67) displays received and transmitted IP packets. Touch the Refresh button to return the counters to their placement before the latest update. FIG. 67 Network Statistics page Network Statistics Page Refresh: Refreshes all data on this page. Modero G4 Touch Panels - Configuration and Programming...
  • Page 51: Icsp Statistics

    Click this button to enable the Connection Utility page. Master IP: The IP address for the network’s Master. Panel IP: The IP address used by the device. Messages Sent: Lists the number of queries sent to the Master. Modero G4 Touch Panels - Configuration and Programming...
  • Page 52: Streaming Video

    For more information on the functionality of the MicroUSB port, please refer to the Operation Reference Guide for the particular panel model, available from www.amx.com. Modero G4 Touch Panels - Configuration and Programming...
  • Page 53: Entering A Streaming Video Url

    In the Windows Start bar, select Control Panel. From the All Control Panel Items window, open Devices and Printers. The camera will appear in the Devices listing (FIG. 72). FIG. 72 Touch Panel camera appearing in the Devices listing Modero G4 Touch Panels - Configuration and Programming...
  • Page 54 PC. Camera input can only be routed to the panel or to the PC at any given time. The output from a Modero X/S Series G4 touch panel microphone is PCM. Modero G4 Touch Panels - Configuration and Programming...
  • Page 55: Transitions And Gestures

    LCD. In addition, the new page is semi-transparent, Left allowing the old page to be seen through until the transition is finished, Right at which point the old page has faded away. Bottom Modero G4 Touch Panels - Configuration and Programming...
  • Page 56 Right Lower right Upper right Wipe A wipe bar travels across the page from the origin, revealing the new Right page. Left Right Bottom Lower left Upper left Lower right Upper right Modero G4 Touch Panels - Configuration and Programming...
  • Page 57 Since the transitions require OpenGL hardware acceleration, they are not seen by the user on a VNC connection. When a transition is triggered, the user will see a normal page flip to the new page on the VNC connection, while the animated transition occurs as expected on the panel. Modero G4 Touch Panels - Configuration and Programming...
  • Page 58: Afp

    Flips to the page named 'MAIN' using the slide from left animated transition with a time of .5 second. SEND COMMAND Panel,"'^APF-MAIN,tumble,9,10'" Flips to the page named 'MAIN' using the tumble from the upper right animated transition with a time of 1 second. Modero G4 Touch Panels - Configuration and Programming...
  • Page 59: Touch Gesture Recognition

    To be clear, it is not necessary for the user to move off of a button to be considered a gesture, but to move at least 60 pixels in that first 0.15 of a second. Modero G4 Touch Panels - Configuration and Programming...
  • Page 60: Gesture Vnc/Mouse Support

    Note: This setting is not retained and the default is to always send the events. To enable sending the event, the value after the dash can be "on", "ON", or “1”. Anything else will disable sending custom events. Modero G4 Touch Panels - Configuration and Programming...
  • Page 61: Mxa-Mp And Mxa-Mpl Programming

    In the Edit Dynamic Image window (FIG. 74), add a new resource. In the example.  Protocol: HTTP  Host: mxamp  Path: snapit  File: slot1.jpg In this example, make sure to use at least a 2-second Refresh Rate. Modero G4 Touch Panels - Configuration and Programming...
  • Page 62: Adding A Live Motion Stream To A Touch Panel Page Via An Mxa-Mpl

    Loopback Port. In the Button Properties window, this may be found under the Programming tab. The touchpanel file attachment example in FIG. 76 below has examples of preview and streaming windows, as well as a page to give examples of switching resolutions and signal types. Modero G4 Touch Panels - Configuration and Programming...
  • Page 63 When using the MXA-MPL for displaying live motion streams, make sure to use the supported resolutions with the video input type. While the MXA-MPL is capable of supporting up to 60 Hz, the Modero X display panels that use MXA-MPL only support 25-30 Hz. Modero G4 Touch Panels - Configuration and Programming...
  • Page 64: Code-Driven Buttons And Video Feeds

    ** available in firmware v2.1.100 and later. Code-Driven Buttons and Video Feeds Example code is available from AMX to assist with developing individual solutions for producing dynamic buttons and/ or video feeds. From either the MXA-MP or MXA-MPL product pages on www.amx.com, select the AMX Device Modules link on the right side of the page.
  • Page 65: Programming

    Device: Port: System. In all programming examples - Panel is used in place of these values and represents all Modero panels). Verify you are using the latest NetLinx Master and Modero G4 Series firmware, as well as the latest version of NetLinx Studio and TPDesign4.
  • Page 66: Pdr

    ’Clear Page’ command in TPDesign4. Syntax: "'@PPA-<page name>'" Variable: page name = 1 - 50 ASCII characters. Name of the page the popup is displayed On. Example: SEND_COMMAND Panel,"'@PPA-Page1'" Close all pop-ups on Page1. Modero G4 Touch Panels - Configuration and Programming...
  • Page 67: Ppf

    MODAL converts a previously NonModal popup page to Modal. modal = 1 and non-modal = 0 Examples: SEND_COMMAND Panel,"'@PPM-Popup1;Modal'" Sets the popup page ’Popup1’ to Modal. SEND_COMMAND Panel,"'@PPM-Popup1;1'" Sets the popup page ’Popup1’ to Modal. Modero G4 Touch Panels - Configuration and Programming...
  • Page 68: Ppn

    = 1 - 50 ASCII characters. Name of the page the popup is displayed On. Example: SEND_COMMAND Panel,"'@PSP-Popup1;100,0'" Sets the Popup1 show effect x-coordinate value to 100 and the y-coordinate value to 0. Modero G4 Touch Panels - Configuration and Programming...
  • Page 69: Pst

    Toggles the popup page ’Popup1’ on the Main page from one state to another (On/Off). SEND_COMMAND Panel,"'PPOG-Popup1'" Toggles the popup page ’Popup1’ on the current page from one state to another (On/Off). Modero G4 Touch Panels - Configuration and Programming...
  • Page 70: Ppon

    = 1 - 50 ASCII characters. Name of the page the popup is displayed On. Examples: SEND_COMMAND Panel,"'PPON-Popup1; Main'" Activates the popup page ’Popup1’ on the Main page. SEND_COMMAND Panel,"'PPON-Popup1'" Activates the popup page ’Popup1’ on the current page. Modero G4 Touch Panels - Configuration and Programming...
  • Page 71: Programming Numbers

    Courier New Arial Courier New Arial Courier New Arial Courier New Arial Courier New Arial AMX Bold Arial AMX Bold Arial Bold AMX Bold Arial Bold 32 - Variable Fonts start at 32. Modero G4 Touch Panels - Configuration and Programming...
  • Page 72: Border Styles And Programming Numbers

    Menu Rt Rounded 125 Diamond 75 Menu Btm Rounded 75 Menu Rt Rounded 135 Diamond 85 Menu Btm Rounded 85 Menu Rt Rounded 145 Diamond 95 Menu Btm Rounded 95 Menu Rt Rounded 155 Modero G4 Touch Panels - Configuration and Programming...
  • Page 73: Button Commands

    = transition time in tenths of a second (from 3 to 30 with 15 being the default) Examples: SEND COMMAND Panel,"'^APF-400,Stan,Main Page'" Assigns a button to a standard page flip with page name 'Main Page'. SEND COMMAND Panle,"'^APF-400,StanAni,Main Page,Slide,Left,10'" Modero G4 Touch Panels - Configuration and Programming...
  • Page 74: Bat

    SEND_COMMAND Panel,"'^BCB-500.504&510,1,12'" Sets the Off state border color to 12 (Yellow). Colors can be set by Color Numbers, Color name, R,G,B, alpha colors (RRGGBBAA) and R, G & B colors values (RRGGBB). Modero G4 Touch Panels - Configuration and Programming...
  • Page 75: Bcf

    Sets the button’s variable text 530 ON/OFF state draw order (from bottom to top) to Border, Fill, Text, Icon, and Image. SEND_COMMAND Panel,"'^BDO-1,0,12345'" Sets all states of a button back to its default drawing order. Modero G4 Touch Panels - Configuration and Programming...
  • Page 76: Bfb

    1 = Off state and 2 = On state). number of lines = 0 - 240. Example: SEND_COMMAND Panel,"'^BLN-500,55'" Equally removes 55 lines from the top and 55 lines from the bottom of the video button. Modero G4 Touch Panels - Configuration and Programming...
  • Page 77: Bmc

    315 onto the OFF state border, font, Text, bitmap, icon, fill color and text color of the button with a variable text address of 150. Note: Use this command if you are using the panel’s default color palette. For custom color palettes, use ^BMF instead. Modero G4 Touch Panels - Configuration and Programming...
  • Page 78: Bmf

    ’%JT<alignment of text 0-9>’ = As shown the above telephone keypad alignment chart, BUT the 0 (zero) is absolute and followed by ’,<left>,<top>’ For some of these commands and values, refer to the RGB Values for all 88 Basic Colors table on page 61. Modero G4 Touch Panels - Configuration and Programming...
  • Page 79: Bmi

    = 1 - 256 for multi-state buttons (0 = All states, for General buttons, 1 = Off state and 2 = On state). mask image = Graphic file used. Example: SEND_COMMAND Panel,"'^BMI-530,1&2,newMac.png'" Sets the button with variable text 530 ON/OFF state mask image to 'newmac.png'. Modero G4 Touch Panels - Configuration and Programming...
  • Page 80: Bml

    Set the TakeNote network port for the specified Addresses. Syntax: "'^BNT-<vt addr range>,<network port>'" Variables: variable text address range = 1 - 4000. network port = 1 - 65535. Example: SEND_COMMAND Panel,"'^BNT-973,5000'" Sets the TakeNote button network port to 5000. Modero G4 Touch Panels - Configuration and Programming...
  • Page 81: Bop

    ^BOR Set a border to a specific border style associated with a border value for those buttons with a defined address range.Sets the border by name (AMX Elite) to those buttons with the variable text range of 500-504 & 510-515.
  • Page 82: Brd

    2 = On state). sound name = (blank - sound cleared, not matched - button sound not changed). Example: SEND_COMMAND Panel,"'^BSO-500,1&2,music.wav'" Assigns the sound 'music.wav' to the button Off/On states. Modero G4 Touch Panels - Configuration and Programming...
  • Page 83: Bsp

    Set the computer control network port for the specified address. Syntax: "'^BVT-<vt addr range>,<network port>'" Variables: variable text address range = 1 - 4000. network port = 1 - 65535. Example: SEND_COMMAND Panel,"'^BVT-500,5000'" Sets the network port to 5000. Modero G4 Touch Panels - Configuration and Programming...
  • Page 84: Bww

    "'^ENA-<vt addr range>,<command value>'" Variables: variable text address range = 1 - 4000. command value = (0= disable, 1= enable) Example: SEND_COMMAND Panel,"'^ENA-500.504&510.515,0'" Disables button pushes on buttons with variable text range 500-504 & 510-515. Modero G4 Touch Panels - Configuration and Programming...
  • Page 85: Fon

    "'^GLH-<vt addr range>,<bargraph hi>'" Variables: variable text address range = 1 - 4000. bargraph limit range = 1 - 65535 (bargraph upper limit range). Example: SEND_COMMAND Panel,"'^GLH-500,1000'" Changes the bargraph upper limit to 1000. Modero G4 Touch Panels - Configuration and Programming...
  • Page 86: Gll

    = 1 - 4000. color value = Refer to the RGB Values for all 88 Basic Colors table on page 61. Example: SEND_COMMAND Panel,"'^GSC-500,12'" Changes the bargraph or joystick slider color to Yellow. Modero G4 Touch Panels - Configuration and Programming...
  • Page 87: Gsn

    = 1/10th of a second. offTime = 1/10th of a second. Example: SEND_COMMAND Panel,"'^IRM-10,5, 20, 10'" Sets the port 10 IR channel 5 on time to 1 second and off time to 2 seconds. Modero G4 Touch Panels - Configuration and Programming...
  • Page 88: Jsb

    = Value of 1 - 9 corresponds to the following locations: Zero can be used for an absolute position Example: SEND_COMMAND Panel,"'^JST-500.504&510.515,1&2,1'" Sets the text alignment to the upper left corner for those buttons with variable text ranges of 500-504 & 510-515. Modero G4 Touch Panels - Configuration and Programming...
  • Page 89: Mbt

    User or 3rd party program can connect to the panel using this port/ socket number and receive touch/release/move strings. By default, the panel disables touch notifications on startup. Example: SEND_COMMAND Panel, '^SKT-7425' (enables touch notifications on socket 7425) SEND_COMMAND Panel, '^SKT-0' (disables touch notification)" Modero G4 Touch Panels - Configuration and Programming...
  • Page 90: Tec

    2 = On state). new text = 1 - 50 ASCII characters. Example: SEND_COMMAND Panel,"'^TXT-500.504&510.515,1&2,Test Only'" Sets the On and Off state text for buttons with the variable text ranges of 500-504 & 510-515. Modero G4 Touch Panels - Configuration and Programming...
  • Page 91: Text Effects Names

    • Soft Drop Shadow 4 with outline • Soft Drop Shadow 5 with outline • Soft Drop Shadow 6 with outline • Soft Drop Shadow 7 with outline • Soft Drop Shadow 8 with outline Modero G4 Touch Panels - Configuration and Programming...
  • Page 92: Button Query Commands

    (string encode) button text length These fields are populated differently for each query command. The text length (String Encode) field is not used in any command. Modero G4 Touch Panels - Configuration and Programming...
  • Page 93: Bcb

    The result sent to the Master would be: ButtonGet Id = 529 Type = 1012 Flag VALUE1 = 1 VALUE2 = 9 VALUE3 = 0 TEXT = #FF8000FF TEXT LENGTH = 9 Modero G4 Touch Panels - Configuration and Programming...
  • Page 94: Bct

    The result sent to the Master would be: ButtonGet Id = 529 Type = 1002 Flag VALUE1 = 1 VALUE2 = 9 VALUE3 = 0 TEXT = Buggs.png TEXT LENGTH = 9 Modero G4 Touch Panels - Configuration and Programming...
  • Page 95: Bop

    The result sent to the Master would be: ButtonGet Id = 529 Type = 1014 Flag VALUE1 = 1 VALUE2 = 22 VALUE3 = 0 TEXT = Double Bevel Raised -L TEXT LENGTH = 22 Modero G4 Touch Panels - Configuration and Programming...
  • Page 96: Bww

    Gets the button 'OFF state' font type index information. The result sent to the Master would be: ButtonGet Id = 529 Type = 1007 Flag VALUE1 = 1 VALUE2 = 72 VALUE3 = 0 TEXT TEXT LENGTH = 0 Modero G4 Touch Panels - Configuration and Programming...
  • Page 97: Ico

    Gets the button 'OFF state' bitmap justification information. The result sent to the Master would be: ButtonGet Id = 529 Type = 1005 Flag VALUE1 = 1 VALUE2 = 5 VALUE3 = 0 TEXT TEXT LENGTH = 0 Modero G4 Touch Panels - Configuration and Programming...
  • Page 98: Jsi

    Gets the button 'OFF state' text justification information. The result sent to the Master would be: ButtonGet Id = 529 Type = 1004 Flag VALUE1 = 1 VALUE2 = 1 VALUE3 = 0 TEXT TEXT LENGTH = 0 Modero G4 Touch Panels - Configuration and Programming...
  • Page 99: Tec

    The result sent to the Master would be: ButtonGet Id = 529 Type = 1008 Flag VALUE1 = 1 VALUE2 = 18 VALUE3 = 0 TEXT = Hard Drop Shadow 3 TEXT LENGTH = 18 Modero G4 Touch Panels - Configuration and Programming...
  • Page 100: Panel Runtime Operations

    = 1 - 50 ASCII characters. prompt font = 1 - 50 ASCII characters. Example: SEND COMMAND Panel,"'@AKB-Texas;Enter State'" Pops up the Keyboard and initializes the text string 'Texas' with prompt text 'Enter State'. Modero G4 Touch Panels - Configuration and Programming...
  • Page 101: Akeyb

    Remove keyboard or keypad that was displayed using 'AKEYB', 'AKEYP', 'PKEYP', @AKB, @AKP, @PKP, @EKP, or @TKP commands. Syntax: "'@AKR'" Example: SEND COMMAND Panel,"'@AKR'" Removes the Keyboard/Keypad. BEEP Output a beep. Syntax: "'BEEP'" Example: SEND COMMAND Panel,"'BEEP'" Outputs a beep. Modero G4 Touch Panels - Configuration and Programming...
  • Page 102: Brit

    = 1 - 50 ASCII characters. prompt text = 1 - 50 ASCII characters. Example: SEND COMMAND Panel,"'@PKP-1234567;ENTER PASSWORD'" Pops up the Keypad and initializes the text string 'ENTER PASSWORD' in '*'. Modero G4 Touch Panels - Configuration and Programming...
  • Page 103: Setup

    Syntax: "'TPAGEON'" Example: SEND COMMAND Panel,"'TPAGEON'" Turns On page tracking. TPAGEOFF Turn Off page tracking. Syntax: "'TPAGEOFF'" Example: SEND COMMAND Panel,"'TPAGEOFF'" Turns Off page tracking. Modero G4 Touch Panels - Configuration and Programming...
  • Page 104: Panel Setup Commands

    "'^PWD-<password level>,<page flip password>'" Variables: password level = 1 - 4. page flip password = 1 - 50 ASCII characters. Example: SEND COMMAND Panel,"'^PWD-1,Main'" Sets the page flip password on Password Level 1 to 'Main'. Modero G4 Touch Panels - Configuration and Programming...
  • Page 105: Input Commands

    ($A2) Right Arrow ($8B) ($C0) CTRL key up ($8C) ($C1) ALT key up ($8D) ($C2) Shift key up ($8E) ($8F) Num Lock ($90) Caps Lock ($91) Insert ($92) Delete ($93) Home ($94) Modero G4 Touch Panels - Configuration and Programming...
  • Page 106: Dynamic Image Commands

    Force a refresh on 'Sport_Image' when the resource is visible onscreen and disable completion notifications. SEND_COMMAND Panel, '^RFR-Sports_Image,once' Force a refresh on 'Sport_Image' when the resource is visible onscreen and enable a one-time completion notification. Modero G4 Touch Panels - Configuration and Programming...
  • Page 107: Rfrp

    "'^RSR-<resource name>,<refresh rate>'" Variables: resource name = 1 - 50 ASCII characters. refresh rate = Measured in seconds. Example: SEND_COMMAND Panel,"'^RSR-Sports_Image,5'" Sets the refresh rate to 5 seconds for the given resource (’Sports_Image’). Modero G4 Touch Panels - Configuration and Programming...
  • Page 108: Raf, ^Rmf - Embedded Codes

    If the %C code is not sent as part of a ^RAF command, the notifications are set to off. If the %C code is not sent as part of a ^RMF command, the notifications are not changed from the current setting. Modero G4 Touch Panels - Configuration and Programming...
  • Page 109: Escape Sequences

    X resolution of current panel mode/file X Resolution of Current button Y resolution of current panel mode/file Y Resolution of Current button Current state Name of Button For instance, http://www.amx.com/img.asp?device=$DV would become http://www.amx.com/img.asp?device=10001. Modero G4 Touch Panels - Configuration and Programming...
  • Page 110: Intercom Commands

    SEND_COMMAND TP1, "^ICS-192.168.0.3,9000,9002,0" SEND_COMMAND TP2, "^ICS-192.168.0.4,9002,9000,1" Note: When integrating the intercom functionality between AMX devices and non-AMX devices, please note that the RX UDP port should be used by the non-AMX device to receive audio. ^ICE' This terminates an intercom call/connection.
  • Page 111: Icm-Miclevel

    Example: SEND_COMMAND TP1,"'^ICM-TALK'" ^IIC Intercom incoming call. Syntax: “’^IIC’ Notifies the panel (specifically the AMX BT Handset accessory) that an intercom call is coming in. This is to enable the accessory to ring. ^IOC Intercom outgoing call. Syntax: “’^IOC’ Notifies the panel that an intercom call is outgoing. This is to enable any headset accessories for the appropriate operation.
  • Page 112: Sip Commands

    = The identifying number of the connection. state = IDLE, HOLD, or CONNECTED extn = The local extension of this panel (see Example) Example: SEND_COMMAND Panel,"'^PHN-LINESTATE, 1, IDLE, 2, CONNECTED, SIP, <extn>'" Modero G4 Touch Panels - Configuration and Programming...
  • Page 113: Phn-Msgwaiting

    Indicates the panel is redialing the number. Syntax: "'^PHN-REDIAL, <number>'" Variable: number = The phone number to dial. Example: SEND_COMMAND Panel,"'^PHN-REDIAL, 2125551000’" ^PHN-TRANSFERRED Indicates a call has been transferred. Syntax: "'^PHN-TRANSFERRED'" Example: SEND_COMMAND Panel,"'^PHN-TRANSFERRED’" Modero G4 Touch Panels - Configuration and Programming...
  • Page 114: Sip Call Management Commands

    = The identifying number of the connection Example: SEND_COMMAND Panel,"'^PHN-HANGUP, 1'" ^PHN-HOLD Places the call on hold. Syntax: "’^PHN-HOLD, <connection id>’" Variable: connection id = The identifying number of the connection Example: SEND_COMMAND Panel,"'^PHN-HOLD, 1'" Modero G4 Touch Panels - Configuration and Programming...
  • Page 115: Sip Setup Commands

    = The realm used for authentication Example: SEND_COMMAND Panel,"’^PHN-SETUP-DOMAIN,asterisk’" ^PHN-SETUP-ENABLE Registers a new user. Once the configuration has been updated, the ENABLE command should be run to re-register the new user. Syntax: "’^PHN-SETUP-ENABLE’" Modero G4 Touch Panels - Configuration and Programming...
  • Page 116: Phn-Setup-Password

    IP = The IP address for the STUN server Example: SEND_COMMAND Panel,"’^PHN-SETUP-STUNADDR,192.168.223.111’" ^PHN-SETUP-USERNAME Sets the user name for authentication with the proxy server. Syntax: "’^PHN-SETUP-USERNAME,<username>’" Variable: username = The user name (usually the phone extension) Example: SEND_COMMAND Panel,"’^PHN-SETUP-USERNAME,6003’" Modero G4 Touch Panels - Configuration and Programming...
  • Page 117: Audio Commands

    2 = USB Headset 3 = Bluetooth Headset CUSTOM.TYPE = EVENTID = 1305 CUSTOM.ID = ADDRESS = 0 CUSTOM.FLAG = 0 CUSTOM.VALUE1 = 0 (unmuted)/1 (muted) CUSTOM.VALUE2 = 0 CUSTOM.VALUE3 = 0 CUSTOM.TEXT = blank Modero G4 Touch Panels - Configuration and Programming...
  • Page 118: Mut

    2 = USB Headset 3 = Bluetooth Headset The "Bluetooth Headset" option used in several of these commands only applies to Modero X/S Series G4 panels equipped with Bluetooth functionality (excluding all "No Comm" panels). Modero G4 Touch Panels - Configuration and Programming...
  • Page 119: Panel-To-Panel Video Communication

    Modero G4 panels, where the output from the camera can be remotely viewed from any other Modero X Series panel. The camera output from one panel can be sent to one or many Modero G4 panels. Videocom is not compatible with SIP video phones.
  • Page 120: Streaming Video, Mxa-Mp, And Mxa-Mpl Commands

    Sets ON state to play video on multicast address SEND_COMMAND 10001:2:0, ‘^SDM-10,1,cam://local’ ;# Sets OFF state to play camera SEND_COMMAND 10001:2:0, ‘^SDM-10,1,stop’ ;# Stop playing the current video SEND_COMMAND 10001:2:0, ‘^SDM-10,1,’ ;# Stop playing the current video Modero G4 Touch Panels - Configuration and Programming...
  • Page 121: Slt

    16 is a good practice. If the width and height are not multiples of 16, video could be cropped asymmetrically by the boundaries of the button. The MXA-MPL only supports 2-channel stereo audio over HDMI. Modero G4 Touch Panels - Configuration and Programming...
  • Page 122: Notes On Using The ^Sdm And ^Slt Commands

    EVENTID value for the custom event. The range of 32001 to 65535 has been reserved in the panel for user custom event numbers. A different value could be used but might collide with other AMX event numbers. Event configuration is not permanent and all event numbers revert to the default of 0 when the panel restarts.
  • Page 123: Sdr

    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. Syntax: "'^SHD-<vt addr range>,<name>,<optional time>'" Modero G4 Touch Panels - Configuration and Programming...
  • Page 124: Ssh

    (like ^SSH) will apply to each set. For more information on subpages and their use, please refer to the TPDesign4 online Help and the TPDesign4 Operation Reference Guide, available at www.amx.com. Modero G4 Touch Panels - Configuration and Programming...
  • Page 125: Led Commands

    CUSTOM.VALUE1 = 0 CUSTOM.VALUE2 = 0 CUSTOM.VALUE3 = 0 CUSTOM.TEXT = blank Note: AMX Bluetooth Handset Custom Events only apply to Modero X/S Series G4 panels equipped with Bluetooth functionality (excluding all "No Comm" panels). Dynamic Images Custom Events for Dynamic Images Resource Load Notification Received when a resource for which notification is enabled is loaded.
  • Page 126: Popups

    Flag = 0 Value1 = width of popup Value2 = height of popup Value3 = 1 if popup is attached to current page, 0 of not attached to current page Text = popup name Modero G4 Touch Panels - Configuration and Programming...
  • Page 127: Smart Cards

    CUSTOM.ID = ADDRESS = 0 CUSTOM.FLAG = Start(1), Stop(2), Error(8) CUSTOM.VALUE1 = Number of starts (or stops or errors) CUSTOM.VALUE2 = Address of button/stream CUSTOM.VALUE3 = Port of button/stream CUSTOM.TEXT = stream URL Modero G4 Touch Panels - Configuration and Programming...
  • Page 128: Nfc Commands

    0 = custom.text field contains the NFC UID (as a text string) 1 = custom.text contains NFC data (currently not supported) Note: Custom Events for NFC only apply to Modero X/S Series G4 panels equipped with NFC functionality (excluding all "No Comm" panels). Modero G4 Touch Panels - Configuration and Programming...
  • Page 129: Appendix A: Text Formatting

    Example Format Display $A out of $R 32 out of 100 $A of 0 - $R 32 of 0 - 100 $V of $L - $H 532 of 500 - 600 Modero G4 Touch Panels - Configuration and Programming...
  • Page 130: Text Area Input Masking

    Refer to the following SEND_COMMANDs for more detailed information: • ^BIM - Sets the input mask for the specified addresses. • ^BMF subcommand - sets the input mask of a text area Modero G4 Touch Panels - Configuration and Programming...
  • Page 131: Input Mask Ranges

    In the above example, if the overflow flag was set, the first example will place the "1" into the previous logical field and the second example will place "12" in the previous logical field. Modero G4 Touch Panels - Configuration and Programming...
  • Page 132: Input Mask Output Examples

    URL indicates that the protocol in use is http (HyperText Transport Protocol) and that the information resides on a host machine named www.amx.com. The image on that host machine is given an assignment (by the program) name of company-info-home.asp (Active Server Page).
  • Page 133 Y Resolution of current panel mode/file X Resolution of current button Y Resolution of current button Name of button Current state Address Code Address Port Channel Code Channel Port Level Code Level Port Modero G4 Touch Panels - Configuration and Programming...
  • Page 134 Appendix A: Text Formatting Modero G4 Touch Panels - Configuration and Programming...
  • Page 135: Appendix B: Video Streaming Troubleshooting

    H.264, 2mbps bit rate, 480p resolution, Baseline profile. If this does not work, try transcoding the stream into MPEG2 video, which is less susceptible to A/V drift. Third-party encoders and digital television devices have not been tested with Modero X Series touch panels, and are not supported by AMX. Modero G4 Touch Panels - Configuration and Programming...
  • Page 136 May require transcoding to H.264 baseline profile and reducing resolution/ frame rate/bit rate per recommendations above. Recommend transcoding source material to MPEG2 if Audio/Video sync issues still occur after following above guidelines. Modero G4 Touch Panels - Configuration and Programming...
  • Page 137 • High quality preset profile (6Mbps/ MPEG2 CBR D1 Resolution) • MP2/MP3 audio < 192Kbps @ 48KHz • UDP Transport protocol only (RTP not supported) • Multicast and/or unicast addresses • SAP disabled Modero G4 Touch Panels - Configuration and Programming...
  • Page 138 Ethernet switch to filter unintended multicast packets reaching the panel and consuming panel resources. We recommend maintaining aspect ratio of source and following usage guidelines regarding window/button placement. Modero G4 Touch Panels - Configuration and Programming...
  • Page 139 Appendix B: Video Streaming Troubleshooting Modero G4 Touch Panels - Configuration and Programming...
  • Page 140 - Schedules and registration for any AMX University course - Travel and hotel information - Your individual certification requirements and progress 3000 RESEARCH DRIVE, RICHARDSON, TX 75082 USA • 800.222.0193 • 469.624.8000 • 469-624-7153 fax • 800.932.6993 technical support • www.amx.com...

Table of Contents