86 lines
2.7 KiB
Groff
86 lines
2.7 KiB
Groff
.\"
|
|
.\" Copyright © 2009 Keith Packard <keithp@keithp.com>
|
|
.\"
|
|
.\" This program is free software; you can redistribute it and/or modify
|
|
.\" it under the terms of the GNU General Public License as published by
|
|
.\" the Free Software Foundation; either version 2 of the License, or
|
|
.\" (at your option) any later version.
|
|
.\"
|
|
.\" This program is distributed in the hope that it will be useful, but
|
|
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
.\" General Public License for more details.
|
|
.\"
|
|
.\" You should have received a copy of the GNU General Public License along
|
|
.\" with this program; if not, write to the Free Software Foundation, Inc.,
|
|
.\" 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
|
|
.\"
|
|
.\"
|
|
.TH AO-SKY-FLASH 1 "ao-sky-flash" ""
|
|
.SH NAME
|
|
ao-sky-flash \- flash GPS firmware program to a SkyTraq GPS chip
|
|
.SH SYNOPSIS
|
|
.B "ao-sky-flash"
|
|
[\-T \fItty-device\fP]
|
|
[\--tty \fItty-device\fP]
|
|
[\-D \fIaltos-device\fP]
|
|
[\--device \fIaltos-device\fP]
|
|
[\--loader \fIboot-loader\fP]
|
|
[\--firmware \fIgps-firmware\fP]
|
|
[\--query]
|
|
[\--quiet]
|
|
[\--raw]
|
|
.SH DESCRIPTION
|
|
.I ao-sky-flash
|
|
loads the specified GPS firmware file into the target GPS chip flash
|
|
memory using the specified boot loader.
|
|
.SH OPTIONS
|
|
.TP
|
|
\-T tty-device | --tty tty-device
|
|
This selects which tty device the debugger uses to communicate with
|
|
the target device.
|
|
.TP
|
|
\-D AltOS-device | --device AltOS-device
|
|
Search for a connected device. This requires an argument of one of the
|
|
following forms:
|
|
.IP
|
|
TeleMetrum:2
|
|
.br
|
|
TeleMetrum
|
|
.br
|
|
2
|
|
.IP
|
|
Leaving out the product name will cause the tool to select a suitable
|
|
product, leaving out the serial number will cause the tool to match
|
|
one of the available devices.
|
|
.TP
|
|
\--loader boot-loader
|
|
This specifies the desired boot loader to use for reflashing the
|
|
device. You should use srec_115200.bin unless you have a good reason
|
|
not to. This should be in S record format.
|
|
.TP
|
|
\--firmware gps-firmware
|
|
This specifies the new GPS firmware image to load onto the target GPS
|
|
chip. No checking is done on this device at all; flash garbage and the
|
|
GPS chip will probably fail to boot.
|
|
.TP
|
|
\--query
|
|
Instead of loading new firmware, query the current version of firmware
|
|
running on the target device.
|
|
.TP
|
|
\--quiet
|
|
Normally, ao-spy-flash is quite chatty. This shuts it up, except for
|
|
error messages.
|
|
.TP
|
|
\--raw
|
|
The expected target for reflashing is an Altus Metrum product with the
|
|
GPS chip connected to the CPU on that board and not directly to the
|
|
USB serial port. This option says that the target GPS chip is directly
|
|
connected, which changes how things are initialized a bit.
|
|
.SH USAGE
|
|
.I ao-sky-flash
|
|
loads the specified bootloader into device RAM and then uses that to
|
|
load new firmware to flash.
|
|
.SH AUTHOR
|
|
Keith Packard
|