summaryrefslogtreecommitdiff
path: root/xpp/astribank_hexload.8
blob: 4017f78e95007ae356fa6fcc1a5ef554627f3b32 (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
.TH "ASTRIBANK_HEXLOAD" "8" "29 March 2009" "" ""

.SH NAME
astribank_tool \- Xorcom Astribank (xpp) firmware loader
.SH SYNOPSIS
.B astribank_tool -D \fIdevice-path\fR <\fB-F|-p\fR> [\fIoptions\fR] \fIhexfile\fR

.B astribank_tool [-h]

.SH DESCRIPTION
.B astribank_hexload
is a second-stage firmware loader for Xorcom Astribanks. Note that some 
older models use fpga_load(8) instead.

It is used to load a file in the Intel HEX format into a Xorcom
Astribank. It can be used to load either an FPGA firmware or a PIC
firmware. It is normally run by the script xpp_fxloader.

.SH OPTIONS
.B -D 
.I device-path
.RS
Required. The device to read from/write to. On modern UDEV-based system
this is usually /dev/bus/usb/\fIbus_num\fR/\fIdevice_num\fR,
where \fIbus_num\fR and \fIdevice_num\fR are the first two numbers in the
output of lsusb(8).
On older systems that use usbfs, it is usually
/proc/bus/usb/\fIbus_num\fR/\fIdevice_num\fR.
.RE

.B -F
.RS
The firmware to load is a FPGA firmware.
.RE

.B -p
.RS
The firmware to load is a PIC firmware.
.RE

.B -v
.RS
Increase verbosity. May be used multiple times.
.RE

.B -d \fImask\fR
.RS
Set debug mask to \fImask\fR. Default is 0, 0xFF is "everything".
.RE

.B -h
.RS
Displays usage message.
.RE

.SH SEE ALSO
fxload(8), lsusb(8), astribank_tool(8), fpga_load(8)

.SH AUTHOR
This manual page was written by Tzafrir Cohen <tzafrir.cohen@xorcom.com> .
Permission is granted to copy, distribute and/or modify this document under
the terms of the GNU General Public License, Version 2 any 
later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public
License can be found in /usr/share/common-licenses/GPL.