Pickle is an PICMicro in-circuit serial programmer for FreeBSD, NetBSD, Linux, Cygwin (Windows) and MACOS/X or any UNIX/POSIX based system, which includes the Raspberry Pi and embedded devices running OpenWRT.

All operating systems support high voltage programming (HVP) of PICMicros with the Velleman K8048 or K8076 kits using a RS232 interface, yet many other high voltage programming kits may be supported with the appropriate configuration.

Support is also available to program low voltage programming (LVP) compatible PICMicros directly from a Raspberry Pi, OpenWRT enabled router or an USB UART adapter. Look for PICMicros marked LVP(PGM) or LVP(KEY) in the supported PICMicro device list.

Refer to the Microchip documentation for your PICMicro as to whether it supports high voltage (HVP) or low voltage (LVP) programming or both.

Currently supported PICMicros range from the PIC10 to the PIC32. Predominantly PICMicros available in DIP packages are tested and supported.

In order to use the program in Windows you must first install and setup Cygwin including the necessary development tools for building the application. See this page for details.

Darron M Broad < darron at kewl dot org >

TOC

Pickle version 5.0 has been released. This version changes how ICSP interfaces are configured in the configuration file. The changes do not affect the RPi but do affect the legagy Velleman K8048.

Programming executive support has been added for PIC32MM 32-bit PICMicros.

TOC

Before you download and use the application you should read the LICENCE found here. This licence details the rights and liabilities of using the application and it should be especially understood that I, the author, will not accept any responsibility for any side effects of running it. Do not download and run this program unless you are willing to accept the consequences of it failing for any reason.

TOC

Pickle was originally written by Darron M Broad in 2005 as `k8048' to support the PIC16F627. `k8048' was updated in 2007 adding various other devices and more active development has occured since 2012 adding many more. The project was renamed from `k8048' to pickle in January 2015 as the Velleman K8048 kit became less relevant and superseded by the Raspberry Pi as the primary development platform.

Special thanks go to various people who helped over the years with this project!

TOC

Hardware with ICSP support.

TOC

The following tables list all the supported PICMicros. PICMicros in each table are grouped by family and at least one device of each family has been tested.

12-bit word / 8-bit data PIC10F/12F/16F architecture

14-bit word / 8-bit data PIC10F/12F/16F architecture

14-bit word / 8-bit data PIC16F architecture (new programming algorithm)

16-bit word / 8-bit data PIC18F architecture

16-bit word / 8-bit data PIC18F architecture (new programming algorithm)

24-bit word / 16-bit data PIC24/dsPIC architecture

32-bit word / 32-bit data PIC32 architecture

TOC

The PICMicros in the following table have been tested are known to work in specific modes of operation.

Code Y/N indicates whether an ICSP I/O test has been written for this device.

The three modes are as follows:

• HVP. High voltage programming at 9 or 13V.
• LVP(PGM). Low voltage programming with VPP and PGM at VDD.
• LVP(KEY). Low voltage programming with VPP at VDD and entry using a 32-bit key.

The legacy Velleman K8048/K8076 is incompatible with many modern devices and any advice is noted.

New algorithm noted in the comment column refers to the new PIC16F/18F programming algorithm incompatible with the older ICSP programming method.

TOC

Download the latest archive file pickle-5.01.tgz or check out the latest development version here tip.tar.gz.

Decompress and extract the application source code from the archive. Perform `sudo make && sudo make install', the application will be ready for use.

This has been tested on FreeBSD 5 and 6 yet should work on all FreeBSD variants and other BSD derived systems. It has also been test to work in Linux 2.6 but only compiled for 2.4.

A binary build is available for the RPi pickle-5.02-pi.tgz. This pre-built binary must be extracted as root into / as /opt/pickle/.

Here are some sample sessions obtaining the source of the application and then compiling and installing it.

As root.

cd /usr/ports/devel/gmake
make
make install
rehash
cd /root
fetch "https://wiki.kewl.org/downloads/pickle-5.01.tgz"
tar zxf pickle-5.01.tgz
cd pickle
gmake k8048
gmake k8048-install

wget "https://wiki.kewl.org/downloads/pickle-5.01.tgz"
tar zxf pickle-5.01.tgz
cd pickle
make linux
sudo make linux-install

wget "https://wiki.kewl.org/downloads/pickle-5.01.tgz"
tar zxf pickle-5.01.tgz
cd pickle
make cygwin
make cygwin-install
cd ~
vi .pickle
DEVICE=/dev/ttyS2
SLEEP=0
BITRULES=0x001F
BUSY=0
:wq!

Below is an example where we build the latest version of pickle from the code repository (use at your own risk).

sudo -s
apt-get install build-essential mercurial libftdi-dev
rehash
hg clone http://hg.kewl.org/pub/pickle
cd pickle
make linux
make linux-install

TOC

There are two ways to configure pickle; either use a dot file named `.pickle' in your home directory, else create a directory named `.pickle' and store the configuration in a file there named `config'.

The second option is to allow selectable configurations with the `PICKLE' environment variable, and also for storage of Programming Executive files for the 32-bit PICMicros.

