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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
.\" 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 PIKLAB SECTION "April 11, 2007"
.\" 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 PIKLAB-PROG \- Commandline program for PIC-microcontroller programming.
.SH SYNOPSIS
.B piklab-prog [Qt-options] [KDE-options] [options] [file]
.RI
.br
.SH DESCRIPTION
This manual page documents briefly the
.B piklab-prog command.
.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.
\fBPiklab-prog\fP is a command line tool, which can be used to program microcontrollers with program and data, stored in a HEX-file to a connected programmer. It supports the most common serial, parallel and usb programmers, like ICD2, Pickit2, PicStart+) and debuggers (ICD2).
.SH OPTIONS
This program follows the usual GNU command line syntax, with long
options starting with two dashes (`-').
A summary of options is included below.
.TP
.B \-h, \-\-help
Show summary of options.
.TP
.B \-v, \-\-version
Show version of program.
.TP
.B \-\-help-qt
Show Qt specific options
.TP
.B \-\-help-kde
Show KDE specific options
.TP
.B \-\-help-all
Show all options
.TP
.B \-\-author
Show author information
.TP
.B \-\-license
Show license information
.TP
.B \-\-
End of options
.br
.B Options:
.B \-c, \-\-command <name>
Perform the requested command.
.TP
.B \-\-command-list
Return the list of recognized commands.
.TP
.B \-\-debug
Display debug messages.
.TP
.B \-\-extra-debug
Display extra debug messages.
.TP
.B \-\-max-debug
Display all debug messages.
.TP
.B \-\-quiet
Do not display messages.
.TP
.B \-f, \-\-force
Overwrite files and answer "yes" to questions.
.TP
.B \-i, \-\-cli
Interactive mode
.TP
.B \-r, \-\-range <name>
Memory range to operate on.
.TP
.B \-\-range-list
Return the list of memory ranges.
.TP
.B \-p, \-\-programmer <name>
Programmer to use.
.TP
.B \-\-programmer-list
Return the list of supported programmers.
.TP
.B \-d, \-\-device <name>
Target device.
.TP
.B \-\-device-list
Return the list of supported devices.
.TP
.B \-f, \-\-format <name>
HEX output file format.
.TP
.B \-\-format-list
Return the list of supported HEX file formats.
.TP
.B \-t, \-\-port <name>
Programmer port ("usb" or device such as "/dev/ttyS0")
.TP
.B \-\-port-list
Return the list of detected ports.
.TP
.B \-\-firmware-dir <dir>
Firmware directory.
.TP
.B \-\-target-self-powered
Indicates that device is self-powered.
.br
.SH Arguments:
.B file <HEX-filename for programming>.
.br
.sp 2
.SH SEE ALSO
.BR piklab-prog (1),
.BR piklab-hex (1),
.BR gputils (1),
.BR sdcc (1).
.br
.SH AUTHORS
piklab was written by Nicolas Hadacek and many others, including:
* Alain Gibaud: author of Pikdev; main infrastructure; IDE interface; direct programmers; gputils integration.
* Keith Baker: direct programmer support for 16F7X devices.
* Xiaofan Chen: numerous tests of PICkit1/2 and ICD2 programmers.
* Craig Franklin: author of gputils (disassembler and coff parser).
* Manwlis Giannos: direct programmer support for PIC18FXX2/FXX8 devices.
* Stephen Landamore: author of LPLAB (microchip command-line programmer).
* Brian C. Lane: original code for direct programming.
* Sébastion Laoût: author of Likeback.
* Nestor A. Marchesini: tests of PicStart+ programmer.
* Lorenz Mösenlechner and Matthias Kranz: USB support for ICD2 programmer.
* Mirko Panciri: direct programmers with bidirectionnal buffers.
* Sean A. Walberg: direct programmer support for 16F676/630 devices.
.B Translations:
* Michele Petrecca: Italian translation.
* Alain Portal: French translation.
* Stefan von Halenbach: German translation.
* Nagy Lázló: Hungarian translation.
.sp 2
.SH COPYRIGHT
This is free software. You may redistribute copies of it under the terms of the GNU General Public License
<http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
.PP
This manual page was written by Stefan <[email protected]>,
for the Debian project (but may be used by others).
|
