doc/MobileL3_v13.4.adoc

---
Author: Tímea Moder
Version: 1551-CNL 113 832, Rev. A
Date: 2016-03-18

---
= MobileL3 (v13.4.0) Protocol Modules for TTCN-3 Toolset with TITAN, Function Description
:author: Tímea Moder
:revnumber: 1551-CNL 113 832, Rev. A
:revdate: 2016-03-18
:toc:

= Functionality

The MobileL3 v13.4.0 protocol module implements the message structures of the related protocol <<_5, [5]>> in a formalized way, using the standard specification language TTCN-3. This allows defining of test data (templates) in the TTCN-3 language and correctly encoding/decoding messages when executing test suites using the Titan TTCN-3 test environment.

The MobileL3 v13.4.0 protocol module uses Titan’s RAW encoding attributes <<_1, [1]>> and hence is usable with the Titan test toolset only.

== Implemented Protocols

This set of protocol modules implements a subset of protocol messages and constants of the Mobile L3 protocol. It includes GMM, SM, RRM, SMS and SS. SM and GMM are based on 24.008 v13.4.0 (see <<_4, [4]>>), RRM are based on 44.018 v13.0.0 (see <<_5, [5]>>), SMS are based on 24.011 v13.0.0 (see <<_6, [6]>>) and 23.040 v13.0.0 (see <<_7, [7]>>) and SS are based on 24.080 v13.0.0 (see <<_8, [8]>>) with the modifications specified in <<modifications-deviations-related-to-the-protocol-specification, Modifications/Deviations Related to the Protocol Specification>>.

[[modifications-deviations-related-to-the-protocol-specification]]
== Modifications/Deviations Related to the Protocol Specification

=== Unimplemented and Implemented Messages, Information Elements and Constants

==== Messages for Mobility Management (MM)

All the messages are implemented according to Table 9.2.1 and 10.2 of 24.008 (see <<_4, [4]>>).

==== Messages for Circuit Switched Call Control (CC)

All the messages are implemented according to Table 9.54 and 9.3 of 24.008 (see <<_4, [4]>>).

==== GPRS Mobility Management (GMM) Messages

All the messages are implemented according to Table 10.4 of 24.008 (see <<_4, [4]>>).

==== GPRS Session Management (SM) Messages

All the messages are implemented according to Table 10.4a of 24.008 (see <<_4, [4]>>).

==== Common Information Elements (CommonIE)

All the information elements implemented according to 10.5.1 of 24.008 (see <<_4, [4]>>).

==== Radio Resource Management (RRM) Messages

Some of the messages that are used are implemented according to table 9.1.1 of 44.018 (see <<_5, [5]>>).

==== Short Message Service (SMS) Messages

All the CP-messages are implemented according to 7.2 of 24.011 (see <<_6, [6]>>).

All the RP-messages are implemented according to 7.3 of 24.011 (see <<_6, [6]>>).

All the TPDU-messages are implemented according to 9.2.2 of 23.040 (see <<_7, [7]>>).

==== Supplementary Service Management (SS) Messages

All the SS-messages are implemented according to table 2.1 of 24.080 (see <<_8, [8]>>).

=== Ericsson-Specific Changes

None.

== Backward Incompatibilities

None.

== System Requirements

Protocol modules are a set of TTCN-3 source code files that can be used as part of TTCN-3 test suites only. Hence, protocol modules alone do not put specific requirements on the system used. However, in order to compile and execute a TTCN-3 test suite using the set of protocol modules the following system requirements must be satisfied:

* Titan TTCN-3 Test Executor version CRL 113 200/5 R4A (5.4.pl0) or higher installed. For Installation Guide see <<_2, [2]>>.

NOTE: This version of the test port is not compatible with Titan releases earlier than CRL 113 200/5 R4A.

= Usage

== Installation