The options are as follows.

#
# I/O device
#
#DEVICE=BPI                     # Banana Pi SBC
#DEVICE=CP2104                  # CP2104 USB UART
#DEVICE=FTDI                    # FTDI FT230X, FT4232H, FT2232H or FT232 USB UART
#DEVICE=GPIO-BB                 # Linux GPIO bit-bang kernel module
#DEVICE=MCP2221                 # Microchip USB bridge
#DEVICE=MCP23016                # Microchip I2C I/O expander
#DEVICE=MCP230XX                # Microchip 23008/23017 I2C I/O expanders
#DEVICE=MCP23SXX                # Microchip 23S08/23S17 SPI I/O expanders
#DEVICE=PCF8574                 # Philips I2C I/O expander
#DEVICE=RPI                     # Raspberry Pi/0/2/3/4 SBCs
#DEVICE=TTY                     # POSIX RS-232 UART

# I/O interface
#IFACE=/dev/ttyUSB0             # CP2104 or TTY
#IFACE=0                        # FTDI
#IFACE=/dev/gpio-bb             # GPIO-BB
#IFACE=/dev/i2c-1               # MCP23016, MCP230XX or PCF8574
#IFACE=/dev/spidev0.1           # MCP23SXX
#IFACE=/dev/ttyS0               # TTY

# I/O 1/2-bit delay/sleep time
#
# For ttyS   use 1
# For ttyUSB use 600
# For RPI    use 1
#
# When SLEEP is set to zero no delay is taken
# When SLEEP is less than 10, then SLEEP x I/O bit time is taken for RPI and tty
# When SLEEP is less than 100 a busy loop is utilised
# When SLEEP is >=100 then system usleep is used.
#
# For GPIO BIT-BANG SLEEP configures the low and high clock durations in the driver
#
# TTY ttyS
#SLEEP=1
# TTY ttyUSB
#SLEEP=600
# RPI VELLEMAN K8048
#SLEEP=10
# RPI GPIO
#SLEEP=1
# I2C/SPI
#SLEEP=0
# GPIO-BB
#SLEEP=1

# I/O bit rules.
#       These rules determine the polarity of the control lines and whether
#       data input requires data output pulled high or low.
# 0x0001 PGD_OUT_FLIP
# 0x0002 PGC_OUT_FLIP
# 0x0004 VPP_OUT_FLIP
# 0x0008 PGD_IN_FLIP
# 0x0010 PGD_IN_PULLUP
# 0x0020 PGM_OUT_FLIP
# 0x0040 VPP_OUT_CLOCK
# 0x0080 PGD_IN_PULLDOWN
#       These rules release GPIOs on program exit by setting them to Input.
# 0x0100 PGD_RELEASE
# 0x0200 PGC_RELEASE
# 0x0400 PGM_RELEASE
# 0x0800 VPP_RELEASE
# 0x1000 VPP_RUN
#       This rule enables shift with irq lock for GPIO BIT-BANG
# 0x2000 BB_LOCK
#       This rule resets any released pin to its previous function on exit (input, output or ALT).
# 0x4000 ALT_RELEASE
#       This rule is for Winklepicker reset
# 0x8000 TX_BREAK

# TTY VELLEMAN K8048 = PGD_IN_PULLUP + PGD_OUT_FLIP + PGC_OUT_FLIP + VPP_OUT_FLIP + PGD_IN_FLIP
# TTY VELLEMAN K8076 = PGD_IN_PULLUP
# RPI VELLEMAN K8048 = PGD_IN_PULLUP
#
# TTY VELLEMAN K8048
#BITRULES=0x001F
# TTY VELLEMAN K8076
#BITRULES=0x0010
# RPI VELLEMAN K8048
#BITRULES=0x0010
# RPI GPIO
#BITRULES=0x1000
# MCP23017 I2C
#BITRULES=0x1010
# GPIO-BB
#BITRULES=0x1000
# RPI CHIPKIT PI PIC32 ICSP
#BITRULES=0x4F00
# TTY T-TYPE FLIP FLOP ON TXD FOR VPP
#BITRULES=0x004F

# I/O busy cursor speed (0=DISABLED)
#
#BUSY=0

# RPI VELLEMAN K8048 (https://wiki.kewl.org/dokuwiki/projects:k8048-rpi)
#
# TX/!MCLR/VPP     - DSUB9(3)
#VPP=14
# PGM              - NOT SUPPORTED ON VELLEMAN K8048
#PGM=-1
# RTS/PGC CLOCK    - DSUB9(7)
#PGC=18
# DTR/PGD DATA_OUT - DSUB9(4)
#PGDO=24
# CTS/PGD DATA_IN  - DSUB9(8)
#PGDI=25

