Skip to content

Commit f47c9bd

Browse files
committed
Changed readme to reflect driver support changes.
1 parent 40f4f86 commit f47c9bd

File tree

1 file changed

+4
-216
lines changed

1 file changed

+4
-216
lines changed

README

Lines changed: 4 additions & 216 deletions
Original file line numberDiff line numberDiff line change
@@ -28,18 +28,12 @@ Digital Cards
2828
* Digium TE220: PCI-Express dual-port T1/E1/J1
2929
* Digium TE420: PCI-Express quad-port T1/E1/J1
3030
* Digium TE820: PCI-Express eight-port T1/E1/J1
31-
- wcte12xp:
32-
* Digium TE120P: PCI single-port T1/E1/J1
33-
* Digium TE121: PCI-Express single-port T1/E1/J1
34-
* Digium TE122: PCI single-port T1/E1/J1
35-
- wcte11xp:
36-
* Digium TE110P: PCI single-port T1/E1/J1
37-
- wct1xxp:
38-
* Digium T100P: PCI single-port T1
39-
* Digium E100P: PCI single-port E1
4031
- wcb4xxp:
4132
* Digium B410: PCI quad-port BRI
42-
- tor2: Tormenta quad-span T1/E1 card from the Zapata Telephony project
33+
* Digium B233: PCI-Express dual-port BRI with echo can
34+
* Digium B234: PCI dual-port dual-port BRI with echo can
35+
* Digium B433: PCI-Express quad-port BRI with echo can
36+
* Digium B434: PCI quad-port BRI with echo can
4337

4438

4539
Analog Cards
@@ -51,19 +45,13 @@ Analog Cards
5145
* Digium A4B: PCI express up to 4 mixed FXS/FXO ports
5246
- wctdm24xxp:
5347
* Digium TDM2400P/AEX2400: up to 24 analog ports
54-
* Digium TDM800P/AEX800: up to 8 analog ports
55-
* Digium TDM410P/AEX410: up to 4 analog ports
5648
* Digium Hx8 Series: Up to 8 analog or BRI ports
57-
- wctdm:
58-
* Digium TDM400P: up to 4 analog ports
5949
- xpp: Xorcom Astribank: a USB connected unit of up to 32 ports
6050
(including the digital BRI and E1/T1 modules)
61-
- wcfxo: X100P, similar and clones. A simple single-port FXO card
6251

6352

6453
Other Drivers
6554
~~~~~~~~~~~~~
66-
- pciradio: Zapata Telephony PCI Quad Radio Interface
6755
- wctc4xxp: Digium hardware transcoder cards (also need dahdi_transcode)
6856
- dahdi_dynamic_eth: TDM over Ethernet (TDMoE) driver. Requires dahdi_dynamic
6957
- dahdi_dynamic_loc: Mirror a local span. Requires dahdi_dynamic
@@ -196,204 +184,6 @@ you a clue of the versions installed:
196184
find /lib/modules -name dahdi.ko
197185

198186

