2017-01-03 11:10:10 +00:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
|
|
|
<HTML
|
|
|
|
|
><HEAD
|
|
|
|
|
><TITLE
|
|
|
|
|
>htsoft-downloader</TITLE
|
|
|
|
|
><META
|
|
|
|
|
NAME="GENERATOR"
|
|
|
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
|
|
|
|
|
><BODY
|
|
|
|
|
CLASS="REFENTRY"
|
|
|
|
|
BGCOLOR="#FFFFFF"
|
|
|
|
|
TEXT="#000000"
|
|
|
|
|
LINK="#0000FF"
|
|
|
|
|
VLINK="#840084"
|
|
|
|
|
ALINK="#0000FF"
|
|
|
|
|
><H1
|
|
|
|
|
><A
|
|
|
|
|
NAME="AEN1"
|
|
|
|
|
></A
|
|
|
|
|
><SPAN
|
|
|
|
|
CLASS="APPLICATION"
|
|
|
|
|
>htsoft-downloader</SPAN
|
|
|
|
|
></H1
|
|
|
|
|
><DIV
|
|
|
|
|
CLASS="REFNAMEDIV"
|
|
|
|
|
><A
|
|
|
|
|
NAME="AEN6"
|
|
|
|
|
></A
|
|
|
|
|
><H2
|
|
|
|
|
>Name</H2
|
|
|
|
|
><SPAN
|
|
|
|
|
CLASS="APPLICATION"
|
|
|
|
|
>htsoft-downloader</SPAN
|
|
|
|
|
> -- Download code to PIC microcontroller with HI-TECH version_1 bootloader
|
|
|
|
|
installed using RS232 serial port.</DIV
|
|
|
|
|
><DIV
|
|
|
|
|
CLASS="REFSYNOPSISDIV"
|
|
|
|
|
><A
|
|
|
|
|
NAME="AEN10"
|
|
|
|
|
></A
|
|
|
|
|
><H2
|
|
|
|
|
>Synopsis</H2
|
|
|
|
|
><P
|
|
|
|
|
><B
|
|
|
|
|
CLASS="COMMAND"
|
|
|
|
|
>htsoft-downloader</B
|
|
|
|
|
> [-?hv] [-f<TT
|
|
|
|
|
CLASS="REPLACEABLE"
|
|
|
|
|
><I
|
|
|
|
|
> serial_device</I
|
|
|
|
|
></TT
|
|
|
|
|
>] [-r<TT
|
|
|
|
|
CLASS="REPLACEABLE"
|
|
|
|
|
><I
|
|
|
|
|
> retries</I
|
|
|
|
|
></TT
|
|
|
|
|
>] [-t<TT
|
|
|
|
|
CLASS="REPLACEABLE"
|
|
|
|
|
><I
|
|
|
|
|
> timeout (.1 second/timeout)</I
|
|
|
|
|
></TT
|
|
|
|
|
>] [-v<TT
|
|
|
|
|
CLASS="REPLACEABLE"
|
|
|
|
|
><I
|
|
|
|
|
> verbose level</I
|
|
|
|
|
></TT
|
|
|
|
|
>]</P
|
|
|
|
|
></DIV
|
|
|
|
|
><DIV
|
|
|
|
|
CLASS="REFSECT1"
|
|
|
|
|
><A
|
|
|
|
|
NAME="AEN22"
|
|
|
|
|
></A
|
|
|
|
|
><H2
|
|
|
|
|
>DESCRIPTION</H2
|
|
|
|
|
><P
|
|
|
|
|
>The <B
|
|
|
|
|
CLASS="COMMAND"
|
|
|
|
|
>htsoft-downloader</B
|
|
|
|
|
> command is an implementation of
|
|
|
|
|
a download application for the HI-TECH version_1 PIC bootloader. An
|
|
|
|
|
Intel Hexadecimal Object File Format Specification Rev A (ie a .hex
|
|
|
|
|
file from picc, MPLAB, gpasm, or other PIC compatible toolchains) is read
|
|
|
|
|
on standard output and downloaded to a PIC on the
|
|
|
|
|
<TT
|
|
|
|
|
CLASS="REPLACEABLE"
|
|
|
|
|
><I
|
|
|
|
|
>serial_device</I
|
|
|
|
|
></TT
|
|
|
|
|
>.</P
|
|
|
|
|
></DIV
|
|
|
|
|
><DIV
|
|
|
|
|
CLASS="REFSECT1"
|
|
|
|
|
><A
|
|
|
|
|
NAME="AEN27"
|
|
|
|
|
></A
|
|
|
|
|
><H2
|
|
|
|
|
>OPTIONS</H2
|
|
|
|
|
><P
|
|
|
|
|
></P
|
|
|
|
|
><DIV
|
|
|
|
|
CLASS="VARIABLELIST"
|
|
|
|
|
><DL
|
|
|
|
|
><DT
|
2017-01-03 11:16:53 +00:00
|
|
|
>-f, --serial-device=<TT
|
2017-01-03 11:10:10 +00:00
|
|
|
CLASS="REPLACEABLE"
|
|
|
|
|
><I
|
|
|
|
|
> serial_device</I
|
|
|
|
|
></TT
|
|
|
|
|
></DT
|
|
|
|
|
><DD
|
|
|
|
|
><P
|
|
|
|
|
>Serial device filename. Examples:</P
|
|
|
|
|
><P
|
|
|
|
|
><TT
|
|
|
|
|
CLASS="FILENAME"
|
|
|
|
|
>/dev/ttyUSB0</TT
|
|
|
|
|
> (Linux USB Serial Adapter)</P
|
|
|
|
|
><P
|
|
|
|
|
><TT
|
|
|
|
|
CLASS="FILENAME"
|
|
|
|
|
>/dev/cuad0</TT
|
|
|
|
|
> (FreeBSD COM port).</P
|
|
|
|
|
><P
|
|
|
|
|
>The default is <TT
|
|
|
|
|
CLASS="FILENAME"
|
|
|
|
|
>/dev/cuaU0</TT
|
|
|
|
|
>, a
|
|
|
|
|
Prolific PL2303 USB to serial adaptor on FreeBSD.</P
|
|
|
|
|
></DD
|
|
|
|
|
><DT
|
2017-01-03 11:16:53 +00:00
|
|
|
>-h, --help</DT
|
|
|
|
|
><DD
|
|
|
|
|
><P
|
|
|
|
|
>Help</P
|
|
|
|
|
></DD
|
|
|
|
|
><DT
|
|
|
|
|
>-i, --ignore-last-wok-timeout</DT
|
|
|
|
|
><DD
|
|
|
|
|
><P
|
|
|
|
|
>Ignore timeout for last WOK after sending reset.</P
|
|
|
|
|
></DD
|
|
|
|
|
><DT
|
|
|
|
|
>-r, --pic-retries=<TT
|
2017-01-03 11:10:10 +00:00
|
|
|
CLASS="REPLACEABLE"
|
|
|
|
|
><I
|
|
|
|
|
> retries</I
|
|
|
|
|
></TT
|
|
|
|
|
></DT
|
|
|
|
|
><DD
|
|
|
|
|
><P
|
|
|
|
|
>Number of times to retry a block. Defaults to 5.</P
|
|
|
|
|
></DD
|
|
|
|
|
><DT
|
2017-01-03 11:16:53 +00:00
|
|
|
>-t, --pic-timeout=<TT
|
2017-01-03 11:10:10 +00:00
|
|
|
CLASS="REPLACEABLE"
|
|
|
|
|
><I
|
|
|
|
|
> timeout</I
|
|
|
|
|
></TT
|
|
|
|
|
></DT
|
|
|
|
|
><DD
|
|
|
|
|
><P
|
|
|
|
|
>Timeout in .1 second intervals. Defaults to 25.</P
|
|
|
|
|
></DD
|
|
|
|
|
><DT
|
2017-01-03 11:16:53 +00:00
|
|
|
>-v, --verbose=<TT
|
2017-01-03 11:10:10 +00:00
|
|
|
CLASS="REPLACEABLE"
|
|
|
|
|
><I
|
|
|
|
|
> verbose_level</I
|
|
|
|
|
></TT
|
|
|
|
|
></DT
|
|
|
|
|
><DD
|
|
|
|
|
><P
|
|
|
|
|
>Increasing the verbosity level will produce debug messages indicating
|
|
|
|
|
the status of the download. A level of 9 will include all debugging
|
|
|
|
|
output. A level of 1 will indicate the overall status of the transfer.</P
|
|
|
|
|
></DD
|
2017-01-03 11:16:53 +00:00
|
|
|
><DT
|
|
|
|
|
>--version</DT
|
|
|
|
|
><DD
|
|
|
|
|
><P
|
|
|
|
|
>Display software version.</P
|
|
|
|
|
></DD
|
2017-01-03 11:10:10 +00:00
|
|
|
></DL
|
|
|
|
|
></DIV
|
|
|
|
|
></DIV
|
|
|
|
|
><DIV
|
|
|
|
|
CLASS="REFSECT1"
|
|
|
|
|
><A
|
2017-01-03 11:16:53 +00:00
|
|
|
NAME="AEN68"
|
2017-01-03 11:10:10 +00:00
|
|
|
></A
|
|
|
|
|
><H2
|
|
|
|
|
>EXAMPLE</H2
|
|
|
|
|
><DIV
|
|
|
|
|
CLASS="INFORMALEXAMPLE"
|
|
|
|
|
><P
|
|
|
|
|
></P
|
|
|
|
|
><A
|
2017-01-03 11:16:53 +00:00
|
|
|
NAME="AEN70"
|
2017-01-03 11:10:10 +00:00
|
|
|
></A
|
|
|
|
|
><P
|
|
|
|
|
>Transfer the HEX file spyrus1.1.hex to a PIC connected to
|
|
|
|
|
<TT
|
|
|
|
|
CLASS="FILENAME"
|
|
|
|
|
>/dev/ttyUSB0</TT
|
|
|
|
|
> with verbose output. Note that
|
|
|
|
|
the bootloader in this device does not send the last WOK command, this
|
|
|
|
|
appears to be harmless.</P
|
|
|
|
|
><P
|
|
|
|
|
> <B
|
|
|
|
|
CLASS="COMMAND"
|
2017-01-03 11:14:13 +00:00
|
|
|
>pic-downloader -v9 -i -f /dev/ttyUSB0 < spyrys1.1.hex</B
|
2017-01-03 11:10:10 +00:00
|
|
|
></P
|
|
|
|
|
><PRE
|
|
|
|
|
CLASS="SCREEN"
|
|
|
|
|
>Waiting for bootloader..........
|
|
|
|
|
|
|
|
|
|
upload block: load_offset=0x0000 bytes_to_send=32
|
|
|
|
|
Dwrite: cmd=E3 load=0000 bytes=20 csum=F8
|
|
|
|
|
write: data=01833000018A280400003020008430652020300700E830FE00E7306500843067
|
|
|
|
|
|
|
|
|
|
upload block: load_offset=0x0020 bytes_to_send=32
|
|
|
|
|
Dwrite: cmd=E3 load=0010 bytes=20 csum=AF
|
|
|
|
|
write: data=202530A0008430E8202017833010008430362020120A118A2DBD060401800A84
|
|
|
|
|
|
|
|
|
|
...
|
|
|
|
|
|
2017-01-03 11:14:13 +00:00
|
|
|
upload block: load_offset=0x1FF8 bytes_to_send=8
|
|
|
|
|
Dwrite: cmd=E3 load=0FFC bytes=08 csum=7E
|
|
|
|
|
write: data=246B120A158A3400
|
|
|
|
|
wDONE: reply=F0, expecting E4wPIC reset sent.</PRE
|
2017-01-03 11:10:10 +00:00
|
|
|
><P
|
|
|
|
|
></P
|
|
|
|
|
></DIV
|
|
|
|
|
></DIV
|
|
|
|
|
><DIV
|
|
|
|
|
CLASS="REFSECT1"
|
|
|
|
|
><A
|
2017-01-03 11:16:53 +00:00
|
|
|
NAME="AEN76"
|
2017-01-03 11:10:10 +00:00
|
|
|
></A
|
|
|
|
|
><H2
|
|
|
|
|
>AUTHOR</H2
|
|
|
|
|
><P
|
|
|
|
|
>Mark Fullmer
|
|
|
|
|
<CODE
|
|
|
|
|
CLASS="EMAIL"
|
|
|
|
|
><<A
|
|
|
|
|
HREF="mailto:maf@splintered.net"
|
|
|
|
|
>maf@splintered.net</A
|
|
|
|
|
>></CODE
|
|
|
|
|
></P
|
|
|
|
|
></DIV
|
|
|
|
|
><DIV
|
|
|
|
|
CLASS="REFSECT1"
|
|
|
|
|
><A
|
2017-01-03 11:16:53 +00:00
|
|
|
NAME="AEN83"
|
2017-01-03 11:10:10 +00:00
|
|
|
></A
|
|
|
|
|
><H2
|
|
|
|
|
>SEE ALSO</H2
|
|
|
|
|
><P
|
|
|
|
|
>Intel Hexadecimal Object File Format Specification Rev A</P
|
|
|
|
|
><P
|
2017-01-03 11:18:19 +00:00
|
|
|
>http://www.htsoft.com</P
|
|
|
|
|
><P
|
|
|
|
|
>http://www.microchip.com</P
|
2017-01-03 11:10:10 +00:00
|
|
|
><P
|
|
|
|
|
>http://www.ehl.cz/pic/pic_e.htm</P
|
2017-01-03 11:18:19 +00:00
|
|
|
><P
|
|
|
|
|
>ftp://ftp.htsoft.com/hitech/samples/bootldr.zip</P
|
2017-01-03 11:10:10 +00:00
|
|
|
></DIV
|
|
|
|
|
></BODY
|
|
|
|
|
></HTML
|
|
|
|
|
>
|
