FTE Presentation

SCH-TE

Maria Vetrova

Motorola Internal Use Only MOTOROLA and the Stylized M Logo are registered in the US Patent & Trademark Office. All other product or service names are the property of their respective owners. © Motorola, Inc. 2008.

Environment

Following variable should be set: For tautester:

setenv TAUTESTER_HOME /home/iden/telelogic/TAU_TESTER_G3_1

Licence: setenv TELELOGIC_LICENSE_FILE 19353@swim-b:19353@sail-a:19353@sail-b

For MouseTrap: setenv MOUSETRAP_HOME

/home/iden/WiBB/WiMAX/tools/MT_03-13-00 gcc:

setenv LD_LIBRARY_PATH /usr/local/gcc-4.1.1/lib:/usr/local/lib:/usr/lib:/lib:/usr/openwin/lib:/usr/dt/lib:$TAUTESTER_HOME/mw/lib-sunos5_optimized:$TAUTESTER_HOME/bin


Tools & Equipment

Cages SPb – link to lab configuration

http://telecom.spb.mot.com/WMX/MAC_TE/HowTo/Cages.htm

AH - link to lab configuration http://wmxlab.cig.mot.com/devicetype.php?id=5

Test Studio to keep test suite description to keep tests results

TestStudio is available: http://compass.mot.com/go/teststudio

TauTester


Apple1 + AH server

Apple1: [10.245.6.1] Folders for SCH-TE

SCH_TE_R25_REGRESSION (current load) Scripts for SCH-TE

sch_..., trnk_sch_...

AH server: [10.19.184.23] Folder for SCH-TE

SCH_TE_R25_REGRESSION (current load) Scripts for SCH-TE

sch_..., trnk_sch_...


Tools: Test Studio

Test Studio Where are the tests plan for all releases

NE\WIMAXBT\AP_Dev\Mac\

Where are the test suite & tests description NE\WIMAXBT\AP\DEV\MAC\SCH_TEST_MODE


Tools: Tautester

How to run All TTCN projects are located in

/vob/wibb_bts/mac/test/dit/ttcn/sch_te/scripts/ Choose appropriate project and run it

>tautester <Project>.ttw

How to compile & build project Press “Compile”, after it press “Build” button


Tools: Tautester


SCH-TE Projects. Current status

1. MIMO_DL 2. MIMO_UL3. MixedCapability4. Alamouti5. TxAA6. SleepMode7. MTG Frame Config8. EPP1654 Suite9. HARQ10. FCC_Common All SCH-TE project are located here

/vob/wibb_bts/mac/test/dit/ttcn/sch_te/scripts/


Script to load cage (example)cd "SCH_TE_R25_REGRESSION“ # folder with files required to current regression cycleld < libxml2.outld < ha_stub.out # stubs and proxyha_logger_activate()ld < mem.outld < imt.outld < mac_com.out # stubs and proxy ld < cmt_stub.out # stubs and proxyld < sch_sw.out # SCH codeld < ohp_proxy.out # stubs and proxy cmt_stub_add_xml_file("./NECB_default_HARQ_A.xml") # AP IM filescmt_stub_add_xml_file("./NECB_factoryTunned.xml") # AP IM files cmt_stub_reassign_xml_files()com_type_filter = 0xFFFFFFFF;g_log_destination = LIBDBGLG_TO_LOG_AGENTlibcmt_stub_create_log("./log-01.txt");schStubInit_TestMode()taskDelay(2*sysClkRateGet())g_dump_phy = 2;SCH_rfhead_type = 1;SCH_unicast_zone_diversity=3;global_debug_to_console = 1;enable_cqm_debug;mac_version #print current version of SCH


AP settings

In NECB files you should set all required variables in test’s precondition.

For more details refer to “WMX-ICD-015_Info_Model.pdf” doc

One of the main table in this NECB is: wmanIfBsSchedulerTable


Steps to execute tests: Full project and Single test

1. Set up the view

2. Compile the test and build binary file

3. Start the test In automatic modeIn automatic mode

./<binary_name> -t3rtout <t3rt_logfile_name> -t3rt "-par begin <#tc> -par end <#tc> -file <path to adapter cfg> -par autocycle true“

In manual modeIn manual mode

./<binary_name> -t3rtout <t3rt_logfile_name> -t3rt "-par begin <#tc> -file <path to adapter cfg> “


Special help command on modem:

Helpful command to get some info at the end of tests:-> ohp_help cm_conn_dump cm_mss_dump cm_sys_config_dump get_scheduler_state get_ul_measurements ……

Use these commands to get debug info after test case execution.


SCH-TE Design view

Scheduler

MSSPTC

