view cdg211/prim/grlc.pdf @ 639:026c98f757a6

tpudrv12.h & targets/gtm900.h: our current support is for MGC2GSMT version only As it turns out, there exist two different Huawei-made hw platforms both bearing the marketing name GTM900-B: one is MG01GSMT, the other is MGC2GSMT. The two are NOT fw-compatible: aside from flash chip differences which should be handled by autodetection, the two hw platforms are already known to have different RFFEs with different control signals, and there may be other differences not yet known. Our current gtm900 build target is for MGC2GSMT only; we do not yet have a specimen of MG01GSMT on hand, hence no support for that version will be possible until and unless someone provides one.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 30 Jan 2020 18:19:01 +0000
parents 56abf6cf8a0b
children
line wrap: on
line source

;********************************************************************************
;*** File           : grlc.pdf
;*** Creation       : Fri Jun 08 13:57:32 CST 2007
;*** XSLT Processor : Apache Software Foundation / http://xml.apache.org/xalan-j / supports XSLT-Ver: 1
;*** Copyright      : (c) Texas Instruments AG, Berlin Germany 2002
;********************************************************************************
;*** Document Type  : Service Access Point Specification
;*** Document Name  : grlc
;*** Document No.   : 8010.126.02.009
;*** Document Date  : 2003-06-06
;*** Document Status: BEING_PROCESSED
;*** Document Author: AGR
;********************************************************************************



PRAGMA 	SRC_FILE_TIME 	"Thu Jul 15 16:12:04 2004"
PRAGMA 	LAST_MODIFIED 	"2003-06-06"
PRAGMA 	ID_AND_VERSION 	"8010.126.02.009"
PRAGMA 	PREFIX 	GRLC 	; Prefix for this document
PRAGMA 	ALLWAYS_ENUM_IN_VAL_FILE 	NO 	; Enumeration values in value file
PRAGMA 	ENABLE_GROUP 	NO 	; Enable h-file grouping
PRAGMA 	COMPATIBILITY_DEFINES 	NO 	; Compatible to the old #defines






VALTAB 	VAL_sapi
VAL 	1 	SAPI_1 	"SAP for GMM"
VAL 	3 	SAPI_3 	"SAP 1 for SNDCP"
VAL 	5 	SAPI_5 	"SAP 2 for SNDCP"
VAL 	7 	SAPI_7 	"SAP for SMS"
VAL 	9 	SAPI_9 	"SAP 3 for SNDCP"
VAL 	11 	SAPI_11 	"SAP 4 for SNDCP"
VAL 	255 	SAPI_TEST_MODE 	"This signs a primitive as GRLC-self generated for test purposes"

VALTAB 	VAL_peak
VAL 	0 	PEAK_SUB 	"Subscribed peak throughput"
VAL 	1 	PEAK_1K 	"Up to 1 000 octet/s"
VAL 	2 	PEAK_2K 	"Up to 2 000 octet/s"
VAL 	3 	PEAK_4K 	"Up to 4 000 octet/s"
VAL 	4 	PEAK_8K 	"Up to 8 000 octet/s"
VAL 	5 	PEAK_16K 	"Up to 16 000 octet/s"
VAL 	6 	PEAK_32K 	"Up to 32 000 octet/s"
VAL 	7 	PEAK_64K 	"Up to 64 000 octet/s"
VAL 	8 	PEAK_128K 	"Up to 128 000 octet/s"
VAL 	9 	PEAK_256K 	"Up to 256 000 octet/s"

VALTAB 	VAL_relclass
VAL 	0 	RELCLASS_SUB 	"Subscribed reliability class"
VAL 	1 	GTP_LLC_RLC_PROT 	"Acknowledged GTP, LLC, and RLC; Protected data"
VAL 	2 	LLC_RLC_PROT 	"Unacknowledged GTP; Acknowledged LLC and RLC, Protected data"
VAL 	3 	RLC_PROT 	"Unacknowledged GTP and LLC; Acknowledged RLC, Protected data"
VAL 	4 	PROT 	"Unacknowledged GTP, LLC, and RLC, Protected data"
VAL 	5 	NO_REL 	"Unacknowledged GTP, LLC, and RLC, Unprotected data"

