Difference between revisions of "Dsp cmd"

From MCEWiki
Line 1: Line 1:
 
{{Hierarchy header}}
 
{{Hierarchy header}}
In case of communication loss with MCE when a proper command packet may not be recognized, use the following command to reset the  
+
'''dsp_cmd''' can be used to interact with the [[PCI fibre card]] DSP program directly.  It makes screwing up the fibre card program and/or your PCI bus simple.  Use with caution.
MCE by sending a special character over the fibre:
 
  
  dsp_cmd -x reset_mce
+
== Usage ==
 +
  dsp_cmd [-i] [-q] [-p] [-n CARD] [-f FILE | -x COMMAND]
 +
dsp_cmd [-h | -?]
 +
 +
where:
 +
  -h / -?    show this help screen
 +
  -i        interactive mode
 +
  -q        quiet mode (report errors only)
 +
  -p        don't prefix output lines
 +
  -f FILE    read commands from FILE
 +
  -n CARD    communicate with PCI fibre card number CARD.  Ignored unless [[Multicard MAS]] has been enabled.
 +
  -x COMMAND execute command COMMAND
  
To reset the PCI card, issue:
+
== Commands ==
 
+
COMMAND is one of (case insenstive):
  dsp_cmd -x reset
+
* '''VERS''': Report the version number of the DSP code.  Syntax is:
 +
VERS
 +
* '''READ''': Read data from the DSP memory banks.  Syntax is:
 +
READ bank addr
 +
:where
 +
:* <tt>bank</tt> is the memory bank to read, one of '''X''', '''Y''', '''P'''
 +
:* <tt>addr</tt> is the memory address
 +
* '''WRITE''': Write data to the DSP memory banks.  Syntax is:
 +
WRITE bank addr value
 +
:where
 +
:* <tt>bank</tt> is the memory bank to write, one of '''X''', '''Y''', '''P'''
 +
:* <tt>addr</tt> is the memory address
 +
:* <tt>value</tt> is the datum to write
 +
* '''RESET''': Reset the DSP program.  This is equivalent to the [[dsp_reset]] command in [[mce_cmd]].  Syntax is:
 +
RESET
 +
* '''RESET_MCE''': Reset the MCE.  This is equivalent to the [[mce_reset]] command in [[mce_cmd]].  Syntax is:
 +
RESET_MCE
 +
* '''QT_SET''': Set a QT (quiet transfer) mode parameter. Syntax is:
 +
QT_SET param value
 +
:where
 +
:* <tt>param</tt> is the parameter to set, one of '''BASE''', '''DELTA''', '''NUMBER''', '''INFORM''', '''SIZE''', '''TAIL''', '''HEAD''', '''DROPS''', '''FLUSH''', '''ENABLE''', '''BURST'''
 +
:* <tt>value</tt> is the parameter value to write
  
 
== See also ==
 
== See also ==
* [[dsp_status]]
+
* [[dsp_status]] for a general status report from the fibre card
* [[PCI card hacking]]
+
* [[PCI card hacking]] for examples of dsp_cmd use.
  
 
[[Category:Software]]
 
[[Category:Software]]

Revision as of 17:14, 6 December 2012

Template:Hierarchy header dsp_cmd can be used to interact with the PCI fibre card DSP program directly. It makes screwing up the fibre card program and/or your PCI bus simple. Use with caution.

Usage

dsp_cmd [-i] [-q] [-p] [-n CARD] [-f FILE | -x COMMAND]
dsp_cmd [-h | -?]

where:
 -h / -?    show this help screen
 -i         interactive mode
 -q         quiet mode (report errors only)
 -p         don't prefix output lines
 -f FILE    read commands from FILE
 -n CARD    communicate with PCI fibre card number CARD.  Ignored unless Multicard MAS has been enabled.
 -x COMMAND execute command COMMAND

Commands

COMMAND is one of (case insenstive):

  • VERS: Report the version number of the DSP code. Syntax is:
VERS
  • READ: Read data from the DSP memory banks. Syntax is:
READ bank addr
where
  • bank is the memory bank to read, one of X, Y, P
  • addr is the memory address
  • WRITE: Write data to the DSP memory banks. Syntax is:
WRITE bank addr value
where
  • bank is the memory bank to write, one of X, Y, P
  • addr is the memory address
  • value is the datum to write
  • RESET: Reset the DSP program. This is equivalent to the dsp_reset command in mce_cmd. Syntax is:
RESET
  • RESET_MCE: Reset the MCE. This is equivalent to the mce_reset command in mce_cmd. Syntax is:
RESET_MCE
  • QT_SET: Set a QT (quiet transfer) mode parameter. Syntax is:
QT_SET param value
where
  • param is the parameter to set, one of BASE, DELTA, NUMBER, INFORM, SIZE, TAIL, HEAD, DROPS, FLUSH, ENABLE, BURST
  • value is the parameter value to write

See also