wiki:bs11_config

bs11_config is a small commandline program that can be used to configure the 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)
Last modified 3 years ago Last modified on Dec 14, 2010, 12:43:19 PM