help.c

gdb for adsp develop

static char _[] = "@(#)help.c	5.22 93/08/23 15:30:33, Srini, AMD.";
/******************************************************************************
 * Copyright 1991 Advanced Micro Devices, Inc.
 *
 * This software is the property of Advanced Micro Devices, Inc  (AMD)  which
 * specifically  grants the user the right to modify, use and distribute this
 * software provided this notice is not removed or altered.  All other rights
 * are reserved by AMD.
 *
 * AMD MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS
 * SOFTWARE.  IN NO EVENT SHALL AMD BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL
 * DAMAGES IN CONNECTION WITH OR ARISING FROM THE FURNISHING, PERFORMANCE, OR
 * USE OF THIS SOFTWARE.
 *
 * So that all may benefit from your experience, please report  any  problems
 * or  suggestions about this software to the 29K Technical Support Center at
 * 800-29-29-AMD (800-292-9263) in the USA, or 0800-89-1131  in  the  UK,  or
 * 0031-11-1129 in Japan, toll free.  The direct dial number is 512-462-4118.
 *
 * Advanced Micro Devices, Inc.
 * 29K Support Products
 * Mail Stop 573
 * 5900 E. Ben White Blvd.
 * Austin, TX 78741
 * 800-292-9263
 *****************************************************************************
 *      Engineer: Srini Subramanian.
 *****************************************************************************
 **       This file contains the help screens for the monitor.
 *****************************************************************************
 */

/*
** Main help
*/

char *help_main[] = {

"Use 'h <letter>' for individual command help",
" ",
" --------------------- MONDFE Monitor Commands -----------------------------",
" a - Assemble Instruction        | b,b050,bc - Set/Clear/Display Breakpoint",
" c - Print Configuration         | caps - DFE and TIP Capabilities",
" cp - Create UDI Process         | con - Connect to a UDI Debug Session",
" ch0 - 29K Terminal Control      | d,dw,dh,db,df,dd - Dump Memory/Registers",
" dp - Destroy UDI Process        | disc - Temporarily Disconnect UDI Session",
" ex - Exit UDI Session           | esc - Escape to Host Operating System",
" eon - Turn Echo Mode ON         | eoff - Turn Echo Mode OFF",
" g - Start/Resume Execution      | f,fw,fh,ff,fd,fs - Fill Memory/Registers",
" h - Help Command                | init - Initialize Current UDI Process",
" ix,il - Display Am2903X Cache   | k - Kill Running Program on 29K Target",
" logon - Turn ON log mode        | logoff - Turn OFF log mode",
" l - List/Disassemble Memory     | m - Move Data to Memory/Registers",
" pid - Set UDI Process ID        | q - Quit mondfe",
" qon - Turn Quiet Mode ON        | qoff - Turn Quiet Mode OFF",
" sid - Set UDI Session ID        | r - Reset (software reset) 29K Target",
" t - Trace/Single Step Execution | s,sw,sh,sb,sf,sd - Set Memory/Registers",
" ver - Montip Version Command    | tip - Montip Transparent Mode Command",
" y - Yank/Download COFF File     | xp - Display Protected Special Registers",
" ze - Echo File For Echo Mode    | zc - Execute commands from command file",
" zl - Use log file for log mode  | | - Comment character (in Command File)",
" ----------------------------------------------------------------------------",
""
};


/*
** Assemble
*/

char *help_a[] = {

"A <address> <instruction>",
" ",
"Assemble instructions into memory.",
" ",
"The address, is the memory address for the instruction.",
" ",
"The instruction will be assembled and placed in memory at the",
"specified address.",
" ",
"Memory addresses:",
" ",
"<hex>m - data memory             <hex>i - instruction memory",
"<hex>r - rom memory              <hex>u - unspecified (no addr check)",
""
};


/*
** Breakpoint
*/

char *help_b[] = {

"Breakpoint display, set and clear.",
" ",
"B - displays valid breakpoints",
"B <address> [<passcount>]  - to set  software breakpoint",
"B050[P,V] <address> [<passcount>]  - to set Am29050 hardware breakpoint",
" When B050P is used, breakpoint is hit only if translation is disabled.",
" When B050V is used, breakpoint is hit only if translation is enables.",
"A breakpoint is set at the specified address.  An optional",
"<pass count> sets the pass count.  The B050 command sets",
"a breakpoint using an Am29050 breakpoint register. ",
"BC <address> - to clear the breakpoint set at <address>",
"BC - clears all breakpoints.",
" ",
"<address> format:",
" ",
"<hex>m - data memory              <hex>i - instruction memory",
"<hex>r - rom memory               <hex>u - unspecified (no addr check)",
" B Command usage: B, B050, B050V, B050P",
""
};


/*
** Configuration help
*/

