summaryrefslogtreecommitdiffstats
path: root/doc/man/piklab-prog.1
blob: e0d6340770083cdd2d1dc74934d9988470a393d4 (plain)
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
.\" 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 [TQt-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-tqt
	Show TQt 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 <vonHalenbach@users.sf.net>,
for the Debian project (but may be used by others).