Instruction Manual Modero G4 Configuration and Programming Modero X-Series G4 Touch Panels Modero S-Series G4 Touch Panels Touch Panels L a s t R e v is e d : 9 / 0 2 / 2 0 1 4
AMX Limited Warranty and Disclaimer This Limited Warranty and Disclaimer extends only to products purchased directly from AMX or an AMX Authorized Partner which include AMX Dealers, Distributors, VIP’s or other AMX authorized entity.
Table of Contents Table of Contents Modero G4 Configuration and Programming .....................................................1 Overview .................................................................................................................. 1 Settings Pages ....................................................................................................3 Overview ..................................................................................................................
Table of Contents Configuration.......................................................................................................... 24 Panel Configuration....................................................................................................... 24 Changing the Device Number................................................................................................... 25 Changing the Device Name ..........................................................................................
Table of Contents Gesture Custom Event .................................................................................................. 50 Enabling or Disabling the Gesture Custom Event ......................................................... 50 ^GCE...................................................................................................................................... 50 MXA-MP and MXA-MPL Programming .............................................................51 Overview ...............
Table of Contents ^BCT ...................................................................................................................................... ^BDO ..................................................................................................................................... ^BFB ...................................................................................................................................... ^BIM .....................................................................
Table of Contents ^TXT ...................................................................................................................................... 80 Text Effects Names ................................................................................................. 81 ^UNI....................................................................................................................................... 81 Button Query Commands ...............................................................
Table of Contents Embedded Codes ................................................................................................... 95 Dynamic Image Commands..................................................................................... 96 ^BBR ...................................................................................................................................... ^RAF .......................................................................................................................
Table of Contents SIP Call Management Commands................................................................................ 104 ^PHN-ANSWER.................................................................................................................... ^PHN-AUTOANSWER .......................................................................................................... ?PHN-AUTOANSWER...........................................................................................................
Table of Contents Custom Events ...................................................................................................... 115 Bluetooth Headsets..................................................................................................... 115 AMX Bluetooth Handset Custom Event ............................................................................... 115 Dynamic Images ..........................................................................................................
Modero G4 Configuration and Programming Modero G4 Configuration and Programming Overview 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.
Modero G4 Configuration and Programming 2 Modero G4 Touch Panels - Configuration and Programming
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. Accessing the Settings Page To access the Settings page, press and hold the Sleep button on the touch panel for 3 seconds.
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 to reveal those functions. The Settings pages use the subpage feature. Not all menu items on a Settings page are visible on screen at one time, and scrolling up and down to see them may be necessary.
Settings Pages Saving Changed Settings Changes to the Settings pages are made to the device’s Flash memory, and may not be saved immediately to the panel in the case of sudden power loss. To ensure that your changes are retained, always make sure to shut down the device from the main Settings page (page 5). In situations of sudden power loss, the panel may boot up at its next use with only previously saved settings, requiring resetting all of those settings to their new values.
Settings Pages Status The Status page (FIG. 7) displays basic touch panel information, such as currently available memory and the screen resolution dimensions. FIG. 7 Status page Status Page 6 Device Number: Displays the panel’s device number. Connection: Displays the panel’s connection type. Panel IP: Displays the panel’s IP address. Master IP: Displays the IP address for the panel’s Master. Version: Displays the current version of the panel firmware. Panel Type: Displays the panel model.
Settings Pages File Information The File Information page (FIG. 8) displays information on the TPDesign4 project file currently loaded on the panel. FIG. 8 File Information page 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.
Settings Pages Display The Display page (FIG. 9) controls the basic functions of the touch panel display, including the panel brightness. FIG. 9 Display page Display Page 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.
Settings Pages FIG. 11 Panel calibration 4. Follow the instructions, touching the crosshairs in order across the screen. 5. The page will read "Calibration Successful. Touch to continue." Touch anywhere on the screen to return to the Calibration page. If the screen is not touched at that point, the device will automatically return to the Calibration page within 10 seconds. In certain circumstances, you may wish to test the calibration of a panel without actually recalibrating it.
Settings Pages 2. From the Display page, select Calibration Test. 3. Follow the instructions, touching the crosshairs in order across the screen. In order to ensure a correct calibration upon starting, the touch panel display should not be touched while the panel is booting. Sounds The Sounds page (FIG. 14) allows adjustment of volume levels and panel sounds settings. FIG. 14 Sounds page Sounds Page Panel Volume: • Move the slidebar to the left or right to adjust the panel volume.
Settings Pages Sounds Page (Cont.) Button Miss: Press to enable the panel to play a default sound when you touch a non-active button or any area outside of the active button. Button Miss Sound: Displays the information on the sound file associated with the Button Miss function. Press repeatedly to scroll through the 10 included sounds. NFC Sound: Press to enable the panel to play a default sound when the panel detects an NFC tag.
Settings Pages Date & Time The Date & Time page (FIG. 16) allows setting and adjusting of time and date information on the touch panel. If the time and/or date on the Master is modified, all connected devices will be updated to reflect the new information. FIG. 16 Date & Time page Date & Time Page Year: Use the Up/Down arrows to set the current year. Month: Use the Up/Down arrows to set the current month. Day: Use the Up/Down arrows to set the current day.
Settings Pages Connection & Networks The Connections & Networks page (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 NFC functionality. FIG. 17 Connection & Networks page Connection & Networks Page Master Connection: Opens the Master Connection page (page 13).
Settings Pages Master Connection Page Scan For Masters Mode: Click this button to open the Master Scan page (page 14). Cycles between the connection modes: URL, Listen, and Auto. • URL - In this mode, enter the IP/URL, Master Port Number, and username/password (if used) on the Master. The System Number field is read-only - the panel obtains this information from the Master. • Listen - In this mode, add the panel address into the URL List in NetLinx Studio and set the connection mode to Listen.
Settings Pages Changing the Master IP/URL To change the IP address or URL for the chosen Master: 1. From the Master Connection page, press the Master IP/URL field to open the Master IP Address keyboard (FIG. 20). FIG. 20 Master IP Address keyboard 2. Enter the IP address or the URL in the keyboard field and press OK. 3. The new IP address/URL is now displayed in the Master IP/URL field. 4. When finished, press Back to return to the Settings page.
Settings Pages FIG. 22 Master User keyboard 2. Enter the new username in the keyboard field and press OK. 3. When finished, press Back to return to the Settings page. To change the password: 1. From the Master Connection page, press the Password field to open the Master Password keyboard (FIG. 23). FIG. 23 Master Password keyboard 2. Enter the new password in the keyboard field and press OK. 3. When finished, press Back to return to the Settings page. Network Connection The Network Connection page (FIG.
Settings Pages Network Connection Page DHCP/Static: Sets the panel to either DHCP or Static communication modes. • DHCP is an IP Address assigned to the panel by a DHCP server. If DHCP is selected, the other Network Connection fields are disabled (see below). • Static IP is a permanent IP Address assigned to the panel. If Static IP is selected, the other Network Connection fields are enabled. IP Address: Displays the IP address for this panel. If DHCP is enabled, this field will be disabled.
Settings Pages FIG. 26 Host Name keyboard 3. Enter the new hostname and press OK. 4. The new hostname will now appear in the Hostname field. 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. FIG. 27 Bluetooth page Bluetooth Page Bluetooth: Click this button to enable or disable Bluetooth device access to the touch panel. Set up new device...
Settings Pages Bluetooth Device Search The Bluetooth Device Search page (FIG. 28) allows you to search for new Bluetooth devices, or ones already paired to the panel, and allow them to connect to the panel. Scanning Icon FIG. 28 Bluetooth Device Search page Bluetooth Device Search Page Device Name: This is the device name of the Bluetooth device currently on the network. Device Address: This is the device address of the Bluetooth device currently on the network.
Settings Pages Bluetooth device selected for pairing Press to connect selected device FIG. 29 Selecting a Bluetooth device 5. In the Enter Pincode keypad (FIG. 30), enter the device’s pincode. FIG. 30 Enter Pincode keypad The default pincode is 0000. You must enter the pincode within 30 seconds. 6. If a pincode needs to be entered from the device, a System Message popup window appears, requesting that this be done (FIG. 31). FIG. 31 System Message: Please enter the pincode 7.
Settings Pages FIG. 32 System Message: Pairing in progress... 8. When the pairing is finished, the new device appears on the main Bluetooth page (FIG. 33). FIG. 33 Detected Bluetooth devices on the Bluetooth page NFC The NFC page (FIG. 34) controls the touch panel’s Near Field Communications™ (NFC) access, as well as displaying the last 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.
Settings Pages Smart Card The Smart Card page controls the touch panel’s ability to receive and process information from Common Access 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.
Settings Pages Breakout Box Use the Breakout Box page to configure the touch panel to receive signals from a MXA-MP Multi Preview or MXAMPL Multi Preview Live devices for video stream display. If a Breakout Box is not connected to the panel’s network, all fields but the Breakout Box button will be empty. For more information on operation and configuration of an MXA-MP or MXA-MPL, refer to the MXA-MP/MPL Operation Reference Guide, available at www.amx.com. FIG.
Settings Pages Configuration The Configuration page (FIG. 37) allows confirmation of and changes to panel configuration information. FIG. 37 Configuration page Configuration Page Panel: Select this to open the Panel Configuration page (page 24). Admin: Select this to open the Admin Configuration page (page 30). SIP: Select this to open the SIP page (page 36). Advanced: Select this to open the Advanced Config page (page 38).
Settings Pages Panel Configuration Page Device Number: Press to open a keypad used to view or change the device number of the panel. Device Name: Press to open a keyboard used to view or change the device name used for the panel. Power Management: Press to open the Power Management page (page 26). G4 Webcontrol: Press to open the G4 Web Control page (page 26). Sensors: Press to open the Sensor Settings page (page 27).
Settings Pages FIG. 40 Device Name keyboard 2. Enter the new device name and press OK. Power Management The options on the Power Management page (FIG. 41) allow setting of display timeout and shutdown preferences. FIG. 41 Power Management page Power Management Page Display Timeout: This value determines the number of seconds, minutes, or hours that need to pass before the panel automatically goes into Sleep Mode.
Settings Pages G4 WebControl Page G4 WebControl: The G4 Web Control button toggles between the two G4 activation settings: • Off - deactivates G4 Web Control on the panel. • On - activates G4 Web Control on the panel. Timeout: Sets the length of time (in minutes) that the panel can remain idle, detecting no cursor movements, before the G4 Web Control session is terminated.
Settings Pages Sensor Settings Page Motion Detection: • The yellow indicator shows the current motion sensor reading. • The movable circle sets the motion sensor threshold.The threshold controls when a motion sensor channel is on. • The “walk” icon with also change color from grey to green when the threshold is crossed. Wake Panel on Motion Sense: Click this button to wake up the panel if any motion detected crosses the threshold set by the Motion Detection slider.
Settings Pages FIG. 44 Function Show Synchronizing Device Names For ease of connectivity, it may be desirable or necessary to make sure that all of the names registered with the panel are the same. Enabling the Synchronize Device Names button synchronizes these names, tracking any changes to the current Device Name setting. If this button is disabled, Hostname and G4 Web Control names may be changed individually. The Synchronize Device Names button is disabled by default.
Settings Pages Admin Configuration The Admin Configuration page (FIG. 46) allows control of access to the Settings pages, passwords, security settings, and the ability to install firmware or touch panel pages from various sources. FIG. 46 Admin Configuration page Admin Configuration Page Configuration Protected: Press this button to protect the Settings pages from access without a password.
Settings Pages Admin Passwords Page Password 1-4 Accesses the alphanumeric password. Select PASSWORD 1, 2, 3, or 4 to open a keyboard to enter alphanumeric values associated with the selected password. Password 5 (protected): Accesses the alphanumeric values associated to particular password sets. Select PASSWORD 5 (protected) to open a keyboard to enter alphanumeric values associated with the selected password.
Settings Pages Security The Security page (FIG. 50) allows you to select between the three security options available on the panel: Standard, Secure, and DoD. FIG. 50 Security page Security Page Standard: Click this button to set security to Standard (see below). Secure: Click this button to set security to Secure (see below). DoD: Click this button to set security to DoD (see below). Cancel: Click this button to return to the Admin Configuration page without saving any changes made to this page.
Settings Pages A transition to Secure or DoD mode will disable G4 Web Control. Although the security password features are immediate, a reboot must occur for all the new security mode features to take full effect. Changing the security setting will also change the G4 Web Control password. This must be reset from the G4 WebControl on page 26 before you can access the panel via VNC. Install Firmware The Install Firmware page (FIG.
Settings Pages Press these three dots to reset the panel to its original factory firmware FIG. 53 Modero X Series splash page 2. The new confirmation page informs you that a panel reset to its original factory firmware may result in a loss of data (FIG. 54). Click Yes to confirm that you wish to continue the resetting process and click No to return to the splash page. FIG. 54 Factory Reset confirmation page 3. The touch panel will now reset to its original factory firmware and restart.
Settings Pages Installing New Firmware From an External USB Stick For more information on updating firmware for your touch panel, particularly concerning the format and the directory placement of the firmware upgrade, please refer to the Upgrading Firmware section of the touch panel’s Operation Reference Guide (available at www.amx.com). Installing New Firmware From an External Disk Via the Settings Pages 1. Download the latest Modero X/S Series G4 touch panel firmware from www.amx.
Settings Pages FIG. 58 Upgrade In Progress screen 4. Once the upgrade is complete, the touch panel will automatically reboot with the new firmware. 5. 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. At this point, do not touch the screen, and the reboot will continue. SIP The options on the SIP page (FIG.
Settings Pages SIP Page (Cont.) STUN Server: This option enables you to enter the IP address or DNS name of the Simple Traversal of UDP through NATs (STUN) server. This field is optional. Cancel: Press the Cancel button to return to the Configuration page without saving any changes made on the SIP page. Save: Touch the Save button to save the changes and return to the Configuration page. Changing the SIP Proxy Address To change the SIP proxy address: 1.
Settings Pages FIG. 62 SIP STUN Address Keyboard 2. Enter the STUN server address and click OK. 3. Click Save to save your changes to the SIP page and return to the Configuration page. Advanced Config The Advanced Config page (FIG. 63) displays options for more advanced configuration options, such as running diagnostics or modifying the options for streaming video. FIG.
Settings Pages If Flash caching is enabled, dynamic images that would have been discarded will actually be moved to Flash, since retrieving images on Flash is typically faster than across a network, although it is slower than using a RAM cache. Note that since static images are already stored on Flash, they are never moved to the Flash cache, so Flash caching applies only to dynamic images. Images in Flash cache are moved back to RAM cache the next time they are viewed.
Settings Pages Logs The Logs page (FIG. 66) chronicles all previous connections between the device and the network. FIG. 66 Logs page Logs Page Clear: Clears all connection logs. Refresh: Refreshes displayed log information. Page: Displays the current log page number. Use the Up/Down arrows to select log pages. Network Statistics The Network Statistics page (FIG. 67) displays received and transmitted IP packets.
Settings Pages ICSP Statistics The ICSP Statistics page (FIG. 68) collects the number of ICSP messages received by the touch panel. FIG. 68 ICSP Statistics page ICSP Statistics Page ICSP: • Received: Lists the number of ICSP messages received since the last time the page was cleared or refreshed, or within the last 15 minutes. • Processed: Lists the number of ICSP messages processed since the last time the page was cleared or refreshed, or within the last 15 minutes.
Settings Pages Connection Utility Page (Cont.) Responses Received: Lists the number of responses received from the Master. Responses Missed: Lists the number of responses missed by the Master. Streaming Video This page is not available on Modero X/S Series G4 panels without a camera (including portrait wall panels and all "No Comm" panels). The Streaming Video page (FIG. 70) is used to preview video sources, as well as the touch panel’s camera. FIG.
Settings Pages Entering a Streaming Video URL 1. From the Streaming Video page, select Enter URL to open the Set URL keyboard (FIG. 71). FIG. 71 Set URL keyboard 2. Enter the URL for the camera and click OK. To preview the touch panel’s camera feed, enter "cam://local". 3. The camera feed will now appear in the Streaming Video page window.
Settings Pages Both the camera and audio can be routed through the panel's MicroUSB port to a host PC. The microphone and camera will appear as 2 separate USB devices on the host. If you preview the camera via the touch panel, the camera’s input will no longer be routed to the host 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.
Transitions and Gestures Transitions and Gestures 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 first be defined in the NetLinx programming language with values for the Device: Port: System (in all programming examples - Panel is used in place of these values and represents all Modero panels).
Transitions and Gestures Transition Classes (Cont.) Transition 46 Transition Description Origins Default Center door with fade This transition operates as above, except that the hinge point is at the center of the LCD rather than the edge. Top Left Right Bottom Right Zoom In The new page appears from the center of the panel and expands outward. Center Center Zoom Out The new page appears from the outside edges of the panel and contracts inward to the center.
Transitions and Gestures The origin of the transition is the point on the LCD where the motion originates. In most cases, these locations are the top, bottom, left and right of the screen. For example, a slide transition with a left origin will appear to slide in from the left towards the right of the screen. Some transitions may have an origin at the upper or lower corner on any given side, such as the upper right or the lower left.
Transitions and Gestures 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-,,,
Transitions and Gestures Touch Gesture Recognition Gesturing refers to the act of moving a finger or stylus across the overlay and having the panel recognize and process this motion as a gesture. Once a gesture is detected, it is processed as another external button on the panel. This enables the user to design pages that translate gesture operations into any functionality available to external buttons.
Transitions and Gestures Gesture Prioritization (Cont.) The user double taps on a button or slider. This will not be recognized as a gesture. This would be considered two quick press/release operations on the button or slider. The user double taps outside of a button or slider. This will be registered as a gesture.
MXA-MP and MXA-MPL Programming MXA-MP and MXA-MPL Programming Overview The MXA-MP Modero X Series Multi Preview and MXA-MPL Multi Preview Live are touch panel accessories that display still images or an HD digital video stream on Modero X Series touch panels. The MXA-MP accepts analog or digital video inputs and converts them into up to 10 regularly refreshed JPEG preview images. The MXA-MPL accepts analog or digital video inputs over HDMI and converts them to a video stream.
MXA-MP and MXA-MPL Programming 4. When finished, click OK and then Close to close the Resource Manager. FIG. 74 Edit Dynamic Image window 5. After adding the Dynamic Image, assign the image as a Bitmap to a button on a touch panel page. Adding a Live Motion Stream To A Touch Panel Page via an MXA-MPL To add a live motion stream to a touch panel page via an MXA-MPL: 1. In the touch panel page, draw a button to be the video window. 2. In Button Properties, select MXA-MPL as the video fill (FIG. 75). FIG.
MXA-MP and MXA-MPL Programming FIG. 76 Command Output Loopback Port If you wish to embed commands in a button, these are done through the Command Output Loopback Port. This may be found in the Button Properties window, under the Programming tab. Click the "..." button to open the Button Command Output window (FIG. 77). FIG.
MXA-MP and MXA-MPL Programming Supported Resolution/Signal Type Commands HDMI: SEND_COMMAND 10001:1:0,"'^SLT-1,videomode=hdmi,640x480p@30'" SEND_COMMAND 10001:1:0,"'^SLT-1,videomode=hdmi,800x600p@30'" ** SEND_COMMAND 10001:1:0,"'^SLT-1,videomode=hdmi,1024x768p@30'" SEND_COMMAND 10001:1:0,"'^SLT-1,videomode=hdmi,1280x720p@30'" DVI: SEND_COMMAND 10001:1:0,"'^SLT-1,videomode=dvi,640x480p@30'" SEND_COMMAND 10001:1:0,"'^SLT-1,videomode=dvi,800x600p@30'" ** SEND_COMMAND 10001:1:0,"'^SLT-1,videomode=dvi,1024x7
Programming Programming 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 first be defined in the NetLinx programming language with values for the Device: Port: System. In all programming examples - Panel is used in place of these values and represents all Modero panels).
Programming Page Commands (Cont.) @PDR Set the popup location reset flag. If the flag is set, the popup will return to its default location on show instead of its last drag location. Syntax: "'@PDR-;'" Variables: popup page name = 1 - 50 ASCII characters. Name of the page the popup is displayed On. reset flag = 1 = Enable reset flag, 0 = Disable reset flag Example: SEND_COMMAND Panel,"'@PDR-Popup1;1'" Popup1 will return to its default location when turned On.
Programming Page Commands (Cont.) @PPF Deactivate a specific popup page on either a specified page or the current page. If the page name is empty, the current page is used (see example 2). If the popup page is part of a group, the whole group is deactivated. This command works in the same way as the ’Hide Popup’ command in TPDesign4. Syntax: "'@PPF-;'" Variables: popup page name = 1 - 50 ASCII characters. Name of the popup page. page name = 1 - 50 ASCII characters.
Programming Page Commands (Cont.) @PPN 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’ command in TPDesign4. Syntax: "'@PPN-;'" Variables: popup page name = 1 - 50 ASCII characters. Name of the popup page. page name = 1 - 50 ASCII characters.
Programming Page Commands (Cont.) @PST Set the show effect time for the specified popup page. Syntax: "'@PST-;'" Variables: popup page name = 1 - 50 ASCII characters. Name of the page the popup is displayed On. show effect time = Given in 1/10ths of a second. Example: SEND_COMMAND Panel,"'@PST-Popup1;50'" Sets the Popup1 show effect time to 5 seconds. PAGE Flips to a page with a specified page name. If the page is currently active, it will not redraw the page.
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’ command in TPDesign4. Syntax: "'PPON-;'" Variables: popup page name = 1 - 50 ASCII characters. Name of the popup page. page name = 1 - 50 ASCII characters.
Programming Programming Numbers RGB Triplets and Names For Basic 88 Colors RGB Values for all 88 Basic Colors Index # 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 Name Very Light Red Light Red Red Medium Red Dark Red Very Dark Red Very Light Orange Light Orange Orange Medium Orange Dark Orange Very Dark Orange Very Light Yellow Light Yellow Yellow Medium Yellow Dark Yellow Very Dark Yellow Very Light Lime Li
Programming Fonts must be imported into a TPDesign4 project file. The font ID numbers are assigned by TPDesign4. These values are also listed in the Generate Programmer’s Report. Border Styles and Programming Numbers Border styles can be used to program borders on buttons, sliders, and popup pages. Border Styles and Programming Numbers No. Border styles No.
Programming “^” Button Commands All commands that begin with “^” have the capability of assigning a variable text address range and button state range. A device must first be defined in the NetLinx programming language with values for the Device: Port: System (in all programming examples - Panel is used in place of these values). Variable text ranges allow you to target 1 or more variable text channels in a single command.
Programming "^" Button Commands (Cont.) ^BAT Append non-unicode text. Syntax: "'^BAT-,
Programming "^" Button Commands (Cont.) ^BCF Set the fill color to the specified color. This applies only if the specified fill color is not the same as the current color. Note: Color can be assigned by color name (without spaces), number or R,G,B value (RRGGBB or RRGGBBAA). Syntax: "'^BCF-,
Programming "^" Button Commands (Cont.) ^BFB Set the feedback type of the button. ONLY works on General-type buttons. Syntax: "'^BFB-,'" Variables: variable text address range = 1 - 4000. feedback type = (None, Channel, Invert, On (Always on), Momentary, and Blink). Example: SEND_COMMAND Panel,"'^BFB-500,Momentary'" Sets the Feedback type of the button to 'Momentary'. ^BIM Set the input mask for the specified address.
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 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.
Programming "^" Button Commands (Cont.) ^BMF Set any/all button parameters by sending embedded codes and data. Syntax: "'^BMF-,
Programming "^" Button Commands (Cont.) ^BMF (Cont.) ’%LN<0-240>’ = Set the lines of video being removed. ^BLN section on page 66 for more information. ’%MI’ = Set the mask image. Refer to the ^BMI command on page 69 for more information. Note: This parameter should be always used in its own BMF command, and should not be combined with other BMF subcommands. ’%MK’ = Set the input mask of a text area.
Programming "^" Button Commands (Cont.) ^BML Set the maximum length of the text area button. If this value is set to zero (0), the text area has no max length. The maximum length available is 2000. This is only for a Text area input button and not for a Text area input masking button. Syntax: "'^BML-,'" Variables: variable text address range = 1 - 4000. max length = 2000 (0=no max length).
Programming "^" Button Commands (Cont.) ^BOP Set the button opacity. The button opacity can be specified as a decimal between 0 - 255, where zero (0) is invisible and 255 is opaque, or as a HEX code, as used in the color commands by preceding the HEX code with the # sign. In this case, #00 becomes invisible and #FF becomes opaque. If the opacity is set to zero (0), this does not make the button inactive, only invisible.
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 theTPDesign Border Styles by Name table on page 62. Syntax: "'^BRD-,
Programming "^" Button Commands (Cont.) ^BSP Set the button size and its position on the page. Syntax: "'^BSP-,,,,'" Variables: variable text address range = 1 - 4000.
Programming "^" Button Commands (Cont.) ^BWW Set the button word wrap feature to those buttons with a defined address range. By default, wordwrap is Off. Syntax: "'^BWW-,
Programming "^" Button Commands (Cont.) ^FON Set a font to a specific Font ID value for those buttons with a defined address range. Font ID numbers are generated by the TPDesign4 programmers report. Syntax: "'^FON-,
Programming "^" Button Commands (Cont.) ^GLL Change the bargraph lower limit. Syntax: "'^GLL-,'" Variables: variable text address range = 1 - 4000. bargraph limit range = 1 - 65535 (bargraph lower limit range). Example: SEND_COMMAND Panel,"'^GLL-500,150'" Changes the bargraph lower limit to 150. ^GRD Change the bargraph ramp-down time in 1/10th of a second. Syntax: "'^GRD-,'" Variables: variable text address range = 1 - 4000.
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-,'" Variables: variable text address range = 1 - 4000. bargraph slider name = See table below.
Programming "^" Button Commands (Cont.) ^JSB Set bitmap/picture alignment using a numeric keypad layout for those buttons with a defined address range. The alignment of 0 is followed by ',,'. The left and top coordinates are relative to the upper left corner of the button. Syntax: "'^JSB-,
Programming "^" Button Commands (Cont.) ^MBT Set the Mouse Button mode On for the virtual PC. Syntax: "'^MBT-'" Variable: pass data: 0 = None 1 = Left 2 = Right 3 = Middle Example: SEND COMMAND Panel,"'^MBT-1'" Sets the mouse button mode to ’Left Mouse Click’. ^MDC Turn On the ’Mouse double-click’ feature for the virtual PC. Syntax: "'^MDC'" Example: SEND COMMAND Panel,"'^MDC'" Sets the mouse double-click for use with the virtual PC. ^PIC Start/stop Picture View.
Programming "^" Button Commands (Cont.) ^TEC Set the text effect color for the specified addresses/states to the specified color. The Text Effect is specified by name and can be found in TPD4. You can also assign the color by name or RGB value (RRGGBB or RRGGBBAA). Syntax: "'^TEC-,
Programming "^" Button Commands (Cont.) ^UNI Set Unicode text. For the ^UNI command (%UN and ^BMF command), the Unicode text is sent as ASCII-HEX nibbles. Syntax: "'^UNI-,
Programming Button Query Commands Button Query commands reply back with a custom event. There will be one custom event for each button/state combination. Each query is assigned a unique custom event type.
Programming Button Query Commands ?BCB Get the current border color. Syntax: "'?BCB-,
Programming Button Query Commands (Cont.) ?BCT Get the current text color. Syntax: "'?BCT-,
Programming Button Query Commands (Cont.) ?BOP Get the overall button opacity. Syntax: "'?BOP-,
Programming Button Query Commands (Cont.) ?BWW Get the current word wrap flag status. Syntax: "'?BWW-,
Programming Button Query Commands (Cont.) ?ICO Get the current icon index. Syntax: "'?ICO-,
Programming Button Query Commands (Cont.) ?JSI Get the current icon justification. Syntax: "'?JSI-,
Programming Button Query Commands (Cont.) ?TEC Get the current text effect color. Syntax: "'?TEC-,
Programming Button Query Commands (Cont.) ?TXT Get the current text information. Syntax: "'?TXT-,
Programming Panel Runtime Operation Commands (Cont.) AKEYB Pop up the keyboard icon and initialize the text string to that specified. Keyboard string is set to null on power up and is stored until power is lost. Syntax: "'AKEYB-'" Variables: initial text = 1 - 50 ASCII characters. Example: SEND COMMAND Panel,"'AKEYB-This is a Test'" Pops up the Keyboard and initializes the text string 'This is a Test'. AKEYP Pop up the keypad icon and initialize the text string to that specified.
Programming Panel Runtime Operation Commands (Cont.) BRIT Set the panel brightness. Syntax: "'BRIT-'" Variable: brightness level = 0 - 100. Example: SEND COMMAND Panel,"'BRIT-50'" Sets the brightness level to 50. @BRT Set the panel brightness. Syntax: "'@BRT-'" Variable: brightness level = 0 - 100. Example: SEND COMMAND Panel,"'@BRT-70'" Sets the brightness level to 70. DBEEP Output a double beep.
Programming Panel Runtime Operation 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'" Shuts-down the batteries feeding power to the panel. This function saves the battery from discharging. SLEEP Force the panel into screen saver mode.
Programming Panel Runtime Operation Commands (Cont.) @VKB Popup the virtual keyboard. Syntax: "'@VKB'" Example: SEND COMMAND Panel,"'@VKB'" Pops-up the virtual keyboard. WAKE Force the panel out of screen saver mode. Syntax: "'WAKE'" Example: SEND COMMAND Panel,"'WAKE'" Forces the panel out of the screen saver mode. Panel Setup Commands These commands are case-insensitive. Panel Setup Commands @PWD Set the page flip password. @PWD sets the level 1 password only.
Programming Input Commands These Send Commands are case-insensitive. Input Commands ^KPS Set the keyboard passthru. Syntax: "'^KPS-'" Variables: pass data: = Disables the keyboard. 0 = Pass data to G4 application (default). This can be used with VPC or text areas. 1 - 4 = Not used. 5 = Sends out data to the Master. Examples: SEND COMMAND Panel,"'^KPS-5'" Sets the keyboard passthru to the Master.
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-,
Programming Dynamic Image Commands (Cont.) ^RFRP Force a refresh of the given resource, pre-fetching the resource. The command will "prefetch" the resource even if it is not currently visible. Syntax: "'^RFRP-, '" This command has new optional notification option at the end of the command with the following possible values: • on - notifications are sent whenever the named dynamic image resource is loaded/refreshed. • off - notifications are not sent (default).
Programming ^RAF, ^RMF - Embedded Codes The ^RAF and ^RMF commands add and modify any and all resource parameters by sending embedded codes and data: "'^RAF-,'" "'^RMF-,'" The variable uses the embedded codes described in the following table: ^RAF, ^RMF - Embedded Codes Parameter Embedded Code Description protocol ’%P <0-1>’ Set protocol: either HTTP (0) or FTP (1) user ’%U ’ Set Username for authentication password ’%S ’ Set Pass
Programming Escape Sequences The ^RAF and ^RMF commands support the replacement of any special escape sequences in the filename (specified by the %F embedded code) with the corresponding data obtained from the system as outlined in the table below: Escape Sequences Sequence Panel Information Sequence Panel Information $DV Device Number $AC Address code $SY System Number $AP Address port $IP IP Address $CC Channel code $HN Host Name $CP Channel port $MC Mac Address $LC Level code $ID
Programming Intercom Commands Intercom commands only apply to Modero X/S Series G4 panels equipped with a microphone (excluding all "No Comm" panels). 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. Syntax: SEND_COMMAND ,"'^MODEL?'" Variables: None.
Programming Intercom Commands (Cont.) ^ICM-MICLEVEL Sets the microphone level during an intercom call (0 to 100). Syntax: "^ICM-MICLEVEL" Variables: Level = 0-100 Example: SEND_COMMAND TP1, "^ICM-MICLEVEL,40" Sets the microphone level to 40. ^ICM-MUTEMIC Sets the state of the microphone on a panel to muted (1) or unmuted (0). At the start of each call, the microphone starts out unmuted.
Programming SIP Commands The following table lists and describes SIP commands that are generated from the touch panel. SIP commands only apply to Modero X/S Series G4 panels equipped with SIP functionality (excluding all "No Comm" panels). SIP Commands ^PHN-AUTOANSWER Provides the state of the auto-answer feature. Syntax: "'^PHN-AUTOANSWER, '" Variable: state = 0 or 1 (off or on) Example: SEND_COMMAND Panel,"'^PHN-AUTOANSWER, 1'" ^PHN-CALL Provides call progress notification for a call.
Programming SIP Commands (Cont.) ^PHN-MSGWAITING Indicates the number of messages waiting the user’s voice mail box. Syntax: "'^PHN-MSGWAITING, , , , , '" Variables: messages = 0 or 1 (1 indicates new messages) new message count = The number of new messages. old message count = The number of old messages. new urgent message count = The number of new messages marked urgent.
Programming SIP Call Management Commands The following table lists and describes SIP commands that are sent to the touch panel to manage calls. SIP commands only apply to Modero X/S Series G4 panels equipped with SIP functionality (excluding all "No Comm" panels). . SIP Call Management Commands ^PHN-ANSWER Answers the call.
Programming SIP Call Management Commands (Cont.) ?PHN-LINESTATE Queries the state of each of the connections used by the SIP device. The panel responds with the ^PHN-LINESTATE message. Syntax: "’?PHN-LINESTATE’" Example: SEND_COMMAND Panel,"'?PHN-LINESTATE'" ^PHN-PRIVACY Enables or disables the privacy feature on the phone (do not disturb). Syntax: "’^PHN-PRIVACY, ’" Variable: state = 0 (Disable) or 1 (Enable) Example: SEND_COMMAND Panel,"'^PHN-PRIVACY, 1'" Enables the privacy feature.
Programming SIP Setup Commands (Cont.) ^PHN-SETUP-PASSWORD Sets the user password for the proxy server. Syntax: "’^PHN-SETUP-PASSWORD,’" Variable: password = The password for the user name Example: SEND_COMMAND Panel,"’^PHN-SETUP-PASSWORD,6003’" ^PHN-SETUP-PORT Sets the port number for the proxy server.
Programming Audio Commands The following is a list of commands that control audio resources. 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): Audio Commands ^ADS Selects the audio device to use. Syntax: "'^ADS-'" Variables: Device: 1 = Built-in Speaker 2 = USB Headset 3 = Bluetooth Headset ?ADS Queries the currently selected audio device (returned in custom event).
Programming Audio Commands (Cont.) ^MUT Sets the panel mute 0 or 1. Syntax: "'^MUT-,[device]'" Variables: Status: 0 = unmuted, 1 = muted Device: 0 = Active device (mutes device if none specified) 1 = Built-in Speaker 2 = USB Headset 3 = Bluetooth Headset ?VOL Queries the panel volume (returned in custom event).
Programming Panel-to-Panel Video Communication All camera-enabled Modero G4 panels are AMX Videocom-enabled. Videocom is a new feature that is only supported on 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.
Programming Panel-to-Panel Video Communication Commands (Cont.) ^VCS Starts Videocom communication. Syntax: "'^VCS-,'" Videocom (Panel to Panel Video Chat) Start Start sending h264/rtp data to dstIp:port. 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 X/S Series G4 touch panel from an MXA-MP Multi Preview or MXA-MPL Multi Preview Live video breakout box.
Programming Streaming Video, MXA-MP/MPL Commands (Cont.) ^SLT MXA-MP and MXA-MPL Command Set. Syntax: "'^SLT-,'" Examples: ^SLT-1,reboot= Variables: Device = 1 (Device is always 1 for the MXA-MP and MXA-MPL, the only device type currently supported by Modero X Series panels) Subcommands: Reboot the MXA-MP/L. If "current" is used, or if no parameter is given, it is a simple reboot.
Programming Notes on Using the ^SDM and ^SLT Commands Based on the user’s pages, the touch panel receiving video from an MXA-MPL will initiate that video feed as necessary, based on the button receiving the video. However, if you are changing video resolution or mode, using the ^SDM or ^SLT commands may be necessary to start and stop the video. To do so: 1. Use the ^SDM command first, with an empty URL value to stop the video. 2. If this does not work, use ^SDM with the URL value of "169.254.11.12:5700".
Programming Subpages Commands (Cont.) ^SCE (Cont.) The events are: Anchor - a new subpage has docked in the anchor position Onscreen - a docking operation has been completed and the subpages in the list are now onscreen. This list will include the anchor along with any subpages that may be partially onscreen. Offscreen - a docking operation has been completed and the subpages in the list are now offscreen.
Programming Subpages Commands (Cont.) ^SSH Subpage show command. This command will perform one of three different operations based on the following conditions: 1. If the named subpage is hidden in the set associated with the viewer button it will be shown in the anchor position. 2. If the named subpage is not present in the set it will be added to the set and shown in the anchor position. 3.
Programming LED Commands For Modero X/S Series G4 touch panels with LED displays, the following command controls the LED behavior and output: LED Commands ^WLD Controls the LED behavior. Syntax: ^WLD-, Variables: indicates the channel code or ID number (0-RED, 2-GREEN) indicates the expected behavior of the LED: 0-LED OFF - Turns LED Off 1-LED ON - Turns LED On Note: Setting a particular LED color is not mutually exclusive.
Programming Popups Custom Events for Popups ^PUN Notifies when a popup custom event has been sent to the Master. When a popup is attached, detached, or moved on a page, a custom event is sent to the master from port 1 of the device to indicate the popup's location. On a move, the custom event is sent when the move is complete but not when the moves starts or is in progress. Notifications happen via a custom event (1323) sent to the master. The same event type (132) is used for ?PUL responses.
Programming Smart Cards Custom Events for Smart Cards Smart Card Insert/Remove This event indicates when a smart card was removed or inserted. Custom.Text can be a large string, so it will be sent in 1024 chunks. Value1 and Value2 indicate chunk count and total number of chunks. "Custom.Type = 710 "Custom.ID = 0 "Custom.Flag = 0: Remove Card Event 1: Insert Card Event "Custom.Value1 = Chunk counter of Custom.Text "Custom.Value2 = Total number of chunks for Custom.Text "Custom.
Programming NFC Commands Custom Events for NFC NFC Read tag custom event Reported to the master when the panel reads an NFC Tag. Custom ID - 1 Flag Value1 Value2 Value3 Text - event type - 700 0 - Tag Type - Data Type - Length of data in the Text field NFC Data (of type specified by Value2) Where Tag Type is: 1 = ISO 15693 2 = ISO 14443A 3 = ISO 14443B 4 = FeliCa (currently not supported) Data Type is: 0 = custom.text field contains the NFC UID (as a text string) 1 = custom.
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.
Appendix A: Text Formatting Text Area Input Masking Text Area Input Masking may be used to limit the allowed/correct characters that are entered into a text area. For example, in working with a zip code, a user could limit the entry to a max length of only 5 characters; with input masking, this limit could be changed to 5 mandatory numerical digits and 4 optional numerical digits. A possible use for this feature is to enter information into form fields.
Appendix A: Text Formatting Input Mask Ranges These ranges allow a user to specify the minimum and maximum numeric value for a field. Only one range is allowed per field. Using a range implies a numeric entry ONLY. Input Mask Ranges Character Meaning [ Start range ] End range | Range Separator An example from the above table: [0|255] This allows a user to enter a value from 0 to 255.
Appendix A: Text Formatting If the overflow field already contains a value, the new value will be inserted to the right of the current characters and the overflow field will be evaluated. Overflow continues to work until a field with no overflow value is set or no more fields remain (i.e. reached first field). If a character is typed and that character appears in the Next Field list, the keyboard should move the focus to the next field.
Appendix A: Text Formatting Other used escape sequences include: Escape Sequences Sequence Panel Information $DV Device Number $SY System Number $IP IP Address $HN Host Name $MC Mac Address $ID Neuron ID $PX X Resolution of current panel mode/file $PY Y Resolution of current panel mode/file $BX X Resolution of current button $BY Y Resolution of current button $BN Name of button $ST Current state $AC Address Code $AP Address Port $CC Channel Code $CP Channel Port $LC Level
Appendix A: Text Formatting 124 Modero G4 Touch Panels - Configuration and Programming
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 TPDesign4 may show no issues.
Appendix B: Video Streaming Troubleshooting The table below lists the typical synchronization and latency times for each supported video and audio stream: Video Performance Device Typical A/V Sync (offset/ hr) Typical A/V Sync Restart Rate <100ms ~ every 3hrs Expected Latency Typical Expected Latency Max Notes: MXA-MPL H.
Appendix B: Video Streaming Troubleshooting Video Performance (Cont.) Device Typical A/V Sync (offset/ hr) Typical A/V Sync Restart Rate Expected Latency Typical Expected Latency Max Notes: Vision2 (Cont.) MPEG2 <100ms ~ every 1-2hrs 1.5s 3s or more, depending on network The MXA-UENET video accelerator cable (FG5968-74/75/76) is recommended for this application, especially HD streams. Network congestion can cause video glitches.
Appendix B: Video Streaming Troubleshooting Video Performance (Cont.) Device Typical A/V Sync (offset/ hr) Typical A/V Sync Restart Rate Expected Latency Typical Expected Latency Max Notes: 3rd Party Solutions H.264 N/A N/A N/A N/A Note: Third-party encoders and digital television devices have not been tested with Modero X Series touch panels, and are not supported by AMX. The MXA-UENET video accelerator cable (FG5968-74/75/76) is recommended for this application, especially HD streams.
Appendix B: Video Streaming Troubleshooting Modero G4 Touch Panels - Configuration and Programming 129
In the ever-changing AV industry, continual education is key to success. AMX University is dedicated to ensuring that you have the opportunity to gather the information and experience you need to deliver strong AMX solutions. Plus, AMX courses also help you earn CEDIA, NSCA, InfoComm, and AMX continuing education units (CEUs).
