Man Linux: Main Page and Category List


       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 inhx32.

       -c, --object
              Output a relocatable object (old COFF format).

       -C, --new-coff
              Output a relocatable object (new COFF format).

       -d, --debug
              Output debug messages.

       -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.

       -g, --debug-info
              Use debug directives for COFF.

       -h, --help
              Show the usage message.

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

       -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.

       -M, --deps
              Output a dependency file.

       -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 output 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.

       -v, --version
              Show the version.

       -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

       -y, --extended
              Enable 18xx extended mode.




       Craig Franklin <>


       Copyright (C) 2002, 2003, 2004, 2005 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.