Project

General

Profile

Bs11 config » History » Version 11

laforge, 02/20/2016 07:20 PM

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