VALTAB 	VAL_delay
VAL 	0 	DELAY_SUB 	"Subscribed delay class"
VAL 	1 	DELAY_1 	"Delay class 1"
VAL 	2 	DELAY_2 	"Delay class 2"
VAL 	3 	DELAY_3 	"Delay class 3"
VAL 	4 	DELAY_4 	"Delay class 4 (best effort)"

VALTAB 	VAL_mean
VAL 	0 	MEAN_SUB 	"Subscribed mean throughput"
VAL 	1 	MEAN_100 	"100 octet/h"
VAL 	2 	MEAN_200 	"200 octet/h"
VAL 	3 	MEAN_500 	"500 octet/h"
VAL 	4 	MEAN_1K 	"1 000 octet/h"
VAL 	5 	MEAN_2K 	"2 000 octet/h"
VAL 	6 	MEAN_5K 	"5 000 octet/h"
VAL 	7 	MEAN_10K 	"10 000 octet/h"
VAL 	8 	MEAN_20K 	"20 000 octet/h"
VAL 	9 	MEAN_50K 	"50 000 octet/h"
VAL 	10 	MEAN_100K 	"100 000 octet/h"
VAL 	11 	MEAN_200K 	"200 000 octet/h"
VAL 	12 	MEAN_500K 	"500 000 octet/h"
VAL 	13 	MEAN_1M 	"1 000 000 octet/h"
VAL 	14 	MEAN_2M 	"2 000 000 octet/h"
VAL 	15 	MEAN_5M 	"5 000 000 octet/h"
VAL 	16 	MEAN_10M 	"10 000 000 octet/h"
VAL 	17 	MEAN_20M 	"20 000 000 octet/h"
VAL 	18 	MEAN_50M 	"50 000 000 octet/h"
VAL 	31 	MEAN_BEST 	"Best effort"

VALTAB 	VAL_preced
VAL 	0 	PRECED_SUB 	"Subscribed precedence"
VAL 	1 	PRIO_HIGH 	"High priority"
VAL 	2 	PRIO_NORM 	"Normal priority"
VAL 	3 	PRIO_LOW 	"Low priority"

VALTAB 	VAL_radio_prio
VAL 	0 	RADIO_PRIO_1 	"Radio Priority Level 1 (highest)"
VAL 	1 	RADIO_PRIO_2 	"Radio Priority Level 2"
VAL 	2 	RADIO_PRIO_3 	"Radio Priority Level 3"
VAL 	3 	RADIO_PRIO_4 	"Radio Priority Level 4 (lowest)"

VALTAB 	VAL_cause
VAL 	0 	DTACS_DEF 	"any other reason"
VAL 	1 	DTACS_PAGE_RESPONSE 	"data is sent due to a page response"
VAL 	2 	DTACS_MOBILITY_MANAGEMENT 	"mobility management data is sent"
VAL 	3 	DTACS_EMPTY_FRAME 	"data is sent due to a cell update"
VAL 	4 	DTACS_CELL_NOTIFI_NULL_FRAME 	"data is send due to cell notification using LLC unnumbered NULL command."




VAR 	sapi 	"service access point identifier" 	B

VAL 	@p_grlc - VAL_sapi@ 	

VAR 	list_len 	"Length in octets of whole data" 	S


VAR 	first 	"Pointer to generic data descriptors" 	L


VAR 	delay 	"Delay class" 	B

VAL 	@p_grlc - VAL_delay@ 	

VAR 	relclass 	"Reliablility class" 	B

VAL 	@p_grlc - VAL_relclass@ 	

VAR 	peak 	"Peak throughput" 	B

VAL 	@p_grlc - VAL_peak@ 	

VAR 	preced 	"Precedence class" 	B

VAL 	@p_grlc - VAL_preced@ 	

VAR 	mean 	"Main throughput" 	B

VAL 	@p_grlc - VAL_mean@ 	

VAR 	reserved_1 	"Reserved" 	B


VAR 	reserved_2 	"Reserved" 	B


VAR 	reserved_3 	"Reserved" 	B


VAR 	radio_prio 	"Radio Priority" 	B

VAL 	@p_grlc - VAL_radio_prio@ 	

