Brick-HD Videowall Command Shell


INDEX

Home

Command Shell

Flash Volumes

Boot Process

Telnet Access

Shell Scripts

Shell Command Reference


Command Shell

 

The Brick-HD supports a simple line based command shell. This allows the video wall application to be controlled and low level system administration to be performed using a terminal emulation package. The terminal emulator can be connected either via the host serial port or via Telnet.

 

A PC application is supplied with the Brick-HD that provides a graphical user interface to control the Brick-HD. This provides all of the normal control requirements without the need to use the command shell.  Access to the shell is normally only necessary to diagnose problems and recover from corrupted or inadvertently deleted system files.

 

Microsoft Windows up to and including Windows XP has a built in terminal emulation application called hyperterm (hypertm.exe). This was dropped from later versions of Windows. However there are a number of very good (if not better) freeware applications available as a replacement, such as putty (www.putty.org).

 

The hyperterm  .exe and it's .dll file can be copied to later versions of Windows from a machine running Windows XP if required for those more familiar with hyperterm. The terminal emulation should be configured for 19200 bit/s, 8 data bits, 1 stop bit, no parity to connect serially. There is no hardware or software flow control. The emulation should be set to a VT100 compatible mode and ideally support 132 columns.

 

The serial connection is multiplexed with the serial MTCP (Media Technologies Control Protocol) messages. MTCP messages are framed by SOM (Start of Message = 0x7E =  '~') and EOM characters (End of Message = 0x7C = ']'). The message handler is aware of the terminal escape sequences, so if an MTCP framing  character is used as part of a terminal escape sequence (e.g. an Up/Down/Left/Right cursor key) this will not be interpreted as framing character.

 

If a native ‘~’ character is sent from a terminal emulation it will be interpreted as a SOM and all characters typed subsequently apparently ignored.  Eventually the message buffer will overflow and normal command line mode will resume.  To recover quicker, if a ~ character is accidentally typed, type the close square bracket character ‘]’ to end the message. MTCP messages contain checksums, so it is very unlikely that such a sequence of key presses will result in a valid MTCP message.

 

On start-up the Brick-HD will display an initialisation message containing the firmware version and some start-up progress information. Once running a prompt will be displayed, showing the current working directory in the Flash disk volume, followed by a # prompt. If the unit id is not 0, the # prompt will be preceded with the unit id.

 

Commands can be typed at this prompt, e.g.

 

BrickHD Bootloader
Version 1.3 (MK3)
(c) Media Technologies Ltd 2010
Boot: HD3_3.2.04.BIN

-------------------------------------------------------------------------------

Brick-HD Videowall
Version 3.02.0004 - Feb 23 2011
(c) Media Technologies Ltd 2011

Load FPGA_C2201.xsvf - OK
Init File System - OK
Starting TELNET server
Starting MTCP server
Starting HTTP server
Initial split: 4,4
Video output: DVI
Video input: DVI
Starting TFTP server

#

 

The command line is buffered, so the command is only acted upon when return is pressed. Previous commands lines are saved in a command history buffer. Use the up and down arrow keys to scroll through this buffer. The left and right arrow keys allow the cursor to be moved along the command line. Insert mode can be toggled on/off by pressing the insert key.

 

The set of commands available are described below. To get a summary of top level commands enter ? followed by return. To get a summary of all commands enter ??. Commands can have multiple level command words, for example "show dvi input"

 

Commands are not case sensitive, however file and directory names are.

 

The ? and ?? help commands can be used with commands as arguments, as well as from the prompt directly. For example to get a list of all show commands enter "show ?” or “show ??". This works for each level of the command structure. Ultimately it will show just one command if the command supplied is unique.

 

It is not necessary to use the full command word. A short form can be used provided the first characters of the command word are unique, for example the two following commands are the same

 

show dvi input

sh d in

 

If tab is pressed a command word will be expanded to it's full form if it is unique.

 

Text output from Shell can be unsolicited if debug is enabled, though generally the output only appears as a result of a command. A pair of commands, "terminal monitor" (term mon) and "no terminal monitor" (no term mon) enable and disable unsolicited debug messages.

 

Most commands can be embedded in MTCP messages. To see which commands can be used this way use the ?? help command to list them. Those with an (M) preceding the comment can be embedded. The commands that can't be used this way are generally those which produce some output text, since there is no mechanism to redirect this output from the console to the message process.

 


 

Flash Volumes

 

There are two Flash Memory based "disk" volumes used by the Brick-HD processor.

 

Flash

A general read/write volume which acts just like a conventional magnetic disk.

Bootflash:

A special purpose volume that holds files required to boot the video wall application. 

     

             

The conventional flash volume supports up to 5 sub-directories. Directory names are limited to 10 characters. When formatted 5 sub-directories are created in addition to root. Directories are separated from filenames by forward slash characters.

 

/

/usr

/sequence

/etc

/wwwroot

/images

 

The /usr directory contains any user created shell scripts. Shell scripts are extremely simple and consist of a list of command lines with optional blank lines. Comments may be used, preceded by a # character.

 

The /sequence directory holds binary sequence files (.SFB or .sfb) and a text based mapping file seqmap.conf, if character mapped sequences are configured.

 

The /etc directory holds the user account database and configuration files. These may be created automatically by the video wall application. Configuration files with the extension .conf are text files which can be changed using a text editor and downloaded to the Brick-HD.

 

The /wwwroot and /images directories hold files to support the web server.

 

Space from deleted files is automatically recovered when needed for new files. The volume uses a static and dynamic wear leveling algorithm to prevent premature failure of the device due to repeated erase operations.

 

Filenames can be up to 80 characters long and include spaces. Filenames are not case sensitive when used by the shell commands. Filenames can contain any ASCII printable character except  < >  \  : "  |  *  ?

 

 

The Bootflash: volume contains the binary code for the video wall application and the binary data for the Xilinx FPGA devices. It does not support directories. 

 

Bootflash: files are not stored in a block based format, but written linearly so that the file can be accessed simply and the whole file copied to RAM at high speed.

 

Bootflash: does not support directories. Filenames are limited to 16 characters. The characters permitted in filenames are the same as the conventional flash volume so files can be copied between the two volumes using the same name within the Bootflash: length constraint.

 

When a Bootflash: file is deleted it is simply marked as deleted and no file space is released. To release deleted file space the command "squeeze" must be used. Files only need to be written to the Bootflash: volume if the firmware needs to be updated. There is space for a number of updates before it is necessary to squeeze the Bootflash: volume. If the Brick-HD PC application is used to update the firmware the squeeze process, if required, is performed automatically.

 

In shell commands the Bootflash: volume name can be abbreviated to bf:

 

 

The CPU itself contains two further Flash memories. One holds the boot loader / ROM monitor code that executes following a reset. A second small Flash memory contains significant configuration data required before the two larger non-CPU Flash volumes are initialised.

 


 

Boot (start-up) Process

 

On power-up or following a software reset the processor executes the boot loader. This is a small program held in the CPU's main read only Flash memory. This uses configuration data in the small CPU base configuration memory to determine the name of a binary code file to load. Depending on the type of binary file the boot loader may also download the FPGA data or leave that to the binary application.

 

If the boot loader successfully reads a valid binary file into RAM it will print a row of dashes before executing the code. Any text below this row of dashes belongs to the booted application. Text before the dashes comes from the boot loader itself.

 

If the boot loader fails to load the configured binary file, for example because it can't find a valid application binary or the file to be loaded is corrupted, the bootloader instead boots a ROM Monitor program from the CPU's Flash Memory. This is a compressed file which is decompressed to RAM before being executed.

 

The ROM Monitor is very similar to the video wall application, except that it does not initialise anything. The shell prompt be a >  since the flash volume has not been mounted. Use the mount command to mount the flash filing system. Bootflash: does not need to be mounted and will be accessible regardless of the type of prompt.

 

The ROM Monitor allows the flash and Bootflash: volumes to be re-formatted and supports the file transfer protocols necessary to allow the system files to be loaded onto Bootflash:

 

To force the Brick-HD to enter the ROM monitor reset the unit (or turn the power off and then on) keeping the front panel push/select knob pressed until the ROM monitor starts. There is a short delay following a reset command issued from the front panel VFD menu, allowing time to release the Select/Push knob to execute the reset and then push and hold the knob before the boot loader starts.

 


 

Telnet Access

 

The Brick-HD command shell can be accessed using Telnet if the Telnet daemon is enabled. (See “set service telnet”).  Telnet uses TCP/IP on port 23.

 

On connection a username and password are required. If the user database is configured this will be an account configured in that database. To set and clear user accounts, see the “user …” set of commands. If no user accounts have been configured the default username/password is anonymous/anonymous. As soon as one user account is configured, the default username/password is disabled.

 

The user database is a simple text file /etc/passwd.conf with each user account occupying one line. Passwords are hidden using a one way MD5 based hash. Users can set their passwords using the passwd command.

 

To disconnect from a Telnet session use the exit command.

 

To view the users currently connected via telnet use the “who” command.

 


 

Shell Scripts

 

The Brick-HD command shell supports an extremely limited scripting facility. Commands that can be entered at the command prompt can be included in a file. Comments can be included by preceding the comment with a # character. If the file name is entered at the command prompt the script will be executed. Scripts must be located in the /usr directory. Scripts cannot be used to alias existing command words, they always take precedence.

 

For example, to create a simple script that prints "Hello world!".

 

#inp /usr/example
Enter lines of text, press ^Z to end
# Simple shell script
remark "Hello world!\n"
^Z

 

To execute the script

 

#example
Hello world!
#
 

 

The shell does not have the concept of a working directory. Generally file paths have to be used in their absolute form. To execute a script the shell assumes the script is located in /usr, so it is not necessary to prepend the directory name.

 

The script file "startup" is a special case. This will be executed at startup just before the shell prompt is displayed. The script runs in the same thread as the shell so will not run concurrently.

 

If there is problem with the startup script - for example a sleep command is included which sleeps for too long - to skip the startup script load the ROM Monitor.  This is achieved by resetting the unit (or turning the power off then back on) and keeping the Select/Push knob on the front panel pressed until the firmware starts up. The ROM Monitor does not execute the start up script. Using the ROM Monitor the script can be deleted (or amended).

 

Note that the ROM Monitor does not mount the flash volume. This must be done manually using the "mount" command.

 


 

Shell Command Reference

 

The following is a list of all the commands supported. Later firmware releases may have slight changes to the command syntax and some commands may no longer be supported or replaced with alternative commands to achieve the same effect. See the ? and ?? commands to get a command summary directly from the shell firmware for a specific release.

 

