gpasm(1)                    General Commands Manual                   gpasm(1)

       gpasm - GNU PIC assembler

       gpasm [ options ] file

       The information in this man page is an extract from the full
       documentation of gputils and is limited to the meaning of the options.
       For complete and current documentation, refer to "" located
       in the gputils docs directory.

       gpasm is an assembler for Microchip (TM) PIC (TM) micro-controllers.
       It's intended to be compatible with the manufacturer's MPASM assembler.
       gpasm is part of gputils.  Check the gputils(1) manpage for details on
       other GNU PIC utilities.

       Below is a summary of the gpasm options.  gpasm options always
       supersede any settings in the source code.

       -a FMT, --hex-format FMT
              GPASM supports inhx8m, inhx8s, inhx16, and inhx32 hex file
              formats.  This option controls which hex file format is used.
              The default is inhx8m.

       -c, --case
              All user defined symbols and macros are case sensitive.  This
              option makes them case insensitive.

       -D SYM=VAL, --define SYM=VAL
              Define SYM with value VAL. This is equivalent to placing
              "#define SYM VAL" in the source.

       -e [ON|OFF], --expand [ON|OFF]
              Macro expansion in the listing file is controlled using the
              EXPAND and NOEXPAND directives.  This option can force either
              directive to be ignored.  When "ON" is selected the macros are
              always expanded regardless of the presence of NOEXPAND.
              Likewise, "OFF" will force macros not to be expanded.

       -h, --help
              Show the usage message.

       -I DIR, --include DIR
              The top level assembly file is passed to gpasm as an argument.
              This file can contain INCLUDE directives.  These directives open
              the specified file and then its contents are assembled.  GPASM
              searches for these files in the local directory.  If the file is
              not located, the default header path is checked.  Finally, all
              paths specified using this argument are searched.

       -L, --force-list
              Ignore NOLIST directives.  This forces gpasm to print every line
              assembled in the list file output.

       -l, --list-chips
              List the supported processors.

       -m, --dump
              Upon completion of the final pass of assembly, display the
              contents of instruction memory.

       -n, --dos
              By default, gpasm generates hex files using ISO format.
              However, some device programmers required a DOS formatted file.
              This option will cause gpasm to generate a DOS formatted hex

       -o FILE, --output FILE
              Alternate name of the hex file.

       -p PROC, --processor PROC
              Select the processor.

       -q, --quiet
              Suppress anything sent to standard output.

       -r RADIX, --radix RADIX
              The supported radices are BIN, DEC, OCT, and HEX.  The default
              is HEX.

       -w [0|1|2], --warning [0|1|2]
              This option sets the message level. "0" is the default.  It will
              allow all messages, warnings, and errors to be reported.  "1"
              will suppress the messages.  "2" will suppress the messages and

       -v, --version
              Show the version.


       Craig Franklin <>

       Copyright (C) 2002 James Bowman, Craig Franklin

       This program is free software; you can redistribute it and/or modify it
       under the terms of the GNU General Public License as published by the
       Free Software Foundation; either version 2 of the License, or (at your
       option) any later version.

       This program is distributed in the hope that it will be useful, but
       WITHOUT ANY WARRANTY; without even the implied warranty of
       General Public License for more details.

       You should have received a copy of the GNU General Public License along
       with this program; if not, write to the Free Software Foundation, Inc.,
       675 Mass Ave, Cambridge, MA 02139, USA.

                     (c) 2002 James Bowman, Craig Franklin            gpasm(1)