GPUTILS - GNU PIC Utilities

GPUTILS is a collection of tools for the Microchip (TM) PIC microcontrollers. It includes gpasm, gplink, and gplib. It's distributed under the terms of the GNU Public License. There are other GNU PIC tools available such as gpsim, a gputils compatible simulator.

GPUTILS was created by Craig Franklin and James Bowman. Currently, it is primarily supported by Molnár Károly. Until recently has been supported Borut Ražem. In the past it has been supported by David Barnett, Scott Dattalo and Marko Kohtala .

Linux (and other unixes), Mac OS X, and MS-Windows are supported. GPUTILS will compile natively on Linux using gcc. Mac OS X users will need the December 2001 Developer Tools. Windows 98/NT users will need MinGW32 if they wish to compile the tools.

See the Sourceforge download page for source and binary packages.

The latest development sources are available from our svn server.

The following commands will checkout all of the sources and place them in a gputils subdirectory:

RW access:
svn checkout --username=user_name svn+ssh://user_name@svn.code.sf.net/p/gputils/code/trunk .
RO access:
svn checkout svn://svn.code.sf.net/p/gputils/code/trunk .
HTTP access:
svn checkout --username=user_name https://svn.code.sf.net/p/gputils/code/trunk .

You can browse our svn tree here.

Older gputils and gpasm releases are available.

Users have ported gputils to many other platforms. Some of these binaries are for the old gpasm package.

If you have generated a binary of gputils please notify the maintainer of this website, so that it can be added.

Microchip offers an integrated development environment called MPLAB. This environment is only available for MS-Windows. The gputils project has developed an MPLAB plugin. With this plugin, gputils-mplab, MPLAB can be used as an IDE for gputils.

Microchip provided the project with a set of test files that they use to test MPASM for each release. These files were reformatted, some typos were fixed, and scripts to run the tests were generated. The files and scripts are located in svn and can be accessed here.

For anyone interested, the original unaltered files are available in this archive. For information about the archive please read this file. These files were provided by Microchip without any warranty or any level of support. If you have a question about the files ask the current gputils project administrator, not Microchip.

Jan 30, 2022 -- gputils-1.5.2 Released

New experimental gplink features: banksel, pagesel and pcallw
Support for more PIC16F184XX devices.
A few minor bugfixes.

Previous News

GPUTILS comes with some documentation and examples. When that isn't enough, you can find help in the following places:

User Manual - for information on the tools in Acrobat format. You might also want to take a look at Microchip's MPASM manual. For information on Microchip's COFF files, look in this manual.
gputils Wiki - for in-depth documentation, etc. (additions welcome).
FAQ - for frequently asked questions.
Relocatable object HOWTO - for brief information about using gputils with relocatable objects.
User Mailing List - if you have a general question about PIC micro controllers or the tools. Subscribe to the gputils-user@lists.sourceforge.net mailing list: https://lists.sourceforge.net/lists/listinfo/gputils-user

Developer Mailing List - for development work on PIC micro controllers or the tools. Subscribe to the gputils-devel@lists.sourceforge.net mailing list: https://lists.sourceforge.net/lists/listinfo/gputils-devel
Bug Reporting - if you have a problem using GPUTILS, we need to hear about it.
Feature Requests - if you would like to see a new feature.
Source Forge Website - for further information.
GPSIM Information - for information on the gputils compatible simulator.
XGPASM Information - for information on a gui for gpasm.
PiKdev Information - for information on an IDE for gpasm.
Piklab Information - for information on another IDE for gpasm.