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)}} |