VAR 	l_buf 	"length of content in bit" 	S


VAR 	o_buf 	"offset of content in bit" 	S


VAR 	buf 	"buffer content" 	B


VAR 	tlli 	"temporary logical link identifier" 	L


VAR 	cause 	"Cause" 	B

VAL 	@p_grlc - VAL_cause@ 	

VAR 	reserved_data_req 	"reserved octets for data request" 	B


VAR 	reserved_unitdata_req1 	"reserved octet" 	B


VAR 	reserved_unitdata_req2 	"reserved octets for unitdata request" 	B





COMP 	desc_list 	 "list of generic data descriptors"
{
 	list_len 	 ; Length in octets of whole data
 	first 	 ; Pointer to generic data descriptors
}



COMP 	grlc_qos 	 "Quality of service"
{
 	delay 	 ; Delay class
 	relclass 	 ; Reliablility class
 	peak 	 ; Peak throughput
 	preced 	 ; Precedence class
 	mean 	 ; Main throughput
 	reserved_1 	 ; Reserved
 	reserved_2 	 ; Reserved
 	reserved_3 	 ; Reserved
}



COMP 	sdu 	 "service data unit"
{
 	l_buf 	 ; length of content in bit
 	o_buf 	 ; offset of content in bit
 	buf 	[1] 	 ; buffer content
}






; GRLC_DATA_REQ 	0x80000097
; GRLC_DATA_IND 	0x80004097
; GRLC_DATA_IND_TEST 	0x80014097
; GRLC_UNITDATA_REQ 	0x80010097
; GRLC_UNITDATA_IND 	0x80024097
; GRLC_UNITDATA_IND_TEST 	0x80034097
; GRLC_READY_IND 	0x80044097
; GRLC_ACTIVATE_GMM_QUEUE_REQ 	0x80020097
; GRLC_SUSPEND_READY_IND 	0x80054097
; GRLC_MAC_DATA_IND 	0x80060097
; GRLC_MAC_READY_IND 	0x80070097
; GRLC_MAC_PWR_CTRL_IND 	0x80080097



PRIM 	GRLC_DATA_REQ 	0x80000097
{
 	sapi 	 ; Service access point identifier
 	tlli 	 ; Temporary logical link identifier
 	grlc_qos 	 ; Quality of service
 	radio_prio 	 ; Radio priority
 	cause 	 ; Cause
 	reserved_data_req 	[16] 	 ; Reserved octets for data request
 	sdu 	 ; Service data unit
}






PRIM 	GRLC_DATA_IND 	0x80004097
{
 	tlli 	 ; Temporary logical link identifier
 	desc_list 	 ; List of generic data descriptors
}






PRIM 	GRLC_DATA_IND_TEST 	0x80014097
{
 	tlli 	 ; Temporary logical link identifier
 	sdu 	 ; Service data unit
}






PRIM 	GRLC_UNITDATA_REQ 	0x80010097
{
 	sapi 	 ; Service Access Point Identifier
 	tlli 	 ; Temporary logical link identifier
 	grlc_qos 	 ; Quality of service
 	radio_prio 	 ; Radio priority
 	reserved_unitdata_req1 	 ; Reserved octet
 	reserved_unitdata_req2 	[16] 	 ; Reserved octets for unitdata request
 	sdu 	 ; Service data unit
}






PRIM 	GRLC_UNITDATA_IND 	0x80024097
{
 	tlli 	 ; Temporary logical link identifier
 	desc_list 	 ; List of generic data descriptors
}






PRIM 	GRLC_UNITDATA_IND_TEST 	0x80034097
{
 	tlli 	 ; Temporary logical link identifier
 	sdu 	 ; Service data unit
}






PRIM 	GRLC_READY_IND 	0x80044097
{
}






PRIM 	GRLC_ACTIVATE_GMM_QUEUE_REQ 	0x80020097
{
}






PRIM 	GRLC_SUSPEND_READY_IND 	0x80054097
{
}






PRIM 	GRLC_MAC_DATA_IND 	0x80060097
{
}






PRIM 	GRLC_MAC_READY_IND 	0x80070097
{
}






PRIM 	GRLC_MAC_PWR_CTRL_IND 	0x80080097
{
}