Variable arguments are shown in angle brackets. Optional arguments are shown in square brackets. Alternative arguments are shown separated by the vertical separator | character. A limited set of named arguments is shown bounded by curly brackets. e.g.

 

{A|B}  

 Means the argument supplied can be literally A or B

<A> <B>

 Means two arguments are required. The values of A and B are not defined here.    

[<A>] 

 Means argument A is optional

 

 

show dvi input

 

Show the dvi input connection status.  e.g.

 

#sh dvi in

Enabled: No

Hotplug: Not connected

    I/P: Not active

 

 

show dvi power

 

Shows the DVI output hotplug power supply voltage, nominally +5v, common to all DVI outputs. Individual DVI outputs can be enabled and disabled. The power will be disabled (voltage = 0v) if all of the DVI outputs are disabled. e.g.

 

#sh dvi pow

DVI output supply = 4.84V

 

 

show dvi output [<channel>|summary]

 

Show the dvi output connection status. If no arguments are supplied, the state of all 16 channels is listed. If the "summary" keyword is used the monitor EDID channel is not interrogated. If a channel number (range 1 to 16) is supplied the monitor EDID data for that channel is read and displayed.

 

#sh dvi out
Ch  Hotplug Rx-Sense  State                      EDID
01    Yes      No     Disabled/Down  Connected   SAM0566   SyncMaster   HMCSB02138
02    Yes      No     Disabled/Down  Connected   SAM0566   SyncMaster   HMCSB02365
03    Yes      No     Disabled/Down  Connected   SAM0566   SyncMaster   HMCSB02364
04    Yes      No     Disabled/Down  Connected   SAM0566   SyncMaster   HMCSB02363
05    Yes      No     Disabled/Down  Connected   SAM0566   SyncMaster   HMCSB02762
06    Yes      No      Enabled/Up    Connected   SAM0566   SyncMaster   HMCSB02624
07    Yes      No      Enabled/Up    Connected   SAM0566   SyncMaster   HMCSB02741
08    Yes      No      Enabled/Up    Connected   SAM0566   SyncMaster   HMCSB02246
09    Yes      No     Disabled/Down  N/C
10    Yes      No      Enabled/Up    Connected   SAM0566   SyncMaster   HMCSB02247
11    Yes      No      Enabled/Up    Connected   SAM0566   SyncMaster   HMCSB02740
12    Yes      No      Enabled/Up    Connected   SAM0566   SyncMaster   HMCSB02245
13    Yes      No     Disabled/Down  Error
14    Yes      No      Enabled/Up    Connected   SAM0566   SyncMaster   HMCSB02784
15    Yes      No      Enabled/Up    Connected   SAM0566   SyncMaster   HMCSB02623
16    Yes      No      Enabled/Up    Connected   SAM0566   SyncMaster   HMCSB02739
 
#sh dvi out sum
Ch  Hotplug  Rx-Sense  State
01    Yes       No      Down
02    Yes       No      Down
03    Yes       No      Down
04    Yes       No      Down
05    Yes       No      Up
06    Yes       No      Up
07    Yes       No      Up
08    Yes       No      Down
09    Yes       No      Up
10    Yes       No      Up
11    Yes       No      Up
12    Yes       No      Down
13    Yes       No      Up
14    Yes       No      Up
15    Yes       No      Up
16    Yes       No      Down
 

 

show video output [<channel>]

 

Shows a summary of the status of each output channel or a specific channel if a channel argument is supplied in the range 1 to 16.

 

#sh vid out
Channel Bus Freeze Filter Row Col Signal   O/P   State Cable  Wash: Red Grn Blu
  1      A    Off   On     1   1   VIDEO   DVI    Down  Conn          0   0 128
  2      A    Off   On     1   2   VIDEO   DVI    Down  Conn        128 128   0
  3      A    Off   Horiz  1   3   VIDEO   DVI    Down  Conn          0   0 128
  4      A    Off   Vert   1   4   VIDEO   DVI    Down  Conn          0   0 128
  5      A    Off   Off    2   1   VIDEO   DVI    Down  Conn          0   0 128
  6      A    Off   On     2   2   VIDEO   DVI      Up  Conn          0   0 128
  7      A    Off   On     2   3   VIDEO   DVI      Up  Conn          0   0 128
  8      A    Off   On     2   4   VIDEO   DVI      Up  Conn          0   0 128
  9      A    Off   On     3   1   WASH    DVI    Down  Conn          0   0 128
  10     A    Off   On     3   2   WASH    DVI      Up  Conn          0   0 128
  11     A    Off   On     3   3   VIDEO   DVI      Up  Conn          0   0 128
  12     A    Off   On     3   4   VIDEO   DVI      Up  Conn          0   0 128
  13     A    Off   On     4   1   VIDEO   DVI    Down  Conn          0   0 128
  14     A    Off   On     4   2   VIDEO   DVI      Up  Conn          0   0 128
  15     A    Off   On     4   3   VIDEO   DVI      Up  Conn          0   0 128
  16     A    Off   On     4   4   VIDEO   DVI      Up  Conn          0   0 128


 

#sh dvi out 1
 Checksum Blk#0: OK
        Version: 1.3
 Plug & Play ID: SAM0566
  Serial num ID: 1129730386
   Manufactured: Week 48 2009
      Video I/P: Digital
     Image size: 410 x 260 mm
          Gamma: 2.20
  Power control: Active-Off/VLP
   Display Type: RGB Colour
Default CS sRGB: No
  Pref Timiming: Yes
  GTF Supported: No
   Chromaticity:   red 0.640,0.329
                 Green 0.300,0.600
                  Blue 0.150,0.060
                 White 0.313,0.329
  Estab. timing: 720x400p @ 70Hz
                 640x480p @ 60Hz
                 640x480p @ 67Hz

 

etc....

 

show video input

 

Shows the video input status. The status includes the configured image size and whether the auto standard detection process is running, the image format out of the input block (MUX FPGA) and the signal detected by the selected input chip. If there is no signal the measurement may timeout or be shown as inactive.

 

The auto standard measuring process monitors the selected input. If the I/P changes and the new signal is a supported video standard the input chip is configured to match. The rest of the video processing is also re-configured to match the image format. For example if the image is magnified and the resolution changes, the image "split" is re-calculated. If the process is disabled, the video processing and input chip configuration stays as statically configured.

 

For analog inputs, an input decoder chip is used and it’s status is shown (AD7401)  When there is no input signal the input decoder chip will free run and output a valid signal to the FPGA chip of the configured format.

 

For DVI the input is connected directly to the first signal processing FPGA following line termination, so there is no AD7401 status information to display.

 

The example below illustrates the result of the command “shows video input” when there is no signal present on the selected input, in this case YPrPb channel 1 and auto standard mode is disabled.

 

#sh vid in

Configured:-

 

Auto mode: No

   Source: YPrPb

    Width: 1920

   Height: 540

  Refresh: 60

     Scan: Interlaced

 

MUX FPGA

 

    Width: 1920

   Height: 540

   H-sync: Normal (-ve) [2068:132]

   V-sync: Normal (-ve) [558:5]

  Refresh: 59.979 Hz

Line Freq: 33.768 kHz

Pixel Clk: 74.280 MHz

 

        Timeout

 

Result of show video input when there is an unsupported signal present on the selected input, in this case YPrPb channel 1

 

#sh vid in

Configured:-

 

Auto mode: No

   Source: YPrPb

    Width: 1920

   Height: 540

  Refresh: 60

     Scan: Interlaced

 

MUX FPGA

 

    Width: 1920

   Height: 540

   H-sync: Normal (-ve) [2068:132]

   V-sync: Normal (-ve) [557:5]

  Refresh: 60.087 Hz

Line Freq: 33.768 kHz

Pixel Clk: 74.284 MHz

 

AD7401 STDI

 

   Locked: No

       BL: 14652        28.63636 MHz clocks in 8 lines

     LCVS: 2            Lines in a V-sync pulse

      LCF: 311          Lines in a field

      FCL: 2240         28.63626 clocks/256 in a field

     Scan: Interlaced

  Refresh: 49.937 Hz

Line Freq: 15.635 kHz

 

Unsupported Component video format

 

Result of show video input when there is an valid signal present on the selected input, in this case YPrPb. Since automode is enabled in this case, the configured standard is forced to match the measured standard and the input is shown as locked (Locked: Yes).

 

#sh vid in

Configured:-

 

Auto mode: Yes

   Source: YPrPb

    Width: 1280

   Height: 720

  Refresh: 60

     Scan: Progressive

 

MUX FPGA

 

    Width: 1280

   Height: 720

   H-sync: Normal (-ve) [1514:136]

   V-sync: Normal (-ve) [746:4]

  Refresh: 59.943 Hz

Line Freq: 44.957 kHz

Pixel Clk: 74.172 MHz

 

AD7401 STDI

 

   Locked: Yes

       BL: 5088         28.63636 MHz clocks in 8 lines

     LCVS: 8            Lines in a V-sync pulse

      LCF: 749          Lines in a field

      FCL: 1866         28.63626 clocks/256 in a field

     Scan: Progressive

  Refresh: 59.945 Hz

Line Freq: 45.025 kHz

 

Valid Input detected

 

    Width: 1280

   Height: 720

  Refresh: 60

     Scan: Progressive

 

 

 

show video modes

 

Lists the supported analogue video standards for each analogue input type.

 

#sh vid mode

 

YPrPb modes supported

 

1280 x  720 P 50

1280 x  720 P 60

1920 x  1080 I 50

1920 x  1080 I 60

  

 

show clock

 

Shows the Real Time Clock date and time.

 

 

show version

 

Shows firmware/fpga version information.  e.g.

 

#sh ver

Brick-HD Videowall
Version 3.02.0004 - Feb 23 2011
Built: Wed, 23 Feb 2011 10:28:07
(c) Media Technologies Ltd 2011

PCB: 03
CPLD: 00
CPU: 0008 rev 02
FPGA: 2.201

Yrs Days Hrs Mins Secs
Uptime: 0 0 0 0 50
Start: 23-Feb-11 11:47:04
 

 

show environment

 

Show environmental conditions, i.e. PSU output voltage and unit internal temperature.  e.g.

 

#sh env

Main PSU OK

1.8V supply = 1.79V

2.5V supply = 2.46V

3.3V supply = 3.26V

5.0V supply = 4.86V

  Inlet temp: 27 Deg. C

Exhaust temp: 33 Deg. C 

 

 

show configuration

 

Show the configuration saved in base flash memory. The base flash memory is independent of the flash and Bootflash: volumes. It is used to save fundamental configuration data that is available before the CPU initialises the flash volumes, and is necessary if the flash volumes are unavailable (e.g. because they have been re-formatted).

 

#sh ver

