The 'new' bootloader for MPIDE/chipKIT PIC32 boards
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
BootloadersCurrent-hex Referencing Pull Request #30 : this commit adds a build configuration… Feb 6, 2018


The 'new' bootloader for non-Digilent designed chipKIT PIC32 and chipKIT related boards.

The bootloader code in this repository is buildable for many non-Digilent chipKIT boards (meaning boards that either happen to be programmable with MPIDE/UECIDE/chipKIT-core or were designed that way, but not designed by Digilent) like the UBW32 and Fubarino boards.

The bootloader codebase supports two methods of bootloading - over UART (async serial) or USB CDC-ACM (virtual serial). These two methods are mutually exclusive in the current bootloader code - for a given board, you build the bootloader for EITHER serial OR USB, but not both. This decision is made by which files are included in the build, and the #define CAPABILITIES in the BoardConfig.h file. Note that many boards (like the chipKIT Pi) have two bootloaders, one for UART and one for USB.

There is a single project and multiple build targets for MPLAB X. To build the code requires MPLAB X and the XC32 v1.40 (or higher) compiler. Note that the full size optimizations are needed for this bootloader, so the free XC32 won't work for all of the bootloaders (although it may work for some).

IMPORTANT NOTE: While the majority of this code was written and tested by Keith Vogel of Digilent Inc., this software is NOT a product of Digilent Inc. and Digilent will provide no support for it. They have gracefully contributed this code as open source code to the MPIDE community, and it is now being maintained and supported purely through the ChipKIT forums ( and this GetHub repo site ( for code updates and issue tracking. This means that the official bootloader HEX file for a board purchased from Digilent is NOT contained here. If you want the official HEX file for the bootloader for your Digilent board, you should go to Digilent's website and download it from there. If you want the sourcecode for bootloaders installed on Digilent designed boards, please contact Digilent and ask them for it. They will be happy to give it to you.

The BoardConfig.h file contains all of the board-specific information (what capabilities the board has, what pins the LEDs and buttons (if any) are on, what the config bits are, etc.).

This GitHub repo also contains 'update-sketches' which are proof-of-concept MPIDE sketches that can be used to over-write a bootloader with a newer bootloader. They are provided by Keith Vogel of Digilent without any support. But they can be terribly useful.

The BootloadersCurrent-hex folder now has the very latest hex files for all supported boards.

To use one of these hex files, you'll either need to use the update-sketches or an ICSP hardware programmer like the PICKit3 from Microchip.