# RPI GPIO (separate PGD DATA I/O)
#                  = SLICE OF PI/O =
# !MCLR/VPP        - PI/O G04
#VPP=4
# PGM              - PI/O G22
#PGM=22
# PGC CLOCK        - PI/O G25
#PGC=25
# PGD DATA_OUT     - PI/O G24
#PGDO=24
# PGD DATA_IN      - PI/O G23
#PGDI=23

# RPI OR GPIO-BB (single PGD DATA I/O)
#                  = SLICE OF PI/O =
# !MCLR/VPP        - PI/O G04
#VPP=4
# PGM              - PI/O G22
#PGM=22
# PGC CLOCK        - PI/O G25
#PGC=25
# PGD DATA_I/O     - PI/O G24
#PGD=24

# RPI OR GPIO-BB (single PGD DATA I/O)
#                  = CHIPKIT PI I/O =
# !MCLR/VPP        - RPI-Connect 18
#VPP=9
# PGM              - RPI-Connect 12
#PGM=22
# PGC CLOCK        - RPI-Connect 16
#PGC=10
# PGD DATA_I/O     - RPI-Connect 20
#PGD=11

# RPI OR GPIO-BB (single PGD DATA I/O)
#                  = CHIPKIT PI PIC32 ICSP =
# !MCLR/VPP        - /RESET
#VPP=4
# PGM              - N/A
#PGM=-1
# PGC CLOCK        - PGC1 RX2
#PGC=14
# PGD DATA_I/O     - PGD1 TX2
#PGD=15

# I2C/SPI ADDRESS
#
#ADDR=0x20

# ICSP I/O 1/2-bit sleep time for `pio'.
#FWSLEEP=30

# Debug level (0=NONE, 1=ERROR, 10=INFO)
#DEBUG=1

# PIC14-NEW, PIC16, and PIC16-NEW CONFIG MASK
#
# 1 CONFIGVER        APPLY TO VERIFY (DEFAULT)
# 2 CONFIGAND        APPLY TO DUMP   (DEFAULT)
# 4 CONFIGSET        APPLY TO WRITE
#
# DOES NOT APPLY TO PIC18J SERIES
#
#CONFIG=0 # DISABLED

TOC

DEVICE=BPI
SLEEP=1
BITRULES=0x1000
VPP=270
PGM=-1
PGC=266
PGD=272

DEVICE=OPI0
BITRULES=0x1000
SLEEP=1
VPP=12
PGC=11
PGD=6
PGM=-1

#
# IO0 ---------> MCLR
# IO1 ---------> PGC
# IO2 ---390R--> PGD
# IO3 <--390R--- PGD
#
# /dev/ttyUSB0
#
DEVICE=CP2104
IFACE=/dev/ttyUSB0
BITRULES=0x1000
VPP=0
PGC=1
PGDO=2
PGDI=3

# DB0 TXD
# DB1 RXD
# DB2 RTS#
# DB3 CTS#
# DB4 DTR#
# DB5 DSR#
# DB6 DCD#
# DB7 RI#
DEVICE=FTDI
IFACE=0
BITRULES=0x1000
SLEEP=0
VPP=0
PGC=1
PGD=3
PGM=-1 # DISABLED
DEBUG=0

DEVICE=GPIO-BB
IFACE=/dev/gpio-bb
SLEEP=1
BITRULES=0x1000
VPP=9
PGM=22
PGC=10
PGD=11

#
# GP3 PGDI <---------- PGD
# GP2 VPP  ----------> MCLR
# GP1 PGC  ----------> PGC
# GP0 PGDO ----1K----> PGD
#
DEVICE=MCP2221
BITRULES=0x1000
SLEEP=0
PGDI=3
VPP=2
PGC=1
PGDO=0
PGM=-1  # N/A

VPP=0
PGC=1
PGDO=2
PGDI=3
PGM=-1
DEVICE=MCP23016
IFACE=/dev/i2c-1
ADDR=0x20
SLEEP=0
#VPP_RUN + PGD_IN_PULLUP
BITRULES=0x1010

VPP=0
PGC=1
PGDO=2
PGDI=3
PGM=-1
DEVICE=MCP230XX
IFACE=/dev/i2c-1
ADDR=0x20
SLEEP=0
#VPP_RUN + PGD_IN_PULLUP
BITRULES=0x1010

VPP=0
PGC=1
PGDO=2
PGDI=3
PGM=-1
DEVICE=MCP23SXX
IFACE=/dev/spidev0.0
ADDR=0x20
SLEEP=0
#VPP_RUN + PGD_IN_PULLUP
BITRULES=0x1010
BAUDRATE=1000000