The set of protocol modules can be used in developing TTCN-3 test suites using any text editor; however, to make the work more efficient a TTCN3enabled text editor is recommended (for example `nedit`, `xemacs`). Since the MobileL3 protocol is used as a part of a TTCN-3 test suite, this requires TTCN-3 Test Executor be installed before the module can be compiled and executed together with other parts of the test suite. For more details on the installation of TTCN-3 Test Executor see the relevant section of <<_3, [3]>>.

== Configuration

None.

== Examples

None.

= Interface Description

== Top Level PDU

The top level PDUs are the TTCN-3 records PDU_L3_MS_SGSN, PDU_L3_SGSN_MS, PDU_ML3_NW_MS, PDU_ML3_MS_NW.

[[encoding-decoding-and-other-related-functions]]
== Encoding/Decoding and Other Related Functions

This product also contains encoding/decoding functions, which assure correct RAW encoding of messages when sent from TITAN and correct RAW decoding of messages when received by TITAN.

=== Implemented Encoding and Decoding Functions

[cols=3*,options=header]
|===

|Name |Type of formal parameters |Type of return value

|`enc_PDU_L3_MS_SGSN` |PDU_L3_MS_SGSN |octetstring
|`enc_PDU_L3_MS_SGSN_fast` |in PDU_L3_MS_SGSN, +
out octetstring |
|`dec_PDU_L3_MS_SGSN` |octetstring |PDU_L3_MS_SGSN
|`dec_PDU_L3_MS_SGSN_backtrack` |in octetstring, +
out PDU_L3_MS_SGSN |integer (0: success, +
1: decoding failed)
|`enc_PDU_L3_SGSN_MS` |PDU_L3_SGSN_MS |octetstring
|`enc_PDU_L3_SGSN_MS_fast` |in PDU_L3_SGSN_MS, +
out octetstring |
|`dec_PDU_L3_SGSN_MS` |octetstring |PDU_L3_SGSN_MS
|`dec_PDU_L3_SGSN_MS_backtrack` |in octetstring, +
integer |(0: success, +
1: decoding failed)
|`enc_PDU_ML3_NW_MS` |PDU_ML3_NW_MS |octetstring
|`enc_PDU_ML3_NW_MS_fast` |in PDU_ML3_NW_MS, +
out octetstring |
|`dec_PDU_ML3_NW_MS` |octetstring |PDU_ML3_NW_MS
|`dec_PDU_ML3_NW_MS_backtrack` |in octetstring, +
out PDU_ML3_NW_MS |integer (0: success, +
1: decoding failed)
|`enc_PDU_ML3_MS_NW` |PDU_ML3_MS_NW |octetstring
|`enc_PDU_ML3_MS_NW_fast` |in PDU_ML3_MS_NW, +
out octetstring |
|`dec_PDU_ML3_MS_NW` |octetstring |PDU_ML3_MS_NW
|`dec_PDU_ML3_MS_NW_backtrack` |in octetstring, +
out PDU_ML3_MS_NW |integer (0: success, +
1: decoding failed)
|`enc_SS_FacilityInformation` |SS_FacilityInformation |octetstring
|`dec_SS_FacilityInformation` |octetstring |SS_FacilityInformation
|`dec_SS_FacilityInformation` |in octetstring, +
out SS_FacilityInformation |integer (0: success, +
1: decoding failed)
|`enc_TPDU_RP_DATA_MS_SGSN_fast` |in TPDU_RP_DATA_MS_SGSN +
out octetstring |
|`dec_TPDU_RP_DATA_MS_SGSN_backtrack` |in octetstring +
out TPDU_RP_DATA_MS_SGSN |integer (0: success, +
1: decoding failed)
|`enc_TPDU_RP_DATA_SGSN_MS_fast` |in TPDU_RP_DATA_SGSN_MS +
out octetstring |
|`dec_TPDU_RP_DATA_SGSN_MS_backtrack` |in octetstring +
out TPDU_RP_DATA_SGSN_MS |integer (0: success, +
1: decoding failed)
|`enc_TPDU_RP_ACK_MS_SGSN_fast` |in TPDU_RP_ACK_MS_SGSN +
out octetstring |
|`dec_TPDU_RP_ACK_MS_SGSN_backtrack` |in octetstring +
out TPDU_RP_ACK_MS_SGSN |integer (0: success, +
1: decoding failed)
|`enc_TPDU_RP_ACK_SGSN_MS_fast` |in TPDU_RP_ACK_SGSN_MS +
out octetstring |
|`dec_TPDU_RP_ACK_SGSN_MS_backtrack` |in octetstring +
out TPDU_RP_ACK_SGSN_MS |integer (0: success, +
1: decoding failed)
|`enc_TPDU_RP_ERROR_MS_SGSN_fast` |in TPDU_RP_ERROR_MS_SGSN +
out octetstring |
|`dec_TPDU_RP_ERROR_MS_SGSN_backtrack` |in octetstring +
out TPDU_RP_ERROR_MS_SGSN |integer (0: success, +
1: decoding failed)
|`enc_TPDU_RP_ERROR_SGSN_MS_fast` |in TPDU_RP_ERROR_SGSN_MS +
out octetstring |
|`dec_TPDU_RP_ERROR_SGSN_MS_backtrack` |in octetstring +
out TPDU_RP_ERROR_SGSN_MS |integer (0: success, +
1: decoding failed)
|`enc_RPDU_SGSN_MS_fast` |in RPDU_SGSN_MS +
out octetstring |
|`dec_RPDU_SGSN_MS_backtrack` |in octetstring +
out RPDU_SGSN_MS |integer (0: success, +
1: decoding failed)
|`enc_RPDU_MS_SGSN_fast` |in RPDU_MS_SGSN +
out octetstring |
|`dec_RPDU_MS_SGSN_backtrack` |in octetstring +
out RPDU_MS_SGSN |integer (0: success, +
1: decoding failed)
|===

