Project

General

Profile

BS11Getting Started » History » Version 19

laforge, 02/19/2016 10:47 PM
git repo url change

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 16 dexter
[[Image(bs-11_panel.jpg,30%)]]
37
38
Note: The image shows the panel of a working BS11. As you can see, all jumers are removed.
39
40 1 laforge
== Mount and connect the BS-11 Antenna ==
41
42
The Antenna needs to be attached to the BS11 main unit by the means of four screws.  Screws are included in
43
a small plastic bag.
44
45
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 laforge
47
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
51 1 laforge
== Test the BS-11 status and configuration ==
52
53
 * connect the power plug to the BS-11
54
 * connect the RS232 cable to J2 of the BS-11 (see photograph)
55
 * connect the RS232 cable to your PC
56
 * 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
  * at the end of the process (10 minutes or so), you should have ''Phase 3 Normal'' and ''MBCCU0 Load'' and ''Abis-Link Restoring''
60
  * MBCCU1 might be ''Load'' or ''No Load'', depending on whether TRX1 is activated or not
61 2 laforge
{{{
62
PHASE: 3 Normal               MBCCU0: Load        MBCCU1: No Load     Abis-link: Restoring
63
}}}
64 1 laforge
 * Once you are in "Phase 3 Normal", use ''bs11_config query'' to query the configuration
65
  * OML TEI must be 25
66 2 laforge
  * OML E1 Timeslot must be 1 and the full 64kbps timeslot (Full Slot)
67
{{{
68
SITE MANAGER  ATTRIBUTES:
69
        E1 Channel: Port=0 Timeslot=1 (Full Slot)
70
        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
    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
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
{{{
79
$ ./bs11_config disconnect # you should now be in ''State 2 Maintenance''
80
$ ./bs11_config oml-tei    # you will see a SET ATTRIBUTE ACK and can then terminate the program
81
$ ./bs11_config reconnect  # brings you back to ''State 3 Normal''.
82
$ ./bs11_config query      # to verify that the setting of E1 Timeslot and TEI is now correct
83
}}}
84
85
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
88
If everything is correct, you can proceed as follows:
89 9 laforge
90
=== PLL Mode ===
91
92
The PLL of the BS-11 can be set to two different modes:
93
 # Locked to the E1 clock that is received from the HFC-E1 card
94
 # A built-in standalone oscillator
95
96
Unless you have some accurate E1 clock source (like a physical ISDN line to a telephone network), we recommend you
97
configure the PLL Mode to ''Standalone''
98
99
==== Standalone ====
100
{{{
101
$ ./bs11_config disconnect
102
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
103
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
104
105
LMT LOGON: ACK
106
107
PHASE: 3 Normal               MBCCU0: Load        MBCCU1: Load        Abis-link: Restoring 
108
PHASE: 2 Maintenance          MBCCU0: Load        MBCCU1: Load        Abis-link: Down      
109
LMT LOGOFF: ACK
110
}}}
111
{{{
112
$ ./bs11_config pll-standalone
113
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
114
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
115
116
LMT LOGON: ACK
117
118
PHASE: 2 Maintenance          MBCCU0: Load        MBCCU1: Load        Abis-link: Down      
119
SET ATTRIBUTE ObjClass=0xa5 ObjInst=(7,0,0) ACK
120
LMT LOGOFF: ACK
121
}}}
122
123
==== E1 Locked ====
124
125
Like above, but using
126
{{{
127
$ ./bs11_config pll-e1-locked
128
}}}
129
instead.
130
131 1 laforge
132
== Preparing the E1 card ==
133
134
=== HFC-E1 Evaluation Board ===
135
136
 * make sure you configure the jumpers for NT Mode and Termination to 120 Ohms, reference [wiki:HFC-E1]
137
138 15 dexter
[[Image(jughanns_E1_openBSC_settings.jpg,30%)]]
139 14 dexter
140
Note: The image shows a Junghanns HFC-E1 card configured to work with openBSC/BS11
141
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
144 1 laforge
== Preparing your PC ==
145
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
 * 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 laforge
{{{
154 19 laforge
git clone git://git.osmocom.org/openbsc.git
155 11 laforge
cd openbsc/openbsc
156
autoreconf -i
157 3 laforge
./configure
158
make
159
}}}
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
162 18 dexter
Getting started under Debian: [wiki:Building_OpenBSC]
163 10 laforge
164 1 laforge
== Testing the E1 Link ==
165
166
 * connect the RJ45 plug of the E1 cable with your E1 card in the PC
167
 * connect the two twinax connectors of your E1 cable (correctly!) to the BS-11 connector board, use the two leftmost connectors
168
 * keep the LMT / RS232 cable connected
169
 * power-on the BS-11 if it is not already powered-up
170
 * Start bs11_config and wait until you enter ''Phase 3 Normal, Abis-Link: Restoring''
171 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.
172 1 laforge
 * Verify that bs11_config now prints ''Phase 3 Normal, Abis-Link: Up''
173
 * bsc_hack should print you a lot of yellow lines about setting channel attributes and event state changes
174
 * at some point you should see 'Bootstrapping RSL'
175
 * 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)