Project

General

Profile

BS11Getting Started » History » Version 14

dexter, 02/19/2016 10:47 PM

1 1 laforge
If you have just purchased a new BS-11, this guide will give you some basic instructions on how to proceed.
2
3
== Check Package contents ==
4
5
Please check the [wiki:BS11_Package_List Packing List] and see if you can find all the items in your two boxes.
6
If there is any doubt, please contact the openbsc mailing list and ask for help.
7
8 7 laforge
== Unpacking the BS-11 ==
9
10
You can now unpack the BS-11 (the heavier box).  Make sure you do this with two people handling the unit, 36-48kg of weight
11
are not meant to be lifted by a single person.
12
13
We recommend you mount the wall-mount (from the lighter of the two boxes, packaged in a small brown parcel) to the back of the BS-11,
14
since this gives it a flat surface.  without the wall mount you have a single metal ridge poking out at the back, scratching your floor/table
15
or other surface.
16
17
'''NOTE: If you want to operate the BS-11 for more than just a bit of testing, especially with an enabled 2nd TRX, you definitely should mount
18
it __vertically__ to a pole or wall, since this enables airflow through through the cooling fins'''
19
20 1 laforge
== Build a power cable ==
21
22
Please follow the instructions at [wiki:BS11_Configuration] to manufacture the power cable
23
24
== Build E1 cable ==
25
26
Please follow the instructions at [wiki:BS11_Configuration] to manufacture the E1 cable
27
from RJ45 to the strange RADIALL twinax connectors
28
29
== Configure the BS-11 Jumpers ==
30
31
If you remove the connector cover (loosen three Philips screws), you will uncover the four E1 connectors,
32
as well as the RS232 ports.  There are also four green jumpers at the side of the connector panel.  The
33
factory default of those connectors is 75Ohms.  You need to remove all of the four jumpers to switch to
34
120Ohms termination.
35
36
== Mount and connect the BS-11 Antenna ==
37
38
The Antenna needs to be attached to the BS11 main unit by the means of four screws.  Screws are included in
39
a small plastic bag.
40
41
Connect the four RF antenna cables to the connectors of the BS-11.  Their order is 1:1, i.e. leftmost plug into leftmost socket, etc.
42 4 laforge
43
Be aware of the fact that the panel antenna adds some gain to the transmission path. So even if you configure the BTS to transmit with the lowest power possible, the effective radiated power (ERP) may exceed permitted limits.
44 1 laforge
45 13 dexter
Note: The antenna connectors are formaly known as "N-Connectors"
46
47 1 laforge
== Test the BS-11 status and configuration ==
48
49
 * connect the power plug to the BS-11
50
 * connect the RS232 cable to J2 of the BS-11 (see photograph)
51
 * connect the RS232 cable to your PC
52
 * switch on the power switch of the BS-11 (the LED should light up green in 2-3 seconds)
53 7 laforge
 * start the ''bs11_config'' program to observe the boot process (see [wiki:bs11_config] for details)
54 1 laforge
  * you should observe the boot process like it is indicated at the [wiki:bs11_config] page
55
  * at the end of the process (10 minutes or so), you should have ''Phase 3 Normal'' and ''MBCCU0 Load'' and ''Abis-Link Restoring''
56
  * MBCCU1 might be ''Load'' or ''No Load'', depending on whether TRX1 is activated or not
57 2 laforge
{{{
58
PHASE: 3 Normal               MBCCU0: Load        MBCCU1: No Load     Abis-link: Restoring
59
}}}
60 1 laforge
 * Once you are in "Phase 3 Normal", use ''bs11_config query'' to query the configuration
61
  * OML TEI must be 25
62 2 laforge
  * OML E1 Timeslot must be 1 and the full 64kbps timeslot (Full Slot)
63
{{{
64
SITE MANAGER  ATTRIBUTES:
65
        E1 Channel: Port=0 Timeslot=1 (Full Slot)
66
        TEI: 25
67 1 laforge
}}}
68 7 laforge
  * It is normal if you see a GET ATTRIBUTE NACK at the end of the output, as the ''query'' mode tries to
69
    query the PA RF Power setting of TRX1 (which by default is not enabled at all).
