Project

General

Profile

BS11Getting Started » History » Version 20

laforge, 02/19/2016 10:47 PM
rename bsc_hack to osmo-nitb in page text

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