Cellular Network Infrastructure » Radio Access Network » OsmoBSC

[[PageOutline]]

= CTU Console =

The CTU each have a DB-9 serial port with a RS-232 UART on them.

There is a text based command line interface available.  However, the command set seems pretty limited

== Boot up ==

During boot, there are no log messages.  Only after boot has completed, the following information

is printed:

{{{

                       EQCP TTY Operational Code

                Motorola Confidential Proprietary 1997-8

             Developed by Charlie Green and Lonnie Donovan

                    Version/Revision : 050B.0400

                    Release Date     : Jan 13 2005

                     Last Reset was a Hard Reset

EQCP >

}}}

== Level 1 Commands (BASIC) ==

=== help ===

{{{

EQCP > help

BASIC LEVEL ACCESS COMMANDS

===========================

ALARMS         CALCHK         CHKSUM         HELP           ?              

HWVER          LOGOUT         PS STAT        SN QRY         STATE          

SWVER          

}}}

=== alarms ===

{{{

EQCP > alarms

EQCP > 

        Incorrect State For Command

}}}

=== calchk ===

{{{

EQCP > calchk

EQCP > 

        RX Branch 1:  CAL  CHECKSUM   RX Branch 2:  CAL  CHECKSUM

         AIC          YES   fff6        AIC           YES   fffe

         AGC          YES   d25d        AGC           YES   ce69

         BAY          YES   720f        BAY           YES   6e43

         BBG          YES   0027 (This is for both branches.) 

         DCO          YES   8811        DCO           YES   5dd7

         FREQ         YES   ff59        FREQ          YES   fd78

         IFG          YES   0006        IFG           YES   0006

         RSSI         YES   a1e8        RSSI          YES   99f2

        TX            CAL  CHECKSUM 

         DET          YES   347e

         PWR          YES   05b6

         TX           YES   0003

         VVA          YES   8d83

}}}

=== chksum ===

{{{

EQCP > chksum

EQCP > 

        The Checksum Value is                     : $c0ffee

}}}

=== hwver ===

{{{

EQCP > hwver

EQCP > 

        The Radio Type is                         : Thor

        The RF Hardware is configured for         : DCS1800_HP

        The Hardware Version is                   : $5

}}}

=== swver ===

{{{

EQCP > swver

EQCP > 

        The Software Version is            : $50b

        The Software Revision is           : $400

        The Feature Capatibility Bitmap is : $ 0  0  0 73

}}}

=== ps stat ===

{{{

EQCP > ps stat

EQCP > 

Alarmed at the value outside -6V +/-5%

Alarmed at the value outside +6V +/-5%

Alarmed at the value under 20V

Alarmed at the value over 30V

Alarmed at the value under 12V -20%

Alarmed at the value over +3.3V +10%

Alarmed at the value outside +5V +/-5%

Alarmed at the value outside -5V +/-5%

}}}

=== sn qry ===

{{{

EQCP > sn qry

EQCP > 

Radio Serial Number :  X77F0P1APT 

Radio Kit Number    :  SWRG5197DA 

Radio Description   :  THOR 1800 XCVR 

Board Serial Number :  X77F0P18A2 

Board Kit Number    :  SWRG5198BBF 

}}}

=== state ===

{{{

EQCP > state

EQCP > 

        INVALID processor selected

}}}

== Level 2 Commands (NORMAL) ==

In order to enter Level2, you have to type in the ".gsmfw" password (the characters will be blanked over by *)

Help will now show the following additional block of commands:

{{{

NORMAL LEVEL ACCESS COMMANDS

============================

AUTO ALARM     BAYDONE        BBG            CAL BAY        CONTINUOUS     

CORREL         CSPWR          DMP TRACE      E2TEST         EQTS           

FILTER         FLASHRD        FR             IDATA          LEVAGC         

LOG            MR             MSG QUERY      QDATA          RTC            

SNDCMB         TACORR         TASK           TEST           TX 27V         

TX DET RD      TX REV         TX TEMP        UPCTL          VALDBR         

}}}

=== dmp trace ===

