The ARM Symbolic Debugger (armsd)
---------------------------------


About armsd
...........

<armsd> can be used to debug programs assembled or compiled using <armasm> (the 
ARM Assembler), and <armcc> (the ARM C compiler), if those programs have been 
produced with debugging enabled. A limited amount of debugging information can 
be produced at link time, even if the object code being linked was not compiled 
with debugging enabled.  <armsd> is normally used to run ARM Image Format 
images.

See "<The ARM C Compiler (armcc)>", "<The ARM Assembler 
(armasm)>" and "<The ARM Linker (armlink)>" starting on page
19 for more information on the generation of debugging data.

Note that from release 1.5 of the software tools, <pisd> has been combined with 
<armsd> in a single tool, <armsd>.


Command Line Options
....................

Invoke <armsd> using the command:

    armsd {<options>} <image-name> {<arguments>}

The options are listed below. Upper-case is used to show the allowable 
abbreviations. 

    -Help       Give a summary of the <armsd> command line options;

    -Size <n>   Specify the minimum memory size required for the image being 
                debugged.  <n> may be prefixed by 0x for hex values, and 
                suffixed with either K or M to specify KB or MB respectively.  
                It should be noted that whether this option actually does 
                anything or not is dependent on the user supplied memory model 
                linked in with armsd.  For more information about these see "
                <Memory Models>" of the Reference Manual.

    -Little     Specify that memory should be little endian;

    -Big        Specify that memory should be big endian;

    -SErial     Specify that armsd should act as a front end to the Platform 
                Independent Evaluation Card (-SErial and -Armul are mutually 
                exclusive);

    -Armul      Specify that armsd should act as a front end to the software 
                ARM emulator, ARMulator (-SErial and -Armul are mutually 
                exclusive);

    -Port <n>   This option is only significant if -SErial is being used.  <n> 
                specifies whether the first or second serial port should be 
                used.

    -LINEspeed <n>    This option is only significant if -SErial is being used.  
                <n> specifies the linespeed for communication through the 
                serial port: only the values 9600, 19200 and 38400 are 
                permitted.

Note that many of these options can be configured as the default, so that they 
can be omitted from the <armsd> command for convenience.  See section "<The ARM 
Tool Reconfiguration Utility (reconfig)>" for details.


armsd Line-Speed Negotiation
............................

<armsd> will attempt to operate at the configured line speed (9600, 19200 or 
38400 baud).

When first invoked, and whenever it detects that the debugee has been reset, 
<armsd> operates at 9600 baud. Similarly, when the debug monitor (<demon>) is 
reset, it operates at 9600 baud. One of <armsd>'s first acts after reset is to 
send a request to the debug monitor (at 9600 baud) to start operating at the 
configured (higher) line rate.

The default configured line speed for <armsd> is:

 *  under SunOS: 38400 baud;

 *  under PC/DOS: 19200 baud.

 *  under Macintosh: 19200 baud.

This can be re-configured after installation using the <reconfig> Utility (see 
"<The ARM Tool Reconfiguration Utility (reconfig)>").

 

 

