Cellular Network Infrastructure » Radio Access Network » OsmoBSC

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: 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.

'''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...

}}}