GSPA Assembler command line tool docs

GSPA_CLI_DOCS.txt

GSPA Assembler

This is help synopses for the TI the TMS340 COFF macro assembler v6.10 used
to assemble source files into object code, with optional listing and
cross-reference output. This documentatin has been compiled from multiple
sources as I can't find the TMS340 Family Code-Generation Tools User's Guide
online (SPVU020).

Usuage:

gspa input file [object file [listing file]] [-options}

gspa:
    is the command that invokes the assembler.

input file:
    names the assembler source file. If you do not supply an extension, 
    the assembler assumes that the input file has the default
    extension .asm. If you do not supply an input filename when
    you invoke the assembler, the assembler will prompt you for one.

object file
    names the object file that the assembler creates. If you do not
    supply an extension, the assembler uses .obj as a default extension. 
    If you do not supply an object file, the assembler creates a
    file that uses the input filename with the .obj extension.

listing file
    names the listing file that the assembler creates. If you do not
    supply an extension, the assembler uses .1st as a default extension. 
    If you do not supply a name for a listing file, the assembler
    does not create one, unless you use the -I option. In this case,
    the assembler uses the input file name with the .1st extension.

option
    identifies the assembler options that you want to use. Case is
    insignificant for assembler options. Options can appear anywhere on 
    the command line; precede each option with a hyphen(-). You can
    string the options together; for example, -Ic is
    equivalent to -I -c. Valid assembler options include:

      -i specifies a directory name where the assembler can find files
      named by the .copy, .include, or .mlib directives. The format
      of the -i option is -ipathname. You can specify up to 10 directories
      in this manner; each pathname must be preceded by the -i option.

      -x produces a cross-reference table and appends it to the end
      of the listing file. If you did not request a listing file, the 
      assembler creates one anyway, but the listing will only contain
      the cross-reference table.

      -c makes case insignificant in the source file. For example, the
      symbols ABC and abc will be equivalent. If you do not use
      this option case is significant.

      -s Put all defined symbols in the object file's symbol table.

      -l (lowercase LU) produces a listing file.

      -q (quiet) suppresses the banner and all progress information.

      -b makes blanks significant. This option provides compatibility
      with older code in which a blank terminated the operand
      field, and thus began the comment field.

      -h allows hexadecimal constants to use the format >nnn. This
      option provides compatibility with older code that uses this
      format. Note that this for

      -e The assembler can produce object code for little-endian or bigendian
      mode. By default, the assembler produces Iittle-endian code; if you
      want it to produce big-endian code, be sure to use the -e 
      assembler option. 

      -d Define Symbol. Defines a symbol/constant usable by .if or logic in
      the code.	Same as #define in C compilers. Max of 10 options allowed

      -a	Absolute Mode. Enables absolute listing generation and allows 
      the use of the .abs directive.

      -V10 CPU target TMS34010. Code is forward-compatible (runs on '20).
      
      -V20 CPU target TMS34020. Code using '20-specific features will 
      not run on a TMS34010.