~vibhavp/ubuntu/raring/dahdi-tools/merge-from-debian

« back to all changes in this revision

Viewing changes to xpp/README.Astribank

  • Committer: Vibhav Pant
  • Date: 2012-12-26 17:23:16 UTC
  • mfrom: (2.1.6 sid)
  • Revision ID: vibhavp@gmail.com-20121226172316-o2jojsfcnr0aqrme
* Merge from Debian unstable. Remaining changes:
  - Bug Fix: If linux-headers are not installed, don't block, and print
    information for the user.
  - added debian/dahdi.postinst
  - added --error-handler=init_failed to debian/rules
  - debian/control: Added gawk as dependency for dkms build (LP: #493304)
  - Changes from Debian:
    - debian/control: Change Maintainer
    - debian/control: Removed Uploaders field.
    - debian/control: Removed Debian Vcs-Svn entry and replaced with
      ubuntu-voip Vcs-Bzr, to reflect divergence in packages.
    - debian/control: Package dahdi Depends on dahdi-dkms | dahdi-source 

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
Xorcom Astribank Documentation
2
2
==============================
3
3
Xorcom Team <support@xorcom.com>
4
 
$Revision: 8948 $, $Date: 2010-07-20 06:23:39 -0500 (Tue, 20 Jul 2010) $
 
4
$Revision: 10187 $, $Date: 2011-09-07 02:10:53 -0500 (Wed, 07 Sep 2011) $
5
5
 
6
6
This file documents the DAHDI drivers for the Xorcom Channel Bank.
7
7
 
43
43
 
44
44
Building and Installation
45
45
-------------------------
46
 
Apart from the standard DAHDI build requirements, you also need libusb
47
 
development headers to build the fpga_load firmware loader. This is
48
 
typically the package libusb-dev on Debian (and derivatives like Ubuntu)
49
 
or libusb-devel on RedHat (and derivatives like CentOS/Trixbox).
50
 
 
51
 
Patch for BRI
52
 
~~~~~~~~~~~~~
53
 
(As of DAHDI 2.2 this patch is no longer needed. Furthermore, it does
54
 
not apply. The same directory has a newer patch that applies. This
55
 
section is kept in the document for the time being for the benefit of
56
 
those with older versions)
57
 
 
58
 
In order for the BRI module (xpd_bri.ko) to build, you still need an
59
 
external patch: 
60
 
 
61
 
http://updates.xorcom.com/astribank/bristuff/dahdi_bri_dchan.diff[]
62
 
 
63
 
You need to apply it to the dahdi-linux tarball before building:
64
 
 
65
 
  wget http://updates.xorcom.com/astribank/bristuff/dahdi_bri_dchan.diff
66
 
  patch -p1 <dahdi_bri_dchan.diff
 
46
Apart from the standard DAHDI build requirements, you also need:
 
47
 
 
48
* *libusb development headers* to build the fpga_load firmware loader.
 
49
  This is typically the package libusb-dev on Debian (and derivatives
 
50
  like Ubuntu) or libusb-devel on RedHat (and derivatives like
 
51
  CentOS/Trixbox).
 
52
* *Echo Canceller Module firmware*: If you have an Astribank with an
 
53
  echo canceller module, see the following section.
 
54
 
 
55
Follow the build instructions of DAHDI-linux and DAHDI-tools. But
 
56
Basically, in dahdi-linux run:
 
57
 
 
58
  make
 
59
  make install # as root
 
60
 
 
61
And later in dahdi-tools:
 
62
 
 
63
  ./configure
 
64
  make
 
65
  make install # as root
 
66
 
 
67
 
 
68
Echo Canceller Firmware
 
69
~~~~~~~~~~~~~~~~~~~~~~~
 
70
If you install from source, you should copy OCT6104E-256D.ima to the
 
71
source tree (before running make install:
 
72
 
 
73
  wget http://updates.xorcom.com/astribank/hwec/OCT6104E-256D.ima
 
74
  mv OCT6104E-256D.ima drivers/dahdi/xpp/firmwares/
 
75
 
 
76
Alternatively, if you have already installed DAHDI-linux (e.g. from a
 
77
binary package that does not include the firmware) you can just copy
 
78
it directly to the target directory, /usr/share/dahdi using:
 
79
 
 
80
  cd /usr/share/dahdi
 
81
  wget http://updates.xorcom.com/astribank/hwec/OCT6104E-256D.ima
67
82
 
68
83
 
69
84
Installation Scenarios
955
970
  # pick the right name according to the device ID. FPGA_1161.hex is for
956
971
  # 116x Astribanks:
957
972
  astribank_hexload -D /dev/bus/usb/MMM/NNN -F /usr/share/dahdi/FPGA_1161.hex
 
973
  # If the device has an echo canceller unit (If the unit is BRI/E1, you
 
974
  # need to add an extra -A to the command-line after the -O)
 
975
  #astribank_hexload -D /dev/bus/usb/MMM/NNN -O /usr/share/dahdi/OCT6104E-256D.ima
958
976
  # Note the shell expantion in this line:
959
977
  astribank_hexload -D /dev/bus/usb/MMM/NNN -p /usr/share/dahdi/PIC_TYPE_[1-4].hex
960
978
  # reenumerate (disconnect and reconnect)
1072
1090
  BRI ("ISDN") modules. Module type 3.
1073
1091
xpd_pri::
1074
1092
  The module for controlling E1/T1 modules. Module type 4.
 
1093
xpd_echo::
 
1094
  The module for controlling hardware echo canceller modules. Module type 5.
 
1095
  Does not generate a span.
1075
1096
xpp_usb::
1076
1097
  The functionality needed to connect to the USB bus.
1077
1098