File: picp.1

package info (click to toggle)
picp 0.4d-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 272 kB
  • ctags: 444
  • sloc: ansic: 4,614; makefile: 63
file content (116 lines) | stat: -rw-r--r-- 3,798 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH PICP 1 "March 17, 2002"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
picp \- command line utility to drive a PICSTART programmer
.SH SYNOPSIS
.B picp
ttyname devtype [\-h] [\-q] [\-v] [\-s [size]] [\-b|\-r|\-w|\-e][pcido]
.br
.SH DESCRIPTION
This manual page documents briefly the
.B picp
command.
This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.
\fBpicp\fP is a utility which allows you to use the Microchip PICSTART
programmer, where you would normally be required to use the Windows
software.
.SH OPTIONS
A summary of options is included below.
.TP
.B \-h
Show summary of options.
.TP
.B \-s
[size] shows a hash mark status bar of length [size] while erasing/writing
.TP
.B \-q
sets quiet mode (excess messages supressed)
.TP
.B \-r
initiates a read (Intel Hex record format)
.TP
.B \-b
blank checks the requested region or regions
.TP
.B \-f
ignores verify errors while writing
.TP
.B \-w
writes to the requested region
.TP
.B \-e
erases the requested region (flash parts only)
.TP
.B \-v
Shows PICSTART Plus version number
.TP
.B p [filename]
program memory, optionally reading/writing filename
.TP
.B c [val]
configuration bits (val is a numeric word value when writing)
.TP
.B i [val]
ID locations
.TP
.B d [filename]
data memory, optionally reading/writing filename
.TP
.B o [val]
oscillator calibration space
.TP
.B filename
optional input or output file (default is stdin/stdout)
.SH NOTES
Flags are operated on in order, from left to right.  If any operation fails,
further execution is aborted.  Thus, a part can be blank checked and programmed
with a single command, e.g.:

.nf
picp /dev/ttyS0 16c505 -bp -wp program.hex 
.fi

This example will blank check the program memory of a PIC16C505 then write the
contents of the file program.hex to the program memory only if the blank check
succeeded.
The -wc, -wi, and -wo options must be followed by a numeric argument which
represents the value.  The number may be binary (preceeded by 0b or 0B), hex
(preceeded by 0x or 0X), or decimal (anything else).

.nf
.B supported devices:
.fi
12C508, 12C508A, 12C509, 12C509A, 12C671, 12C672, 12CE518, 12CE519, 12CE673, 
12CE674, 14000, 16C505, 16C52, 16C54, 16C54A, 16C54B, 16C54C, 16C55, 16C554, 
16C558, 16C55A, 16C56, 16C56A, 16C57, 16C57C, 16C58A, 16C58B, 16C61, 16C62, 
16C620, 16C620A, 16C621, 16C621A, 16C622, 16C622A, 16C62A, 16C62B, 16C63, 
16C63A, 16C64, 16C642, 16C64A, 16C65, 16C65A, 16C65B, 16C66, 16C662, 16C67, 
16C71, 16C710, 16C711, 16C711, 16C715, 16C716, 16C72, 16C72A, 16C73, 16C73A, 
16C73B, 16C74, 16C74A, 16C74B, 16C76, 16C77, 16C773, 16C774, 16C84, 16C923, 
16C924, 16CE623, 16CE624, 16CE625, 16F83, 16F84, 16F84A, 16F872, 16F873, 
16F874, 16F876, 16F877, 16HV540, 17C42, 17C42A, 17C43, 17C44, 17C752, 17C756, 
17C756A, 17C762, 17C766, 18C242, 18C252, 18C442, 18C452
.br
.SH AUTHOR
This manual page was written by Josh Huber <huber@debian.org>,
for the Debian GNU/Linux system (but may be used by others).