Project

General

Profile

Bs11 config » History » Version 9

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

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