{{{

DMP TRACE (ALARMS)

Dumps the contents of the SPOX trace buffer or the Alarms History Log.

ALARMS - Alarms History Log

}}}

Example:

{{{

dmp trace^M^M

Start of Creating environments...

Creating streams...sci input...85f7d1 sci output...85f58f stream creation finished^M

Creating queues...queue creation finished^M

Creating semaphores...rt-act-sem...85f357

rcp-test-sem...rcp-tty-sio-sem...85f343 eq-rx-msg-sem...semaphore creation finished^M

Creating mailboxes.....hardware...85f323 state...85f2f9 equ response...85f2cf eqcp tty...85f291 ^M

msg-router...85f267 cccp-msg-if...85f23d ^M

code download...85f213 equ-msg-if...85f1e9 ^M

configuration...85f1ab calibration...85f181 ^M

eqcp alarms agent...85f157 RT Test ...85f101^M

cccp incoming...85f0d7 ^M

combiner...85efc1^M

mailbox creation finished^M

Creating tasks...hardware...state...eqcp tty...msg-router...cccp-msg-if...^M

rt control...configuration...calibration...^M

EQCP alarms agent...EQCP background task...combiner...EQCP watchdog timer task...task creation finished^M

Real Time Operating System environment completed^M

End of Creating environments...

FLASH mfc_id is: 0^M

FLASH dev_id is: 0^M

FLASH is at: 880000^M

Life_timer FLAG = 1234^M

Loading life_timer.^M

Flash AGC B1 cal chksum pass.^M

Flash AGC B2 cal chksum pass.^M

CAL & TEST TSK Param 0 Cal & Test Task Running

^M

Sending Status message to RSS...

State Task Running^M

State Task Running^M

State Task Running^M

State Task Running^M

State Task Running^M

State Task Running^M

State Task Running^M

State Task Running^M

State Task Running^M

State Task Running^M

State Task Running^M

CONFIG TSK Param 0 TTY MODE IS NORMAL

}}}

=== eqts ===

{{{

EQTS <T,D>

Sets the timeslot for commands using the test point system.

T   - Timeslot number (0-7)

D   - Disable test point system

}}}

=== e2test ===

{{{

E2TEST^M

Tests the integrity tests done on RAM.

}}}

=== bbg ===

{{{

BBG( <I,Q> <B> <V,NRM>)

Sets the baseband gain to a 2.5V peak to peak value.

No Parameter - Returns the current setting

I - In-phase component

Q - Quadrature component

B - Branch (1, 2, or Both)

V - Gain value (0-FF)

NRM - Return control to the Real Time Task

}}}

=== continuous ===

{{{

CONTINUOUS(_XX,NRM)

Adjusts the length of the pause for all

commands that support the continuous mode.

XX  - The number of timeslots to pause.

NRM - Set pause to original value.

}}}

=== correl ===

{{{

CORREL (C)

Displays the real, imaginary, and real^2+imaginary^2 results of

the correlation with the expected training sequence.

No Parameter - Return the results once.

C   - Continuous reporting

}}}

=== cspwr ===

{{{

CSPWR

Sets the Tx cell site's desired maximum output power level.

After CSPWR has started, only the following keys are valid.

[U] - Increases the power level by 0.2dB

[D] - Decreases the power level by 0.2dB

[ESC, CTRL-C, CTRL-Y] - Exits the routine and stores the offset

}}}

=== filter ===

{{{

FILTER (<X,ALL> <MC,ON,OFF>)

Allows the user to filter messages between the EQCP and CCCP in both the uplink

and downlink directions.

No Parameter - displays a list of the filters present.

X   - Filter number (0-7)

ALL - Used with ON/OFF for effect on all filters

MC  - EQCP <-> CCCP Message Code

ON  - Turn the specified filter on

OFF - Turn the specified filter off

}}}

=== flashrd ===