= Terminology

*TITAN:* +
TTCN-3 Test Executor (see <<_3, [3]>>).

== Abbreviations

3GPP:: 3rd Generation Partnership Project

GMM:: GPRS Mobility Management

GPRS:: General Packet Radio Service

IE:: Information Element

L3:: Layer 3

PDU:: Protocol Data Unit

SM:: Session Management

TTCN-3:: Testing and Test Control Notation version 3

MM:: Mobility Management

CC:: Circuit Switched Call Control

RRM:: Radio Resource Management

SMS:: Short Message Service

SS:: Supplementary Service Management

= References

[[_1]]
[1] ETSI ES 201 873-1 v4.5.1 (2013-04) +
The Testing and Test Control Notation version 3. Part 1: Core Language

[[_2]]
[2] User Guide for TITAN TTCN-3 Test Executor

[[_3]]
[3] Programmer’s Technical Reference for Titan TTCN–3 Test Executor

[[_4]]
[4] 3GPP TS 24.008 V13.4.0 (2015-12), +
3rd Generation Partnership Project; +
Technical Specification Group Core Network and Terminals; +
Mobile radio interface Layer 3 specification; +
Core network protocols; Stage 3 (Release 13)

[[_5]]
[5] 3GPP TS 44.018 V13.0.0 (2015-12), +
3rd Generation Partnership Project; +
Technical Specification Group GSM/EDGE Radio Access Network; +
Mobile radio interface Layer 3 specification; +
Radio Resource Control (RRC) protocol; (Release 13)

[[_6]]
[6] 3GPP TS 24.011 V13.0.0 (2015-12), +
3rd Generation Partnership Project; +
Technical Specification Group Core Network and Terminals; +
Point-to-Point (PP) Short Message Service (SMS) support on mobile radio interface (Release 13)

[[_7]]
[7] 3GPP TS 23.040 V13.0.0 (2015-12), +
3rd Generation Partnership Project; +
Technical Specification Group Core Network and Terminals; +
Technical Realization of the Short Message Service (SMS) (Release 13)

[[_8]]
[8] 3GPP TS 24.080 V13.0.0 (2015-12), +
3rd Generation Partnership Project; +
Technical Specification Group Core Network and Terminals; +
Mobile radio interface layer 3 supplementary services platform; +
Formats and coding (Release 13)