VPP=0
PGDI=1
PGDO=1
PGC=2
PGM=-1
DEVICE=PCF8574
IFACE=/dev/i2c-1
ADDR=0x20
SLEEP=0
#VPP_RUN + PGC_RELEASE + PGD_RELEASE + PGD_IN_PULLUP
BITRULES=0x1310

DEVICE=RPI1
SLEEP=1
BITRULES=0x1000
VPP=9
PGM=-1
PGC=10
PGD=11

DEVICE=RPI # AUTO-DETECT
SLEEP=1
BITRULES=0x1000
VPP=9
PGM=-1
PGC=10
PGD=11

Velleman K8048

DEVICE=TTY
IFACE=/dev/ttyS0
SLEEP=1
BITRULES=0x001F

TOC

On dsPIC/PIC24 and PIC32 devices, Microchip provide a `programming executive'.

This software is loaded into the chip to speed up ICSP.

Pickle supports ICSP with the programming executive (PE) on the PIC32 but not the dsPIC/PIC24 devices. Currently there are no plans to add PE support for the dsPIC/PIC24.

By default, PIC32 PE mode is not enabled and a few steps must be completed to activate this mode of operation.

If you have a .pickle file then rename it with a temporary name.

mv ~/.pickle ~/.pickle-config

Make a directory named .pickle in your home dir.

mkdir ~/.pickle

Move any old config into the new directory, renaming it to `config'.

mv ~/.pickle-config ~/.pickle/config

Download and unzip the programming executive from Microchip, Eg. for the PIC32MX150F128B.

cd ~/.pickle
wget -q http://ww1.microchip.com/downloads/en/DeviceDoc/RIPE_11_000301.zip
unzip RIPE_11_000301.zip

A file named RIPE_11_000301.hex will now exist in the .pickle directory. When we use p32, and it finds this file, it will automatically load it into the chip.

The following PE files are all that's required for the PIC32 range of PICMicros.

To test that the PE has been registered correctly, we can issue the id command, and if the PE is found the filename is shown. If the filename is not shown then something is wrong.

$ p32 id
[1D000000] [PROGRAM]  00008000 WORDS
[1F80F220] [DEVICEID] 14D06053 PIC32MX150F128B
[1FC00000] [BOOT]     00000300 WORDS
[1FC00BF0] [DEVCFG3]  CFFFFFFF
[1FC00BF4] [DEVCFG2]  FFF9FFD9
[1FC00BF8] [DEVCFG1]  FC67CF59
[1FC00BFC] [DEVCFG0]  7FFFFFFB
           [PE]       RIPE_11_000301.hex

The speed up when using the PIC32 PE to read and write to flash file is considerable. For example, programming 128KB without PE takes about 60 seconds on the RPi, with the PE it takes about 7.5 seconds. Verifying the same data takes 2 minutes without the PE and 5.5 seconds with it.

TOC

There are multiple ways to run the pickle and its mode of operation is selected by using one of its symlinked command variations.

$ pickle
USAGE: pickle
Usage information.

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

FRONTENDS:
 INHX32
                File or standard input.
 STK500
                POSIX serial or network input.

BACKENDS:
 BPI/OPI
                Linux AllWinner Banana Pi (A20) and Orange Pi (H2+/H3) GPIO.
 CP2104
                Linux CP2104 GPIO.
 FTDI
                Linux FTDI USB bit-bang.
 GPIO-BB
                Linux GPIO bit-bang version 1.3.
 MCP2221
                Linux MCP2221 GPIO.
 MCP23016
                Linux MCP23016 I2C.
 MCP230XX
                Linux MCP23008/17 I2C.
 MCP23SXX
                Linux MCP23S08/17 SPI.
 PCF8574
                Linux PCF8574 I2C.
 RPI
                Linux Raspberry Pi GPIO (Pi0/Pi1/Pi2/Pi3/Pi4).
 TTY
                POSIX Serial bit-bang.

EXAMPLES:
 p12 SELECT DEVICE OPERATION [ARG]
                12-bit word PIC10F/12F/16F operations.
 p14 [SELECT DEVICE] [LVP] OPERATION [ARG]
                14-bit word PIC10F/12F/16F operations.
 n14 [LVP] OPERATION [ARG]
                14-bit word PIC16F operations.
 p16 [SELECT DEVICE] [LVP|HVP] OPERATION [ARG]
                16-bit word PIC18F operations.
 n16 [LVP] OPERATION [ARG]
                16-bit word PIC18F operations.
 p24 [SELECT|PARTITION DEVICE] [LVP|HVP] OPERATION [ARG]
                24-bit word PIC24/dsPIC operations.
 p32 OPERATION [ARG]
                32-bit word PIC32 operations.
 pctrl RUN|STOP|RESTORE
                Control master clear.
 pio COMMAND [ARG]
                ICSPIO operations.
 pload PROGRAM|VERIFY TTY|IP FILE [16|24|32]
                Program or verify file on TTY or network.
 ptest TEST [ARG]
                Hardware tests.

