Release Notes
-------------------------------------------------------------------------------
All Modero X G5 Panels
FG #: FG5968-35, FG5968-36, FG5968-37
FG5968-41, FG5968-42, FG5968-43, FG5968-47, FG5968-48, FG5968-49
FG5968-53, FG5968-54, FG5968-55, FG5968-55W, FG5968-56
FG5968-77, FG5968-78, FG5968-79,
FG5968-80, FG5968-81
Firmware Version: 1.7.30
Release Date: 12/04/2017
Device Id: 0x0196 MXT-2001-PAN
0x0197 MXD-2001-PAN-P
0x0198 MXD-2001-PAN-L
0x0199 MXT-1901-PAN
0x019A MXD-1901-PAN-P
0x019B MXD-1901-PAN-L
0x019C MXT-1001
0x019D MXD-1001-P
0x019E MXD-1001-L
0x019F MXT-701
0x01A0 MXD-701-P
0x01A1 MXD-701-L
0x01D6 MXR-1001
Prerequisites: None
-------------------------------------------------------------------------------
Changes
-------------------------------------------------------------------------------
*******************************************************
*******************1.7.30******************************
*******************************************************
* Add IPv6 Support.
- IPv6 support is disabled by default.
- Supports Link-local IPv6 address, neighbour discovery IPv6 address,
and static IPv6 address.
- IPv6 gateway can be discovered using IPv6 router discovery or a static
IPv6 gateway can be set.
- Static IPv6 settings that can be set are the IPv6 address, the IPv6
subnet prefix length, the IPv6 gateway, and the IPv6 DNS servers.
* Add secure master connection.
- Secure connection uses TLS with x.509 certificate connection
verification. If the master uses a custom device certificate, then that
certificate should be installed in the panel using:
Settings->Security->Credential Storage->Install From Storage->Trusted CA
* Added 802.1x support.
- Supplicant uses FIPS 140-2 library for 802.1x which limits
EAP method/Phase 2 authentication to only TTLS/PAP. Certificate used for
IPv6 must be installed using:
Settings->Security->Credential Storage->Install From Storage->802.1x
* Added support for IPv6 addresses being used with dynamic images.
- ^RAF/^RMF commands now support IPv6 addresses HTTP. IPv6 addresses
should be inside [] (e.g. [2001::1] )
* Added password protected button property.
* Add G5 support for HTTPS client options.
- Validate HTTPS Server Certificate: If enabled, the HTTPS server
certificate is validated while the connection is being negotiated.
- Verify HTTPS Server Hostname: If enabled, verify the HTTPS server
hostname matches the HTTPS server certificate.
* Add modal popup support and support for popups with names ( _name ).
- Enforce modal popups and popups with names beginning with underscore
are highest in Z order of popups in the order of attachment.
* Added FIPS 140-2 SSL/TLS approved library to platform.
* Add support for Audit Logging to a NetLinx master which will log
to the syslog server if configured.
* Add central storage for encrypted data. Usernames/passwords from previous
versions will be migrated but if downgrading to prior release then
the current usernames/passwords will not be downgraded to previous
version. They should be reset on downgrading of firmware versions.
* Added USB security settings.
* Add support for enclosing ListView .csv fields inside quotations.
- Support escaping quotation marks inside of quotes with consecutive
quotation marks.
* Add Firefox as default browser.
* Add 'scale - maintain aspect ratio' image justification.
Justification value is 11 when using a SEND_COMMAND to set the
justification for a image.
* Add support for custom NTP server. Panel time is set to master time by
default.
* Add clear icon to ListView search field.
* Add support for ^BML command and %ML ^BMF option.
* Added Custom Event when USB is plugged/unplugged.
custom.id = 0
custom.type = 791
custom.flag = 1 if USB device was attached. 0 if USB device was detached.
custom.value1 = 0
custom.value2 = 0
custom.value3 = 0
custom.text = 'USB device attached' or 'USB device detached'
* Add ^SAD Subpage Add command. Adds a subpage to a set but doesn't change
the set anchor.
* Fix Intercom/SIP commands not always reported in right port.
* Fix level types not being retained after an online/offline.
* Fix level types not being reported correctly in some cases. This could
cause a level that is signed and went negative to be displayed at max
positive values.
* Fix where after a TPD5 file transfer the panel came online two times.
* Fix text append to a Text Input button.
* Fix ^BAT command to accept ISO-8859-1 encoded text instead of UTF8 encoded
text.
* Add ^BAF command that expects UTF8 encoded text.
* Fix ListView refresh commands from updating UI until list data has been
processed.
* Fix problems with ^BMF subcommand %GV, removed subcommand %SH and fixed
issue with ^UTF command not showing Unicode characters.
* Fixed issue with ^TPN where page tracking would not occur after startup
(when enabled) until ^TPN was sent to the touch panel. Pages will now be
tracked upon startup if page tracking is turned on.
* Fixed single line text buttons so that a done button always appears
instead of a return button.
* Fixed single line text buttons so that done button sends contained string
to master.
* Fixed text buttons so that when cancelled only one abort message is sent
to the master. Cancelling is done by either changing focus to different
buttons or closing the keyboard.
* Fixed multiline text buttons so that a done button is shown with the
keyboard.
* Fixed bug with password dialog where enter key on hardware keyboard would
add new line. Hardware keyboard's enter keys now act as pressing OK on the
dialog. Pressing 'Done' key on soft keyboard now is the same as pressing
OK on the dialog.
* Fix ListView to handle using SQL keywords in column/table names.
* Fix video streaming using UDP/RTP data on a multicast IPv6 address.
* Fixed ^BMF %P and %SO options not able to be cleared.
* Fix HTTP Digest authentication for MD5-sess algorithm.
* Fix HTTP Digest authentication when server sends HTTP redirects.
* Fix VNC input location offset errors.
- Errors introduced through new display timings in 19" and 20" panels
requiring display buffer size changes that were not compensated for in
the VNC server input.
* Fix where multiple subpage viewers with the same address code didn't
handle subpage show/hide send commands correctly.
* Fix subpages intermittently not anchoring in correct position after
multiple ^SSH/^SHD commands.
* Fix crash when multiple subpages were hidden/shown simultaneously.
* Increase the dispatching timeout to 20 seconds from the default 5 seconds
to reduce ANR messages.
* Ensure inactivity page flip tracking sent to master.
* Only send ^WCN response if VNC is enabled.
* Fix PKEYB and PKEYP commands not displaying keyboard/keypad if no '-' is
part of the command.
- Add support for @PKB command. Syntax same as ^PKB.
* Allow dynamic images loader to continue to attempt connections after 3
failed attempts, but do so at a reduced rate.
* Handle encoded paths and files in ^RMF/^RAF commands.
- Fix Resource path (%A) and File (%F) parameters that contain URL
encoded text (%%xx).
* Fix HTTP get of dynamic image when no content-type is in the
server response.
* Fix mishandling of URIs like http://user@server:pass@host:port/path/file.
(Usernames that have an '@'.)
* Handle URL encoding/decoding in Dynamic Images and ListView Images.
*******************************************************
*******************1.6.34******************************
*******************************************************
* Add support for new MXR-1001 Retractable Touch Panels
-------------------------------------------------------------------------------
New or Modified Send Commands in This Release
-------------------------------------------------------------------------------
* ^PPM / @PPM - Popup modal command
-------------------------------------------------------------------------
Set whether a popup is modal or not modal.
Syntax:
"'^PPM-<popup page name>;<modal 1|0>'"
or
"'@PPM-<popup page name>;<moda1 mode 1|0>'"
Variables:
popup page name Name of the popup page.
modal mode 1 if modal, 0 if non-modal.
Example:
SEND_COMMAND Panel,"'^PPM-Popup 1;1'"
Set the popup page named Popup 1 to modal mode.
* ^SCO - Session clear out command
-------------------------------------------------------------------------
Clears session data for some applications.
Syntax:
'^SCO'
Variables: none
NOTE: Application data that is cleared is for Browser, Firefox, Gallery,
Skype, Dropbox, VNC server, PlanMaker, TextMaker, and Presentations.
* ^MSG - Message Dialog Command
-------------------------------------------------------------------------
A generic message dialog that has displayed content defined from the
^MSG command.
Syntax:
'^MSG-dialog_id[:dialog_theme],dialog_type[-input_option][:dialog_image_name],
timeout, custom_event_type, custom_event_id, title_text, message_text,
positive_button_text,negative_button_text, neutral_button_text,
cancel_text, timeout_text'
Variables:
dialog_id Unique id to reference the dialog. Used to track IDs to
displayed dialogs.
dialog_theme Optional theme of the dialog is set by appending the
theme to the dialog_id number with ':' and the theme.
Valid themes are light and dark (default)
dialog_type The type of dialog to display:
std standard dialog. By default, no image is
displayed in the title area.
warn warning dialog. The built-in warning image is
used in the title area.
error error dialog. The built-in error image is
used in the title area.
quest question dialog. The built-in question image is
used in the title area.
list list of items to choose. By default, no image
is displayed in the title area. List items are
put in the message_text field and are separated
by colons (':').
input input entry. By default, no image is displayed
in the title area. Optional input_options follow
a dash ('-') and are:
no option present alphanumeric input
num numeric input (no
alphabetic input)
phone phone pad presented
uri URI keyboard presented
email Email keyboard presented
name Keyboard presented and
capital words are used.
date Date pad presented
time Time pad presented
datetime Date/Time pad presented
pass password entry. By default, no image is
displayed in the title area. Optional
input_options follow a dash ('-') and are:
no option present alphanumeric input
num numeric input (no
alphabetic input)
dialog_image_name It is optional to override any type with a custom
image or dynamic image from the TP5 file to be
displayed in the title area. The image used is set
by appending a ':' and image file/resource name to
the dialog_type-input_option (e.g. std:number.png
or warn:mywarningimage.jpg).
timeout Timeout is in milliseconds. If timeout is 0, message
does not timeout and is considered modal.
custom_event_type The custom event type value to use for result custom
events.
custom_event_id The custom event ID value to use for result custom
events.
title_text Text that is displayed in the dialog title. If this
field is empty, no title is displayed on the dialog.
message_text In most cases, the contents of this field is
displayed in the message of the dialog. There are a
few exceptions based on dialog_type:
list In a list dialog type, the message_text
contains the list items. List items are
separated by a colon (':').
input In a input dialog type, the message_text
contains the initial value of the text
entry field of the dialog.
pass In a pass dialog type, the message_text
contains the initial value of the text
entry field of the dialog.
positive_button_text Text to display on the positive button (e.g.
Yes, OK, Enter, etc.) In most cases, if the
positive button is selected, this text is sent
to master in the custom.text field. NOTE:If this
field is empty,the positive button is not
displayed in the MessageDialog.
negative_button_text Text to display on the negative button (e.g. No,
etc.) If the negative button is selected, this
text is sent to the master in the custom.text
field. NOTE: If this field is empty, the negative
button is not displayed in the MessageDialog.
neutral_button_text Text to display on the neutral button (e.g.
Cancel, Dismiss, etc.) If the neutral button is
selected, this text is sent to the master in the
custom.text field. NOTE: If this field is empty,
the neutral button is not displayed in the
MessageDialog.
cancel_text Optional. If the dialog is cancelled, this text
is sent to the master in the custom.text field.
timeout_text Optional. If the dialog times out, this text is
sent to the master in the custom.text field.
NOTE: Text fields can be put into quotations (“ ”) so that
commas can be used in text. Like the CSV parser, if a " is
needed in the text, the " can be escaped by a prepended another
" (e.g. "").
NOTE: The use of text params in command instead of preset
definitions for button text is so that the language of text
can be set in code. Unicode quads for text are supported by
using the command '^MSGU-' command. Legacy ISO-8859-1 (like ^TXT)
text is supported by using the '^MSGT-' command.
Response Data:
The response to the MessageDialog is sent to the master via a Custom Event.
Some of the custom event values are set in the ^MSG command, and others
are generated as a result of the dialog action.
Result Custom Events data:
custom.type The value set in the custom_event_type field
custom.id The value set in the custom_event_id field.
custom.flag value has the result. In most cases, it indicates
which button was selected, or cancel, or timeout:
-1 = timeout
0 = cancel
1 = positive button
2 = negative button
3 = neutral button
In a list dialog type, when an item is selected, the
custom.flag field will be set to 1 (positive button).
custom.value1 The dialog_id value set in the command
custom.value2 In a list dialog type, this field has the index of
the selected list item. If the first item was
selected then value2==1, second item selected then
value2==2, etc. If the dialog_type is not a list,
then value2 is unused and is set to 0.
custom.value3 Unused. Set to 0.
custom.text The text of the resulting button selected, or
cancel_text if dialog was cancelled, or timeout_text
if timed out. In list mode, the selected list item
text value is sent in this field. In input or pass,
the entered value is sent in this field.
NOTE: Custom events are returned on the port the command was
sent to from the master.
Examples:
SEND_COMMAND Panel,’^MSG-1,std,60000,32001,1,Please Wait,”System is busy”,OK’;
Display dialog ID 1 as a standard dialog.
The timeout is 60s.
The custom_event_type to use is 32001.
The custom_event_id to use is 1.
The title_text is 'Please Wait'.
The message_text is 'System is busy'.
The positive_button_text is 'OK'
SEND_COMMAND Panel,'^MSG-1,list:question-flat-48x48.png,30000,32001,10,
Select item,"item 1:item 2:item 3:item 4:item 5",,"Cancel"'
Display dialog ID 1 as a list dialog. The image 'question-flat-48x48.png'
is used as the image in the title area.
The timeout is 30s.
The custom_event_type to use is 32001.
The custom_event_id to use is 10.
The title_text is 'Select Item'.
The message_text is list of 5 items (item 1, item 2, item 3, item 4, item5).
The positive_button_text is empty.
The negative_button_text is empty.
The neutral_button_text is 'Cancel'.
SEND_COMMAND Panel,"'^MSGT-1:light,error,30000,32001,32002,"Error Title",
"Lorem ipsum dolor sit amet, consectetur adipiscing elit,
sed do eiusmod tempor incididunt ut labore et dolore magna
aliqua. Ut enim ad minim veniam, quis nostrud exercitation
ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit
esse cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum. ""the end"",
"Positive","Negative","Neutral","Cancel","Timeout"'"
^MSGT - The dialog text is encoded in the ISO-8859-1 (Latin-1) format
(Like what is expected by ^TXT command).
Display dialog ID 1 with a light theme as an error dialog. The default
error image is used as the image in the title area.
The timeout is 30s.
The custom_event_type to use is 32001.
The custom_event_id to use is 32001.
The title_text is 'Error Title'.
The message_text is a variation of 'Lorem ipsum...'.
The positive_button_text is 'Positive'.
The negative_button_text is 'Negative'.
The neutral_button_text is 'Neutral'.
The cancel_text is 'Cancel'.
The timeout_text is 'Timeout'.
* ^NOT - Popup Note Command
-------------------------
A generic popup note message that can be used to display information for
a short duration on the display.
Syntax:
'^NOT-note_text, duration, location, text_size'
Variables:
note_text The text to displayed in the popup note.
duration The time in milliseconds to display the popup note
location Where to display the popup note. Options are 'c' for
CENTERED on display, 't' for TOP CENTER on display, and
'b' for BOTTOM CENTER on display. Any other value will
be displayed as CENTER.
text_size The size value to display the popup note text. Default
is 18.
NOTE: The note text field can be put into quotations (“ ”) so that
commas can be used in text. Like the CSV parser, if a " is needed
in the text, the " can be escaped by a prepending another "
(e.g. ""). Note text is assumed to be UTF-8 encoded.
* Modify ^RAF/^RMF commands
-------------------------------------------------------------------------
- In a single string the %P, %U, %S, %H, %A, and %F values can be entered.
- Commands now accept full URL using %L embedded code. If the URL is the
first part of the string then the %L is assumed.
- Example: The following send commands are equivalent. All examples set
the resource Image1 to a URL of http://server/folder1/image.jpg with
a username of username, password of password, notifications on, and
refresh time of 30 seconds.
SEND_COMMAND Panel,'^RMF-Image1,%Lhttp://username:password@server/folder1/image.jpg%Con%R30'
SEND_COMMAND Panel,'^RMF-Image1,%P0%Uusername%Spassword%Hserver%Afolder1%Fimage.jpg%Con%R30'
SEND_COMMAND Panel,'^RMF-Image1,http://username:password@server/folder1/image.jpg%Con%R30'
SEND_COMMAND Panel,'^RMF-Image1,http://server/folder1/image.jpg%Con%R30%Uusername%Spassword'
* Modify ^BSP command
-------------------------------------------------------------------------
- Modify ^BSP send command to accept unspecified parameters.
- This can be done with either ,, or ,-1,
- If left or top is unspecified, then the current values for the button
will be used.
- If right or bottom is unspecified, the current width and height is used
to maintain the button size.
- This effectively creates a button "move" command.
- Also works the same with %R in ^BMF.
* ^BAF - Append UTF-8 Text to State Command
-------------------------------------------------------------------------
Append non-unicode text.
Syntax:
"'^BAF-<addr range>,<button states range>,<new text>'"
Variables:
address range Address codes of buttons to affect. A '.' between
addresses includes the range, and & between
addresses includes each address.
button states range 1 - 256 for multi-state buttons (0 = All states,
for general buttons 1 = Off state and
2 = On state).
new text UTF-8 encoded characters.
Example:
SEND_COMMAND Panel,"'^BAF-520,1,ξεσκεπάζω τὴν ψυχοφθόρα βδελυγμία'"
Appends the UTF-8 text 'ξεσκεπάζω τὴν ψυχοφθόρα βδελυγμία' to the
button's OFF state.
* ^BML - Set text input max length command
-------------------------------------------------------------------------
Set the maximum length of the text area button. If this value is set to
zero (0), the text area has no max length. This is only for a Text area
input button and not for a Text area input masking button.
Syntax
"'^BML-<addr range>,<max length>'"
Variables:
address range Address codes of buttons to affect. A '.' between
addresses includes the range, and & between addresses
includes each address.
max length The maximum length in characters of a text input
area. (0=no max length)
Example:
SEND_COMMAND Panel,"'^BML-500,20'"
Sets the maximum length of the text area input button to 20 characters.
* ^SAD - Subpage add command
-------------------------------------------------------------------------
Adds a subpage to a viewer button without changing the anchor subpage.
- If the named subpage is not present in the set it will be added in the
specified position. If no position parameter is supplied the subpage
is added to the end of the set. The anchor subpage will not be changed.
- If the named suppage is already present, it will be hidden from the set
and re-added in the specified position. The anchor subpage will not be
changed, unless the named subpage is currently the anchor. In that case,
the next appropriate subpage will become the anchor and the named
subpage will be added at the appropriate position.
- If no subpages are in the set, this command is effectively a Subpage
Show command (^SSH).
Syntax:
"'^SAD-<addr range>,<name>,<optional position>,<optional time>'"
Variables:
address range Address codes of buttons to affect. A '.' between
addresses includes the range, and & between addresses
includes each address.
name Specifies the name of the subpage to be shown or added.
position Specifies where to add the named subpage in the set
with 0 representing the beginning of the set. If this
value is left out (or set to 65535) then the new
subpage is placed at the end of the list.
time Can range from 0 to 30 and represents tenths of a
second. This is the amount of time used to move the
subpages around when subpages are added or removed
from a button.
Example:
SEND_COMMAND Panel,"'^SAD-400,media1'"
Add the media1 subpage at the end of the set.
-------------------------------------------------------------------------------
Known Issues/Requests
-------------------------------------------------------------------------------
* Authenticated HTTP and HTTPS connections for dynamic images must have
username (%U) and password (%S) defined if the web server requires
authentication credentials.
* Authenticated HTTP and HTTPS connections for ListView files must have
username (user=username) and password (pass=password) options defined in
the ^LVD command if the web server requires authentication credentials.
* Cannot use an IPv6 link-local address for a dynamic image or ListView
data host address. The panel OS requires a link-local address include
an interface name as a part of a URL, but the framework classes interpret
a hostname with an interface name as an invalid URL. Without the
the interface name the following error is seen:
HttpAuthenticate: failed to connect to...(Invalid argument)
SIP/Intercom:
------------------------
* When using the intercom module and supplied intercom UI, the panel name
cannot be edited from the panels.
* Intercom calls to an iPad will have poor audio quality unless TPControl
v2.5.0.2 (or higher) is used on the iPad.
* The new SIP engine only supports a single call at this time.
Multiple calls will be handled in an upcoming version. This affects
aspects of call transfer and hold/answer new call.
* Panel monitoring and a SIP call cannot occur at the same time.
* Call re-directs within CUCM may not establish audio connections.
Video:
------------------------
* MJPG sources that could be entered as a streaming video fill (using an
http://server/image.mjpg URL) are not supported. They must be entered in
the dynamic images resource list.
* Video glitches with 576i PAL component video from MPL. Use an alternate
format as a workaround.
* When using the MPL video with video fill set to Audio and Video, if no
audio is on the HDMI input the video will routinely glitch until the
setting is corrected. Use the ^SLT command to set audio/video mode to
'video' (‘^SLT-1,audiovideoenable=video’) to optimize video performance.
* On rare occurrences, some video undergoes buffering for a few seconds,
video freezes, or the panel forces reboot.
Audio:
------------------------
* Audio extraction is not supported from the panel.
* USB Audio is not supported at this time.
UI:
------------------------
* Some text may render differently between TPD5 and the G5 panel. The font
rendering engines are not identical between the TPD5 Windows application
and the Panel firmware, so there can be slight differences in font
spacing, word wrapping, etc.
* Limited support for Chameleon Images in G5. Some forms of Chameleon
Images are not rendered in the same manner. These images must be reworked.
(See Tech Note 1031 - Chameleon Images and G5)
USB/Bluetooth:
------------------------
* USB Headsets are not supported.
* If the Bluetooth dongle is inserted/removed, the panel may require reboot
to recognize the change in configuration.
* The Bluetooth device discovery scan will display all Bluetooth devices in
range even though their connection types may not be supported by the panel.
3rd Party Applications:
------------------------
* General - For applications to deliver notifications to the user the Show
Status action must be implemented on a G5 page.
* Skype - Occasionally the video will glitch or lose audio/video
synchronization.
* Browser - The browser will intermittently close if left on a page with
animations for multiple days.
* Dropbox - No support for "Turn on Camera Upload" feature as the panel
camera cannot take pictures.
* Mail - App settings page has a reference to Wi-Fi under
Mail Settings->Data Usage, which actually refers to the wired Ethernet
connection.
* TextMaker - Clicking internet links in documents intermittently freezes
panel. Presentation animations could crash app.
* VNC - Intermittent failures in application. VNC will display previous
session screencap after disconnect.
Content Sharing
------------------------
* Enzo has changed the default port for Content Sharing from 8080 to 80.
A Content Sharing receiver (Enzo) will auto migrate from a previously set
8080 to 80 (with a user dialog presented at bootup). Content Sharing
senders (ModeroX) that were previously configured with 8080, will need to
be manually updated to the new port number.
-------------------------------------------------------------------------------
Migrating from G4 to G5
-------------------------------------------------------------------------------
The newest Modero X touch panels are based on G5, the latest operating
system from AMX. Please review the programmer’s primer regarding G4 to G5
differences, located at http://www.amx.com/products/TPDesign5.asp. G4 touch
panel files must be converted to G5-compatible files before use with G5
touch panels. Use the G4 Utility tool to convert panel pages from G4 to G5.
Refer to the Configuration and Programming Guide for Modero X Series G5
Touch Panels for information regarding NetLinx code modifications required
to support G5 panels.