Brick-HD Videowall
Version 3.02.0004 - Feb 23 2011
Built: Wed, 23 Feb 2011 10:28:07
(c) Media Technologies Ltd 2011

 PCB: 03
CPLD: 00
 CPU: 0008 rev 02
FPGA: 2.201

       Yrs Days Hrs Mins Secs
Uptime:  0    0   0    0   50
 Start: 23-Feb-11 11:47:04
#sh conf
  FS partition: 0

 Start options: FF
      Services: TELNET HTTP MTCP TFTP
   Start debug: off

        Keypad: off
 Host baudrate: 19200
 Loop baudrate: 19200
          BOOT: HD3_3.2.04.BIN
          FPGA: FPGA_C2201.xsvf
       Unit ID: 0

   VFD timeout: 0
VFD brightness: 0

      Timezone: GMT +0

   MAC Address: 00:50:C2:C9:10:0F
          DHCP: Off
    IP Address: 192.168.11.7 255.255.255.0
       Gateway: 192.168.11.1
   SNTP Server: 207.46.197.32
    DNS Server: 192.168.11.1

 

show options

 

Shows the options byte comprising 8 flags as a 2 digit hexadecimal number. The flags select certain firmware options on start-up that are specific to the version of firmware. They are usually used for diagnostic purposes and should normally be set to FF (all on).

 

 

show debug

 

Lists the available debug items and their current state (On/Off).  e.g.

 

#sh debug

Log to terminal: on

Prompt re-print: off

  Authen: off

 Message: off

   Frame: off

    MTCP: off

    FPGA: off

     I2C: off

Sequence: off

 Execute: off

   Image: off

  Telnet: off

    TFTP: off

    V-in: off

   V-out: off

    Fsys: off
    HTTP: off
    SNTP: off


 

show memory

 

Show the amount of free RAM available to the application.  e.g.

 

#sh mem

 Heap start: 081E2F  size: 516560 bytes

Free memory: 459340 bytes (448K)

  Max block: 458839 bytes (448K)

 

 

show interface

 

Show the Ethernet interface status and configuration. e.g.

 

Description: Ethernet 10/100

   Physical: 100M Full duplex

  Int state: Up

MAC Address: 00:90:23:00:00:01

 IP Address: 192.168.11.7 255.255.255.0

    Gateway: 192.168.11.1

        MTU: 1500

 

 

show bootflash

 

Shows the files in the Bootflash: volume. Note that the word bootflash is part of the command and not a volume name as such, so does not have a trailing colon. The command is effectively an alias for the extended version of the dir command, showing the size and checksum of each file in the Bootflash: volume and a summary of volume space.

 

#sh bf
drwx      Size      Timestamp       Hdr Checksum   Filename
-r--   1200337  23-Feb-11 11:46:25  OK  8B4C0E OK  FPGA_C2201.xsvf
-r-x    502693  23-Feb-11 11:46:46  OK  5D4018 OK  HD3_3.2.04.BIN

1261675 bytes free, 5423824 bytes in deleted files

	

 

show info <file>

 

Show information about an executable file stored on the Bootflash: volume. e.g.

 

#sh info HD3_3.2.04.BIN
         Version: 3.02.0004
            Date: Wed, 23 Feb 2011 10:28:07 GMT
   Initial debug: 000000
Compiled options: 00
       Code size: 502693 (502693)
   Code checksum: 5D4018

 


 

show edid <file>

 

Show the contents of an EDID data file. An EDID data file contains the Extended Display Identification Data that can be assigned to the DVI input that connected devices read to determine the display characteristics.

 

EDID data files can be either a binary copy, using 128 or 256 bytes or an ASCII Hex equivalent. In the ASCII form, each byte is represented by two hex digits seperated by white space. Up to 16 bytes per line are possible.

 

 

show message [-d] <fn>

 

List the full set of MTCP function codes. If a function code argument is supplied (0 to 255) then just that function code detail, if any, is shown. If the -d switch is used, the output format is in a macro definition form that can be pasted into a sequence text file.

 

 

show volume

 

Shows details of the flash volumes available.

 

#sh vol

Partition            Volume        Size   Free  Dirty
0: 00000000-007FFFFF            8388608 5935616 19328
6: 03000000-037FFFFF bootflash: 8388608 6703205 0


 

show alignment [<x> [<y>]]

 

Shows the video wall row and column alignment offsets. If no arguments are supplied offsets for all magnification factors (splits) are shown. If a specific magnification factor is supplied for x and or y directions (cols / rows) the output is filtered to only include that magnification. If only a x magnification is specified, y is assumed to be the same as x.

 

#sh align 4
Current split (X,Y): 4 (1280) x 4 (720)
   Column alignment:     1    2    3    4    5    6    7    8    9    10   11   12   13   14   15   16
            Split 4:    42   21  -21  -42
      Row alignment:     1    2    3    4    5    6    7    8    9    10   11   12   13   14   15   16
            Split 4:    38   19  -19  -38
 

 

show process

 

Lists the currently running processes (threads) and their state.

 

#sh proc
ID  Name     State Mode Slice Pri
000 IDLE       0B   05     1   31
001 SYSIT      83   84    20    0
002 SER0IT     83   84     2    6
003 SER1IT     83   84     2    6
004 EMACIT     83   84     2    6
005 TNETd      83   07    20   20
006 SYSD       53   06     1   28
007 VFD        53   07    20    8
008 DHCPtmr    13   06     1   10
009 Console    0B   07    20    9
010 Control    13   07    20    9
011 MTCPd      83   07    20   20
012 LOOPd      83   07     1   10
013 QClean     13   07    20   29
014 HTTPd      83   07    20   20
015 Debug      13   07    20    8
016 SEQ        13   07     1    9
017 FRMINT     83   80     2    4
018 VideoIn    13   07    20   28
019 TFTPd      83   03    20   28
 


 

show sequence [*]

 

If no arguments are supplied shows the name of the currently executing sequence or <none> if there are no sequences running. If the * argument is used, all available sequence files are listed. If the sequence file was installed using the Brick-HD PC control software the button legend will be captured in the binary sequence file and displayed with this command.

 

 

show queue

 

Shows the state of the MTCP reply queues. Functions that return data place it in reply queue. An MTCP poll message is used to read data from the queue.

 

 

show keypad

 

Shows the voltage on the keypad power pin (pin 9 of the Host RS-232 connector).

 

 

show dimensions

 

Shows a list of the image dimensions that have non-default alignment configurations. For any given input image dimension, 1024x768, 1280x720 etc. a table of row/column offsets for each magnification factor is maintained. These tables are dynamic in that they are only created when a non-zero row or column offset is set for a specific magnification of that image size.

 

 

show logging

 

Shows the current logging configuration and state. Debug and other significant event messages can be sent (logged) to the console, the loop serial port and a syslog server.

  

#sh log
       Server: 192.168.11.2
         Port: 514
      Enabled: Yes
Log loop port: No
     Severity: Notice (5)
     Facility: LOCAL7
 Total logged: 4
 
 

read io <address> [number wait states]

rd io <address> [number wait states]

 

Read I/O data.

 

 

read i2c <address> [<sub-address> [<len>]]

rd i2c <address> [<sub-address> [<len>]]

 

Read I2C register(s). Address is either a physical I2C address or a logical address of an output encoder chip. Add 16 to the logical address for the DVI driver chip.

 

 

read fpga <ch|*> <reg> [<n>]

rd fpga <ch|*> <reg> [<n>]

 

Read an output FPGA register. The 16 logical output FPGAs are addressed from 0 to 15 and mapped 1:1 with the output channels numbered from 1 to 16. If * is used rather than a specific FPGA address, the selected register(s) from all output FPGAs are shown. If 3 arguments are supplied, the 3rd argument is a count of the number of registers to show from the starting register address.

 

 

write io <address> <data> [<wait>]

wr io <address> <data> [<wait>]

 

Write a byte to an I/O port at <address>, using an optional number of wait states.

 

 

write i2c <address> <sub-address> <data>...

wr i2c <address> <sub-address> <data>...

 

Write bytes to an I2C device at address. Address is either a physical I2C address or a logical address of an output encoder chip. Add 16 to the logical address for the DVI driver chip. To write to an I2C device that does not use a sub-address, supply just the address and data. If more than 3 arguments are supplied they are assumed to be data for successive I2C sub-addresses.

 

 

write fpga <ch|*> <reg> <data>

wr fpga <ch|*> <reg> <data>

 

Write a data byte to an output FPGA register. The 16 logical output FPGAs are addressed from 0 to 15 mapped 1:1 with the output channels. If * is used rather than a specific FPGA address, all of the output FPGAs a written.

 

 

write mux <reg> <data> [<data>]

wr mux <reg> <data> [<data>]

 

Write to an input MUX FPGA register.

 

 

set ip dns server <address>

 

Set the IP address of the default DNS server in dotted decimal form. The address is written to the base configuration in flash memory and not applied until the processor is reset.  e.g.

 

set ip dns server 192.168.11.1

 

 

set ip sntp server <address>

 

Set the IP address of the default SNTP server in dotted decimal form. The address is written to the base configuration in flash memory and not applied until the processor is reset. e.g.

 

set ip sntp server 192.168.11.8

 

 

set ip address <address> <mask>

 

Set the IP address assigned to the Ethernet interface. If DHCP is enabled this address is only used if DHCP fails. The address is written to base configuration in flash memory and not applied until the processor is reset. e.g. to set an IP address with a /24 mask

 

set ip address 192.168.11.7 255.255.255.0

 

 

set ip gateway <address>

 

Set the IP default gateway address e.g.

 

set ip gateway 192.168.11.1

 

 

set ip dhcp address {on|off}

 

Enables or disables DHCP on start-up.  DHCP is enabled by default if the base configuration is erased.

 

DHCP can take some time to timeout if there are no DHCP servers available, so if starting from scratch it is better to disconnect the Ethernet cable and then disable DHCP, configure the IP parameters and then re-connect the Ethernet cable.  This is because the DHCP process will see the Ethernet link down and fail immediately, rather than timing out waiting for a response from a DHCP server.

 

 

set ethernet mac {<NN:NN:NN:NN:NN:NN>|<Serial Number>}

 

Set the Ethernet MAC address. The MAC address is in the form NN:NN:NN:NN:NN:NN (where NN is a 2 digit hexadecimal value), or the (decimal) serial number of the device. The MAC address is written to the base configuration in flash memory and not applied until the processor is reset.

 

The range of MAC addresses for the Brick-HD assigned by Media Technologies Ltd is 00:50:C2:C9:10:00 to 00:50:C2:C9:1F:FF. The last 3 hex digits will be set to decimal serial number of the device prior to delivery.

 