VERSION:
 5.01

$ p12
USAGE: p12 SELECT DEVICE OPERATION [ARG]
12-bit word PIC10F/12F/16F operations.

Error: Missing arg(s).

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

EXAMPLES:
 p12 select
                Show supported devices.
 p12 select PIC1XFXXX blank
                Blank device (disable protection and bulk erase).
 p12 select PIC1XFXXX config
                Display device configuration.
 p12 select PIC1XFXXX data
                Display data flash content.
 p12 select PIC1XFXXX dump
                Dump device content (INHX32 format).
 p12 select PIC1XFXXX flash [n] [address]
                Display all or n words of program flash content from address.
 p12 select PIC1XFXXX id
                Display device identification.
 p12 select PIC1XFXXX osccal
                Display oscillator calibration.
 p12 select PIC1XFXXX osccal 0x0c1a
                Restore oscillator calibration as 0x0c1a.
 p12 select PIC1XFXXX program [file.hex] [noblank]
                Blank and program file.hex or stdin to flash (INHX32 format).
 p12 select PIC1XFXXX verify [file.hex]
                Verify file.hex or stdin in flash (INHX32 format).
 p12 select PIC1XFXXX view [file.hex] [raw]
                View file.hex or stdin (INHX32 format).
 p12 select PIC1XFXXX /dev/ttyUSB0 | 8048
                Listen on /dev/ttyUSB0 or network for remote programming.

VERSION:
 5.0

$ p14
USAGE: p14 [SELECT DEVICE] [LVP] OPERATION [ARG]
14-bit word PIC10F/12F/16F operations.

Error: Missing arg(s).

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

EXAMPLES:
 p14 select
                Show supported devices.
 p14 select 16F84 OPERATION [ARG]
                Select device PIC16F84.
 p14 lvp OPERATION [ARG]
                LVP 32-bit key entry.
 p14 blank
                Blank device (disable protection and bulk erase).
 p14 config
                Display device configuration.
 p14 config 0x3000
                Restore band-gap configuration as 0x3000.
 p14 data
                Display data EEPROM content.
 p14 dump
                Dump device content (INHX32 format).
 p14 erase eeprom | flash | id | row [n]
                Erase EEPROM, flash, id or flash at row for n rows.
 p14 flash [n] [address]
                Display all or n words of program flash content from address.
 p14 id
                Display device identification.
 p14 loader
                Output boot loader configuration.
 p14 osccal
                Display oscillator calibration.
 p14 osccal 0x343c
                Restore oscillator calibration as 0x343c.
 p14 program [file.hex] [noblank]
                Blank and program file.hex or stdin to flash (INHX32 format).
 p14 verify [file.hex]
                Verify file.hex or stdin in flash (INHX32 format).
 p14 view [file.hex] [raw]
                View file.hex or stdin (INHX32 format).
 p14 /dev/ttyUSB0 | 8048
                Listen on /dev/ttyUSB0 or network for remote programming.

VERSION:
 5.0

$ n14
USAGE: n14 [LVP] OPERATION [ARG]
14-bit PIC16F operations.

Error: Missing arg(s).

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

EXAMPLES:
 n14 select
                Show supported devices.
 n14 lvp OPERATION [ARG]
                LVP 32-bit key entry.
 n14 blank
                Blank device (disable protection and bulk erase).
 n14 config
                Display device configuration.
 n14 data
                Display data EEPROM content.
 n14 dump
                Dump device content (INHX32 format).
 n14 flash [n] [address]
                Display all or n words of program flash content from address.
 n14 id
                Display device identification.
 n14 loader
                Output boot loader configuration.
 n14 program [file.hex] [noblank]
                Blank and program file.hex or stdin to flash (INHX32 format).
 n14 verify [file.hex]
                Verify file.hex or stdin in flash (INHX32 format).
 n14 view [file.hex] [raw]
                View file.hex or stdin (INHX32 format).
 n14 /dev/ttyUSB0 | 8048
                Listen on /dev/ttyUSB0 or network for remote programming.

VERSION:
 5.0

$ p16
USAGE: p16 [SELECT DEVICE] [LVP|HVP] OPERATION [ARG]
16-bit word PIC18F operations.

Error: Missing arg(s).

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