char *help_c[] = {

"C - Prints target system configuration.",
" ",
"This command is used to read and display the target configuration.",
"A banner is printed displaying information about the target.",
" ",
" Other C commands: CAPS, CP, CON, CH0",
""
};

char *help_caps[] = {
" CAPS - Prints UDI capabilities of DFE and TIP",
" This prints the DFE version number, TIP version number, and UDI revision.",
""
};

char *help_cp[] = {
"CP - Create a UDI Process.",
" This sends a request to the TIP to create a new process.",
""
};

char *help_con[] = {
"CON <session_id>- Requests connection to UDI TIP running <session_id>.",
" This connects to the debug session specified by <session_id>.",
""
};

char *help_ch0[] = {
" CH0 - Transfers control of the terminal to the 29K target.",
" This is used to transfer control to the 29K target program.",
" The input characters typed are sent to the TIP without interpreting",
" for a mondfe command. Control is transferred to mondfe when a Ctrl-U",
" is typed.",
""
};
/*
** Dump
*/

char *help_d[] = {

"D[W|H|B|F|D] [<from_address> [<to_address>]]",
" ",
"Display memory or register contents.",
" ",
"DW or D - display as words.           DF - display in floating point.",
"DH      - display as half-words.      DD - display in double precision",
"DB      - display as bytes.                floating point.",
" ",
"<from_address> defaults to address last displayed.  The ",
"<to_address> is the address of the last data to display.  The default",
"is about eight lines of data.",
" ",
"Valid register names:",
"gr0-gr1, gr64-gr127 - global register names",
"sr0-sr14, sr128-sr135, sr160-sr162,sr164 - special register names",
"lr0-lr127 - local register names ",
"tr0-tr127 - TLB register names ",
"<address> format:",
" ",
"<hex>m - data memory                  <hex>i - instruction memory",
"<hex>r - rom memory                   <hex>u - unspecified (no addr check)",
" D Command usage: D, DW, DH, DB, DF, DD",
" Other D Commands: DP, DISC",
""
};


char *help_dp[] = {
" DP - Destroy process.",
" This requests the TIP to destroy a UDI process. ",
""
};

char *help_disc[] = {
" DISC - Disconnect from the debug session.",
" This disconnects the DFE from the current debug session. The TIP is",
" not destroyed and left running for later reconnections.",
""
};
/*
 * Escape command
 */

char	*help_e[] = {
"ESC",
" ",
"Temporarily exit to host operating system.",
"Use EXIT command to resume debug session.",
"Other E commands: EON, EOFF",
""
};

char	*help_ex[] = {
" EX - Exit current debug session.",
" This command can be used to exit from a debug session when done. Mondfe",
" looks for another session in progress and connects to that session. If",
" there are no more debug sessions in progress, this command causes Mondfe",
" to quit, i.e. it has the same effect as the Quit command",
""
};

char	*help_esc[] = {
"ESC",
" ",
"Temporarily exit to host operating system.",
"Use EXIT command to resume debug session.",
"Other E commands: EON, EOFF",
""
};

char *help_eon[] = {
" EON and EOFF can be used to turn echo mode ON and OFF during the",
" interactive debug session. Echo mode is specified by using the -e ",
" mondfe command line option and an file name. During echo mode, everything",
" displayed on the screen are captured in the file specified.",
""
};

/*
** Fill
*/

char *help_f[] = {

"F[W|H|B|F|D] <start address>, <end address>, <value>",
" ",
"Fill memory or register contents.",
" ",
"FW or F - fill as 32-bit integers  |    FF - fill as floating point value.",
"FH      - fill as 16-bit integers  |    FD - fill as double precision",
"FB      - fill as 8-bit integers   |    floating point value.",
"FS      - fill with the string/pattern given.",
" ",
"Valid register names:",
"gr0-gr1, gr64-gr127 - global register names",
"sr0-sr14, sr128-sr135, sr160-sr162,sr164 - special register names",
"lr0-lr127 - local register names ",
"tr0-tr127 - TLB register names ",
" ",
"<address> format:",
" ",
"<hex>m - data memory               <hex>i - instruction memory",
"<hex>r - rom memory                <hex>u - unspecified (no addr check)",
" F command usage: F, FW, FH, FB, FD, FS",
""
};


/*
** Go
*/

char *help_g[] = {

"G - Start program execution",
" ",
"This resumes program execution at the next instruction.",
" The program runs either until completion or until it hits a breakpoint",
" It is used to run the downloaded program and to resume after hitting",
" a breakpoint. The trace command can be used to execute a specified",
" number of instructions.",
""
};


/*
** I    (ix, ia, il)
*/

char *help_i[] = {
"IX, IL -  Display/Disassemble Am2903X cache registers",
" ",
"Display/Disassemble 2903x cache registers by bit field name.",
" I Commands: IX, IL ",