WE B CO N S O LE A N D P RO G RA M M IN G G UI DE

N X - S E R I ES C O N T RO L LE RS
E N OVA ® DVX A L L - I N - O N E P RES E N T AT I O N SW I TC H E RS
E N OVA ® D GX DI G I T A L M EDIA SW I TC H E RS
M ASS I O ™ C O N T RO LPAD S
NX -1 20 0, N X- 220 0, N X- 320 0, N X-4 200
DVX-3250HD-SP , DVX-3250HD-T, DVX-3255HD-SP , DVX-3255HD-T, DVX-3256HD-SP, DVX-3256HD-T
DVX-2250HD-SP , DVX-2250HD-T, DVX-2255HD-SP , DVX-2255HD-T, DVX-2210HD-SP, DVX-2210HD-T
DGX8-ENC, DGX16-ENC, DGX32- EN C- A, DGX64-ENC
MCP- 10 6, MCP- 10 8
IMPORTANT SAFETY INSTRUCTIONS
1. READ these instructions.
2. KEEP these instructions.
3. HEED all warnings.
4. FOLLOW all instructions.
5. DO NOT use this apparatus near water.
6. CLEAN ONLY with dry cloth.
7. DO NOT block any ventilation openings. Install in accordance with the manufacturer's instructions.
8. DO NOT install near any heat sources such as radiators, heat registers, stoves, or other apparatus (including amplifiers) that
produce heat.
9. DO NOT defeat the safety purpose of the polarized or grounding type plug. A polarized plug has two blades with one wider than the
other. A grounding type plug has two blades and a third grounding prong. The wider blade or the third prong are provided for your
safety. If the provided plug does not fit into your outlet, consult an electrician for replacement of the obsolete outlet.
10. PROTECT the power cord from being walked on or pinched, particularly at plugs, convenience receptacles, and the point where
they exit from the apparatus.
11. ONLY USE attachments/accessories specified by the manufacturer.

12. USE ONLY with a cart, stand, tripod, bracket, or table specified by the manufacturer, or sold with the apparatus. When a cart is
used, use caution when moving the cart/apparatus combination to avoid injury from tip-over.

13. UNPLUG this apparatus during lightning storms or when unused for long periods of time.
14. REFER all servicing to qualified service personnel. Servicing is required when the apparatus has been damaged in any way, such as
power-supply cord or plug is damaged, liquid has been spilled or objects have fallen into the apparatus, the apparatus has been
exposed to rain or moisture, does not operate normally, or has been dropped.
15. DO NOT expose this apparatus to dripping or splashing and ensure that no objects filled with liquids, such as vases, are placed on
the apparatus.
16. To completely disconnect this apparatus from the AC Mains, disconnect the power supply cord plug from the AC receptacle.
17. Where the mains plug or an appliance coupler is used as the disconnect device, the disconnect device shall remain readily operable.
18. DO NOT overload wall outlets or extension cords beyond their rated capacity as this can cause electric shock or fire.

The exclamation point, within an equilateral triangle, is intended to alert the user to the presence of important operating and maintenance
(servicing) instructions in the literature accompanying the product.

The lightning flash with arrowhead symbol within an equilateral triangle is intended to alert the user to the presence of uninsulated "dangerous
voltage" within the product's enclosure that may be of sufficient magnitude to constitute a risk of electrical shock to persons.

ESD Warning: The icon to the left indicates text regarding potential danger associated with the discharge of static electricity from an outside
source (such as human hands) into an integrated circuit, often resulting in damage to the circuit.

WARNING: To reduce the risk of fire or electrical shock, do not expose this apparatus to rain or moisture.
WARNING: No naked flame sources - such as candles - should be placed on the product.
WARNING: Equipment shall be connected to a MAINS socket outlet with a protective earthing connection.
WARNING: To reduce the risk of electric shock, grounding of the center pin of this plug must be maintained.

COPYRIGHT NOTICE
AMX© 2015, all rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any
means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of AMX. Copyright protection claimed
extends to AMX hardware and software and includes all forms and matters copyrightable material and information now allowed by statutory or judicial
law or herein after granted, including without limitation, material generated from the software programs which are displayed on the screen such as
icons, screen display looks, etc. Reproduction or disassembly of embodied computer programs or algorithms is expressly prohibited.

LIABILITY NOTICE
No patent liability is assumed with respect to the use of information contained herein. While every precaution has been taken in the preparation of this
publication, AMX assumes no responsibility for error or omissions. No liability is assumed for damages resulting from the use of the information
contained herein. Further, this publication and features described herein are subject to change without notice.

AMX WARRANTY AND RETURN POLICY

The AMX Warranty and Return Policy and related documents can be viewed/downloaded at www.amx.com.
 Table of Contents

Table of Contents
Overview ..........................................................................................................13
NetLinx NX Integrated Controllers................................................................................. 13
Enova DVX All-in-One Presentation Switchers ............................................................... 13
Enova DVX-22xxHD & DVX-325xHD ...................................................................................................... 13
Enova DGX Digital Media Switchers................................................................................ 14
Massio™ ControlPads ..................................................................................................... 14
About This Document ..................................................................................................... 14
Differences in DEFINE_PROGRAM Program Execution................................................... 14
CPU Usage ............................................................................................................................................ 15
Quick Setup and Configuration Overview....................................................................... 17
Installation Procedures ........................................................................................................................ 17
Configuration and Communication ...................................................................................................... 17
Update the On-board Master and Controller Firmware........................................................................ 17
Configure NetLinx Security on the NX Controller ................................................................................. 17
Using Zero Configuration ............................................................................................... 17
Bonjour (Zero-Configuration) Client .................................................................................................... 17
Connecting to a Network with a DHCP Server ...................................................................................... 17
Initial Configuration ........................................................................................19
Overview ......................................................................................................................... 19
Before You Start ............................................................................................................. 19
Preparing the Master for USB Communication .............................................................. 19
Configuring the NX Controller for LAN Communication................................................. 21
Obtaining the NX Controller’s IP Address (using DHCP) ................................................ 23
Assigning a Static IP to the NX Controller ..................................................................... 24
Communicating via IP Address ....................................................................................... 25
Upgrading Firmware .......................................................................................28
Overview .......................................................................................................................... 28
NX Controllers - Firmware Files ............................................................................................................ 28
NX Master Firmware ............................................................................................................................................................... 28
Device Controller Firmware.................................................................................................................................................... 28
Enova DVX ............................................................................................................................................. 28
Before You Start .............................................................................................................. 29
Verifying the Current Firmware Version ......................................................................... 29
Downloading the Latest Firmware Files from www.amx.com ......................................... 29
NetLinx Integrated Controllers ............................................................................................................ 29
Master and Device Firmware Kit Files for NX-Series Controllers ....................................................................... 29
Downloading NX-Series Controller Firmware Files on www.amx.com............................................................... 30
Enova DVX All-In-One Presentation Switchers..................................................................................... 30
Master, Switcher and Device Firmware Files for Enova DVX All-In-One Presentation Switchers ...................... 30

NX-Series Controllers - WebConsole & Programming Guide 3

 Table of Contents

Downloading Enova DVX Firmware Files on www.amx.com............................................................................... 30

Master and Device Firmware Kit Files for Massio ControlPads ............................................................ 31
Required Order of Firmware Updates ............................................................................ 31
Required Order of Firmware Updates for DVX Controllers ................................................................... 31
Upgrading Firmware via USB ......................................................................................... 31
Upgrading Firmware via NetLinx Studio ........................................................................ 31
Resetting the Factory Default System and Device Values............................................... 33
On-Board WebConsole User Interface ............................................................34
WebConsole UI Overview ............................................................................................... 34
System Configuration Interface Tips: ................................................................................................................ 34
Accessing the WebConsole .................................................................................................................. 35
Default User Names and Passwords..................................................................................................... 35
WebConsole - Network Options ......................................................................36
Network Overview............................................................................................................ 36
Network - IPv4 Setup ..................................................................................................... 37
IPv4 Options ......................................................................................................................................... 37
Network - IPv6 Setup ...................................................................................................... 38
Network - Date/Time ....................................................................................................... 38
Setting the Mode for the Clock Manager .............................................................................................. 39
Setting Daylight Savings Rules ............................................................................................................. 39
Selecting a Custom NIST Server .......................................................................................................... 39
Adding a Custom NIST Server to the List ............................................................................................. 40
Removing an NIST Server From the List............................................................................................... 40
Clock Manager NetLinx Programming API ........................................................................................... 40
WebConsole - Security Options ......................................................................41
Security Overview........................................................................................................... 41
Login Rules............................................................................................................................................ 41
User and Role Name Rules.................................................................................................................................. 42
Password Rules................................................................................................................................................... 42
Security - General........................................................................................................... 43
System Level Security - System Security Settings ............................................................................... 43
System Security Options....................................................................................................................... 43
Security Presets.................................................................................................................................... 45
Audit Logs ............................................................................................................................................. 46
Banners................................................................................................................................................. 46
Security - Roles............................................................................................................... 47
Default Roles ......................................................................................................................................... 47
Role Permissions .................................................................................................................................. 48
Adding a New Role ................................................................................................................................ 49
Viewing and Modifying Role Security Settings Details ......................................................................... 50
Deleting a Role ...................................................................................................................................... 50

NX-Series Controllers - WebConsole & Programming Guide 4

 Table of Contents

Locking/Disabling a Role ...................................................................................................................... 50

Security - Users .............................................................................................................. 51
Default User Accounts .......................................................................................................................... 51
Adding a New User................................................................................................................................ 52
Viewing and Editing User Security Settings ......................................................................................... 53
Deleting a User ..................................................................................................................................... 53
Locking/Disabling a User...................................................................................................................... 53
Security Settings - LDAP................................................................................................. 54
LDAP Options ........................................................................................................................................ 54
Accepting Changes ............................................................................................................................... 55
Testing the Connection to the LDAP Server ......................................................................................... 55
Wired 802.1X support........................................................................................................................... 55
Security - Profile .............................................................................................................. 56
Changing a User’s Password ................................................................................................................ 56
WebConsole - System Options ........................................................................57
System Overview ............................................................................................................ 57
System - Info .................................................................................................................. 57
System - Devices ............................................................................................................. 58
Changing the System Number on the Master....................................................................................... 58
Changing the Device Number on a Device............................................................................................ 58
Resetting the Master Controller to the Factory Defaults Configuration .............................................. 58
WebConsole - Modules Options ......................................................................59
Modules Overview ........................................................................................................... 59
Modules - Device Options ............................................................................................... 60
Configuring Device Binding Options ..................................................................................................... 60
Managing Device Driver Modules ......................................................................................................... 60
Uploading a Module ............................................................................................................................................ 60
Archiving a Module ............................................................................................................................................. 60
Deleting a Module ............................................................................................................................................... 60
Modules - Bindings ......................................................................................................... 61
Configuring Application-Defined Devices............................................................................................. 62
Application Devices and Association Status......................................................................................... 63
Viewing Physical Device Properties...................................................................................................... 63
Modules - User-Defined Devices .................................................................................... 64
Adding a User-Defined Device .............................................................................................................. 64
Modules - Active Devices................................................................................................. 65
Searching For All Compatible Duet Modules for a Selected Device ..................................................... 65
Viewing Physical Device Properties...................................................................................................... 66
WebConsole - Switching Options ....................................................................67
Switching Overview ........................................................................................................ 67
Color-coded Switch Selection and Switching Orientation ................................................................................. 67
Switching Page Components................................................................................................................ 68

NX-Series Controllers - WebConsole & Programming Guide 5

 Table of Contents

Switch Mode.......................................................................................................................................... 69
Configuring/Switching the Downmix Signal ........................................................................................ 70
Designating an Input for Downmixing (from Configuration page) ...................................................... 70
Configuration Page......................................................................................................... 71
Configuration Components .................................................................................................................. 71
Video Settings....................................................................................................................................... 73
Inputs Only ......................................................................................................................................................... 73
Outputs Only ....................................................................................................................................................... 73
DXLink Video Settings........................................................................................................................... 75
DXLink (Twisted Pair or Fiber) Transmitters (for selected video input) ............................................................ 75
DXLink (Twisted Pair or Fiber) Receivers (for selected video output)............................................................... 75
Audio Settings ...................................................................................................................................... 76
Inputs Only ......................................................................................................................................................... 76
Outputs Only ....................................................................................................................................................... 77
DXLink Audio Settings .......................................................................................................................... 78
DXLink (Twisted Pair or Fiber) Transmitter (for selected audio input) ............................................................. 78
DXLink (Twisted Pair or Fiber) Receivers (for selected audio output)............................................................... 79
EDID Configuration ............................................................................................................................... 79
Setting an EDID for an Input:................................................................................................................ 79
Setting an EDID for an Output:.............................................................................................................. 79
Setting the EDID Mode for an Audio Input: .......................................................................................... 79
Loading and Saving EDIDs .................................................................................................................... 79
Status Page..................................................................................................................... 80
System Configuration Interface Tips ................................................................................................................. 81

NetLinx Programming .....................................................................................82

Overview .......................................................................................................................... 82
Port Assignments by NetLinx Master .............................................................................. 82
Port Assignments by All-in-One-Presentation Switcher ................................................. 82
Port Assignments by Massio ControlPad ........................................................................ 82
Serial, IR, AxLink, and PoE Port Diagnostics ................................................................... 83
Master SEND_COMMANDs .............................................................................................. 84
CLOCK .................................................................................................................................................................................... 84
G4WC ..................................................................................................................................................................................... 84
~IGNOREEXTERNALCLOCKCOMMANDS................................................................................................................................. 84
Master IP Local Port SEND_COMMANDs.......................................................................... 85
UDPSENDTO ............................................................................................................................................................................ 85
SSH SEND_COMMANDs .................................................................................................... 86
SSH_CLIENT_CLOSE ............................................................................................................................................................... 86
SSH_CLIENT_OPEN ................................................................................................................................................................. 86
LED SEND_COMMANDs.................................................................................................... 87
LED-DIS.................................................................................................................................................................................. 87
LED-EN ................................................................................................................................................................................... 87
RS232/422/485 Ports Channels ................................................................................... 87
RS-232/422/485 SEND_COMMANDs .............................................................................. 88
B9MOFF................................................................................................................................................................................... 88
B9MON .................................................................................................................................................................................... 88

NX-Series Controllers - WebConsole & Programming Guide 6

 Table of Contents

CHARD..................................................................................................................................................................................... 88
CHARDM.................................................................................................................................................................................. 88
CLEAR FAULT .......................................................................................................................................................................... 88
CTSPSH ................................................................................................................................................................................... 88
CTSPSH OFF ............................................................................................................................................................................ 88
GET BAUD ............................................................................................................................................................................... 89
GET FAULT .............................................................................................................................................................................. 89
GET STATUS............................................................................................................................................................................ 89
HSOFF ..................................................................................................................................................................................... 89
HSON....................................................................................................................................................................................... 89
RXCLR ..................................................................................................................................................................................... 89
RXOFF ..................................................................................................................................................................................... 89
RXON ....................................................................................................................................................................................... 89
SET BAUD............................................................................................................................................................................... 90
SET FAULT DETECT OFF ......................................................................................................................................................... 90
SET FAULT DETECT ON........................................................................................................................................................... 90
TSET BAUD............................................................................................................................................................................. 90
TXCLR .................................................................................................................................................................................... 91
XOFF....................................................................................................................................................................................... 91
XON ........................................................................................................................................................................................ 91
RS-232/422/485 SEND_STRING Escape Sequences...................................................... 92
27,17,<time> ......................................................................................................................................................................... 92
27,18,0 ................................................................................................................................................................................... 92
27,18,1 ................................................................................................................................................................................... 92
27,19,<time> ......................................................................................................................................................................... 92
27,20,0 ................................................................................................................................................................................... 92
27,20,1 ................................................................................................................................................................................... 92
ESCSEQOFF ............................................................................................................................................................................. 92
ESCSEQON .............................................................................................................................................................................. 92
IR/Serial Ports Channels................................................................................................. 93
IRRX Port Channels ......................................................................................................... 93
IR/Serial SEND_COMMANDs............................................................................................ 93
CAROFF ................................................................................................................................................................................... 93
CARON .................................................................................................................................................................................... 93
CH ........................................................................................................................................................................................... 93
CLEAR FAULT .......................................................................................................................................................................... 93
CP........................................................................................................................................................................................... 94
CTOF ...................................................................................................................................................................................... 94
CTON ...................................................................................................................................................................................... 94
GET BAUD .............................................................................................................................................................................. 94
GET FAULT ............................................................................................................................................................................. 94
GET MODE .............................................................................................................................................................................. 94
GET STATUS........................................................................................................................................................................... 94
IROFF ...................................................................................................................................................................................... 95
POD ......................................................................................................................................................................................... 95
POF.......................................................................................................................................................................................... 95
PON ......................................................................................................................................................................................... 95
PTOF........................................................................................................................................................................................ 95
PTON ....................................................................................................................................................................................... 95
SET BAUD................................................................................................................................................................................ 96
SET FAULT DETECT OFF .......................................................................................................................................................... 96
SET FAULT DETECT ON............................................................................................................................................................ 96
SET IO LINK ............................................................................................................................................................................ 96
SET MODE............................................................................................................................................................................... 97
SP........................................................................................................................................................................................... 97
XCH ........................................................................................................................................................................................ 97
XCHM ...................................................................................................................................................................................... 98
Input/Output SEND_COMMANDs..................................................................................... 99
GET DBT .................................................................................................................................................................................. 99
SET DBT .................................................................................................................................................................................. 99
GET INPUT .............................................................................................................................................................................. 99
SET INPUT .............................................................................................................................................................................. 99

NX-Series Controllers - WebConsole & Programming Guide 7

 Table of Contents

PoE SEND_COMMANDs ................................................................................................. 100

GET CLASS ........................................................................................................................................................................... 100
GET CURRENT ...................................................................................................................................................................... 100
GET FAULT ........................................................................................................................................................................... 100
GET STATUS......................................................................................................................................................................... 100
GET VOLTAGE....................................................................................................................................................................... 100
SET FAULT DETECT OFF ....................................................................................................................................................... 100
SET FAULT DETECT ON......................................................................................................................................................... 100
SET POWER OFF ................................................................................................................................................................... 100
SET POWER ON..................................................................................................................................................................... 100
AxLink SEND_COMMANDs............................................................................................. 101
AXPWROFF ........................................................................................................................................................................... 101
AXPWRON ............................................................................................................................................................................ 101
GET AX FAULT ...................................................................................................................................................................... 101
Audit Log SEND_COMMANDs ........................................................................................ 101
LOG ...................................................................................................................................................................................... 101
Authentication .............................................................................................................. 102
Library Calls ........................................................................................................................................ 102
TLS_CLIENT_CLOSE ............................................................................................................................................................. 102
TLS_CLIENT_OPEN............................................................................................................................................................... 102
VALIDATE_NETLINX_ACCOUNT........................................................................................................................................... 103
VALIDATE_NETLINX_ACCOUNT_WITH_PERMISSION ......................................................................................................... 103

Terminal (Program Port/Telnet) Commands .............................................. 104

Overview ....................................................................................................................... 104
Establishing a Terminal Connection via the Program Port .......................................... 104
Establishing a Terminal Connection via Telnet ............................................................ 104
Terminal Commands .................................................................................................... 105
----- Help ----- <D:P:S> ........................................................................................................................................................ 105
? or Help............................................................................................................................................................................... 105
ADD AUDIT SERVER [D:P:P] ................................................................................................................................................. 105
AUTO LOCATE (ENABLE|DISABLE|STATUS) ........................................................................................................................ 105
BOOT STATUS ...................................................................................................................................................................... 105
CHANGE PASSWORD............................................................................................................................................................ 105
CLEAR AUDIT ....................................................................................................................................................................... 105
CLEAR HTTPS REDIRECT...................................................................................................................................................... 105
CLEAR MAX BUFFERS........................................................................................................................................................... 105
CLEAR PERSISTENT VARS.................................................................................................................................................... 105
CPU USAGE .......................................................................................................................................................................... 105
DATE .................................................................................................................................................................................... 105
DATE/TIME ON|OFF ............................................................................................................................................................. 105
DEVICE DEBUG..................................................................................................................................................................... 105
DEVICE HOLDOFF ON|OFF .................................................................................................................................................... 105
DEVICE STATUS <D:P:S>..................................................................................................................................................... 105
DIPSWITCH.......................................................................................................................................................................... 105
DISK FREE ............................................................................................................................................................................ 105
DNS LIST <D:P:S>................................................................................................................................................................ 106
DOT1X (ENABLE|DISABLE|STATUS).................................................................................................................................... 106
ECHO ON|OFF ....................................................................................................................................................................... 106
EXPORT (CONFIG|CLONE) TO USB (FRONT|BACK) ............................................................................................................. 106
EXPORT AUDIT to USB (FRONT|BACK) ................................................................................................................................ 106
FIPS MODE ........................................................................................................................................................................... 106
GET AUDIT STATUS ............................................................................................................................................................. 106
GET DEVICE HOLDOFF .......................................................................................................................................................... 107
GET DEVICE TRAFFIC........................................................................................................................................................... 107
GET DUET MEMORY .............................................................................................................................................................. 107
GET ICSLAN ......................................................................................................................................................................... 107
GET IP <D:P:S> .................................................................................................................................................................... 107
GET LEASES ......................................................................................................................................................................... 107
GET OCSP URL...................................................................................................................................................................... 107

NX-Series Controllers - WebConsole & Programming Guide 8

 Table of Contents

GET PLATFORM INFO ........................................................................................................................................................... 107

HELP SECURITY ................................................................................................................................................................... 107
ICSPMON ENABLED|DISABLED [PORT]................................................................................................................................ 107
IMPORT CONFIG .................................................................................................................................................................. 107
IMPORT IRL.......................................................................................................................................................................... 107
IMPORT KIT ......................................................................................................................................................................... 107
IMPORT TKN ........................................................................................................................................................................ 108
IP STATUS ........................................................................................................................................................................... 108
IPDD ..................................................................................................................................................................................... 108
JAVA SECURITY ................................................................................................................................................................... 108
LIST AUDIT FILES ................................................................................................................................................................ 108
LIST AUDIT SERVERS........................................................................................................................................................... 108
LOG FORMAT ........................................................................................................................................................................ 108
MAIL RESET ......................................................................................................................................................................... 108
MAIL STATUS....................................................................................................................................................................... 108
MANAGE FIRMWARE ............................................................................................................................................................ 108
MEM ..................................................................................................................................................................................... 108
MSG ON|OFF......................................................................................................................................................................... 109
MSG STATS .......................................................................................................................................................................... 109
NDP ...................................................................................................................................................................................... 109
NETLINX LOG LEVEL............................................................................................................................................................. 109
OFF [D:P:S or NAME,CHAN] .................................................................................................................................................. 109
ON [D:P:S or NAME,CHAN] ................................................................................................................................................... 109
PASS [D:P:S or NAME].......................................................................................................................................................... 110
PHYSICAL STATUS............................................................................................................................................................... 110
PING [ADDRESS] .................................................................................................................................................................. 110
PROGRAM (ENABLE|DISABLE|STATUS) .............................................................................................................................. 110
PROGRAM INFO.................................................................................................................................................................... 110
PULSE [D:P:S or NAME,CHAN].............................................................................................................................................. 110
PWD ..................................................................................................................................................................................... 110
REBOOT ................................................................................................................................................................................ 110
REMOVE AUDIT SERVER [D:P:P]........................................................................................................................................... 111
RENEW DHCP ....................................................................................................................................................................... 111
REPORT FIRMWARE ............................................................................................................................................................. 111
REPORT NETLINX ................................................................................................................................................................. 111
RESETADMINPASSWORD..................................................................................................................................................... 111
RESET FACTORY................................................................................................................................................................... 111
ROUTE MODE DIRECT|NORMAL ........................................................................................................................................... 111
SELINUX STATUS................................................................................................................................................................. 111
SEND_COMMAND D:P:S or NAME,COMMAND ....................................................................................................................... 111
SEND_LEVEL <D:P:S>,<LEVEL ID>,<LEVEL VALUE>............................................................................................................ 111
SEND_STRING D:P:S or NAME,STRING ................................................................................................................................ 111
SET DATE ............................................................................................................................................................................. 111
SET DEVICE REBOOT ............................................................................................................................................................ 111
SET DNS <D:P:S> ................................................................................................................................................................. 112
SET DUET MEMORY .............................................................................................................................................................. 112
SET FTP PORT ...................................................................................................................................................................... 112
SET HTTP PORT.................................................................................................................................................................... 112
SET HTTPS PORT.................................................................................................................................................................. 112
SET HTTPS REDIRECT .......................................................................................................................................................... 112
SET ICSLAN.......................................................................................................................................................................... 113
SET ICSP PORT .................................................................................................................................................................... 113
SET ICSP TCP TIMEOUT....................................................................................................................................................... 113
SET IP <D:P:S> .................................................................................................................................................................... 113
SET LOCKOUT....................................................................................................................................................................... 113
SET LOG COUNT ................................................................................................................................................................... 114
SET NOTIFY THROTTLE ........................................................................................................................................................ 114
SET OCSP URL ...................................................................................................................................................................... 114
SET QUEUE SIZE .................................................................................................................................................................. 114
SET SELF SIGNED CERTIFICATE .......................................................................................................................................... 114
SET SSH PORT ...................................................................................................................................................................... 114
SET SYSTEM NUMBER .......................................................................................................................................................... 115
SET TELNET PORT ................................................................................................................................................................ 115
SET THRESHOLD .................................................................................................................................................................. 115
SET TIME.............................................................................................................................................................................. 115
SET TIMELINE LOOPCNT...................................................................................................................................................... 115
SET UDP BC RATE ................................................................................................................................................................ 115
SET URL <D:P:S> ................................................................................................................................................................. 116

NX-Series Controllers - WebConsole & Programming Guide 9

 Table of Contents

SHOW AUDIT [FILENAME] ................................................................................................................................................... 116

SHOW AUDIT LOG ................................................................................................................................................................ 116
SHOW BUFFERS ................................................................................................................................................................... 116
SHOW COMBINE................................................................................................................................................................... 116
SHOW DEVICE <D:P:S> ........................................................................................................................................................ 117
SHOW HTTPS REDIRECT ...................................................................................................................................................... 117
SHOW LOG............................................................................................................................................................................ 117
SHOW MAX BUFFERS ........................................................................................................................................................... 118
SHOW MEM .......................................................................................................................................................................... 118
SHOW NOTIFY ...................................................................................................................................................................... 118
SHOW REMOTE..................................................................................................................................................................... 118
SHOW ROUTE ....................................................................................................................................................................... 118
SHOW START LOG <START>................................................................................................................................................ 118
SHOW SYSTEM <S> ............................................................................................................................................................. 119
SHOW TCP............................................................................................................................................................................ 119
SHOW WATCHDOG ............................................................................................................................................................... 119
START LOG (ON|OFF) ........................................................................................................................................................... 119
TIME..................................................................................................................................................................................... 119
TOD ADJUSTMENTS ............................................................................................................................................................. 119
URL LIST <D:P:S> ................................................................................................................................................................ 119
USB LOG [front|back] [enable|disable]............................................................................................................................... 119
ZEROCONF
[ENABLE|DISABLE|STATUS]............................................................................................................................................. 119
ESC Pass Codes .................................................................................................................................. 120
+ + ESC ESC ......................................................................................................................................................................... 120
+ + ESC A ............................................................................................................................................................................. 120
+ + ESC D ............................................................................................................................................................................. 120
+ + ESC H............................................................................................................................................................................. 120
Using the ICSLAN Network ................................................................................................................. 120
DHCP Server...................................................................................................................................................... 120
Opening LAN and ICSLAN Sockets from Code.................................................................................................. 120
Accessing the Security Configuration Options ............................................................ 121
Setup Security Menu .................................................................................................... 122
Enabling LDAP via the Program Port .................................................................................................. 123
Security Options Menu........................................................................................................................ 124
Edit User Menu.................................................................................................................................... 125
Edit Device Menu................................................................................................................................. 125
Edit Role Menu .................................................................................................................................... 126
Access Rights Menu............................................................................................................................ 126
Adding a Role.................................................................................................................................................... 127
Default Security Configuration ........................................................................................................... 127
Telnet Diagnostics Commands..................................................................................... 128
PHYSICAL STATUS............................................................................................................................................................... 128
MSG STATS .......................................................................................................................................................................... 128
Logging Out of a Terminal Session............................................................................... 128
Notes on Specific Telnet/Terminal Clients .................................................................. 128
Windows Client Programs .................................................................................................................. 128
Linux Telnet Client .............................................................................................................................. 128
Appendix A: LDAP Implementation Details ...................................................129
Overview ....................................................................................................................... 129
Changes to LDAP Implementation (v1.4.x) ................................................................. 129
Active Directory/OpenLDAP Setup ..................................................................................................... 129

NX-Series Controllers - WebConsole & Programming Guide 10

 Table of Contents

Changes to LDAP Implementation (v1.5.x).................................................................. 130

User Query Attribute........................................................................................................................... 130
FTP Access with LDAP Authentication ................................................................................................ 130
SSH Access with LDAP Authentication ............................................................................................... 130
Assumptions and Prerequisites ................................................................................... 131
Example - Setting Up User's Access Rights ................................................................. 132
Administrator Access Example........................................................................................................... 132
User Access Example.......................................................................................................................... 132
Appendix B: Certificates ................................................................................133
Overview ....................................................................................................................... 133
Certificate Information................................................................................................. 134
Creating an HTTPS KeyStore........................................................................................ 135
Step 1: Create the private key ............................................................................................................ 135
Step 2: Generate a CSR request ......................................................................................................... 135
Step 3: Send the master.csr file to the CA to have it signed. ............................................................. 135
Step 4: Import the newly signed certificate into the KeyStore .......................................................... 135
Step 5: Upload amxcert to the NX as HTTPS KeyStore and reboot the NX ........................................ 135
Creating & Installing Self-Signed HTTPS KeyStore ..................................................... 136
Generating a Self-Signed KeyStore .................................................................................................... 136
Installing a Self-Signed KeyStore....................................................................................................... 136
Creating/Updating the Duet TrustStore ...................................................................... 138
Acquiring/Installing Public Certificates ...................................................................... 139
Appendix C: SMTP Support .......................................................................... 140
Overview ....................................................................................................................... 140
SMTP Server Configuration .......................................................................................... 140
Sending Mail ................................................................................................................. 141
Appendix D: Clock Manager NetLinx Programming API .............................. 142
Types/Constants .......................................................................................................... 142
Library Calls.................................................................................................................. 142
CLKMGR_IS_NETWORK_SOURCED().................................................................................................................................... 142
CLKMGR_SET_CLK_SOURCE(CONSTANT INTEGER MODE).................................................................................................. 142
CLKMGR_IS_DAYLIGHTSAVINGS_ON() ............................................................................................................................... 142
CLKMGR_SET_DAYLIGHTSAVINGS_MODE(CONSTANT INTEGER ONOFF)........................................................................... 142
CLKMGR_GET_TIMEZONE() ................................................................................................................................................. 142
CLKMGR_SET_TIMEZONE(CONSTANT CHAR TIMEZONE[]) ................................................................................................. 142
CLKMGR_GET_RESYNC_PERIOD() ....................................................................................................................................... 142
CLKMGR_SET_RESYNC_PERIOD(CONSTANT INTEGER PERIOD) ......................................................................................... 142
CLKMGR_GET_DAYLIGHTSAVINGS_OFFSET(CLKMGR_TIMEOFFSET_STRUCT T)............................................................... 142
CLKMGR_SET_DAYLIGHTSAVINGS_OFFSET(CONSTANT CLKMGR_TIMEOFFSET_STRUCT T) ............................................ 142
CLKMGR_GET_ACTIVE_TIMESERVER(CLKMGR_TIMESERVER_STRUCT T) ......................................................................... 142
CLKMGR_SET_ACTIVE_TIMESERVER(CONSTANT CHAR IP[])............................................................................................. 142
CLKMGR_GET_TIMESERVERS(CLKMGR_TIMESERVER_STRUCT T[]) .................................................................................. 143
CLKMGR_ADD_USERDEFINED_TIMESERVER(CONSTANT CHAR IP[], CONSTANT CHAR URL[],
CONSTANT CHAR LOCATION[]) ........................................................................................................................................ 143
CLKMGR_DELETE_USERDEFINED_TIMESERVER(CONSTANT CHAR IP[]) ............................................................................ 143
CLKMGR_GET_START_DAYLIGHTSAVINGS_RULE() ............................................................................................................ 143
CLKMGR_SET_START_DAYLIGHTSAVINGS_RULE(CONSTANT CHAR RECORD[])................................................................ 143

NX-Series Controllers - WebConsole & Programming Guide 11

 Table of Contents

CLKMGR_GET_END_DAYLIGHTSAVINGS_RULE() ................................................................................................................ 144

CLKMGR_SET_END_DAYLIGHTSAVINGS_RULE(CONSTANT CHAR RECORD[]).................................................................... 144

NX-Series Controllers - WebConsole & Programming Guide 12

 Overview

Overview
NetLinx NX Integrated Controllers
NetLinx NX Integrated Controllers (Masters) can be programmed to control RS-232/422/485, Relay, IR/Serial, and Input/Output
devices using the NetLinx Studio application (version 4.0 or higher).
NetLinx NX Integrated Controllers
Name Description
NX-1200 NetLinx NX Integrated Controller
NX-2200 NetLinx NX Integrated Controller
NX-3200 NetLinx NX Integrated Controller
NX-4200 NetLinx NX Integrated Controller

NOTE: Refer to the Products > Central Controllers > NetLinx NX Integrated Controllers page at www.amx.com for details and
variations available for these products.
NX controllers feature an on-board Web Console which allows you to connect to the NX controller via a web browser and make
various configuration and security settings. The WebConsole is described in this document (starting with the On-Board WebConsole
User Interface section on page 34).
NX controllers are Duet-compatible and can be upgraded via firmware. Duet is a dual-interpreter firmware platform from AMX which
combines the proven reliability and power of NetLinx with the extensive capabilities of the Java® MicroEdition (Java Standard
Edition Embedded) platform. Duet simplifies the programming of a system that includes the NX controller and other third party
devices by standardizing device and function definitions, defaulting touch panel button assignments, and controlling feedback
methods.
Dynamic Device Discovery makes integration even easier by automatically identifying and communicating with devices which
support this beaconing technology.

Enova DVX All-in-One Presentation Switchers

Enova Digital Media Switchers
Name Description
DVX-3250HD 10x4 All-In-One Presentation Switchers with NX Control (Multi-Format, HDMI Inputs)
DVX-3255HD 10x4 All-In-One Presentation Switchers with NX Control (Multi-Format, HDMI, 2 DXLink Inputs)
DVX-3256HD 10x4 All-In-One Presentation Switchers with NX Control (Multi-Format, HDMI, 4 DXLink Inputs)
DVX-2250HD 6x3 All-In-One Presentation Switchers with NX Control (Multi-Format, HDMI Inputs)
DVX-2255HD 6x3 All-In-One Presentation Switchers with NX Control (Multi-Format, HDMI, DXLink Inputs)
DVX-2210HD 4x2 All-In-One Presentation Switchers with NX Control (Multi-Format, HDMI Inputs)

NOTE: Refer to the Products > All-in-One Presentation Switchers page at www.amx.com for details and variations available for these
products.
Enova DVX-22xxHD & DVX-325xHD
Enova DVX-22xxHD All-in-One Presentation Switchers utilize an NX-2200 Controller, therefore all controller-related information
that applies to the NX-2200 is fully applicable to DVX-22xxHD products.
Enova DVX-325xHD All-in-One Presentation Switchers utilize an NX-3200 Controller, therefore all controller-related information
that applies to the NX-3200 is fully applicable to DVX-325xHD products.
Enova DVX All-In-One Presentation Switchers features many functions that do not apply to NX-series Controllers, most of
which relate directly to the Audio/Video capabilities of the DVX.
Refer to the Enova DVX-325xHD/22xxHD All-in-One Presentation Switchers Instruction Manual for information specific to
Enova DVX products.

NX-Series Controllers - WebConsole & Programming Guide 13

 Overview

Enova DGX Digital Media Switchers

Enova Digital Media Switchers
Name Description
DGX8-ENC Enova DGX 8 Enclosure
DGX16-ENC Enova DGX 16 Enclosure
DGX32-ENC-A Enova DGX 32 Enclosure
DGX64-ENC Enova DGX 64 Enclosure

NOTE: Refer to the Products > Digital Media Switchers page at www.amx.com for details and variations available for these products.

Massio™ ControlPads
Massio ControlPads
Name Description
MCP-106 6-Button Massio ControlPad
MCP-108 8-Button Massio ControlPad

NOTE: Refer to the Products > ControlPads page at www.amx.com for details and variations available for these products.

About This Document

This document describes using the on-board WebConsole, as well as NetLinx send commands and terminal communications to
configure the NX controllers:
Each major section of the WebConsole is described in a separate section of this document. Refer to:
the On-Board WebConsole User Interface section on page 34,
the WebConsole - Network Options section on page 46,

the WebConsole - Security Options section on page 41,

the WebConsole - System Options section on page 57, and

the WebConsole - Switching Options section on page 67.)

The Initial Conf iguration and Firmware Upgrade section on page 5 describes upgrading the firmware on NX controllers.
The NetLinx Programming section on page 82 lists and defines the NetLinx send commands that are supported by the NX
controllers.
The Terminal (Program Port/Telnet) Commands section on page 104 describes the commands and options available via a
Telnet terminal session with the NX controller.

Differences in DEFINE_PROGRAM Program Execution

Due to differences in the underlying architecture of the X-Series masters, changing variables in the DEFINE_PROGRAM section of
code can negatively impact program performance. It has always been considered poor programming practice to change a variable
within the DEFINE_PROGRAM section of code. If you have legacy NetLinx code that does change a variable in this section it’s very
likely that timing differences will cause your code to run slower and appear less responsive on an NX-Series controller and can have
other adverse effects on platform reliability in the area of connectivity and data throughput.
The DEFINE_PROGRAM section of NetLinx code contains the code known as mainline. Mainline is the section of the program that is
executed on a periodic basis by the NetLinx Master Controller. Under normal operation, the DEFINE_PROGRAM section executes at
least once every half second. Various system activities can cause the DEFINE_PROGRAM section to execute more frequently than
every half second. For example, any time an external event occurs (button push, level change), the DEFINE_PROGRAM section must
re-execute to ensure that any change caused by the event processes through the DEFINE_PROGRAM section code block. This is
also the case for changes to global variables. Any variable change requires the DEFINE_PROGRAM section to re-execute to process
the new variable value through the DEFINE_PROGRAM code block.
Because high CPU usage can be detrimental to the system functionality on an NX master, AMX recommends the complete
deprecation of the DEFINE_PROGRAM section. Syntactically, it is still valid to use the DEFINE_PROGRAM section in your NetLinx
application, but it is no longer recommended. All logic that you would normally place in the DEFINE_PROGRAM section is handled
better in the DEFINE_EVENT section.
Feedback statements remain the most common usage in the DEFINE_PROGRAM section. Because of periodically executing
DEFINE_PROGRAM, you can rely on the program to update user feedback at a regular interval. However, if the DEFINE_PROGRAM
section executes too frequently with the needless iterations expending the CPU to repetitively evaluate the feedback statements.
TIMELINE_EVENTS provide a much more efficient mechanism for evaluating feedback statements. A single timeline triggering every
500ms provides the same periodic execution as the DEFINE_PROGRAM section without the unwanted recursive execution behavior.
Consider the following DEFINE_PROGRAM section containing feedback statements in PRGM EX. 1:
DEFINE_PROGRAM
[dvTP,1] = [dvDev,1]
[dvTP,2] = value1
[dvTP,3] = ![dvTP,3]
PRGM EX. 1 DEFINE_PROGRAM with feedback statements

NX-Series Controllers - WebConsole & Programming Guide 14

 Overview

The code in PRGM EX. 1 would be better implemented using a timeline, as illustrated in PRGM EX. 2:
DEFINE_CONSTANTS
LONG FEEDBACK_TIMES[1] = {500}
INTEGER FEEDBACK_TIMELINE = 1
DEFINE_START
TIMELINE_CREATE(FEEDBACK_TIMELINE, FEEDBACK_TIMES, 1, TIMELINE_RELATIVE, TIMELINE_REPEAT)
DEFINE_EVENT
TIMELINE_EVENT[FEEDBACK_TIMELINE]
{
[dvTP,1] = [dvDev,1]
[dvTP,2] = value1
[dvTP,3] = ![dvTP,3]
}
PRGM EX. 2 Using feedback statements in a timeline
The code in PRGM EX. 2 evaluates the feedback statements every half second regardless of other program activity. If a shorter
feedback refresh is needed, you can specify a smaller constant in the FEEDBACK_TIMES constant. Even a time of 100ms executes
far less frequently than a DEFINE_PROGRAM section stuck in an infinite execution loop due to a global variable change.
By moving all code out of the DEFINE_PROGRAM section, you ensure your NetLinx application is executing only when needed, and
therefore not expending unnecessary CPU cycles.
If you choose to continue to use the DEFINE_PROGRAM section, it is critical that you ensure that you are not modifying a variable
within the section. Any variable change will force a repeated execution of the section, thereby creating an infinite execution loop.
Variables should never fall on the left-hand side of an evaluation statement, as in PRGM EX. 3.
DEFINE_PROGRAM
Var1 = !Var1
PRGM EX. 3 Variable declared within the DEFINE_PROGRAM section
You must also take care to not inadvertently change a variable. For example, if a function is called within DEFINE_PROGRAM, then
that function must likewise not change a global variable. Additionally, accessing global “values” such as TIME and DATE constitute
a variable change. Take for example the code in PRGM EX. 4:
IF (TIME = ’22:00:00’)
{…}
PRGM EX. 4 Time check
At first glance, this code does not appear to change a variable. It is simply checking to see if the current time is equal to 22:00:00.
However, this code effectively changes the TIME variable by retrieving the current system time and assigning it to the TIME variable.
If this code were present in a DEFINE_PROGRAM section, it would infinitely re-execute the DEFINE_PROGRAM section. You should
place evaluations such as this in a TIMELINE_EVENT similar to the feedback timeline described earlier.
CPU Usage
The new NX masters provide several diagnostics that can be used to determine if your program is overloading the CPU and, if so,
what might be causing its excessive use. All of these commands are accessible through a Telnet or USB terminal connection with
the master.
>cpu usage
Gathering CPU usage over a 10 second period. Please wait ...
CPU usage = 2.10% over a 10 second period.
An idle application normally runs below 5% of the CPU. If your idle application shows more usage than this, then it is probable that
your application is experiencing excessive execution of the DEFINE_PROGRAM section.
You can use the following diagnostic to diagnose executions of the DEFINE_PROGRAM section:
>superuser 10
>enable interp stats
>show interp stats

-- Mainline Executions due to:

Variable Change : 0
Pending Int Event : 0
Pulse Expiration : 0
Hold Expiration : 0
DoPush Expiration : 0
Wait Expiration : 0
Until Expiration : 0
Timeline Expiration : 0
Periodic Mainline : 0
Current internal event count = 0

NX-Series Controllers - WebConsole & Programming Guide 15

 Overview

These statistics indicate how many times mainline has been executed and why it has been executed. Repeatedly executing “show
interp stats” will give you an idea which code construct is causing mainline to execute. For example, if a variable is being changed,
you will see the “Variable Change” count increasing. If a timeline is firing quickly, you will see the TIMELINE_EXPIRATION count
increasing. A normal idle application that is executing DEFINE_PROGRAM every half second will only see the “Periodic Mainline”
count increasing.
For example, consider this diagnostic output from a NetLinx application that is changing a variable in DEFINE_PROGRAM:
>show interp stats

-- Mainline Executions due to:

Variable Change : 50927
Pending Int Event : 1
Pulse Expiration : 0
Hold Expiration : 0
DoPush Expiration : 0
Wait Expiration : 0
Until Expiration : 0
Timeline Expiration : 0
Periodic Mainline : 0
Current internal event count = 1

>show interp stats

-- Mainline Executions due to:

Variable Change : 62295
Pending Int Event : 1
Pulse Expiration : 0
Hold Expiration : 0
DoPush Expiration : 0
Wait Expiration : 0
Until Expiration : 0
Timeline Expiration : 0
Periodic Mainline : 0
Current internal event count = 0

>show interp stats

-- Mainline Executions due to:

Variable Change : 72386
Pending Int Event : 1
Pulse Expiration : 0
Hold Expiration : 0
DoPush Expiration : 0
Wait Expiration : 0
Until Expiration : 0
Timeline Expiration : 0
Periodic Mainline : 0
Current internal event count = 1
Notice the “Variable Change” count is increasing rapidly.
These diagnostics will not tell you where in your application the offending code resides. Finding the offending code requires a
process of code analysis and possibly selectively commenting out sections of code to isolate the offender.
NOTE: NetLinx modules each have a DEFINE_PROGRAM section that must abide by the same rules as the main program, so the
offending code could be in a module.

NX-Series Controllers - WebConsole & Programming Guide 16

 Overview

Quick Setup and Conf iguration Overview

Installation Procedures
The general steps involved with most common installations of this device include:
Unpack and confirm the contents of box (see the Specif ications tables in the Hardware Reference Guide for each controller).
Connect all rear panel components and supply power to the NX controller from the external power supply.
Conf iguration and Communication
The general steps involved with setting up and communicating with the NX controller’s on-board Master. In the initial
communication process:
Set the boot-time operations on the rear Configuration DIP switch. (The DIP switch is located on the front panel of the
NX-1200.)
Connect and communicate with the on-board Master via the Program port.
Set the System Value being used with the on-board Master.
Re-assign any Device values.
Retrieve the DHCP Address for the on-board Master or assign a Static IP to the on-board Master.
Once the IP information is determined, re-work the parameters for Master Communication to connect to the on-board
Master via the LAN and not the Program port.
Update the On-board Master and Controller Firmware
Before using your new NX controller, you must first update your NetLinx Studio to the most recent release.
Upgrade the Integrated Controller firmware through an IP address via the LAN connector (Upgrading Firmware section on
page 28) (IP recommended).
Upgrade the on-board Master firmware through an IP address via the LAN connector (Upgrading Firmware section on
page 28) (IP recommended).
Conf igure NetLinx Security on the NX Controller
Setup and finalize your NetLinx Security Protocols (WebConsole - Security Options section on page 41).
Program your NX controller (NetLinx Programming section on page 82).

Using Zero Conf iguration

NetLinx Masters support using "zero-configuration" client software to quickly install multiple devices on the network.
Bonjour (Zero-Conf iguration) Client
You can use a zero-configuration client to determine the IP address of the Controllers. There are many zero-configuration clients
available which are free and widely available for download. NetLinx Studio includes a zero-configuration client which we will use for
the purposes of this document.
If you don’t already have it installed on your PC, download and install NetLinx Studio 4.0 before you begin.
Connecting to a Network with a DHCP Server
By using the Controller’s Zeroconf feature and the NetLinx Studio, you can install and configure multiple devices on the network
without pre-configuring each device before installation.
The dealer only needs to match the serial number printed on the backside of the device or from the label on the box to the serial
number that is displayed in the Bonjour browser pane.
1. Launch NetLinx Studio 4.0.
2. Once power is applied to the device, select the Zero-Config tab on the Workspace bar (see FIG. 1).

FIG. 1 Zero-Config tab

NX-Series Controllers - WebConsole & Programming Guide 17

 Overview

3. In the Workspace area, right-click and select Refresh Zero Conf ig List. The controller appears in the list of devices as shown in
FIG. 2:

FIG. 2 Workspace bar (Zero-Config tab selected)

4. Double-click the Master you want to access it in the WebConsole.
Accessing the Master requires valid login information. The browser will prompt you for User ID and Password before displaying
the configuration pages for the selected device.
Note that the serial number is appended to the name of the device.
After logging in, you can configure the device (changing IP settings, NetLinx settings, User settings, etc) via the pages in the
WebConsole (see the On-Board WebConsole User Interface section on page 34).

NX-Series Controllers - WebConsole & Programming Guide 18

 Initial Configuration

Initial Conf iguration

Overview
This section describes using the NetLinx Studio software application to perform the initial configuration of the NetLinx Master.
NetLinx Studio is used to setup a System number, obtain/assign the IP/URL for the NX controller, as described in this section (as
well as to transfer firmware Kit files to the Master - see the Upgrading Firmware section on page 28).

Before You Start

1. Verify you have the latest version of the NetLinx Studio application version 4.0 installed on your PC.
NetLinx Studio is available to download from www.amx.com. Login to download the latest version. Alternatively, if it is already
installed, use the Web Update option in NetLinx Studio’s Help menu to obtain the latest version.
The default location for the NetLinx Studio application is Start > Programs > AMX Control Disc > NetLinx Studio > NetLinx
Studio.
2. Verify that a LAN cable is connected from the Master to the LAN Hub.
3. Connect a programming cable (Type-B USB) from the Program Port on the Master to a USB port on the PC being used for
programming.
4. Apply power to the Master.

Preparing the Master for USB Communication

To establish USB communication with the Master via the PROGRAM port with Type-B-to-Type-A cable:
1. Launch NetLinx Studio and select Settings > Workspace Communication Settings (FIG. 3):

FIG. 3 NetLinx Studio menu bar - Settings > Workspace Communication Settings
2. This opens the Workspace Communication Settings dialog (FIG. 4).

FIG. 4 Workspace Communication Settings dialog

NX-Series Controllers - WebConsole & Programming Guide 19

 Initial Configuration

3. Click the System Settings button to open the Communications Settings dialog (FIG. 5). If there is no system selected, click the
Default Settings button to open the dialog.

FIG. 5 Communication Settings dialog - Recent tab

4. Select the USB tab to view the USB options (FIG. 6).

FIG. 6 Communications Settings dialog - USB tab

5. On the USB tab, highlight the Master you want to connect to and click Select.
6. Click Edit to open the Edit USB Master’s Username/Password dialog to set the user name and password for authentication
access to the Master. This step is optional. You can only change the user name and password in the dialog. The additional
fields are view-only.
7. Click OK to close the USB Master’s Username/Password dialog, and click OK in the Communication Settings dialog to return to
the Communication Settings dialog, now indicating the USB-connected Master as the current connection configuration.
8. Click OK to close the Communication Settings dialog and return to the main application.

NX-Series Controllers - WebConsole & Programming Guide 20

 Initial Configuration

9. Right-click the Online Tree tab entry and select Refresh System: the Controller should appear in the Device Tree (FIG. 7):

FIG. 7 Workspace Bar - Online Tree

NOTE: If the Master does not appear in the list, verify that the USB cable is connected properly.
Once USB communication has been established, use NetLinx Studio to configure the Controller for LAN Communication, as
described in the next section.

Conf iguring the NX Controller for LAN Communication

1. Use a LAN cable to connect the Controller to the LAN to which the PC running NetLinx Studio is connected.
2. Select Diagnostics > Network Addresses from the menu bar to open the Network Addresses dialog (FIG. 8). Use the options in
this dialog to select to either use DHCP or specify an IP address.

FIG. 8 Network Addresses dialog

NX-Series Controllers - WebConsole & Programming Guide 21

 Initial Configuration

3. Click Get IP Information to enable the fields for editing (FIG. 9):

FIG. 9 Network Addresses dialog showing initial IP information

4. Enter the System, Device (0 for NetLinx Masters), and Host Name information.
NOTE: Host names may contain only the ASCII letters 'a' through 'z' (in a case-insensitive manner), the digits '0' through '9', and the
hyphen ('-').
5. To configure a network address via DHCP (FIG. 10):

FIG. 10 Network Addresses dialog (DHCP)

a. Select Use DHCP.
b. Click Set IP Information to retain the DHCP setting.
c. To finish the process, click Reboot Device.
d. Click Done to close the dialog.
6. To specify a network IP address (FIG. 11):

FIG. 11 Network Addresses dialog (Specify IP Address)

a. Select Specify IP Address.
b. Enter the IP parameters into the available fields.
c. Click Set IP Information to retain the pre-reserved IP address to the Master.
d. To finish the process, click Reboot Device.
e. Click OK to close the dialog.

NX-Series Controllers - WebConsole & Programming Guide 22

 Initial Configuration

7. Repeat steps 1 - 5 from the previous section, but rather than selecting the USB tab, select Network and edit the settings to
match the IP address you are using (Static or Dynamic).
8. If you want the Master to require authentication for access, enter a User Name and Password in the provided fields to secure
the Master.
9. Click the OK to close all dialogs and return to the main application.

Obtaining the NX Controller’s IP Address (using DHCP)

NOTE: Verify there is an active LAN connection on the NX controller’s LAN port before beginning these procedures.
1. In NetLinx Studio, select Diagnostics > Network Addresses from the Main menu to access the Network Addresses dialog
(FIG. 12).

FIG. 12 NetLinx Studio: Network Addresses dialog

2. Verify that both the System number corresponds to the System value previously assigned within the Device Addressing tab
and that zero (0) is entered into the Device field.
NOTE: The system value must correspond to the Device Address entered in the Device Addressing dialog. Refer to the Manage System
- System Number section on page 46 for more detailed instructions on setting a system value.
3. Click Get IP Information to enable the Use DHCP and Specify IP Address options.
4. Select Use DHCP.
NOTE: DO NOT enter ANY IP information at this time; this step only gets the System Master to recognize that it should begin using an
obtained DHCP Address.
5. Click Reboot Device.
6. After the device has booted, repeat steps 1-3.
7. Note the obtained IP address (read-only). This information is later entered into the Communication Settings dialog and used
by NetLinx Studio to communicate to the NX controller via an IP. This address is reserved by the DHCP server and then given to
the Master.
NOTE: If the IP Address f ield is empty, give the Master a few minutes to negotiate a DHCP Address with the DHCP Server, and try
again. The DHCP Server can take anywhere from a few seconds to a few minutes to provide the Master with an IP address.
NOTE: Verify that these IP values are also entered into the related f ields within either the IP Settings section of the System
Connection page (on the touch panel) or within the Address f ield on the web browser.
8. Click Done to close the dialog.
NOTE: On the front panel of the NetLinx Master, the STATUS and OUTPUT LEDs should begin to alternately blink during the
incorporation. Wait until the STATUS LED is the only LED to blink.
Complete the communication process by continuing on to the Communicating via IP Address section on page 25.

NX-Series Controllers - WebConsole & Programming Guide 23

 Initial Configuration

Assigning a Static IP to the NX Controller

NOTE: Verify there is an active LAN connection on the LAN port of the Master before beginning these procedures.
1. In NetLinx Studio, select Diagnostics > Network Addresses to open the Network Addresses dialog (FIG. 13):

FIG. 13 NetLinx Studio: Network Addresses dialog

2. Verify that both the System number corresponds to the System value previously assigned within the Device Addressing tab
and that zero (0) is entered into the Device field.
NOTE: The system value must correspond to the Device Address previously entered in the Device Addressing tab. Refer to the Manage
System - System Number section on page 46 for more detailed instructions on setting a system value.
3. Click the Get IP Information button to enable the Use DHCP and Specify IP Address options.
4. Select Specify IP Address to enable the IP fields for editing (FIG. 14):

FIG. 14 NetLinx Studio: Network Addresses dialog (Specify IP Address)

5. Enter the IP Address, Subnet Mask, and Gateway information into their respective fields (as defined by the System
Administrator).
NOTE: Verify that these IP values are also entered into the related f ields within either the IP Settings section of the System
Connection page (on the touch panel) or within the Address f ield on the web browser.
6. Click Set IP Information to cause the on-board Master to retain this new IP address.
7. Click Reboot Master.
8. Click Done to close the dialog.
NOTE: On the front panel of the NetLinx Master, the STATUS and OUTPUT LEDs should begin to alternately blink during the
incorporation. Wait until the STATUS LED is the only LED to blink.
Complete the communication process by continuing on to the Communicating via IP Address section on page 25.

NX-Series Controllers - WebConsole & Programming Guide 24

 Initial Configuration

Communicating via IP Address

Whether the on-board Master’s IP address was set or obtained via DHCP, use the IP address information from the Network
Addresses dialog to establish communication via the LAN-connected Master.
1. Use NetLinx Studio to obtain the IP address of the NX controller. If you do not have an IP address, follow the steps outlined in
either the Obtaining the NX Controller’s IP Address (using DHCP) section on page 23, or the Assigning a Static IP to the NX
Controller section on page 24.
2. Select Settings > Workspace Communication Settings from the Main menu to open the Workspace Communication Settings
dialog (FIG. 15):

FIG. 15 NetLinx Studio - Workspace Communication Settings dialog

3. Click System Settings to open the Communications Settings dialog. If you do not have a system selected, click the Default
Settings button (FIG. 16).

FIG. 16 NetLinx Studio - Communication Settings dialog (TCP/IP selected)

NX-Series Controllers - WebConsole & Programming Guide 25

 Initial Configuration

4. Select the Network tab (FIG. 17).

FIG. 17 Communications Settings dialog - Network tab

5. Click New to open the New TCP/IP Setting dialog. In this dialog, you can enter both a previously obtained DHCP or static IP
address and an associated Description for the connection into their respective fields. (FIG. 18):

FIG. 18 NetLinx Studio - New TCP/IP Setting dialog

Verify that the Automatically Ping the Master Controller to ensure availability option is selected to make sure the Master is
initially responding on-line before establishing full communication.
If the authentication is required for connecting to the Master at this address, enter a User Name and Password in the text
fields provided.
6. Click OK to close the New TCP/IP Settings dialog and return to the Communication Settings dialog: (FIG. 19).

FIG. 19 NetLinx Studio - Communication Settings dialog

a. Click on the new IP address entry in the List of Addresses window
b. Click Select to use the selected IP address as the current IP address.

NX-Series Controllers - WebConsole & Programming Guide 26

 Initial Configuration

7. Click OK to save your newly entered information and close the Communication Settings dialog and return to the
Communication Settings dialog. Note the selected IP address is indicated in the Conf iguration field (FIG. 20):

FIG. 20 NetLinx Studio - Communication Settings dialog (Current Master Connection field indicating the selected IP address)
8. Click OK to begin the communication process to your Master (and close the dialog).
If you are currently connected to a Master, a pop-up asks whether you would want to stop communication to the current
Master and apply the new settings.
Click Yes to interrupt the current communication from the Master and apply the new settings.
NOTE: On the front panel of the NetLinx Master, the STATUS and OUTPUT LEDs should begin to alternately blink during the
incorporation. Wait until the STATUS LED is the only LED to blink.
9. Click the OnLine Tree tab in the Workspace window to view the devices on the System. The default System value is one (1).
10. Right-click the associated System number and select Refresh System. This establishes a new connection to the specified
System and populates the list with devices on that system. The communication method is then highlighted in green on the
bottom of the NetLinx Studio window.
NOTE: If the connection fails to establish, a Connection Failed dialog appears. Try selecting a different IP address if communication
fails. Press the Retry button to reconnect using the same communication parameters. Press the Change button to alter your
communication parameters and repeat the steps above.

NX-Series Controllers - WebConsole & Programming Guide 27

 Upgrading Firmware

Upgrading Firmware
Overview
The basic process of upgrading firmware on NX-series controllers involves downloading the latest firmware files from
www.amx.com and using NetLinx Studio to transfer the files to a target NX controller.
Use the OnLine Device tree in NetLinx Studio to view the firmware files currently loaded on the Central Controller. FIG. 21 shows an
example OnLine Tree indicating an NX-3200:

FIG. 21 NetLinx Studio - Sample OnLine Tree

While the method of upgrading firmware files is the same for all Central Controllers, there are some specific points relative to the
specific model and type of controller that must be noted:
NX Controllers - Firmware Files
NX controllers contain two devices (NX Master and Device Controller), each of which require a separate firmware (*.kit) file.
The NX Master firmware file is not the same as the Device Controller firmware file. These two devices must be kept at compatible
firmware versions for proper operation. Therefore, both files should be used when upgrading any firmware associated with the
Integrated Controllers.
NX Controllers - Firmware Files
NX Master Firmware The on-board NX Master is listed first in the OnLine Tree as
"00000 NX Master (<f irmware version>)"
For example, the NX Master in FIG. 21 above is "00000 - NX-3200 Master (v3.4.555)".
• "00000" represents Device ID 0, which is reserved for the Master
• The number in parenthesis (in this case "v3.4.555") is the current NX Master firmware
version.
Device Controller Firmware The Device Controller is listed next as "05001 NX-XXXX (<f irmware version>)"
For example, the Device Controller in FIG. 21 above is "05001 - NX-3200 (v1.0.35)".
• "05001" represents Device ID 5001, which is reserved for the Device Control ports.
• The number in parenthesis (in this case "v1.0.35") is the current Device Controller firmware
version.

Enova DVX
Enova DVX All-In-One Presentation Switchers contain three devices (NX Master, Device Controller, and A/V Switcher/ Scaler), each
of which require a separate Kit file. These three devices must be kept at compatible firmware versions for proper operation.
Therefore, all three files should be used when upgrading any firmware associated with the Enova DVX All-In-One Presentation
Switchers.
DVX Controllers - Firmware Files
NX Master Firmware The on-board NX Master is listed first in the Online Tree as
"00000 NX Master (<f irmware version>)"
• "00000" represents Device ID 0, which is reserved for the Master
• The number in parenthesis is the current Master firmware version.
Device Controller Firmware The Device Controller is listed next as
"05001 NX-XXXX (<f irmware version>)"
• "05001" represents Device ID 5001, which is reserved for the Device Control ports.
• The number in parenthesis is the current Device Controller firmware version.
A/V Switcher/Scaler Firmware The A/V Switcher/Scaler is listed third as
"05002 NX-XXXX (<f irmware version>)"
• "05002" represents Device ID 5002, which is reserved for the A/V Switcher/Scaler.
• The number in parenthesis is the current Device Controller firmware version.

NX-Series Controllers - WebConsole & Programming Guide 28

 Upgrading Firmware

Before You Start

1. Verify you have the latest version of the NetLinx Studio application installed on your PC.
NetLinx Studio is available to download from www.amx.com. Login to download the latest version. Alternatively, if it is already
installed, use the Web Update option in NetLinx Studio’s Help menu to obtain the latest version.
The default location for the NetLinx Studio application is Start > Programs > AMX Control Disc > NetLinx Studio > NetLinx
Studio.
2. Verify that a LAN cable is connected from the controller to the LAN Hub.
3. Verify that the controller is powered on.
4. Connect to the controller via IP address.
5. Establish what version of firmware is currently loaded on the controller (see Verifying the Current Firmware Version below).

Verifying the Current Firmware Version

Use the OnLine Tree in NetLinx Studio (see FIG. 21 on page 28) to verify which version of each firmware file is currently installed.
NOTE: These steps assume that you have already established a connection with the target Central Controller (see the Initial
Conf iguration section on page 19 for details).
1. In NetLinx Studio, click on the OnLine Tree tab (in the Workspace Bar) to view the devices on the System.
2. Click Display and select Refresh System from the context menu. This establishes a new connection to the System and
populates the device tree with devices on that system.
3. After the Communication Verif ication dialog indicates active communication between the PC and the Central Controller, verify
the Central Controller and associated devices are listed in the OnLine Tree.
4. Check the appropriate product page on www.amx.com for the latest NX Master and Device Controller firmware files for your
device.
If necessary, follow the procedures outlined in the following sections to obtain these firmware (*.kit) files from www.amx.com and
then transfer the new firmware files to the device.

Downloading the Latest Firmware Files from www.amx.com

NetLinx Integrated Controllers
NX-series Controllers require two firmware (*.kit) files: Master firmware and Device firmware. The Master firmware file is not the
same as the Device firmware file.
Both files should be used when upgrading any firmware associated with the Integrated Controllers.
IMPORTANT: The process of downloading and transferring f irmware f iles is the same for all types of f irmware. However, it is
important that the f irmware f iles are upgraded in specif ic following order for NX-series Controllers (see the Required Order of
Firmware Updates section on page 31).
Master and Device Firmware Kit Files for NX-Series Controllers
Below is a table outlining the Master and Device Firmware (*.kit) files used by NetLinx Integrated Controllers:
Master and Device Firmware Files for NX-Series Controllers
NX-4200 / 3200 / Master Firmware: SW2106_NX_X200_Master_vx_x_xxx.kit
2200 / 1200
HTTP Firmware Kit: SW2106_NX_X200_10x_vx_x_xxx-http.kit

NOTE: The HTTP f irmware kit enables you to upgrade f irmware via an HTTP server. Follow the same steps in NetLinx Studio as you
would with a typical f irmware upgrade. Upgrading f irmware via HTTP server is typically much faster than upgrading with the standard
f irmware kit f iles. See the Upgrading Firmware via NetLinx Studio section on page 31 for more information.

NX-Series Controllers - WebConsole & Programming Guide 29

 Upgrading Firmware

Downloading NX-Series Controller Firmware Files on www.amx.com

Visit the appropriate product page on www.amx.com for the latest NX Master and Device Controller firmware (*.kit) files for your NX
controller. Firmware file links are available along the right-side of the catalog page (FIG. 22):

FIG. 22 www.amx.com - sample NX Controller Firmware File links

Firmware files are bundled in a ZIP file, along with a Readme.TXT file that provides details on this firmware release.
1. Accept the AMX Licensing Agreement.
2. Download the ZIP file and unzip the contents to a known location.
Enova DVX All-In-One Presentation Switchers
Enova DVX All-In-One Presentation Switchers require an additional Switcher Firmware file for the built-in switcher. ALL files should
be used when upgrading any firmware associated with the Integrated Controllers.
NOTE: The process of downloading and transferring f irmware f iles is the same for all types of f irmware. However, it is important that
the f irmware f iles are upgraded in specif ic following order for DVX Controllers (see the Required Order of Firmware Updates for DVX
Controllers section on page 31).
Master, Switcher and Device Firmware Files for Enova DVX All-In-One Presentation Switchers
Below is a table outlining the Master, Device, and Switcher firmware (*.kit) files used by Enova DVX Controllers:
Master Firmware Kit File Usage for Enova DVX Controllers
DVX-3250/3255/3256 Master Firmware: SW2106_NX-X200_Master_v1_x_xxx.kit
2250/2255/2210HD
Device Firmware: SW2106_NX_X200_Device_v1_x_xx.kit
HTTP Firmware Kit: SW2106_NX_X200_10x_vx_x_xxx-http.kit

NOTE: The HTTP f irmware kit enables you to upgrade f irmware via an HTTP server. Follow the same steps in NetLinx Studio as you
would with a typical f irmware upgrade. Upgrading f irmware via HTTP server is typically much faster than upgrading with the standard
f irmware kit f iles. See the Upgrading Firmware via NetLinx Studio section on page 31 for more information.
Downloading Enova DVX Firmware Files on www.amx.com
Visit the appropriate product page on www.amx.com for the latest NX Master, Device Controller, and A/V Switcher/Scaler firmware
(*.kit) files for your Enova DVX All-In-One Presentation Switcher. Firmware file links are available along the right-side of the catalog
page (FIG. 23):

FIG. 23 www.amx.com - sample Enova DVX Firmware File links

Firmware files are bundled in a ZIP file, along with a Readme.TXT file that provides details on this firmware release.
1. Accept the AMX Licensing Agreement.
2. Download the ZIP file and unzip the contents to a known location.

NX-Series Controllers - WebConsole & Programming Guide 30

 Upgrading Firmware

Master and Device Firmware Kit Files for Massio ControlPads

Below is a table outlining the Master and Device Firmware (*.kit) files used by Massio ControlPads:
Master and Device Firmware Files for Massio ControlPads
MCP-106/108 Master Firmware: SW2102_MCP_10x_vx_x_xxx.kit
Device Firmware: SW2102_MCP_10x_Device_vx_xx_x.kit
HTTP Firmware Kit: SW2102_MCP_10x_vx_x_xxx-http.kit

NOTE: The HTTP f irmware kit enables you to upgrade f irmware via an HTTP server. Upgrading a Massio ControlPad to f irmware
version 1.4 or higher requires the current f irmware version on the ControlPad to be version 1.3.106 or higher. Follow the same steps
in NetLinx Studio as you would with a typical f irmware upgrade. Upgrading f irmware via HTTP server is typically much faster than
upgrading with the standard f irmware kit f iles. See the Upgrading Firmware via NetLinx Studio section on page 31 for more
information.

Required Order of Firmware Updates

The Upgrading Firmware via NetLinx Studio instructions (below) apply equally to all types of firmware files. However, it is important
that the firmware files are upgraded in the following order:
1. First, upgrade the Master firmware.
2. When that process is complete, upgrade the Device firmware.
IMPORTANT: ALWAYS consult the Readme.TXT f ile bundled with the f irmware f ile for any special instructions before upgrading to a
newer f irmware version. If no specif ics are provided, use the order provided above.
Required Order of Firmware Updates for DVX Controllers
Upgrade firmware in the following order:
1. First, upgrade the A/V Switcher/Scaler firmware.
2. When that process is complete, upgrade the Master firmware.
3. When that process is complete, upgrade the Device firmware.
IMPORTANT: ALWAYS consult the Readme.TXT f ile bundled with the f irmware f ile for any special instructions before upgrading to a
newer f irmware version. If no specif ics are provided, use the order provided above.

Upgrading Firmware via USB

All X-Series controllers support firmware upgrades via a USB solid-state drive. You can upgrade via USB by selecting the
appropriate .kit file and initiating the upgrade via telnet. The “IMPORT KIT” telnet command causes the controller to search the
attached USB drive for all valid .kit files and display the files as a list. From here you can select the .kit file to use and initiate the
firmware upgrade. See the IMPORT KIT section on page 107 for more information.

Upgrading Firmware via NetLinx Studio

NOTE: These steps assume that you have already established a connection with the target Central Controller (IP connection is
preferred.) See the Initial Conf iguration section on page 19 for details.
1. In NetLinx Studio. click on the OnLine Tree tab (in the Workspace Bar) to view the devices on the System.
2. In the OnLine Tree tab, click Display and select Refresh System from the context menu. Doing so establishes a new connection
to the System and populates the device tree with devices on that system.
3. After the Communication Verif ication dialog indicates active communication between the PC and the Central Controller, verify
the Master and associated devices (including the Device Controller) are listed in the OnLine Tree.
4. In NetLinx Studio, select Tools > Firmware Transfers > Send to NetLinx Device (FIG. 24):

FIG. 24 NetLinx Studio - Tools > Firmware Transfers > Send to NetLinx Device
This step opens the Send to NetLinx Device dialog.

NX-Series Controllers - WebConsole & Programming Guide 31

 Upgrading Firmware

5. Click the Browse button (...) to locate and select the firmware (*.kit) file that will be transferred, in the Browse for Folders
dialog (FIG. 25):

FIG. 25 NetLinx Studio - Send to NetLinx Device dialog

The selected file is indicated in the Files window.
6. Verify the target’s System number matches the value listed within the active System folder in the OnLine Tree.
The Device number is always 0 for the NX Master.
Note that the Port field is disabled (FIG. 26).

FIG. 26 Send to NetLinx Device dialog (showing on-board NX Master firmware update)
7. Click Send to begin the transfer. The file transfer progress is indicated in the Progress section of the dialog. The Master
reboots when the file transfer is complete.
8. Click Close once the Master is finished rebooting.
9. In the OnLine Tree, right-click on the Master and select Refresh System. This establishes a new connection and refreshes the
device list and their firmware versions in your system.

NX-Series Controllers - WebConsole & Programming Guide 32

 Upgrading Firmware

Once the process is complete, you can upgrade the remaining firmware files. All device files must be kept at compatible firmware
versions for proper operation. Therefore, all files should be used when upgrading any firmware associated with the Integrated
Controllers.
Be sure to follow the required order for installing firmware files. See the Required Order of Firmware Updates section on page 31 for
more information.

Resetting the Factory Default System and Device Values

1. In NetLinx Studio, access the Device Addressing dialog:
Right-click on any system device listed in the Workspace and select Device Addressing.
Select Diagnostics > Device Addressing from the Main menu.
2. Click the Set Device/System to Factory Default button (FIG. 27):

FIG. 27 Device Addressing dialog

This resets both the system value and device addresses (for definable devices) to their factory default settings. The system
information (in the OnLine Tree tab of the Workspace window) refreshes and then displays the new information.
NOTE: By setting the system to its default value (#1), Modero panels that were set to connect to the Master on another System value
will not appear in the OnLine Tree tab of the Workspace window. For example: A Modero touch panel was previously set to System #2.
The system is then reset to its default setting of System #1 and then refreshed from within the Workspace window. The panel will not
reappear until the system is changed (from within the System Connection page on the Modero) to match the new value and both the
Master and panel are rebooted.
3. Click Done to close the Device Addressing dialog.
4. Click Reboot (from the Tools > Reboot the Master Controller dialog) and wait for the System Master to reboot.
NOTE: The STATUS and OUTPUT LEDs should begin to alternately blink during the incorporation. Wait until the STATUS LED is the only
LED to blink.
5. Click Done. Wait until the Master Reboot Status field reads *Reboot of System Complete*.
6. Click the OnLine Tree tab in the Workspace window to view the devices on the System.
7. Right-click the associated System number (or anywhere within the tab itself) and select Refresh System. This establishes a
new connection to the specified System and populates the list with devices on that system.
8. Use Ctrl+S to save these changes to your NetLinx Project.

NX-Series Controllers - WebConsole & Programming Guide 33

 On-Board WebConsole User Interface

On-Board WebConsole User Interface

WebConsole UI Overview
NetLinx Masters have a built-in System Configuration interface that allows you to make various configuration settings via a web
browser on any PC that has access to the Master. The System Configuration interface (an on-board web configuration) contains a
comprehensive set of web pages that can be used during setup to manage your system’s network, security, and system needs, as
well as configure its inputs and outputs while executing switches (FIG. 28).

FIG. 28 WebConsole - Web Controls page (initial view)

The WebConsole offers five primary sections from a menu located at the top of the page, indicated by five menu options across the
top of the main page (FIG. 29):

FIG. 29 System Configuration Menu Options

Home: This option appears when you access the System Configuration page. Use these options to view any connected
device or access a module.
Network: Click to access the Network Settings for the Master. The options on these pages enable you to view and modify
the IPv4 and IPv6 network settings and the clock settings for the system (see the WebConsole - Network Options section
on page 36).
Security: Click to access the System Security page. The options in this page allow you to configure various aspects of
NetLinx System and Security on the Master, including network configuration and creating users and roles (see the
WebConsole - Security Options section on page 41).
System: Click to access the System Details page. The options on this page allow you to view and configure various aspects
of the NetLinx System (see the WebConsole - System Options section on page 57).
Modules: Click to access several different device-related pages (see the WebConsole - Modules Options section on page 59).
Switcher: Click to access the Enova Switcher Configuration page (see the WebConsole - Switching Options section on
page 67). This page only appears for Enova devices.
From the Home page, Web Control options become available (e.g., RMS, Virtual Keypad, and device details pages for any connected
devices).
System Conf iguration Interface Tips:
It is recommended that you use the latest, industry accepted version of HTML5 browsers. If a browser is inconsistent,
upgrade or try a different browser. To-date, browsers tested include Google Chrome (preferred), Mozilla Firefox, Apple
Safari, and Microsoft Internet Explorer 10+/Edge.
To access the interface after initial setup, simply type the integrated Master’s IP address in the address bar of the browser
and press the Enter key. On the DVX, DGX, and NX-4200, the IP address is available on the front panel display.
Some devices run on a secured file-system. As such, file-system operations (e.g., Load and Save operations) may not be
supported by the device’s default capabilities and may require downloading a file manager application.
When selecting Inputs and Outputs for switches – you may select an input followed by multiple outputs, but only one input
is selectable if you select an output first.
Inputs and Outputs can only have one name each, regardless of whether the name is set via the Video tab or the Audio tab
in the Configuration page (or via NetLinx SEND_COMMANDs VIDIN_NAME, VIDOUT_NAME, AUDIN_NAME, AUDOUT_NAME).
Inputs and Outputs may be named independently.

NX-Series Controllers - WebConsole & Programming Guide 34

 On-Board WebConsole User Interface

Accessing the WebConsole

From any PC that has access to the LAN that the target Master resides on:
1. Open a web browser and type the IP Address of the target Master in the Address Bar.
2. Press Enter to access WebConsole for that Master. The initial view is the Web Control page (FIG. 28).
When using the Microsoft Internet Explorer browser in Windows 8, you may not be able to login and connect to the Master via the
WebConsole. If you cannot login and connect, try any of the following options:
Shift+Right-click Internet Explorer icon and select Run as administrator.
Select Internet Options | Advanced | Security Settings, and check Enable Enhanced Protection Mode. A Windows 8 restart
will be required.
Use the Master’s Hostname instead of its IP numeric address to enter the URL (e.g.: http://AMXM98A1A2B rather than
http://192.168.1.123)
Use a non-Windows 8 device if Internet Explorer 10+ is required.
Default User Names and Passwords
The following table lists the default user names and passwords for accessing the NX-series controllers through NetLinx Studio or
the WebConsole.
Default User Names and Passwords
User Name Password
NetLinx Studio netlinx password
WebConsole administrator password

NX-Series Controllers - WebConsole & Programming Guide 35

 WebConsole - Network Options

WebConsole - Network Options

Network Overview
The Network page (FIG. 30) is accessed by clicking Network on the page’s main heading. This page allows you to view and
configure various aspects of the Master’s network:
IPv4 Setup - Options on this page allow you to view/change the Master’s IP and DNS address information. See the Network
- IPv4 Setup section on page 37 for details.
IPv6 Setup - This page allows you to view the IPv6 address, subnet mask, and gateway for the Master. See the Network -
IPv6 Setup section on page 38 for details.
Date/Time - Options on this page allow you to enable/disable using a network time source and provide access to Daylight
Saving configuration and which NIST servers to use as a reference. See the Network - Date/Time section on page 38 for
details.

FIG. 30 Network page

NX-Series Controllers - WebConsole & Programming Guide 36

 WebConsole - Network Options

Network - IPv4 Setup

Click IPv4 Setup to access the IPv4 page (FIG. 31) and view and configure IP and DNS addresses for the Master. Use the options on
this page to view/edit the Master’s network settings. A user can only modify the information on this page if it is assigned a Role that
includes the Network Configuration permission. Without the proper permission, a user can only view the information on this page.

FIG. 31 Network - IPv4 Setup page

IPv4 Options
The IPv4 options are described in the following table:
IPv4 Options
Option Description
IP Address: This section enables you to set IP information for the Master’s network.
IP Hostname Enter the IP host name in this field.
DHCP/Specific IP Use the buttons to select a DHCP or static IP address. Additional options in this area become available if you select
Address Specific IP Address.
IP Address Enter the IPv4 address in this field. This field is only available if you select Specific IP Address.
Subnet Mask Enter the IPv4 subnet mask in this field. This field is only available if you select Specific IP Address.
Gateway Enter the gateway IPv4 address in this field. This field is only available if you select Specific IP Address.
DNS Address: This section enables you to set DNS information for the Master’s network.
Domain Enter the domain name of the DNS server in this field.
DNS IP Enter up to three DNS server addresses in the provided fields.
Zero-Config Use the buttons to activate zero-config networking functionality on the Master’s network. Zero-config networking
Networking provides the ability to automatically discover devices that are present on the LAN. By default, zeroconf is enabled
(On option selected). With zeroconf enabled, the Master's web interface will be registered via zeroconf and can be
viewed through a zeroconf browser plug-in such as Bonjour for IE.
NetLinx Discovery Use the buttons to indicate whether you want the Master to search for any NDP-capable devices currently
Protocol (NDP) connected to the Master.

NX-Series Controllers - WebConsole & Programming Guide 37

 WebConsole - Network Options

Network - IPv6 Setup

Click IPv6 Setup to access the IPv6 page (FIG. 32) and view the IPv6 address, subnet mask, and gateway for the Master. This
information is view-only.

FIG. 32 Network - IPv6 Setup page

Network - Date/Time
Click the Date/Time link (on the Network page) to access the Date/Time page (FIG. 33). The options on this page allow you to
enable/disable using a network time source and provide access to Daylight Saving configuration and which NIST servers to use as
a reference.

FIG. 33 Network - Date/Time page

The Clock Manager Options are separated into three areas:
Clock Manager - The Clock Manager allows you to set the Clock Manager Mode (Network Time or Stand Alone).
Daylight Savings Time Manager - The Daylight Savings Time Manager allows you to specify how and when to implement
Daylight Savings rules on the clock.
NIST Server Manager - The NIST Server Manager allows you to connect to a specific NIST (Internet Time Service) Server.

NX-Series Controllers - WebConsole & Programming Guide 38

 WebConsole - Network Options

Setting the Mode for the Clock Manager

1. In the Manage System tab (FIG. 33), select a Time Sync option.
Network Time: This option allows the Master to manage it’s clock by connecting to a NIST (Internet Time Service) Server.
When this option is selected, the Master will connect to the default NIST Server to get date and time information.
You can select a different NIST Server (or specify the IP Address of a known NIST Server) in the NIST Server Manager
section (see the Selecting a Custom NIST Server section on page 39).
Stand Alone: This option lets the Master use its own internal clock. When this option is selected, two additional fields are
available on this tab:
Date - Enter the current date in this field (mm/dd/yyyy).
Time - Enter the current time in these fields (Hours/Minutes/Seconds).
2. Click Accept to save these settings to the Master.
Setting Daylight Savings Rules
1. In the Daylight Savings Time Manager section (FIG. 34), enable Daylight Savings mode by clicking the On button. Clicking On
reveals additional Daylight Savings options.

FIG. 34 Date/Time Options - Daylight Savings Time Manager

2. Use the Offset drop-down menus to adjust the amount of time (hours and minutes) to offset Daylight Savings. By default, the
offset is set to 1 hour.
NOTE: Although most places that support Daylight Savings usually adjust the local time by one hour this doesn't cover all locations.
To provide flexibility for such locations it is possible to conf igure a different daylight savings time offset.
3. Use the Starts fields to specify when Daylight Savings should start. The Starts rules include:
Select Fixed to specify the calendar date when the rule applies as a specific date ("March 21"). When Fixed is selected, use
the Day, Month, Hours, and Minutes fields to specify the date and time (hh:mm) to start Daylight Savings time.
Select by Occurrence to specify the calendar date when the rule applies as a heuristic, ("the 3rd Sunday in March"). When
by Occurrence is selected, use the Wk of the Month, Day, Month, Hours, and Minutes fields to specify the occurrence to
start Daylight Savings time.
The range for Wk of the Month is 1 through Last, where Last indicates the last occurrence of a particular day of the
month. This is to accommodate months that include four weeks as well as those that include five.
4. Use the Ends fields to specify when Daylight Savings should end. The Ends rules match the Start rules, and follow the same
logic. Select Fixed or by Occurrence, and specify the End date/time information accordingly.
5. Click Accept to save these settings to the Master.
Selecting a Custom NIST Server

FIG. 35 Date/Time Options - NIST Server Manager

1. In the NIST Server Manager section (FIG. 35), use the option buttons to select one of the NIST Servers in the list.
2. Click Accept to save the selection to the Master.

NX-Series Controllers - WebConsole & Programming Guide 39

 WebConsole - Network Options

Adding a Custom NIST Server to the List

1. Click Add Server. The Add New Server dialog opens (FIG. 36).

FIG. 36 Add New Server dialog

2. In the New Server URL field, enter the URL of the NIST Server. The URL is used only to help you manage entries, and is not
verified or used internally by the clock manager.
3. Enter the NIST Server’s IP Address in the New IP field. This is used internally and must be a valid IP address.
NOTE: The strings entered into the URL and Location f ields are not used to connect to NIST Servers. The IP Address (entered
into the IP f ield) specif ies the NIST Server(s) that will be used. As stated above, the address entered into the IP f ield must be
must be a valid IP address (not a URL).
4. Enter the NIST Server’s location in the New Location field. This is used only to help the user manage entries and it is not
verified or used internally by the clock manager.
5. Click Accept to save these settings to the Master.
Removing an NIST Server From the List
1. Click on the Remove (x) button to the right of a user-added NIST Server in the NIST Server Manager list.
2. Click Accept to save these settings to the Master.
NOTE: The built-in entries cannot be removed.
Clock Manager NetLinx Programming API
Refer to Appendix C: Clock Manager NetLinx Programming API section on page 145 for a listing and description of the Types/
Constants and Library Calls that are included in the NetLinx.AXI to support Clock Manager functions.

NX-Series Controllers - WebConsole & Programming Guide 40

 WebConsole - Security Options

WebConsole - Security Options

Security Overview
The Security page is accessed by clicking Security on the page’s main heading. This page allows you to view configure and modify
the Master’s security settings at three levels (System, Role, and User). See the Security Presets section on page 45 for more
information on the three presets.
System Level - changes made at this level affect the system globally. See the Security - General section on page 43 for
details.
Role Level - changes made at this level affect specific Roles. See the Security - Roles section on page 47 for details.
User Level - changes made at this level affect individual Users. See the Security - Users section on page 51 for details.
The default view for the option is System Security Settings (FIG. 37).

FIG. 37 System Security Settings

NOTE: By default, all System-level security options are disabled, except for Authentication On Server Ports, which requires a login for
access to the web or command line interface.
Additional security configuration options are available via Terminal/Telnet Commands. See the Accessing the Security
Conf iguration Options section on page 121.
Login Rules
There is no limit to the number of concurrent logins allowed for a single user. This allows for the creation of a single user that is
provided to multiple ICSP devices (touch panels, for example) using the same login to obtain access to the Master.
For example, if you have 50 devices connected to a Master, you do not have to create 50 individual user accounts, with one for each
device. Instead, you only need to create one which all 50 devices use for access.
The first layer of security for the Master is to prompt a user to enter a valid user name and password before gaining access to a
secured feature on the target Master.
Depending on the Security configuration, users may be prompted to enter a valid user name and password before gaining access to
various features of the WebConsole. User access is specified by the administrator in the Role and User Level pages of the Security
section.
NOTE: This user name and password information is also used by both G5 touch panels (within the System Connection f irmware page)
and AMX software applications such as NetLinx Studio v 4.0 and above to communicate securely with a Master using encrypted
communication.

NX-Series Controllers - WebConsole & Programming Guide 41

 WebConsole - Security Options

User and Role Name Rules

User account and role names must follow these rules:
Case-sensitive

Must be between 4 and 20 alpha-numeric characters: A-Z, a-z, 0-9

The following characters are allowed: - _ . # and <space>.
Password Rules
The rules for changing a password vary according to the Password Complexity setting for the user. A user’s password complexity
can be set to Low, Medium, or High.
Low - Minimum length is 4 characters, and must be different from previous password.
Medium - Minimum length is 8 characters, must contain characters from 3 character classes listed in the table below, must
contain at least 4 changes from the previous password, and must be different from the previous 10 passwords.
High - Minimum length is 15 characters, must contain characters from all of the characters classes listed in the table below,
must contain at least 8 changes from the previous password, and must be different from the previous 30 passwords.
The requirements for each setting are listed in the following table:
Password Complexity Requirements
Requirement Low Medium High
Case Change Only No No Yes
Character Classes Required 0 3 4
Library Check No No Yes
Minimum Length 4 8 15
Palindrome Check No No Yes
Same Consecutive Characters No check 5 3
Similarity Check 1 4 8
User Name Check (straight or reversed) No Yes Yes
Different from Previous # of Passwords 1 10 30

The definitions of each requirement are listed below:

Case Change Only: A new password cannot differ from the previous passwords solely by a change in case (upper/lower)
Character Classes Required: A password must contain characters from a set number of character classes. See the
Character Classes table below for the list and definitions of character classes.
Library Check: The password cannot contain a word from a dictionary file supplied with the OS.
Minimum Length: The password must contain a minimum set number of characters.
Palindrome Check: The password does not contain a palindrome of a 7-letter length or greater.
Same Consecutive Characters: The password does not contain more than a set number of the same consecutive
characters.
Similarity Check: The password differs from the previous password by a set number of characters.
User Name Check: The password does not contain the user’s user name.
Different from Previous # of Passwords: The password differs from a set number of previous passwords.
The following table lists the characters available in each character class:
Character Classes
Character Class Example
Uppercase Letters A-Z
Lowercase Letters a-z
Numbers 0-9
Other Characters `~ ! @ # $ % ^ & * ( ) _ - + = { } [ ] \ | : ; " ' <> , . ?/ (including "space")

NX-Series Controllers - WebConsole & Programming Guide 42

 WebConsole - Security Options

Security - General
The General Security Settings page provides global permissions for various options that may be individually selected and applied to
all users. The Master provides 3 levels of security settings presets: Low, Medium, and High. The levels are simply presets of various
security settings. When a preset is selected, the settings are not applied until you click Accept. You can customize any settings as
needed on the security preset before accepting and applying the settings. The default for the settings will match the Low presets.
System Level Security - System Security Settings
Click the System Security Settings link to access the System Security Details page (FIG. 38). The options in this page allow you to
establish whether the Master will require a valid user name and password be entered prior to gaining access to the configuration
options.

FIG. 38 System Security Settings

These are global options that enable or disable the login requirement for both users and roles.
System Security Options
The System Security options are described in the following table:
System Security Options
Option Description
Security Presets The Master provides three levels of security setting presets: Low, Medium, and High. Each level is a preset of
various security settings (see the Security Presets section on page 45 for more information.) When a preset is
selected, that setting is applied after clicking Accept.
NOTE: If a security preset is not selected, all subordinate options are grayed-out and not selectable, meaning
that the Master is completely unsecured and can be altered by any user (regardless of their rights).
Audit Log Select to enable/disable remote syslog. See the Audit Logs section on page 46 for more information.
Banner Display Select to turn on or turn off banner messages. Banners enable you to display pre- and post-login text in the
WebConsole. See the Banners section on page 46 for more information.
USB Host Port Select to enable all Type-A USB connectors on the Master.
Inactivity Timeout Select to enable the Master to log out a user after a defined period of inactivity. After enabling the inactivity
timeout option, use the spin box to set the number of minutes before the timeout activates. You can set a timeout
in the range of 1 to 60 minutes. The default setting is 10 minutes. The timeout applies to Program Port, Telnet,
SSH, HTTP, and HTTPS sessions.

NX-Series Controllers - WebConsole & Programming Guide 43

 WebConsole - Security Options

System Security Options (Cont.)

Option Description
Password Expiration Select to force a user to change its password after a set period of time. After enabling the password expiration
options, use the spin box to set the interval for password expiration. You can set an amount of time in the range of
1 to 180 days. The default setting is 60 days.
NOTE: This option is only valid on locally-maintained accounts. When external LDAP is enabled, only the
administrator and device user accounts are affected.
Cryptography Set the cryptography strength of the Master to Low or High. On the High setting, only FIPS 140-2 validated
Strength: binaries are used.
Password Complexity Set the password complexity to Low, Medium, or High. When the password complexity level is raised from a lower
level to a higher level, the Master requires confirmation from the user. When the user confirms the change, all
passwords are marked as expired on all local user accounts, and the passwords must be changed to meet the new
complexity requirements. Password complexity requirements are as follows:
• Low - Minimum length is 4 characters, and must be different from previous password.
• Medium - Minimum length is 8 characters, must contain characters from 3 of the following characters sets
(uppercase letters, lowercase letters, numbers, other characters), must contain at least 4 changes from the
previous password, and must be different from the previous 10 passwords.
• High - Minimum length is 15 characters, must contain characters from all of the following characters sets
(uppercase letters, lowercase letters, numbers, other characters), must contain at least 8 changes from the
previous password, and must be different from the previous 30 passwords.
NOTE: This option is only valid on locally-maintained accounts. When external LDAP is enabled, only the
administrator and device user accounts are affected.
Lockout Access Select to enable a lock on a user account after a set number of failed logins. When enabled, use the Attempts spin
box to set the number of login attempts allowed. Use the Lockout Duration options menu to indicate the amount of
time you want the lockout to last. The default setting is 60 minutes.
NOTE: This option is only valid on locally-maintained accounts. When external LDAP is enabled, only the
administrator user is affected.
HTTP/HTTPS Select to enable HTTP and HTTPS access to the Master.
HTTP: The port value used for unsecure HTTP Internet communication between the web browser’s UI and the
target Master. By disabling this port, the administrator (or other authorized user) can require that any consecutive
sessions between the UI and the target Master are done over a more secure HTTPS connection.
By default, the Master does not have security enabled and must be communicated with using http:// in the
Address field. The default port value is 80.
NOTE: One method of adding security to HTTP communication is to change the Port value. If the port value is
changed, any consecutive session to the target Master has to add the port value at the end of the address
(within the Address f ield). An example is if the port were changed to 99, the new address information would
be: http://192.192.192.192:99.
HTTPS: The port value used by web browser to securely communicate between the web server UI and the target
Master. This port is also used to simultaneously encrypt this data using the SSL certificate information on the
Master as a key.
This port is used not only used to communicate securely between the browser (using the web server UI) and the
Master using HTTPS but also provide a port for use by the SSL encryption key (embedded into the certificate).
Whereas SSL creates a secure connection between a client and a server, over which any amount of data can be
sent securely, HTTPS is designed to transmit individual messages securely. Therefore both HTTPS and SSL can be
seen as complementary and are configured to communicate over the same port on the Master. These two methods
of security and encryption are occurring simultaneously over this port as data is being transferred. The default
port value is 443.
Another method of adding security to HTTPS communication would be to change the port value. If the port
value is changed, any consecutive session to the target Master has to add the port value at the end of the
address (within the Address f ield). An example is if the port were changed to 99, the new address information
would be: http://192.192.192.192:99.
Telnet/SSH/SSH FTP Select to enable Telnet, SSH, and SSH FTP access to the Master.
Access Telnet: The port value used for Telnet communication to the target Master. Enabling this feature allows future
communication with the Master via a separate Telnet application.
• The default port value for Telnet is 23.
• Refer to the NetLinx Security with a Terminal Connection section for more information on the related procedures.
SSH: The port value used for secure Telnet communication. A separate secure SSH Client would handle
communication over this port. When using a secure SSH login, the entire login session (including the transmission
of passwords) is encrypted; therefore it is secure method of preventing an external user from collecting
passwords.
• SSH version 2 is supported.
• The default port value is 22.
NOTE: If this port’s value is changed, make sure to use it within the Address f ield of the SSH Client
application.

NX-Series Controllers - WebConsole & Programming Guide 44

 WebConsole - Security Options

System Security Options (Cont.)

Option Description
FTP Access Select to enable FTP access to the Master. The default port value used for FTP communication is 21.
NOTE: This port can be disabled/enabled, but its value cannot be changed.
Authenticate on Select to require user name and password authentication on Telnet, Program, and HTTP/HTTPS ports.
Server Ports Authentication is always required on FTP/SFTP and SSH ports.
NOTE: If Authenticate on Server Ports is disabled but LDAP is enabled, a login is still required. If you do not
desire a login, LDAP must also be disabled.
Authenticate AMX Select to require user name and password authentication on devices connected to the ICSLAN ports on the Master.
Devices On ICSLAN
Ports
ICSLAN AMX Device Select to allow ICSP access to the Master for Device-type users connected to the ICSLAN ports. Expand the
Connection ICSLAN AMX Device Connection section to view this option.
ICSLAN Encryption Select to enable encryption on the ICSLAN ports on the Master. Expand the ICSLAN AMX Device Connection
section to view this option.
Authenticate AMX Select to require user name and password authentication on devices connected to the LAN ports on the Master.
Devices On LAN Ports
LAN AMX Device Select to allow ICSP access to the Master for Device-type users connected to the LAN ports. Expand the LAN AMX
Connection Device Connection section to view this option.
LAN Encryption Select to enable encryption on the LAN ports on the Master. Expand the LAN AMX Device Connection section to
view this option.

Security Presets
The Master provides three levels of security setting presets: Low, Medium, and High. Each level is a preset of various security
settings. The following table describes each of the Security Presets presented on the General section of the Security page:
Security Presets
Preset Low Medium High
Audit Log Off On On
Banner Display Off On On
USB Host Port Enabled Enabled Disabled
Authentication On Server Ports Required Required Required
Inactivity Timeout Off On On
Password Expiration Disabled Enabled Enabled
Cryptography Strength Low Low High
Password Complexity Low Medium High
Lockout Access Off On On
FTP Access Both enabled Disabled/Enabled Disabled/Disabled
HTTP/HTTPS Both enabled Disabled/Enabled Disabled/Disabled
Telnet/SSH/SSH FTP Access Both enabled Disabled/Enabled Disabled/Disabled
Authenticate AMX Devices on Not required Required Required
ICSLAN Ports
ICSLAN AMX Device Connection ICSPS enabled, ICSP enabled - ICSPS enabled, ICSP enabled - ICSPS enabled, ICSP disabled
without encryption with encryption
Authenticate AMX Devices on Not required Required Required
LAN Ports
LAN AMX Device Connection ICSPS enabled, ICSP enabled - ICSPS enabled, ICSP enabled - ICSPS enabled, ICSP disabled
without encryption with encryption

Once any of the settings have been modified, press the Accept button to save these changes to the Master. Once these changes are
saved, the following message appears: "Device must be rebooted for the setting to take effect. To reboot, go to the System Devices
page." A link appears which you can click to jump to the System Devices page (see the System - Devices section on page 58 for
more information.) Click the Reboot button to remotely reboot the target Master.

NX-Series Controllers - WebConsole & Programming Guide 45

 WebConsole - Security Options

Audit Logs
An audit log includes the date/time of the event, the event type, the software or hardware component where the event occurred,
the source of the event, the subject identity, and the outcome of the event. For events related to a remote device, the audit log
includes the source and destination network addresses and ports or protocol identifiers.
The Master generates an audit record for the following events:
Each successful or unsuccessful attempt to access security files
Alerts and errors
Starting/Shutting down audit logging
Any blocking (including the reason) of access based on a UID, terminal, or access port
Any configuration change. The record includes the source and destination network addresses and ports or protocol
identifiers.
Denial of access due to excessive login attempts
Each log off
Each successful or unsuccessful attempt to log on to the application
Successfully or unsuccessfully loading and starting a Duet module
Modification of permissions associated with roles
Connection and loss of connection to an NTP server. (Loss of connection is defined as three successive failed polls. A single
successful poll constitutes a re-connection.
System reboot
Software or firmware updates
Creation, modification, and deletion of user accounts
NOTE: The Master retains audit log records for 30 days (or less depending on available space), after which they are automatically
purged.
Banners
Banners enable you to display pre- and post-login text in the WebConsole and terminal interfaces. Banner files are text files
containing up to 500 characters in each file. (Any additional characters are discarded.)
NOTE: Banner f iles are user-provided and optional. If no f iles are found, no banner appears.
The following special characters are allowed for use in banner text messages:
!”#$%&’()*+,-./:;<=>?@[\]^_`{|}~
Also allowed are any printable ASCII characters (including "space"): A-Z, a-z, 0-9.
Pre-login banners must be named "banner.txt" and stored in the /user directory on the Master. Post-login banners are obtained
from one or more files in the /user directory. Post-login banner text is a concatenation of the allroles_banner.txt file, followed by all
of the applicable <role>_banner.txt files, where <role> is the name of a defined Role in the system. The applicable files are those
that match the Roles assigned to the user that logged in. If a Role is currently locked, its banner file is not included.
NOTE: If you load a new "banner.txt" f ile with new content to the Master, you must reboot the Master to display the new f ile.

NX-Series Controllers - WebConsole & Programming Guide 46

 WebConsole - Security Options

Security - Roles
A Role is a set of privileges or permissions assigned to one or more users. The privileges and permissions can involve various
functions or allow access to specific ports. Any privileges or permissions set for a role are inherited by all users sharing that role.
Multiple roles can be assigned to a user, but at the same time, roles are not required for users. A user can have zero roles assigned
to it.
NOTE: You cannot assign a permission directly to a user. All user permissions are determined by the Role assigned to the user.
NOTE: If you have a remote directory such as LDAP enabled, the common name of the LDAP group on the LDAP server must match the
name of the Role assigned to the user on the Master.
Select the Roles option of the Security Page to access the Role Security Details page (FIG. 39).

FIG. 39 Security - Roles page

The options in this page allow authorized users to assign and alter role properties such as creating, modifying, or deleting a role’s
rights, locking a role, and defining the files/directories accessible by a particular role. Locking a role disables the role without
deleting it.
Default Roles
By default, the NetLinx Master creates the following accounts, access rights, directory associations, and security options:
Default User Accounts
All_Permissions Studio
Permissions: All Permissions:
• Device Management
• Firmware Update
• Network Management
• Security Control

NX-Series Controllers - WebConsole & Programming Guide 47

 WebConsole - Security Options

Role Permissions
The following table lists the permissions available for Roles:
Role Permissions
Option Description
Audit Log Select to allow the role to view and configure the audit log.
Device Select to allow the role to modify the configuration of NetLinx and 3rd party devices including the following:
Configuration • System number
• Device number
• Integrated device settings
• Switcher device settings (DVX or DGX)
• Reboot
NOTE: This permission is not required to view the information, only to change it.
Firmware/Software Select to allow the role to update firmware and software. This setting allows Device access via ICSP with user
Update credentials.
NOTE: This permission also includes the right to reboot the Master after the update. It does not include the
right to reboot the Master outside of this context or to reboot any other devices.
FTP/SFTP Access Select to allow the role to have FTP and SFTP access.
General Select to allow the role to modify general configuration including access to WebControl for RMS and RPM
Configuration configuration, importing and exporting configuration files, and the following parameters:
• Auto-locate enable/disable
• Device Holdoff setting
• Duet memory allocation
• ICSP TCP timeout
• Master-to-master route mode
• Message log length
• Message thresholds for threads
• Queue sizes for threads
• UDP broadcast rate
NOTE: This permission also includes the right to reboot the Master after the conf iguration change. It does not
include the right to reboot the Master outside of this context or to reboot any other devices.
NOTE: This permission is not required to view the information, only to change it.
HTTP/HTTPS Select to allow the role to have HTTP and HTTPS access through the web interface.
Network Select to allow the role to modify network configuration including the following:
Configuration • Clock Manager settings
• DHCP/Static setting (Gateway IPv4 address, IPv4 address, IPv4 subnet mask (if static selected))
• DNS server addresses
• Domain name
• Hostname
• zeroconfig enable/disable
NOTE: This permission also includes the right to reboot the Master after the conf iguration change. It does not
include the right to reboot the Master outside of this context or to reboot any other devices.
NOTE: This permission is not required to view the information, only to change it.
Program Port Select to allow the role to have terminal access via the Program Port.
Access
Security Control Select to allow the role to view and configure security including the following:
• Audit log enable • HTTP/HTTPS enable
• Authentication on server ports enable • Inactivity timeout enable
• Authentication on ICSP LAN ports enable • ICSP options on ICSLAN
• Authentication on ICSP ICSLAN ports enable • ICSP options on LAN
• Banner display enable • Password complexity
• Cryptographic options • Password expiration enable
• Lockout on failed logins enable • Telnet/SSH enable
• FTP/SFTP enable • USB Host port disable
NOTE: This permission also includes the right to reboot the Master after the conf iguration change. It does not
include the right to reboot the Master outside of this context or to reboot any other devices.
NOTE: This permission is not required to view the information, only to change it.
Telnet/SSH Access Select to allow the role to have Telnet and SSH access.
Touch Panel Select to allow the Master to access a touch panel’s settings page.
Administration

NX-Series Controllers - WebConsole & Programming Guide 48

 WebConsole - Security Options

Role Permissions (Cont.)

Option Description
User Access 1-4 Select to allow the role access generic access permissions. These privileges are to be used by NetLinx programs.
User Management Select to allow the role to view, create, modify, lock, and remove user accounts.
NOTE: A user has the ability to change its own password, regardless of whether it has the User Management
permission.

Adding a New Role

1. Select the Roles option (in the Security section) to open the Role Security Details page.
2. Click the Add Role button (see FIG. 40) to access the Add New Role page (FIG. 40).

FIG. 40 Add New Role

3. In the Role Name field, enter a unique name for the new role.
The name must be a valid character string consisting of 4 - 20 alpha-numeric characters. See the User and Role Name
Rules section on page 42 for a complete list of valid characters.
The string is case sensitive and must be unique.
The terms "All_Permissions" and "Studio" cannot be used for a new role name since the names already exist by default.
NOTE: If you have a remote directory such as LDAP enabled, the common name of the LDAP group on the LDAP server must
match the name of the Role assigned to the user on the Master.
4. Enable the security access rights you want to provide to the role. By default, all of these options are disabled. See the Role
Permissions section on page 48 for details.
5. Click the Accept button to save your changes to the target Master.
If there are no errors within any of the page parameters, a “Role added successfully” message displays at the top of the page.
NOTE: Security changes made from within the web browser are applied instantly without the need to reboot.

NX-Series Controllers - WebConsole & Programming Guide 49

 WebConsole - Security Options

Viewing and Modifying Role Security Settings Details

Click any Role listed on the Role Security Details page to expand the view to show details for the selected user Role (FIG. 41):

Lock button

Click to expand

Edit button

FIG. 41 Role Security Details Page

1. Select the Roles option (in the Security section) to open the Role Security Details page.
2. Click any Role listed on the Role Security Details page to expand the view to show details for the selected user Role.
3. Modify the previously configured access rights by enabling/disabling the check boxes. See the Role Permissions section on
page 48 for details.
4. Click Accept to save your changes to the Master.
If there are no errors with the modification of any of this page’s parameters, a “Role updated successfully” is displayed at the
top of the page.
NOTE: The "All_Permissions" user name cannot be modif ied or deleted.
Any properties possessed by roles (ex: access rights, update rights, directory associations, etc.) are inherited by users assigned to
that particular role.
Unchecking a security option (which is available within the associated role) does not remove that right from the user. The only way
to remove a role’s available security right from a target user is either to not associate a role to a user or to alter the security rights
of the role being associated.
Deleting a Role
1. Select the Roles option (in the Security section) to open the Role Security Details page.
2. Click the Edit button (see FIG. 41) for any Role listed on the Role Security Details page to expand the view to show details for
the selected Role.
3. Click Delete to remove the selected role and refresh the page. The system will prompt you to verify this action - click OK to
proceed.
If the role is associated with several users, you might get an error while trying to delete the role. If this happens, change the
role association of those specific users utilizing the old role and either give them a new role or assign them (none) as a role.
When you return to delete the desired role, you receive a message saying "Role deleted successfully".
4. Click the Accept button to save your changes to the Master.
Locking/Disabling a Role
1. Select the Roles option (in the Security section) to open the Role Security Details page.
2. Click the Lock button (see FIG. 41) for any Role listed on the Role Security Details page to lock and disable the Role. Click the
Lock button again to unlock and enable the Role
NOTE: Any Role can be disabled except for the All_Permissions role.

NX-Series Controllers - WebConsole & Programming Guide 50

 WebConsole - Security Options

Security - Users
Select the Users option on the Security Page to access the User Security Details page (FIG. 42). The options on this page allow
authorized users to add/delete/lock User accounts and configure User’s access rights. Locking a user account disables the
account without deleting it.

FIG. 42 Security - Users page

A User represents a single client of the Master, while a Role specifies a set of privileges and permissions which can be assigned to a
user. An administrator can assign up to 5 roles to a single user. Any properties possessed by a role are inherited by all of the users
assigned to the role.
Default User Accounts
By default, the NetLinx Master creates the following accounts, access rights, directory associations, and security options:
Default User Accounts
administrator netlinx
Username: administrator Username: netlinx
Password: password Password: password
Role: All_Permissions Role: Studio
Directory Association: /* Directory Association: none
NOTE: You can delete and/or modify the "administrator" user NOTE: The "netlinx" user account is compatible with previous
account to optimize system security. If deleted, you can create a NetLinx Master f irmware versions. This account is initially
new user with the "administrator" user name with its own proper created by default and can later be deleted or modif ied.
settings, provided LDAP is not enabled.

FTP Security is always enabled on the Masters.

All other security options are disabled by default.

NX-Series Controllers - WebConsole & Programming Guide 51

 WebConsole - Security Options

Adding a New User

TIP: For a quicker conf iguration, it is recommended to def ine all roles and permissions before def ining users.
1. Select the Users option (in the Security section) to view the User Security Details page.
2. Click the Add User button (see FIG. 42) to access the Add New User page (FIG. 43).

FIG. 43 Add New User

3. In the User Name field, enter a unique name for the new role.
The name must be a unique alpha-numeric character string (4 - 20 characters), and is case sensitive.
The words "administrator" and "NetLinx" cannot be used since they already exist by default.
NOTE: The Type f ield indicates the type of account for the user. This f ield lists either Normal or Device. Normal users are any users
which access the web interface, Telnet, or NetLinx Studio, and must be assigned to a Role with those permissions assigned to it.
Device connections are required for machine to machine over ICSP, such as touch panels and ICSLan device control boxes.
Device-type users are stored only in the local user database and are able to be modif ied even when a remote directory service is
enabled.
4. From the Roles options menu, choose from a list of roles and associate the rights of the role to the new user. You can assign
up to 5 roles to a user.
5. Enter a user password in both the Password and Password Conf irm fields. The password must conform to the rules set by the
Password Complexity level set on the User account. See the Password Rules section on page 42 for more information.
6. Select Force Password Change if you want the user to change its password on its next login. This option is not available for
Device users.
7. Click the Accept button to save your changes to the Master.
NOTE: Any security changes made to the Master from within the web browser are instantly reflected within a Terminal session without
the need to reboot, unless otherwise notif ied.

NX-Series Controllers - WebConsole & Programming Guide 52

 WebConsole - Security Options

Viewing and Editing User Security Settings

Click any User listed in the User Security Details page to view the security settings for the selected User (FIG. 44):

Edit button

click to expand

Lock button

FIG. 44 Security - Users page

1. Click the Edit button for the User you want to edit to expand the User’s details.
2. Make any necessary changes to the selected User, and click Accept for the changes to take effect.
Deleting a User
1. Select the Users options (in the Security section) to open the User Security Details page.
2. Click the Edit button for the User you want to delete to expand the User’s details.
3. Press the Delete button to remove the selected User and refresh the page. The system will prompt you to verify this action -
click OK to proceed.
4. Reboot the Master via the Reboot button on the Manage System Page (select the System control button to access).
Locking/Disabling a User
1. Select the Users option (in the Security section) to open the User Security Details page.
2. Click the Lock button (see FIG. 42) for any user listed on the User Security Details page to lock and disable the user. Click the
Lock button again to unlock and enable the user.

NX-Series Controllers - WebConsole & Programming Guide 53

 WebConsole - Security Options

Security Settings - LDAP

The LDAP page provides configuration and tests connection to a remote directory service via LDAPv3. The master supports the
option of an insecure or secure connection. The secure option is supported via the StartTLS command in LDAP and also via
"LDAPS", or LDAP over SSL/TLS on port 636. Select the LDAP option on the Security Page to access the LDAP Settings page
(FIG. 42). The options on this page allow authorized users to enable and modify LDAP security settings.

FIG. 45 Security - LDAP page

LDAP Options
All parameters are case sensitive and must be entered exactly as they are entered into the LDAP database. You can also perform
LDAP Client Configuration via terminal commands to the NetLinx Master’s Program Port - see the Enabling LDAP via the Program
Port section on page 123 for details.
See Appendix A: LDAP Implementation Details on page 127 for additional information on implementing LDAP on the NetLinx Master.
The LDAP options are described in the following table:
LDAP Options
Option Description
LDAP Enabled: This parameter enables the LDAP configuration parameters described below.
NOTE: When LDAP is enabled, you can only create device users. If the administrator user has been
deleted, you must perform a factory reset of the Master via pushbutton to restore the administrator
user.
LDAP URI This parameter has the syntax ldap[s]://hostname:port.
• The ldap:// URL is used to connect to LDAP servers over unsecured connections.
• The ldaps:// URL is used to connect to LDAP server over Secure Sockets Layer (SSL) connections.
• The hostname parameter is the name or IP address, in dotted format, of the LDAP server (for example,
LDAPServer01 or 192.202.185.90).
• The port parameter is the port number of the LDAP server (for example, 696).
NOTE: The standard unsecured port number is 389 and the standard secured port number is 636.
LDAP BASE DN This parameter specifies the Distinguished Name (DN) of an entry in the directory. It identifies the entry
that is the starting point of the user search.
BIND DN This parameter specifies the Distinguished Name (DN) to use to bind to the LDAP server for the initial
search for the user's DN.
User Query Attr This LDAP attribute is used for the AMX equipment user search (for example, UID).
NOTE: This attribute MUST be unique in the context of the LDAP BASEDN or the search will fail.
Search Password This is the password used for the initial bind to the LDAP server - it is the password associated with BIND
DN.

Click the LDAP enabled check box to make the LDAP options available for selection.
When LDAP is enabled, users are authenticated using the configuration set up on the LDAP server.
The "administrator" user is handled by the local NetLinx Master, and does not connect to the LDAP server for user
verification.

NX-Series Controllers - WebConsole & Programming Guide 54

 WebConsole - Security Options

If an administrator password change is desired, LDAP must be disabled, the password changed and saved and then LDAP re-
enabled.
Users may not be added or deleted via the web pages when LDAP is enabled.
User access privileges cannot be changed via the web pages.
As users log onto a NetLinx Master, their user name and access privileges are displayed on the User Security Details page
(see Security - Users section on page 51). This information is stored in the master's RAM but is not written to non-
volatile memory, and is lost after rebooting the Master.
If a user is removed from the LDAP directory tree, access is denied, and if that user name is on the master's User Security
Details web page it is removed.
Accepting Changes
Click the Accept/Test button to save changes on this page. Accepting changes is instantaneous and does not require rebooting the
Master.
Testing the Connection to the LDAP Server
After entering and accepting the parameters, the Accept/Test button can be used to test the connection to the LDAP server. This
test does a bind to the BIND DN using the Search Password entered.
If the bind is successful, the message Connection successful is displayed.
If the server could not be reached or the bind is unsuccessful, the message Could not connect to server -- Please check
LDAP URI, BIND DN and Search Password settings is displayed.
Refer to Appendix A: LDAP Implementation Details on page 127 for additional information.
IMPORTANT: For the NX-series Masters to work with LDAP over SSL (LDAPS), you must upload a CA server certif icate in .pem format
to the Master’s FTP server. The certif icate’s f ile name must be "ldap_ad.pem" and the f ile must be saved in a folder named "certs".
Once the f ile is uploaded, you must reboot the Master for the certif icate f ile to be read and employed by the system. LDAPS requires
Master Firmware version 1.3.78 or greater.
Wired 802.1X support
IEEE 802.1X is an IEEE Standard for Port-based Network Access Control (PNAC). PNAC provides the ability to grant or deny
network access to devices wishing to attach to a LAN based on credentials tied to the device rather than to a user. Until the device
has been verified and permitted access, no network traffic is passed through the connected port, effectively keeping the device
disconnected from the network.
The NX-Series controller acts as a supplicant (client device) to a wired 802.1X enabled network and presents customer-provided
X.509 certificates to be allowed access to protected networks. The following EAP Encryption Methods are supported.
PEAPv0/MSCHAPv2

TTLS/MSCHAPv2

TTLS/PAP

MD5

Customer provided X.509 certificates are uploaded to the NX-Series controller using NetLinx Studio, and 802.1x is configured via
the Command Line Interface and the syntax:
DOT1X[status|enable|disable]
Once you add the certificate file to your workspace, NetLinx Studio transfers the file to the appropriate directory on the controller.
1. Click to select (highlight) a System (in the Workspace tab of the Workspace Bar).
2. Right-click on the Other folder to access the Other File Folder context menu, and select Add Existing Other File.
3. In the Add Existing Other File dialog, locate and select the certificate file (.crt) that you want to add to the selected System.
Change the Files of Type option to All Files (*.*) to look for other file types, if necessary.
4. Click Open to access the File Properties dialog, where you can view/edit general file information for the selected file.
5. Click OK to add the file to the selected System. The file should now appear in the Other folder under the selected System.

NX-Series Controllers - WebConsole & Programming Guide 55

 WebConsole - Security Options

Security - Prof ile

The Profile page (FIG. 46) enables a user to see its own roles and permissions, and to change its password. The user cannot change
the roles and permissions on this page.

FIG. 46 Security - Profile page

Changing a User’s Password

Password rules depend on the password complexity setting for the user. For information on password rules, see the Password
Rules section on page 42.
1. Select the Prof ile option (in the Security section) to open the User Profile Details page.
2. Click Change Password. The Change Password dialog box opens (FIG. 47).

FIG. 47 Change Password dialog box

3. Enter the old password in the Old Password field.
4. Enter the new password in the New Password field.
5. Confirm the password by re-entering the new password in the Confirm Password field.
6. Click Accept for the changes to take effect and close the dialog box.

NX-Series Controllers - WebConsole & Programming Guide 56

 WebConsole - System Options

WebConsole - System Options

System Overview
The System page is accessed by clicking System on the page’s main heading. This page allows you to view and configure various
aspects of the NetLinx System:
System Information - Options on this page allow you to view a detailed list of the properties of the Master. See the System
- Info section on page 57 for details.
Devices - Options in this tab allow you to view the details of additional attached devices (including module-supported third-
party devices). See the System - Devices section on page 58 for details.
The default view for the System option is Manage System / System Number (FIG. 48).

FIG. 48 System - Info page

System - Info
The Info page (FIG. 48) enables you to view a detailed list of the properties of the Master. The properties include the Model ID and
serial number of the Master, network addresses, and firmware versions. This information is view-only. See the WebConsole -
Network Options section on page 36 for information on changing the network address of the Master.

NX-Series Controllers - WebConsole & Programming Guide 57

 WebConsole - System Options

System - Devices
The Devices page (FIG. 49) contains information about the Master and any connected devices. Select a device from the Device List
and its information appears in the Device Information area. The information in this area is view-only, unless the device allows a
change to its device number. If so, you can change the device number on this page (see Changing the Device Number on a Device
below for more information.) Masters also include a system number which a user can change with proper access (see Changing the
System Number on the Master below for more information.)

FIG. 49 System - Devices page

Changing the System Number on the Master

1. Select the Master from the Device List.
2. Enter the new numeric value into the New System Number field.
3. Click the Accept button to save this new value to the system on the target Master. The message "System number changed to X.
Master must be rebooted for the change to take effect." reminds you that the Master must be rebooted before the new settings
take effect.
4. Click Reboot to reboot the target Master. The Device Tree then reads "Rebooting...". After a few seconds, the Device Tree
refreshes with the current system information (including the updated system number assignment.) If the Device Tree does not
refresh within a few minutes, press the Refresh button and reconnect to the Master.
Changing the Device Number on a Device
Note that in most cases, the Device Number for Masters should remain set to zero.
1. Select the device from the Device List. Ensure the device has a device number.
2. Enter the new numeric value into the Device Number field.
3. Click the Accept button to save this new value to the system on the target device.
Resetting the Master Controller to the Factory Defaults Conf iguration
Click the Reset to Factory Defaults button. This resets the Master to its’ factory default state. This includes the following:
Removal of all security settings
Removal of all user files; creation of administrator and netlinx user accounts.
Removal of all roles; creation of All_Permissions and Studio roles.
Resetting to DHCP
Loading an empty NetLinx program.
Once reset, the Master will be effectively in an out-of-box state.
NOTE: It may be necessary to refresh the browser window after the master has f inished booting (click Refresh).

NX-Series Controllers - WebConsole & Programming Guide 58

 WebConsole - Modules Options

WebConsole - Modules Options

Modules Overview
The Modules page is accessed by clicking Modules on the page’s main heading. This page allows you to view and configure various
aspects of the NetLinx System:
Device Options - Options on this page display various details specific to additional (non-NetLinx) System Devices. See the
Modules - Device Options section on page 60 for details.
Bindings - Options on this page allow you to view the details of additional attached devices (including module-supported
third-party devices). See the Modules - Bindings section on page 61 for details.
User-Def ined Devices - Options on this page provide a listing with all of the dynamic devices that have been discovered in
the system, and allow you to add and delete User-Defined Devices. See the Modules - User-Def ined Devices section on
page 64 for details.
Active Devices - Options on this page allow you to check devices for compatible Duet Modules. See the Modules - Active
Devices section on page 65.
The default view for the Modules option is Device Options (FIG. 50).

FIG. 50 Modules - Device Options page

NX-Series Controllers - WebConsole & Programming Guide 59

 WebConsole - Modules Options

Modules - Device Options

Click the Device Options link (in the Manage Devices tab) to access the Details for Additional Devices page (FIG. 50). The options
on this page display various details specific to additional (non-NetLinx) System Devices.
Conf iguring Device Binding Options
1. Use the Conf igure System Binding Options to specify how the Master will manage Bound Devices:
Conf igure System Binding Options
Option Description
IP Device Discovery This option enables you to specify whether you want the Master to scan your network and locate any devices
connected to it.
Enable Auto Shutdown Auto-Shutdown forces the termination of modules that have lost communication with their respective
physical device. This capability is needed for plug-and-play support.
By default, Auto-Shutdown is enabled. If automatic termination of modules when they have lost
communication is not desired, this selection should be disabled.
Enable Subnet Match This selection allows you to specify whether or not IP devices should only be detected/discovered if they are
on the same IP Subnet as the Master.
Purge Bound Modules This selection indicates that all modules should be deleted from the bound directory upon the next reboot.
on Reset During the binding process, the associated Duet modules for a device are copied from the /unbound
directory into a protected /bound area.
Due to the dynamic nature of Java class loading, it is not safe to delete a running .JAR file. Therefore, this
selection provides the administrator the capability of removing existing modules upon reboot by forcing a
re-acquisition of the module at bind time.
This selection is a one-time occurrence. Upon the next reboot, the selection is cleared.

2. Press the Accept button to save your changes.

Managing Device Driver Modules
Use the Manage Device Driver Modules set of options to upload, archive, or delete modules from the Master. All modules currently
present on the Master are indicated in the Module list.
Uploading a Module
Perform the following steps to browse for a Module file and then upload it to the Master:
1. Click Upload Module to browse for Duet Modules on your PC/Network.
2. Select the JAR file that you want to upload to the Master.
3. Click the Open button to upload a copy of the selected JAR file to the target Master's /unbound directory. Only JAR file types
are allowed for Upload to the target Master.
Archiving a Module
Click the Archive button next to the module you want to archive. This action copies the selected module (*.JAR) file to your PC. Your
PC may require you to confirm this action depending on its security settings.
Deleting a Module
Select a module and click the Delete Module button. This action deletes the selected module from the /unbound directory.
NOTE: Any corresponding module within the /bound directory will not be deleted. Bound modules must be deleted via the Purge Bound
Modules on Reset selection described in the Conf igure System Binding Options section.

NX-Series Controllers - WebConsole & Programming Guide 60

 WebConsole - Modules Options

Modules - Bindings
Click Bindings to access the Device Bindings page (FIG. 51). Use the options on this page to configure application-defined Duet
virtual devices with discovered physical devices.

FIG. 51 Modules - Bindings

The table on this page displays a list of all application-defined devices, including each device’s "Friendly Name", the Duet virtual
device’s D:P:S assignment, the associated Duet Device SDK class (indicating the type of the device), and the physical device’s D:P:S
assignment. This information has to be pre-coded into the NetLinx file currently on the Master.

NX-Series Controllers - WebConsole & Programming Guide 61

 WebConsole - Modules Options

Conf iguring Application-Def ined Devices

Elements such as DUET_DEV_TYPE_DISPLAY and DUET_DEV_POLLED are defined within the NetLinx.axi file.
The NetLinx.axi file contains both the new API definitions, as well as the pre-defined constants that are used as some of the API
arguments (ex: DUET_DEV_TYPE_DISPLAY).
NOTE: Physical device names are typically pref ixed with "dv" and Virtual device names are typically pref ixed with "vdv".
Example Code:
PROGRAM_NAME='DDD'
DEFINE_DEVICE
COM1 = 5001:1:0
COM2 = 5001:2:0
dvDisplay = 41001:1:0
dvVideoProjector = 41002:1:0

DEFINE_CONSTANT
DEFINE_TYPE
DEFINE_VARIABLE
DEFINE_START

STATIC_PORT_BINDING(dvDisplay, COM1, DUET_DEV_TYPE_DISPLAY,

'statbcc Display', DUET_DEV_POLLED)

DYNAMIC_POLLED_PORT(COM2)

DYNAMIC_APPLICATION_DEVICE(dvVideoProjector, DUET_DEV_TYPE_VIDEO_PROJECTOR,
'statbcc Serial Projector')

(***********************************************************)
(* THE EVENTS GO BELOW *)
(***********************************************************)
DEFINE_EVENT

DATA_EVENT [dvVideoProjector]
{
// Duet Virtual device data events go here
}
You can find this example code within the DEFINE_START section of your code. This code is reflected in the first two entries listed in
FIG. 51. The code gives the Master a “heads-up” notification to look for those devices meeting the criteria outlined within the code.

NX-Series Controllers - WebConsole & Programming Guide 62

 WebConsole - Modules Options

Application Devices and Association Status

There are two types of application devices: Static Bound application devices and Dynamic application devices:
Static Bound application devices specify both a Duet virtual device and its associated Device SDK class type, as well as a
NetLinx physical device port to which the application device is always associated (i.e. statically bound).
Dynamic application devices specify both the Duet virtual device and its associated Device SDK with no association to a
physical port. Binding of an application device to a physical device/port occurs at run-time (either via auto-binding or
manual binding).
Application devices that have a "bound" physical device display their physical device ID within the Physical Device column. If an
associated Duet module has been started to communicate with the device, its associated property information is displayed in a
mouse-over popup dialog when the cursor hovers over the physical device ID (see FIG. 52).
Each entry in the table has one of four buttons to the right of the Physical Device D:P:S assignment:
Static Bound application devices will either be blank, or display a Release button:
Static Bound application devices that have not yet detected a physical device attached to their associated port have a
blank button.
Once a physical device is detected and its associated Duet module has been started, a Release button appears. Click

Release to force the associated Duet module to be destroyed. The firmware then returns to detecting any physical
devices attached to the port.
Dynamic application devices either display a Bind or Unbind button:
Dynamic application devices that have been bound display an Unbind button. When you select Unbind, any associated
Duet module is destroyed and the "link" between the application device and the physical device is broken.
Dynamic application devices that have not been bound to a physical device display a Bind button. When this button is
selected, a secondary display appears with a listing of all available unbound physical devices that match the application
device's Device SDK class type.
NOTE: If a currently bound device needs to be replaced or a Duet Module needs to be swapped out, the device should be unbound and
the new module/driver should then be bound.
The administrator/user can select one of the available physical devices to bind with the associated application device. When you
click Accept, the binding is created and the target Master attempts to locate the appropriate Duet Module driver. Once the Master
locates a driver, the Duet Module started and becomes associated with the specified application device (Duet virtual device). If the
you click Cancel button, the binding activity aborts.
NOTE: If the manufacturer device does not support Dynamic Device Discovery (DDD) beaconing, you must use the Add Device page to
both create and manage those values necessary to add a dynamic physical device. This process is described in detail in the Modules -
User-Def ined Devices section on page 64.
Viewing Physical Device Properties
Hold the mouse cursor over the Physical Device entry in the table to display detailed device properties for that device in a pop-up
window (FIG. 52). You can only view the device properties for bound devices.

FIG. 52 Device Bindings - Device Properties pop-up

NX-Series Controllers - WebConsole & Programming Guide 63

 WebConsole - Modules Options

Modules - User-Def ined Devices

Click the User-Def ined Devices link (in the Manage Devices tab) to access the User-Def ined Devices page (FIG. 53). This page
provides a listing with all of the dynamic devices that have been discovered in the system, and allows you to add and delete
User-Defined Devices.

FIG. 53 Modules - User-Defined Devices

Adding a User-Def ined Device

1. Click the Add Device button (in the User-Defined Devices page) to access the Add User Def ined Device page (FIG. 54):

FIG. 54 User-Defined Devices - Add New Device

2. Fill in the device information fields, as described in the following tables:
User-Def ined Device Information Fields
Address: Enter the address of the physical device in the Address field. This information can be either the NetLinx Master port
value (D:P:S) or an IP Address (#.#.#.#).
Control Method: Use the drop-down list to select the control method associated with the physical target device (IR, IP, Serial, Other).
SDK Class: Use the drop-down list to select the closest Device SDK class type match for the physical target device. The SDK Class
Types table on page 65 provides a listing of the available choices.
GUID: Enter the manufacturer-specified device’s GUID (Global Unique Identification) information. You must specify either the
GUID or Make/Model.
Make: Enter the name of the manufacturer for the device being used (ex: Sony, ONKYO, etc.)
• Up to 55 alpha-numeric characters
• Spaces in the name will be converted to underscores.
Model: Enter the model number of the device being used (ex: Mega-Tuner 1000). You can enter up to 255 alpha-numeric
characters.
Revision Enter the firmware version used by the target device. Text is required within this field. The version must be in the
format: major.minor.micro (where major, minor, and micro are numbers). An example is: 1.0.0 (revision 1.0.0 of the
device firmware).

NX-Series Controllers - WebConsole & Programming Guide 64

 WebConsole - Modules Options

SDK Class Types

Amplifier Digital Video Recorder MultiWindow Text Keypad
AudioConferencer Disc Device PoolSpa TV
AudioMixer Display PreAmp Surround Sound Processor UPS
AudioProcessor Document Camera Receiver Utility
AudioTape HVAC RelayDevice VCR
AudioTunerDevice IODevice RFID System Video Conferencer
Camera Keypad Security System Video Processor
Digital Media Decoder Light Sensor Device Video Projector
Digital Media Encoder Light System Set Top Box Video Wall
Digital Media Server Monitor Slide Projector Volume Controller
Digital Satellite System Motor Switcher Weather

3. When you are finished with creating the profile for the new device, click the Add Property button to access the Name and
Value fields property information for association with the new User Defined Device. This information appears in the Physical
Device Properties for each device. See the Viewing Physical Device Properties section on page 66 for more information.
4. Click the Accept button. The new device is indicated in the list of discovered physical devices (in the User-Def ined Devices
page).

Modules - Active Devices

Click the Active Devices link (in the Manage Devices tab) to access the Active Devices page (FIG. 55). The options on this page
allow you to check devices for compatible Duet Modules.

FIG. 55 Modules - Active Devices

Searching For All Compatible Duet Modules for a Selected Device

1. Click the Search button for any device to search for a Duet Module for that particular device. This action initiates a search for
compatible modules. Modules that are retrieved from either the Internet or from the manufacturer's device are then placed
into the /unbound directory and automatically overwrite any existing module of the same name.
If the device specified a URL in its DDD beacon, the file is retrieved from the URL either over the Internet or from the physical
device itself, provided the device has an inboard HTTP or FTP server.
2. Once a list of all compatible modules is compiled, the list of available Duet Modules appears on this page.
Each module is listed with its calculated “match” value. The greater the “match” value, the better the match between the Duet
Module's properties and the physical device's properties.
3. Select a module and click the Accept button to associate the selected Duet module with the physical device.
NOTE: This action will not affect any currently running Duet module associated with the physical device. The module is associated
with the device upon reboot.

NX-Series Controllers - WebConsole & Programming Guide 65

 WebConsole - Modules Options

Viewing Physical Device Properties

Hold the mouse cursor over the Device entry in the table to display detailed device properties for that device, in a pop-up window
(FIG. 56).

FIG. 56 Active Devices - Device Properties pop-up

NX-Series Controllers - WebConsole & Programming Guide 66

 WebConsole - Switching Options

WebConsole - Switching Options

Switching Overview
The Switching page is used to route the system’s inputs to its outputs during system setup. Each input and output can be labeled
by filling in the Input Name or Output Name field on the Configuration page. The one exception to this statement is the audio input
“Downmix” button, which cannot be renamed.
NOTE: The number of available video and audio inputs and outputs depends on the Enova DGX 100 Series model and the number and
type of boards it contains.
Color-coded Switch Selection and Switching Orientation
Yellow buttons indicate they have been selected but not switched; blue buttons indicate an already routed switch.
TIP: When disconnecting switches, selecting an input or an output in an already routed switch will turn the button from blue to white,
but will leave a thin blue line around the button to indicate it is still active until Take is pressed.
From a cleared state, switching is accomplished from either an input-orientation or an output-orientation depending on whether an
input or an output is selected first. When an input is selected first, the Inputs title bar turns yellow (see FIG. 57) and
“input-orientation switching” is enabled. Multiple outputs can then be selected for the input followed by Take to execute the
switch(es). When an output is selected first, the Outputs title bar turns yellow and “output-orientation switching” is enabled. A
single input can then be selected for the output followed by Take to execute the switch.
Pressing Clear before pressing Take allows you to start over.
NOTE: The default selection (input button highlighted blue) for the Switching pane is Input 1, which also appears in the Input section
of the vertical “Selected” bar to the right. All output buttons that the default selection is routed to are highlighted and also appear in
the Outputs section of the Selected bar. FIG. 57 shows the factory default switch of one-to-all.

A B
C

E
G

FIG. 57 Switching page allows routing of inputs to outputs during system setup

NX-Series Controllers - WebConsole & Programming Guide 67

 WebConsole - Switching Options

Switching Page Components

The Switching page features the following components (labeled alphabetically to correspond to FIG. 57 on previous page):
A Auto Take button (default is unselected) – when checked, this button persists the Auto Take function and remains illuminated until
unchecked. Once an input or output is selected, a click on an output for the input or on an input for an output will execute a switch.
This allows for quick cycling through several inputs for a selected output. Note that when a button is selected, it also appears in the
Configuration page with signal details (for button/signal details, click the Legend button).
Legend button – click to open an additional browser tab (Audio/Video Legend) which displays the legend key with details regarding
the state of the input (source) and output (destination) connections. The browser tab opens in a tearaway tab/window that can be
dragged and dropped as a standalone desktop window for side-by-side reference with the Switcher/Configuration pages.
NOTE: The label on the title bar can be edited in the Input or Output Name f ield on the Conf iguration page.

Title bar

Board state icons

NOTE: If the enclosure does not include a full set of input/output boards, input and output buttons for connectors that are not
available display with a gray Title bar (i.e., No Card).

B Switch Mode buttons – click the A/V (default), Video, or Audio button to select the type of signal to be switched. These buttons
correspond to the available video and audio Virtual Matrices (VMs) in the system. For additional information on the Switch Mode,
see page 69.
C Inputs section – this section contains buttons for each of the available input signals (per selected Switch Mode) in the system.
Click the input button that needs to be switched. Scroll bars on the right-hand side provide access to any inputs on large systems
which are not currently visible.
Downmix button – the Audio Switch Mode must be selected before the Downmix button displays. The input source used for the
downmix signal is selected on the Configuration page.
D Outputs section – this section contains buttons for each of the available output signals in the system. Click the output button(s)
that needs to receive the signal from the currently selected input button. Note that when the currently selected button is an output,
it also appears in the Configuration page with signal details (for button/signal details, click the Legend button). Scroll bars on the
right-hand side provide access to any outputs on large systems which are not currently visible.
Select All and Deselect All buttons – these buttons appear only after an input is selected. Click as necessary to select or deselect all
output buttons.
E Clear button – click to deselect all inputs and outputs (if selected, the Auto Take button state persists) and clear routing status in
the Configuration pane. Note that the Clear button does not disconnect switches. After the Clear button is selected and the input or
one of the outputs already routed is selected, the buttons turn blue to indicate current status. Selecting an output will show status
for the input routed to it, not the other outputs also routed from the same input.
Take button – click to execute the switch for the selected input and output(s). After the switch is made, the current content in the
Switching and Configuration pages persists until further action is taken. Note that the Take button is grayed out until one input and
one or more outputs have been selected for routing; once these conditions are met, the Take button becomes active. After the Take
button is clicked, all of the buttons clear their status.
F Selected status bar (non-editable) – this status bar provides quick visual confirmation of input and output selections and their
status (blue = currently routed; yellow = ready to route, waiting further action; blue outline = currently routed, but deselected in
preparation to disconnect).
G Switcher Setup button options are available on both the Switching page and the Configuration page.
Save and Load buttons – after a system has been set up per the installation’s requirements, the configuration values for the entire
switcher’s state (i.e., currently routed switches, video settings, and audio settings) can be saved and reloaded onto another
system(s) or backup system(s) for reuse. The file type is .xdg with XML content. When the Save button is clicked, the file is saved as
a managed content (non-editable text) file.

NX-Series Controllers - WebConsole & Programming Guide 68

 WebConsole - Switching Options

Group Restore to Default button – click to open the Warning dialog box below, which requires you to select an A/V Group and an
I/O Group to restore to their factory default settings.

Switch Mode
The Switch Mode buttons allow you to choose between switching Audio follow Video (A/V), Video (with embedded audio), or Audio
only.
IMPORTANT: Support for the Audio Switch Mode (VM 2) requires Audio Switching Boards in the enclosure.
A/V and Video input and output ranges cover the basic switching size of the system:
 8x8, 16x16, 32x32, or 64x64
Audio only input and output ranges cover the embedded audio as part of the basic switching size of the system, plus the
audio available on the Audio Switching Boards (ASB) in the expansion slots, plus the assignment of one input as a
downmixed audio channel:
Enova DGX 800: 1-8 embedded audio, 9-16 audio only, 17 downmix audio only
Enova DGX 1600: 1-16 embedded audio, 17-24 audio only, 25 downmix audio only
Enova DGX 3200: 1-32 embedded audio, 33-40 audio only, 41 downmix audio only

Enova DGX 6400: 1-64 embedded audio, 65-80 audio only, 81 downmix audio only

To execute a switch, click the Switch Mode button (otherwise the switch will default to A/V), an Input button, an Output button(s),
and the Take button. (This is called input-oriented switching, also known as one-to-many switching.)
NOTE: If you select an output button f irst (output-oriented switching, which can only be one-to-one switching), you must select an
input button next followed by the Take button, i.e., you cannot select additional outputs before you select the input. If you select an
output button f irst and then the input button, the only way to select multiple outputs is to click the Clear button and click the input
button followed by the output buttons.
To deselect (clear status) of an input button that has already been selected, click another input button or click Clear.
To deselect (clear status) of a single output button that has already been selected (before an input button), click another output
button or Click Clear.
To clear status of an input and any or all output buttons, click Clear.
To disconnect all currently selected outputs for an input, click the Deselect All button followed by clicking Take.
To execute a switch with a downmixed signal,* the Audio Switch Mode must be selected and the input used for the Downmix signal
must be selected on the Configuration page. Click the Downmix button, click the output(s), and click Take.
* Audio Switching Boards must be present for this functionality to work.

NX-Series Controllers - WebConsole & Programming Guide 69

 WebConsole - Switching Options

Conf iguring/Switching the Downmix Signal

When the system contains Audio Switching Boards, one embedded audio signal** can be downmixed and routed at any given time.
** Signal must be Dolby, TrueHD, Dolby Digital, DTS-HD Master Audio, DTS, or 2 CH through 8 CH L-PCM.
When Audio Switch Mode is selected, the “Downmix” input automatically displays as the last analog audio input+1. The Downmix
Input number for each of the Enova 100 Series models is shown in the following table.
Downmix Input #
Enova DGX 800 17
Enova DGX 1600 25
Enova DGX 3200 41
Enova DGX 6400 81

NOTE: The table above also applies to Enova 8/16/32/64 enclosures that have been upgraded with an Enova DGX 100 Series CPU
and that contain Audio Switching Boards.
From the Configuration page – to designate which source will be routed on the Downmix Input, click the Downmix button in the
Switching pane on the left and then select the input from the Downmix Source drop-down list in the Configuration pane on the
right.
Switch Mode must be set to Audio

Downmix Source
routes the selected
input (Input 1 in the
example)

Drop-down list displays

inputs available for
downmixing

Downmix Input button

FIG. 58 Downmix input ready to switch or configure

Designating an Input for Downmixing (from Conf iguration page)

1. In the Switching pane on the left, select Audio Switch Mode.
The Downmix button displays at the end of the input buttons.
2. Select the Downmix button.
3. In the Configuration pane on the right, select the input from the Downmix Source drop-down list.
The Downmix signal is ready to apply any of the configuration options or to execute switches.
4. To use a different input source for downmixing, repeat Steps 1-3 (only one input can be downmixed at a time).

NX-Series Controllers - WebConsole & Programming Guide 70

 WebConsole - Switching Options

Conf iguration Page

The Configuration page is used to configure inputs and outputs in the system. The most recently selected input or output displays
in the Configuration page in accordance with the currently selected Config Viewer button (Recent, Inputs Only, or Outputs Only).
The Configuration page displays the Switching page components compressed on the left. Note that the components are active, i.e.,
they can be used for all switching functionality without needing to return to the full Switching page.
B
A

D
C E

F
G

FIG. 59 Configuration page allows configuration of inputs and outputs

Conf iguration Components

Any changes made in the Configuration page occur instantaneously on the attached devices. In addition, when you select an input
or an output on the left, the options on the right side of the page change to reflect the current settings. Configuration is not
affected by power loss, restarting the enclosure, or upgrading the firmware.
NOTE: The number of available video and audio inputs and outputs depends on the Enova DGX 100 Series model and the number and
type of boards it contains.
A Switching page components – all of the components from the Switching page are compressed and displayed (for details, see
previous section on the “Switching Page”).
Input and Output buttons are selected individually for configuration.
B Input # or Output # Conf iguration heading (large text above the Video and Audio tabs) – changes according to the input or output
currently selected for configuration.
Video (default) and Audio tabbed views – click tabs to configure the video or audio signal that is selected in the Switching view. The
signal will be either input or output depending on the Config Viewer button selection. The setting options vary depending on the
signal.
Conf ig Viewer buttons – the Recent, Inputs Only, and Outputs Only buttons allow you to choose the source or destination signal to
be configured. Settings for the current Config Viewer remain when leaving the page and reactivate upon return. When the Recent
button is clicked, the last selected input or output and its settings display. If no inputs or outputs are selected before opening the
page, then the information will be cleared.
NOTE: When the Inputs Only button is selected, clicking an output button in the Switching components will result in blank
Conf iguration information; the same is true for selecting the Outputs Only button and then clicking an input button.
C Selecting any video or audio signal button will display corresponding information as follows:
Input or Output button – an enlargement of the button selected under Switching (or from the Switching page) appears on the
Configuration side with the source name and number, plus signal details (for an explanation of the button’s details, click the Legend
button).
Video button Audio button

Input Name or Output Name field – use to label the buttons in the Switching pane (and on the Switching page).
Type the name in the field and press Enter on the keyboard.

NX-Series Controllers - WebConsole & Programming Guide 71

 WebConsole - Switching Options

Restore to Default (red) button – click to open the Warning dialog box below, which requires you to select the Yes button to restore
D the currently selected input or output to its factory default settings.

E Video Details or Audio Details button – click to display additional video or audio details for inputs or outputs, depending on current
selection (video: colorSpace, flags, pixelclock, etc.; audio: CTS Value, N Value, Audio Mute State, etc.). Examples of both Video Input
and Output Details are shown below. Audio details are similar.

F Video, DXLink, and Audio settings – the settings section of the Configuration page changes depending on the type of signal,
whether it is an input or an output, and whether a DXLink unit is attached. A variety of interface controls are used to change the
settings (e.g., buttons, sliders, drop-down lists) depending on the values involved. Details for these settings follow this section.
G Switcher Setup button options are available on both the Switching and the Configuration pages.
Save and Load buttons – after a system has been set up per the installation’s requirements, the configuration values for the entire
switcher’s state (i.e., currently routed switches, video settings, and audio settings) can be saved and reloaded onto another
system(s) or backup system(s) for reuse. The file type is .xdg with XML content. When the Save button is clicked, the file is saved as
a non-editable text file.
Group Restore to Default button – click to open the Warning dialog box below, which requires you to select an A/V Group and an
I/O Group to restore to their factory default settings.

IMPORTANT: When selecting a signal to conf igure, the Conf ig Viewer button selection, Inputs Only or Outputs Only, must correspond
to the input or output button selected.

NX-Series Controllers - WebConsole & Programming Guide 72

 WebConsole - Switching Options

Video Settings
Video settings display when the Switch Mode is A/V or Video, the Video tabbed view is selected, and a specific input or output is
selected.
Inputs Only
General:

Resolution – displays Resolution (read-only).

EDID Mode – in the drop-down list, select the resolution type (All Resolutions, Wide-Screen, Full-Screen, or Custom).
Preferred EDID – in the drop-down list, select the specific resolution/refresh rate.

Save EDID button – use to save (persist them in memory) the EDID settings for the currently selected input

Load EDID button – use to load the EDID settings for the currently selected input to other inputs.

HDCP Setting:

HDCP Compliance – if desired, click the check box to enable HDCP compliance.
NOTE: When EDID Mode/All Resolutions is selected, the Preferred EDID drop-down list includes both standard EDIDs and Video
Information Code (VIC) EDIDs (denoted by either a “p” or an “i”). For a complete list of VIC EDIDs for your input boards see the “EDID
Resolutions Supported through Local DDC” section of the applicable board chapter.
Outputs Only
General:

Scaling (Mode) – click the button for the mode (Auto, Manual, or Bypass)
Resolution – in the drop-down list, select the resolution/refresh rate; select the “Show only EDID Display Supported
(DS)” check box if desired.
Aspect Ratio – click either Maintain or Stretch (Zoom and Anamorphic are also available for DXLink outputs).

Save EDID – click this button to save the EDID setting for the currently selected output.

NX-Series Controllers - WebConsole & Programming Guide 73

 WebConsole - Switching Options

Display Settings:

Video Mute – click the check box to mute the video.

Video Freeze – click the check box to freeze the video.
Test Pattern – in the drop-down list, select Off, Color Bar, Gray Ramp, SMPTE Bar, HiLo Trak, Pluge, or X-Hatch.

Blank Color – in the drop-down list, select Black or Blue.

Screen Sleep – click the check box to place the display in sleep mode; in the Sleep Delay (ms) box, set the delay time in

milliseconds.
On-Screen Display:

Enable OSD – click check box to enable.

OSD Color – in the drop-down list, select Black, Blue, White, or Yellow.
OSD Position – in the drop-down list, select Top Left, Top Right, Bottom Left, or Bottom Right.

Image Adjustments:

Brightness – use the slider bar to adjust (range: 0 to 100).

Contrast – use the slider bar to adjust (range: 0 to 100).
NOTE: For additional EDID conf iguration information, see page 79.

NX-Series Controllers - WebConsole & Programming Guide 74

 WebConsole - Switching Options

DXLink Video Settings

DXLink specific video settings display when a DXLink Twisted Pair or DXLink Fiber Transmitter or Receiver (or other DXLink
equipment) is connected to the selected input or output. These settings display in addition to the normal video settings for the
input or output described in the previous section. The Video tabbed view must be selected.
DXLink (Twisted Pair or Fiber) Transmitters (for selected video input)
Video Priority – click either the HDMI, Analog, or Manual button.
AV Source – click Analog or Digital.
Video Type – non-editable.
DXLink Details button – click to display additional settings for the DXLink Transmitter.

TX Settings:
DXLink Quality – green = good; red = poor; number
indicates degree or lack of quality
Firmware Version – current version
Friendly Name – current name
IP Address – for auto-setup, displays integrated
Master’s IP address
Subnet Mask – current setting
D. P. S. – current setting
MAC Address – current setting
Auto-Setup – Status (Enable/Disable) and Force to
Auto-setup button
DIP Settings – indicates settings on DIP switch
Reboot button – reboots TX
Refresh button – updates status of TX settings

VGA Settings (DXLink Twisted Pair only) – use sliders to adjust Phase, Horizontal Shift, and Vertical Shift settings.
IMPORTANT: The DXLink settings are not asynchronous. To obtain the latest information, the Refresh button in the dialog box that
opens when the DXLink Details button is clicked must be clicked.
DXLink (Twisted Pair or Fiber) Receivers (for selected video output)
DXLink Details button – click to display additional settings for the DXLink Receiver.
RX Settings:
DXLink Quality – green = good; red = poor; number
indicates degree or lack of quality
Firmware Version – current version
Friendly Name – current name
IP Address – for auto-setup, displays integrated
Master’s IP address
Subnet Mask – current setting
D. P. S. – current setting
MAC Address – current setting
Auto-Setup – Status (Enable/Disable) and Force to
Auto-setup button
DIP Settings – indicates settings on DIP switch
Reboot button – reboots RX
Refresh button – updates status of RX settings

NX-Series Controllers - WebConsole & Programming Guide 75

 WebConsole - Switching Options

Audio Settings
Audio settings display when the Switch Mode is A/V or Audio (for details, see page 69), the Audio tabbed view is selected, and a
specific input or output is selected. The audio settings can be used to configure any digital signal processing required for the audio
signal that is selected in the Switching view.
Inputs Only
General:

Stereo or Mono buttons – click either.*

Input Gain (dB) – use the slider bar to adjust (-24 dB to +24 dB),
Encoding – PCM (read only)

EDID Mode – from the drop-down list, select the mode (Basic, PCM 2-Channel, PCM Multi-Channel, Dolby Digital,

Dolby Digital + DTS, Dolby Digital + MPEG, Dolby Digital + AAC, Dolby TrueHD, or DTS HD Master).
Compression:

Buttons at top – click Off, Low, Medium, High, or Custom.

Threshold – use the slider bar to adjust (range: 0 to -60).
Attack (ms), Release (ms), and Ratio – adjust the values in the boxes (either enter values or use the arrows)

NOTE: When in Low, Medium, or High, changes to any of the other Compression settings will automatically change the Compressor
mode to Custom.
* Setting this option to “Mono” audio on the input results in the left channel being sent to both the left and right output channels.

NX-Series Controllers - WebConsole & Programming Guide 76

 WebConsole - Switching Options

Outputs Only
General settings:

 Encoding – PCM (read only).

 Output Format – click Stereo or Mono.*
Test Tone Enable – click Disable or Enable.

Test Tone Generator – from the drop-down list, select Off, 60Hz, 250Hz, 400Hz, 1kHz, 3kHz, 5kHz, 10kHz, Pink Noise, or

White Noise.
Audio Routing – click Embedded or Switched.**

* Setting this option to “Mono” audio on the output results in the left and right channels being combined and sent to both the left
and right output channels equally.
** With Audio Switching Boards in the system, Audio Routing defaults to Switched.
Levels & Delay:

 Mute – click Mute if desired.***

 Output Volume (0 to 100)
Min/Max (0 to 100)

Balance (-20 to 20, left to right)

Sync Delay (ms) (0 to 200).

*** Changing the volume level will not un-mute the signal; however, the new volume level is saved and when the Mute button is
deselected, the volume returns at the new level.
10-Band Parametric Equalizer:

Enabled – this check box must be selected before the Equalizer options are available.*
Tone Adjust – use the drop-down box to select: Off, Voice, Music, or Movie (Tone Adjust is applied on top of any
equalizer adjustments).
Reset EQ – click this button to reset the all of the Equalizer values.

NX-Series Controllers - WebConsole & Programming Guide 77

 WebConsole - Switching Options

Blue Handles – use the sliders (blue handles) to adjust Equalizer values.
The following drop-down lists can also be used to adjust Equalizer values.
Band – numbered from 1 to 10.

Filter – the options are Bell, Band Pass, Band Stop, High Pass, Low Pass, Treble Shelf, and Bass Shelf.

Frequency – the adjustment range is from 20 to 20000 (Hz).

Gain – the adjustment range is from -12 to 12.

Q – the adjustment range depends on the filter selected:

Bell = 0.1 to 20
Band Pass = 0.1 to 20
Band Stop = 0.1 to 20
High Pass = 0.5 to 1.4
Low Pass = 0.5 to 1.4
Treble Shelf = 0.5 to 1
Bass Shelf = 0.5 to 1
* On reboot, the Enabled box always returns to the checked (default) state. To disable the Equalizer options over a reboot, set the
“y” (vertical) vertex to 0 (zero).
DXLink Audio Settings
DXLink specific audio settings display when a DXLink Twisted Pair or DXLink Fiber Transmitter or Receiver (or other DXLink
equipment) is connected to the selected input or output. These settings display in addition to the normal audio settings for the
input or output described in the previous section. The Audio tabbed view must be selected.
DXLink (Twisted Pair or Fiber) Transmitter (for selected audio input)

Audio Priority – click either the Auto or Manual button.

Audio Source – click either the HDMI, SPDIF, or Analog button
DXLink Details button – click to display additional settings for the DXLink Transmitter.

TX Settings:
DXLink Quality – green = good; red = poor; number
indicates degree or lack of quality
Firmware Version – current version
Friendly Name – current name
IP Address – for auto-setup, displays integrated
Master’s IP address
Subnet Mask – current setting
D. P. S. – current setting
MAC Address – current setting
Auto-Setup – Status (Enable/Disable) and Force
to Auto-setup button
DIP Settings – indicates settings on DIP switch
Reboot button – reboots TX
Refresh button – updates status of TX settings

NX-Series Controllers - WebConsole & Programming Guide 78

 WebConsole - Switching Options

DXLink (Twisted Pair or Fiber) Receivers (for selected audio output)

Active Output – click either the HDMI, Analog, or All button.

DXLink Details button – click to display additional settings for the DXLink Receiver.

RX Settings:
DXLink Quality – green = good; red = poor; number
indicates degree or lack of quality
Firmware Version – current version
Friendly Name – current name
IP Address – for auto-setup, displays integrated
Master’s IP address
Subnet Mask – current setting
D. P. S. – current setting
MAC Address – current setting
Auto-Setup – Status (Enable/Disable) and Force to
Auto-Setup button
DIP Settings – indicates settings on DIP switch
Reboot button – reboots RX
Refresh button – updates status of RX settings

EDID Conf iguration

NOTE: Because signals routed through HDMI, DVI, DXLink Twisted Pair, and DXLink Fiber Boards in an Enova DGX 100 Series Switcher
normally produce a quality image, you will not need the information in this section unless the installation has special EDID
requirements.
A default EDID (Extended Display Identification Data) is stored on the boards. This data is provided by the display and presented to
the video source and includes timing and display size/format information for best performance.
Setting an EDID for an Input:
1. From Configuration page / Switch Mode (on the left), click the Video button.
2. Check to be sure the Config Viewer on the top right is set to Inputs Only.
3. From the Switching pane on the left, select the video input.
4. Under General settings from the EDID Mode drop-down list, select the mode (All Resolutions, Wide-Screen, Full-Screen, or
Custom).
5. Select the Preferred EDID from the drop-down list of resolutions/refresh rates.
6. Click the Save EDID button.*
* Once the preferred EDID is saved, it can be loaded to another input(s).
Setting an EDID for an Output:
1. From Configuration page / Switch Mode (on the left), click the Video button.
2. Check to be sure the Config Viewer on the top right is set to Outputs Only.
3. From the Switching pane on the left, select the video output.
4. Under General settings from the Resolution drop-down list, select the resolution/refresh rate.**
5. Under General settings, click the Save EDID button.
** Click the “Show only EDID Display Supported (DS)” check box to narrow the drop-down list to show only those resolution/
refresh rate options marked DS (Display Supported).
Setting the EDID Mode for an Audio Input:
1. From Configuration page / Switch Mode (on the left), click the Audio button.
2. Check to be sure the Config Viewer on the top right is set to Inputs Only.
3. From the Switching page components on the left, select the audio input.
4. Under General settings from the EDID Mode drop-down list, select the mode: Basic, PCM 2-Channel, PCM Multi-Channel,
Dolby Digital, Dolby Digital + DTS, Dolby Digital + MPEG, Dolby Digital + AAC, Dolby TrueHD, or DTS HD Master.
Loading and Saving EDIDs
For custom EDIDs, click the Load EDID button and browse for the .edid file on your device/computer. Once the EDID is loaded, make
any necessary changes and use the Save EDID button to save the altered .edid file to your device/computer.
NOTE: Some devices run on a secured f ile-system. As such, f ile-system operations (e.g., Load and Save operations) may not be
supported by the device’s default capabilities and may require downloading a f ile manager application.

NX-Series Controllers - WebConsole & Programming Guide 79

 WebConsole - Switching Options

Status Page
The Status page is used to check a number of the switcher’s components and their states. The components (from top to bottom of
page) display status for Alarms, the Chassis, the Master CPU Board, Input and Output Boards, and Input and Output Expansion
Audio Boards. A quick glance at this page will indicate whether the system is running okay (green text will state OK) or if any thing
is failing (red text will state FAIL.)
IMPORTANT: The Status page settings are not asynchronous. To obtain the latest information, the Refresh button must be clicked.
The example provided in the figure below is based on an Enova DGX 3200 Switcher with two each standard Input and Output
Boards, as well as two Expansion Audio Boards.

G
F

FIG. 60 Status page indicates status of system components

NX-Series Controllers - WebConsole & Programming Guide 80

 WebConsole - Switching Options

System Auto-Setup check box – select to place the system in auto-setup mode (i.e., the mode wherein the system requires only a
A single IP address for the integrated Master, and each endpoint is automatically configured for communication via a private LAN
hosted by the integrated Master).
The following must be adhered to when using auto-setup mode (default):
 Endpoints must be set to DHCP Mode (default)
 Endpoints must use NDP Master connection mode (default)
 Endpoints must not be currently bound (traditional NetLinx binding) to a Master
 Endpoints DIP switch setting for Toggle #3 (network connectivity) is ignored while in auto-setup mode
NOTE: Some devices run on a secured f ile-system. As such, f ile-system operations (e.g., Load and Save operations) may not be
supported by the device’s default capabilities and may require downloading a f ile manager application.
Alarms – if any are red, consult the individual Fan, Power, and Temperature components on the page to help pinpoint the location of
the problem.
Refresh button – if necessary, use the Refresh button to view system status changes.

B Chassis f ield – this field contains readouts for individual fan speeds, individual power supply status, and the current temperature of
the chassis (shown in degrees Celsius). Each readout displays in a color to convey statuses of OK, Fail, or no problems detected
(black). Fan speed information is displayed by individual fans (Fan #) and the fan assembly where each fan is located (FAN ASM #).
Power supply and temperature information is available in each switcher’s General Specifications table in the “Product Overview and
General Specifications” chapter.

Master CPU (MCPU) Board f ield – this field displays information for Status, Model number of the integrated Master, FG (part)
C number, Version, Temperature (actual degrees in Celsius with OK or FAIL status), and Power (OK or FAIL status).
Input and Output Board f ields – these fields give detailed information for each input or output board in the enclosure: Slot, Status,
D Type, FG (part) number, Version, Temperature (actual degrees in Celsius with OK or FAIL status), and Power (OK or FAIL status). A
red Reboot button at the right cycles power to the individual board.
Input and Output Audio Expansion Boards f ields – these fields give detailed information for each expansion input or output board
E in the enclosure: Slot, Status, Type, FG (part) number, Version, Temperature (actual degrees in Celsius with OK or FAIL status), and
Power (OK or FAIL status). A red Reboot button at the right cycles power to the individual board.
Switcher Setup (Save, Load, and Group Restore to Default) buttons – after a system has been set up per the installation’s
F
requirements, the configuration can be saved and reloaded onto another system(s) or backup system(s) for reuse. The Group
Restore to Default button returns the system to its last previously saved state. This button will restore control values to default
(initial) values. (This Restore button performs the same function for the entire system as the Configuration page’s Restore to
Default button does for individual inputs or outputs.)

G Refresh button – if necessary, use the Refresh button to view system status changes.

System Conf iguration Interface Tips

To change the network connection type from DHCP (default) to Static IP – navigate to Network/IPv4; click on Specific IP
Address; enter values into the IP Address, Subnet Mask, and Gateway fields; then click Accept.
To enable/disable auto-setup ¡V navigate to Switcher/Status; click the System Auto-Setup check box to add a check mark
(enabled) or remove a check mark (disabled).
To route audio without the benefit of audio options available via the interface – navigate to Switcher/Configuration; select
Audio Switch Mode; select Outputs Only in the Config Viewer options; select the desired output; select Switched Audio
Routing from the General options.

NX-Series Controllers - WebConsole & Programming Guide 81

 NetLinx Programming

NetLinx Programming
Overview
This section describes the Send_Commands, Send_Strings, and Channel commands you can use to program the Master. The
examples in this section require a declaration in the DEFINE_DEVICE section of your program to work correctly.
Refer to the NetLinx Programming Language instruction manual for specifics about declarations and DEFINE_DEVICE information.
NOTE: All f ile names on the X-Series controllers are case sensitive. This includes all user f iles created or used within NetLinx or Java
code. If you have legacy code that uses f iles, it is important that you verify that every reference to each f ile is consistent with regard
to case. If your legacy code generates an error when accessing a f ile, it is likely due to inconsistent use of case in the f ilename.

Port Assignments by NetLinx Master

The following table lists the port assignments for NetLinx Masters:
Port Assignments By Master
Master RS-232 RS-232/422/485 IR/Serial IR/RX Relays I/O PoE
NX-1200 Port 2 Port 1 Ports 11-12 Port 20 N/A Port 22 N/A
NX-2200 Ports 2-4 Port 1 Ports 11-14 N/A Port 21 Port 22 N/A
NX-3200 Ports 2-4, 6-8 Ports 1, 5 Ports 11-18 N/A Port 21 Port 22 N/A
NX-4200 Ports 2-4, 6-8 Ports 1, 5 Ports 11-18 N/A Port 21 Port 22 Ports 24-27

Port Assignments by All-in-One-Presentation Switcher

The following table lists the port assignments for Enova All-in-One Presentation Switchers:
Port Assignments By Enova All-in-One Presentation Switcher
Master RS-232 RS-232/422/485 IR/Serial Relays I/O
DVX-22xxHD Ports 2-4 Port 1 Ports 11-14 Port 21 Port 22
DVX-325xHD Ports 2-4, 6-8 Ports 1, 5 Ports 11-18 Port 21 Port 22

Port Assignments by Massio ControlPad

The following table lists the port assignments for Massio ControlPads:
Port Assignments By ControlPad
ControlPad RS-232 IR/Serial Relays I/O NetLinx
MCP-106 Port 1 Port 11 N/A N/A Port 28
MCP-108 Ports 1-2 Ports 11-12 Port 21 Port 22 Port 28

NX-Series Controllers - WebConsole & Programming Guide 82

 NetLinx Programming

Serial, IR, AxLink, and PoE Port Diagnostics

When a string is sent to a serial port or an IR pulse to an IR port, the X-Series controllers can detect and report if the port being
used is in a fault condition. The controllers can also detect certain fault conditions on the AxLink bus. The following fault conditions
are recognized:
The serial cable is not connected
The Serial pin is connected to another pin
The IR emitter is not connected
The IR emitter is wired backwards
One or both AxLink bus data pins are shorted to power or ground
The maximum power for all PoE ports (72W) has been exceeded or the power supply voltage is outside of the
recommended limits
The maximum current for a single PoE port has been exceeded or the load has disconnected from an individual port
On the first attempt to use a port that is in a fault condition, the controller will do the following:
Quickly flash the front panel LED of the port being used 10 times
Generate an ONERROR data event in NetLinx
Report the error to any Duet Module that has claimed the port
Report the error to RMS if the controller is connected to an RMS server
Set an error flag for that port
The status of the error flag can be queried using the GET FAULT NetLinx command, which will result in a DATA EVENT where the
return status can be parsed.
NOTE: If the fault condition persists, subsequent attempts to use the same port will only result in the quick flashing of the front panel
LED. The ONERROR event and the reporting to a Duet Module or RMS only occur on the f irst attempt after booting or after the fault
status is cleared. This prevents a flood of redundant error messages when a faulted port is used continuously.
The fault status is cleared on a successful transmission over the port, and also can be cleared manually using the CLEAR FAULT
NetLinx command.
For serial and IR ports, an error condition is only checked at the time the port is used, so unused serial and IR ports will not
generate errors. AxLink bus errors are checked at boot time.

NX-Series Controllers - WebConsole & Programming Guide 83

 NetLinx Programming

Master SEND_COMMANDs
These commands are specific to the Master and not the Controller. These commands are sent to the DPS 0:1:0 (the Master you are
connected to).
A device (<DEV>) must first be defined in the NetLinx programming language with values for the Device: Port: System (<D:P:S>).
Master SEND_COMMANDs
Command Description
CLOCK Set the date and time on the Master. The date and time settings are propagated over the local bus.
Syntax:
SEND_COMMAND <DEV>,"'CLOCK <mm-dd-yyyy> <hh:mm:ss>'"
Variables:
mm-dd-yyyy = Month, day, and year. Month and day have 2 significant digits. Year has 4 significant digits.
hh-mm-ss = Hour, minute, and seconds. Each using only 2 significant digits.
Example:
SEND_COMMAND 0,"'CLOCK 04-12-2005 09:45:31'"
Sets the Master's date to April 12, 2005 with a time of 9:45 am.
G4WC Add G4 Web Control devices to Web control list displayed by the Web server in a browser. The internal G4WC
Send command (to Master 0:1:0) has been revised to add G4 Web Control devices to Web control list displayed
in the browser.
Syntax:
SEND_COMMAND <D:P:S>,"'G4WC "Name/Description",IP Address/URL,IP Port,Enabled'"
Variables:
• Name/Description = A string, enclosed in double quotes, that is the description of the G4 Web Control
instance. It is displayed in the browser.
• IP Address/URL = A string containing the IP Address of the G4 Web Control server, or a URL to the G4 Web
Control server.
• IP Port = A string containing the IP Port of the G4 Web Control Server.
• Enabled = 1 or 0. If it is a 1 then the link is displayed. If it is a 0 then the link is disabled.
The combination of Name/Description, IP Address/URL, and IP Port are used to determine each unique
listing.
Example:
SEND_COMMAND 0:1:0,"'G4WC "Bedroom",192.168.1.2,5900,1'"
Adds the BEDROOM control device using the IP Address of 192.168.1.2.
~IGNOREEXTERNAL Set the Master so that it cannot have it’s time set by another device which generates a ‘CLOCK’ command.
CLOCKCOMMANDS Syntax:
SEND_COMMAND <D:P:S>,"'~IGNOREEXTERNALCLOCKCOMMANDS'"
Example:
SEND_COMMAND 0:1:0,"'~IGNOREEXTERNALCLOCKCOMMANDS'"

NX-Series Controllers - WebConsole & Programming Guide 84

 NetLinx Programming

Master IP Local Port SEND_COMMANDs

These commands are specific to the Master and not the Controller. These commands are sent to the DPS 0:1:0 (the Master). A
device must first be defined in the NetLinx programming language with values for the Device: Port: System.
In these programming examples, <DEV> = Device. The term <D:P:S> = Device:Port:System.
Master IP Local Port SEND_COMMANDs
Command Description
UDPSENDTO Set the IP and port number of the UDP local ports destination for sending future packets. This is only available for Type 2
and Type 3 Local Ports. Type 2 and Type 3 are referring to the protocol type that is part of the IP_CLIENT_OPEN call (4th
parameter).
Type 1 is TCP.
Type 2 is UDP (standard)
Type 3 is UDP (2 way)
The NetLinx.axi defines constants for the protocol types:
CHAR IP_TCP = 1
CHAR IP_UDP = 2
CHAR IP_UDP_2WAY = 3
Syntax:
SEND_COMMAND <D:P:S>,"'UDPSENDTO-<IP or URL>:<UDP Port Number>'"
Variables:
• IP or URL = A string containing the IP Address or URL of the desired destination.
• UDP Port Number = A String containing the UDP port number of the desired destination.
Example 1:
SEND_COMMAND 0:3:0,"'UDPSENDTO-192.168.0.1:10000'"
Any subsequent SEND_STRING to 0:3:0 are sent to the IP Address 192.168.0.1 port 10000.
Example 2:
SEND_COMMAND 0:3:0,"'UDPSENDTO-myUrl.com:15000'"
Any subsequent SEND_STRING to 0:3:0 are sent to the URL myURL.com port 15000.

NX-Series Controllers - WebConsole & Programming Guide 85

 NetLinx Programming

SSH SEND_COMMANDs
These command open or close SSH communication with a server:
SSH SEND_COMMANDs
SSH_CLIENT_CLOSE Closes an open SSH communication port with a server.
Syntax:
SEND_COMMAND <DEV>,"'SSH_CLIENT_CLOSE(LocalPort)'
Parameters:
• LocalPort - A user-defined (non-zero) integer value representing the local port on the client machine to use for
this conversation. This local port number must be passed to SSH_CLIENT_OPEN to open the conversation.
Returns:
This function always returns 0. Errors are returned via the DATA_EVENT ONERROR method. The following errors
may be returned from the call:
2 - General failure (out of memory)
4 - Unknown host
6 - Connection refused
7 - Connection timed out
8 - Unknown connection error
9 - Already closed
14 - Local port already used
16 - Too many open sockets
Example:
SEND_COMMAND <DEV>,"'SSH_CLIENT_CLOSE(5000)'"
SSH_CLIENT_OPEN Opens a port for SSH communication with a server.
Syntax:
SEND_COMMAND <DEV>,"'SSH_CLIENT_OPEN(LocalPort, ServerAddress, remotePort, username,
password, privateKeyPathname, privateKeyPassphrase)'"
Parameters:
• LocalPort- A user-defined (non-zero) integer value representing the local port on the client machine to use for
this conversation. This local port number must be passed to SSH_CLIENT_CLOSE to close the conversation.
• ServerAddress - A string containing either the IP address (in dotted-quad-notation) or the domain name of the
server to which you want to connect.
• remotePort - The port number on the server that identifies the program or service that the client is requesting,
typically 22
• username - Login user name
• password - Password for the user name, null if using PKI
• privateKeyPathname - Path to private key
• privateKeyPassphrase - Password for private key.
Returns:
This function always returns 0. Errors are returned via the DATA_EVENT ONERROR method. The following errors
may be returned from the call:
2 - General failure (out of memory)
4 - Unknown host
6 - Connection refused
7 - Connection timed out
8 - Unknown connection error
9 - Already closed
14 - Local port already used
16 - Too many open sockets
Example:
SEND_COMMAND <DEV>,"'SSH_CLIENT_OPEN(5000, '192.168.0.1', 22, 'user1', 'password', '/
certs/id_rsa', '')'"

NX-Series Controllers - WebConsole & Programming Guide 86

 NetLinx Programming

LED SEND_COMMANDs
NOTE: The following sections only apply to the integrated controller component of the NX-series controllers.
The following commands enable or disable the LEDs on the Controller.
In the examples: <DEV> = Port 1 of the device. Sending to port 1 of the controller affects all ports.
LED SEND_COMMANDs
Command Description
LED-DIS Disable all LEDs (on 32 LED hardware) for a port. Regardless of whether or not the port is active, the LED will not be
lit.
Issue this command to port 1 to disable all the LEDs on the Controller.
When activity occurs on a port(s) or Controller, the LEDs will not illuminate.
Syntax:
SEND_COMMAND <DEV>,"'LED-DIS'"
Example:
SEND_COMMAND Port_1,"'LED-DIS'"
Disables all the LEDs on Port 1 of the Controller.
LED-EN Enable the LED (on 32 LED hardware) for a port. When the port is active, the LED is lit. When the port is not active,
the LED is not lit.
Issue the command to port 1 to enable the LEDs on the Controller (default setting). When activity occurs on a
port(s) or Controller, the LEDs illuminate.
Syntax:
SEND_COMMAND <DEV>,'LED-EN'
Example:
SEND_COMMAND System_1,'LED-EN'
Enables the System_1 Controller's LEDs.

RS232/422/485 Ports Channels

RS-232/422/485 Port Assignments By Master
Master RS-232 RS-232/422/485
NX-1200 Port 2 Port 1
NX-2200 Ports 2-4 Port 1
NX-3200 Ports 2-4, 6-8 Ports 1, 5
NX-4200 Ports 2-4, 6-8 Ports 1, 5
DVX-22xxHD Ports 2-4 Port 1
DVX-325xHD Ports 2-4, 6-8 Ports 1, 5
MCP-106 Port 1 N/A
MCP-108 Ports 1-2 N/A

RS232/422/485 Ports Channels

255 - CTS push channel Reflects the state of the CTS input if a 'CTSPSH' command was sent to the port.

NOTE: Massio ControlPads do not support RS-422 or RS-485 communications to other devices.

NX-Series Controllers - WebConsole & Programming Guide 87

 NetLinx Programming

RS-232/422/485 SEND_COMMANDs
RS-232/422/485 SEND_COMMANDs
Command Description
B9MOFF Disables 9-bit in 232/422/455 mode. By default, this returns the communication settings on the serial port to the last
programmed parameters. This command works in conjunction with the 'B9MON' command.
Syntax:
SEND_COMMAND <DEV>,"'B9MOFF'"
Example:
SEND_COMMAND RS232_1,"'B9MOFF'"
Sets the RS-232 port settings to match the port's configuration settings.
B9MON Override and set the current communication settings and parameters on the RS-232 serial port to 9 data bits with one
stop bit. This command works in conjunction with the 'B9MOFF' command.
Syntax:
SEND_COMMAND <DEV>,"'B9MON'"
Example:
SEND_COMMAND RS232_1,"'B9MON'"
Resets the RS-232 port's communication parameters to nine data bits, one stop bit, and locks-in the baud rate.
CHARD Set the delay time between all transmitted characters to the value specified (in 100 Microsecond increments).
Syntax:
SEND_COMMAND <DEV>,"'CHARD-<time>'"
Variable:
time = 0 - 255. Measured in 100 microsecond increments.
Example:
SEND_COMMAND RS232_1,"'CHARD-10'"
Sets a 1-millisecond delay between all transmitted characters.
CHARDM Set the delay time between all transmitted characters to the value specified (in 1-Millisecond increments).
Syntax:
SEND_COMMAND <DEV>,"'CHARDM-<time>'"
Variable:
time = 0 - 255. Measured in 1 millisecond increments.
Example:
SEND_COMMAND RS232_1,"'CHARDM-10'"
Sets a 10-millisecond delay between all transmitted characters.
CLEAR FAULT Forces a reset back to normal status.
Syntax:
SEND_COMMAND <DEV>, "'CLEAR FAULT'"
Example:
SEND_COMMAND RS232_1,"'CLEAR FAULT'"
CTSPSH Enable Pushes, Releases, and Status information to be reported via channel 255 using the CTS hardware handshake
input. This command turns On (enables) channel tracking of the handshaking pins.
If Clear To Send (CTS) is set high, then channel 255 is On.
Syntax:
SEND_COMMAND <DEV>,"'CTSPSH'"
Example:
SEND_COMMAND RS232_1,"'CTSPSH'"
Sets the RS232_1 port to detect changes on the CTS input.
CTSPSH OFF Disable Pushes, Releases, and Status information to be reported via channel 255. This command disables tracking. Turns
CTSPSH Off.
Syntax:
SEND_COMMAND <DEV>,"'CTSPSH OFF'"
Example:
SEND_COMMAND RS232_1,"'CTSPSH OFF'"
Turns off CTSPSH for the specified device.

NX-Series Controllers - WebConsole & Programming Guide 88

 NetLinx Programming

RS-232/422/485 SEND_COMMANDs (Cont.)

Command Description
GET BAUD Get the RS-232/422/485 port’s current communication parameters. The port sends the parameters to the device that
requested the information.
The port responds with:
<port #>,<baud>,<parity>,<data>,<stop> [422] or [485] <ENABLED | DISABLED>
NOTE: The RS-232 ports on Massio ControlPads are RS-232 only, so sending this SEND_COMMAND to enable or
disable 422 or 485 mode on a Massio ControlPad via Telnet will have no effect on the ControlPad, and the
ControlPad also will not return an error message.
Syntax:
SEND_COMMAND <DEV>,"'GET BAUD'"
Example:
SEND_COMMAND RS232_1,"'GET BAUD'"
System response example:
Device 1,38400,N,8,1 422/485 DISABLED
GET FAULT Check the activation status of fault detection on the port.
Syntax:
SEND_COMMAND <DEV>, "’GET FAULT’"
Example:
SEND_COMMAND RS232_1,"’GET FAULT’"
Responds with a COMMAND event: DISABLED, NONE, or NO DEVICE.
GET STATUS Check the fault detection status of the port.
Syntax:
SEND_COMMAND <DEV>, "’GET STATUS’"
Example:
SEND_COMMAND RS232_1,"’GET STATUS’"
Responds with a COMMAND event: STATUS: NORMAL or STATUS: FAULT.
HSOFF Disable hardware handshaking (default).
Syntax:
SEND_COMMAND <DEV>,"'HSOFF'"
Example:
SEND_COMMAND RS232_1,"'HSOFF'"
Disables hardware handshaking on the RS232_1 device.
HSON Enable RTS (ready-to-send) and CTS (clear-to-send) hardware handshaking.
NOTE: This SEND_COMMAND is not compatible with Massio ControlPads. While you may execute this command via
Telnet, the command will have no effect on the ControlPad, and the ControlPad also will not return an error
message.
Syntax:
SEND_COMMAND <DEV>,"'HSON'"
Example:
SEND_COMMAND RS232_1,"'HSON'"
Enables hardware handshaking on the RS232_1 device.
RXCLR Clear all characters in the receive buffer waiting to be sent to the Master.
Syntax:
SEND_COMMAND <DEV>,"'RXCLR'"
Example:
SEND_COMMAND RS232_1,"'RXCLR'"
Clears all characters in the RS232_1 device's receive buffer waiting to be sent to the Master.
RXOFF Disable the transmission of incoming received characters to the Master.
Syntax:
SEND_COMMAND <DEV>,"'RXOFF'"
Example:
SEND_COMMAND RS232_1,"'RXOFF'"
Stops the RS232_1 device from transmitting received characters to the Master.
RXON Start transmitting received characters to the Master (default).
Enables sending incoming received characters to the Master.
This command is automatically sent by the Master when a 'CREATE_BUFFER' program instruction is executed.
Syntax:
SEND_COMMAND <DEV>,"'RXON'"
Example:
SEND_COMMAND RS232_1,"'RXON'"
Sets the RS232_1 device to transmit received characters to the Master.

NX-Series Controllers - WebConsole & Programming Guide 89

 NetLinx Programming

RS-232/422/485 SEND_COMMANDs (Cont.)

Command Description
SET BAUD Set the RS-232/422/485 port's communication parameters.
NOTE: On NX-series controllers, ports 1&5 support RS-232, RS-422, or RS485. The three modes are mutually
exclusive. Setting any of the three modes disables the other two.
NOTE: The RS-232 ports on Massio ControlPads are RS-232 only, so sending the SEND_COMMAND to Enable 422 or
485 mode on a Massio ControlPad via Telnet will have no effect on the ControlPad, and the ControlPad will not
return an error message.
Syntax:
SEND_COMMAND <DEV>,"'SET BAUD <baud>,<parity>,<data>,<stop> [422 Enable | 485 Enable]'"
NOTE: Serial modes are mutually exclusive. RS-232 is specif ied by omitting 422 Enable and 485 Enable. Enabling
422 effectively disables 232 and 485. Enabling 485 effectively disables 232 and 422.
Variables:
baud = baud rates are: 115200, 76800, 57600, 38400, 19200, 9600, 4800, 2400, 1200, 600, 300, 150.
parity = N (none), O (odd), E (even), M (mark), S (space).
data = 8 data bits.
stop = 1 and 2 stop bits.
422 Enable = Enables 422 (Disables 232/485)
485 Enable = Enables 485 (Disables 232/422)
NOTE: The only valid 9 bit combination is (baud),N,9,1.
Example:
SEND_COMMAND RS232_1,"'SET BAUD 115200,N,8,1 485 ENABLE'"
Sets the RS232_1 port's communication parameters to 115,200 baud, no parity, 8 data bits, 1 stop bit, and enables
RS-485 mode.
SET FAULT Disables fault detection on the port. Fault detection is turned on by default.
DETECT OFF Syntax:
SEND_COMMAND <DEV>, "'SET FAULT DETECT OFF'"
Example:
SEND_COMMAND RS232_1,"'SET FAULT DETECT OFF'"
SET FAULT Enables fault detection on the port. Fault detection is turned on by default.
DETECT ON Syntax:
SEND_COMMAND <DEV>, "’SET FAULT DETECT ON’"
Example:
SEND_COMMAND RS232_1,"’SET FAULT DETECT ON’"
TSET BAUD Temporarily set the RS-232/422/485 port's communication parameters for a device. TSET BAUD works the same as SET
BAUD, except that the changes are not permanent, and the previous values will be restored if the power is cycled on the
device.
NOTE: On NX-series controllers, ports 1&5 support RS-232, RS-422, or RS485. The three modes are mutually
exclusive. Setting any of the three modes disables the other two.
NOTE: The RS-232 ports on Massio ControlPads are RS-232 only, so sending the SEND_COMMAND to Enable 422 or
485 mode on a Massio ControlPad via Telnet will have no effect on the ControlPad, and the ControlPad will not
return an error message.
Syntax:
SEND_COMMAND <DEV>,"'SET BAUD <baud>,<parity>,<data>,<stop> [422 Enable | 485 Enable]'"
NOTE: Serial modes are mutually exclusive. RS-232 is specif ied by omitting 422 Enable and 485 Enable. Enabling
422 effectively disables 232 and 485. Enabling 485 effectively disables 232 and 422.
Variables:
baud = baud rates are: 115200, 57600, 38400, 19200, 9600, 4800, 2400, 1200, 600, 300.
parity = N (none), O (odd), E (even), M (mark), S (space).
data = 8 or 9 data bits.
stop = 1 or 2 stop bits.
422 Enable = Enables 422 (Disables 232/485)
485 Enable = Enables 485 (Disables 232/422)
NOTE: The only valid 9 bit combination is (baud),N,9,1.
Example:
SEND_COMMAND RS232_1,"'TSET BAUD 115200,N,8,1 485 ENABLE'"
Sets the RS232_1 port's communication parameters to 115,200 baud, no parity, 8 data bits, 1 stop bit, and enables
RS-485 mode.

NX-Series Controllers - WebConsole & Programming Guide 90

 NetLinx Programming

RS-232/422/485 SEND_COMMANDs (Cont.)

Command Description
TXCLR Stop and clear all characters waiting in the transmit out buffer and stops transmission.
Syntax:
SEND_COMMAND <DEV>,"'TXCLR'"
Example:
SEND_COMMAND RS232_1,"'TXCLR'"
Clears and stops all characters waiting in the RS232_1 device's transmit buffer.
XOFF Disable software handshaking (default).
Syntax:
SEND_COMMAND <DEV>,"'XOFF'"
Example:
SEND_COMMAND RS232_1,"'XOFF'"
Disables software handshaking on the RS232_1 device.
XON Enable software handshaking.
Syntax:
SEND_COMMAND <DEV>,"'XON'"
Example:
SEND_COMMAND RS232_1,"'XON'"
Enables software handshaking on the RS232_1 device.

NX-Series Controllers - WebConsole & Programming Guide 91

 NetLinx Programming

RS-232/422/485 SEND_STRING Escape Sequences

NX Controllers also use some special SEND_STRING escape sequences. Use the ESCSEQON and ESCSEQOFF NetLinx
SEND_COMMANDS to control whether escape sequences are active. The ESCSEQON command must precede the Escape
Sequences, otherwise strings will be processed normally. These commands are sent to Port 1. Escape sequences are disabled by
default.
If any of the 3 character combinations below are found anywhere within a SEND_STRING program instruction, they will be treated
as a command and not the literal characters.
In these examples: <DEV> = device.
RS-232/422/485 SEND_STRING Escape Sequences
Command Description
27,17,<time> Send a break character for a specified duration to a specific device.
Syntax:
SEND_STRING <DEV>,"27,17,<time>"
Variable:
time = 1 - 255. Measured in 100 microsecond increments.
Example:
SEND_STRING RS232_1,"27,17,10"
Sends a break character of 1 millisecond to the RS232_1 device.
27,18,0 Clear the ninth data bit by setting it to 0 on all character transmissions.
Used in conjunction with the 'B9MON' command.
Syntax:
SEND_STRING <DEV>,"27,18,0"
Example:
SEND_STRING RS232_1,"27,18,0"
Sets the RS232_1 device's ninth data bit to 0 on all character transmissions.
27,18,1 Set the ninth data bit to 1 for all subsequent characters to be transmitted.
Used in conjunction with the 'B9MON' command.
Syntax:
SEND_STRING <DEV>,"27,18,1"
Example:
SEND_STRING RS232_1,"27,18,1"
Sets the RS232_1 device's ninth data bit to 1 on all character transmissions.
27,19,<time> Insert a time delay before transmitting the next character.
Syntax:
SEND_STRING <DEV>,"27,19,<time>"
Variable:
time = 1 - 255. Measured in 1 millisecond increments.
Example:
SEND_STRING RS232_1,"27,19,10"
Inserts a 10 millisecond delay before transmitting characters to the RS232_1 device.
27,20,0 Set the RTS hardware handshake's output to high (> 3V).
Syntax:
SEND_STRING <DEV>,"27,20,0"
Example:
SEND_STRING RS232_1,"27,20,0"
Sets the RTS hardware handshake's output to high on the RS232_1 device.
27,20,1 Set the RTS hardware handshake's output to low/inactive (< 3V).
Syntax:
SEND_STRING <DEV>,"27,20,1"
Example:
SEND_STRING RS232_1,"27,20,1"
Sets the RTS hardware handshake's output to low on the RS232_1 device.
ESCSEQOFF Disables SEND_STRING escape sequences.
Syntax:
SEND_STRING <DEV>,"ESCSEQOFF"
ESCSEQON Enables SEND_STRING escape sequences.
Syntax:
SEND_STRING <DEV>,"ESCSEQON"

NX-Series Controllers - WebConsole & Programming Guide 92

 NetLinx Programming

IR/Serial Ports Channels

IR / Serial Ports Channels
CHANNELS: Description
00001 - 00229 IR commands.
00229 - 00253 May be used for system call feedback.
00254 Power Fail. (Used w/ 'PON' and 'POF' commands).
00255 Power status. (Shadows I/O Link channel status).
00256 - 65000 IR commands.
65000 - 65534 Future use.

IRRX Port Channels

IRRX Ports Channels
00001 - 00255 PUSH and RELEASE channels for the received IR code.

IR/Serial SEND_COMMANDs
The following IR and IR/Serial Send_Commands generate control signals for external equipment. In these examples: <DEV> =
device.
IR/Serial SEND_COMMANDs
Command Description
CAROFF Disable the IR carrier signal until a 'CARON' command is received.
Syntax:
SEND_COMMAND <DEV>,"'CAROFF'"
Example:
SEND_COMMAND IR_1,"'CAROFF'"
Stops transmitting IR carrier signals to the IR_1 port.
CARON Enable the IR carrier signals (default).
Syntax:
SEND_COMMAND <DEV>,"'CARON'"
Example:
SEND_COMMAND IR_1,"'CARON'"
Starts transmitting IR carrier signals to the IR_1 port.
CH Send IR pulses for the selected channel. All channels below 100 are transmitted as two digits.
• If the IR code for ENTER (function #21) is loaded, an Enter will follow the number.
• If the channel is greater than or equal to (>=) 100, then IR function 127 or 20 (whichever exists) is generated for the
one hundred digit.
• Uses 'CTON' and 'CTOF' times for pulse times.
Syntax:
SEND_COMMAND <DEV>,"'CH',<channel number>"
Variable:
channel number = 0 - 199.
Example:
SEND_COMMAND IR_1,"'CH',18"
This device performs the following:
• Transmits IR signals for 1 (IR code 11). The transmit time is set with the CTON command.
• Waits until the time set with the CTOF command elapses.
• Transmits IR signals for 8 (IR code 18).
• Waits for the time set with the CTOF command elapses. If the IR code for Enter (IR code 21) is programmed, the
Controller performs the following steps.
1) Transmits IR signals for Enter (IR code 21).
2) Waits for the time set with the CTOF command elapses.
CLEAR FAULT Forces a reset back to normal status.
Syntax:
SEND_COMMAND <DEV>, "'CLEAR FAULT'"
Example:
SEND_COMMAND IR_1,"'CLEAR FAULT'"

NX-Series Controllers - WebConsole & Programming Guide 93

 NetLinx Programming

IR/Serial SEND_COMMANDs (Cont.)

Command Description
CP Halt and clear all active or buffered IR commands, and then send a single IR pulse.
Set the Pulse and Wait times with the 'CTON' and 'CTOF' commands.
Syntax:
SEND_COMMAND <DEV>,"'CP',<code>"
Variable:
code = IR port's channel value 0 - 252 (253 - 255 reserved).
Example:
SEND_COMMAND IR_1,"'CP',2"
Clears the active/buffered commands and pulses IR_1 port's channel 2.
CTOF Set the duration of the Off time (no signal) between IR pulses for channel and IR function transmissions. Off time
settings are stored in non-volatile memory. This command sets the delay time between pulses generated by the 'CH' or
'XCH' send commands in tenths of seconds.
Syntax:
SEND_COMMAND <DEV>,"'CTOF',<time>"
Variable:
time = 0 - 255. Given in 1/10ths of a second. Default is 5 (0.5 seconds).
Example:
SEND_COMMAND IR_1,"'CTOF',10"
Sets the off time between each IR pulse to 1 second.
CTON Set the total time of IR pulses transmitted and is stored in non-volatile memory. This command sets the pulse length for
each pulse generated by the 'CH' or 'XCH' send commands in tenths of seconds.
Syntax:
SEND_COMMAND <DEV>,"'CTON',<time>"
Variable:
time = 0 - 255. Given in 1/10ths of a second. Default is 5 (0.5 seconds).
Example:
SEND_COMMAND IR_1,"'CTON',20"
Sets the IR pulse duration to 2 seconds.
GET BAUD Get the IR port’s current DATA mode communication parameters. The port sends the parameters to the device that
requested the information. Only valid if the port is in Data Mode (see SET MODE command).
Syntax:
SEND_COMMAND <DEV>,"'GET BAUD'"
The port responds with:
<port #> <baud>,<parity>,<data bits>,<stop bits>
Example:
SEND_COMMAND IR_1,"'GET BAUD'"
System response example:
PORT 11,9600,N,8,1
GET FAULT Check the activation status of fault detection on the port.
Syntax:
SEND_COMMAND <DEV>, "'GET FAULT'"
Example:
SEND_COMMAND IR_1,"'GET FAULT'"
Responds with a COMMAND event: DISABLED, NONE, SHORT, or NO DEVICE.
GET MODE Poll the IR/Serial port's configuration parameters and report the active mode settings to the device requesting the
information.
Syntax:
SEND_COMMAND <DEV>,"'GET MODE'"
The port responds with:
<port #> <mode>,<carrier>,<io link channel>
Example:
SEND_COMMAND IR_1,"'GET MODE'"
The system could respond with:
PORT 4 IR,CARRIER,IO LINK 0
GET STATUS Check the fault detection status of the port.
Syntax:
SEND_COMMAND <DEV>, "'GET STATUS'"
Example:
SEND_COMMAND IR_1,"'GET STATUS'"
Responds with a COMMAND event: STATUS: NORMAL or STATUS: FAULT.

NX-Series Controllers - WebConsole & Programming Guide 94

 NetLinx Programming

IR/Serial SEND_COMMANDs (Cont.)

Command Description
IROFF Halt and Clear all active or buffered IR commands being output on the designated port.
Syntax:
SEND_COMMAND <DEV>,"'IROFF'"
Example:
SEND_COMMAND IR_1,"'IROFF"
Immediately halts and clears all IR output signals on the IR_1 port.
POD Disable previously active 'PON' (power on) or 'POF' (power off) command settings.
Channel 255 changes are enabled.
This command is used in conjunction with the I/O Link command.
Syntax:
SEND_COMMAND <DEV>,"'POD'"
Example:
SEND_COMMAND IR_1,"'POD'"
Disables the 'PON' and 'POF' command settings on the IR_1 device.
POF Turn Off a device connected to an IR port based on the status of the corresponding I/O Link input.
If at any time the IR sensor input reads that the device is ON (such as if someone turned it on manually at the front
panel), IR function 28 (if available) or IR function 9 is automatically generated in an attempt to turn the device back OFF.
If three attempts fail, the IR port will continue executing commands in the buffer.
If there are no commands in the buffer, the IR port will continue executing commands in the buffer and trying to turn the
device OFF until a 'PON' or 'POD' command is received. If the IR port fails to turn the device OFF, a PUSH and RELEASE is
made on channel 254 to indicate a power failure error. You can only use the 'PON' and 'POF' commands when an IR
device has a linked I/O channel. Channel 255 changes are disabled after receipt of this command.
You can only use the 'PON' and 'POF' commands when an IR device has a linked I/O channel.
Syntax:
SEND_COMMAND <DEV>,"'POF'"
Example:
SEND_COMMAND IR_1,"'POF'"
Sends power down IR commands 28 (if present) or 9 to the IR_1 device.
PON Turn On a device connected to an IR port based on the status of the corresponding I/O Link input.
If at any time the IR sensor input reads that the device is OFF (such as if one turned it off manually at the front panel), IR
function 27 (if available) or IR function 9 is automatically generated in an attempt to turn the device back ON. If three
attempts fail, the IR port will continue executing commands in the buffer and trying to turn the device On.
If there are no commands in the buffer, the IR port will continue trying to turn the device ON until a 'POF' or 'POD'
command is received. If the IR port fails to turn the device ON, a PUSH and RELEASE is made on channel 254 to indicate
a power failure error.
You can only use the 'PON' and 'POF' commands when an IR device has a linked I/O channel. Channel 255 changes are
disabled after receipt of this command.
Syntax:
SEND_COMMAND <DEV>,"'PON'"
Example:
SEND_COMMAND IR_1,"'PON'"
Sends power up IR commands 27 or 9 to the IR_1 port.
PTOF Set the time duration between power pulses in .10-second increments. This time increment is stored in permanent
memory. This command also sets the delay between pulses generated by the 'PON' or 'POF' send commands in tenths of
seconds. It also sets the delay required after a power ON command before a new IR function can be generated. This gives
the device time to power up and get ready for future IR commands.
Syntax:
SEND_COMMAND <DEV>,"'PTOF',<time>"
Variable:
time = 0 - 255. Given in 1/10ths of a second. Default is 15 (1.5 seconds).
Example:
SEND_COMMAND IR_1,"'PTOF',15"
Sets the time between power pulses to 1.5 seconds for the IR_1 device.
PTON Set the time duration of the power pulses in .10-second increments. This time increment is stored in permanent memory.
This command also sets the pulse length for each pulse generated by the 'PON' or 'POF' send commands in tenths of
seconds.
Syntax:
SEND_COMMAND <DEV>,"'PTON',<time>"
Variable:
time = 0 - 255. Given in 1/10ths of a second. Default is 5 (0.5 seconds).
Example:
SEND_COMMAND IR_1,"'PTON',15"
Sets the duration of the power pulse to 1.5 seconds for the IR_1 device.

NX-Series Controllers - WebConsole & Programming Guide 95

 NetLinx Programming

IR/Serial SEND_COMMANDs (Cont.)

Command Description
SET BAUD Set the IR port's DATA mode communication parameters.
Only valid if the port is in Data Mode (see SET MODE command).
Syntax:
SEND_COMMAND <DEV>,"'SET BAUD <baud>,<parity>,<data>,<stop>'"
Variables:
baud = baud rates are: 19200, 9600, 4800, 2400, and 1200.
parity = N (none), O (odd), E (even), M (mark), S (space).
data = 7 or 8 data bits.
stop = 1 and 2 stop bits.
Example:
SEND_COMMAND IR_1,"'SET BAUD 9600,N,8,1'"
Sets the IR_1 port's communication parameters to 9600 baud, no parity, 8 data bits, and 1 stop bit.
NOTE: The maximum baud rate for ports using SERIAL mode is 19200. Also, SERIAL mode works best when using a
short cable length (< 10 feet).
SET FAULT Disables fault detection on the port. Fault detection is turned on by default.
DETECT OFF Syntax:
SEND_COMMAND <DEV>, "'SET FAULT DETECT OFF'"
Example:
SEND_COMMAND IR_1,"'SET FAULT DETECT OFF'"
SET FAULT Enables fault detection on the port. Fault detection is turned on by default.
DETECT ON Syntax:
SEND_COMMAND <DEV>, "'SET FAULT DETECT ON'"
Example:
SEND_COMMAND IR_1,"'SET FAULT DETECT ON'"
SET IO LINK Link an IR or Serial port to a selected I/O channel for use with the 'DE', 'POD', 'PON', and 'POF' commands.
The I/O status is automatically reported on channel 255 on the IR port. The I/O channel is used for power sensing (via a
PCS or VSS). A channel of zero disables the I/O link.
Syntax:
SEND_COMMAND <DEV>,"'SET IO LINK <I/O number>'"
Variable:
I/O number = 1 - 8. Setting the I/O channel to 0 disables the I/O link.
Example:
SEND_COMMAND IR_1,"'SET IO LINK 1'"
Sets the IR_1 port link to I/O channel 1. The IR port uses the specified I/O input as power status for processing 'PON'
and 'POF' commands.

NX-Series Controllers - WebConsole & Programming Guide 96

 NetLinx Programming

IR/Serial SEND_COMMANDs (Cont.)

Command Description
SET MODE Set the IR/Serial ports for IR or Serial-controlled devices to either IR, Serial, or Data mode.
Syntax:
SEND_COMMAND <DEV>, 'SET MODE <mode>'"
Variable:
mode = IR, SERIAL, or DATA.
Example:
SEND_COMMAND IR_1,"'SET MODE IR'"
Sets the IR_1 port to IR mode for IR control.
NOTE: The maximum baud rate for ports using SERIAL mode is 19200. Also, SERIAL mode works best when using a
short cable length (< 10 feet).
SP Buffers IR commands which haven’t had time to execute yet, and executes each command until the buffer is empty.
Syntax:
SEND_COMMAND <DEV>,"'SP',<code>"
Variable:
code = IR code value 1 - 252 (253-255 reserved).
Example:
SEND_COMMAND IR_1, "'SP',25"
Pulses IR code 25 on IR_1 device.
XCH Transmit the selected channel IR codes in the format/pattern set by the 'XCHM' send command.
Syntax:
SEND_COMMAND <DEV>,"'XCH <channel>'"
Variable:
channel = 0 - 9999.
Example:
For detailed usage examples, refer to the 'XCHM' command.
NOTE: This command supports 4-digit channels.

NX-Series Controllers - WebConsole & Programming Guide 97

 NetLinx Programming

IR/Serial SEND_COMMANDs (Cont.)

XCHM Changes the IR output pattern for the 'XCH' send command.
Syntax:
SEND_COMMAND <DEV>,"'XCHM-<extended channel mode>'"
Variable:
extended channel mode = 0 - 4.
Example:
SEND_COMMAND IR_1,"'XCHM-3'"
Sets the IR_1 device's extended channel command to mode 3.
Mode 0 Example (default): [x][x]<x><enter>
SEND_COMMAND IR_1,"'XCH-3'"
Transmits the IR code as 3-enter.
SEND_COMMAND IR_1,"'XCH-34'"
Transmits the IR code as 3-4-enter.
SEND_COMMAND IR_1,"'XCH-343'"
Transmits the IR code as 3-4-3-enter.
Mode 1 Example: <x> <x> <x> <enter>
SEND_COMMAND IR_1,"'XCH-3'"
Transmits the IR code as 0-0-3-enter.
SEND_COMMAND IR_1,"'XCH-34'"
Transmits the IR code as 0-3-4-enter.
SEND_COMMAND IR_1,"'XCH-343'"
Transmits the IR code as 3-4-3-enter.
Mode 2 Example: <x> <x> <x>
SEND_COMMAND IR_1,"'XCH-3'"
Transmits the IR code as 0-0-3.
SEND_COMMAND IR_1,"'XCH-34'"
Transmits the IR code as 0-3-4.
SEND_COMMAND IR_1,"'XCH-343'"
Transmits the IR code as 3-4-3.
Mode 3 Example: [[100][100]…] <x> <x>
SEND_COMMAND IR_1,"'XCH-3'"
Transmits the IR code as 0-3.
SEND_COMMAND IR_1,"'XCH-34'"
Transmits the IR code as 3-4.
SEND_COMMAND IR_1,"'XCH-343'"
Transmits the IR code as 100-100-100-4-3.
Mode 4: Mode 4 sends the same sequences as the 'CH' command. Only use Mode 4 with channels
0 - 199.
Mode 5 Example: <x><x><x><x><enter>
SEND_COMMAND IR_1,"'XCH-3'"
Transmits the IR code as 0-0-0-3-enter.
SEND_COMMAND IR_1,"'XCH-34'"
Transmits the IR code as 0-0-3-4-enter.
SEND_COMMAND IR_1,"'XCH-343'"
Transmits the IR code as 0-3-4-3-enter.
SEND_COMMAND IR_1,"'XCH-1343'"
Transmits the IR code as 1-3-4-3-enter.
Mode 6 Example: <x><x><x><x>
SEND_COMMAND IR_1,"'XCH-3'"
Transmits the IR code as 0-0-0-3.
SEND_COMMAND IR_1,"'XCH-34'"
Transmits the IR code as 0-0-3-4.
SEND_COMMAND IR_1,"'XCH-343'"
Transmits the IR code as 0-3-4-3.
SEND_COMMAND IR_1,"'XCH-1343'"
Transmits the IR code as 1-3-4-3.

NX-Series Controllers - WebConsole & Programming Guide 98

 NetLinx Programming

Input/Output SEND_COMMANDs
The I/O port is port 22 on the NX-series controllers and the MCP-108 Massio ControlPad.
The following SEND_COMMANDs program the I/O ports on the Integrated Controller.

I/O SEND_COMMANDs
Command Description
GET DBT Get Debounce Time
Syntax:
GET DBT <n>
Variable:
n = the channel number of the I/O input port
Example:
SEND_COMMAND 5001:22:0,'GET DBT 1'
Retrieves the Debounce time channel 1 on the I/O port.
Response:
DBT 1 50
Responds with the channel number and the Debounce time in milliseconds (ms).
SET DBT Set Debounce Time
Syntax:
SET DBT <n><v>
Variables:
n = the channel number of the I/O input port
v = Value 1-50 which sets the debounce time in increments of 5ms
Example:
SEND_COMMAND 5001:22:0,'SET DBT 1 10'
Sets channel 1 on the I/O port to 50ms Debounce time.
GET INPUT Get the active state for the selected channels. An active state can be high (logic high) or low (logic low or contact closure).
Channel changes, Pushes, and Releases generate reports based on their active state. The port responds with either 'HIGH'
or 'LOW'.
Syntax:
SEND_COMMAND <DEV>,"'GET INPUT <channel>'"
Variable:
channel = Input channel 1 - 8.
Example:
SEND_COMMAND IO,"'GET INPUT 1'"
Gets the I/O port's active state.
The system could respond with:
INPUT1 ACTIVE HIGH
SET INPUT Set the input channel's active state. An active state can be high (logic high) or low (logic low or contact closure). Channel
changes, Pushes, and Releases generate reports based on their active state. Setting an input to ACTIVE HIGH will disable
the ability to use that channel as an output.
Syntax:
SEND_COMMAND <DEV>,"'SET INPUT <channel> <state>'"
Variable:
channel = Input channel 1 - 8.
state = Active state HIGH or LOW (default).
Example:
SEND_COMMAND IO,"'SET INPUT 1 HIGH'"
Sets the I/O channel to detect a high state change, and disables output on the channel.

NX-Series Controllers - WebConsole & Programming Guide 99

 NetLinx Programming

PoE SEND_COMMANDs
The NX-4200 has 4 ICSLAN ports, each of which feature Power-over-Ethernet (PoE). The ports are numbered 1-4. The following
PoE SEND_COMMANDs program the ICSLAN ports on the controller.
NOTE: Note: These commands are not compatible with Massio ControlPads.

PoE SEND_COMMANDs
Command Description
GET CLASS Retrieve the class type of the device connected via PoE. This command receives a COMMAND event of ’DISABLED’, ’NO
DEVICE’, or ’CLASS x DEVICE’, with x being a value from 0 to 4.
Syntax:
SEND_COMMAND <DEV>,"'GET CLASS'"
Example:
SEND_COMMAND PoE_24,"'GET CLASS'"
GET Retrieve the current of the device connected via PoE. This command receives a COMMAND event with the number in
CURRENT milliamps (mA).
Syntax:
SEND_COMMAND <DEV>,"'GET CURRENT'"
Example:
SEND_COMMAND PoE_24,"'GET CURRENT'"
GET FAULT Retrieve the type of fault on the PoE port. This command receives a COMMAND event of ’DISABLED’, ’NONE’, ’UNDER-
VOLTAGE / OVER-VOLTAGE’, ’CURRENT OVERLOAD’, ’LOAD DISCONNECT’, MAX POWER EXCEEDED,’ or ’POE NOT
AVAILABLE’.
Syntax:
SEND_COMMAND <DEV>,"'GET FAULT'"
Example:
SEND_COMMAND PoE_24,"'GET FAULT'"
GET STATUS Retrieve the status of the PoE port. This command receives a COMMAND event of ’STATUS: NORMAL’ or, ’STATUS: FAULT’.
Syntax:
SEND_COMMAND <DEV>,"'GET STATUS'"
Example:
SEND_COMMAND PoE_24,"'GET STATUS'"
GET Retrieve the current draw on the PoE port. This command receives a COMMAND event with the number in volts.
VOLTAGE Syntax:
SEND_COMMAND <DEV>,"'GET VOLTAGE'"
Example:
SEND_COMMAND PoE_24,"'GET VOLTAGE'"
SET FAULT Disables fault detection on the PoE port. Fault detection is turned on by default.
DETECT OFF Syntax:
SEND_COMMAND <DEV>,"'SET FAULT DETECT OFF'"
Example:
SEND_COMMAND PoE_24,"'SET FAULT DETECT OFF'"
SET FAULT Enables fault detection on the PoE port. Fault detection is turned on by default.
DETECT ON Syntax:
SEND_COMMAND <DEV>,"'SET FAULT DETECT ON'"
Example:
SEND_COMMAND PoE_24,"'SET FAULT DETECT ON'"
SET POWER Disables PoE to the port. PoE is turned on by default.
OFF Syntax:
SEND_COMMAND <DEV>,"'SET POWER OFF'"
Example:
SEND_COMMAND PoE_24,"'SET POWER OFF'"
SET POWER Enables PoE to the port. PoE is turned on by default.
ON Syntax:
SEND_COMMAND <DEV>,"'SET POWER ON'"
Example:
SEND_COMMAND PoE_24,"'SET POWER ON'"

NX-Series Controllers - WebConsole & Programming Guide 100

 NetLinx Programming

AxLink SEND_COMMANDs
The following commands program the AxLink ports on the NX controller.
NOTE: These commands are not compatible with Massio ControlPads.

AxLink SEND_COMMANDs
Command Description
AXPWROFF Powers off the specified AxLink port.
Syntax:
SEND_COMMAND <DEV>,"'AXPWROFF <UPPER|LOWER>'"
Variable:
UPPER|LOWER = Specifies the AxLink port on the controller
Example:
SEND_COMMAND 5001:1:0,"'AXPWROFF UPPER'"
Powers off the upper AxLink port on the controller.
AXPWRON Powers on the specified AxLink port.
Syntax:
SEND_COMMAND <DEV>,"'AXPWRON <UPPER|LOWER>'"
Variable:
UPPER|LOWER = Specifies the AxLink port on the controller
Example:
SEND_COMMAND 5001:1:0,"'AXPWRON LOWER'"
Powers on the lower AxLink port on the controller.
GET AX FAULT Retrieve the AxLink port which currently has a fault.
Syntax:
SEND_COMMAND <DEV>,"'GET AX FAULT'"
Example:
SEND_COMMAND 5001:1:0,"'GET AX FAULT'"
Responds with the COMMAND event: ’AX FAULT: UPPER/LOWER’ or ’NONE’.

Audit Log SEND_COMMANDs

The following command enables you to send an audit log from a device.

Audit Log SEND_COMMANDs

Command Description
LOG Sends Audit Logs to the Master for output via Syslog. The D:P:S of the sending device will be added to the audit log. It is
the sender's responsibility to ensure that the log conforms to the standard format (i.e. contains event type, component,
source if not the device itself, identity and outcome).
Syntax:
SEND_COMMAND <DEV>,"'LOG, <log text>'"
or
SEND_COMMAND <DEV>,"'LOG, <severity>, <log text>'"
Variable:
log text - the text of the log message
severity - 1=fatal, 2=error, 3=warning, 4=info, 5=debug
Example:
SEND_COMMAND <DEV>,"'LOG, TEST LOG'"
SEND_COMMAND <DEV>,"'LOG, 4, TEST LOG'"

NX-Series Controllers - WebConsole & Programming Guide 101

 NetLinx Programming

Authentication
The NetLinx.axi file that ships with NetLinx Studio includes the following types/constants for authentication:
(*------------------------------------------------------------------------------------------------*)
(* Added v1.56 *)
(*------------------------------------------------------------------------------------------------*)
STRUCTURE LAST_LOGIN_INFO
{
INTEGER failedLoginCount
CHAR lastSuccessfulLoginDate[MAX_LAST_LOGIN_INFO_LENGTH]
CHAR lastSuccessfulLoginIp[MAX_LAST_LOGIN_INFO_LENGTH]
CHAR lastFaileLoginDate[MAX_LAST_LOGIN_INFO_LENGTH]
CHAR lastFailedLoginIp[MAX_LAST_LOGIN_INFO_LENGTH]
}

Library Calls
The NetLinx.axi file that ships with NetLinx Studio includes the following Authentication-specific library calls:
NetLinx.axi - Library Calls
TLS_CLIENT_CLOSE Closes an open TLS communication port with a remote device. Typically, the remote host closes the
connection and you do not need to send this command.
Syntax:
integer TLS_CLIENT_CLOSE(LocalPort)
Parameters:
• LocalPort - A user-defined (non-zero) integer value representing the local port on the client
machine to use for this conversation. This local port number must be passed to TLS_CLIENT_OPEN
to open the conversation.
Returns:
0 - Success
1 - Error
Example:
TLS_CLIENT_CLOSE(5000)
TLS_CLIENT_OPEN Opens a port for TLS communication with a remote device.
Syntax:
integer TLS_CLIENT_OPEN(LocalPort, hostname, port, mode)
Parameters:
• LocalPort- A user-defined (non-zero) integer value representing the local port on the client machine
to use for this conversation. This local port number must be passed to TLS_CLIENT_CLOSE to close
the conversation.
• hostname - The host name or IP address of the remote host.
• port - The connecting port on the remote host, usually port 443 for standard HTTPS connections.
• mode - 0: TLS_VALIDATE_CERTIFICATE (perform certificate validation), 1:
TLS_IGNORE_CERTIFICATE_ERRORS (connect to the remote site while ignoring certificate errors or
mismatches)
Returns:
This function returns 0 is all parameters are accepted, or a positive value indicating the offending
parameter if there is an error.
Example:
TLS_CLIENT_OPEN(5000, '192.168.0.1', 443, 0)

NX-Series Controllers - WebConsole & Programming Guide 102

 NetLinx Programming

NetLinx.axi - Library Calls (Cont.)

VALIDATE_NETLINX_ACCOUNT This function validates the specified user name and password against the NetLinx Master Controller's
internal user account database. For the account to be valid the user name must exist with the
matching password and the specified user account must have been set up with ICSP Authorization.
Syntax:
sinteger VALIDATE_NETLINX_ACCOUNT(CHAR username[], CHAR
password[],LAST_LOGIN_INFO info)
Parameters:
username - A character array containing the user name to validate.
password - A character array containing the password to validate.
info - A return structure of type LAST_LOGIN_INFO.
Returns:
The following values are returned from the call:
0 - Valid user account.
-1 - Username invalid
-2 - Password invalid
-3 - Invalid user account
-4 - No authorization (Username/password are not authorized)
-5 - Invalid parameter
-6 - User account matching name is locked out
-7 - User account matching name has expired
VALIDATE_NETLINX_ACCOUNT_ This function validates the specified user name and password against the NetLinx Master Controller's
WITH_PERMISSION internal user account database. For the account to be valid the user name must exist with the
matching password and the specified user account must have been set up with ICSP Authorization.
This command includes parameters for authorization and permission types.
Syntax:
sinteger VALIDATE_NETLINX_ACCOUNT_WITH_PERMISSION(CHAR username[], CHAR
password[],CHAR type[], CHAR permission[], LAST_LOGIN_INFO info)
Parameters:
username - A character array containing the user name to validate.
password - A character array containing the password to validate.
type - The authorization type.
permission - The permission type. Valid permissions include: Configuration, Console, Diags,
EncryptICSP, FTP, HTTP, ICSP, Terminal, AuditLog, User1, User2, User3, and User4
info - A return structure of type LAST_LOGIN_INFO
Returns:
The following values are returned from the call:
0 - Valid user account.
-1 - Username parameter is not a valid string
-2 - Password parameter is not a valid string
-3 - Invalid user account
-4 - No authorization (Username/password are not authorized and/or permission is not
authorized)
-5 - Third argument is not a LAST_LOGIN_INFO structure
-6 - User account matching name is locked out
-7 - User account matching name has expired

NX-Series Controllers - WebConsole & Programming Guide 103

 Terminal (Program Port/Telnet) Commands

Terminal (Program Port/Telnet) Commands

Overview
There are two types of terminal communications available on NetLinx Integrated Controllers:
Program Port - The "Program" port is a Type-B USB port located on the Master that allows terminal communication with
the Master. This type of terminal communication requires that you are physically connected to the Master to access the
configuration options and commands supported. Since this method of terminal communication requires physical
proximity as well as a physical connection to the Master, it is the most secure form of terminal communication.
For this reason, all Security Configuration options are only available via the Program port (and cannot be accessed via
Telnet).
Telnet - This type of terminal communication can be accessed remotely, via TCP/IP. It is a less secure form of terminal
communication, since it does not require a physical connection to the Master to connect. Further, the Telnet interface
exposes information to the network (which could be intercepted by an unauthorized network client).
NOTE: It is recommended that you make initial conf igurations as well as subsequent changes via the WebConsole. Refer to the On-
Board WebConsole User Interface section on page 34.
Refer to the Terminal Commands section on page 105 for a listing of all commands available in a terminal session.
Note that all commands in the table are available for both Program Port and Telnet sessions, with two exceptions: "Help Security"
and "Resetadminpassword". These commands are only available via a Program Port connection.

Establishing a Terminal Connection via the Program Port

To establish a terminal session via the Program Port, the USB port on your PC must be physically connected to the Program port on
the NetLinx Master.

Establishing a Terminal Connection via Telnet

1. In your Windows task bar, select Start > Run to open the Run dialog.
2. Type cmd in the Open field and click OK to open an instance of the Windows command interpreter (cmd.exe).
3. In the CMD (command), type "telnet" followed by a space and the Master’s IP address info.
Example:
>telnet XXX.XXX.XXX.XXX
4. Press Enter.
Unless Telnet security is enabled, a session will begin with a welcome banner:
Welcome to NetLinx vX.XX.XXX, AMX LLC
>
If Telnet security is enabled, type in the word login to be prompted for a Username and Password before gaining access to
the Master.
5. Enter your username to be prompted for a password.
If the password is correct, you will see the welcome banner.
If the password is incorrect, the following will be displayed:
Login: User1
Password: *****
Login not authorized. Please try again.
After a delay, another login prompt will be displayed to allow you to try again.
If after 5 prompts, the login information is not entered correctly, the following message will be displayed and the
connection closed:
Login not allowed. Goodbye!

To restrict access to the Master via terminal connection, enable Telnet/SSH on the Master via the Telnet/SSH option on the
Security page - see the Security Options Menu section on page 124 for details). With Configuration Security enabled, a
valid user with Configuration Security access will have to login before being able to execute Telnet commands. If security
is not enabled, these commands are available to all.
If a connection is opened, but a valid username / password combination is not entered (i.e. just sitting at a login prompt),
the connection will be closed after one minute.

NX-Series Controllers - WebConsole & Programming Guide 104

 Terminal (Program Port/Telnet) Commands

Terminal Commands
The Terminal commands listed in the following table can be sent directly to the Master via either a Program Port or a Telnet terminal
session (with the exception of the "Help Security" and "Resetadminpassword" commands, which are only available to a Program
Port (RS232) connection.
In your terminal program, type "Help" or a question mark ("?") and <Enter> to access the Help Menu, and display the Program
port commands described below:
Terminal Commands
Command Description
----- Help ----- <D:P:S> (Extended diag messages are OFF)
<D:P:S>: Device:Port:System. If omitted, assumes Master.
? or Help Displays this list of commands.
ADD AUDIT SERVER [D:P:P] Adds a remote syslog server for audit messages.
- D: IP address or host name of the remote server
- P: Port number
- P: Protocol (UDP, TCP, or RELP)
Example:
>ADD AUDIT SERVER REMOTESVR:514:UDP
AUTO LOCATE Enables/Disables/queries the auto locate feature on the Master.
(ENABLE|DISABLE|STATUS) Auto locate adds additional broadcast information for use by AMX Touch Panel devices configured
in Auto connect mode.
BOOT STATUS Returns the current boot state of the master.
Response is either "Boot in progress." or "Boot complete."
CHANGE PASSWORD Change your password (requires login).
CLEAR AUDIT Removes all locally-stored audit records.
See the SHOW AUDIT LOG command on page 116.
CLEAR HTTPS REDIRECT Clears the HTTPS redirect flag.
See the SET HTTPS REDIRECT command on page 112.
CLEAR MAX BUFFERS Reset the max buffers high-water counters to zero.
CLEAR PERSISTENT VARS Clear out the persistent/non-volatile variable values without having to download a new NetLinx
program.
CPU USAGE Diagnostic tool to calculate a running average of the current CPU usage of the Master.
DATE Displays the current date and day of the week.
Example:
>DATE
10/31/2004 Wed
DATE/TIME ON|OFF ENABLES/DISABLES the addition of a date time stamp to the terminal logs displayed via "msg on"
DATE/TIME is Off by default at the start of each Terminal/Telnet session.
DEVICE DEBUG Turns the device side traffic debug messages on or off.
DEVICE HOLDOFF ON|OFF Sets the Master to holdoff devices (i.e. does not allow them to report ONLINE) until all objects in
the NetLinx program have completed executing the DEFINE_START section.
If set to ON, any messages to devices in DEFINE_START will be lost, however, this prevents
incoming messages being lost in the Master upon startup.
When DEVICE_HOLDOFF is ON, you must use ONLINE events to trigger device startup
SEND_COMMANDs.
By default, DEVICE_HOLDOFF is OFF to maintain compatibility with Axcess systems where devices
are initialized in DEFINE_START.
NOTE: This command sets the state of the device holdoff. The GET DEVICE HOLDOFF command
reveals whether the state is On or Off (see page 107).
Example:
>Device Holdoff ON
Device Holdoff Set.
DEVICE STATUS <D:P:S> Displays a list of all active (on) channels for the specified D:P:S.
DIPSWITCH Displays the current state of the Master's hardware dip switches.
DISK FREE Displays the total bytes of free space available on the Master.
Example:
>DISK FREE
The disk has 2441216 bytes of free space.

NX-Series Controllers - WebConsole & Programming Guide 105

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
DNS LIST <D:P:S> Displays the DNS configuration of a specific device including:
• Domain suffix·
• Configured DNS IP Information
Example:
>DNS LIST [0:1:0]
Domain suffix:amx.com
The following DNS IPs are configured
Entry 1-192.168.20.5
Entry 2-12.18.110.8
Entry 3-12.18.110.7
DOT1X Enables/disables wired 802.1x security or displays its current settings.
(ENABLE|DISABLE|STATUS) Syntax:
DOT1X[status|enable|disable]
ECHO ON|OFF Enables/Disables echo (display) of typed characters.
EXPORT (CONFIG|CLONE) Exports a Master's configuration (config) or entire clone to USB media connected to the front or
TO USB (FRONT|BACK) back of the Master.
Syntax:
EXPORT [CONFIG|CLONE] TO USB [FRONT|BACK]
The copy format of the configuration export includes:
• Auto-locate enable/disable
• Clock Manager settings
• Device Holdoff setting
• ICSP TCP timeout
• IP Device Discovery enable/disable
• LDAP settings
• Master-to-Master route mode
• Message log length
• Message thresholds for threads
• NDP enable/disable
• Queue sizes for threads
• Security configuration including the system, group, and user level settings
• Security profile
• Server port enable/disable for FTP, HTTP, HTTPS, ICSP, SSH, Telnet
• Server port numbers for FTP, HTTP, HTTPS, ICSP, SSH, Telnet
• SSL certificate parameters
• Startup log enable/disable
• UDP broadcast rate
• Zeroconfig enable/disable
The clone format of the configuration export includes all of the items from the copy format plus the
following:
• DNS server names
• Domain name
• Duet memory allocation
• Hostname
• System number
• URL list
• NetLinx code
• Java code (Duet modules, XDD modules)
• All user files and folders, (includes .IRL files)
NOTE: See IMPORT CONFIG.
EXPORT AUDIT to USB Exports all locally stored audit files to USB media connected to the front or back of the Master.
(FRONT|BACK) Syntax:
EXPORT AUDIT TO USB [FRONT|BACK]
FIPS MODE Displays the status of Federal Information Processing Standard (FIPS) mode. FIPS mode is set to
ON by default.
NOTE: If you disable FIPS mode then reboot the Master, FIPS mode will be enabled again when
booting is complete.
GET AUDIT STATUS Displays the log daemon status and the percentage of free disk space.

NX-Series Controllers - WebConsole & Programming Guide 106

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
GET DEVICE HOLDOFF Displays the state of the Master’s device holdoff setting.
NOTE: This command reveals the state of the device holdoff set using the DEVICE HOLDOFF
ON|OFF command (see page 105).
Example:
>GET DEVICE HOLDOFF
Device Holdoff is off.
GET DEVICE TRAFFIC Gets diagnostic information about device side traffic.
Example:
>get device traffic
GET DUET MEMORY Display the amount of memory allocated for Duet Java pool. This is the current Java memory heap
size as measured in Megabytes. An example is a value of 5 = 5 MB.
GET ICSLAN Displays the current ICSLAN port settings. See the Using the ICSLAN Network section on page 120
for more information.
Example:
>get icslan
ICSLan Network: 198.18.0.0
ICSLan Hostname: ICSLAN
ICSLan Master IPv4 Address: 198.18.0.1
ICSLan Master IPv6 Address: fe80::260:9fff:fe98:bd9e
ICSLan DHCP Server is enabled
ICSLan Dns Server is 198.18.0.1
Note: See SET ICSLAN.
GET IP <D:P:S> Displays the IP configuration of a device.
If you enter GET IP without the D:P:S variable, the Master displays its D:P:S, Host Name, Type
(DHCP or Static), IP Address, Subnet Mask, Gateway IP, and MAC Address.
Example:
>GET IP [0:1:50]
IP Settings for 0:1:50
HostName MLK-INSTRUCTOR
Type DHCP
IP Address 192.168.21.101
Subnet Mask 255.255.255.0
Gateway IP 192.168.21.2
MAC Address 00:60:9f:90:0d:39
GET LEASES Displays the leases on the ICSLAN port.
GET OCSP URL Retrieves the user Online Certificate Status Protocol (OCSP) URL.
GET PLATFORM INFO Retrieves information about a Master connected via USB port. The command returns the master
type, host name, system number, IPv4 address, IPv6 address, MAC address, and serial number in a
single response.
Example:
>get platform info
DESC=NX-3200;HOST=AMXM98BFB0;SYS=1;IP4=192.168.224.68;IP6=fe80::260:
9fff:fe98:bfb0;MAC=00:60:9f:98:bf:b0;SN='654321',0,0,0,0,0,0,0,0,0,0
HELP SECURITY Displays security related commands.
NOTE: This command is only available to Program Port terminal sessions. It is not available to
Telnet sessions (see the Overview section on page 104).
Example:
>HELP SECURITY
>logout Logout and close secure session
>setup security Access the security setup menus
ICSPMON ENABLED|DISABLED Enables or disables ICSP monitoring out the specified IP port. By enabling icspmon on an IP port,
[PORT] an external application could connect to that port and "listen" on the ICSP traffic.
IMPORT CONFIG Installs a previously exported config or clone file. The command searches the USB media for
config and clone .tar files and allows you to select which file to import. See EXPORT
(CONFIG|CLONE) TO USB (FRONT|BACK).
IMPORT IRL Loads an IRL file from USB media onto the masters flash file system. The command searches the
USB media for .irl files and allows you to select which IRL file to import.
IMPORT KIT Installs a KIT file from USB media. The command searches the USB media for .kit files and allows
you to select which KIT file to import.

NX-Series Controllers - WebConsole & Programming Guide 107

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
IMPORT TKN Installs a NetLinx token file from USB media. The command searches the USB media for .tkn files
and allows you to select which .tkn file to import.
NOTE: NOTE: This command does not install the zipped token f ile and its associated duet f iles.
This command only works with the base token f ile (PROG.tkn).
IP STATUS Provides information about the current NetLinx IP Connections.
Example:
>IP STATUS
NetLinx IP Connections
No active IP connections
IPDD Provides information about the IP Device Discovery setting.
Example:
>IPDD
IP Device Discovery has been ***ENABLED***.
JAVA SECURITY Provides information about the Java Security Manager setting.
Example:
>JAVA SECURITY DISABLE
Java Security Manager has been ***DISABLED***. Reboot required.
LIST AUDIT FILES Displays the file names of all locally stored audit files.
LIST AUDIT SERVERS Lists all remote syslog servers that receive audit messages.
LOG FORMAT Sets the format of log messages for specific devices.
Example:
>log format
Format Logging for which log device:
0) ALL (changes will apply to all devices)
1) BUFFER
2) STARTUP
3) SESSION
4) USB
5) CONSOLE
Enter selection or press return to exit without changes: 3
Setting Log format for SESSION
Print user-friendly date/timestamps in logs? (Y/N): Y Y
Print Day of Week in logs? (Y/N): N
Print Clock Tick (ms since start) in logs? (Y/N): N
Print Thread IDs in logs? (Y/N): Y Y
Log format for BUFFER: (ticks) log
Log format for STARTUP: timestamp (ticks) [threadId] (severity) log
Log format for SESSION: timestamp [threadId] log
Log format for USB: timestamp day (ticks) log
Log format for CONSOLE: timestamp (ticks) [threadId] (severity) log
MAIL RESET Resets the mail service.
MAIL STATUS Displays the status of the configured mail server.
MANAGE FIRMWARE Telnet interface to load previous and factory firmware versions for both master (device 0) and
Integrated Device (device 5001)
Example:
>manage firmware
Devices
-------
0 - Master
5001
Select device or press return to cancel:0
Current Version: 1.2.259
Previous Version: 1.2.258
Factory Version: 1.2.250
To install a firmware version:
Enter P (Previous), F (Factory) or press return to cancel:
MEM Displays the largest free block of the Master’s memory.
Example:
>MEM
The largest free block of memory is 11442776 bytes.

NX-Series Controllers - WebConsole & Programming Guide 108

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
MSG ON|OFF Enables/Disables extended diagnostic messages.
• MSG On [error|warning|info|debug] sets the terminal program to display log messages
generated by the Master. The level of log printed to the terminal window depends both on the
level used when sending the message and the output level selected with "msg on."
For example if log output is enabled via "msg on warning" then logs produced at levels
AMX_ERROR and AMX_WARNING will be displayed, but not logs produced at levels AMX_INFO or
AMX_DEBUG.
The order of severity from highest to lowest is ERROR, WARNING, INFO, DEBUG.
If no severity is supplied with "msg on", the default setting is WARNING.
• MSG OFF disables the display.
Example:
> MSG ON
Extended diagnostic information messages turned on.
> MSG OFF
Extended diagnostic information messages turned off.
MSG STATS Calculates incoming and outgoing messages over a time interval.
NDP Provides information about the NetLinx Discovery Protocol (NDP) setting.
Example:
>NDP
NDP beacon is ***ENABLED***.
NETLINX LOG LEVEL Configure the current setting for the NetLinx AMX_LOG facility.
Example:
>netlinx log level
NetLinx Log Level is WARNING
Set NetLinx Log level to :
1) ERROR
2) WARNING
3) INFO
4) DEBUG
Enter selection or press return to keep current level:
>3
NetLinx Log Level set to INFO
OFF [D:P:S or NAME,CHAN] Turns off a specified channel on a device. The device can be on any system that the Master you are
connected to is able to reach. You can specify the device number, port, and system, or the name of
the device that is defined in the DEFINE_DEVICE section of the program.
Syntax:
OFF[name,channel]
-or-
OFF[D:P:S,channel]
Example:
>OFF[5001:7:4,1]
Sending Off[5001:7:4,1]
ON [D:P:S or NAME,CHAN] Turns on a specified channel on a device. The device can be on any system that the Master you are
connected to is able to reach. You can specify the device number, port, and system, or the name of
the device that is defined in the DEFINE_DEVICE section of the program.
Syntax:
ON[name,channel]
-or-
ON[D:P:S,channel]
Example:
>ON[5001:7:4,1]
Sending On[5001:7:4,1]

NX-Series Controllers - WebConsole & Programming Guide 109

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
PASS [D:P:S or NAME] Sets up a pass through mode to a device. In pass through mode, any string received by the device
is displayed on the screen, and anything typed is sent as a string to the device. The device can be
on any system that the Master you are connected to is able to reach. You can specify the device
number, port, and system, or the name of the device that is defined in the DEFINE_DEVICE section
of the program.
• Mode is exited by ++ ESC ESC.
• Display Format is set by ++ ESC n
Where n =
A, format = ASCII
D, format = Decimal
H = Hex
NOTE: Refer to the ESC Pass Codes section on page 120 for detailed descriptions of the
supported pass codes.
Example:
>pass[5001:7:4]
Entering pass mode.
PHYSICAL STATUS Retrieve the current LED states.
PING [ADDRESS] Pings an address (IP or URL), to test network connectivity to and confirms the presence of another
networked device. The syntax is just like the PING application in Windows or Linux.
Example:
>ping 192.168.29.209
192.168.29.209 is alive.
PROGRAM Enable/disable the NetLinx program or display the status of the current program execution setting.
(ENABLE|DISABLE|STATUS) The PROGRAM command performs the same function as flipping dip switch 1 on the rear panel of
the Master. The setting persists until it is manually changed. If the software setting is disabled OR
dip switch 1 is "on" then the NetLinx program is disabled. The default setting is enabled.
Syntax:
PROGRAM [status|enable|disable]
PROGRAM INFO Displays a list of program files and modules residing on the Master.
Example:
>PROGRAM INFO
-- Program Name Info
-- Module Count = 1
1 Name is i!-PCLinkPowerPointTest

-- File Names = 2
1 = C:\Program Files\AMX Applications\i!-PCLinkPowerPoint
2 = C:\Program Files\Common Files\AMXShare\AXIs\NetLinx.axi
2 = Name is MDLPP

-- File Names = 2
1 C:\AppDev\i!-PCLink-PowerPoint\i!-PCLinkPowerPointMod.axs
2 C:\Program files\Common Files\AMXShare\AXIs\NetLinx.axi
PULSE [D:P:S or NAME,CHAN] Pulses a specified channel on a device on and off. The device can be on any system the Master you
are connected to can reach. You can specify the device number, port, and system; or the name of
the device that is defined in the DEFINE_DEVICE section of the program.
Example:
>PULSE[50001:8:50,1]
Sending Pulse[50001:8:50,1]
PWD Displays the name of the current directory.
Example:
pwd
The current directory is doc:
REBOOT Reboots the Master or specified device. Options for rebooting the Master are cold, soft, and warm.
The reboot command with no parameter executes as "reboot cold".
Example (Rebooting device):
>REBOOT [0:1:0]
Rebooting...
Example (Rebooting Master):
>reboot cold
Reboots the Master and restarts the entire operating system.
>reboot warm
>reboot soft
Reboots the Master but only starts the AMX NetLinx application firmware.

NX-Series Controllers - WebConsole & Programming Guide 110

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
REMOVE AUDIT SERVER [D:P:P] Removes a remote syslog server for audit messages.
- D: IP address or host name of the remote server
- P: Port number
- P: Protocol (UDP, TCP, or RELP)
Example:
>REMOVE AUDIT SERVER REMOTESVR:514:UDP
RENEW DHCP Renews/Releases the current DHCP lease for the Master.
NOTE: The Master must be rebooted to acquire a new DHCP lease.
Example:
>RENEW DHCP
REPORT FIRMWARE Calculates and displays checksums for stored firmware installation files.
REPORT NETLINX Calculates and displays a checksum for the currently installed NetLinx code.
RESETADMINPASSWORD This command resets the administrator password. The password is set to one of the following
passwords depending on the Password Complexity setting:
• Low - password
• Medium - Amx1234!
• High - Amx1234!PasSword
NOTE: This command is only available to Program Port terminal sessions. It is not available to
Telnet sessions (see the Overview section on page 104).
RESET FACTORY Resets the Master to factory default state including removal of all security settings, removal of all
user files, resetting to DHCP, and loading an empty NetLinx program. The Master will be effectively
in an out-of-box state.
ROUTE MODE DIRECT|NORMAL Sets the Master-to-Master route mode:
• Normal mode - allows a Master to communicate with any Master accessible via the routing tables
(shown with the SHOW ROUTE command - see page 118). This includes a directly-connected
Master (route metric =1) and indirectly connected Masters (route metric greater than 1, but less
than 16).
• Direct mode - allows communication only with Masters that are directly connected (route metric
= 1). Indirectly connected Masters cannot be communicated within this mode.
Examples:
>ROUTE MODE DIRECT
Route Mode "Direct" Set
>ROUTE MODE NORMAL
Route Mode "Normal" Set
SELINUX STATUS Displays the status of Security-Enhanced Linux (SELinux).
SEND_COMMAND D:P:S or Sends a specified command to a device. The device can be on any system that the Master you are
NAME,COMMAND connected to can reach. You can specify the device number, port, and system; or the name of the
device that is defined in the DEFINE_DEVICE section of the Program.
The data of the string is entered with the following NetLinx string syntax:
SEND_COMMAND 1:1:1,"'This is a test',13,10"
SEND_COMMAND RS232_1,"'This is a test',13,10"
SEND_LEVEL <D:P:S>, Allows the user to set a level on a device via the Master's Telnet/program port interface.
<LEVEL ID>,<LEVEL VALUE>
SEND_STRING D:P:S or Sends a string to a specified device. The device can be on any system that the Master you are
NAME,STRING connected to can reach.
You can specify the device number, port, and system; or the name of the device defined in the
DEFINE_DEVICE section of the Program.
The data of the string is entered with NetLinx string syntax.
SET DATE Prompts you to enter the new date for the Master. When the date is set on the Master, the new date
will be reflected on all devices in the system that have clocks (i.e. touch panels). By the same token,
if you set the date on any system device, the new date will be reflected on the system’s Master, and
on all connected devices.
NOTE: This command will not update clocks on devices connected to another Master (in
Master-to-Master systems).
Example:
>SET DATE
Enter Date: (mm/dd//yyyy) ->
SET DEVICE REBOOT Sets the fault response to an NI device side failure.
Example:
>SET DEVICE REBOOT

NX-Series Controllers - WebConsole & Programming Guide 111

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
SET DNS <D:P:S> Sets up the DNS configuration of a device. This command prompts you to enter a Domain Name,
DNS IP #1, DNS IP #2, and DNS IP #3. Then, enter Y (yes) to approve/store the information in the
Master.
Entering N (no) cancels the operation.
NOTE: The device must be rebooted to enable new settings.
Example:
>SET DNS [0:1:0]
-- Enter New Values or just hit Enter to keep current settings --

Enter Domain Suffix: amx.com

Enter DNS Entry 1 : 192.168.20.5
Enter DNS Entry 2 : 12.18.110.8
Enter DNS Entry 3 : 12.18.110.7

You have entered: Domain Name: amx.com

DNS Entry 1: 192.168.20.5
DNS Entry 2: 12.18.110.8
DNS Entry 3: 12.18.110.7

Is this correct? Type Y or N and Enter -> Y

Settings written. Device must be rebooted to
enable new settings
SET DUET MEMORY Set the amount of memory allocated for Duet Java pool. This is the current Java memory heap size
as measured in Megabytes. This feature is used so that if a NetLinx program requires a certain size
of memory be allotted for its currently used Duet Modules, it can be reserved on the target Master.
Valid values are:
• 2 - 8 for 32MB systems
• 2 - 36 for 64MB systems.
This setting does not take effect until the next reboot.
NOTE: If you are trying to accomplish this setting of the Duet Memory size via a NetLinx
program, the program command "DUET_MEM_SIZE_SET(int)" should call REBOOT() following
a set.
SET FTP PORT Enables/Disables the Master’s IP port listened to for FTP connections.
NOTE: The Master must be rebooted to enable new settings.
Example:
>SET FTP PORT
FTP is enabled
Do you want to enable (e) or disable (d) FTP (enter e or d):
FTP enabled, reboot the Master for the change to take affect.
SET HTTP PORT Sets the Master’s IP port listened to for HTTP connections.
NOTE: The Master must be rebooted to enable new settings.
Example:
>SET HTTP PORT
Current HTTP port number = 80
Enter new HTTP port number (Usually 80) (0=disable HTTP):
Setting HTTP port number to
New HTTP port number set, reboot the Master for the change to take affect.
SET HTTPS PORT Sets the Master’s IP port listened to for HTTPS connections.
NOTE: The Master must be rebooted to enable new settings.
Example:
>SET HTTPS PORT
Current HTTPS port number = 443
Enter new HTTPS port number (Usually 443) (0=disable HTTPS):
Once you enter a value and press the ENTER key, you receive the following message:
Setting HTTPS port number to
New HTTPS port number set, reboot the Master for the change to take affect.
SET HTTPS REDIRECT Sets the HTTPS redirect flag. All HTTP requests will be redirected to HTTPS.
See the CLEAR HTTPS REDIRECT command on page 105.

NX-Series Controllers - WebConsole & Programming Guide 112

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
SET ICSLAN Sets the ICSLAN port settings.
Example:
>set icslan
--- Enter New Values or just hit Enter to keep current settings
Enter ICSLan Host Name: ICSLAN
Enter ICSLan Network octet 1: 198
Enter ICSLan Network octet 2: 18
Disable DHCP Server? (Y):
See the Using the ICSLAN Network section on page 120 for more information.
SET ICSP PORT Sets the Master’s IP port listened to for ICSP connections.
NOTE: The Master must be rebooted to enable new settings.
Example:
>SET ICSP PORT
Current ICSP port number = 1319
Enter new ICSP port number (Usually 1319)
(0=disable ICSP):
Once you enter a value and press the ENTER key, you receive the following message:
Setting ICSP port number to
New ICSP port number set, reboot the Master for the change to
take affect.
SET ICSP TCP TIMEOUT Sets the timeout period for ICSP and i!-Web Control TCP connections.
NOTE: The new timeout value is immediately (no reboot required).
Example:
>SET ICSP TCP TIMEOUT

This will set the timeout for TCP connections for both ICSP and i!-Web
Control.When no communication has been detected for the specified number of
seconds, the socket connection is closed.ICSP and i!-Web Control have built-in
timeouts and reducing the TCP timeout below these will cause undesirable
results. The default value is 45 seconds.

The current ICSP TCP timeout is 45 seconds

Enter new timeout (in seconds):
Once you enter a value and press the ENTER key, you receive the following message:
New timeout value set (in affect immediately).
SET IP <D:P:S> Sets the IP configuration of a specified device.
Enter a Host Name, Type (DHCP or Fixed), IP Address, Subnet Mask, and Gateway IP Address.
NOTE: On a Master, the host names may contain only the ASCII letters 'a' through 'z'
(case-insensitive), the digits '0' through '9', and the hyphen ('-').
• Enter Y (yes) to approve/store the information into the Master.
• Enter N (no) to cancel the operation.
NOTE: The Device must be rebooted to enable new settings.
Example:
>SET IP [0:1:0]
--- Enter New Values or just hit Enter to keep current settings ---

Enter Host Name: MLK-INSTRUCTOR

Enter IP type. Type D for DHCP or S for Static IP and then Enter: DHCP
Enter Gateway IP: 192.168.21.2

You have entered: Host Name MLK-INSTRUCTOR

Type DHCP
Gateway IP 192.168.21.2
Is this correct? Type Y or N and Enter -> y
Settings written. Device must be rebooted to enable new settings.
SET LOCKOUT Sets the number of failed logins on a user account before the user account is locked.
Example:
>SET LOCKOUT 10

NX-Series Controllers - WebConsole & Programming Guide 113

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
SET LOG COUNT Sets the number of entries allowed in the message log.
NOTE: The Master must be rebooted to enable new settings.
Example:
>SET LOG COUNT
Current log count = 1000
Enter new log count (between 50-10000):
Once you enter a value and press the ENTER key, you receive the following message:
Setting log count to
New log count set, reboot the Master for the change to
take affect.
SET NOTIFY THROTTLE Sets the Master-to-Master notification throttle level.
Example:
>SET NOTIFY THROTTLE

Current notification throttle level = 5

Enter the master-to-master notification throttle level between 1 (low) and 10
(high):
Notification throttle set to 5
The system must be rebooted for the setting to take effect.
SET OCSP URL Sets the user OCSP URL. The URL should be in the format http(s)://<ip address>
Syntax:
SET OCSP URL <url>
Example:
>SET OCSP URL http(s)://192.168.0.1
SET QUEUE SIZE Provides the capability to modify maximum message queue sizes for various threads.
Example:
set queue size
This will set the maximum message queue sizes for several threads.
Use caution when adjusting these values.
Set Queue Size Menu:
1. Interpreter (factory default=2000, currently=600)
2. Notification Manager (factory default=2000, currently=200)
3. Connection Manager (factory default=2000, currently=500)
4. Route Manager (factory default=400, currently=200)
5. Device Manager (factory default=500, currently=500)
6. Diagnostic Manager (factory default=500, currently=500)
7. TCP Transmit Threads (factory default=600, currently=200)
8. IP Connection Manager (factory default=800, currently=500)
9. Message Dispatcher (factory default=1000, currently=500)
10. Axlink Transmit (factory default=800, currently=200)
11. ICSP 232 Transmit (factory default=500, currently=500)
12. UDP Transmit (factory default=500, currently=500)
13. NX Device (factory default=500, currently=500)
Enter choice or press ESC.
SET SELF SIGNED CERTIFICATE Enables or disables self-signed certificates for ICSPS connections. (Enable = 1; Disable = 0)
Syntax:
SET SELF SIGNED CERTIFICATE [0|1]
Example:
>SET SELF SIGNED CERTIFICATE 1
SET SSH PORT Sets the Master’s IP port listened to for SSH connections.
NOTE: The Master must be rebooted to enable new settings.
Example:
>SET SSH PORT
Current SSH port number = 22
Enter new SSH port number (Usually 22) (0=disable SSH):
Once you enter a value and press the ENTER key, you receive the following message:
Setting SSH port number to 22
New SSH port number set, reboot the Master for the change to take effect.

NX-Series Controllers - WebConsole & Programming Guide 114

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
SET SYSTEM NUMBER Sets the system number for this Master.
NOTE: The Master must be rebooted to enable new settings.
Example:
>set system number
Current System number = 1
Enter new System number : 2
Setting System number to 2
New System number set, reboot the master for the change to take effect.
SET TELNET PORT Sets the Master’s IP port listened to for Telnet connections.
NOTE: The Master must be rebooted to enable new settings.
Example:
>SET TELNET PORT
Current telnet port number = 23
Enter new telnet port number (Usually 23)
(0=disable Telnet):
Once you enter a value and press the ENTER key, you receive the following message:
Setting telnet port number to 23
New telnet port number set, reboot the Master for the change to take effect.
SET THRESHOLD Sets the Master's internal message thresholds.
This command will set the thresholds of when particular tasks are pended. The threshold is the
number of messages queued before a task is pended.
Use extreme caution when adjusting these values.
NOTE: The Master must be rebooted to enable new settings.
Example:
>SET THRESHOLD

-- This will set the thresholds of when particular tasks are pended. The
threshold is the number of messages queued before a task is pended.--
--Use extreme caution when adjusting these values.--
Current Interpreter Threshold = 2000
Enter new Interpreter Threshold (Between 1 and 2000)(Default=10):
Once you enter a value and press the ENTER key, you receive the following message:
Current Lontalk Threshold = 50
Enter new Lontalk Threshold (Between 1 and 2000)
(Default=50):50
Current IP Threshold = 600
Enter new IP Threshold (Between 1 and 2000)
(Default=200): 600
Setting Thresholds to: Interpreter 2000
Lontalk 50
IP 600
New thresholds set, reboot the Master for the changes to take effect.
SET TIME Sets the current time. When the time is set on the Master, the new time will be reflected on all
devices in the system that have clocks (i.e. touch panels). By the same token, if you set the time on
any system device, the new time will be reflected on the system’s Master, and on all connected
devices.
NOTE: This will not update clocks on devices connected to another Master (in
Master-to-Master systems).
Example:
>SET TIME
Enter Date: (hh:mm:ss) ->
SET TIMELINE LOOPCNT Sets the Master's timeline/event max loopcount.
SET UDP BC RATE Sets the UDP broadcast rate. A broadcast message is sent by the Master to allow devices to
discover the Master. This command allows the broadcast frequency to be changed or eliminate the
broadcast message.
Example:
>SET UPD BC RATE
Current broadcast message rate is 5 seconds between messages.
Enter broadcast message rate in seconds between messages
(off=0; default=5) (valid values 0-300):
Once you enter a value and press the ENTER key, you receive the following message:
Setting broadcast message rate to 300 seconds between messages
New broadcast message rate set.

NX-Series Controllers - WebConsole & Programming Guide 115

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
SET URL <D:P:S> Sets the initiated connection list URLs of a device. Enter the URL address and port number of
another Master or device (that will be added to the URL list).
• Enter Y (yes) to approve/store the new addresses in the Master.
• Enter N (no) to cancel the operation.
Example:
>SET URL [0:1:0]
No URLs in the URL connection list
Type A and Enter to Add a URL or Enter to exit.
> a

Enter URL -> 192.168.21.200

Enter Port or hit Enter to accept default (1319) ->
Enter Type (Enter for permanent or T for temporary) ->
URL Added successfully.
SHOW AUDIT [FILENAME] Displays the current day’s audit record. Optionally, you can specify a file name to display previous
audit logs.
SHOW AUDIT LOG Displays the User Account Access Audit Log.
Example:
SHOW AUDIT LOG
08-24-2009 06:54:04 <TERMINAL> administrator TERMINAL LOGIN_SUCCESS
08-24-2009 07:05:30 <TERMINAL> administrator TERMINAL LOGIN_SUCCESS
09-04-2009 09:21:09 <TERMINAL> administrator TERMINAL LOGIN_SUCCESS
09-04-2009 09:25:49 192.168.220.171 administrator HTTPS LOGIN_SUCCESS
09-04-2009 09:35:55 192.168.220.171 administrator HTTPS LOGOUT
09-08-2009 06:07:46 192.168.220.171 administrator SSH LOGIN_SUCCESS
09-08-2009 06:07:55 192.168.220.171 administrator SSH LOGOUT
09-08-2009 07:44:29 192.168.220.171 administrator HTTPS LOGIN_FAIL
09-08-2009 07:44:44 192.168.220.171 administrator HTTPS LOGIN_SUCCESS
09-08-2009 07:45:25 192.168.220.171 administrator HTTPS LOGOUT
Each record displays:
• Date and time of access,
• Connection source consisting of either <TERMINAL> or the IP address of the user,
• Account username,
• Access transport mechanism (TERMINAL, HTTP, HTTPS, TELNET, SSH)
• Activity (LOGIN_SUCCESS, LOGIN_FAIL, LOGOUT).
NOTE: Records older than 90 days will be automatically purged.
The entire database of audit records can be purged manually from Telnet/SSH/terminal session
using the "CLEAR AUDIT LOG" command (see page 105).
SHOW BUFFERS Displays a list of various message queues and the number of buffers in each queue
Example:
show buffers
Thread TX RX Queued
----------- ---- ---- ----
Axlink 0
UDP 0 0-Sent=NO Waiting=NO
IPCon Mgr 0
Con Manager 0
Interpreter 0
Device Mgr 0
Diag Mgr 0
Msg Dispatch 0
Cfg Mgr 0
Route Mgr 0
Notify Mgr 0
Java Router 0
---- ---- ----
Total 0 0 0 GrandTotal 0
NOTE: See the SHOW MAX BUFFERS section on page 118.
SHOW COMBINE Displays a list of devices, levels, and channels that are currently combined.
Example:
> SHOW COMBINE
Combines
--------
Combined Device([33096:1:1],[96:1:1])
Combined Level([33096:1:1,1],[128:1:1,1],[10128:1:1,1])
Combined Device([33128:1:1],[128:1:1],[10128:1:1])

NX-Series Controllers - WebConsole & Programming Guide 116

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
SHOW DEVICE <D:P:S> Displays a list of devices present on the bus, with their device attributes.
Example:
>SHOW DEVICE [0:1:0]
Local devices for system #1 (This System)
----------------------------------------------------------------------------
Device (ID)Model (ID)Mfg FWID Version
00000 (00256)NXC-ME260/64M (00001)AMX Corp. 00336 v3.00.312
(PID=0:OID=0) Serial=0,0,0,0,0,0,0,0,0,0,0,0,
Physical Address=NeuronID 000531589201
(00256)vxWorks Image (00001) 00337 v3.00.312
(PID=0:OID=1) Serial=N/A
(00256)BootROM (00001) 00338 v3.00.312
(PID=0:OID=2) Serial=N/A
(00256)AXlink I/F uContr(00001) 00270 v1.03.14
(PID=0:OID=3) Serial=0000000000000000
SHOW HTTPS REDIRECT Displays the status of the HTTPS redirect flag.
See the SET HTTPS REDIRECT command on page 112.
SHOW LOG Displays the log of messages stored in the Master's memory. The Master logs all internal messages
and keeps the most recent messages. The log contains:
• Entries starting with first specified or most recent
• Date, Day, and Time message was logged
• Which object originated the message
• The text of the message:
SHOW LOG [start] [end]
SHOW LOG [filename]
SHOW LOG ALL
- [start] specifies message to begin the display.
- If start is not entered, the most recent message will be first.
- If end is not entered, the last 20 messages will be shown.
- If [ALL] is entered, all stored messages will be shown, starting with the most recent.
Example:
>SHOW LOG
Message Log for System 50 Version: v2.10.75
Entry Date/Time Object Text
-------------------------------------------------------
1: 11-01-2001 THU 14:14:49 ConnectionManager
Memory Available = 11436804 <26572>
2: 11-01-2001 THU 14:12:14 ConnectionManager
Memory Available = 11463376 <65544>
3: 11-01-2001 THU 14:10:21 ConnectionManager
Memory Available = 11528920 <11512>
4: 11-01-2001 THU 14:10:21 TelnetSvr
Accepted Telnet connection:socket=14 addr=192.168.16.110
port=2979
5: 11-01-2001 THU 14:05:51 Interpreter
CIpEvent::OnLine 10002:1:50
6: 11-01-2001 THU 14:05:51 Interpreter
CIpEvent::OnLine 128:1:50
7: 11-01-2001 THU 14:05:51 Interpreter
CIpEvent::OffLine 128:1:50
8: 11-01-2001 THU 14:05:51 Interpreter
CIpEvent::OnLine 96:1:50
9: 11-01-2001 THU 14:05:51 Interpreter
CIpEvent::OffLine 96:1:50
10: 11-01-2001 THU 14:05:51 Interpreter
CIpEvent::OnLine 128:1:50
11: 11-01-2001 THU 14:05:51 Interpreter
CIpEvent::OnLine 96:1:50
12: 11-01-2001 THU 14:05:51 Interpreter
CIpEvent::OnLine 5001:16:50
13: 11-01-2001 THU 14:05:51 Interpreter
CIpEvent::OnLine 5001:15:50
14: 11-01-2001 THU 14:05:51 Interpreter
To display only the startup log, use the SHOW START LOG command (see page 118).

NX-Series Controllers - WebConsole & Programming Guide 117

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
SHOW MAX BUFFERS Displays a list of various message queues and the maximum number of message buffers that were
ever present on the queue.
Example:
show max buffers
Thread TX RX
----------- ---- ----
Axlink 1
UDP 1
IPCon Mgr 0 (Total for TCP Connections TX=0)

Con Manager 8
Interpreter 17
Device Mgr 8
Diag Mgr 1
Msg Dispatch 0
Cfg Mgr 0
Route Mgr 0
Notify Mgr 0
---- ---- ----
Total 2 34 GrandTotal 36
See the SHOW BUFFERS section on page 116.
SHOW MEM Displays the memory usage for all memory types.
SHOW NOTIFY Displays the Notify Device List (Master-Master). This is a list of devices (up to 1000) that other
systems have requested input from and the types of information needed.
NOTE: The local system number is 1061.
Example:
>SHOW NOTIFY

Device Notification List of devices requested by other Systems

Device:Port System Needs

------------------------------------------------------
00128:00001 00108 Channels Commands Strings Levels
33000:00001 00108 Channels Commands
SHOW REMOTE Displays the Remote Device List (Master-Master). This is a list of the devices this system requires
input from and the types of information needed. If when a NetLinx Master connects to another
NetLinx Master, the newly connecting system has a device that the local system desires input from;
the new system is told what information is desired from what device.
NOTE: The local system number is 1062.
Example:
>SHOW REMOTE

Device List of Remote Devices requested by this System

Device Port System Needs

------------------------------------------------------
00001 00001 00001 Channels Commands
00002 00001 00001 Channels Commands
33000 00001 00001 Channels Commands
00128 00001 00108 Channels Commands Strings Levels
33000 00001 00108 Channels Commands
SHOW ROUTE Displays information about how this NetLinx Master is connected to other NetLinx Masters (routing
information).
Example:
>SHOW ROUTE
Route Data:

System Route Metric PhyAddress

--------------------------------
-> 50 50 0 AxLink
SHOW START LOG <START> Displays the startup log (see START LOG below).
<START> specifies the message to begin the display.
'ALL' will display all startup log messages.
NOTE: This command is identical in implementation to the SHOW LOG command (see
page 117), except that it executes the startup log.

NX-Series Controllers - WebConsole & Programming Guide 118

 Terminal (Program Port/Telnet) Commands

Terminal Commands (Cont.)

Command Description
SHOW SYSTEM <S> Displays a list of all devices in all systems currently on-line. The systems lists are either directly
connected to this Master (i.e. 1 hop away), or are referenced in the DEFINE_DEVICE section of the
NetLinx program. Optionally, you may provide the desired system number as a parameter to display
only that system's information (e.g. SHOW SYSTEM 2001).
The systems listed are in numerical order.
Example:
>SHOW SYSTEM
Local devices for system #50 (This System)
------------------------------------------------------------
Device (ID)Model (ID)Mfg FWID Version
00000 (00256)Master (00001)AMX Corp. 00256 v2.10.75
(PID=0:OID=0) Serial='2010-12090',0,0,0,0,0,0
Physical Address=NeuronID 000239712501
(00256)vxWorks Image (00001) 00257 v2.00.77
(PID=0:OID=1) Serial=N/A
(00256)BootROM (00001) 00258 v2.00.76
(PID=0:OID=2) Serial=N/A
(00256)AXlink I/F uContr(00001) 00270 v1.02
(PID=0:OID=3) Serial=0000000000000000
00096 (00192)VOLUME 3 CONTROL BO(00001)AMX Corp. 00000 v2.10
(PID=0:OID=0) Serial=0000000000000000
Physical Address=Axlink
00128 (00188)COLOR LCD TOUCH PAN(00001)AMX Corp. 32778 v5.01d
(PID=0:OID=0) Serial=0000000000000000
Physical Address=Axlink
05001 (00257)NXI Download (00001)AMX Corp. 00260 v1.00.20
(PID=0:OID=0) Serial=0,0,0,0,0,0,0,0,0,0,0,0,
Physical Address=NeuronID 000189145801
(00257)NXI/NXI-1000 Boot(00001) 00261 v1.00.00
(PID=0:OID=1) Serial=0,0,0,0,0,0,0,0,0,0,0,0,
10002 (00003)PHAST PLK-IMS (00001)Phast Corp 0003 v3.12
(PID=0:OID=0) Serial=0000000000000000
Physical Address=NeuronID 0100417BD800
SHOW TCP Displays a list of active TCP/IP connections.
Example:
>SHOW TCP
The following TCP connections exist(ed):
1: IP=192.168.21.56:1042 Socket=0 (Dead)
2: IP=192.168.21.56:1420 Socket=0 (Dead)
SHOW WATCHDOG Displays the Watchdog Manager monitors.
START LOG (ON|OFF) Enables and disables the collection of startup log messages. Once enabled, the first x number of
logs will be retained at startup for subsequent review via the SHOW START LOG <START>
command. Use SET LOG COUNT (page 114) to set the number of log message that are retained.
TIME Displays the current time on the Master.
Example:
>TIME
13:42:04
TOD ADJUSTMENTS Displays the number of times the Linux system clock needed to be updated. The Linux system clock
is compared to the hardware clock chip every hour, and if different, the Linux clock is updated with
the correct time.
URL LIST <D:P:S> Displays the list of URL addresses programmed in the Master (or another system if specified).
Example:
>URL LIST
The following URLs exist in the URL connection list
->Entry 0-192.168.13.65:1319 IP=192.168.13.65 State=Connected
Entry 1-192.168.13.200:1319 IP=192.168.13.200 State=Issue Connect
USB LOG [front|back] Directs the Master logs to a USB flash media file. The log files are named with the current date and
[enable|disable] time.
Syntax:
USB LOG [front|back] [enable|disable]
NOTE: For safe removal of the USB drive, you must issue the command to disable USB LOG.
Failure to do so may result in a message indicating "A fatal error has been detected by the Java
Runtime Environment" if the Master is actively writing a log f ile to the USB device.
ZEROCONF Enable, disable or view the new Zeroconf client in the Master. When Zeroconf is enabled (default)
[ENABLE|DISABLE|STATUS] the Master's web interface will be registered via Zeroconf and can be viewed through a Zeroconf
browser plug-in such as Bonjour for IE.

NX-Series Controllers - WebConsole & Programming Guide 119

 Terminal (Program Port/Telnet) Commands

ESC Pass Codes

There are 'escape' codes in the pass mode. These codes can switch the display mode or exit pass mode. The following 'escape'
codes are defined.
Escape Pass Codes
Command Description
+ + ESC ESC Exit Pass Mode: Typing a plus (shift =) followed by another plus followed by an ESC (the escape key) followed by another
escape exits the pass mode.
The Telnet session returns to "normal".
+ + ESC A ASCII Display Mode: Typing a plus (shift =) followed by another plus followed by an ESC (the escape key) followed by an
'A' sets the display to ASCII mode.
Any ASCII characters received by the device will be displayed by their ASCII symbol.
Any non-ASCII characters will be displayed with a \ followed by two hex characters to indicate the characters hex value.
+ + ESC D Decimal Display Mode: Typing a plus (shift =) followed by another plus followed by an ESC (the escape key) followed by a
'D' sets the display to decimal mode.
Any characters received by the device will be displayed with a \ followed by numeric characters to indicate the characters
decimal value.
+ + ESC H Hex Display Mode: Typing a plus (shift =) followed by another plus followed by an ESC (the escape key) followed by an 'H'
sets the display to hexadecimal mode.
Any characters received by the device will be displayed with a \ followed by two hex characters to indicate the characters
hex value.

Using the ICSLAN Network

The default IP address for the ICSLAN network is 198.18.0.1 with a subnet mask of 255.255.0.0.
It is important that the ICSLAN and LAN subnets do not overlap. If the LAN port is configured such that its address space overlaps
with the ICSLAN network, the ICSLAN network will be DISABLED.
DHCP Server
The ICSLAN port has a built-in DHCP server. This DHCP server is enabled by default and will serve IP addresses to any connected
devices set to DHCP mode.
The DHCP server can be disabled from telnet with the command:
SET ICSLAN
The DHCP address range is fixed. The server will provide addresses in the range x.x.0.2 through x.x.63.255.
Devices using static IP addresses on the ICSLAN network should be set within the reserved static IP address range of x.x.64.1 to
x.x.255.255.
Opening LAN and ICSLAN Sockets from Code
When opening sockets from NetLinx or Java code there is no mechanism to indicate which network to use. The controller will open
the socket on whichever network has an IP subnet that matches the address provided in the command to open the socket. There is
no indication which network was used, only whether the socket was created successfully.

NX-Series Controllers - WebConsole & Programming Guide 120

 Terminal (Program Port/Telnet) Commands

Accessing the Security Conf iguration Options

Security conf iguration options are only available to Program Port connections (see the Overview section on page 104).
1. In the Terminal session, type help security to view the available security commands. Here is a listing of the security help:
---- These commands apply to the Security Manager and Database ----
logout Logout and close secure session
set password complexity Sets the password complexity: low, medium, high.
set password min age [age] Sets the password min age.
set password max age [age] Sets the password max age.
set password history [count] Sets the number of historical passwords to compare against.
set lockout Set the password lockout settings
setup security Access the security setup menus
set security preset [level] Set the security preset
NOTE: The 'help security' and 'setup security' functions are only available via a direct Program Port connection. They are not
available to Telnet sessions.
NOTE: You can set the security preset levels to low, medium, or high.
2. Type setup security to access the Setup Security menu, shown below:
>setup security

---- These commands apply to the Security Manager and Database ----
1) Set system security options for NetLinx Master
2) Display system security options for NetLinx Master
3) Add user
4) Edit user
5) Delete user
6) Show the list of authorized users
7) Add Device
8) Edit device
9) Delete device
10) Show list of authorized devices
11) Add role
12) Edit role
13) Delete role
14) Show list of authorized roles
15) Set Inactivity Timeout (minutes)
16) Display Inactivity Timeout (minutes)
17) Enter LDAP security information
18) Test connection to the LDAP server
19) Test an LDAP user
20) Display LDAP security information
21) Show active sessions/logins
22) Backup Database
23) Restore Database from backup
24) Reset Database
25) Display Database
Or <ENTER> to return to previous menu

Security Setup ->

3. The Setup Security menu shows a list of choices and a prompt. To select one of the listed choices, simply enter the number of
the choice (1 - 25) at the prompt and press <Enter>.
Each option in the Setup Security menu displays a sub-menu specific to that option. The following subsections describe using each
of the Setup Security menu options.
NOTE: Changes made to the target Master from within the Terminal window are not reflected within the web browser, until the Master
is rebooted and the web browser connection is refreshed. Any changes made to the Master, from within the web browser are instantly
reflected within the Terminal session without the need to reboot.

NX-Series Controllers - WebConsole & Programming Guide 121

 Terminal (Program Port/Telnet) Commands

Setup Security Menu

The following table lists the options in the Setup Security menu:
Setup Security Menu
Command Description
1) Set system security options for This selection will bring up the Security Options Menu that allows you to change the security
NetLinx Master options for the NetLinx Master. These are "global" options that enable rights given to users
See the Security Options Menu section and groups.
on page 124 for descriptions of each For instance, if you want to disable Telnet security for all users, you would simply go to this
menu item. menu and disable Telnet security for the entire Master. This would allow any user, whether
they have the rights to Telnet or not.
These options can be thought of as options to turn on security for different features of the
NetLinx Master.
2) Display system security options This selection will display the current security options for the NetLinx Master.
for NetLinx Master
3) Add user This selection will prompt you for a name for the User you are adding. The user name must
be a unique alpha-numeric string (4 - 20 characters).
NOTE: User and Role names are case sensitive.
After the user has been added, you will be taken to the Edit User menu to setup the new
user’s privileges (see page 125).
4) Edit user This selection will prompt you select a user whose properties you want to edit. Once you have
selected the user you want to edit, you will access the Edit User menu so you can edit the
user's privileges (see page 125).
5) Delete user This selection will prompt you select a user to delete.
6) Show the list of authorized This selection displays a list of users that are currently enrolled.
users
7) Add device This selection will prompt you for a name for the device you are adding. The device name
must be a unique alpha-numeric string (4 - 20 characters).
After the device has been added, you will be taken to the Edit device menu to setup the new
users right (see page 126).
8) Edit device This selection will prompt you select a device whose properties you want to edit. Once you
have selected the device you want to edit, it will take you to the Edit Device Menu so you can
edit the device’s rights (see page 126).
9) Delete device This selection will prompt you select a device to delete. A device can only be deleted if there
are no users assigned to that device.
10) Show list of authorized This selection displays a list of devices that are currently enrolled.
devices
11) Add role This selection will prompt you for a name for the role you are adding. The role name must be
a unique alpha-numeric string (4 - 20 characters).
NOTE: User and Role names are case sensitive.
After the role has been added, you will be taken to the Edit Role menu to setup the new users
rights (see page 126).
12) Edit role This selection will prompt you select a role whose properties you want to edit. Once you have
selected the role you want to edit, it will take you to the Edit Role Menu so you can edit the
role’s rights (see page 126).
13) Delete role This selection will prompt you select a role to delete. A role can only be deleted if there are no
users assigned to that role.
14) Show list of authorized roles This selection displays a list of roles that are currently defined.
15) Set Inactivity Timeout This selection allows you to set a period of inactive time that must elapse before the Master
(minutes) can log out a user. You can set a timeout in the range of 1 to 60 minutes. The timeout applies
to Program Port, Telnet, SSH, HTTP, and HTTPS sessions.
16) Display Inactivity Timeout This selection displays the time set for the inactivity timeout.
(minutes)
17) Enter LDAP security This selection prompts you to specify the LDAP URI. Once the URI is entered and enter is
information pressed, a prompt for the next LDAP parameter will be displayed, and so on until all LDAP
parameters are entered.
NOTE: Options 3 - 14 (Add user, Edit user, Delete user, Show the list of authorized users,
Add device, Edit device, Delete device, Show list of authorized devices, Add role, Edit role,
Delete role, Show list of authorized roles) on the Security Setup menu are disabled when
LDAP is enabled.

NX-Series Controllers - WebConsole & Programming Guide 122

 Terminal (Program Port/Telnet) Commands

Setup Security Menu (Cont.)

Command Description
18) Test connection to the LDAP This selection prompts you for a user name and password to access an LDAP server.
server
19) Test an LDAP user This selection attempts to access the LDAP server with a user name and password you
provide.
20) Display LDAP security This selection displays the current LDAP server information.
information
21) Show active sessions/logins This selection displays the users and administrators that are currently logged into the Master.
22) Backup Database This selection creates a backup of the current local database.
23) Restore Database from backup This selection restores the local database from the most recent backup.
24) Reset Database If a user has been given "administrator rights", this additional menu option is displayed. This
selection will reset the security database to its Default Security Configuration settings,
erasing all users and groups that were added. This is a permanent change and you will be
asked to verify this before the database is reset.
This function is only visible to administrators.
25) Display Database If a user has been given "administrator rights", this additional menu option is displayed. This
selection will display the current security settings to the terminal (excluding user
passwords). It also displays all users (minus passwords), their group assignment (if any) and
their rights, as well as all groups and their rights.
This function is only visible to administrators.

Enabling LDAP via the Program Port

1. Type setup security to access the Setup Security menu, shown below:
>setup security

---- These commands apply to the Security Manager and Database ----
1) Set system security options for NetLinx Master
2) Display system security options for NetLinx Master
3) Add user
4) Edit user
5) Delete user
6) Show the list of authorized users
7) Add device
8) Edit device
9) Delete device
10) Show list of authorized devices
11) Add role
12) Edit role
13) Delete role
14) Show list of authorized roles
15) Set Inactivity Timeout (minutes)
16) Display Inactivity Timeout (minutes)
17) Enter LDAP security information
18) Test connection to the LDAP server
19) Test an LDAP user
20) Display LDAP security information
21) Show active sessions/logins
22) Backup Database
23) Restore Database from backup
24) Reset Database
25) Display Database
Or <ENTER> to return to previous menu

Security Setup ->

2. To enable LDAP, enter 1 and press Enter. The following will be output to the screen:
NetLinx Master security is Enabled
Do you want to keep NetLinx Master security enabled? (y or n):

NX-Series Controllers - WebConsole & Programming Guide 123

 Terminal (Program Port/Telnet) Commands

3. To proceed, enter y and press enter. The following menu displays:

Select to change current security option
1) Audit Log.................................. Disabled
2) Banner Disply.............................. Disabled
3) Inactivity Timeout......................... Disabled
4) Failed Login Lockout....................... Disabled
5) OCSP....................................... Disabled
6) Password Expiration........................ Disabled
7) Usb........................................ Enabled
8) Auth on server port (telnet, ftp).......... Enabled
9) Auth on ICSP Lan .......................... Disabled
10) Encryption on ICSP Lan .................... Disabled
11) Auth on ICSP-ICSLan ....................... Disabled
12) Encryption on ICSP-ICSLan ................. Disabled
13) HTTP Service............................... Enabled
14) HTTPS Service.............................. Enabled
15) Telnet Service............................. Enabled
16) SSH Service................................ Enabled
17) FTP Service................................ Enabled
18) SFTP Service............................... Enabled
19) ICSP on WAN................................ Enabled
20) ICSP on ICSLan............................. Enabled
21) General Configuration Security............. Disabled
22) LDAP Security.............................. Enabled
Or <ENTER> to return to previous menu
4. To enable LDAP Security, enter 21 and press Enter. The same menu will be sent to the screen with LDAP Security set to
Enabled. Press enter to return to the Security Setup menu.
5. When back to the Security Setup menu, enter 17 and press Enter.
A prompt to enter the LDAP URI will be displayed. Once you enter the URI is entered and press enter, a prompt for the next
LDAP parameter appears.
Continue entering the LDAP server parameters until all parameters are entered. The Security Setup menu displays again.
6. To test the connection to the server enter 18 and press Enter.
This test performs a bind to the BIND DN using the Search Password entered. If the bind is successful, "Connection
successful" appears on the screen. If the server could not be reached or the bind is unsuccessful, "Could not connect to
server" appears on the screen.
7. Press Enter to return to the main menu.
NOTE: Options 3 - 14 (Add user, Edit user, Delete user, Show the list of authorized users, Add device, Edit device, Delete device, Show
list of authorized devices, Add role, Edit role, Delete role, Show list of authorized roles) on the Security Setup menu are disabled when
LDAP is enabled.
Security Options Menu
Select "Set system security options for NetLinx Master" (option 1) from the Setup Security Menu to access the Security Options
menu, described in the following table:
Security Options Menu
Command Description
1) Audit Log This selection enables/disables remote syslog.
2) Banner Display This selection enables/disables banner messages.
3) Inactivity Timeout This selection enables/disables whether the Master logs out a user after a defined period of
inactivity.
4) Failed Login Lockout This selection enables/disables whether the Master places a lock on a user account after a set
number of failed logins.
5) OCSP This selection enables/disables usage of the Online Certificate Status Protocol (OCSP) to validate
received certificates before trusting the sending site.
6) Password Expiration This selection enables/disables whether the Master forces a user to change its password after a set
period of time.
7) USB This selection enables/disables all Type-A USB connectors on the Master.
8) Auth on server port This selection enables/disables whether the Master requires user name and password
(Telnet, FTP) authentication on Telnet, Program, and HTTP/HTTPS ports.
9) Auth on ICSP LAN This selection enables/disables whether the Master requires user name and password
authentication on devices connected to the LAN ports on the Master.
10) Encryption on ICSP LAN This selection enables/disables whether there is encryption on the LAN ports on the Master.

NX-Series Controllers - WebConsole & Programming Guide 124

 Terminal (Program Port/Telnet) Commands

Security Options Menu (Cont.)

Command Description
11) Auth on ICSP-ICSLAN This selection enables/disables whether the Master requires user name and password
authentication on devices connected to the ICSLAN ports on the Master.
12) Encryption on ICSP-ICSLAN This selection enables/disables whether there is encryption on the ICSLAN ports on the Master.
13) HTTP Service This selection enables/disables HTTP access to the Master.
14) HTTPS Service This selection enables/disables HTTPS access to the Master.
15) Telnet Service This selection enables/disables Telnet access to the Master.
16) SSH Service This selection enables/disables SSH access to the Master.
17) FTP Service This selection enables/disables FTP access to the Master.
18) SFTP Service This selection enables/disables SFTP access to the Master.
19) ICSP on WAN This selection enables/disables ICSP on WAN ports.
20) ICSP on ICSLAN This selection enables/disables ICSP on ICSLAN ports.
21) General Configuration This selection enables/disables general configuration including access to WebControl for RMS and
Security RPM Configuration and the following parameters:
• Auto-locate enable/disable
• Device Holdoff setting
• Duet memory allocation
• ICSP TCP timeout
• Master-to-master route mode
• Message log length
• Message thresholds for threads
• Queue sizes for threads
• UDP broadcast rate
22) LDAP Security This selection enables/disables LDAP Security. Refer to Appendix A: LDAP Implementation Details
on page 127 for details on LDAP Implementation.

Edit User Menu

The Edit User Menu is accessed whenever you enter the Add user, or Edit user selections from the Setup Security menu. The Edit
User Menu options are described in the following table:
Edit User Menu
Command Description
1) Generate New Password This selection creates a new password for the user. Once the new password is entered, the user
must use the new password from that point forward, or change the password.
2) Rename User This selection enables you to change the user’s name.
3) Require Password Change On This selection enables you to toggle whether the user will be required to change its password
Next Login the next time the user logs in to the Master. When this option is enabled, the words "already
set" appear next to the option in the Edit menu.
4) Change Role Membership This selection enables you to assign or remove a role from the user. Active roles for the user are
marked with an asterisk (*).
5) Display Role Membership This selection will display any roles assigned to the user.
6) Lock/Unlock User This selection enables you to lock the user’s account. When locked, the option changes to
Unlock User. Select the option again to unlock the user’s account.

Edit Device Menu

The Edit Device Menu is accessed whenever you enter the Add device, or Edit device selections from the Setup Security menu. The
Edit Device Menu options are described in the following table:
Edit Device Menu
Command Description
1) Generate Device Password This selection prompts you to enter the new password (twice) for the user. Once you enter the
new password, you must use the new password from that point forward.
2) Change Role Membership This selection enables you to assign or remove a role from the device. Active roles for the device
are marked with an asterisk (*).
3) Display Role Membership This selection will display any roles assigned to the device.
4) Lock/Unlock Device This selection enables you to lock the device’s account. When locked, the option changes to
Unlock Device. Select the option again to unlock the device’s account.
5) Rename This selection enables you to change the device’s name.

NX-Series Controllers - WebConsole & Programming Guide 125

 Terminal (Program Port/Telnet) Commands

Edit Role Menu

The Edit Role Menu is accessed whenever you enter the Add role, or Edit role selections from the Setup Security menu. The Edit
Role Menu options are described in the following table:
Edit Role Menu
Command Description
1) Display Access Rights This selection will display the current Access Rights assigned to the role.
2) Change Access Rights This selection will display any current directory associations assigned to the role, and then will
prompt you to select the directory association you want to delete.
3) Disable/Enable Role This selection allows you to disable the role so it cannot be assigned to a user or device. When
disabled, the option changes to Enable Role. Select the option again to enable the role.
4) Rename This selection enables you to change the role’s name.

Access Rights Menu

The Access Rights Menu is accessed whenever you select Change Access Rights (option 2) from the Edit Role menu. Active access
rights for the role are marked with an asterisk (*). The options in this menu is described in the following table:
Access Rights Menu
Option Description
1) View Audit Log Select to allow the role to view and configure the audit log.
2) Configuration Select to allow the role to modify general configuration including access to WebControl for RMS and RPM
Security Configuration and the following parameters:
• Auto-locate enable/disable
• Device Holdoff setting
• Duet memory allocation
• ICSP TCP timeout
• Master-to-master route mode
• Message log length
• Message thresholds for threads
• Queue sizes for threads
• UDP broadcast rate
NOTE: This permission also includes the right to reboot the Master after the conf iguration change. It
does not include the right to reboot the Master outside of this context or to reboot any other devices.
NOTE: This permission is not required to view the information, only to change it.
3) Device Configuration Select to allow the role to modify the configuration of NetLinx and 3rd party devices including the
following:
• System number
• Device number
• Duet/XDD module binding options
• IP Device Discovery enable/disable
• NDP enable/disable
• NetLinx device control/emulation
• URL list
• Integrated device settings
• Switcher device settings (DVX or DGX)
• Reboot
NOTE: This permission is not required to view the information, only to change it.
4) Network Select to allow the role to modify network configuration including the following:
Configuration • Clock Manager settings
• DHCP/Static setting (Gateway IPv4 address, IPv4 address, IPv4 subnet mask (if static selected))
• DNS server addresses
• Domain name
• Hostname
• zeroconfig enable/disable
NOTE: This permission also includes the right to reboot the Master after the conf iguration change. It
does not include the right to reboot the Master outside of this context or to reboot any other devices.
NOTE: This permission is not required to view the information, only to change it.
5) Telnet/SSH Select to allow the role to have Telnet and SSH access.
6) FTP/SFTP Access Select to allow the role to have FTP and SFTP access.
7) HTTP Select to allow the role to have HTTP and HTTPS access.
8) Program Port/RS232 Select to allow the role to have terminal access via the Program Port.

NX-Series Controllers - WebConsole & Programming Guide 126

 Terminal (Program Port/Telnet) Commands

Access Rights Menu (Cont.)

Option Description
9) Security Control Select to allow the role to view and configure security including the following:
• Security settings
• Certificate policy (trusted CAs, etc.) and management (upload, delete)
• LDAP server settings
• Role settings
NOTE: This permission also includes the right to reboot the Master after the conf iguration change. It
does not include the right to reboot the Master outside of this context or to reboot any other devices.
NOTE: This permission is not required to view the information, only to change it.
10) Software Update Select to allow the role to update firmware and software.
NOTE: This permission also includes the right to reboot the Master after the update. It does not
include the right to reboot the Master outside of this context or to reboot any other devices.
11) User Management Select to allow the role to view, create, modify, lock, and remove user accounts.
NOTE: A user has the ability to change its own password, regardless of whether it has the User
Management permission.
12-15) User Access 1-4 Select to allow the role access generic access permissions. These privileges are to be used by NetLinx
programs.
16) TPAdmin Select to allow the Master to access a touch panel’s settings page.
17) Remote UI Select to allow the Master to access Web controls for remote user interfaces, such as Virtual Touch Panel
or Virtual Keypad.

Adding a Role
1. Type 11 and <Enter> at the Security Setup prompt (at the bottom of the Main Security Menu) to add a new role. A sample
session response is:
The following groups are currently defined:
All_Permissions
Studio
User
Enter name of new role:
2. Enter a name for the group. A group name is a valid character string (4 - 20 alpha-numeric characters) defining the group.
This string is case sensitive, and each group name must be unique.
3. Press <Enter> to display the Edit Group menu.
Default Security Conf iguration
By default, the NetLinx Master will create the following accounts, access rights, directory associations, and security options.
Account 1: User Name: administrator
Password: password
Role: All_Permissions
Directory Association: /*

Account 2: User Name: NetLinx

Password: password
Role: Studio
Directory Association: none

Role 1: Group: All_Permissions

Rights: All
Directory Association: /*

Role 2: Role: Studio

Rights: Device Management, Firmware Update, Network Management, Security Control
Directory Association: /*

Security Options: USB enabled

Auth on server port (telnet, ftp) enabled
HTTP/HTTPS Services enabled
Telnet/SSH Services enabled
FTP/SFTP Services enabled
ICSP on WAN/ICSLAN enabled
All other options disabled

NX-Series Controllers - WebConsole & Programming Guide 127

 Terminal (Program Port/Telnet) Commands

Telnet Diagnostics Commands

The following Telnet Diagnostics Commands provide visibility to remote Masters, in order to determine the current state of
operations, and are provided as diagnostic/troubleshooting tools.
While these commands are available for any user to execute, their output is interpretable primarily by an AMX Technical Support
Engineer.
Telnet Diagnostics Commands
Command Description
PHYSICAL STATUS This command reports the current state of the Master’s Status, Output and Input LEDs, in order to
troubleshoot a remote Master. For example, if PHYSICAL STATUS indicates that the Input LED always shows
‘1’ (or ON), it could indicate that the Master is being hammered by incoming events.
MSG STATS This command collects messages statistics for the Interpreter over a 10 second period by calculating the
number of event messages that have been processed. This can be useful as a debugging/diagnostics tool to
determine if the NetLinx Interpreter is running and how many messages it’s processing.

Logging Out of a Terminal Session

CAUTION: It is very important to execute the 'logout' command prior to disconnecting from a Master. Simply removing the
connector from the Program Port maintains your logged-in status until you either return to logout via a new session or reboot the
target Master.

Notes on Specif ic Telnet/Terminal Clients

Telnet and terminal clients will have different behaviors in some situations. This section states some of the known anomalies.
Windows Client Programs
Anomalies occur when using a Windows™ client if you are not typing standard ASCII characters (i.e. using the keypad and the ALT
key to enter decimal codes). Most programs will allow you to enter specific decimal codes by holding ALT and using keypad
numbers.
For example, hold ALT, hit the keypad 1, then hit keypad 0, then release ALT. The standard line feed code is entered (decimal 10).
Windows will perform an ANSI to OEM conversion on some codes entered this way because of the way Windows handles languages
and code pages.
The following codes are known to be altered, but others may be affected depending on the computer's setup.
Characters 15, 21, 22, and any characters above 127.
This affects both Windows Telnet and Terminal programs.
Linux Telnet Client
The Linux Telnet client has three anomalies that are known at this time:
A null (\00) character is sent after a carriage return.
If an ALT 255 is entered, two 255 characters are sent (per the Telnet RAFT).
If the code to go back to command mode is entered (ALT 29 which is ^]), the character is not sent, but Telnet command
mode is entered.

NX-Series Controllers - WebConsole & Programming Guide 128

 Appendix A: LDAP Implementation Details

Appendix A: LDAP Implementation Details

Overview
The process of verifying credentials and obtaining user authorization is designed to support most organizations requirements for
'least privilege'. The account used to search LDAP to provide user objects for authentication never needs access to user
information. Authorization lookups are performed as the authenticated user and as such, no elevated permission is required.

Changes to LDAP Implementation (v1.4.x)

There are numerous changes to LDAP configuration when you upgrade your Master’s firmware to version 1.4.x or higher.
Upgrading from version 1.3.x to 1.4.x may require you to make changes to the configuration on your LDAP server.
When a remote directory service is enabled, the Master maps a user’s group memberships in the LDAP database to a
locally-defined Role. A Role is a set of privileges or permissions assigned to one or more users. See the Security -
Roles section on page 47 for more information.
The common name of the LDAP group on the LDAP server must match the name of the Role assigned to the user on the
Master.
ICSP permission is granted for Device-type users, and only when the user is granted the Firmware/Software Update
permission. See the Role Permissions section on page 48 for more information.
Device authentication is no longer checked against the remote LDAP server. All device authentication is performed locally.
Several changes to Active Directory and OpenLDAP configurations. See the Active Directory/OpenLDAP Setup section below
for more details.
Active Directory/OpenLDAP Setup
Unix Identity Module on Active Directory or OpenLDAP must use posixAccount for user and group memberships. For
OpenLDAP, you can add posixAccount to each entry that requires SSH/SFTP authentication. inetOrgPerson will continue
to work for FTP/HTTP/HTTPS/Program Port authentication.
When adding posixAccount to an existing entry, you may be asked for a uidNumber or gidNumber. These numbers must be unique
for each user (uidNumber) or group (gidNumber), however, the actual values do not matter to the NX-controller. When creating the
attributes, consider the following rules:
uidNumber must be unique for each user (often enforced by the server.)
gidNumber must be unique for each group.
homeDirectory can be anything (typically it is /home/<cn>, but you can also use /bin/false or /opt/amx/user.)
NOTE: If you have already installed Identity Management for Unix (IDMU) on your Windows Server, you can assign these attributes
using the tools for IDMU. However, if you do not have IDMU installed, you must enter the attributes manually.
Perform these steps to manually set the attributes:
1. In Windows, select Start | Control Panel | Administrative Tools. Select Active Directory Users and Computers.
2. In the Active Directory Users and Computers dialog, select Advanced Features from the View menu.
3. Create a new user or select an existing user.
4. Right-click the user to view user's properties.
5. Click the Attribute tab.
6. Select gidNumber and click Edit.
7. Enter a gidNumber.
8. Select uidNumber and click Edit.
9. Enter a uidNumber.
10. Click OK to accept the changes, and click OK close the user properties dialog.

NX-Series Controllers - WebConsole & Programming Guide 129

 Appendix A: LDAP Implementation Details

The following table provides sample LDIF files:

Sample LDIF Files
Example: Example:
dn: cn=admin,dc=smith,dc=local dn: ou=users,dc=smith,dc=local
objectClass: simpleSecurityObject objectClass: organizationalUnit
objectClass: organizationalRole objectClass: top
cn: admin ou: users
description: LDAP administrator
Example: Example:
dn: uid=olUser,ou=users,dc=smith,dc=local dn: uid=olAdmin,ou=users,dc=smith,dc=local
cn: user cn: olAdmin
uid: olUser uid: olAdmin
objectClass: posixAccount objectClass: posixAccount
objectClass: inetOrgPerson objectClass: inetOrgPerson
objectClass: top objectClass: top
uidNumber: 5001 uidNumber: 5000
gidNumber: 5001 homeDirectory: /home/olAdmin
homeDirectory: /home/olUser sn: admin
sn: olUser gidNumber: 5000

Changes to LDAP Implementation (v1.5.x)

There are numerous changes to LDAP configuration when you upgrade your Master’s firmware to version 1.5.x or higher.
Upgrading from version 1.4.x to 1.5.x may require you to make changes to the configuration on your LDAP server.
User Query Attribute
If the server is an LDAP server, the attribute used for the User Query Attribute can be any unique attribute but typically the
cn attribute is used.
If the server is an Active Directory server, the attribute used for the User Query Attribute field MUST be sAMAccountName.
If the sAMAccountName attribute is not used, LDAP authentication will work for Telnet and HTTP but not for FTP and
SSH.
FTP Access with LDAP Authentication
If the server is an Active Directory server, the sAMAccountName attribute must be used for the User Query Attribute field
on the NX Master’s LDAP configuration page.
For FTP access to an NX Master to work using LDAP authentication credentials on an NX Master running firmware version
1.5.x, the following attributes must exist on the user account on the LDAP/Active Directory server: gidNumber,
homeDirectory, uidNumber.
If the server is an Active Directory server, the homeDirectory attribute in the user account can contain ANY value.
If the server is an LDAP server, the homeDirectory attribute in the user account MUST be a valid UNIX directory path format
(for example, /user or /bin). However, if the homeDirectory attribute contains two levels of directories which do not exist
on the NX Master (for example, /bin/nonexistent directory), FTP access will not work.
The uidNumber, gidNumber, homeDirectory, and loginShell attributes MUST be readable by the BINDDN for FTP to work.
SSH Access with LDAP Authentication
Same requirements as FTP (see above)
The user account (on either an Active Directory server or LDAP server) can contain the loginShell attribute, but this
attribute is not required.
If the loginShell attribute does exist in the user account and the server is an Active Directory server, the value of the
loginShell attribute can be ANY value.
If the loginShell attribute does exist in the user account and the server is an LDAP server, the value of the loginShell
attribute MUST be a valid UNIX directory path format (for example, /user or /bin). However, if the loginShell attribute
contains two levels of directories which do not exist on the NX Master (for example, /bin/nonexistent directory), SSH
access won't work.
The uidNumber, gidNumber, homeDirectory, and loginShell attributes MUST be readable by the BINDDN for SSH to work.

NX-Series Controllers - WebConsole & Programming Guide 130

 Appendix A: LDAP Implementation Details

Assumptions and Prerequisites

Assumptions made about the LDAP implementation or environment in which the AMX client will participate include:
1. Must support simple authentication (for example, NetLinx Masters do not support Kerberos or SASL).
2. The account setup for a bind DN must have search capability along with the necessary permissions to read the 'uid', 'cn',
'member' and 'objectclass' attributes.
3. When a search is performed to find a DN with the specified user ID, a search must return one and only one object if the user
exists. No object will be returned if an account does not exist for that user ID.
4. An account is considered valid if a user can authenticate/bind. No other attributes are considered during the authentication
process.
5. AMX LDAP implementation supports both encrypted and un-encrypted connections using SSL.
6. When a person authenticates, that account must have access to all the attributes defined by RFC 2798 with the following
exception:
User passwords are not necessarily accessible for anything except to perform a bind to the directory (for example, this
attribute may not be directly available to the user).
7. The bind DN must have the ability to search for group membership. (This ability is similar to RMS requirements.)
8. When a person authenticates, that account must have access to "cn" attributes for all groups of which it is a member.
9. Group membership for users is defined by the Role assigned to the user. Use GroupOfNames as the objectClass for group
mapping. GroupOfUniqueNames is not supported due to ambiguities associated with implementations which use unique IDs
appended to membership DNs.
10. When performing searches for group membership, no restrictions exist which would the restrict returning the full list of
objects for which the user is a member with the possible exception of reasonable response timeouts. AMX LDAP
implementation does not support paged search results.
11. AMX LDAP implementation does not support following referrals.
IMPORTANT: For the NX-series Masters to work with LDAP over SSL (LDAPS), you must upload a CA server certif icate in .pem format
to the Master’s FTP server. The certif icate’s f ile name must be "ldap_ad.pem". You can attach the f ile to your NetLinx Studio project
and upload the f ile to the ../8021x directory (the default directory for .pem f iles.) Once the f ile is uploaded, you must reboot the
Master for the certif icate f ile to be read and employed by the system. LDAPS requires Master Firmware version 1.3.78 or greater.

NX-Series Controllers - WebConsole & Programming Guide 131

 Appendix A: LDAP Implementation Details

Example - Setting Up User's Access Rights

To give AMX equipment users access rights to the Master, group memberships for administrators and users are defined by the Role
Name setting when establishing Roles (see the Security - Roles section on page 47 for more information.) Two records need to be
created in the database:
One that represents users with administrative privileges (Program Port Access, FTP Access, HTTP Access, Telnet Access,
General and Network Configuration, Firmware Updates, and Security Control). The factory default settings include an
administrator user which includes all administrative privileges.
Another that represents users with user privileges. The factory default settings include a netlinx user which includes Device
Management, Firmware Update, Network Management, and Security Control privileges.
NOTE: You can create as many groups as necessary according to your policies, but you should create at least two groups to separate
administrators from other users.
IMPORTANT: The common name of the LDAP group on the server must match the name of the Role assigned to the user on the
Master.
Administrator Access Example
Administrator Access
LDAP Server Conf iguration Master Conf iguration
Example: On the Role Security Details page, create a Role with the
dn: cn=administrator,ou=groups,ou=Dallas, dc=example,dc=com Administrator groupOfNames cn, or use the existing administrator
objectClass: groupOfNames role.
objectClass: top Example:
cn: All_Permissions Role Name: All_Permissions
member: uid=DallasAdminUser1,ou=people,
ou=Dallas,dc=example,dc=com
member: uid=ICSPUser,ou=people, ou=Dallas,dc=example,dc=com

User Access Example

User Access
LDAP Server Conf iguration Master Conf iguration
Example: On the Role Security Details page, create a Role with a name which
dn: cn=master01User,ou=groups, ou=Dallas,dc=example,dc=com matches the groupOfNames cn.
objectClass: groupOfNames Example:
objectClass: top Role Name: Studio
cn: Studio
member: uid=DallasUser1,ou=people,
ou=Dallas,dc=example,dc=com
member: uid=DallasUser2,ou=people,
ou=Dallas,dc=example,dc=com

NOTE: If the DN of a user is in both the administrator groupOfNames and the user groupOfNames, the administrative privileges take
precedence over user privileges.

NX-Series Controllers - WebConsole & Programming Guide 132

 Appendix B: Certificates

Appendix B: Certif icates

Overview
In any security scenario, it is important that the private key is protected. If the private key is compromised, the entire security chain
breaks down and is subject to decryption by outside parties. The following table lists certificates supported by NX Masters:
Supported Certif icates
Certif icate Type Format Function
Trusted CA PEM A list of trusted Certificate Authorities (CAs) for verifying secure connections include
Secure-ICSP (ICSPS), TLS_CLIENT_OPEN, Audit Log, and LDAPS. For Secure ICSP
connections, this only works when the NX Master is used as a client (contains an entry
in the URL list). An audit log trusted CA must be specified when configuring remote
logging. The primary usage for Trusted CAs is to enable validation of remote sites
based on the site certificate.
CRL (Certificate Revocation PEM A list of compromised certificates that should no longer be trusted. The primary usage
List) of CRLs is to prevent a secure connection to a remote site. Since CAs must be loaded
manually, this type should be rarely needed for a well-defined system that does not
connect to random sites.
Device Certificate and PEM A certificate and private key (must be generated together) used in Secure ICSPS
Private Key connections. The primary use of custom device certificates and private keys is to
conform to unique site-specific certificate/security policies.
NOTE: These must be added in pairs to work. The key has no use without the
public certif icate, and vice versa.
NetLinx/SSH Private Key SSH-Private Key A private key (generated by SSH-keygen) to connect to a remote system using
passwordless/PKI authorization. This is NOT an X.509 certificate, but the X.509-like/
SSH custom form used by most SSH client/servers. The primary reason for SSH
private key usage is to connect to a remote server without a plain-text password in the
NetLinx program.
802.1x Certificate PEM Used by the upstream switch/RADIUS server for network authorization.
Audit Log Certificate and PEM A certificate and private key used for authorization on the Remote Syslog server. This
Private Key certificate is used only when the audit log is sending data to a remote server. The
primary reason for audit log certificates is to encrypt the logging connection to the
Remote Syslog server.
NOTE: These must be added in pairs to work. The key has no use without the
public certif icate, and vice versa.
HTTPS KeyStore JKS (Java KeyStore/ The default HTTPS store is auto-generated at the first boot. A user KeyStore should
Keytool) include the private key, the device certificate as well as the signer's certificate. The
primary reason for updating the HTTPS KeyStore is to prevent the security exception
warning when connecting to the NX over HTTPS.
Duet TrustStore JKS (Java KeyStore/ The Duet TrustStore is the default shipped with Java. If additional CAs are required,
Keytool) they should be added to the original. A user-provided Duet TrustStore is NOT in
addition to a system TrustStore. The primary reason for doing this is to add a
self-signed/internally signed CA for a server to enable HTTPS connections to RMS.

NOTE: Existing secure sites coming from 1.4 using LDAPS should continue to work for user authentication. However, in NetLinx
Studio, the Certif icate Manager may show an LDAP CA as an 802.1x certif icate. This is due to previous versions of Studio sending
.pem f iles to the 8021x directory. It is recommended that the LDAP CA be removed from the 802.1x type, and re-sent to the NX as a
Trusted CA type.
NOTE: Existing installations that used basic FTP and installed the LDAP CA in user/certs will NOT show up in the Certif icate Manager.
However, auth will still be available for most access.
NOTE: For LDAPS connections, specif ically FTP/SSH, the CA must be in the Trusted CA store otherwise the NX will authorize, but FTP/
SSH will fail. This is not required for instances where the Controller authorizes the activity (HTTP, ICSP).

NX-Series Controllers - WebConsole & Programming Guide 133

 Appendix B: Certificates

Certif icate Information

Locations Example
Path to JDK C:\Program Files\Java\jdk1.8.0_144\bin
Path to OpenSSL C:\OpenSSL-Win64\bin
Path to device certificate files C:\certs\amxnxmaster
Path to CA certificate files C:\certs\CA

File Names Type Example

Host Name amxnxmaster
HTTPS Keystore Name .jks amxnxmaster .jks
Key Alias amxnxmaster_key
Signed Cert Alias amxnxmaster_cert
Duet Truststore Name .jks truststore.jks
Intermediate CA Alias Int_CA
Root CA Alias Root_CA
Certificate Signing Request Name .csr amxnxmaster.csr
PKCS12 File Name .p12 amxnxmaster.p12
Key File Name .key amxnxmaster.key
Backup Key File Name .back amxnxmaster.back
Signed Certificate Name .cer amxnxmaster_signed_Y_M_D.cer
Intermediate CA Name .cer DoD_JITC_Root_CA_3_CA-37.cer
Root CA Name .cer JITC_Root_CA_3_CA_3.cer

Certificate Signing Request Type Example

Information
Certificate Validity days 365
Host Name
Country Name (2 letter code) CN= US
Organization Name (U.S. Government) O= U.S. Government
Organizational Unit Name 1 (DOD) OU= DOD
Organizational Unit Name 2 (Branch) OU= USN
Organizational Unit Name 3 (PKI) OU= PKI
Organizational Unit Name 4 () OU=
Fully Qualified Domain Name CN= amxnxmaster.group.command.service.mil

NX-Series Controllers - WebConsole & Programming Guide 134

 Appendix B: Certificates

Creating an HTTPS KeyStore

Java Keytool is a key and certificate management utility provided by the Java SDK. Java Keytool allows users to manage their own
public and private key pairs and certificates and to cache certificates. Java Keytool stores the keys and certificates in a KeyStore.
By default, the Java KeyStore is implemented as a file. To create an HTTPS KeyStore, you are required to install Java SDK on the host
system. You do not create certificates on the NX Master. Certificates are created on a PC then transferred to an NX Master via
NetLinx Studio. The KeyStore must be a .jks file.
The following steps are required to create an HTTPS KeyStore.
Step 1: Create the private key
Use the following commands to create the private key:
keytool -genkeypair -keyalg RSA \
-validity 365 -keystore amxcert -keysize 2048 \
-storepass amxcertpassword -keypass amxcertpassword \
-dname CN=<hostname>,OU=Harman,O=Amx,L=Richardson,S=Tx,C=US
NOTE: The CN can be any desired name. Naming conventions likely vary from site to site.
IMPORTANT: The storepass and keypass values are f ixed and should not be changed. The passwords must be "amxcertpassword".
Step 2: Generate a CSR request
Use the following command to generate a CSR request:
keytool -certreq -keystore amxcert -file master.csr -storepass amxcertpassword

Step 3: Send the master.csr f ile to the CA to have it signed.

IMPORTANT: Typically, this step is performed by the CA service. Normally, you will NOT perform this step unless you acting as the CA.
This process will vary with each registrar. If signing locally, the command should look similar to the following line:
openssl x509 -req -in master.csr -CA CA.crt -CAkey CA.key -CAserial ./CA.srl -out master.crt -days 10240

Step 4: Import the newly signed certif icate into the KeyStore
Use the following commands to import the newly signed certificate into the KeyStore:
keytool -keystore amxcert -alias CA -import -file CA.crt -trustcacerts
keytool -keystore amxcert -import -file master.crt -trustcacerts

Step 5: Upload amxcert to the NX as HTTPS KeyStore and reboot the NX

When connecting to HTTPS, the certificate information should reflect the new certificate information.

NX-Series Controllers - WebConsole & Programming Guide 135

 Appendix B: Certificates

Creating & Installing Self-Signed HTTPS KeyStore

A self-signed KeyStore is simply a certificate signed by itself.
Generating a Self-Signed KeyStore
Use the following command to generate a self-signed KeyStore:
keytool -genkey -keyalg RSA -validity 365 -keystore amxcert -keysize 2048 \
-storepass amxcertpassword -keypass amxcertpassword \
-dname CN=hostname,OU=Harman,O=Amx,L=Richardson,S=Tx,C=US
NOTE: The hostname should either be the IP, or the DNS hostname.
NOTE: Keystore, storepass, and keypass are all f ixed values and must not be changed.
Installing a Self-Signed KeyStore
Perform these steps to install a self-signed HTTPS KeyStore:
1. Transfer the certificate to the NX Master and reboot the Master.
2. Navigate to https://hostname. You should see the unknown certificate authority message (FIG. 61).

FIG. 61 Unknown Certificate Authority Message

3. Click Continue to this website.

NX-Series Controllers - WebConsole & Programming Guide 136

 Appendix B: Certificates

4. When the website appears, click the red X in the address bar (FIG. 62). An Untrusted Certificate pop-up message will appear.

Click to access pop-up screen

FIG. 62 Untrusted Certificate pop-up message

5. Click View Certif icates in the pop-up. The certificate information for the self-signed certificate on the NX appears (FIG. 63).

FIG. 63 Certificate dialog

NX-Series Controllers - WebConsole & Programming Guide 137

 Appendix B: Certificates

6. Click Install Certif icate. The Certificate Import Wizard opens. Click Next to access the Certificate Store page (FIG. 64).

FIG. 64 Certificate Import Wizard - Certificate Store

7. Select Place all certif icates in the following store, and click Browse. Select Trusted Root Certif ication Authorities from the
list that appears, and click OK.
8. Click Next, then verify the information is correct before clicking Finish. The certificate is installed.
9. Restart the browser or open a new browser, and navigate to the hostname of the Master. You should see a secure lock symbol
in the address bar (FIG. 65).

Website is secure

FIG. 65 Secure Website

Creating/Updating the Duet TrustStore

The Duet TrustStore is the trusted CA repository for the Duet/Java environment. The default TLS factory in Java references the Duet
TrustStore to verify certificates of remote servers. Additional CAs can be installed to the Duet TrustStore to connect to servers
signed with a private/internal certificate or signed by a CA not trusted by the default JVM installation. The following instructions
describe how to update the Duet TrustStore. Updating the Duet TrustStore requires that a Java JDK/Keytool is installed on the host
system.
The default password for the TrustStore is changeit. You can change the password, but it is not necessary to do so. The primary
reason for making changes to the Duet TrustStore is so you can connect to an RMS server with a self-signed/internal signed
certificate via HTTPS.
Before updating the Duet TrustStore, you must download the Duet TrustStore via the Certificate Manager in NetLinx Studio. See the
NetLinx Studio Instruction Manual or the consult the NetLinx Studio online help for more information.
Using the Keytool, enter the following:
keytool -import -v -trustcacerts -alias myCa -file myCA.crt -keystore cacerts -keypass changeit
cacerts is the name of the Duet TrustStore downloaded from the NX
myCa is a unique alias for the CA
myCA.crt is the certificate for the CA

NX-Series Controllers - WebConsole & Programming Guide 138

 Appendix B: Certificates

Acquiring/Installing Public Certif icates

TLS connections to remote servers may require certificates to be uploaded to the NX Master if certificate validation is used. The
connections also requires accurate date/time information. Perform the following steps to connect to google.com via
TLS_CLIENT_OPEN with certificate validation (This procedure provides instructions for Internet Explorer.)
1. Enter https://www.google.com in the address bar of the web browser.
2. Click the lock on the right hand side of the address bar (FIG. 66).

Click lock

FIG. 66 Click lock in address bar

3. The Website Identification pop-up opens (FIG. 67). Click View Certif icates.

FIG. 67 Website Identification pop-up

4. The Certificate dialog opens. Select the Certif ication Path tab.
5. Perform the following steps for every certificate in the path above the site to which you connected (in this case, Google
Internet Authority G2 and GeoTrust Global CA):
Click View Certif icate.
Select the Details tab.
Click Copy to File.
Click Next.
Select Base-64 encoded X.509 (.cer).
Choose a file name. It should be similar to the subject name of the certificate. In the first case, choose
google.internet.auth.g2.cer.
Click OK.
Repeat for each certificate
Upload each certificate as a Trusted CA.

NX-Series Controllers - WebConsole & Programming Guide 139

 Appendix C: SMTP Support

Appendix C: SMTP Support

Overview
NetLinx Integrated Controllers (Masters) have built-in support for transmission or email via an SMTP server. NetLinx Master
support includes the configuration of a single outbound SMTP server and the subsequent transmission of individual emails via the
configured server.
NOTE: When using Google Gmail, you may receive an authentication error when generating outbound emails over SMTP from an NX
Master. If you receive this error, turn on "Access for less secure apps" on your Google account (found under My Account). If this
option is turned off, you may receive the authentication error.

SMTP Server Conf iguration

The SMTP Server is configured by specifying a set of server properties. SMTP server properties once set are persistent on the
master until they are reset to a different value. SMTP server properties include the server IP address or URL, the SMTP IP port
number for connecting to the server, any username and password that is required for connecting with the server, the "from"
address that will be associated with all outgoing messages and finally a flag indicating if the server must support TLS
authentication security in order to establish a connection. Properties are set and read using two built-in NetLinx functions:
SMTP_SERVER_CONFIG_SET(CONSTANT CHAR cfgName[], CONSTANT CHAR cfgValue[])
Sets a server configuration parameter. These configuration settings are general mail server settings and thus apply to all
emails. Settings are saved to the configuration database & thus are static upon reboot.
cfgName is the server property name that is being set. Acceptable values are
ADDRESS - SMTP server name, such as "mail.amx.com". The maximum number of characters allowed for email destination
is 127.
PORT - SMTP server port, such as "25" or "0". 0 means "use the best default port" which would imply using 25 which is the
SMTP well-known port.
USERNAME - User name to offer for authentication. If user name length is set to 0, authentication is not attempted.
PASSWORD - Password to offer for authentication. If password length is set to 0, authentication is still attempted but simply
uses a zero-length password.
FROM - Mail address to populate to the 'Mail-From:' field in outgoing emails.
REQUIRE_TLS - SMTP server must support TLS in order to establish a connection. Valid values are 'TRUE' or 'FALSE'
cfgValue is the value to associate for a setting property.
char[] SMTP_SERVER_CONFIG_GET (CONSTANT CHAR cfgName[])
Queries a server configuration property. Returns the config property value.
cfgName is the server property name that is being retrieved. Acceptable values are a subset of the settable properties
(username & password query are disabled as a security precaution). No return value
ADDRESS - SMTP server name, such as "mail.amx.com". The maximum number of characters allowed for email destination
is 127.
PORT - SMTP server port, such as "25" or "0". 0 means "use the best default port" which would imply using 25 which is the
SMTP well-known port.
FROM - Mail address populated to the 'Mail-From:' field in outgoing emails.
REQUIRE_TLS - SMTP server must support TLS in order to establish a connection. Valid values are 'TRUE' or 'FALSE'
The NetLinx .axi file has the following built in constants to ease configuration:
CHAR SMTP_ADDRESS[] = 'ADDRESS';
CHAR SMTP_PORT_NUMBER[] = 'PORT';
CHAR SMTP_USERNAME[] = 'USERNAME';
CHAR SMTP_PASSWORD[] = 'PASSWORD';
CHAR SMTP_REQUIRE_TLS[] = 'REQUIRE_TLS';
CHAR SMTP_FROM[] = 'FROM';
CHAR NULL_STR[] = '';
CHAR SMTP_TLS_TRUE[] = 'TRUE';
CHAR SMTP_TLS_FALSE[] = 'FALSE';
Example server configuration:
SMTP_SERVER_CONFIG_SET(SMTP_ADDRESS,'mail.mymailserver.com')
SMTP_SERVER_CONFIG_SET(SMTP_PORT_NUMBER,'25')
SMTP_SERVER_CONFIG_SET(SMTP_USERNAME,'myAccountUsername')
SMTP_SERVER_CONFIG_SET(SMTP_PASSWORD,'myAccountPassword')
SMTP_SERVER_CONFIG_SET(SMTP_REQUIRE_TLS, SMTP_TLS_TRUE)
SMTP_SERVER_CONFIG_SET(SMTP_FROM,'John Doe')

NX-Series Controllers - WebConsole & Programming Guide 140

 Appendix C: SMTP Support

Sending Mail
Sending mail is accomplished with the use of the Master's built-in Mail Service. An outbound mail is handed to the Mail Service via
the following built-in NetLinx function:
sinteger SMTP_SEND (DEV responseDPS, CONSTANT CHAR toAddress[], CONSTANT CHAR mailSubject[], CONSTANT
CHAR mailBody[], CONSTANT CHAR textAttachment[])
where:
responseDPS - The DPS address to return asynchronous send status. Ex. 0:3:0
toAddress - The email address of destination. Ex. john.doe@amx.com.
Note that the NetLinx mail service supports up to eight recipient address (semi-colon delimited). These are "To"
addresses only (not "Cc" or "Bcc" addresses.)
The maximum number of characters allowed for email destination is 127.
mailSubject - The email subject line.
mailBody - The email body text.
textAttachment - A text filename to attach to the email (optional argument). Filenames must be 256 characters or less,
and file size must be under 65536 bytes. When no attachment is included textAttachment should be set to NULL_STR.
SMTP_SEND returns a signed integer.
If the return value is negative (<0) that is an indication there was a failure in handing the message off to the mail service,
most likely due to an invalid argument supplied to the SMTP_SEND call.
If the return value is positive (>0) then the value is the index associated with the mail being sent.
Mail sends are asynchronous to the normal processing of the NetLinx application.
When SMTP_SEND is called and the mail is posted to the internal Mail Service, the NetLinx application will continue
executing the code following the SMTP_SEND.
The failed send status will be returned via an ONERROR DATA_EVENT for the responseDPS specified in the SMTP_SEND call
with DATA.NUMBER set to the error code and DATA.TEXT set to the mail identifier returned from the SMTP_SEND call.
Example SMTP_SEND:
DEFINE_DEVICE
MAIL_SERVICE=0:3:0

DEFINE_VARIABLE
SINTEGER MAIL_IDX

…
MAIL_IDX = SMTP_SEND(MAIL_SERVICE,'jdoe@somemail.com','Mail Subj','Mail Body', NULL_STR)
IF (MAIL_IDX < 0)
{
// FAILED TO SEND MAIL
}
…
DATA_EVEN [MAIL_SERVICE]
{
ONERROR:
{
// AN ERROR OCCURRED
LOG_ERROR("MAIL SEND FAILURE - IDX=',DATA.TEXT,' ERROR=',ITOA(DATA.NUMBER))
}
}
The possible error codes are:
MALFORMED DATA = 1;
NOT ENOUGH MEMORY = 2;
SERVER UNREACHABLE = 3;
AUTHENTICATION FAILURE = 4;
SMTP PROTOCOL ERROR = 5;

NX-Series Controllers - WebConsole & Programming Guide 141

 Appendix D: Clock Manager NetLinx Programming API

Appendix D: Clock Manager NetLinx Programming

API
Types/Constants
The NetLinx.axi file that ships with NetLinx Studio includes the following types/constants:
(*-----------------------------------------------------------------------------*)
(* Added v1.28, Clock Manager Time Offset Structure *)
(*-----------------------------------------------------------------------------*)
STRUCTURE CLKMGR_TIMEOFFSET_STRUCT
{
INTEGER HOURS;
INTEGER MINUTES;
INTEGER SECONDS;
}

(*-----------------------------------------------------------------------------*)
(* Added v1.28, Clock Manager Time Server Entry Structure *)
(*-----------------------------------------------------------------------------*)
STRUCTURE CLKMGR_TIMESERVER_STRUCT
{
CHAR IS_SELECTED; (* TRUE/FALSE *)
CHAR IS_USER_DEFINED; (* TRUE/FALSE *)
CHAR IP_ADDRESS_STRING[48]; (* Allow enough room for IPv6 in the future *)
CHAR URL_STRING[32]; (* Example: time.organization.net *)
CHAR LOCATION_STRING[32]; (* Example: Boulder, Colorado, US *)
}

(* Added v1.28, Clock Manager *)

INTEGER CLKMGR_MODE_NETWORK = $01; (* Used to enable Clock Manager Functionality *)
INTEGER CLKMGR_MODE_STANDALONE = $02; (* Use a free-running clock - legacy behavior.*)

Library Calls
The NetLinx.axi file that ships with NetLinx Studio includes the following Clock Manager-specific library calls:
NetLinx.axi - Library Calls
CLKMGR_IS_NETWORK_SOURCED() Returns FALSE/0 or TRUE/1 (default = FALSE/0)
CLKMGR_SET_CLK_SOURCE Can be set to CLKMGR_MODE_NETWORK or CLK-MGR_MODE_STANDALONE.
(CONSTANT INTEGER MODE)
CLKMGR_IS_DAYLIGHTSAVINGS_ON() Returns FALSE/0 or TRUE/1 (default = FALSE/0).
CLKMGR_SET_DAYLIGHTSAVINGS_MODE Can be set to ON/TRUE or OFF/FALSE.
(CONSTANT INTEGER ONOFF)
CLKMGR_GET_TIMEZONE() Returns Timezone as a string in the format: UTC[+|-]HH:MM
CLKMGR_SET_TIMEZONE Input string must have the correct format: UTC[+|-]HH:MM
(CONSTANT CHAR TIMEZONE[])
CLKMGR_GET_RESYNC_PERIOD() Returns the Clock Manager's re-sync period in minutes (default = 60). This
setting has no effect if the Clock Manager mode is set to STANDALONE.
CLKMGR_SET_RESYNC_PERIOD Sets the re-sync period to the specified minute value. The upper bound is 480
(CONSTANT INTEGER PERIOD) minutes (i.e., 8 hours).
CLKMGR_GET_DAYLIGHTSAVINGS_OFFSET Populates the TIMEOFFSET structure with the current Daylight Savings Offset
(CLKMGR_TIMEOFFSET_STRUCT T) configured. The function returns a negative SLONG value if it encounters an
error.
CLKMGR_SET_DAYLIGHTSAVINGS_OFFSET Sets the Daylight Savings Offset to the specified value.
(CONSTANT CLKMGR_TIMEOFFSET_STRUCT T)
CLKMGR_GET_ACTIVE_TIMESERVER Populates the TIMESERVER structure with the currently active time server's
(CLKMGR_TIMESERVER_STRUCT T) data. The function returns a negative SLONG value if it encounters an error.
CLKMGR_SET_ACTIVE_TIMESERVER Sets the time server entry that has the matching IP-ADDRESS to the IP
(CONSTANT CHAR IP[]) parameter as the active time server entry.

NX-Series Controllers - WebConsole & Programming Guide 142

 Appendix D: Clock Manager NetLinx Programming API

NetLinx.axi - Library Calls (Cont.)

CLKMGR_GET_TIMESERVERS Populates the currently configured time server entries from the Clock
(CLKMGR_TIMESERVER_STRUCT T[]) Manager into the specified TIMESERVER array.
The function returns a negative SLONG value if it encounters an error,
otherwise the return value is set to the number of records populated into the
CLK-MGR_-TIMESERVER_STRUCT array.
CLKMGR_ADD_USERDEFINED_TIMESERVER Adds a user-defined time server entry.
(CONSTANT CHAR IP[], CONSTANT CHAR URL[],
CONSTANT CHAR LOCATION[])
CLKMGR_DELETE_USERDEFINED_ Deletes the user-defined entry that has its IP-ADDRESS matching the
TIMESERVER(CONSTANT CHAR IP[]) parameter.
CLKMGR_GET_START_ Gets a string representation of when Daylight Savings is supposed to START.
DAYLIGHTSAVINGS_RULE() The Fixed-Date rules have the form:
"fixed:DAY,MONTH,HH:MM:SS"
with all fields as numeric except for the word "fixed".
The Occurrence-Of-Day rules have the form:
"occurence:OCCURENCE,DAY-OF-WEEK,MONTH,HH:MM:SS"
with all fields as numeric except for the word "occurence".
• OCCURANCE range = 1-5
’5’ indicates the 'LAST' occurrence of a particular day of the month.
• DAY-OF-WEEK translates as:
1=Sunday
2=Monday
3=Tuesday
4=Wednsday
5=Thursday
6=Friday
7=Saturday
Examples:
"fixed:5,10,16:00:00" = October 5, at 4:00PM).
"occurence:5,1,10,02:00:00" = last Sunday in October, at 2:00AM).
CLKMGR_SET_START_DAYLIGHTSAVINGS_RULE Sets the START Daylight Savings rule to the specified string which must be in
(CONSTANT CHAR RECORD[]) either the Fixed-Date format or the Occurence-Of-Day format. The function
returns a negative SLONG value if it encounters an error.
The Fixed-Date rules have the form:
"fixed:DAY,MONTH,HH:MM:SS"
with all fields as numeric except for the word "fixed".
The Occurrence-Of-Day rules have the form:
"occurence:OCCURENCE,DAY-OF-WEEK,MONTH,HH:MM:SS"
with all fields as numeric except for the word "occurence".
• OCCURANCE range = 1-5
’5’ indicates the 'LAST' occurrence of a particular day of the month.
• DAY-OF-WEEK translates as:
1=Sunday
2=Monday
3=Tuesday
4=Wednsday
5=Thursday
6=Friday
7=Saturday
Examples:
"fixed:5,10,16:00:00" = October 5, at 4:00PM).
"occurence:5,1,10,02:00:00" = last Sunday in October, at 2:00AM).

NX-Series Controllers - WebConsole & Programming Guide 143

 Appendix D: Clock Manager NetLinx Programming API

NetLinx.axi - Library Calls (Cont.)

CLKMGR_GET_END_DAYLIGHTSAVINGS_RULE() Gets a string representation of when Daylight Savings is supposed to END.
The Fixed-Date rules have the form:
"fixed:DAY,MONTH,HH:MM:SS"
with all fields as numeric except for the word "fixed".
The Occurrence-Of-Day rules have the form:
"occurence:OCCURENCE,DAY-OF-WEEK,MONTH,HH:MM:SS"
with all fields as numeric except for the word "occurence".
• OCCURANCE range = 1-5
’5’ indicates the 'LAST' occurrence of a particular day of the month.
• DAY-OF-WEEK translates as:
1=Sunday
2=Monday
3=Tuesday
4=Wednsday
5=Thursday
6=Friday
7=Saturday
Examples:
"fixed:5,10,16:00:00" = October 5, at 4:00PM).
"occurence:5,1,10,02:00:00" = last Sunday in October, at 2:00AM).
CLKMGR_SET_END_DAYLIGHTSAVINGS_RULE Sets the END Daylight Savings rule to the specified string which MUST be in
(CONSTANT CHAR RECORD[]) either the Fixed-Date format or the Occurence-Of-Day format. The function
returns a negative SLONG value if it encounters an error.
The Fixed-Date rules have the form:
"fixed:DAY,MONTH,HH:MM:SS"
with all fields as numeric except for the word "fixed".
The Occurrence-Of-Day rules have the form:
"occurence:OCCURENCE,DAY-OF-WEEK,MONTH,HH:MM:SS"
with all fields as numeric except for the word "occurence".
• OCCURANCE range = 1-5
’5’ indicates the 'LAST' occurrence of a particular day of the month.
• DAY-OF-WEEK translates as:
1=Sunday
2=Monday
3=Tuesday
4=Wednsday
5=Thursday
6=Friday
7=Saturday
Examples:
"fixed:5,10,16:00:00" = October 5, at 4:00PM).
"occurence:5,1,10,02:00:00" = last Sunday in October, at 2:00AM).

NX-Series Controllers - WebConsole & Programming Guide 144

© 2017 Harman. All rights reserved. NetLinx, Enova, Axcess, Modero, AV FOR AN IT WORLD, and HARMAN, and their respective logos are registered Last Revised:
trademarks of HARMAN. Oracle, Java and any other company or brand name referenced may be trademarks/registered trademarks of their respective
companies. 9/27/2017
AMX does not assume responsibility for errors or omissions. AMX also reserves the right to alter specifications without prior notice at any time.
The AMX Warranty and Return Policy and related documents can be viewed/downloaded at www.amx.com.
3000 RESEARCH DRIVE, RICHARDSON, TX 75082 AMX.com | 800.222.0193 | 469.624.8000 | +1.469.624.7400 | fax 469.624.7153
AMX (UK) LTD, AMX by HARMAN - Unit C, Auster Road, Clifton Moor, York, YO30 4GD United Kingdom • +44 1904-343-100 • www.amx.com/eu/