Project

General

Profile

BS11Getting Started » History » Version 22

laforge, 02/19/2016 10:48 PM
Name changed from BS11_Getting_Started to BS11/Getting_Started

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 1 laforge
3 1 laforge
4 22 laforge
h2. Check Package contents
5 22 laforge
6 22 laforge
7 22 laforge
Please check the [[BS11Package_List|Packing List]] and see if you can find all the items in your two boxes.
8 1 laforge
If there is any doubt, please contact the openbsc mailing list and ask for help.
9 1 laforge
10 1 laforge
11 22 laforge
h2. Unpacking the BS-11
12 22 laforge
13 22 laforge
14 7 laforge
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
15 7 laforge
are not meant to be lifted by a single person.
16 1 laforge
17 1 laforge
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,
18 1 laforge
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
19 1 laforge
or other surface.
20 1 laforge
21 22 laforge
*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
22 22 laforge
it +vertically+ to a pole or wall, since this enables airflow through through the cooling fins*
23 1 laforge
24 1 laforge
25 22 laforge
h2. Build a power cable
26 7 laforge
27 1 laforge
28 22 laforge
Please follow the instructions at [[BS11Configuration]] to manufacture the power cable
29 22 laforge
30 22 laforge
31 22 laforge
h2. Build E1 cable
32 22 laforge
33 22 laforge
34 22 laforge
Please follow the instructions at [[BS11Configuration]] to manufacture the E1 cable
35 20 laforge
from RJ45 to the strange RADIALL twinax connectors
36 1 laforge
37 1 laforge
38 22 laforge
h2. Configure the BS-11 Jumpers
39 22 laforge
40 22 laforge
41 1 laforge
If you remove the connector cover (loosen three Philips screws), you will uncover the four E1 connectors,
42 1 laforge
as well as the RS232 ports.  There are also four green jumpers at the side of the connector panel.  The
43 1 laforge
factory default of those connectors is 75Ohms.  You need to remove all of the four jumpers to switch to
44 1 laforge
120Ohms termination.
45 1 laforge
46 1 laforge
[[Image(bs-11_panel.jpg,30%)]]
47 1 laforge
48 1 laforge
Note: The image shows the panel of a working BS11. As you can see, all jumers are removed.
49 1 laforge
50 1 laforge
51 22 laforge
h2. Mount and connect the BS-11 Antenna
52 22 laforge
53 22 laforge
54 1 laforge
The Antenna needs to be attached to the BS11 main unit by the means of four screws.  Screws are included in
55 1 laforge
a small plastic bag.
56 1 laforge
57 1 laforge
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.
58 1 laforge
59 1 laforge
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.
60 7 laforge
61 1 laforge
Note: The antenna connectors are formaly known as "N-Connectors"
62 1 laforge
63 1 laforge
64 22 laforge
h2. Test the BS-11 status and configuration
65 22 laforge
66 22 laforge
67 22 laforge
* connect the power plug to the BS-11
68 22 laforge
* connect the RS232 cable to J2 of the BS-11 (see photograph)
69 22 laforge
* connect the RS232 cable to your PC
70 22 laforge
* switch on the power switch of the BS-11 (the LED should light up green in 2-3 seconds)
71 22 laforge
* start the _bs11_config_ program to observe the boot process (see [[bs11_config]] for details)
72 22 laforge
** you should observe the boot process like it is indicated at the [[bs11_config]] page
73 22 laforge
** at the end of the process (10 minutes or so), you should have _Phase 3 Normal_ and _MBCCU0 Load_ and _Abis-Link Restoring_
74 22 laforge
** MBCCU1 might be _Load_ or _No Load_, depending on whether TRX1 is activated or not
75 22 laforge
<pre>
76 2 laforge
PHASE: 3 Normal               MBCCU0: Load        MBCCU1: No Load     Abis-link: Restoring
77 22 laforge
</pre>
78 22 laforge
* Once you are in "Phase 3 Normal", use _bs11_config query_ to query the configuration
79 22 laforge
** OML TEI must be 25
80 22 laforge
** OML E1 Timeslot must be 1 and the full 64kbps timeslot (Full Slot)
81 22 laforge
<pre>
82 1 laforge
SITE MANAGER  ATTRIBUTES:
83 9 laforge
        E1 Channel: Port=0 Timeslot=1 (Full Slot)
84 6 laforge
        TEI: 25
85 22 laforge
</pre>
86 22 laforge
** It is normal if you see a GET ATTRIBUTE NACK at the end of the output, as the _query_ mode tries to
87 6 laforge
    query the PA RF Power setting of TRX1 (which by default is not enabled at all).
88 6 laforge
89 6 laforge
90 22 laforge
h3. TEI / E1 timeslot
91 22 laforge
92 22 laforge
93 1 laforge
If your TEI or E1 Timeslot is configured to a wrong value, you can use the following sequence of commands to fix it:
94 22 laforge
<pre>
95 22 laforge
$ ./bs11_config disconnect # you should now be in _State 2 Maintenance_
96 9 laforge
$ ./bs11_config oml-tei    # you will see a SET ATTRIBUTE ACK and can then terminate the program
97 22 laforge
$ ./bs11_config reconnect  # brings you back to _State 3 Normal_.
98 1 laforge
$ ./bs11_config query      # to verify that the setting of E1 Timeslot and TEI is now correct
99 22 laforge
</pre>
100 9 laforge
101 22 laforge
If you see any other difference (i.e. not reaching _Phase 3 Normal_ or no _MBCCU0 Load_) please
102 1 laforge
contact the openbsc@lists.gnumonks.org mailinglist with the full details.
103 1 laforge
104 1 laforge
If everything is correct, you can proceed as follows:
105 1 laforge
106 9 laforge
107 22 laforge
h3. PLL Mode
108 22 laforge
109 22 laforge
110 1 laforge
The PLL of the BS-11 can be set to two different modes:
111 1 laforge
 # Locked to the E1 clock that is received from the HFC-E1 card
