EasyManua.ls Logo

AMX NX-3200 User Manual

AMX NX-3200
145 pages
To Next Page IconTo Next Page
To Next Page IconTo Next Page
To Previous Page IconTo Previous Page
To Previous Page IconTo Previous Page
Page #14 background imageLoading...
Page #14 background image
Overview
14
NX-Series Controllers - WebConsole & Programming Guide
Enova DGX Digital Media Switchers
NOTE: Refer to the Products > Digital Media Switchers page at www.amx.com for details and variations available for these products.
Massio
ControlPads
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 Configuration 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
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
Massio ControlPads
Name Description
MCP-106 6-Button Massio ControlPad
MCP-108 8-Button Massio ControlPad

Table of Contents

Other manuals for AMX NX-3200

Question and Answer IconNeed help?

Do you have a question about the AMX NX-3200 and is the answer not in the manual?

AMX NX-3200 Specifications

General IconGeneral
ModelNX-3200
TypeController
Operating SystemLinux
USB Ports2 x USB 2.0
Power Supply100-240 VAC, 50-60 Hz
MasterYes
CPUDual-core ARM Cortex-A9
ProcessorDual Core Processor
Memory2 GB
Storage4 GB
Flash Storage4GB eMMC
Ethernet2x 10/100/1000
HDMI Output1
Audio Output1 (3.5mm)
IR Ports4
RS-232/422/485 Ports4
Serial Ports4
Relay Ports4
GPIO Ports8

Summary

Overview of NX Controllers and Related Products

NetLinx NX Integrated Controllers

Masters for controlling RS-232/422/485, Relay, IR/Serial, and Input/Output devices via NetLinx Studio.

Enova DVX All-in-One Presentation Switchers

Presentation switchers with NX Control for Multi-Format, HDMI, and DXLink inputs.

Enova DGX Digital Media Switchers

Digital Media Switchers.

Massio ControlPads

B-Button ControlPads.

About This Document

Describes WebConsole, NetLinx commands, and terminal communications for NX controllers.

Differences in DEFINE_PROGRAM Program Execution

Explains performance impacts of DEFINE_PROGRAM on NX controllers and recommends alternatives.

CPU Usage Diagnostics

Details diagnostics for determining and diagnosing CPU overload on NX masters.

Quick Setup and Configuration Overview

Installation Procedures

General steps for installing the device, including unpacking and connecting.

Configuration and Communication

Steps for initial communication and setup with the NX controller's on-board Master.

Firmware Updates

Procedure to update NetLinx Studio and controller firmware via IP address.

Configure NetLinx Security

Setup and finalization of NetLinx Security Protocols and programming the NX controller.

Using Zero Configuration

Utilizing zero-configuration clients for quick installation and configuration of multiple devices.

Connecting to a DHCP Network

Installing and configuring devices on a network without pre-configuring each device.

Initial Configuration

Preparing for USB Communication

Steps to establish USB communication with the Master via the PROGRAM port.

Configuring for LAN Communication

Connecting the Controller to the LAN and configuring network addresses via NetLinx Studio.

Obtaining IP Address via DHCP

Procedure to obtain the NX controller's IP address using DHCP.

Assigning a Static IP Address

Steps to assign a static IP address to the NX Controller.

Communicating via IP Address

Establishing communication with the Master using the obtained IP address.

Upgrading Firmware

NX Controllers Firmware Files

Details on firmware files required for NX controllers (Master and Device Controller).

Enova DVX Firmware

Firmware requirements for Enova DVX Presentation Switchers (Master, Device, Switcher).

Required Order of Firmware Updates

Specifies the correct order for upgrading firmware files for NX and DVX controllers.

Upgrading Firmware via USB

Instructions for upgrading firmware using a USB solid-state drive.

Upgrading Firmware via NetLinx Studio

Procedure for transferring firmware files to the controller using NetLinx Studio.

Resetting to Factory Defaults

Procedure to reset the Master controller to its factory default state.

On-Board WebConsole User Interface

WebConsole UI Overview

Overview of the System Configuration interface and its five primary sections.

System Configuration Menu Options

Details on the five main sections: Home, Network, Security, System, and Modules.

System Configuration Interface Tips

Tips for using the WebConsole interface, including browser compatibility and input/output selection.

Accessing the WebConsole

Steps to access the WebConsole via a web browser by entering the Master's IP address.

Default User Names and Passwords

Lists default user names and passwords for NetLinx Studio and the WebConsole.

WebConsole - Network Options

Network Overview

Overview of the Network page for configuring Master's network settings.

Network - IPv4 Setup

Options to view/change the Master's IPv4 and DNS address information.

Network - IPv6 Setup

View IPv6 address, subnet mask, and gateway for the Master.

Network - Date/Time

Configure network time source, Daylight Saving rules, and NIST servers.