EXAMPLES:
 p16 select
                Show supported devices.
 p16 select 18LF2539 OPERATION [ARG]
                Select device PIC18LF2539.
 p16 lvp OPERATION [ARG]
                LVP 32-bit key entry.
 p16 hvp OPERATION [ARG]
                HVP 32-bit key entry.
 p16 blank
                Blank device (disable protection and bulk erase).
 p16 config
                Display device configuration.
 p16 data
                Display data EEPROM content.
 p16 dump
                Dump device content (INHX32 format).
 p16 erase eeprom | flash | id | row [n]
                Erase EEPROM, flash, id or flash at row for n rows.
 p16 flash [n] [address]
                Display all or n words of program flash content from address.
 p16 id
                Display device identification.
 p16 loader
                Output boot loader configuration.
 p16 program [file.hex] [noblank]
                Blank and program file.hex or stdin to flash (INHX32 format).
 p16 verify [file.hex]
                Verify file.hex or stdin in flash (INHX32 format).
 p16 view [file.hex] [raw]
                View file.hex or stdin (INHX32 format).
 p16 /dev/ttyUSB0 | 8048
                Listen on /dev/ttyUSB0 or network for remote programming.

VERSION:
 5.0

$ n16
USAGE: n16 [LVP] OPERATION [ARG]
16-bit PIC18F operations.

Error: Missing arg(s).

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

EXAMPLES:
 n16 select
                Show supported devices.
 n16 lvp OPERATION [ARG]
                LVP 32-bit key entry.
 n16 blank
                Blank device (disable protection and bulk erase).
 n16 config
                Display device configuration.
 n16 data
                Display data EEPROM content.
 n16 dump
                Dump device content (INHX32 format).
 n16 flash [n] [address]
                Display all or n words of program flash content from address.
 n16 id
                Display device identification.
 n16 loader
                Output boot loader configuration.
 n16 program [file.hex] [noblank]
                Blank and program file.hex or stdin to flash (INHX32 format).
 n16 verify [file.hex]
                Verify file.hex or stdin in flash (INHX32 format).
 n16 view [file.hex] [raw]
                View file.hex or stdin (INHX32 format).
 n16 /dev/ttyUSB0 | 8048
                Listen on /dev/ttyUSB0 or network for remote programming.

VERSION:
 5.0

$ p24
USAGE: p24 [SELECT|PARTITION DEVICE] [LVP|HVP] OPERATION [ARG]
24-bit word PIC24/dsPIC operations.

Error: Missing arg(s).

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

EXAMPLES:
 p24 select
                Show supported devices.
 p24 select 33EP128GP502 OPERATION [ARG]
                Select device dsPIC33EP128GP502.
 p24 select 24FJ128GB202 OPERATION [ARG]
                Select device PIC24FJ128GB202.
 p24 partition 33EP64GS502 OPERATION [ARG]
                Select and partition device dsPIC33EP64GS502.
 p24 lvp OPERATION [ARG]
                LVP 32-bit key entry.
 p24 hvp OPERATION [ARG]
                HVP 32-bit key entry.
 p24 blank
                Blank device (disable protection and bulk erase).
 p24 config
                Display device configuration.
 p24 data
                Display data EEPROM content.
 p24 dump
                Dump device content (INHX32 format).
 p24 exec [n] [address]
                Display all or n words of executive flash content from address.
 p24 flash [n] [address]
                Display all or n words of program flash content from address.
 p24 id
                Display device identification.
 p24 loader
                Output boot loader configuration.
 p24 program [file.hex] [noblank]
                Blank and program file.hex or stdin to flash (INHX32 format).
 p24 verify [file.hex]
                Verify file.hex or stdin in flash (INHX32 format).
 p24 view [file.hex] [raw]
                View file.hex or stdin (INHX32 format).
 p24 /dev/ttyUSB0 | 8048
                Listen on /dev/ttyUSB0 or network for remote programming.

VERSION:
 5.0

$ p32
USAGE: p32 OPERATION [ARG]
32-bit word PIC32 operations.

Error: Missing arg(s).

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

EXAMPLES:
 p32 select
                Show supported devices.
 p32 boot [n] [address]
                Display all or n words of boot flash content from address.
 p32 blank
                Blank device (erase).
 p32 config
                Display device configuration.
 p32 dump
                Dump device content (INHX32 format).
 p32 flash [n] [address]
                Display all or n words of program flash content from address.
 p32 id
                Display device identification.
 p32 program [file.hex] [noblank]
                Blank and program file.hex or stdin to flash (INHX32 format).
 p32 verify [file.hex]
                Verify file.hex or stdin in flash (INHX32 format).
 p32 view [file.hex] [raw]
                View file.hex or stdin (INHX32 format).
 p32 /dev/ttyUSB0 | 8048
                Listen on /dev/ttyUSB0 or network for remote programming.

VERSION:
 5.0

$ pctrl
USAGE: pctrl RUN|STOP|RESTORE [BEFORE][AFTER][DURATION]
Control master clear.

