MISDN Getting Started » History » Revision 2
Revision 1 (laforge, 03/13/2022 09:17 AM) → Revision 2/3 (WIMPy, 03/13/2022 01:55 PM)
h1. MISDN Getting Started
h2. Introduction
@mISDN@ is a split kernel / userspace architecture.
The kernel handles
* hardware device drivers
* PHY/L1 related bits
* [optionally] layer2 like Q.921/LAPD on D-channel, HDLC or X.75slp in the B-channel
* [optionally] audio processing of B-channels, such as conferencing, DTMF detection, ...
The userspace handles
* configuration of the kernel code / stack
* any layers not implemented in the kernel
* Layer3 (Q.931) is always handled in userspace
The interface between kernel and userspace is based around AF_ISDN sockets. Those sockets carry _primitives_ between the layers.
The userspace part is called @mISDNuser@ and consists of libraries (@libmisdn.so@ and @libsuppserv.so@) and some utilities + examples.
An introduction can be found in a presentation by Karten Keil at http://data.guug.de/slides/lk2008/lk2008-mISDN-slides.pdf
h2. Availability
The kernel part of mISDN is still present in mainline kernels today (as of 5.14), and also built by default as kernel modules by Debian 11.
However, not all drivers are present, specifically the XHFC driver is currently only available at https://github.com/ISDN4Linux/mISDN
mISDNuser is available from https://github.com/ISDN4Linux/mISDNuser
h2. Supported Hardware
As of kernel 5.15, the following hardwre is supported in mainline:
* avmfritz ([[AVM_Fritz!Card_PCI]] adapters)
* hfcmulti ([[CologneChip_HFC]] HFC-4S/HFC-8S/HFC-E1 based PCI adapters)
* hfcpci ([[CologneChip_HFC]] based PCI adapters)
* hfcsusb ([[CologneChip_HFC]]-S based USB adapters)
* speedfax (Sedlbauer Speedfax+ cards based on ISAR DSP)
* w6692 (Winbond W6692 ISDN S/T Controller for PCI bus)
h2. First Steps
Assuming you've installed the hardware, have a kernel with mISDN + driver support and built the @mISDNuser@ tools, you can use @misdn_info@ to list the installed cards:
h3. tools/misdn_info
<pre>
$ sudo ./misdn_info
Found 1 port
Port 0 'HFC-S_USB.1': TE/NT-mode BRI S/T (for phone lines & phones)
2 B-channels: 1-2
B-protocols: RAW HDLC X75slp
</pre>
h3. tools/misdn_log
@misdn_log@ is a tracer/logger of signaling related activity in mISDN. You can also use it with the @-w@ flag to store pcap files for later analysis by wireshark.
h3. examples/misdntestlayer3
Assuming further that you are operating your adapter in TE mode and are connecte to some PBX / softswitch that can route inbound voice calls to it, you can use @misdntestlayer3@ as follows:
<pre>
$ sudo ./misdntestlayer3 -v 3
</pre>
If you then call any MSN routed to this S/T interface, it will be immediately answered and you will get a playback of a fixed audio recordong (supposedly by Karsten Keil, the developer of the tool).