WebConsole - Security Options

Security Overview

Overview of Master's security settings at System, Role, and User levels.

Login Rules

Rules for concurrent logins and initial user authentication.

User and Role Name Rules

Rules for creating user and role names, including character limits and allowed characters.

Password Rules

Defines password complexity requirements based on Low, Medium, and High settings.

Security - General Settings

Global security settings affecting all users, including presets and system security options.

Security Presets

Describes the Low, Medium, and High security preset levels and their settings.

Security - Roles Management

Default Roles

Default accounts, access rights, and security options created by the NetLinx Master.

Role Permissions

Lists available permissions that can be assigned to roles.

Adding a New Role

Steps to create a new role by assigning a name and security access rights.

Viewing and Modifying Role Settings

How to view and modify security settings for selected roles.

Deleting a Role

Procedure to remove a role and its associated settings.

Locking/Disabling a Role

How to lock and disable a role, preventing its assignment to users.

Security - User Management

Default User Accounts

Lists default administrator and netlinx user accounts and their properties.

Adding a New User

Steps to add a new user, define its name, assign roles, and set password.

Viewing and Editing User Settings

How to view and edit security settings for selected users.

Deleting a User

Procedure to remove a user account and its associated settings.

Locking/Disabling a User

How to lock and disable a user account.

Security Settings - LDAP

LDAP Options

Configuration parameters for remote directory service connection via LDAPv3.

Accepting Changes and Testing Connection

How to save changes and test the LDAP server connection.

Wired 802.1X Support

Information on IEEE 802.1X for network access control using X.509 certificates.

Security - Profile Management

Changing a User’s Password

Procedure for a user to change their password according to defined rules.

WebConsole - System Options

System Overview

Overview of the System page for viewing and configuring NetLinx System aspects.

System Information

View detailed Master properties: Model ID, serial number, network addresses, firmware versions.

System Devices

View information about the Master and connected devices, including system and device numbers.

Changing System Number

Procedure to change the Master's system number.

Changing Device Number

Procedure to change the device number for attached devices.

Resetting to Factory Defaults

Reset the Master controller to its factory default state.

WebConsole - Modules Options

Modules Overview

Overview of the Modules page for viewing and configuring system devices and modules.

Modules - Device Options

Details specific to additional (non-NetLinx) System Devices.

Configuring Device Binding Options

Specify how the Master manages Bound Devices.

Managing Device Driver Modules

Options to upload, archive, or delete modules from the Master.

Modules - Bindings

Configure application-defined Duet virtual devices with discovered physical devices.

Modules - User-Defined Devices

List and manage dynamic devices discovered in the system.

Modules - Active Devices

Check devices for compatible Duet Modules.

WebConsole - Switching Options

Switching Overview

Overview of the Switching page for routing inputs to outputs during system setup.

Color-coded Switch Selection

Explanation of color-coded buttons indicating selected and routed switches.

Switching Page Components

Description of components on the Switching page, labeled alphabetically.

Switch Mode Selection

Choose between switching Audio follow Video (A/V), Video, or Audio only.

Configuring Downmix Signal

How to downmix and route one embedded audio signal at a time.

Designating Downmix Input

Designate a source for the Downmix Input using the Configuration page.

Configuration Page

Configuration Components

Instantaneous changes in Configuration page reflect attached devices.

Video Settings

Video settings display when Switch Mode is A/V or Video, and Video tab is selected.

Output Settings

General settings for outputs, including scaling, resolution, and aspect ratio.

DXLink Video Settings

DXLink specific video settings for transmitters and receivers.

DXLink Transmitter Settings

Settings for DXLink transmitters, including Video Priority and AV Source.

DXLink Receiver Settings

Settings for DXLink receivers, including Active Output and DXLink Details.

Audio Settings

Audio Input Settings

General audio settings for inputs, including gain, encoding, EDID mode, and compression.

Audio Output Settings

General audio settings for outputs, including encoding, output format, test tone, and levels.

DXLink Audio Settings

DXLink Transmitter Audio Settings

DXLink audio settings for transmitters: Audio Priority, Source, and Details.

EDID Configuration

Setting EDID for an Input

Procedure to set EDID for inputs, including mode, preferred EDID, and saving.

Setting EDID for an Output

Procedure to set EDID for outputs, including resolution and saving.

Setting EDID Mode for Audio Input

Setting the EDID mode for audio inputs, including Basic, PCM, Dolby, and DTS options.

Loading and Saving EDIDs

Loading custom EDIDs from a file and saving altered EDID files.

Status Page

System Configuration Interface Tips

Tips for network connection, auto-setup, and audio routing.

NetLinx Programming

Overview of NetLinx Programming

Describes Send_Commands, Send_Strings, and Channel commands for Master programming.

Port Assignments by NetLinx Master