{{{

FLASHRD (or FR) <AAAAAA, Cal_variable> (<BBBBBB>)

Displays the value at the given memory location(s).

AAAAAA       - Memory address

BBBBBB       - Optional ending address for a block read

Cal_variable - Calibration variable:

                AGC  - Rx Automatic Gain Control Cal.

                AIC  - Rx Automatic Intermodulation Control Cal.

                BAY  - Rx Bay Level Cal.

                BBG  - Rx Baseband Gain

                DCO  - Rx DC Offset Cal.

                DET  - Tx Detector Cal.

                FREQ - Rx Frequency Offset Cal.

                IFG  - Rx Intermediate Frequency Gain

                PWR  - Tx Full Power Cal.

                RSSI - Rx Received Signal Strength Indicator Cal.

                TX   - Tx Cell Site Power Cal.

                VVA  - Tx Voltage Variable Attenuator Cal.

}}}

=== idata ===

{{{

IDATA (C)

Displays the central portion of the I-channel data.

No Parameter - Return the results once.

C   - Continuous reporting

}}}

=== levagc ===

{{{

LEVAGC (C)

Displays the RSSI, half scale error, AGC pad setting, channel type,

and subchannel number.

No Parameter - Return the results once.

C - Continuous reporting

}}}

=== log ===

{{{

LOG (A,C,P,M)

Displays a log of the state specific data that can be verified off-line.

THE CODE FOR THIS COMMAND HAS NOT BEEN IMPLEMENTED YET.

A - Active Standby

C - Call Processing

P - Parameter Download

M - Maintenance

}}}

=== msg query ===

{{{

MSG QUERY <Message_Code>

Reports all unresponded instances of the messages being queried to 

the TTY, along with the average response time.

Message_Code - Even value representing the uplink message code

}}}

=== rtc ===

{{{

RTC (C)

Displays the real-time configuration information pertaining to the

current timeslot packed into 2 words per frame.

No Parameter - Return the results once.

C - Continuous reporting

}}}

=== sndcmb ===

{{{

SNDCMB <XX> (<XX ... XX>)

Emulates the messaging to the combiner by sending the hex values of the

string to the combiner.

XX - Data to send to the combiner

}}}

=== tacorr ===

{{{

TACORR

Activates the equalizer process test point display.

}}}

=== task ===

{{{

TASK <DEBUG,ERROR,OFF> (<X>)

Allows the autonomous display of EQCP task level debug and error information.

DEBUG  - Enables reporting of debug information

ERROR  - Enables reporting of error information

OFF    - Disables reporting of error/debug information

X      - EQCP task number:

          0 - State Task              5 - Msg Router Task

          1 - Hardware Task           6 - EQCP TTY Task

          2 - Configuration Task      7 - EQU IF Task

          3 - Code Task               8 - CCCP IF Task

          4 - RT Control Task         9 - Reserved

}}}

=== test ===

{{{

TEST

Places the EQCP into Test mode.

}}}

== Level 3 Commands (TEST) ==

On Level2, enter "test" to enable the test mode commands:

{{{

TEST LEVEL ACCESS COMMANDS

==========================

ACTIVATE       AIC            ALIVE          BAUD           BBF            

BBH ALARM      BBPOW          CFGQRY         CL ALARM       CTRLREG        

DIV            DLCAL          FLASHWR        FM CLR         FM NORM        

FM SET         FM TEST        FM_TEST        FW             HALT           

IFG            IQAVG          IQDCO          LBD            LBE            

LBK            LOAD CAL       MDLTR          MEM STAT       MW             

NORMAL         RAMP           REPORT         RESET          RXCONFIG       

RXFULL         SAVE CAL       SELF CAL       SEND CCCP      SEND EQCP      

SYNTH          THRESHOLD      TS             TS-AGC         TS-AGC-K       

TS-AI          TS-AM          TS-ANT         TS-CH          TS-CHAN        

TS-DET-PAD     TS-DET-GAIN    TS-DSA         TS-HOP         TS-HSN         

TS-MA          TS-MAIO        TS-MOD         TS-TSC         TS-TXPWR       

TS-VVA         TS-NRM         TXFULL         TXLOAD         TX TP          

TX             VSWR           WRENB          WRPTC          

}}}

=== alive ===

