Merge branch 'master' of ssh://git.gag.com/scm/git/fw/altos
[fw/altos] / ao-tools / ao-rawload / ao-rawload.1
1 .\"
2 .\" Copyright © 2009 Keith Packard <keithp@keithp.com>
3 .\"
4 .\" This program is free software; you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 2 of the License, or
7 .\" (at your option) any later version.
8 .\"
9 .\" This program is distributed in the hope that it will be useful, but
10 .\" WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 .\" General Public License for more details.
13 .\"
14 .\" You should have received a copy of the GNU General Public License along
15 .\" with this program; if not, write to the Free Software Foundation, Inc.,
16 .\" 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
17 .\"
18 .\"
19 .TH AO-RAWLOAD 1 "ao-rawload" ""
20 .SH NAME
21 ao-rawload \- flash a program to a AltOS device
22 .SH SYNOPSIS
23 .B "ao-rawload"
24 [\-T \fItty-device\fP]
25 [\--tty \fItty-device\fP]
26 [\-D \fIaltos-device\fP]
27 [\--device \fIaltos-device\fP]
28 \fIfile.ihx\fP
29 .SH DESCRIPTION
30 .I ao-rawload
31 loads the specified .ihx file, without modification, into the target
32 device flash memory.
33 .SH OPTIONS
34 .TP
35 \-T tty-device | --tty tty-device
36 This selects which tty device the debugger uses to communicate with
37 the target device. The special name 'BITBANG' directs ao-dbg to use
38 the cp2103 connection, otherwise this should be a usb serial port
39 connected to a suitable cc1111 debug node.
40 .TP
41 \-D AltOS-device | --device AltOS-device
42 Search for a connected device. This requires an argument of one of the
43 following forms:
44 .IP
45 TeleMetrum:2
46 .br
47 TeleMetrum
48 .br
49 2
50 .IP
51 Leaving out the product name will cause the tool to select a suitable
52 product, leaving out the serial number will cause the tool to match
53 one of the available devices.
54 .SH USAGE
55 .I ao-rawload
56 reads the specified .ihx file into memory. It then connects to the
57 specified target device and writes the program to the target device
58 flash memory.
59 .SH AUTHOR
60 Keith Packard