70 1 laforge
71 9 laforge
=== TEI / E1 timeslot ===
72
73 6 laforge
If your TEI or E1 Timeslot is configured to a wrong value, you can use the following sequence of commands to fix it:
74
{{{
75
$ ./bs11_config disconnect # you should now be in ''State 2 Maintenance''
76
$ ./bs11_config oml-tei    # you will see a SET ATTRIBUTE ACK and can then terminate the program
77
$ ./bs11_config reconnect  # brings you back to ''State 3 Normal''.
78
$ ./bs11_config query      # to verify that the setting of E1 Timeslot and TEI is now correct
79
}}}
80
81
If you see any other difference (i.e. not reaching ''Phase 3 Normal'' or no ''MBCCU0 Load'') please
82 1 laforge
contact the openbsc@lists.gnumonks.org mailinglist with the full details.
83
84
If everything is correct, you can proceed as follows:
85 9 laforge
86
=== PLL Mode ===
87
88
The PLL of the BS-11 can be set to two different modes:
89
 # Locked to the E1 clock that is received from the HFC-E1 card
90
 # A built-in standalone oscillator
91
92
Unless you have some accurate E1 clock source (like a physical ISDN line to a telephone network), we recommend you
93
configure the PLL Mode to ''Standalone''
94
95
==== Standalone ====
96
{{{
97
$ ./bs11_config disconnect
98
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
99
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
100
101
LMT LOGON: ACK
102
103
PHASE: 3 Normal               MBCCU0: Load        MBCCU1: Load        Abis-link: Restoring 
104
PHASE: 2 Maintenance          MBCCU0: Load        MBCCU1: Load        Abis-link: Down      
105
LMT LOGOFF: ACK
106
}}}
107
{{{
108
$ ./bs11_config pll-standalone
109
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
110
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
111
112
LMT LOGON: ACK
113
114
PHASE: 2 Maintenance          MBCCU0: Load        MBCCU1: Load        Abis-link: Down      
115
SET ATTRIBUTE ObjClass=0xa5 ObjInst=(7,0,0) ACK
116
LMT LOGOFF: ACK
117
}}}
118
119
==== E1 Locked ====
120
121
Like above, but using
122
{{{
123
$ ./bs11_config pll-e1-locked
124
}}}
125
instead.
126
127 1 laforge
128
== Preparing the E1 card ==
129
130
=== HFC-E1 Evaluation Board ===
131
132
 * make sure you configure the jumpers for NT Mode and Termination to 120 Ohms, reference [wiki:HFC-E1]
133
134 14 dexter
[[Image(jughanns_E1_openBSC_settings.jpg) width=30%]]
135
136
Note: The image shows a Junghanns HFC-E1 card configured to work with openBSC/BS11
137
138 1 laforge
== Preparing your PC ==
139
140 12 laforge
 * Install a current (>= 2.6.30) Linux kernel source
141
   * if you have to use an older kernel, Apply the patch from svn trunk/linux-kernel to your kernel
142 1 laforge
 * Configure the kernel as usual, make sure you enable the mISDN core and driver for HFC-E1 (hfcmulti)
143
 * Install and boot the kernel, load hfcmulti '''with dslot=1 module load parameter'''
144 11 laforge
 * Check out the latest git version of OpenBSC
145 1 laforge
 * Compile it
146 8 zecke
  * You need the following build dependencies: autoconf, automake, gcc, libc6-dev, libdbi-dev, libdbd-sqlite3
147 3 laforge
{{{
148 11 laforge
git clone git://bs11-abis.gnumonks.org/openbsc.git
149
cd openbsc/openbsc
150
autoreconf -i
151 3 laforge
./configure
152
make
153
}}}
154
  * You may experience compilation problems when you use the latest and greatest trunk version. This is a normal behavior, since OpenBSC is under heavy development. Please contact the mailing list and ask for help in that case.
155 1 laforge
156 10 laforge
Getting started under Debian: [wiki:Debian_Getting_Started]
157
158 1 laforge
== Testing the E1 Link ==
159
160
 * connect the RJ45 plug of the E1 cable with your E1 card in the PC
161
 * connect the two twinax connectors of your E1 cable (correctly!) to the BS-11 connector board, use the two leftmost connectors
162
 * keep the LMT / RS232 cable connected
163
 * power-on the BS-11 if it is not already powered-up
164
 * Start bs11_config and wait until you enter ''Phase 3 Normal, Abis-Link: Restoring''
165 5 laforge
 * run the "bsc_hack" program, pass it the '-f ' paramenter for the [http://www.telecomabc.com/a/arfcn.html ARFCN] you want to use.  '''Make sure you use a frequency that you have permission to use''', and/or limit your output power to a level that you are allowed to transmit.  The default ARFCN is 123.
166 1 laforge
 * Verify that bs11_config now prints ''Phase 3 Normal, Abis-Link: Up''
167
 * bsc_hack should print you a lot of yellow lines about setting channel attributes and event state changes
168
 * at some point you should see 'Bootstrapping RSL'
169
 * congratulations, your BS-11 should be running and you should see the BCCH (network ID 01-001) from a GSM phone.
Add picture from clipboard (Maximum size: 48.8 MB)