Lists port assignments for NetLinx Masters.

Port Assignments for Enova Switchers

Lists port assignments for Enova All-in-One Presentation Switchers.

Port Assignments for Massio ControlPads

Lists port assignments for Massio ControlPads.

Serial, IR, AxLink, and PoE Port Diagnostics

Serial, IR, AxLink, and PoE Port Diagnostics

Detects and reports fault conditions on serial, IR, AxLink, and PoE ports.

Master SEND_COMMANDs

CLOCK Command

Command to set the date and time on the Master.

G4WC Command

Add G4 Web Control devices to the Web control list.

IGNOREEXTERNALCLOCKCOMMANDS

Prevent setting the Master's time via external CLOCK commands.

Master IP Local Port SEND_COMMANDs

UDPSENDTO Command

Set IP and port for UDP local ports destination for sending future packets.

SSH SEND_COMMANDs

SSH_CLIENT_CLOSE

Closes an open SSH communication port with a server.

SSH_CLIENT_OPEN

Opens a port for SSH communication with a server.

LED SEND_COMMANDs

LED-DIS Command

Disables all LEDs for a port.

LED-EN Command

Enables LEDs for a port.

RS232/422/485 SEND_COMMANDs

RS232/422/485 Command Reference

Commands for configuring RS-232/422/485 ports, including baud rate and fault detection.

RS232/422/485 SEND_STRING Escape Sequences

Special SEND_STRING escape sequences for RS-232/422/485.

IR/Serial SEND_COMMANDs

IR/Serial Command Reference

Commands for generating control signals for external equipment via IR/Serial.

IR Port Channels

Channels for IR commands and push/release signals.

Input/Output SEND_COMMANDs

I/O Command Reference

Commands to program I/O ports on the Integrated Controller.

PoE SEND_COMMANDs

PoE Command Reference

Commands to program the ICSLAN ports with Power-over-Ethernet (PoE) functionality.

AxLink SEND_COMMANDs

AxLink Command Reference

Commands to program the AxLink ports on the NX controller.

Audit Log SEND_COMMANDs

LOG Command

Send audit logs to the Master for output via Syslog.

Authentication Library Calls

TLS Client Calls

Authentication-specific library calls for NetLinx.axi.

TLS_CLIENT_CLOSE

Closes an open TLS communication port with a remote device.

TLS_CLIENT_OPEN

Opens a port for TLS communication with a remote device.

NetLinx Library Calls

VALIDATE_NETLINX_ACCOUNT

Validates user name and password against NetLinx Master's internal database.

VALIDATE_NETLINX_ACCOUNT_WITH_PERMISSION

Validates user credentials and checks for authorization and permission types.

Terminal (Program Port/Telnet) Commands

Terminal Communications Overview

Overview of terminal communications via Program Port and Telnet.

Establishing Terminal Connection via Program Port

Steps to establish a terminal session via the Program Port.

Establishing Terminal Connection via Telnet

Steps to establish a terminal session via Telnet.

Terminal Commands Reference

General Terminal Commands

Basic commands for terminal interaction, including help and status checks.

System Diagnostics Commands

Commands for monitoring CPU usage and disk space.

Terminal Commands (Continued)

Network Configuration & Export/Import

Commands for DNS, 802.1x, exporting/importing configurations via USB.

System Status Commands

Commands for checking FIPS mode and audit log status.

Terminal Commands (Continued)

Device Information and Security Commands

Commands for retrieving device info, IP settings, and managing ICSP monitoring.

Terminal Commands (Continued)

File and System Management Commands

Commands for managing token files, IP status, Java security, logs, and firmware.

Terminal Commands (Continued)

Message and Log Control Commands

Commands for controlling diagnostic messages, log levels, and NDP settings.

Device Channel Control Commands

Commands to turn specified channels on or off for a device.

Terminal Commands (Continued)

Device Communication and Program Control Commands

Commands for pass-through mode, pinging, program control, and rebooting.

Terminal Commands (Continued)

System Configuration and Command Sending

Commands for resetting factory defaults, route modes, and sending commands.

Date and Device Settings Commands

Commands for setting the date and rebooting devices.

Terminal Commands (Continued)

Network Settings Commands

Commands for setting DNS, Duet memory, FTP, HTTP, and HTTPS ports.

Terminal Commands (Continued)

ICSLAN, ICSP, and IP Settings Commands

Commands for configuring ICSLAN, ICSP ports, TCP timeouts, IP settings, and lockouts.

Terminal Commands (Continued)

Log, Notification, and Security Settings Commands

Commands for log count, notification throttle, OCSP URL, and security certificates.

Terminal Commands (Continued)

System and Network Settings Commands

Commands for setting system number, Telnet port, thresholds, time, and UDP broadcast rate.

Terminal Commands (Continued)

URL and Audit Log Commands