If the base configuration flash memory is erased using the clear configuration command, the default MAC address 00:50:C2:C9:10:00 will be used until a valid MAC address is set.  This address will work, but if there is more than one Brick-HD connected to the LAN in the same state there will be an address conflict. The Brick-HD serial number label is located on the base of the unit by the mains A/C connection.

 

e.g. to set the MAC address explicitly

 

set ip ethernet mac 00:50:C2:C9:10:64

 

or to use the serial number, (100 decimal in this example)

 

set ip ethernet mac 100

 

The configured Ethernet MAC address can be read using the command show configuration. Note that this shows the configured address, not the current address in use. To view the currently active Ethernet MAC address, use the command show interface.

 

 

set service mtcp {on|off}

 

Enable or disable the MTCP service. It is necessary to enable this service to allow TCP/IP connections from the PC Brick-HD control application. MTCP listens on TCP port 5000 for connection requests.

 

 

set service tftp {on|off}

 

Enable or disable the TFTP service. It is necessary to enable this service to allow file upload/download using the Brick-HD PC control application. The TFTP service listens on UDP port 69 for connection requests.

 

 

set service telnet {on|off}

 

Enable or disable the TELNET service. This service allows remote console access via TCP/IP. User sessions are authenticated. See the "user ..." set of commands for administering user sessions. If no user accounts are configured the default username/password is anonymous/anonymous. Once a user account is configured, the default username/password are no longer valid.

 

 

set service http {on|off}

 

The HTTP service listens on TCP port 80 for connection requests.  It also requires flash directories /wwwroot and /images. wwwroot contains the default index.htm file which provides links to other html files. In addition there is a virtual directory cgi-bin available. Currently only /cgi-bin/buttons is supported. This will display a web page populated with buttons corresponding  to downloaded sequences located in the /sequences directory.

 

 

set vfd brightness <0..3>

 

Sets the brightness of the Brick-HD front panel VFD (Vacuum Florescent Display). 0 is the dimmest and 3 the brightest setting. If an LCD display is fitted rather than a VFD type the brightness is not adjustable and this command may not be present.

 

 

set vfd timeout <seconds>

 

Sets the timeout for the front panel VFD menu system. If there has been no activity for the period set the VFD is blanked. If blank it can be re-activated by pressing the front panel Select/Push knob.

 

 

set alignment row <split> <row> <offset> [<offset>] ...

 

Set the position of magnified image row for a given magnification factor (split). The offset is signed value (+/- 1000) and sets the deviation from nominal (0) in magnified pixels. Multiple offset values (up to 8) can be used to set offsets for successive rows.

 

 

set alignment column <split> <column> <offset> [<offset>] …

 

Set the position of magnified image column for a given magnification factor (split). The offset is signed value (+/- 1000) and sets the deviation from nominal (0) in magnified pixels. Multiple offset values (up to 8) can be used to set offsets for successive columns.

 

 

set alignment pan row <split> <offset>

 

Sets an offset from the normal start point for all image rows for a given split, range 1-16. Offset is a signed decimal number from -500 to +500. The offset is added / subtracted from any existing offsets. The change is applied in real time. The effect of this command is to move the displayed image up/down by <offset> pixels.

 

 

set alignment pan column <split> <offset>

 

Sets an offset from the normal start point for all magnified image columns for a given split, range 1-16. Offset is a signed decimal number from -500 to +500. The offset is added / subtracted from any existing offsets. The change is applied in real time. The effect of this command is to move the displayed image left/right by <offset> pixels.

 

 

set alignment zoom row <split> <offset>

 

Sets an offset from the normal start point for image rows for a given split (range 1-16) which increases the further from the center the row is. Offset is a signed decimal number from -500 to +500. The offset is added / subtracted from any existing offsets. The change is applied in real time.

 

 

set alignment zoom column <split> <offset>

 

Sets an offset from the normal start point for image columns for a given split (range 1-16) which increases the further from the center the row is. Offset is a signed decimal number from -500 to +500. The offset is added / subtracted from any existing offsets. The change is applied in real time.

 

 

set video input <source> [<standard>]

 

Set the video input to be from one of the following sources

 

·  DVI

·  YPrPb

 

The optional standard defines the expected signal format in the form

 

[<Width>x]<Height><Scan>[/<Refresh>]

 

Where

 

Width is the width of the visible image in pixels.

Height is the height of the visible image in pixels for a complete video frame.

Scan is the type of scanning type, i for interlaced or p for progressive.

Refresh is the number of fields per second

 

e.g. 1280x720p/60    

 

A video standard may be abbreviated. The width can be dropped, in which case it is derived from the height assuming square pixels and a 16:9 aspect ratio. If the refresh rate is omitted 60Hz is assumed,

 

e.g. 720p

 

There are some exceptions where the abbreviated standard is a known SD (Standard Definition) or ED (Enhanced Definition) signal format i.e.

 

525i   

625i   

525p

625p

 

If a video standard is supplied the background process which measures the input video standard is disabled and the input decoder is set to the standard defined. If an unsupported standard is specified an error message is displayed.

 

If just the input source is specified the signal will be measured (line and field frequencies) and if these match a supported standard the input decoder will be configured appropriately.

 

The set of analogue video standards supported can be listed using the command "show video modes"

 

In the case of DVI all image dimensions are supported up to a maximum width of 1920 pixels and height of 1080 pixels, provided the DVI clock is less than ~80MHz.

 

If the video output mode is set to YPrPb or RGB only the analog inputs can be used, since currently the necessary internal colour space conversion is not available.

 

 

set video input automode {on|off}

 

Enables or disables the background input video standard measurement process.

 

 

set video output {DVI|YPrPb|RGB}

 

Sets the video output mode. All 16 output channels will be set to the selected mode. Component and DVI-D is output on the same rear DVIconnectors. Component video in YPrPb format or RGB (sync on green) is via the DVI-A pins on the DVI connectors.

 

If the video output mode is set to YPrPb or RGB only the analog inputs can be used, since currently the necessary internal colour space conversion is not available.

 

 

set video output position <ch> {Rc|<row> <col>}

 

Sets the position of an output channel in the video wall array. The position can be specified as an X,Y location using two decimal numbers or as a single two character address where columns number 1 though.16 and rows use letters A through P. Video channels number from 1 to 16.

 

For example to map channel 4 to the left most monitor on the 2nd row of a 3x3 array

 

set video output position 4 B1         or

set video output position 4 2 1

 

 

set video output wash {<ch>|*} {on|off} [<r> <g> <b>]

 

Sets the video output state for a channel or all channels if the channel address is *. If set off, the display is the selected video input magnified by the split (set split). If wash is on, the output is a uniform colour wash associated with a given channel. The colour of the wash can be set if Red Green and Blue values are supplied. This value will be saved, so for example each channel can have a different wash colour set, but all forced to display their saved colour using the * channel address with "set video output wash * on".

 

 

set freeze on

 

Sets the freeze state of the displayed video image to frozen.

 

 

set freeze off

 

Un-Freeze a frozen video image.

 

 

set syncloss colour <r> <g> <b>

 

Set the color displayed if the current analog video source has failed.  If the video input fails a uniform colour wash is displayed. Detection of a loss of signal is done by the video decoder chip in hardware, so is independent of automatic video standard detection process. The colour is defined by it's red, green and blue components in the range 0..255. These values are converted to the appropriate colour space internally. The colour settings are applied immediately and saved in the video input configuration file, to be re-applied at start-up. This mechanism is not used with the DVI input.

 

 

set {host|loop} baudrate [1200..56000]
 

Sets the baudrate of the Host and Loop serial ports. If no argument is supplied they are reset to the default value of 19200 bit/s. The new baudrate is saved in base configuration flash memory and only applied physically following a processor reset. The rest of the serial port parameters remain as 8 data bits, 1 stop bit, no parity and no flow control.

 

 

set keypad {on|off}

 

Set the start-up keypad mode.  If set to off the Brick-HD will start-up in normal console mode. If set to on, at start-up the host serial port is set to 1200 bit/s, +5v is applied to pin 9 of the host RS-232 connector and the firmware operates in character sequence mode.

 

 

set bezel <dx dy>|<x1 y1 x2 y2>

 

Sets the alignment for the current split and image dimension from the bezel dimensions. If only two arguments are provided these are the size of the bezel as a percentage of the images size multiplied by 100. E.g. if the bezel is 10% of the size of the image, the command would be "set bezel 1000 1000". The maximum values for dx and dy are 5000 i.e. 50%

 

Alternatively relative bezel dimensions can be used. Values must be integers. For example if a monitor has an outer dimension of 44cm by 29cm and picture size of 41cm and 25.5cm these values could be entered as "set bexel 440 290 410 255". The maximum size of x1 and y1 is 100000. x1 must be greater than x2 and y1 greater than y2.

 

 

set partition <P>

 

Set the flash partition <P> used for the Flash Filing system volume. There are 8 Flash partitions numbered 0 to 7. Partitions 0 to 5 can be used for the flash volume. Partitions 6 and 7 are used for the Bootflash: volume.

 

Some earlier Brick-HD units may only have 4 partitions, in which case 0 and 1 can be allocated to the flash volume and 6 and 7 are used by Bootflash:

 

 

set idle timeout [<id>]

 

Set the idle timeout for a Telnet session. If an id is supplied the timeout is applied to that session otherwise it is applied to the user's session. Session ids can be determined using the "who" command. The timeout value is in seconds.

 

 

set date <dd-MMM-yr>

 

Sets the Real Time Clock date. The date format is Day-Month-Year where day is the day of the month from 1 to 31, the Month is a 3 character mnemonic i.e. Month mnemonics are not case sensitive. Day and year numbers do not require leading zeros.

 

JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC

 

The year is the last 2 digits of the year. For example

 

set date 01-MAR-10

set date 1-mar-1

 

 

set time <hr:mm:ss>

 

Sets the Real Time Clock time. e.g.

 

set time 9:30:25

 

 

set id <id>

 

Sets the unit identity. Each Brick-HD in a multi-unit installation must have a unique identity. The primary unit (the one connected to a controlling PC) should have unit id of 0. In the case of stand-alone processors, the unit id should also be 0 for simplicity. The unit id will be saved in base configuration flash memory and applied immediately.

 

 

set zone <offset>

 

Sets the difference between the local time zone and UTC/GMT. The offset is signed number of hours difference between GMT and the local time with a resolution if of 1/2 hour. The zone value is used when the Real Time Clock is set via SNTP, to set it to local time. Current firmware does not provide a mechanism to account for winter/summer time shifts directly.

 

 

set boot [<filename>]

 

Sets the name of the application file that will be loaded on start-up. The file must reside in the Bootflash: volume.

 

 

set fpga [<filename>]

 

