Project

General

Profile

Libosmo-abis » History » Version 8

laforge, 03/04/2020 08:35 PM

1 1 laforge
h1. libosmo-abis
2 3 laforge
3 4 fixeria
{{>toc}}
4 3 laforge
5 6 fixeria
h2. General description
6
7 5 fixeria
This is a library containing common/shared code regarding the A-bis interface between BTS and BSC.
8 1 laforge
It implements drivers for mISDN and DAHDI based E1 cards, as well as some A-bis/IP dialects.
9 7 laforge
h2. Preconditions 
10 1 laforge
11 7 laforge
To compile libosmo-abis you will need the following tools:
12 1 laforge
13 7 laforge
<pre>
14
sudo apt-get install build-essential libtool libortp-dev dahdi-source libsctp-dev shtool autoconf automake git-core pkg-config make gcc
15
</pre>
16
17
18
h2. Obtaining it
19
20 6 fixeria
To obtain libosmo-abis, you can use the following git URL:
21 1 laforge
22 3 laforge
<pre>
23
git clone git://git.osmocom.org/libosmo-abis.git
24 1 laforge
</pre>
25
26 7 laforge
h2. Compiling and installing it
27
28
To compile and install it as standalone:
29
<pre>
30
cd libosmo-abis/
31
autoreconf -i
32
./configure
33
make
34
sudo make install
35
sudo ldconfig -i
36
cd ..
37
</pre>
38
39
40
h2. Licensing
41
42
This library is GPL licensed. This means you *cannot use this library from non-GPL licensed code without infringing copyright!
43
44
45
h2. Browsing its source code
46
47
You can do that using our cgit installation at http://cgit.osmocom.org/libosmo-abis/
48
49 3 laforge
h2. Input Drivers
50 2 laforge
51
There are currently the following input drivers available:
52
53 3 laforge
h3. misdn
54 1 laforge
55 3 laforge
This input driver supports the mISDN code as it is present in mainline linux-2.6 kernels.
56
57 1 laforge
It uses the in-kernel LAPD implementation, and is thus bound to some restrictions.  Specifically,
58 2 laforge
you can only have one signalling timeslot (D-channel) in every E1 line, which may cause problems
59 1 laforge
with multi-BTS or multi-TRX setups (particularly in the case of Nokia A-bis)
60 5 fixeria
61
You have to configure which E1 timeslot is to be used for signalling by module parameters, e.g.
62 3 laforge
63 1 laforge
<pre>
64 3 laforge
modprobe hfcmulti dslot=1
65 2 laforge
</pre>
66 5 fixeria
67 1 laforge
will configure TS1 as signalling.
68 3 laforge
69
h3. misdn_lapd
70 1 laforge
71
This input driver supports the mISDN code as it is present in mainline linux-2.6 kernels.
72
However, unlike the "misdn" driver, it runs LAPD in userspace, as part of libosmo-abis.
73 2 laforge
74 5 fixeria
In order to be able to use it, you will need to make sure the mISDN kernel driver does not
75
configure any timeslot to signalling, e.g.
76 1 laforge
77 2 laforge
<pre>
78 1 laforge
modprobe hfcmulti dslot=-1
79 3 laforge
</pre>
80 5 fixeria
81 2 laforge
(notice the "-" in front of 1 to indicate "no signalling timeslot").
82
83
h3. dahdi
84 3 laforge
85
This driver supports the DAHDI (formerly known as zaptel) out-of-tree drivers for e.g.
86
the various Digium and Digium compatible E1/T1/J1 cards.
87 2 laforge
88 1 laforge
h3. ipa
89 2 laforge
90 7 laforge
This implements A-bis over IP, as implemented by ip.access nanoBTS as well as all BTSs running [[OsmoBTS:]].
91 3 laforge
92
h3. hsl
93 2 laforge
94
Experimental driver for support of the [HSL_Femto]
95 8 laforge
96
{{include(cellular-infrastructure:MacroCommercialSupport)}} 
Add picture from clipboard (Maximum size: 48.8 MB)