picp1

Usage

Overview

This manual page documents briefly the picp command. This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page.

picp is a Linux (and Windows) command line interface to Microchip's PICSTART Plus, Newfound Electronic's Warp-13, and JuPic PIC programmers. Originally written by Andrew Pines, picp is now maintained by Jeff Post.

Thanks to Jim Robertson of Newfound Electronics, who generously donated a Warp-13a programmer and technical advice so that picp would work with both the Warp-13 and PICSTART Plus programmers.

Thanks also to Adam Jurkiewicz, who donated a JuPic programmer for testing. JuPic is an excellent replacement for the Warp-13 programmer (which is no longer being sold).

picp is licensed under the GNU General Public License.

Options

A summary of options is included below.

ttyname

serial (or USB) device the PICSTART or Warp-13 is attached to (e.g. /dev/ttyS0 or com1)

devtype

the pic device to be used (12C508, 16C505, etc.)

-b

blank checks the requested region or regions

-c

enable comm line debug output to picpcomm.log (must be before ttyname)

-d

(if only parameter) show device list

-e

erases the requested region (flash parts only)

-f

ignores verify errors while writing

-h

show a short help message

-i

use ISP protocol (must be first option after devtype)

-q

sets quiet mode (excess messages supressed)

-r

initiates a read (Intel Hex record format)

-s [size]

shows a hash mark status bar of length [size] while erasing/writing

-w

writes to the requested region. -wpx will suppress actual writing to program space (for debugging picp)

-v

shows PICSTART Plus version number

-v

(if only parameter) show picp version number

Read/Write/Erase parameters

p [filename]

program memory, optionally reading/writing filename

c [val]

configuration bits (val is a numeric word value when writing)

i [val]

ID locations

d [filename]

data memory, optionally reading/writing filename

o [val]

oscillator calibration space

f

entire flash device (only applies to -e, erase)

filename is an optional input or output file (default is stdin/stdout)

Notes

Example:

picp -c /dev/ttyS1 16f84 -wp widget.hex

This example programs a 16F84 device with the program in the file widget.hex using the ttyS1 serial port, and writes comm line debug information in the file picpcomm.log.

The -i option causes picp to use a slightly different protocol for communicating with the Warp-13 programmer when programming 18fxxx chips connected to the ISP port of the Warp-13. This appears to be necessary only when using BluePole firmware version 1.5. Use this option only if you experience problems without it.