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)
}}}