MACPTC

PHYPTC

BBMTPTC

NMPTC

Scheduler

MACPHYNMBBMT

Main Test Component

Note: PTC – Parallel Test Component


SCH-TE initialization

Only BBMT & NM components are involved in SCH initialization

How to check state of SCH:Print command on modem –

-> get_scheduler_statevalue = 5 = 0x5

Possible SCH states:typedef enum{ NOT_READY, [0] WAIT_FOR_GO_ACTIVE, [1] WAIT_FOR_RFH_CONFIGURED, [2] WAIT_FOR_SYS_CONFIG_RESP, [3] WAIT_FOR_RFH_ACTIVE, [4] READY [5]} SCH_STATE;


Network Entry

Ranging

SBC

Registration

Refer to MAC-SCH ICD for more detail about structure of these messages.

MSS sends own settings


Network Entry. Create connection

To send data for MSS it’s required to create connection after “Network Entry” phase


SCH initialization ERROR

It means that error occurs on initialization phase during the reading of MIB.(SCH state is not “Active(5)”)

To correct this error check that all required variables were read from MIB. In modem log you can see the following information about error:

cfg_process_syscfg_req.c:653:sch_cache_wmanIfBsSchedulerTable returned failure. libfm_report_fault_event called: event id: 901

TASK_SWFM:0:SCFG:cfg_main.c:414:System Config parse failed.

Add required variables in NECB file in appropriate table. (for shown example it is wmanIfBsSchedulerTable)


Test “failed”

If test failed: It means that one (or more) checks set verdict to “fail”.

In log file find verdicts for each checks (for example): 00:01:00.217 [SCH_TE] Log: MSS_STATE: NE + CreateConnection : pass 00:01:00.217 [SCH_TE] Log: DYNAZONE CFG - STC ZONE IE : pass 00:01:00.217 [SCH_TE] Log: BUILD HARQ_REGION - HARQ_DL_IE : pass 00:01:00.217 [SCH_TE] Log: HARQ_UL__fec_decode_req : pass 00:01:00.217 [SCH_TE] Log: DL_Alloc_provided : pass 00:01:00.960 [SCH_TE] Log: SDMA allocations check for users: pass 00:01:00.960 [SCH_TE] Log: All ul connections rcvd allocations: fail

In TTCN code find what it checks. After it in test log find real value of checking variable (add debug print if necessary)

Try to find “key” of mismatch.

Common Checks


Test “hung”

If test “hung” – it means that one of message was not send by SCH. And system waits until this message will be sent to receive it.

In test log you can find line like follow

00:00:01.050 [SCH_TE] AWait: sector_activation.ttcn, line 57

This can help to determine the reason for tests hang-up. If timeout for testcase execution is set the result of hang-up

will be the ERROR verdict. (Don’t mix with ERROR verdict in case of unexpected message or pack/unpack errors)


SCH-TE. Status for Releases

R2.5 Not supported now

R2.5.2 Sanity – by SPb team Full Regression – by HZ team

R3.0 Not supported

R3.0.1 Sanity – by SPb team Full Regression by HZ team

R4.0 Sanity by SPb team (start Nov, 19)


ReleaseNotes and useful info

All Release Notes are available in compass: http://compass.mot.com/go/schte_regress

Binary, Stubs & Proxy are available in vob: wibb_bts\mac\test\dit\ttcn\sch_te\bin\


How To work with the TTCN tests: http://compass.mot.com/doc/243479970/HowToTTCNtests.txt

802.16e Base Station MAC-Scheduler Interface Control Procedures and Messages Document: http://compass.mot.com/doc/

234543293/802.16e_MAC-Scheduler_ICD_R02.05.00.doc

WMX-ICD_Information_Model: http

://compass.mot.com/doc/209328318/WMX-ICD-015__WiMAX_Information_Model.pdf

Regression process \wibb_projects\wmx20-mac-te\doc\process\

MAC_SCH_TE_Rebaseline_Procedure.doc

References to the documents


BACK UP


Downlink & Uplink

SS

BS Downlink

Uplink


DL_MAP & UL_MAP

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 0 1 2 3 4 5 6 7 8 9 10 11

0 0

1 1

2 2

3 3

4 4

5 5

6 6

7 7

8 8

9 9

10 10

11 11

12 12

13 13

14 14

15 15

16 16

17 17

18 18

19 19

20 20

21 21

22 22

23 23

24 24

25 25

26 26

27 27

28 28

29 29

30

31

32

33

34

CQICH

Unicast HARQ Region 3

Pre

am

ble

FCH

Sub-D

L-U

L-M

AP

Broadcast Non Harq Region

HARQ ACKCH

Com

pre