{{{

EQCP TEST > alive

TASK                  STATUS

============================

CAL & TEST TASK       ALIVE

CCCP MSG IF TASK      ALIVE

COMBINER TASK         ALIVE

CONFIGURATION TASK    ALIVE

HARDWARE TASK         ALIVE

MSG ROUTER TASK       ALIVE

STATE TASK            ALIVE

TTY TASK              ALIVE

REAL TIME CTRL TASK   ALIVE

WATCHDOG TIMER TASK   ALIVE

}}}

=== activate ===

{{{

ACTIVATE <C>

Changes the state of the requested processor from Active Standby to Call

Processing.

C - Specifies the EQCP.

}}}

=== aic ===

{{{

AIC( <IN,OUT,NRM>( B))

Places the AIC pads in or out.

No Parameter - AIC pad status will be displayed.

IN  - Inserts the AIC pad(s)

OUT - Removes the AIC pad(s)

NRM - Returns control of the AIC pads to the real-time task

B   - Branch (1 or 2)

}}}

=== cl alarm ===

{{{

CL ALARM <CAB,CTRL,PATEMP,RX,SITE,TX,TLK,ALL>

Clears the current status of alarms specified by the parameter.

CAB    - Cabinet alarms

CTRL   - Control alarms

PATEMP - PA temperature alarm

RX     - Receive alarms

SITE   - Site alarms

TX     - Transmit alarms

TLK    - TDM link alarms

ALL    - All alarms

}}}

=== div ===

{{{

DIV (<OFF Branch_Number, ON Branch_Number, NRM)

Overrides the diversity configuration.

OFF - No Diversity on specified on branch

ON - No Diversity on specified on branch

Branch_Number - Branch number (1 or 2)

}}}

=== report ===

{{{

REPORT <R,L,B> T<Times> S<Samples> @<Branch> <Timeslot>

Reports to the averaged raw RSSI and linearized RSSI for a particular timeslot

according to the parameters specified.

R        - Raw RSSI^M 

L        - Linearized RSSI^M 

Times    - Number of times to report (default=continuous)

Samples  - Number of samples to take and average (1-100) (default = 12)

Branch   - Branch Number (1,2, B(oth)) (default = 1)

Timeslot - Timeslot on which to perform average (default=0)

}}}

=== ts ===

{{{

TS <ALL,T> <CMD> (<p0 .. pN>)

Sets a variable for a given timeslot.  For a more detailed

description of a specific command, replace the spaces with

dashes [e.g. HELP TS-AGC-K].

ALL - All timeslots

T   - Timeslot number (0-7)

CMD - Command:

       AGC   - Automatic Gain Control Level

       AGC K - Automatic Gain Control Filter Value

       ANT   - Antenna

       C2I   - C to I Ratio

       CH    - Channel Type

       CHAN  - Channel Number

       HOP   - Hopping

       HSN   - Hopping Sequence Number

       MA    - Mobile Allocation

       MAIO  - Mobile Allocation Index Offset

       MOD   - Modulation Type

       RXTSC - Rx Training Sequence

       SUB   - Subchannel Number

       TSC   - Tx Training Sequence

       TXPWR - Transmitter Power

p0  - Parameter number 0

pN  - Parameter number N

Note - There is NO help for the ts nrm command.^M 

This command will set all timeslots for the

VVA, DSA, DET_GAIN, and DET_PAD to NRM.

}}}

=== ts ch ===

{{{

TS <ALL,T> CH (<Channel_Type,N>)

Overrides the channel type configuration value.

ALL          - All timeslots

T            - Timeslot number (0-7)

Channel_Type - Channel type:

                0 - TCH/F

                1 - TCH/H

                2 - TCH/F9.6

                3 - TCH/F4.8

                4 - TCH/H4.8

                5 - TCH/F2.4

                6 - TCH/H2.4

                9 - TCH/AFS

                10- TCH/AHS

                11- RACH

                12- HO_RACH

                13- SACCH/TF

                14- FACCH/F

                15- SACCH/TH

                16- FACCH/H

                17- SDCCH/8

                18- SACCH/C8

                19- SDCCH/4

                20- SACCH/C4

                24- PTCCH

                26- PDTCH

                28- PRACH

                29- PIDLE

                30- Idle Frame

                31-Inactive

N       - Change the channel type back to normal.

}}}

