EV-2 Datasheet, PDF (38/44 Pages) Cirrus Logic – Digital Audio Networking Processor

CobraNet™ EV-2
Appendix E: EV-2 Command Line Interface.
The EV-2 supports a simple command line interface (CLI). This interface allows the user to eval-
uate the CobraNet module (CM) and monitor and control Host Management Interface (HMI) vari-
ables. A list and description of commands follow. Please reference the CobraNet Programmer’s
Manual for more information about the HMI variables. Please note that there is a significant dif-
ference between the CM-1 and CM-2 HMI variable format, i.e. how the raw data is stored in the
CM’s memory. Refer to the CobraNet Programmer’s Manual regarding the HMI variable formats.
Command line Syntax
The CLI is case insensitive, either upper or lower case in any combination may be used. Param-
eters enclosed within < > are mandatory with a few exceptions. At least one white space is
required between command and parameters. Leading, lagging and multiple white spaces are
ignored. A “ctrl-C” or “esc” will abort a command. With exceptions where noted, all numeric val-
ues are to be entered or will be displayed in hexadecimal format with a leading “0x”.
This command line interface allows the user to write scripts (i.e Python scripts) that monitor and
control HMI variables. Two commands are supported that allow the user to perform these tasks:
Peek <target> [offset]
This command will return the value at the given address location or the value of the HMI variable.
<target> – a valid host address. The format of <target> is a hexadecimal number with a “0x” pre-
fix.
Example: peek 0xAB12C5
<target> – the user may use an HMI variable.
Example: peek sysdescr
In this example the CLI will return the system description in its entirety.
[offset] – optionally used with HMI array variables only. Offset into the HMI array. If not present
on an HMI array variable, the peek will return a value for the first location in the array.
Example: peek txBundle 0x1000
The above example will peek location 0x51100 or transmitter #1.
Example: peek rxSubMap 0x2005
This example will peek location 0x42005 or receiver #2, channel #5.
Rev. 2.1
38