AMX Enova DGX 8, Instruction Manual

Page: 235 / 243

Appendix H – DGX_SHELL Commands
235 Instruction Manual – Enova DGX 8/16/32/64 Digital Media Switchers
Appendix H – DGX_SHELL Commands
Overview DGX_SHELL Commands
The Enova DGX Switcher supports a number of shell (command-line interpreter) commands for a variety of functions,
both basic and advanced.
General Rules and Information for DGX_SHELL Commands

DGX_SHELL commands are case sensitive.

All commands in the DGX_SHELL require an Enter to execute.

To exit a standard terminal interface (used for BCS commands) and enter the DGX_SHELL, press
CTRL+C.

To exit the DGX_SHELL and return to the standard terminal interface, type
bcs
and press Enter.

The DGX_SHELL will timeout automatically; BCS resumes. The length of time can be set using a
set
command (see page 241). The value zero (0) allows for an infinite timeout.

Enter
help
or
?
to display a list of the commands supported in the DGX_SHELL.

Enter
help <command>
for detailed usage and options on a specific command.

Enter
help -v
to display all commands and descriptions.
Although the Help file lists all of the DGX_SHELL commands available for the Enova DGX Switcher, only information
on the basic commands (those most useful during installation and setup) are provided in this appendix. The remaining
commands (which are also listed in the Help file) are used mainly by technical support for troubleshooting. For
additional information on any of the advanced commands, contact www.amx.com/techsupport.
To enter the DGX_SHELL from a terminal emulation program:
1.
Use a null modem serial cable to connect a PC to the Control port (RS-232 serial) on the Enova DGX enclosure.
2.
Open a terminal emulation program on the PC (e.g., use the Terminal* view in DGX Configuration Software, which
is available for download at www.amx.com).
Set the COM port settings to match the default ones for the Enova DGX Switcher:

Baud rate – 9600

Data bits – 8

Parity – 1

Stop bits – none

Flow control – 1
3.
Press CTRL+C to exit the terminal emulation program and enter the DGX shell.
4.
At the prompt (
DGX_SHELL>
), type the command and press Enter.
* If you use DGX Configuration Software, you must click the Connect button to establish serial communication with the
system before you can use the terminal. When done, be sure to click the Disconnect button.
Caution: Incorrect use of advanced DGX_SHELL commands has the potential to alter the operation of the
system. We recommend that advanced commands only be entered in conjunction with instructions from
technical support.