=== ts chan ===

{{{{

TS <ALL,T> CHAN (<X,N>)

Programs the tx and rx synthesizers to a channel number for a given timeslot.

ALL - All timeslots

T   - Timeslot number (0-7)

X   - Channel number

N   - Disable the TTY timeslot override control

}}}

=== mw ===

{{{

MW <X,Y,P>:<AAAAAA> <XXXXXX> (<YYYYYY>)

 or MW <Cal_variable> <Offset> <ZZ> (<ZZ...ZZ>)

Performs a memory write.  For a single write, XXXXXX is written to

AAAAAA. For a block write, YYYYYY is written from AAAAAA to XXXXXX.

X            - X-space RAM

Y            - Y-space RAM

P            - P-space RAM

AAAAAA       - Memory address

XXXXXX       - Single write data, or Block end memory address

YYYYYY       - Block data

Cal_variable - Calibration variable:

                AGC  - Rx Automatic Gain Control Cal.

                AIC  - Rx Automatic Intermodulation Control Cal.

                BAY  - Rx Bay Level Cal.

                BBG  - Rx Baseband Gain

                DCO  - Rx DC Offset Cal.

                DET  - Tx Detector Cal.

                FREQ - Rx Frequency Offset Cal.

                IFG  - Rx Intermediate Frequency Gain

                PWR  - Tx Full Power Cal.

                RSSI - Rx Received Signal Strength Indicator Cal.

                TX   - Tx Cell Site Power Cal.

                VVA  - Tx Voltage Variable Attenuator Cal.

ZZ           - Calibration data

}}}

=== ts txpwr ===

{{{

TS <ALL,T> TXPWR (<XX,#YY,N>)

Sets the PA level for the given timeslot.

ALL - All timeslots

T   - Timeslot number (0-7)

XX  - PA power level(hex)

#YY - PA power level(dec)

N   - Place the timeslot under DRI control

}}}

=== tx ===

{{{

TX <ON,OFF,NRM>

Forces the TX KEY line to the state defined by the parameter.

ON   - Tx Keying line is held high

OFF  - Tx Keying line is held low

NRM  - Normal control of TX KEY line

}}}

=== txfull ===

{{{

TXFULL <x1> <x2> <x3> <0> <0> (2)

Performs a full update of the TX parameters.

x1 - First 8 bits of the 56 bit paramter.

x2 - Bits 9-32 of the 56 bit parameter.

x3 - Bits 33-56 of the 56 bit paramter.

No Parameter - Data bits are sent to the first TX SPI line(TIM).

2  - FOR THOR ONLY, Data bits are sent to the second TX SPI line

     (the Synthesizer circuit).

}}}

=== vswr ===

{{{

VSWR <OVERRIDE>

Performs RF Loopback and VSWR testing on the radio.

OVERRIDE - Tests are performed using override values for TX power, channel,

           diversity and antenna

}}}

Example:

{{{

CHANNEL: 0698   TX POWER: 00

-----------------------------------------------------------------

                     ANT1              ANT2              ANT3

                  BR1     BR2       BR1     BR2       BR1     BR2

-----------------------------------------------------------------

RCU  RXLEV        -60     -60       -60     -60       -60     -60

     RESULT      PASS    PASS      PASS    PASS      PASS    PASS

-----------------------------------------------------------------

PIL  RXLEV        -55     -60       -55     -58       -56     -58

     RESULT      PASS    PASS      PASS    PASS      PASS    PASS

-----------------------------------------------------------------

VSWR RXLEV        -57     -59       -58     -58       -58     -58

     RESULT      FAIL    FAIL      FAIL    FAIL      FAIL    FAIL

-----------------------------------------------------------------

RETURN LOSS         2       1         3       1         2       1

VSWR VALUE      8.724  17.391     5.848  17.391     8.724  17.391

-----------------------------------------------------------------

}}}