SYNOPSIS

picp [-c] [-d] [-v] ttyname [-v] devtype [-i] [-h] [-q] [-v] [-s [size]] [-b|-r|-w|-e][pcidof]

DESCRIPTION

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.

AUTHOR

This manual page was written by Josh Huber <[email protected]>, for the Debian GNU/Linux system (but may be used by others).