112 1 laforge
 # A built-in standalone oscillator
113 1 laforge
114 1 laforge
Unless you have some accurate E1 clock source (like a physical ISDN line to a telephone network), we recommend you
115 22 laforge
configure the PLL Mode to _Standalone_
116 1 laforge
117 22 laforge
118 22 laforge
h4. Standalone
119 22 laforge
120 22 laforge
<pre>
121 1 laforge
$ ./bs11_config disconnect
122 1 laforge
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
123 1 laforge
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
124 1 laforge
125 1 laforge
LMT LOGON: ACK
126 1 laforge
127 1 laforge
PHASE: 3 Normal               MBCCU0: Load        MBCCU1: Load        Abis-link: Restoring 
128 1 laforge
PHASE: 2 Maintenance          MBCCU0: Load        MBCCU1: Load        Abis-link: Down      
129 1 laforge
LMT LOGOFF: ACK
130 22 laforge
</pre>
131 22 laforge
<pre>
132 1 laforge
$ ./bs11_config pll-standalone
133 1 laforge
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
134 1 laforge
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
135 9 laforge
136 9 laforge
LMT LOGON: ACK
137 9 laforge
138 9 laforge
PHASE: 2 Maintenance          MBCCU0: Load        MBCCU1: Load        Abis-link: Down      
139 22 laforge
SET ATTRIBUTE [[ObjClass]]=0xa5 [[ObjInst]]=(7,0,0) ACK
140 9 laforge
LMT LOGOFF: ACK
141 22 laforge
</pre>
142 9 laforge
143 9 laforge
144 22 laforge
h4. E1 Locked
145 22 laforge
146 22 laforge
147 1 laforge
Like above, but using
148 22 laforge
<pre>
149 1 laforge
$ ./bs11_config pll-e1-locked
150 22 laforge
</pre>
151 1 laforge
instead.
152 1 laforge
153 1 laforge
154 15 dexter
155 22 laforge
h2. Preparing the E1 card
156 14 dexter
157 14 dexter
158 22 laforge
159 22 laforge
h3. HFC-E1 Evaluation Board
160 22 laforge
161 22 laforge
162 22 laforge
* make sure you configure the jumpers for NT Mode and Termination to 120 Ohms, reference [[HFC-E1]]
163 22 laforge
164 1 laforge
[[Image(jughanns_E1_openBSC_settings.jpg,30%)]]
165 1 laforge
166 11 laforge
Note: The image shows a Junghanns HFC-E1 card configured to work with openBSC/BS11
167 1 laforge
168 8 zecke
Note: In the picture the JP3 Jumper, which configures the power supply is configured to use the 3,3V power source from the PCI-BUS. If your mainboard does not have a 3,3V power surce your card will refuse to work. If you are unsure, do not touch JP3
169 3 dimitri
170 19 laforge
171 22 laforge
h2. Preparing your PC
172 22 laforge
173 22 laforge
174 22 laforge
* Install a current (>= 2.6.31) Linux kernel source
175 22 laforge
*** if you have to use an older kernel, Apply the patch from svn trunk/linux-kernel to your kernel
176 22 laforge
* Configure the kernel as usual, make sure you enable the mISDN core and driver for HFC-E1 (hfcmulti)
177 22 laforge
* Install and boot the kernel, load hfcmulti *with dslot=1 module load parameter*
178 22 laforge
* Check out the latest git version of [[OpenBSC]]
179 22 laforge
* Compile it
180 22 laforge
** You need the following build dependencies: autoconf, automake, gcc, libc6-dev, libdbi-dev, libdbd-sqlite3
181 22 laforge
<pre>
182 1 laforge
git clone git://git.osmocom.org/openbsc.git
183 1 laforge
cd openbsc/openbsc
184 1 laforge
autoreconf -i
185 1 laforge
./configure
186 1 laforge
make
187 22 laforge
</pre>
188 22 laforge
** 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.
189 20 laforge
190 22 laforge
Getting started under Debian: [[Building_OpenBSC]]
191 1 laforge
192 1 laforge
193 22 laforge
h2. Testing the E1 Link
194 22 laforge
195 22 laforge
196 22 laforge
* connect the RJ45 plug of the E1 cable with your E1 card in the PC
197 22 laforge
* connect the two twinax connectors of your E1 cable (correctly!) to the BS-11 connector board, use the two leftmost connectors
198 22 laforge
* keep the LMT / RS232 cable connected
199 22 laforge
* power-on the BS-11 if it is not already powered-up
200 22 laforge
* Start bs11_config and wait until you enter _Phase 3 Normal, Abis-Link: Restoring_
201 22 laforge
* run the "[[osmo-nitb]]" program, pass it the '-f ' paramenter for the "ARFCN":http://www.telecomabc.com/a/arfcn.html 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.
202 22 laforge
* Verify that bs11_config now prints _Phase 3 Normal, Abis-Link: Up_
203 22 laforge
* [[osmo-nitb]] should print you a lot of yellow lines about setting channel attributes and event state changes
204 22 laforge
* at some point you should see 'Bootstrapping RSL'
205 22 laforge
* 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)