Error: Missing arg.

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

COMMANDS:
 RUN            Raise master clear to take the device out of reset.
 STOP           Lower master clear to put the device into reset.
 RESTORE        Lower then raise master clear to reset the device.

ARGUMENTS:
 BEFORE         Delay in milliseconds before command.
 AFTER          Delay in milliseconds after command.
 DURATION       Duration of reset for RESTORE command.

DEFAULTS:
 BEFORE         0ms.
 AFTER          0ms.
 DURATION       10ms.

EXAMPLES:
 pctrl RUN 10
                Wait 10ms then raise master clear to take the device out of reset.
 pctrl STOP 0 10
                Lower master clear to put the device into reset then wait 10ms.
 pctrl RESTORE 0 0 100
                Lower for 100ms then raise master clear to reset the device.

VERSION:
 5.0

$ pio
USAGE: pio COMMAND [ARG]
ICSPIO operations.

Error: Missing arg(s).

FILES:
 /home/darron/.pickle/config
                Configuration.

ENVIRONMENT:
 PICKLE
                Configuration file.

COMMANDS:
 LED            0x00..0x3F              Set Velleman K8048 LEDs.
 SWITCH                                 Get Velleman K8048 switches.
 SLEEP                                  Sleep until watchdog time-out.
 WATCHDOG       E|D                     Set watchdog enable/disable.
 CLOCK          0..7                    Set internal RC clock divider.
 DIRECTION      A..D|G 0x00..0xFF       Set port data direction.
 OUTPUT         A..D|G 0x00..0xFF       Set port data output.
 INPUT          A..D|G                  Get port data input, output on stdout.
 ANALOG         0..N|D                  Set analog channel enable/disable.
 SAMPLE                                 Get analog channel input.
 EEREAD         0x00..0xFF              Get data EEPROM.
 EEWRITE        0x00..0xFF 0x00..0xFF   Set data EEPROM.
 READ           0x0000..0xFFFF          Get program flash.
 VREF           0..15|D                 Set vref voltage level or disable.
 8              0..0xFF                 Send an 8-bit arg & get an 8-bit answer.
 16             0..0xFFFF               Send a 16-bit arg & get an 8-bit answer.
 24             0..0xFFFFFF             Send a 24-bit arg & get an 8-bit answer.
 32             0..0xFFFFFFFF           Send a 32-bit arg & get an 8-bit answer.
 TEST           0..0xFF                 Send an 8-bit test arg & get no reply.
 ERROR                                  Get last firmware error.

EXAMPLES:
 pio WATCHDOG D
                Turn off watchdog.
 pio DIRECTION C 0xF0
                Set port C bits 0..3 as output and bits 4..7 as input.
 pio OUTPUT C 0x0A
                Set port C bits 0..3 to 0x0A.

VERSION:
 5.0

$ pload
USAGE: pload PROGRAM|VERIFY TTY|IP FILE [16|24|32]
Program or verify file on TTY or network.

Error: Missing arg.

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

EXAMPLES:
 pload program /dev/ttyS0 file.hex
                Program file.hex (INHX32 format) on /dev/ttyS0.
 pload verify /dev/ttyS0 file.hex
                Verify file.hex (INHX32 format) on /dev/ttyS0.
 pload program 192.168.1.100 < led.hex
                Program stdin (INHX32 format) on 192.168.1.100 port 8048.
 pload program /dev/ttyAMA0 led.hex 24
                Program led.hex (INHX32 format) on /dev/ttyAMA0 using 24-bit addressing.

VERSION:
 5.0

$ ptest
USAGE: ptest TEST ARG
Hardware tests.

Error: Missing args.

FILES:
 /home/darron/.pickle/config
                Configuration file.

ENVIRONMENT:
 PICKLE
                Configuration file.

EXAMPLES:
 ptest VPP|PGC|PGD|PGM 5
                VPP, PGC, PGD or PGM LOW->HIGH->LOW output test with 5 seconds mark time.
 ptest INPUT 10
                PGD input test with 10 iterations of 1 second per step.
 ptest DSUB9 10
                D-SUB-9 test with 10 seconds per step.
 ptest ICSP 10
                ICSP test with 10 seconds per step.
 ptest CLOCK 0
                PGC/RTS(7) clock test with no mark time.
 ptest CLOCK 10
                PGC/RTS(7) clock test with 10us mark time.
 ptest 16F627 100
                PIC16F627 debug test with 100us clock mark time.
 ptest ICSPIO 100
                ICSPIO test with 100us clock mark time.
 ptest RPI 10
                RPI GPIO test with 10 seconds mark time.
 ptest ALLWINNER 10
                BPI/OPI GPIO test with 10 seconds mark time.

VERSION:
 5.01

TOC

