Project

General

Profile

Bs11 config » History » Version 10

laforge, 02/19/2016 10:48 PM
add information on multi-drop

1 10 laforge
{{>toc}}
2
bs11_config is a small commandline program that can be used to configure the [[BS-11]] BTS using its RS232 link.
3 1 laforge
4
It can perform a subset of the functions that are typically performed using the Siemens LMT (Local Maintenance Terminal) software, such as
5 10 laforge
* querying some essential configuration values
6
* creating and deleting TRX1 objects
7
* download of SAFETY LOAD software
8
* download of BTS software
9
* creating an initial configuration (such as creating BBSIG,CCLK,PA,... objects)
10
* setting the Tx output power of the RF amplifier
11 1 laforge
12
13 10 laforge
h2. Reference
14 1 laforge
15 10 laforge
16
17
h3. Querying the BS-11
18
19
20
<pre>
21 5 laforge
$ ./bs11_config -p /dev/ttyUSB0 query
22
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
23
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
24
25
LMT LOGON: ACK
26
27
PHASE: 3 Normal               MBCCU0: Load        MBCCU1: Load        Abis-link: Restoring 
28
29
BS11  ATTRIBUTES:
30
        BS-11 ESN PCB Serial Number: 001107
31 1 laforge
        BS-11 ESN Hardware Code Number: 135-2044/03.07
32 5 laforge
        BS-11 ESN Firmware Code Number: 135-2044/03.07
33 1 laforge
34
SITE MANAGER  ATTRIBUTES:
35
        E1 Channel: Port=0 Timeslot=1 (Full Slot)
36 5 laforge
        TEI: 25
37 1 laforge
38 5 laforge
BS11 Power Amplifier 0  ATTRIBUTES:
39
        TRX Power: 30mW (GSM)
40
41
BS11 Power Amplifier 1  ATTRIBUTES:
42
        TRX Power: 30mW (GSM)