ssed D

L-U

L M

AP

Sub-D

L-U

L-M

AP

Rang-ing

PAPR/Safety Zone


TT

G

HARQ Burst Alloc

Non HARQ Burst Alloc



Diversity & Broadcast zone

To define zone see info (OFDMA_Symbol_Offset) in DL_MAP for:

- STC_IE (DIUC 15) - HARQ_IE (DIUC 14)- DL_Allocation_IE (DIUC 0

12)

PREAMBLE

DL+UL

MAP

DL+UL

MAP

Contd.

NON-HAR

Q

NON-HAR

Q

FCH

BROADCAST

DL Symbols

DL

Sub

chan

nels

DL Subframe

NON-HAR

Q

Broadcast Zone

Diversity Zone

HA

RQ

R

egio

n

HA

RQ

R

egio

n

HA

RQ

R

egio

n

HA

RQ

R

egio

n

HARQ Stack

HARQ Stack

STC Zone Switch

DL+UL

MAP

Contd.

DL+UL

MAP

Contd

OFDMA_Symbol


Messages. PHY

VERT_FEC_ENCODE_REQ [from SCH to PHY]

HARQ_FEC_DECODE_REQ [from SCH to PHY]

SOUNDING_IND [from SCH to PHY]

DINAMIC_ZONE_CFG_REQ [from SCH to PHY]

FFB_REQ [from SCH to PHY]

FFB_IND [from PHY to SCH]

HARQ_ACKCH_IND [from PHY to SCH]…


Messages. MAC

Build_PDU_Indication [from SCH to MAC]

Downlink_Transmitted_Payload_Request [from SCH to MAC]

Build_Burst_Indication [from SCH to MAC]

Build_HARQ_Region_Indication [from SCH to MAC]

Downlink_Data_Snapshot_Confirm [from SCH to MAC]

HARQ_Free_Bursts_Indication [from SCH to MAC]

DownlinkDataSnapshotIndication [from MAC to SCH]

…


Messages. MSS

Compressed_DL_MAP [From PHY to MSS]

MAC-TE

Anna Kurina


MAC

NM

SCH

IWF

SACM

SM

MSS

MAC Test Mode Interfaces

NM and BBMT used only during initialization

BBMTSYNC


Test scenario(TTCN)

TAU Tester

System Adapter

CTRL Proxy

CMT Stub

MAC SW

Platform Stub

Tunnel

Ethernet

Functions

Functions

TIPCSun Solaris Machine

Modem board(BHP)

PHY-SAP StubFunctions

RAW Ethernet Proxy(SCH, IWF)

Functions

TIPC Proxy(SCH, SM, SFM, DCS, NSMT, BBMT)

MAC-TE interaction scenario


Setting up environment

The same as for SCH-TE


Preparing components for running MAC TE test

MAC binaries (mac_sw.out, mac_com.out)Test executable (get cs; setview; cd

/vob/wibb_bts/mac/test/dit/ttcn/mac_te/scripts/<functional_area>;

run tautester Compile; Build; find test executable in project_name/out_solaris/ )Stubs(/vob/wibb_bts/mac/test/dit/ttcn/mac_te/bin/

MAC_TE_R25_REGRESSION; available on cage for current regression)

Book cage (Jabber -> Actions -> Join a Conference Room -> MAC_TE).


Preparing components for running MAC TE test (cont.)

adapter_cage.cfg (/vob/wibb_bts/mac/test/dit/ttcn/mac_te/system_adapter.cfg):

channel.MAC.ipcharstring = "10.245.6.22“ //for spb cage 1 ……… channel.BHP_TERM.ip charstring = "10.245.6.9“ // for spb

cage 1 channel.BHP_TERM.port integer = 10001 // for spb

cage 1


Test execution

Cage:

Chose appropriate cage and connect Reboot Run mac initialization script Accordance between test and script for R2.5 in

/vob/wibb_bts/mac/test/dit/ttcn/mac_te/auto/<functional_area>.cfg

For R2.5.2 in file GTS_enumeration_Policy.xls at http://compass.mot.com/go/296941312)


Test executionSun:

>cleartool setview <view_name> >cd /vob/wibb_bts/mac/test/dit/ttcn/mac_te/scripts/<functional_area>/ #to run tautester with appropriate project functional_area.ttw & # Compile and Build test executable >cd out_solaris # or copy test executable and system_adapter.cfg to your folder >./NetworkEntry -t3rtout ne01.log -t3rt «-par begin 1 -par end 1 -file

system_adapter.cfg» | tee test1.log

#For Trunking Releases: #Build project “Trunking ”. #For MIBS cashing : ./Trunking -t3rtout TK00001_Ttcn.log -t3rt "-par testNum_ 1 -par maxTestDuration_

