1ASTRIBANK_HEXLOAD(8)                                      ASTRIBANK_HEXLOAD(8)
2
3
4

NAME

6       astribank_hexload - Xorcom Astribank (xpp) firmware loader
7

SYNOPSIS

9       astribank_hexload -D device-path -F [options] hexfile
10
11       astribank_hexload -D device-path -p [options] hexfile1 .. hexfile4
12
13       astribank_hexload  -D  device-path  -O  [-A]  [-S span-specs] [options]
14       imagefile
15
16       astribank_hexload -D device-path -o [options]
17
18       astribank_hexload -D device-path -E [options] hexfile
19
20       astribank_hexload -h
21
22

DESCRIPTION

24       astribank_hexload is a second-stage firmware loader for Xorcom  Astrib‐
25       anks.
26
27       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
31       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
36

OPTIONS

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
46       One of the following is required:
47
48       -F
49              The firmware to load is a FPGA firmware.
50
51       -p
52              The  firmwares  to  load is are PIC firmwares. All (typically 4)
53              should be on the command-line.
54
55       -O
56              The firmware to load is an Octasic echo canceller firmware image
57              file.
58
59       -o
60              Don't  load  firmware. Just print the version number of the cur‐
61              rently-loaded Octasic echo canceller firmware.
62
63       -E
64              The firmware to load is a special EEPROM burning one.
65
66
67       Other options:
68
69       -v
70              Increase verbosity. May be used multiple times.
71
72       -d mask
73              Set debug mask to mask. Default is 0, 0xFF is "everything".
74
75       -h
76              Displays usage message.
77
78       -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
85       -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
89              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
94              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
99              Examples:
100                     3:E1 - The 3'rd port is E1.
101
102                     *:T1 - Any unspecified port is T1 (wildcard match).
103
104                     1:T1,2:T1,*:E1  - First and second ports are T1, the rest
105                     are E1.
106
107              If the -S is not given, the PRI default  is  determined  by  the
108              existance of the -A-fR option.
109
110

SEE ALSO

112       fxload(8), lsusb(8), astribank_tool(8)
113
114

AUTHOR

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
121       On Debian systems, the complete text of the GNU General Public  License
122       can be found in /usr/share/common-licenses/GPL.
123
124
125
126                                  30 May 2011             ASTRIBANK_HEXLOAD(8)
Impressum