199-
Installing the B410P drivers with mISDN
200-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
201-
DAHDI includes the wcb4xxp driver for the B410P, however, support for the
202-
B410P was historically provided by mISDN. If you would like to use the mISDN
203-
driver with the B410P, please comment out the wcb4xxp line in /etc/dahdi/modules.
204-
This will prevent DAHDI from loading wcb4xxp which will conflict with the mISDN
205-
driver.
206-
207-
To install the mISDN driver for the B410P, please see http://www.misdn.org for
208-
more information, but the following sequence of steps is roughly equivalent to
209-
'make b410p' from previous releases.
210-
211-
wget http://www.misdn.org/downloads/releases/mISDN-1_1_8.tar.gz
212-
wget http://www.misdn.org/downloads/releases/mISDNuser-1_1_8.tar.gz
213-
tar xfz mISDN-1_1_8.tar.gz
214-
tar xfz mISDNuser-1_1_8.tar.gz
215-
pushd mISDN-1_1_8
216-
make install
217-
popd
218-
pushd mISDNuser-1_1_8
219-
make install
220-
popd
221-
/usr/sbin/misdn-init config
222-
223-
You will then also want to make sure /etc/init.d/misdn-init is started
224-
automatically with either 'chkconfig --add misdn-init' or 'update-rc.d
225-
misdn-init defaults 15 30' depending on your distribution.
226-
227-
NOTE: At the time this was written, misdn-1.1.8 is not compatible the
228-
2.6.25 kernel. Please use a kernel version 2.6.25 or earlier.
229-
230-
231-
OSLEC
232-
~~~~~
233-
http://www.rowetel.com/ucasterisk/oslec.html[OSLEC] is an
234-
Open Source Line Echo Canceller. It is currently in the staging subtree
235-
of the mainline kernel and will hopefully be fully merged at around
236-
version 2.6.29. The echo canceller module dahdi_echocan_oslec
237-
provides a DAHDI echo canceller module that uses the code from OSLEC. As
238-
OSLEC has not been accepted into mainline yet, its interface is not set
239-
in stone and thus this driver may need to change. Thus it is not
240-
built by default.
241-
242-
Luckily the structure of the dahdi-linux tree matches that of the kernel
243-
tree. Hence you can basically copy drivers/staging/echo and place it
244-
under driver/staging/echo . In fact, dahdi_echocan_oslec assumes that
245-
this is where the oslec code lies. If it is elsewhere you'll need to fix
246-
the #include line.
247-
248-
Thus for the moment, the simplest way to build OSLEC with dahdi is to
249-
copy the directory `drivers/staging/echo` from a recent kernel tree (at
250-
least 2.6.28-rc1) to the a subdirectory with the same name in the
251-
dahdi-linux tree.
252-
253-
After doing that, you'll see the following when building (running
254-
'make')
255-
256-
...
257-
CC [M] /home/tzafrir/dahdi-linux/drivers/dahdi/dahdi_echocan_oslec.o
258-
CC [M] /home/tzafrir/dahdi-linux/drivers/dahdi/../staging/echo/echo.o
259-
...
260-
261-
As this is an experimental driver, problems building and using it should
262-
be reported on the
263-
https://lists.sourceforge.net/lists/listinfo/freetel-oslec[OSLEC mailing
264-
list].
265-
266-
Alternatively you can also get the OSLEC code from the dahdi-linux-extra
267-
GIT repository:
268-
269-
git clone git://gitorious.org/dahdi-extra/dahdi-linux-extra.git
270-
cd dahdi-linux-extra
271-
git archive extra-2.6 drivers/staging | (cd ..; tar xf -)
272-
cd ..; rm -rf dahdi-linux-extra
273-
274-
275-
Live Install
276-
~~~~~~~~~~~~
277-
In many cases you already have DAHDI installed on your system but would
278-
like to try a different version. E.g. in order to check if the latest
279-
version fixes a bug that your current system happens to have.
280-
281-
DAHDI-linux includes a script to automate the task of installing DAHDI
282-
to a subtree and using it instead of the system copy. Module loading
283-
through modprobe cannot be used. Thus the script pre-loads the required
284-
modules with insmod (which requires some quesswork as for which modules
285-
to load). It also sets PATH and other environment variables to make all
286-
the commands do the right thing.
287-
288-
There is an extra mode of operation to copy all the required files to a
289-
remote host and run things there, for those who don't like to test code
290-
on thir build system.
291-
292-
Live Install: The Basics
293-
^^^^^^^^^^^^^^^^^^^^^^^^
294-
Basic operation is through running
295-
296-
./build_tools/live_dahdi
297-
298-
from the root directory of the dahdi-linux tree. Using DAHDI requires
299-
dahdi-tools as well, and the script builds and installs dahdi-tools. By
300-
default it assumes the tree of dahdi-tools is in the directory
301-
'dahdi-tools' alongside the dahdi-linux tree. If you want to checkout
302-
the trunks from SVN, use:
303-
304-
svn checkout http://svn.asterisk.org/svn/dahdi/linux/trunk dahdi-linux
305-
svn checkout http://svn.asterisk.org/svn/dahdi/tools/trunk dahdi-tools
306-
cd dahdi-linux
307-
308-
If the tools directory resides elsewhere, you'll need to edit
309-
live/live.conf (see later on). The usage message of live_dahdi:
310-
311-
Usage: equivalent of:
312-
live_dahdi configure ./configure
313-
live_dahdi install make install
314-
live_dahdi config make config
315-
live_dahdi unload /etc/init.d/dahdi stop
316-
live_dahdi load /etc/init.d/dahdi start
317-
live_dahdi reload /etc/init.d/dahdi restart
318-
live_dahdi xpp-firm (Reset and load xpp firmware)
319-
live_dahdi rsync TARGET (copy filea to /tmp/live in host TARGET)
320-
live_dahdi exec COMMAND (Run COMMAND in 'live' environment)
321-
322-
Normally you should run:
323-
324-
./build_tools/live_dahdi configure
325-
./build_tools/live_dahdi install
326-
./build_tools/live_dahdi config
327-
328-
to build and install everything. Up until now no real change was done.
329-
This could actually be run by a non-root user. All files are installed
330-
under the subdirectory live/ .
331-
332-
Reloading the modules (and restarting Asterisk) is done by:
333-
334-
./build_tools/live_dahdi reload
335-
336-
Note: this stops Asterisk, unloads the DAHDI modules, loads the DAHDI
337-
modules from the live/ subdirectory, configures the system and re-starts
338-
Asterisk. This *can* do damage to your system. Furthermore, the DAHDI
339-
configuration is generated by dahdi_genconf. It can be influenced by
340-
a genconf_parameters file. But it may or may not be what you want.
341-
342-
If you want to run a command in the environment of the live system, use
343-
the command 'exec':
344-
345-
./build_tools/live_dahdi lsdahdi
346-
./build_tools/live_dahdi dahdi_hardware -v
347-
348-
Note however:
349-
350-
./build_tools/live_dahdi dahdi_cfg -c live/etc/dahdi/system.conf
351-
352-
Live Install Remote
353-
^^^^^^^^^^^^^^^^^^^
354-
As mentioned above, live_dahdi can also copy all the live system files
355-
to a remote system and run from there. This requires rsync installed on
356-
both system and assumes you can connect to the remove system through
357-
ssh.
358-
359-
tzafrir@hilbert $ ./build_tools/live_dahdi rsync root@david
360-
root@david's password:
361-
<f+++++++++ live_dahdi
362-
cd+++++++++ live/
363-
<f+++++++++ live/live.conf
364-
cd+++++++++ live/dev/
365-
cd+++++++++ live/dev/dahdi/
366-
cd+++++++++ live/etc/
367-
cd+++++++++ live/etc/asterisk/
368-
cd+++++++++ live/etc/dahdi/
369-
<f+++++++++ live/etc/dahdi/genconf_parameters
370-
<f+++++++++ live/etc/dahdi/init.conf
371-
...
372-
373-
As you can see, it copies the script itselfand the whole live/
374-
subdirectory. The target directory is /tmp/live on the target directory
375-
(changing it should probably be simple, but I never needed that).
376-
377-
Then, on the remove computer:
378-
379-
root@david:/tmp# ./live_dahdi reload
380-
381-
382-
Configuring a Live Install
383-
^^^^^^^^^^^^^^^^^^^^^^^^^^
384-
The live_dahdi script reads a configuration file in 'live/live.conf' if
385-
it exists. This file has the format of a shell script snippet:
386-
387-
var1=value # a '#' sign begins a comment
388-
var2='value'
389-
390-
# comments and empty lines are ignored
391-
var3="value"
392-
393-
The variables below can also be overriden from the environment:
394-
395-
var1='value' ./build_tools/live_dahdi
396-
397187
===== LINUX_DIR
398188
The relative path to the dahdi-linux tree. The default is '.' and normally
399189
there's no reason to override it.
@@ -1456,7 +1246,5 @@ http://issues.asterisk.org in the "DAHDI-linux" category.
14561246
Links
14571247
-----
14581248
- http://asterisk.org/[] - The Asterisk PBX
1459-
- http://voip-info.org/[]
1460-
- http://voip-info.org/wiki/view/DAHDI[]
14611249
- http://docs.tzafrir.org.il/dahdi-linux/README.html[Up-to-date HTML version
14621250
of this file]

0 commit comments

Comments
 (0)