summaryrefslogtreecommitdiffstats
path: root/man/piklab-prog.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/piklab-prog.1')
-rwxr-xr-xman/piklab-prog.1164
1 files changed, 164 insertions, 0 deletions
diff --git a/man/piklab-prog.1 b/man/piklab-prog.1
new file mode 100755
index 0000000..6a06f7a
--- /dev/null
+++ b/man/piklab-prog.1
@@ -0,0 +1,164 @@
+.\" 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)
+.\" 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)
+.TH "PIKLAB" "1" "April 11, 2007" "" ""
+.SH "NAME"
+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 piklab\-coff (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).