Project

General

Profile

Bs11 config » History » Version 12

laforge, 02/21/2016 11:12 AM

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