1ASTRIBANK_HEXLOAD(8) ASTRIBANK_HEXLOAD(8)
2
6 astribank_hexload - Xorcom Astribank (xpp) firmware loader
7
9 astribank_hexload -D device-path -F [options] hexfile
10 astribank_hexload -D device-path -p [options] hexfile1 .. hexfile4
12 astribank_hexload -D device-path -O [-A] [-S span-specs] [options]
14 imagefile
15 astribank_hexload -D device-path -o [options]
17 astribank_hexload -D device-path -E [options] hexfile
19 astribank_hexload -h
21
24 astribank_hexload is a second-stage firmware loader for Xorcom Astrib‐
25 anks.
26 Note that some very old models use fpga_load(8) instead. This legacy
28 tool hasn't been used for several releases. It can be found in version
29 2.6 and below of dahdi-tools.
30 The astribank_hexload(8) program is used to load a file in the Intel
32 HEX format into a Xorcom Astribank. It can be used to load either an
33 FPGA firmware or a PIC firmware. It is normally run by the script
34 xpp_fxloader.
35
38 -D device-path
39 Required. The device to read from/write to. This is
40 bus_num/device_num, where bus_num and device_num are the first
41 two numbers in the output of lsusb(8) or dahdi_hardware(8). On
42 older versions of this tool you needed a complete path to the
43 device, which would be /dev/bus/usb/bus_num/device_num, or
44 /proc/bus/usb/bus_num/device_num.
45 One of the following is required:
47 -F
49 The firmware to load is a FPGA firmware.
50 -p
52 The firmwares to load is are PIC firmwares. All (typically 4)
53 should be on the command-line.
54 -O
56 The firmware to load is an Octasic echo canceller firmware image
57 file.
58 -o
60 Don't load firmware. Just print the version number of the cur‐
61 rently-loaded Octasic echo canceller firmware.
62 -E
64 The firmware to load is a special EEPROM burning one.
65 Other options:
68 -v
70 Increase verbosity. May be used multiple times.
71 -d mask
73 Set debug mask to mask. Default is 0, 0xFF is "everything".
74 -h
76 Displays usage message.
77 -A
79 When loading a Octasic echo canceller firmware, set the channels
80 of the first Astribank module to use aLaw (G.711a). This is what
81 you'd normally use for BRI and E1. If not set, the default mu-
82 Law (G.711u), which is what you'd normally use for FXS, FXO and
83 T1.
84 -S span-specs
86 This option should only be used when loading Octasic echo can‐
87 celler firmware and only if the first Astribank module is PRI.
88 Its goal is to allow specifying different line-mode (E1/T1/J1)
90 in different ports of the PRI module. astribank_hexload use the
91 span-specs argument to select aLaw/uLaw for each of the PRI
92 ports in the module.
93 The span-specs is a list of items separated by whitespace or
95 commas. Each item is composed of a port selector, colon and a
96 line-mode specifier. This syntax follows the syntax of speci‐
97 fiers in /etc/dahdi/span-types.conf.
98 Examples:
100 3:E1 - The 3'rd port is E1.
101 *:T1 - Any unspecified port is T1 (wildcard match).
103 1:T1,2:T1,*:E1 - First and second ports are T1, the rest
105 are E1.
106 If the -S is not given, the PRI default is determined by the
108 existance of the -A-fR option.
109
112 fxload(8), lsusb(8), astribank_tool(8)
113
116 This manual page was written by Tzafrir Cohen <tzafrir.cohen@xor‐
117 com.com> . Permission is granted to copy, distribute and/or modify
118 this document under the terms of the GNU General Public License, Ver‐
119 sion 2 any later version published by the Free Software Foundation.
120 On Debian systems, the complete text of the GNU General Public License
122 can be found in /usr/share/common-licenses/GPL.
123 30 May 2011 ASTRIBANK_HEXLOAD(8)