To demonstrate its usage we may utilise some assembly code supplied in the Pickles support package.

An example assembly file for the PIC16F627 on the Velleman K8048 kit sends the text “hello, world” over the ICSP lines to the host PC within an infinite loop.

The ptest command has a function to decode the text as sent above and dump it to the console, below is an example of assembling the assembly code file, writing it to the PIC16F627 chip and dumping out the text sent by the chip.

hg clone http://hg.kewl.org/pub/pickles
cd pickles/examples/pic16f627/
make

p14 program debug.hex
Total: 272

p14 verify debug.hex
Total: 272 Fail: 0

It is important to remember that on the Velleman K8048 the switch must be set to PROG. mode when writing to the chip and set to the RUN mode to execute code.

ptest 16f627 100

TEST 16F627 debug.asm [CTRL-C TO STOP]

io_test4: read byte: 02 .
io_test4: read byte: 48 H
io_test4: read byte: 65 e
io_test4: read byte: 6C l
io_test4: read byte: 6C l
io_test4: read byte: 6F o
io_test4: read byte: 2C ,
io_test4: read byte: 20
io_test4: read byte: 77 w
io_test4: read byte: 6F o
io_test4: read byte: 72 r
io_test4: read byte: 6C l
io_test4: read byte: 64 d
io_test4: read byte: 0A .
io_test4: read byte: 03 .
io_test4: read line: Hello, world
io_test4: read byte: 02 .
^C
TEST DONE

Below are other examples of using the other commands available in pickle.

p14 id
[0000] [PROGRAM]  0400 WORDS
[2000] [USERID0]  0001 .
[2001] [USERID1]  0002 .
[2002] [USERID2]  0003 .
[2003] [USERID3]  0004 .
[2004] [RESERVED] 3FFF
[2005] [RESERVED] 3FFF
[2006] [DEVICEID] 07A0 DEV:7A0 REV:00 PIC16F627
[2007] [CONFIG]   3F31
[2100] [DATA]     0080 BYTES

p14 config
[2007] [CONFIG]   3F31

p14 data
[2100] 48 65 6C 6C 6F 2C 20 77 6F 72 6C 64 0A 00 FF FF Hello, world....

p14 flash
[0000] 2862 3FFF 3FFF 3FFF 0009 00A4 01A5 01A6 b.......
[0008] 0BA6 2808 0BA5 2808 0BA4 2808 3400 3EFF ........
[0010] 1D03 280F 3400 00A4 3001 200F 0BA4 2814 ........
[0018] 3400 00A4 300B 200F 300B 200F 0BA4 281A ........
[0020] 3400 00A5 300A 2019 0BA5 2822 3400 01A0 ....."..
[0028] 01A1 1F06 3400 0BA1 2829 0BA0 2829 3400 ....).).
[0030] 01A0 01A1 1B06 3400 0BA1 2832 0BA0 2832 .....2.2
[0038] 3400 00A2 1406 2027 1786 2030 1386 3008 ...'.0..
[0040] 00A3 2027 0103 0CA2 1803 3080 0086 2030 .'.....0
[0048] 0BA3 2841 1006 3400 1683 1303 009B 1283 .A......
[0050] 1303 3002 2039 1683 1303 141C 081A 0A9B ..9.....
[0058] 1283 1303 3800 1903 285F 2039 2853 3003 ...._9S.
[0060] 2039 3400 1283 1303 018B 3007 009F 0186 9.......
[0068] 1683 1303 158E 3080 0081 307E 0086 30FF .....~..
[0070] 0085 1283 1303 3000 204C 3001 2005 2873 ....L..s

p14 dump
:020000040000FA
:100000006228FF3FFF3FFF3F0900A400A501A601B2
:10001000A60B0828A50B0828A40B08280034FF3ECF
:10002000031D0F280034A40001300F20A40B142856
:100030000034A4000B300F200B300F20A40B1A2823
:100040000034A5000A301920A50B22280034A00195
:10005000A101061F0034A10B2928A00B2928003478
:10006000A001A101061B0034A10B3228A00B3228ED
:100070000034A2000614272086173020861308308B
:10008000A30027200301A20C031880308600302033
:10009000A30B412806100034831603139B00831220
:1000A000031302303920831603131C141A089B0A09
:1000B00083120313003803195F28392053280330B3
:1000C00039200034831203138B0107309F0086010F
:1000D000831603138E15803081007E308600FF303A
:1000E00085008312031300304C2001300520732853
:020000040000FA
:10420000480065006C006C006F002C0020007700F7
:104210006F0072006C0064000A000000FF00FF00E5
:020000040000FA
:024000000100BD
:024002000200BA
:024004000300B7
:024006000400B4
:02400E00313F40
:00000001FF

I hope you enjoy using this application, good luck.

TOC