43 10 laforge
</pre>
44 5 laforge
45 1 laforge
46 10 laforge
h3. Disconnect
47
48
49 1 laforge
This puts the BTS out of Normal mode into Maintenance mode and disconnects it from the BSC
50 5 laforge
51 10 laforge
<pre>
52 5 laforge
$ ./bs11_config -p /dev/ttyUSB0 disconnect
53
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
54
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
55
56
LMT LOGON: ACK
57
58
PHASE: 3 Normal               MBCCU0: Load        MBCCU1: Load        Abis-link: Restoring 
59 1 laforge
PHASE: 2 Maintenance          MBCCU0: Load        MBCCU1: Load        Abis-link: Down      
60 10 laforge
</pre>
61 1 laforge
62
63 10 laforge
h3. Reconnect
64
65
66 5 laforge
This puts the BTS out of Maintenance mode into Normal mode and reconnects it to the BSC
67
68 10 laforge
<pre>
69 1 laforge
$ ./bs11_config -p /dev/ttyUSB0 reconnect
70
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
71
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
72
73
LMT LOGON: ACK
74
75
PHASE: 2 Maintenance          MBCCU0: Load        MBCCU1: Load        Abis-link: Down      
76
PHASE: 3 Normal               MBCCU0: Load        MBCCU1: Load        Abis-link: Restoring 
77 10 laforge
</pre>
78 5 laforge
79 1 laforge
80 10 laforge
h3. Download SMU Safety Load
81
82
83
<pre>
84 1 laforge
$ ./bs11_config -p /dev/ttyUSB0 -S /path/to/my/BTSBMC76.SWI
85 10 laforge
</pre>
86 1 laforge
87 3 laforge
Note: When the SMU Safety download has completed and the minimal configuration has been created you should let the BS11 boot the first time. The power LED will light up red - this is normal. After the boot you will be able to query the BS11. Bring it into the maintenance (disconnect) mode and proceed with the software download.
88
89
90 10 laforge
*NOTE: The [[OpenBSC]]/bs11-abis project is not providing any Firmware images for the BS-11, as they are copyrighted material*
91 7 dexter
92
93 10 laforge
h3. Minimal Configuration
94 4 laforge
95 3 laforge
96 10 laforge
The minimal configuration is automatically created if the BS-11 enters the _MINIMAL CONFIG REQUIRED_ state after the SMU safety load is installed.
97
98
99
h3. Download Software Load
100
101
102
<pre>
103 3 laforge
$ ./bs11_config -p /dev/ttyUSB0 -s /path/to/my/HS011106.SWL
104 10 laforge
</pre>
105 3 laforge
106
If the BS-11 is not in Maintenance State, it first needs to be detached from the BSC (using -D option)
107 10 laforge
<pre>
108 3 laforge
$ ./bs11_config -p /dev/ttyUSB0 -D -s /path/to/my/HS011106.SWL
109 10 laforge
</pre>
110 3 laforge
111 10 laforge
If you want to force a download, just add the _-f_ parameter.
112 3 laforge
113 6 laforge
The described procedure lasts for about a hour and should generate the following output:
114 10 laforge
<pre>
115 6 laforge
./bs11_config -s bs11-flash/HS011106.SWL software
116
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
117
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
118
119
LMT LOGON: ACK
120
121
PHASE: 2 Maintenance          MBCCU0: No Load     MBCCU1: No Load     Abis-link: Down      
122
Mon May 18 20:51:34 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/HS011106.SWL")
123
Software Load Initiate ACK
124
Software Download Progress: 88%
125
Software Download Progress: 100%
126
Mon May 18 20:51:37 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
127
Mon May 18 20:51:37 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/VS011106.VAM")
128
Mon May 18 20:51:37 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
129
ERROR in main loop: Success
130
Software Load Initiate ACK
131
Software Download Progress: 100%
132
Mon May 18 20:51:38 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
133
Mon May 18 20:51:38 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSBMC48.SWI")
134
Mon May 18 20:51:38 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
135
ERROR in main loop: Success
136
PHASE: 2 Maintenance          MBCCU0: No Load     MBCCU1: No Load     Abis-link: Down      
137
Software Load Initiate ACK
138
Software Download Progress: 1%
139
--- cut ---
140
Software Download Progress: 100%
141
Mon May 18 21:04:05 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
142
Mon May 18 21:04:05 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSCAC11.SWI")
143
Mon May 18 21:04:05 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
144
ERROR in main loop: Success
145
Software Load Initiate ACK
146
Software Download Progress: 1%
147
--- cut ---
148
Software Download Progress: 100%
149
Mon May 18 21:10:03 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
150
Mon May 18 21:10:03 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSDRX22.SWI")
151
Mon May 18 21:10:03 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
152
ERROR in main loop: Success
153
Software Load Initiate ACK
154
Software Download Progress: 1%
155
--- cut ---
156
Software Download Progress: 100%
157
Mon May 18 21:20:31 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
158
Mon May 18 21:20:31 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSBBX12.SWI")
159
Mon May 18 21:20:31 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
160
ERROR in main loop: Success
161
Software Load Initiate ACK
162
Software Download Progress: 1%
163
--- cut ---
164
Software Download Progress: 100%
165
Mon May 18 21:26:23 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
166
Mon May 18 21:26:23 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSARC16.SWI")
167
Mon May 18 21:26:23 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
168
ERROR in main loop: Success
169
Software Load Initiate ACK
170
Software Download Progress: 1%
171
--- cut ---
172
Software Download Progress: 100%
173 1 laforge
Mon May 18 21:32:53 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
174
Mon May 18 21:32:53 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSLIC10.SWI")
175 6 laforge
Mon May 18 21:32:53 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
176 1 laforge
ERROR in main loop: Success
177
Software Load Initiate ACK
178
Software Download Progress: 1%
179 6 laforge
--- cut ---
180
oftware Download Progress: 100%
181 1 laforge
Mon May 18 21:35:10 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
182 6 laforge
Mon May 18 21:35:10 2009 <0020> abis_nm.c:1386 Activating Software (BTS 0, File "bs11-flash/HS011106.SWL")
183
Mon May 18 21:35:10 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 4
184
ERROR in main loop: Success
185
Mon May 18 21:35:11 2009 <0020> abis_nm.c:1292 Activate Software DONE!
186
PHASE: 1 Warm Up              MBCCU0: No Load     MBCCU1: No Load     Abis-link: Down      
187
LMT LOGON: ACK
188
189
LMT LOGON: ACK
190
191
PHASE: 1 Warm Up              MBCCU0: No Load     MBCCU1: No Load     Abis-link: Down      
192
PHASE: 1 Warm Up              MBCCU0: No Load     MBCCU1: No Load     Abis-link: Down      
193
PHASE: 1 Warm Up              Abis-link: Down      
194
--- cut ---
195
PHASE: 1 Load SMU Intended    Abis-link: Down      
196
--- cut ---
197
PHASE: 2 Load MBCCU           MBCCU0: No Load     MBCCU1: No Load     Abis-link: Down      
198
PHASE: 2 Load MBCCU           MBCCU0: Load BTSCAC MBCCU1: No Load     Abis-link: Down      
199
PHASE: 2 Load MBCCU           MBCCU0: Load BTSDRX MBCCU1: No Load     Abis-link: Down      
200 3 laforge
PHASE: 2 Load MBCCU           MBCCU0: Load BTSBBX MBCCU1: No Load     Abis-link: Down      
201 1 laforge
PHASE: 2 Load MBCCU           MBCCU0: Load BTSARC MBCCU1: No Load     Abis-link: Down      
202 2 laforge
PHASE: 2 Load MBCCU           MBCCU0: Load        MBCCU1: No Load     Abis-link: Down      
203 1 laforge
PHASE: 2 Warm Up              MBCCU0: Load        MBCCU1: No Load     Abis-link: Down      
204
PHASE: 3 Normal               MBCCU0: Load        MBCCU1: No Load     Abis-link: Restoring
205 10 laforge
</pre>
206 1 laforge
207 10 laforge
*NOTE: [[OpenBSC]] is not providing any Firmware images for the BS-11*
208 1 laforge
209 2 laforge
210 10 laforge
h3. Observing BS-11 boot process
211
212
213 1 laforge
This is the output of bs11_config while observing the boot process.  You will see every line
214
many times, as the status is refreshed every five seconds.
215 2 laforge
216 10 laforge
<pre>
217 2 laforge
$./bs11_config -p /dev/ttyUSB0
218
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
219 1 laforge
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
220 2 laforge
221
LMT LOGON: ACK
222
T-Link: Down      Abis-link: Down      MBCCU0: No Load     MBCCU1: No Load     PHASE: 1 SUBPHASE: Warm Up...
223
T-Link: Down      Abis-link: Down      MBCCU0: No Load     MBCCU1: No Load     PHASE: 1 SUBPHASE: Load SMU Intended...
224
T-Link: Down      Abis-link: Down      MBCCU0: No Load     MBCCU1: No Load     PHASE: 2 SUBPHASE: Load MBCCU...
225
T-Link: Down      Abis-link: Down      MBCCU0: No Load     MBCCU1: Load BTSCAC PHASE: 2 SUBPHASE: Load MBCCU...
226
T-Link: Down      Abis-link: Down      MBCCU0: Load BTSCAC MBCCU1: Load BTSCAC PHASE: 2 SUBPHASE: Load MBCCU...
227
T-Link: Down      Abis-link: Down      MBCCU0: Load BTSCAC MBCCU1: Load BTSDRX PHASE: 2 SUBPHASE: Load MBCCU...
228
T-Link: Down      Abis-link: Down      MBCCU0: Load BTSDRX MBCCU1: Load BTSDRX PHASE: 2 SUBPHASE: Load MBCCU...
229
T-Link: Down      Abis-link: Down      MBCCU0: Load BTSDRX MBCCU1: Load BTSBBX PHASE: 2 SUBPHASE: Load MBCCU...
230
T-Link: Down      Abis-link: Down      MBCCU0: Load BTSBBX MBCCU1: Load BTSBBX PHASE: 2 SUBPHASE: Load MBCCU...
231
T-Link: Down      Abis-link: Down      MBCCU0: Load BTSBBX MBCCU1: Load BTSARC PHASE: 2 SUBPHASE: Load MBCCU...
232
T-Link: Down      Abis-link: Down      MBCCU0: Load BTSARC MBCCU1: Load BTSARC PHASE: 2 SUBPHASE: Load MBCCU...
233
T-Link: Down      Abis-link: Down      MBCCU0: Load BTSARC MBCCU1: Load        PHASE: 2 SUBPHASE: Load MBCCU...
234
T-Link: Down      Abis-link: Down      MBCCU0: Load        MBCCU1: Load        PHASE: 2 SUBPHASE: Load MBCCU...
235
T-Link: Down      Abis-link: Restoring MBCCU0: Load        MBCCU1: Load        PHASE: 3 SUBPHASE: Normal...
236
T-Link: Down      Abis-link: Up        MBCCU0: Load        MBCCU1: Load        PHASE: 3 SUBPHASE: Normal...
237 10 laforge
</pre>
238 2 laforge
239 9 laforge
240 10 laforge
h3. Configuring Multi-Drop setup
241
242
243 9 laforge
A multi-drop setup is where multiple BS-11 are daisy-chained next to each other on a single E1 line.
244
245
All but the last BS-11 in the chain will have to be configured to
246 10 laforge
* have BPORT0 in multi-drop mode
247
* create a BPORT1 object
248
* have BPORT1 to be set in multi-drop mode.
249 9 laforge
250
You can achieve this by the following bs11_config command sequence:
251 10 laforge
<pre>
252 9 laforge
$ ./bs11_config bport0-multidrop
253
$ ./bs11_config create-bport1
254
$ ./bs11_config bport1-multidrop
255 10 laforge
</pre>
256 9 laforge
257 10 laforge
You can verify the results to show in *query* like this:
258
<pre>
259 9 laforge
BPORT0 ATTRIBUTES:
260
        Line Configuration: Multi-Drop (1)
261
262
BPORT1 ATTRIBUTES:
263
        Line Configuration: Multi-Drop (1)
264 10 laforge
</pre>
Add picture from clipboard (Maximum size: 48.8 MB)