Bs11 config » History » Revision 9
Revision 8 (laforge, 02/19/2016 10:48 PM) → Revision 9/12 (laforge, 02/19/2016 10:48 PM)
[[PageOutline]]
bs11_config is a small commandline program that can be used to configure the [wiki:BS-11] BTS using its RS232 link.
It can perform a subset of the functions that are typically performed using the Siemens LMT (Local Maintenance Terminal) software, such as
* querying some essential configuration values
* creating and deleting TRX1 objects
* download of SAFETY LOAD software
* download of BTS software
* creating an initial configuration (such as creating BBSIG,CCLK,PA,... objects)
* setting the Tx output power of the RF amplifier
== Reference ==
=== Querying the BS-11 ===
{{{
$ ./bs11_config -p /dev/ttyUSB0 query
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
LMT LOGON: ACK
PHASE: 3 Normal MBCCU0: Load MBCCU1: Load Abis-link: Restoring
BS11 ATTRIBUTES:
BS-11 ESN PCB Serial Number: 001107
BS-11 ESN Hardware Code Number: 135-2044/03.07
BS-11 ESN Firmware Code Number: 135-2044/03.07
SITE MANAGER ATTRIBUTES:
E1 Channel: Port=0 Timeslot=1 (Full Slot)
TEI: 25
BS11 Power Amplifier 0 ATTRIBUTES:
TRX Power: 30mW (GSM)
BS11 Power Amplifier 1 ATTRIBUTES:
TRX Power: 30mW (GSM)
}}}
=== Disconnect ===
This puts the BTS out of Normal mode into Maintenance mode and disconnects it from the BSC
{{{
$ ./bs11_config -p /dev/ttyUSB0 disconnect
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
LMT LOGON: ACK
PHASE: 3 Normal MBCCU0: Load MBCCU1: Load Abis-link: Restoring
PHASE: 2 Maintenance MBCCU0: Load MBCCU1: Load Abis-link: Down
}}}
=== Reconnect ===
This puts the BTS out of Maintenance mode into Normal mode and reconnects it to the BSC
{{{
$ ./bs11_config -p /dev/ttyUSB0 reconnect
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
LMT LOGON: ACK
PHASE: 2 Maintenance MBCCU0: Load MBCCU1: Load Abis-link: Down
PHASE: 3 Normal MBCCU0: Load MBCCU1: Load Abis-link: Restoring
}}}
=== Download SMU Safety Load ===
{{{
$ ./bs11_config -p /dev/ttyUSB0 -S /path/to/my/BTSBMC76.SWI
}}}
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.
'''NOTE: The OpenBSC/bs11-abis project is not providing any Firmware images for the BS-11, as they are copyrighted material'''
=== Minimal Configuration ===
The minimal configuration is automatically created if the BS-11 enters the ''MINIMAL CONFIG REQUIRED'' state after the SMU safety load is installed.
=== Download Software Load ===
{{{
$ ./bs11_config -p /dev/ttyUSB0 -s /path/to/my/HS011106.SWL
}}}
If the BS-11 is not in Maintenance State, it first needs to be detached from the BSC (using -D option)
{{{
$ ./bs11_config -p /dev/ttyUSB0 -D -s /path/to/my/HS011106.SWL
}}}
If you want to force a download, just add the ''-f'' parameter.
The described procedure lasts for about a hour and should generate the following output:
{{{
./bs11_config -s bs11-flash/HS011106.SWL software
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
LMT LOGON: ACK
PHASE: 2 Maintenance MBCCU0: No Load MBCCU1: No Load Abis-link: Down
Mon May 18 20:51:34 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/HS011106.SWL")
Software Load Initiate ACK
Software Download Progress: 88%
Software Download Progress: 100%
Mon May 18 20:51:37 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
Mon May 18 20:51:37 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/VS011106.VAM")
Mon May 18 20:51:37 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
ERROR in main loop: Success
Software Load Initiate ACK
Software Download Progress: 100%
Mon May 18 20:51:38 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
Mon May 18 20:51:38 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSBMC48.SWI")
Mon May 18 20:51:38 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
ERROR in main loop: Success
PHASE: 2 Maintenance MBCCU0: No Load MBCCU1: No Load Abis-link: Down
Software Load Initiate ACK
Software Download Progress: 1%
--- cut ---
Software Download Progress: 100%
Mon May 18 21:04:05 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
Mon May 18 21:04:05 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSCAC11.SWI")
Mon May 18 21:04:05 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
ERROR in main loop: Success
Software Load Initiate ACK
Software Download Progress: 1%
--- cut ---
Software Download Progress: 100%
Mon May 18 21:10:03 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
Mon May 18 21:10:03 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSDRX22.SWI")
Mon May 18 21:10:03 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
ERROR in main loop: Success
Software Load Initiate ACK
Software Download Progress: 1%
--- cut ---
Software Download Progress: 100%
Mon May 18 21:20:31 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
Mon May 18 21:20:31 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSBBX12.SWI")
Mon May 18 21:20:31 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
ERROR in main loop: Success
Software Load Initiate ACK
Software Download Progress: 1%
--- cut ---
Software Download Progress: 100%
Mon May 18 21:26:23 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
Mon May 18 21:26:23 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSARC16.SWI")
Mon May 18 21:26:23 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
ERROR in main loop: Success
Software Load Initiate ACK
Software Download Progress: 1%
--- cut ---
Software Download Progress: 100%
Mon May 18 21:32:53 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
Mon May 18 21:32:53 2009 <0020> abis_nm.c:1337 Software Load (BTS 0, File "bs11-flash/BTSLIC10.SWI")
Mon May 18 21:32:53 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 1
ERROR in main loop: Success
Software Load Initiate ACK
Software Download Progress: 1%
--- cut ---
oftware Download Progress: 100%
Mon May 18 21:35:10 2009 <0020> abis_nm.c:1261 Software Load End (BTS 0)
Mon May 18 21:35:10 2009 <0020> abis_nm.c:1386 Activating Software (BTS 0, File "bs11-flash/HS011106.SWL")
Mon May 18 21:35:10 2009 <0020> abis_nm.c:1323 unexpected NM MT 0x08 in state 3 -> 4
ERROR in main loop: Success
Mon May 18 21:35:11 2009 <0020> abis_nm.c:1292 Activate Software DONE!
PHASE: 1 Warm Up MBCCU0: No Load MBCCU1: No Load Abis-link: Down
LMT LOGON: ACK
LMT LOGON: ACK
PHASE: 1 Warm Up MBCCU0: No Load MBCCU1: No Load Abis-link: Down
PHASE: 1 Warm Up MBCCU0: No Load MBCCU1: No Load Abis-link: Down
PHASE: 1 Warm Up Abis-link: Down
--- cut ---
PHASE: 1 Load SMU Intended Abis-link: Down
--- cut ---
PHASE: 2 Load MBCCU MBCCU0: No Load MBCCU1: No Load Abis-link: Down
PHASE: 2 Load MBCCU MBCCU0: Load BTSCAC MBCCU1: No Load Abis-link: Down
PHASE: 2 Load MBCCU MBCCU0: Load BTSDRX MBCCU1: No Load Abis-link: Down
PHASE: 2 Load MBCCU MBCCU0: Load BTSBBX MBCCU1: No Load Abis-link: Down
PHASE: 2 Load MBCCU MBCCU0: Load BTSARC MBCCU1: No Load Abis-link: Down
PHASE: 2 Load MBCCU MBCCU0: Load MBCCU1: No Load Abis-link: Down
PHASE: 2 Warm Up MBCCU0: Load MBCCU1: No Load Abis-link: Down
PHASE: 3 Normal MBCCU0: Load MBCCU1: No Load Abis-link: Restoring
}}}
'''NOTE: OpenBSC is not providing any Firmware images for the BS-11'''
=== Observing BS-11 boot process ===
This is the output of bs11_config while observing the boot process. You will see every line
many times, as the status is refreshed every five seconds.
{{{
$./bs11_config -p /dev/ttyUSB0
bs11_config (C) 2009 by Harald Welte and Dieter Spaar
This is FREE SOFTWARE with ABSOLUTELY NO WARRANTY
LMT LOGON: ACK
T-Link: Down Abis-link: Down MBCCU0: No Load MBCCU1: No Load PHASE: 1 SUBPHASE: Warm Up...
T-Link: Down Abis-link: Down MBCCU0: No Load MBCCU1: No Load PHASE: 1 SUBPHASE: Load SMU Intended...
T-Link: Down Abis-link: Down MBCCU0: No Load MBCCU1: No Load PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Down MBCCU0: No Load MBCCU1: Load BTSCAC PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Down MBCCU0: Load BTSCAC MBCCU1: Load BTSCAC PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Down MBCCU0: Load BTSCAC MBCCU1: Load BTSDRX PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Down MBCCU0: Load BTSDRX MBCCU1: Load BTSDRX PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Down MBCCU0: Load BTSDRX MBCCU1: Load BTSBBX PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Down MBCCU0: Load BTSBBX MBCCU1: Load BTSBBX PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Down MBCCU0: Load BTSBBX MBCCU1: Load BTSARC PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Down MBCCU0: Load BTSARC MBCCU1: Load BTSARC PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Down MBCCU0: Load BTSARC MBCCU1: Load PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Down MBCCU0: Load MBCCU1: Load PHASE: 2 SUBPHASE: Load MBCCU...
T-Link: Down Abis-link: Restoring MBCCU0: Load MBCCU1: Load PHASE: 3 SUBPHASE: Normal...
T-Link: Down Abis-link: Up MBCCU0: Load MBCCU1: Load PHASE: 3 SUBPHASE: Normal...
}}}
=== Configuring Multi-Drop setup ===
A multi-drop setup is where multiple BS-11 are daisy-chained next to each other on a single E1 line.
All but the last BS-11 in the chain will have to be configured to
* have BPORT0 in multi-drop mode
* create a BPORT1 object
* have BPORT1 to be set in multi-drop mode.
You can achieve this by the following bs11_config command sequence:
{{{
$ ./bs11_config bport0-multidrop
$ ./bs11_config create-bport1
$ ./bs11_config bport1-multidrop
}}}
You can verify the results to show in '''query''' like this:
{{{
BPORT0 ATTRIBUTES:
Line Configuration: Multi-Drop (1)
BPORT1 ATTRIBUTES:
Line Configuration: Multi-Drop (1)
}}}