1000.0 -file adapter_cage.cfg" ./NetworkEntry -t3rtout ne01.log -t3rt «-par begin 1 -par end 1 -file system_adapter.cfg»

| tee test1.log #For Sector Recovery: GtsHandOver -t3rtout GHORecovery_Ttcn.log -t3rt "-par testNum_ 0 -par fast_ true -par

sectorMode_ 0 -par sectA_ 0 -par maxTestDuration_ 1000.0 -file adapter_cage.cfg


Script for MAC initialization

cd "MAC_TE_R25_REGRESSION"ld < libxml2.outld < ha_stub.outld < cmt_stub.outld < csp_stub.outld < ha_logger.outld < mem.outld < imt.outld < mac_com.outld < mac_sw.outld < bhp_proxy.outcmt_stub_add_xml_file("./NECB_default_NON-MOB_frag.xml_upd")cmt_stub_add_xml_file("./NECB_factoryTunned_2605.xml")cmt_stub_reassign_xml_files()com_type_filter = 0xFFFFFFFF;g_log_destination = LIBDBGLG_TO_LOG_AGENT; # LIBDBGLG_TO_TELNET, LIBDBGLG_TO_TERMINALenable_Ranging_Workaround = 0macStubInit()taskDelay(4*sysClkRateGet())global_debug_to_console = 1SEND_UL_SIG_LEVEL_ERROR_REPORT=0NO_HARQ_SUPPORT=1g_phy_proxy_fn_source = 1mac_version


Functional area structure

All MAC-TE projects are located here: /vob/wibb_bts/mac/test/dit/ttcn/mac_te/scripts

ARQ HARQ DataPlane eCINR MIMO-B DL SF and ADM Control Handover IdleMode MACInitialization Deregistration NetworkEntry PHS PowerManagement Security SleepMode 4xModem


Tools: Test Studio

Test Studio Where are the tests plan for all releases

NE\WIMAXBT\AP_Dev\Mac\

Where are the test suite & tests description NE\WIMAXBT\AP\DEV\MAC\MAC_TEST_MODE


Release Notes

Release Notes available on compass at:

http://compass.mot.com/go/296943334( Enterprise Networks Development WiMAX Engineering & NAT

Commercial WiMAX Commercial WiMax Development Access Point Software Development Teams MAC Integration/Interoperability Testing DIT FTE

MAC-TE Regression Testing )

(FTE compass page

http://compass.mot.com/go/fte -> MAC-TE -> Regression Testing -> Choose Release folder)


Test logs: How to analyze

After running test there are 2 MAC logs (1 for initialization, another for test), test and ttcn log can be in 1 log.

1) Look if MAC initializes successfully. (In test log Testcase Startup() – pass). In MAC log there shouldn’t be diagnostic like: “get_params_from_mib returned FAILURE”

2) Look in test log if it is not hang, if there is FAIL or ERROR status.

3) Can be usefull have separate logs for components

4) (grep MSS test1.log > test1_MSS.log)


Logs analisys. Common failures.

Template mismatch: template_mismatch: 'value mismatch' for

'SBC_RSP.Param3.OFDMA_MS_CINR_Measurement_Capability.Effective_CINR_Pilot': Expected 0, got 1

Type mismatch: template_mismatch: 'type mismatch' for

'Downlink_Data_Snapshot_Indication': Expected <undefined>, got {{1, 0, 1, {}, {}}}

Deadlock in alt construction detected. error_message: ERROR CMP0026: Deadlock in alt construct detected Timeout (or test hangs)

P.S. not all “mismatch” in log are because of actual error


MAC-TE. Status for Releases



R2.5.2 Sanity – by SPb team Full Regression – by HZ team

R3.0 Not supported

R3.0.1 Sanity – by SPb team Full Regression by HZ team

R4.0 Sanity by SPb team (start Nov, 17)


Useful documents

Regression process: \wibb_projects\wmx20-mac-te\doc\process\

MAC_SCH_TE_Rebaseline_Procedure.doc HowTo:

http://telecom.spb.mot.com/WMX/mac_te.shtml -> howTo -> How to Compile iSL How to build BHP-Proxy (SPb, AH)

Common MAC TE presentations: http://telecom.spb.mot.com/WMX/mac_te.shtml -> Other ->

Use of MAC-TE http://compass.mot.com/go/241230901

WiMAX documents (ICD, IM): http://compass.mot.com/go/wimaxdocs http://compass.mot.com/go/wimaxicds (go to Release folder) http://compass.mot.com/go/230440902 (Information Model)

Documents

FTE Presentation