Commands for managing URLs, audit logs, and buffer status.

Buffer and Combine Status Commands

Commands to view buffer counts and combined device information.

Terminal Commands (Continued)

Device, Connection, and System Status Commands

Commands for showing device status, logs, startup logs, and Zeroconf.

Terminal Commands (Continued)

Buffer and System Information Commands

Commands for showing max buffers, memory usage, and remote device lists.

Terminal Commands (Continued)

System Information Commands

Commands for showing system details, TCP connections, and URL lists.

ESC Pass Codes

Escape Pass Codes

Defines escape codes for switching display mode or exiting pass mode.

Using the ICSLAN Network

Information on the default IP address and subnet mask for ICSLAN network.

DHCP Server Configuration

Information on the built-in DHCP server for the ICSLAN port.

Opening LAN and ICSLAN Sockets from Code

Opening sockets from NetLinx or Java code.

Accessing Security Configuration Options

Setup Security Menu

Lists the options available in the Setup Security menu.

Security Options Menu

Menu for setting system security options for NetLinx Master.

Telnet Diagnostics Commands

Physical Status Command

Reports current state of Master's Status, Output, and Input LEDs.

Message Statistics Command

Collects message statistics for the Interpreter over a 10-second period.

Logging Out of a Terminal Session

Importance of executing the 'logout' command before disconnecting.

Telnet Client Notes

States known anomalies for Windows and Linux Telnet/Terminal clients.

Appendix A: LDAP Implementation Details

Overview of LDAP Implementation

Verifying credentials and obtaining user authorization via LDAP.

Changes to LDAP Implementation (v1.4.x)

Changes to LDAP configuration when upgrading firmware to 1.4.x or higher.

Active Directory/OpenLDAP Setup

Setup for Active Directory and OpenLDAP, including posixAccount usage.

Changes to LDAP Implementation (v1.5.x)

Changes to LDAP configuration when upgrading firmware to 1.5.x or higher.

User Query Attribute

Attribute used for User Query, typically 'cn' or 'sAMAccountName'.

FTP Access with LDAP Authentication

Requirements for FTP access with LDAP authentication.

SSH Access with LDAP Authentication

Requirements for SSH access with LDAP authentication.

Assumptions and Prerequisites for LDAP

Assumptions made about the LDAP implementation or environment.

Appendix B: Certificates

Overview of Certificates

Importance of private key protection and certificates supported by NX Masters.

Supported Certificates

Lists certificate types (Trusted CA, CRL, Device, SSH, 802.1x) and their functions.

Certificate Information

Locations and file names for certificate-related files and signing request information.

Creating an HTTPS KeyStore

Steps to Create an HTTPS KeyStore

Required steps to create an HTTPS KeyStore using Java Keytool.

Creating & Installing Self-Signed HTTPS KeyStore

Generating a Self-Signed KeyStore

Command to generate a self-signed KeyStore.

Installing a Self-Signed KeyStore

Steps to install a self-signed HTTPS KeyStore on the NX Master.

Creating/Updating the Duet TrustStore

Duet TrustStore Management

Instructions for updating the Duet TrustStore using Java JDK/Keytool.

Acquiring/Installing Public Certificates

Acquiring and Installing Public Certificates

Steps to connect to google.com via TLS_CLIENT_OPEN with certificate validation.

Appendix C: SMTP Support

Overview of SMTP Support

Built-in support for transmission or email via an SMTP server.

SMTP Server Configuration

Configuring the SMTP Server by specifying server properties.

Sending Mail via SMTP

Sending Mail Procedure

Accomplished using the Master's built-in Mail Service via SMTP_SEND function.

Appendix D: Clock Manager NetLinx Programming API

Clock Manager Types and Constants

NetLinx.axi file includes Clock Manager types/constants.

Clock Manager Library Calls

NetLinx.axi file includes Clock Manager-specific library calls.

NetLinx Library Calls (Clock Manager)

CLKMGR_GET_TIMESERVERS

Populates time server entries into a TIMESERVER array.

CLKMGR_ADD_USERDEFINED_TIMESERVER

Adds a user-defined time server entry.

CLKMGR_DELETE_USERDEFINED_TIMESERVER

Deletes user-defined entry matching the IP-ADDRESS.

CLKMGR_GET_START_DAYLIGHTSAVINGS_RULE

Gets string representation of when Daylight Savings starts.

CLKMGR_SET_START_DAYLIGHTSAVINGS_RULE

Sets the START Daylight Savings rule.

NetLinx Library Calls (Clock Manager Continued)

CLKMGR_GET_END_DAYLIGHTSAVINGS_RULE

Gets string representation of when Daylight Savings ends.

CLKMGR_SET_END_DAYLIGHTSAVINGS_RULE

Sets the END Daylight Savings rule.

Related product manuals