Sets the name of the data file used to program the FPGA (Field Programmable Gate Array) chips that will be used on start-up. The file must reside in the Bootflash: volume.

 

 

set secret [<name>]

 

Sets the shared secret used with the MTCP (Media Technologies Control Protocol) to allow authenticated remote connection via TCP/IP from the Brick-HD Video Wall Control PC software application. MTCP listens for connections on TCP port 5000. The MTCP needs to be enabled using the command "set service MTCP on" if MTCP support is required. The secret will be saved in base configuration flash memory.

 

 

set debug <name> {on|off}

 

Debugging is disabled at start-up normally. To enable/disable debugging of start-up actions use this command. Debugging should be used with caution. If too many debug actions are enabled it may overload the Brick-HD CPU. The debug setting is saved in base configuration flash memory and applied at start-up.

 

 

set priority <thread id> <priority>

 

Set the priority of a thread. To see the list of current threads use the "show process" command.

 

 

set split <x> [<y>]

 

Set the video image magnification factor (split). If one argument is supplied, the images is magnified using this in both x and y dimensions. If two arguments are supplied the x and y dimensions can have different magnification factors. The range of x and y values is 1 to 16.

 

 

set dimension <x> [<y>]

 

Set the image size. This is used in the split calculation (see the "set split" command). Normally the image size is determined from the video input signal and it is not necessary to force the Brick-HD to use an explicit image size. In the case of interlaced video, the Y dimension is the height (number of lines) of active video in a field e.g. 1080i has a Y dimension of 540.

 

 

set options <options>

 

Sets the options byte, where <options> is a 2 character hexadecimal value. This feature provides the equivalent of a set of 8 DIP switches that can be used to select certain diagnostic software features at start-up. The options value should be FF normally.

 

 

clear setting video in

 

Clear video input settings and revert to factory defaults. Applied immediately but not saved.

 

 

clear setting video out

 

Clear video output settings and revert to factory defaults. Applied immediately but not saved.

 

 

clear setting alignment

 

Clear alignment settings for the current image size. Applied immediately but not saved.

 

 

clear setting all

 

Clears video in, video out and alignment settings.  Applied immediately but not saved.

 

 

clear configuration

 

Clear all base configuration and return to factory defaults. Note this also clears the MAC address which must be unique if the Ethernet connection is used. See the set ethernet mac command, to restore the MAC address.

 

 

clear alignment

 

Clear all alignment settings for all splits. Deletes the alignment configuration file so will not affect current settings but will cause the alignment to be reset to factory defaults (i.e. none) for all splits and all dimensions after a reset.

 

 

clear debug

 

Clear all current debug flags for all users.

 

 

user delete <name>

 

Delete a user account.

 

 

user disconnect <id>

 

Disconnect a connected user. See the who command for a list of connected users. This only works for Telnet users. The id argument is the session id determined from the who command. This id is the same as the process id for the session (see show process).

 

 

user list

 

List the configured user accounts. The same can be determined by listing (cat) the contents of the passwd.conf file in /etc.

 

 

user add

 

Add a user to the user database. User accounts are used for Telnet user authentication. A user account as a minimum must have a username and password. Users can change their password once an account is created using the passwd command.

 

By default users have privilege level 15 and permission to use Telnet. Current firmware does not make use of the privilege level.

 

 

test mode {off|hatch|dots|prbs|csr}

 

Shows a test signal instead of normal video. For this to work an input clock is required, which means it will not work with a DVI source that is not enabled. Selecting one the Component video source (YPrPb) will provide a clock even if there is no valid input.

 

To set the colour of the test signal use the test colour command.

 

 

test ram <start address> <end address>

 

Test a block of RAM between the start and end addresses by writing alternating test patterns to each byte in the selected block. This is a non-destructive test.

 

 

test fpga [<ch>]

 

Test a selected output FPGA, or all output FPGAs. Channels are numbered 0 to 15. The O/P mux address is 16.

 

 

test cursor <x> <y>

 

Display a test cursor at location <x>,<y>. The cursor is generated in hardware.

 

 

test colour <r> <g> <b>

 

Set the colour used with hardware test signals. The colour is defined in the RGB colour space where R,G and B have the range 0 to 255.

 

 

test box <x1> <y1> <x2> <y2> [<r> <g> <b>]

 

Display a bounding box defined by the corners at location x1,y1 and x2,y2 and optionally set the colour of the lines used to draw the box. This signal is not created in hardware directly, but rather by manipulating the internal lookup tables so does not use the test colour. To clear the screen of area bounding box(es) force a magnification update (split) using the split command.

 

 

test encoders

 

Test the component output encoders and DVI driver chips. The test writes and reads back a benign I2C register in each chip.

 

 

enable dvi input

 

Enable the DVI input, by setting the input hotplug output to +5v. By default the DVI input is enabled on startup.

 

 

enable dvi output [<ch>]

 

Enable a DVI output chip or all if no channel is specified. Output channels number 1 to 16. If at least one chip is enabled all outputs have the DVI hotplug output pin set to +5v. By default, if DVI output mode is selected, all DVI outputs are enabled.

 

 

enable keypad

 

Enables the +5v O/P on pin 9 of the Host RS-232 connector to provide power for an external ASCII keypad.

 

 

enable sntp <mode>

 

Enables the SNTP thread. This will attempt to acquire the time from the pre-configured SNTP/NTP server. If mode is set to 0, the thread will end once it has received a valid response and sent the RTC clock. If mode is set 1, it will wait for 24hours before repeating the request.

 

 

enable loop

 

Enable RS232 loop-through mode. In this mode the Host and Loop serial connectors are effectively bussed. Commands sent from a controlling PC to the host serial port will appear at the same time on the loop output. This mode is used when multiple Brick-HD units are connected together to ensure that all devices act on a broadcast command at the same time. This means any unframed command sent via the host serial port will be sent to all devices on the serial bus. To prevent this use the "disable loop" command. See also the "attach" command. The Brick-HD will start-up with loop-through mode disabled.

 

 

disable dvi input

 

Disable the DVI input by setting the hotplug output pin to 0v.

 

 

disable dvi output [<ch>]

 

Disable a selected DVI output by stopping the output clock. If all outputs are disabled the hotplug output pins of all outputs are set to 0v.

 

 

disable keypad

 

Disable the +5v O/P on pin 9 of the Host RS-232 connector, setting it to 0V.

 

 

disable sntp

 

Disables the SNTP thread. This stops any pending SNTP request.

 

 

disable loop

 

Disable the RS232 loop-though mode. In this mode MTCP messages are routed via the CPU. If a message is sent into the host port on a device and not addressed to that device it will be sent un-modified out of the loop port to the next device in the chain. There is a short delay handling the message since the whole message has to be read before it can be forwarded to the next device, hence the loop-though mode.

 

Use the Brick-HD in this mode, when the shell is used with multiple devices, to prevent unframed shell commands via the host port being acted upon by more than one device. See the "attach" command to communicate via the shell to other devices in the chain in this mode. The Brick-HD will start-up with loop-through mode disabled.

 

 

tftp <host> <remote filename> [<local filename>]

 

Gets a file from a remote TFTP server. Host can be either a dotted decimal IP address or a DNS name if a DNS server has been configured. By default the file will be saved in Bootflash: unless the full path using the optional local filename argument is used.

 

e.g. Copy a file to bootflash from the remote TFTP server root directory with the same name.

 

tftp get 192.168.1.2 hdvw.bin

 

e.g. Copy a file to bootflash from the remote TFTP server root directory with a different name.

 

tftp get 192.168.1.2 hdvw_19036.bin hdvw.bin

 

e.g. Copy a file to /sequence from a sub-directory of the remote TFTP server

 

tftp get 192.168.1.2 /my_sequences/split3.sfb /sequence/split3.sfb

 

The Brick-HD itself can act as a TFTP server, so in a multi-unit installation files can be copied from one unit to another.

 

 

tftp put <host> <local name> [<remote name>]

 

Put a file from the Brick-HD onto a remote TFTP server. Host can be either a dotted decimal IP address or a DNS name, if a DNS server has been configured. If local name does not start with a / the file is assumed to be located in Bootflash:.

 

 

tftp dir <host>

 

List the files in the TFTP root directory of the remote server, if the remote server supports the feature. Host can be either a dotted decimal IP address or a DNS name if a DNS server has been configured.

 

If the host is another Brick-HD this lists the files in the Bootflash: volume.

 

 

map sequence {<nn>|<'c'>} [<file>]

 

Assign a character to a specific sequence file. When the host serial interface is placed in character sequence mode instead of the default console shell, receipt of that mapped character over the interface will cause the mapped sequence to execute. To remove a mapping omit the filename.

 

This command updates the file /sequence/seqmap.conf, for example the command

 

map seq 'D' DVIin.SFB

 

causes the line

 

86 DVIin.SFB     ; char = D

 

to be added to the seqmap.conf file.

 

With this configuration, in character sequence mode, sending ASCII D over the host interface causes DVIin.SFB to be executed if it exits in the /sequence directory.

 

 

load dvi edid {<file>|<ch>} [<delay>]

 

Load a dvi EDID (Extended Display Identification Data) file into the DVI input ROM emulation. Devices connected to the DVI input may read this data to determine the display characteristics. If a channel number (range 1 to 16) is used instead of a file the data is read from the device connected to that channel. The delay parameter sets the time that the hotplug output pin is held low in milliseconds, to indicate a change. If not specified a delay of 100 milliseconds is used.

 

 

load video in [<file>]

 

Load a video input settings file (created with save video in). If no file is specified the default /etc/video_in.cfg is used

 

 

load video out [<file>]

 

Load a video output settings file (created with save video out). If no file is specified the default /etc/video_out.conf is used

 

 

load alignment [<file>]

 

Load a monitor alignment file (created with save align). If no file is specified the default /etc/align.conf is used

 

 

list video input

 

Lists the video input settings in a text format that can be “pasted” back into the command line (or saved in a file and executed as a shell script).

 

 

list video output

 

Lists the video output settings in a text format that can be “pasted” back into the command line (or saved in a file and executed as a shell script).

 

 

list base

 

Lists the base configuration in a text format that can be “pasted” back into the command line (or saved in a file and executed as a shell script).

 

 

list alignment

 

Lists the video processor alignment settings in a text format that can be “pasted” back into the command line (or saved in a file and executed as a shell script).

 

 

list all

 

Lists all of the configuration settings (video, alignment and base) in a text format that can be pasted back into the command line or saved in a file and executed as a shell script.

 

 

[no] logging prompt

 

Causes the shell prompt to be redisplayed after a debug message has been displayed. The default condition is no logging prompt.

 

 

[no] logging loop

 

