680892784c396cc401098f9e5cf92aaafdf888af
[dahdi/tools.git] / xpp / astribank_hexload.8
1 .TH "ASTRIBANK_HEXLOAD" "8" "29 March 2009" "" ""
2
3 .SH NAME
4 astribank_tool \- Xorcom Astribank (xpp) firmware loader
5 .SH SYNOPSIS
6 .B astribank_tool \-D \fIdevice-path\fR <\fB\-F|\-p\fR> [\fIoptions\fR] \fIhexfile\fR
7
8 .B astribank_tool [\-h]
9
10 .SH DESCRIPTION
11 .B astribank_hexload
12 is a second-stage firmware loader for Xorcom Astribanks. Note that some 
13 older models use fpga_load(8) instead.
14
15 It is used to load a file in the Intel HEX format into a Xorcom
16 Astribank. It can be used to load either an FPGA firmware or a PIC
17 firmware. It is normally run by the script xpp_fxloader.
18
19 .SH OPTIONS
20 .B \-D 
21 .I device-path
22 .RS
23 Required. The device to read from/write to. On modern UDEV-based system
24 this is usually /dev/bus/usb/\fIbus_num\fR/\fIdevice_num\fR,
25 where \fIbus_num\fR and \fIdevice_num\fR are the first two numbers in the
26 output of lsusb(8).
27 On older systems that use usbfs, it is usually
28 /proc/bus/usb/\fIbus_num\fR/\fIdevice_num\fR.
29 .RE
30
31 .B \-F
32 .RS
33 The firmware to load is a FPGA firmware.
34 .RE
35
36 .B \-p
37 .RS
38 The firmware to load is a PIC firmware.
39 .RE
40
41 .B \-v
42 .RS
43 Increase verbosity. May be used multiple times.
44 .RE
45
46 .B \-d \fImask\fR
47 .RS
48 Set debug mask to \fImask\fR. Default is 0, 0xFF is "everything".
49 .RE
50
51 .B \-h
52 .RS
53 Displays usage message.
54 .RE
55
56 .SH SEE ALSO
57 fxload(8), lsusb(8), astribank_tool(8), fpga_load(8)
58
59 .SH AUTHOR
60 This manual page was written by Tzafrir Cohen <tzafrir.cohen@xorcom.com> .
61 Permission is granted to copy, distribute and/or modify this document under
62 the terms of the GNU General Public License, Version 2 any 
63 later version published by the Free Software Foundation.
64
65 On Debian systems, the complete text of the GNU General Public
66 License can be found in /usr/share/common\-licenses/GPL.