PIC Programmer using GPIO connector
Copyright 2017 Francesco Valla
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 3 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 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
picberry is a PIC programmer using GPIOs that doesn't require additional programming hardware.
It theorically supports dsPIC33E/PIC24E, dsPIC33F/PIC24H, PIC24FJ, PIC18FxxJxx, PIC32MX, PIC32MZ and PIC32MK families, but only some PICs have been tested.
Currently picberry has support for the following host boards/processors:
- the Raspberry Pi
- Allwinner A10-based boards (like the Cubieboard)
- TI AM335x-based boards (like the Beaglebone Black or the AM3359 ICEv2).
Support for additional boards and processors can be easily added, providing the following macro in a header file inside the hosts folder:
/* GPIO registers address */
#define GPIO_BASE // base address for the GPIO controller
#define BLOCK_SIZE // size of the GPIO bank
#define PORTOFFSET // port offset for letter-defined gpios
/* GPIO setup macros */
#define GPIO_IN(g) // set gpio g as input
#define GPIO_OUT(g) // set gpio g as output
#define GPIO_SET(g) // set gpio g as high
#define GPIO_CLR(g) // set gpio g as low
#define GPIO_LEV(g) // read level of gpio g
/* default GPIO <-> PIC connections */
#define DEFAULT_PIC_CLK // default gpio for PGC line
#define DEFAULT_PIC_DATA // default gpio for PGD line
#define DEFAULT_PIC_MCLR // default gpio for MCLR line
A build rule inside the Makefile for the specific platform has to be added too.
picberry is written using C++11 features, so it requires at least g++ version 4.7.
To build picberry launch make TARGET, where TARGET can be one of the following:
| TARGET | Processor/Board |
|---|---|
| raspberrypi | Raspberry Pi v1 or Zero |
| raspberrypi2 | Raspberry Pi v2 or v3 |
| am335x | Boards based on TI AM335x (BeagleBone) |
| a10 | Boards based on Allwinner A10 (Cubieboard) |
Then launch sudo make install to install it to /usr/bin.
To change destination prefix use PREFIX=, e.g. sudo make install PREFIX=/usr/local.
For cross-compilation, given that you have the required cross toolchain in you PATH, simply export the CROSS_COMPILE variable before launching make, e.g. CROSS_COMPILE=arm-linux-gnueabihf- make raspberrypi2.
picberry [options]
Programming Options
-h print help
-g PGC,PGD,MCLR GPIO selection in form PORT:NUM, default if not present
-S port server mode, listening on given port
-f family PIC family (dspic33e, dspic33f, pic18fj, pic32mx1, pic32mx2, pic32mx3, pic32mz)
-i file input file
-o file output file (default: ofile.hex)
-r read chip
-w bulk erase and write chip
-e bulk erase chip
-b blank check of the chip
-d read configuration registers
--noverify skip memory verification after programming
--debug turn ON debug
Runtime Options
-R reset
For Example, to connect the PIC to RPi GPIOs 11 (PGC), 9 (PGD), 22 (MCLR) and write on a dsPIC33FJ128GP802 the file fw.hex:
picberry -w -g 11,9,22 -f dspic33f -i fw.hex
To connect the PIC to A10 GPIOs B15 (PGC), B17 (PGD), I15 (MCLR):
picberry -w -g B:15,B:17,I:15 -f dspic33f -i fw.hex
To use picberry you will need only the "recommended minimum connections" outlined in each PIC datasheet.
Between PIC and the SoC you must have the four basic ICSP lines: PGC (clock), PGD (data), MCLR (Reset), GND. You can also connect PIC VDD line to target board 3v3 line, but be careful: such pins normally have low current capabilities, so consider your circuit current drawn!
If not specified in the command line, the default GPIOs <-> PIC connections are the following:
for the Raspberry Pi:
PGC <-> GPIO23
PGD <-> GPIO24
MCLR <-> GPIO18
for the Allwinner A10:
PGC <-> PB15
PGD <-> PB17
MCLR <-> PB12
for AM335x:
PGC <-> GPIO12
PGD <-> GPIO13
MCLR <-> GPIO40
Remote GUI is written in Qt5 and allows to control a picberry session running in server mode (that is, launched with the -S <port> command line argument).
To compile it, just launch qmake and then make in the remote_gui folder.
- dsPIC33E/PIC24E Flash Programming Specification
- dsPIC33F/PIC24H Flash Programming Specification
- PIC24FJ Flash Programming Specification
- PIC24FJXXGA0XX Flash Programming Specification
- PIC18F2XJXX/4XJXX Family Programming Specification
- PIC32 Flash Programming Specification
picberry is released under the GPLv3 license; for full license see the LICENSE file.
The Microchip name and logo, PIC, In-Circuit Serial Programming, ICSP are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries.
Raspberry Pi is a trademark of The Raspberry Pi Foundation.