Syslog messages can be logged to the Loop RS232 port as well as a syslog server. The default is no logging loop.

 

 

[no] logging syslog

 

Enable the syslog client. In order to enable logging to a syslog server a file must be created in /etc called syslog.conf. This is a text file in the form

 

{# | ; } Comment text

server <address>

[server loop]

[severity name]

[facility name]

 

that will be read on start-up.  The severity and facility names are not case sensitive.

 

If this file is changed the syslog client needs to be restarted to apply the changes, using the "logging restart" command.

 

As a minimum just the server address needs to be defined. The default severity is set to Alert and the facility is set to LOCAL7.

 

Logging to the loop port and the severity level can be changed subsequently from the command line. Facilities in the range LOCAL0 to LOCAL7 are supported.

 

The severity sets the logging level. Messages with a level greater than or equal to this will be logged. syslog severity level names are defined as,

0 = Emergency

1 = Alert

2 = Critical

3 = Error

4 = Warning

5 = Notice

6 = Informational

7 = Debug

 

Example /etc/syslog.conf file

 

; Syslog server config

server 192.168.11.8

severity Debug

facility LOCAL7

 

 

logging restart

 

Restarts the syslog client. This forces the file /etc/syslog.conf to be re-read.

 

 

logging severity <level>

 

Set the logging severity level. Level is a number in the range 0 to 7 (with 0 the most severe), or one of the 8 syslog severity names (see the command logging syslog).

 

 

[no] terminal monitor

 

Enable terminal monitoring. By default debug messages will be logged to the terminal for console sessions via the serial port. Sessions connected using telnet will not receive debug messages unless terminal monitoring is enabled. To stop debug messages being logged to the console enter "no term mon".

 

Note that disabling logging of debug messages does not stop any enabled debug, it merely stops it being displayed.

 

If a valid video wall control protocol frame is received via the host interface, terminal monitoring of debug messages will be disabled.

 

 

save video out [<file>]

 

Save the current video output settings in a file. If no filename is specified the settings are saved in /etc/video_out.cfg

 

 

save video in [<file>]

 

Save the current video input settings in a file. If no filename is specified the settings are saved in /etc/video_in.cfg

 

 

save edid [-h|-f] {<file>|<ch#>} <file>

 

Read an edid table from the specified DVI output channel (range 1 to 16) or an edid file and save the result in a file.

 

If the -h option is applied and the EDID file contains an HDMI Vendor Specific Data Block in the CEA extension, it will be removed. If the -f option is supplied further parameters in the edid file will be filtered to make the edid file more appropriate to the Brick-HD.

 

 

save alignment [<file>]

 

Save the current alignment settings in a file. If no filename is specified the default file /etc/align.cfg is used.

 

 

save settings

 

Save the current video in, out and alignment settings using their default filenames.

 

 

flash dump [<address>]

 

Dump the contents of a block of Flash memory starting at <address>. If an address is not supplied, the next block from the last displayed address is shown. The address is a global device address, not an address within a partition. 

 

 

flash write <address> <nn>[ <nn>...]

 

Write a byte (or bytes) to flash at <address>. The address is a global device address, not an address within a partition. This is a low level diagnostic command that should not normally be used, since it will almost certainly corrupt the filing system using the partition.

 

 

flash info

 

Show the contents of the flash device info block and relevant information about the CPU flash state.

 

 

flash erase [<page>]

 

Erase a flash partition. The flash memory is organised as 8x 8M byte partitions. A volume such as flash or Bootflash: maps to one partition.  If a partition number is not supplied all partitions are erased, following a warning prompt. Erasing all of the partitions uses a slightly different device algorithm than that used in the flash wipe command, but the effect is generally the same.

 

Note: Some earlier Brick-HDs have smaller flash memories and there are only 4x 8M partitions. On these devices only partitions 0,1,6 and 7 are available.

 

 

flash wipe

 

Completely erase the all 8 flash memory partitions using the device erase algorithm. This could theoretically take more than 10 minutes.

 

 

flash copy <src> <dest>

 

Copy one of the 8 flash memory partitions to another partition. If the file system is mounted it can be the source but not the destination. If there are any open files in the source the copy will be corrupt although recoverable using squeeze. It's best to dismount before copying a file system partition

 

 

flash load  <bf:file>

 

Loads the contents of the bootflash file specified into the CPU flash. The CPU flash holds the code that runs on power up and boots the main operating system. It also holds the ROM Monitor that runs in the event that no operating system code can be found, or is forced to run by pressing the front panel button while the boot code starts.

 

The flash load command performs an operation that is not without risk, since a failure can result in the Brick-HD being totally un-recoverable, requiring it to be returned to Media Technologies for repair.

 

 

flash save <bf:file>

 

Copies the contents of the CPU flash to a specified file on the Bootflash volume.

 

 

vfd message "<line1>" ["<line2>"]

 

Display a message on the front panel VFD (Vacuum Florescent Display).

 

 

vfd list

 

Lists the front panel VFD menu command tree.

 

 

fsystem

 

There are a number of sub-commands to the fsystem command. These are all very low level diagnostic and test commands for the flash filing system. The following are benign and can be used, the remainder should be avoided, since if not used in the correct order can potentially lock out the filing system.

 

 

fsystem detail

 

Shows some detailed information for each of the 64 flash pages in the volume.

 

#fs det
FLASH_BASE: 800000
Pages: 64
Blocks/Page: 1000
Block size: 128

Logic Phys Used Free Dirty Erased   Base  Owned   Data
   00   00  992    0     8      0 800000 800010 800C00
   01   01 1000    0     0      0 820000 820010 820C00

 

etc...
 

Each page is 128K bytes and comprises a header and 1000 x 128 byte data blocks. A page has a logical and physical page number. Logical pages can move when dirty blocks are recovered. Each data block can be either free (contains all 0xFFs) dirty (contains random data from a deleted file) or used (contains random data from an un-deleted file).

 

The Erased column shows the number of times the page has been erased. The wear leveling algorithm will try and average out the number of times each page has been erased over time. The threshold is set to 100 so some pages may have be shown as erased 100 or so more times than others. If the volume is formatted the erased count for each page is reset to 0.

 

 

fsystem validate

 

Checks the integrity of each of the flash device pages comprising the filing system.

 

#fsystem validate
[----------------------------------------------------------------]
Total allocated blocks = 16477
#

 

Any pages that fail the integrity check are shown in the progress bar with a # instead of a - character.

 

 

fsystem file <path>

 

Displays detailed information relating to a specific file.

 

 

#fsystem file /wwwroot/index.htm
File 0xA13A80 [16:605] Size=2335 4:index.htm
000000: 0xA13B00 [16:606] 65683C ad><titl
000080: 0xA13B80 [16:607] 682061 ttp-equi
000100: 0xA13C00 [16:608] 2F7478 css">..
000180: 0xA13C80 [16:609] 3E6461 ..<body
000200: 0xA13D00 [16:610] 494C41 GN: cent
000280: 0xA13D80 [16:611] 203A4E center">
000300: 0xA13E00 [16:612] 227265 >&nbsp;<
000380: 0xA13E80 [16:613] 726574 ">&nbsp;
Extn: 0xA13F00 [16:615]
000400: 0xA13F80 [16:615] 65746E r><HR></
000480: 0xA14000 [16:616] 2F3C3E DIV><blo
000500: 0xA14080 [16:617] 3C0A0D p align=
000580: 0xA14100 [16:618] 75716B ote></bl
000600: 0xA14180 [16:619] 73756A tify; ma
000680: 0xA14200 [16:620] 656220 accurat
000700: 0xA14280 [16:621] 206F6E responsi
000780: 0xA14300 [16:622] 6E6920 formatio
000800: 0xA14380 [16:623] 702072 arameter
000880: 0xA14400 [16:624] 6F483E me Page
000900: 0xA14480 [16:625] 3C0A0D /FONT></
#
 

The first line shows the physical address on the device of the header block. This can move if the file is renamed or the filing system has to recover some dirty data blocks contained in the same page as the header. The value in square brackets is the corresponding logical address of the data block. In this case logical block 16 data block 605. Size is the size of the data in the file. The last value is the directory number and filename. The filing system supports 6 directories, root plus 5 sub-directories.

 

The lines following show the detail for each 128 byte data block and the first 3 bytes of data in hex and the first 8 bytes of data in ASCII. In this ecample all of the data blocks are in the same 128K byte page. This does not have to be the case, other pages can be used even for small files if there are no spare data blocks in the page.

 

The header can support a file with up to 8 data blocks, after that an extension data block is used to extend the allocation table. A further table in the page header keeps a mapping of data blocks to a file and their state (used, free, dirty).

 

initialise

 

Initialise (or re-intialise) the Brick-HD processor. This will re-load the FPGA code and initialise the video processes applying any saved configuration.

 

 

reset

 

Performs a software reset.

 

 

radix [<base>]

 

Set the default number radix for the shell. If no argument is supplied the radix is set to decimal. Some commands have a fixed radix, such as those requiring a memory address which will always be in hexadecimal.

 

 

unzip <file in> <file out>

 

Decompresses a file previously compressed in a Media Technologies proprietary compressed format.

 

 

ftest <file> [[[<n>] <blk>]] <loop>]

 

Creates a file filled with a test pattern. If no arguments are supplied a 100 byte file is created.

 

If n is supplied it specifies the file size in bytes.

 

If n and blk are supplied N bytes will be written in blk sized chunks, otherwise the block size defaults to the native file system block size (128 bytes).

 

if n, blk and loop are supplied, the file creation process is repeated loop times. The file has the same name, so the effect is to delete the previous file and create a new one each pass round the loop.

 

 

lookup <hostname>

 

Looks up the hostname using the configured host file then DNS server. A list of statically defined hosts can be held in a file /etc/hosts. The format for this file is

 

# comment

 

a.b.c.d       HostName

 

Any line starting with a # symbol is considered a comment and ignored. Any other none blank line is considered a host statement. It should include a IP address in dotted decimal format followed by the hostname. The hostname should not contain any spaces. Hostnames should not begin with a digit.

 

Each line of the file should be no longer than 64 characters.

 

 

more <file>

 

As cat but pauses every page for a key press.

 

 

exam [<address>[<len>]]

 

Examine the contents of memory starting at address. If no length is defined 256 bytes are displayed. If no arguments are supplied address is set to the next block following on from the end of the last block displayed.

 

 

fill <start> <end> <n>

 

File the memory block from address start through to end with the fill byte n.

 

 

fc <file1> <file2>

 

Compare the contents of two files. This is a simple comparison with a pass/fail result.

 

 

send <device> <id> <fn> ...

 

Send a Media Technologies Control Protocol message to the selected device. For the Brick-HD, device should be 7. The function code

numbers (byte 3) can be determined using the command "show message".

 

e.g. to send a MTCP message to Brick-HD with the id 0 to set a split of 2

 

send 7 0 40 2

 

If unit id 0 is the local device it will be processed locally, otherwise the message will be sent out of the Loop RS-232 port.

 

 

mount

 

Mounts the flash volume. This is normally done on start-up automatically. (See also dismount).

 

 

dismount

 

Un-mount (dismount) the flash volume.

 

 

ls [-lr] [<path>]

dir [-lr] [<path>]

 

Lists the contents of a directory. If path is "bf:" the contents of the bootflash volume will be listed, otherwise the A volume is assumed. The -l switch lists each file one per line with additional information. The -r switch will cause recursive listing of sub-directories. If a filename is supplied, which may include wildcard characters * and ? the output will be filtered using it.

 

 

rename <[path/]oldfile> <newfile>

 

Rename a file. To rename a file in the Bootflash: volume the path part of the old filename should be bf: e.g.

 

rename bf:hdvw.bin hdvw.old

 

otherwise the flash volume is assumed.

 

Relative paths are not supported. Files cannot be moved from one directory to another by renaming them.

 

 

copy <source file> <destination file>

 

Copies a file from a source volume/directory to a destination volume/directory with optionally a new filename. To use the source filename as the destination filename, omit the destination filename.  e.g.

 

copy /sequence/test.sfb bf:test.sfb

copy test.sfb /usr/example.sfb

copy /usr/example.sfb bf:

copy /usr/example /etc

 

Relative paths are not supported. Effectively all copy commands are issued with the current working directory set to root.

 

 

rmdir <name>

 

Remove a directory.

 

 

mkdir <name>

 

Create a (sub-)directory.  

 

 

 

delete <[path/]match>

 

Deletes files matching the match string. Match can include ? to match individual characters or * for all characters between start/end or dot separator, e.g.

 

delete *.sfb delete bf:hdvw.bin

 

 

[no] debug <type> [{on|off}]

 

Enable or disable debugging a selected feature. To get a list of features that can provide debug output enter show debug.

 

 

run {<'c'>|<nnn>|<fname.sfb>}

 

Run a binary sequence file loaded into the /sequence directory. The filename can be supplied directly as an argument or alternatively a single character (enclosed in single quotes) or it's ASCII value expressed as a decimal number. In the later cases, the character or decimal number is used to lookup a reference from the file seqmap.conf in the /sequence directory.

 

 

stop

 

Stops a sequence file that is currently running (if any).

 

 

skip

 

Cause a sequence file pending a wait command to stop waiting and step onto the next statement.

 

 

decode [-d] <file> [<rate>]

 

Decode a binary sequence file (.sfb). If the -d switch is used the raw bytes are displayed as well as the decode. If a rate is supplied, this is used as the initial assumed refresh rate for the decode.

 

 

sleep <s>

 

Causes the console session to pause for s seconds.

 

 

remark ["text...."]

 

Echoes the text following the command to the console. If the text contains spaces it should be bounded in double quotes. 'C' style escape sequences are supported,

 

\n Line feed
\r  Carriage return
\bBackspace
\t  Tab
\\Backslash

 

 

cat [<path/>]<filename>

type [<path/>]<filename>

 

List the contents of a text file on the console.

 

 

input [<path/>]<filename>

 

Copy console input to the named file. Use ^Z to end. Text is written line by line, so if entered by hand (rather than cut and paste via a terminal emulator) each line can be edited before return is pressed.

 

 

format [ bf:]

 

Format either the Flash (no argument) or Bootflash: (bf: or bootflash: argument) volume.

 

 

squeeze [bf:]

 

Recover wasted space from a flash volume. If the volume name is not specified then the normal flash filing system will be squeezed. If the bf:  (or bootflash: in full) argument is supplied the bootflash volume will be squeezed.

 

When a file is deleted from the bootflash volume it marked as deleted, but the space it occupies is not available to be re-used. Similarly when a file is renamed, a new header is created but the old header space is not released. Squeezing the bootflash volume reformats a spare flash page, copies un-deleted bootflash: files to it, re-assigns the bootflash: volume to the new page and erases the old page.  As each  non-blank128K flash data block is copied a dot is displayed on the terminal

 

In the case of the conventional flash filing system, there is no need to squeeze the volume to recover dirty data blocks from deleted files as this will be done on demand. It is perhaps similar to the hard disk process of de-fragmentation. If this command is used, all dirty blocks and space from files that were not properly closed will be recovered.

 

A progress bar will be displayed  as the Flash volume is squeezed. Pages that have dirty blocks recovered are shown with a # character

 

#sq
[#------------#-#-----------------------------------------------]

#
 

 

chksum <file>

 

Calculate a file checksum.

 

 

dump <file>

 

Dumps the contents of a file in hexadecimal format. File can be on either the flash volume.

 

 

attach

 

Connects a user’s console session to the loop RS232 port. This also sets the serial port to isolated (non-bussed) mode. Characters input from the console are sent out of the loop port. Characters received from loop port are echoed on the console. To exit from this mode enter ^Z (control Z).

 

 

boot <file>

 

Boots a Brick-HD processor firmware application using the file named stored on the bootflash volume.

 

 

xsvf [[args] <file>]

 

Executes the Xilinx xsvf player to load code into the FPGAs. The xsvf file must be located in the Bootlflash: volume. To obtain a list of optional arguments in addition to the filename, enter xsvf without any arguments.

 

 

who

 

Lists the currently connected users with details of their session.

 

 

passwd

 

Change the current users account password.

 

 

login

 

Login with a different username.  Useful for testing user accounts.

 

 

telnet <host>

 

Telnet to host. Host can be a DNS name if a DNS server has been configured or a dotted decimal IP address.  TCP/IP port 23 is assumend.

 

exit

 

Exits from the console session.

 

In the case of a Telnet session the command will drop the connection and log the user off.

 

If the console session is via the host serial port it will cause the console to drop into character sequence mode. To return to a console session from this mode, enter return 4 times.

 

 

xmodem <filename>

 

Transfer a file from a host to the Brick-HD via the host serial port using the XMODEM protocol.

 

 

 

ping <host> [<count>]

 

Ping host. Host can be a DNS name if a DNS server has been configured or a dotted decimal IP address. <count> ICMP echo requests are sent to host with the result displayed for each echo request. If count is not supplied it defaults to 5. Ping can be aborted by pressing ^C. 

 

 

wget URL  [<file>|-]

 

Uses an HTTP get to read the file specified in URL and save it to a local file. If an explicit local file is not specified in argument 2, the file is derived from the path of the URL and saved in flash in the /usr directory. The local file can be either flash or bootflash: In the case of bootflash the operation will fail if the file already exists. Flash files will be overwritten. If there is an error in the download no file will be saved. This means that if a file already existed prior to the download and was to be replaced and the download failed the existing file will be deleted.

 

If the local file is preceded with a dash (-) or consists just a dash character, the file will not be written to Flash. This allows wget to be used to submit "cgi-bin" type URLs with arguments that don't really load a file at all but execute a command on the server.

 

The URL format is (items in square brackets are optional)

 

         [http://][auth@]host[:port]/[path/]file[?args...]

 

 

The HTTP:// prefix is optional, HTTP is always assumed. No other protocol is supported. The auth part (username:password) can be supplied but will be ignored. Currently the firmware does not support any type of HTTP authentication.

 

The host name is required. This can be either a fully qualified domain name (FQDN) or a dotted decimal IP address. If an FQDN is used DNS must be configured and operational. If the host port is not provided, port 80 is assumed.

 

The remainder of the URL specifies the location of the resource on the host with optional arguments. This can be just a filename if the file is located in the root directory of the server.

 

 

 

?

 

As a command lists all of the top level command word.  ? can also be used as an argument, e.g.

 

#enable ?

  dvi                                           - ...

  keypad                                        -     Enable keypad power

  loop                                          -     Enable RS232 loop through

#enable dvi in ?

enable dvi input   - Enable DVI input hotplug

 

 

??

 

As a command lists all commands recursing down the command tree. Used as an argument it does the same to the selected part of the command tree e.g.

 

#enable ??

   dvi

     input                                      - (M) Enable DVI input hotplug

     output [<ch>]                              - (M) Enable DVI output

   keypad                                       -     Enable keypad power

   loop                                         -     Enable RS232 loop through

 

The full list of shell commands listed using ?? are shown below. Each successive command word in a command is shown indented. Some commands can be negated by preceding them with the word no. These are commands a shown preceded by [no]. Some commands have a alias e.g. ls and dir are the same. The alias is shown prior to the real command in curved brackets. Commands that can be embedded in an MTCP message  (function code 1 - FN_COMMAND) are shown with a (M) in the command comment.

 

   show
     dvi
       input                                    -     Show I/P status
       power                                    -     Show DVI O/P voltage
       output [<ch>|summary]                    -     Show O/P DVI & EDID status
     video
       output [<ch>]                            -     Show video output channel states
       input                                    -     Show video input status
       modes                                    -     Show video input modes
     clock                                      -     Show clock (date & time)
     version                                    -     Show version
     environment                                -     Show environment temp/voltages
     configuration                              -     Show base configuration
     options                                    -     Show option bit allocation
     debug                                      -     Show debug enabled
     memory                                     -     Show memory usage
     interface                                  -     Show Ethernet I/F info
     bootflash                                  -     Show bootflash
    (BF:)                                       -     Show bootflash
     info <file>                                -     Show bootflash executable info
     edid [<file>]                              -     Show edid file or DVI default
     message [-d][<fn>]                         -     Show WallCP message codes
     volume                                     -     Show volume data
     alignment [<x> [<y>]]                      -     Show magnification alignment
     process                                    -     Show process info
     sequence [*]                               -     Show running sequence / all
     queue                                      -     Show MTCP session/queues
     keypad                                     -     Show keypad power
     logging                                    -     Show logging configuration
     dimensions                                 -     Show configured alignment dimensions
  (rd)
   read
     io <addr> [wait]                           -     Read from IO address
     i2c <addr> [<sub-addr> [<len>]]            -     Read from I2C reg(s)
     fpga <ch|*> <reg> [<n>]                    -     Read O/P FPGA registers
   write
     io <addr> <data> [<wait]]                  - (M) Write to IO addr
     i2c <addr> [<sub-addr>] <data>...          - (M) Write to I2C reg(s)
     fpga <ch|*> <reg> <data>                   - (M) Write to OP FPGA
     mux <reg> <n> [<n>...]                     - (M) Write to I/P mux
   set
     ip
       dns
         server <addr>                          - (M) Set DNS server IP address
       sntp
         server <addr>                          - (M) Set SNTP server IP address
       address <addr> <mask>                    - (M) Set IP address
       gateway <addr>                           - (M) Set gateway address
       dhcp {ON|OFF}                            - (M) Enable/Disable DHCP on startup
     eth
       mac {<nn:nn:nn:nn:nn:nn>|<S/N>}          -     Set MAC address
     service
       telnet {ON|OFF}                          - (M) Enable/Disable Telnet server
       http {ON|OFF}                            - (M) Enable/Disable HTTP server
       tftp {ON|OFF}                            - (M) Enable/Disable TFTP server
       mtcp {ON|OFF}                            - (M) Enable/Disable MTCP server
     vfd
       brightness <0..3>                        - (M) Set VFD brightness
       timeout <time (s)>                       - (M) Set VFD idle timeout
     alignment
       row <split> <row> <off> [<off>...]       - (M) Set row alignment
       column <split> <col> <off> [<off>...]    - (M) Set column alignment
       pan
         row <split> <offset>                   - (M) Pan row alignment
         column <split> <offset>                - (M) Pan column alignment
       zoom
         row <split> <offset>                   - (M) Zoom row alignment
         column <split> <offset>                - (M) Zoom column alignment
     video
       input
         dvi [<std>]                            - (M) Set input to DVI
         YPrPb [<std>]                          - (M) Set input to YPrPb
         cvbs                                   - (M) Set input to Composite
         s-video                                - (M) Set input to S-Video
         automode {ON|OFF}                      - (M) Set automatic video mode
       output
         DVI                                    - (M) Set output to DVI
         YPrPb                                  - (M) Set output to YPrPb
         RGB                                    - (M) Set output to RGB
         position <ch> {Rc|<row> <col>}         - (M) Map O/P channel to array position
         wash {<ch>|*} {ON|OFF} [r g b]         - (M) Set O/P channel colour wash
         filter
           off [<ch>]                           - (M) Set output filter Off
           horizontal [<ch>]                    - (M) Set output filter On - Horizontal
           vertical [<ch>]                      - (M) Set output filter On - Vertical
           on [<ch>]                            - (M) Set output filter On - Both
     freeze
       on                                       - (M) Set freeze on
       off                                      - (M) Set freeze off
     syncloss
       colour <r> <g> <b>                       - (M) Set sync loss colour
     host
       baudrate [1200..56000]                   - (M) Set host baudrate at start-up
     loop
       baudrate [1200..56000]                   - (M) Set loop baudrate
     keypad [<ON|OFF>]                          - (M) Set keypad On/Off at start-up
     bezel <dx dy>|<x1 y1 x2 y2>                - (M) Set bezel size
     partition <a>                              - (M) Set FS flash partition (0..5)
     idle
       timeout <timeout> [<id>]                 - (M) Set user session idle timeout
     date <dd-MMM-yr>                           - (M) Set date, e.g 01-MAR-10
     time <hr:mm:ss>                            - (M) Set time
     id <id>                                    - (M) Set unit ID
     zone <offset>                              - (M) Set timezone +/- hrs GMT
     boot <file>                                - (M) Set boot file from bootflash:
     fpga <file>                                - (M) Set fpga file from bootflash:
     secret <file>                              - (M) Set MTCP shared secret
     debug <name> {ON|OFF}                      - (M) Set start-up debug state
     priority <thr> <pri>                       -     Set thread priority
     split <x> [<y>]                            - (M) Set X,Y magnification
     dimensions <dx> <dy>                       - (M) Set X,Y dimensions
    (resolutions) <dx> <dy>                     - (M) Set X,Y dimensions
     options <options>                          - (M) Set start-up option reg 00..FF
   clear
     setting
       video
         input                                  - (M) Clear video input settings
         output                                 - (M) Clear video output settings
       alignment                                - (M) Clear alignment settings
       all                                      - (M) Clear all settings
     configuration                              - (M) Clear base configuration
     alignment                                  - (M) Clear all alignment settings
     debug                                      - (M) Clear debug flags for all users
   user
     add <name> <passwd> [<priv>]               - (M) Add a user A/C
     delete <name>                              - (M) Delete a user A/C
     disconnect <id>                            - (M) Disconnect a user
     list                                       -     List user A/C
   test
     mode
       off                                      - (M) Set test mode off
       hatch                                    - (M) Set hatch test mode
       dots                                     - (M) Set dots test mode
       prbs                                     - (M) Set prbs test mode
       cursor                                   - (M) Set cursor test mode
     ram <start> <end>                          -     Test RAM block
     fpga [<ch>]                                -     Test O/P FPGAs
     encoders                                   -     Test O/P encoders
     cursor <x> <y>                             - (M) Set test cursor position
     colour <r> <g> <b>                         - (M) Set test colour
     box <x1> <y1> <x2> <y2> [<r> <g> <b>]      - (M) Show area bounding box
   enable
     dvi
       input                                    - (M) Enable DVI input hotplug
       output [<ch>]                            - (M) Enable DVI output
     keypad                                     -     Enable keypad power
     sntp <mode>                                - (M) Enable SNTP thread
     loop                                       -     Enable RS232 loop through
   disable
     dvi
       input                                    - (M) Disable DVI input hotplug
       output [<ch>]                            - (M) Disable DVI output
     keypad                                     -     Disable keypad power
     sntp                                       - (M) Disable SNTP thread
     loop                                       -     Disable RS232 loop through
   tftp
     dir <host>                                 -     List TFTP server files
     get <host> <rem_name> [<lcl_name>]         - (M) Get file via TFTP
     put <host> <lcl_name> [<rem_name>]         - (M) Put file via TFTP
   map
     sequence {nnn|'c'} [<file>]                - (M) Add/Del char to .sfb file mapping
   load
     dvi
       edid {<file>|<ch#>} [<dly>]              - (M) Load new DVI input EDID table
     video
       input [file]                             - (M) Load and set video I/P config
       output [file]                            - (M) Load and set video O/P config
     alignment [file]                           - (M) Load and set video alignment
   list
     video
       input                                    -     List video in settings
       output                                   -     List video out settings
     base                                       -     List base configuration
     alignment                                  -     List alignment settings
     all                                        -     List all settings
   logging
     [no] prompt                                - (M) Debug prompt re-print
     [no] loop                                  - (M) Debug messages out of loop port
     [no] syslog                                - (M) Debug messages to syslog
     restart                                    - (M) Restart syslog client
     severity <level>                           - (M) syslog severity level
   terminal
     [no] monitor                               -     Log messages to terminal
   save
     video
       input [<file>]                           - (M) Save video input settings
       output [<file>]                          - (M) Save video output settings
     edid [-h|f] {<ch#|file>} <file>            - (M) Save output EDID table in file
     alignment [<file>]                         - (M) Save video alignment
     settings                                   - (M) Save all current video settings
   flash
     dump <addr>                                -     Dump flash data
     write <addr> <nn>[ <nn>...]                -     Write to flash device
     info                                       -     Show flash memory info
     erase [<page>]                             -     Erase flash page(s)
     wipe                                       -     Wipe flash memory
     copy <src> <dest>                          -     Copy src to dest partition
     load <bf:file>                             -     Load CPU flash from Bootflash
     save <bf:file>                             -     Save CPU flash to bootflash
   vfd
     message <"line1"> [<"line2">]              - (M) Show message on VFD
     list                                       -     List VFD menu options
   fsystem
     detail <page>                              -     Show file system detail
     validate                                   -     Validate file system
     file <name>                                -     File data block info
     open
       read <name>                              -     File open RD
       write <name>                             -     File open WR
       append <name>                            -     File open APP
     read <name> <size>                         -     File data read
     write <name> "data"                        -     File data write
     close <name>                               -     File close
     list                                       -     List open files
   initialise [<attempts>]                      - (M) (Re-)initialise processor
   reset                                        - (M) Reset processor
   radix [<base>]                               - (M) Set default radix
   unzip <in> <out>                             - (M) Un-compress a file
   ftest <file> [[[<n>] <blk>]] <loop>]         -     Write n bytes to file in blk size chunks
   lookup <host>                                -     DNS lookup
   more <file>                                  -     List a file
   exam [<addr>[<len>]]                         -     Examine memory
   fill <start> <end> <n>                       - (M) Fill memory
   fc <file1> <file2>                           -     Compare files
   send <dev> <id> <fn> ...                     - (M) Send MTCP message
   mount <bank>                                 - (M) Mount filesystem
   dismount                                     - (M) Un-mount filesystem
  (dir) [-lR] [<path>...]                       -     List directories/files
   ls [-lR] [<path>...]                         -     List directories/files
   rename <[path/]old> <new>                    - (M) Rename a file
  (cp) <src> <dest>                             - (M) Copy src file to dest
   copy <src> <dest>                            - (M) Copy src file to dest
   rmdir <path>                                 - (M) Delete a directory
   mkdir <path>                                 - (M) Make a directory
  (rm) <file>                                   - (M) Delete a file
   delete <file>                                - (M) Delete a file
   [no] debug <type> [{on|off}]                 -     Enable/disable debug O/P
   run {'c'|<nnn>|fname.sfb}                    - (M) Run sequence
   stop                                         - (M) Stop any running sequence
   skip                                         - (M) Skip sequence wait state
   decode [-d] <file> [<rate>]                  -     Decode .SFB file
   sleep <s>                                    -     Sleep for s seconds
   remark "remark..."                           -     Echo remark to console
  (type) <file>                                 -     Type a file
   cat <file>                                   -     Type a file
   input <file>                                 -     Input from console to file
   format [bf:]                                 -     Format filing system/bootflash
   squeeze [bf:]                                - (M) Squeeze bootflash
   checksum <file>                              -     Calculate file checksum
   dump <file>                                  -     Dump file in hex
   attach                                       -     Attach console to Loop port
   boot <file>                                  - (M) Boot system from bootflash:fname
   xsvf [args] <file>                           - (M) Xilinx xsvf player
   who                                          -     List console users
   passwd                                       - (M) Change password
   login                                        - (M) Log in with different username
   telnet <host/addr>                           -     Telnet to address
   exit                                         -     Exit from user session
   xmodem <bf:file>                             -     Rx file using XMODEM protocol
   ping <host/addr> [<count>]                   -     Ping address count times
   wget URL [<file>|-]                          - (M) Get file via HTTP

 


The information in this document is believed to be accurate in all respects at the time of printing, but is subject to change without notice. Media Technologies Ltd assumes no responsibility for any errors or omissions, and disclaims responsibility for any consequences resulting from the use of the information included herein. Additionally, Media Technologies Ltd assumes no responsibility for the functioning of features or parameters not described.


Help file version 1.6 [23-Feb-2011] © Media Technologies Ltd.