view cdg-hybrid/sap/ll.pdf @ 303:f76436d19a7a default tip

!GPRS config: fix long-standing AT+COPS chance hanging bug There has been a long-standing bug in FreeCalypso going back years: sometimes in the AT command bring-up sequence of an ACI-only MS, the AT+COPS command would produce only a power scan followed by cessation of protocol stack activity (only L1 ADC traces), instead of the expected network search sequence. This behaviour was seen in different FC firmware versions going back to Citrine, and seemed to follow some law of chance, not reliably repeatable. This bug has been tracked down and found to be specific to !GPRS configuration, stemming from our TCS2/TCS3 hybrid and reconstruction of !GPRS support that was bitrotten in TCS3.2/LoCosto version. ACI module psa_mms.c, needed only for !GPRS, was missing in the TCS3 version and had to be pulled from TCS2 - but as it turns out, there is a new field in the MMR_REG_REQ primitive that needs to be set correctly, and that psa_mms.c module is the place where this initialization needed to be added.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 08 Jun 2023 08:23:37 +0000
parents 35f7a1dc9f7d
children
line wrap: on
line source

;********************************************************************************
;*** File           : ll.pdf
;*** Creation       : Wed Mar 11 09:58:15 CST 2009
;*** 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  : ll
;*** Document No.   : 8441.104.99.017
;*** Document Date  : 2003-02-04
;*** Document Status: BEING_PROCESSED
;*** Document Author: UT
;********************************************************************************



PRAGMA 	SRC_FILE_TIME 	"Thu Nov 29 09:44:38 2007"
PRAGMA 	LAST_MODIFIED 	"2003-02-04"
PRAGMA 	ID_AND_VERSION 	"8441.104.99.017"



CONST 	N202 	4 	; maximum number of octets in the layer-3 header, Requirements: <R.LLC.LLC_PAR.A.008>, <R.LLC.TXUI_ADM.A.003>, <R.LLC.RXUI_ADM.A.003>
CONST 	LLC_SDU_OFFSET 	37 	; number of octets that have to be reserved at the beginning of an SDU when an upper layer allocates an SDU for uplink data transfer; these octets are the maximum number of octets that the LLC header can occupy, they have to be skipped when upper layers write / read the contents of the SDU
CONST 	LLC_SDU_OFFSET_BITS 	296 	; LLC_SDU_OFFSET in bits. NOTE: When this definition is changed, upper layer SAPs may also need to be changed!
CONST 	LLC_MAX_L3_XID_LEN 	255 	; Maximum byte length of  the L3 XID parameter.
CONST 	LLC_MAX_L3_XID_LEN 	255 	; Maximum byte length of  the L3 XID parameter.
CONST 	LLC_MAX_CNF 	32 	; Maximum number of L3-PDU confirmations included in one LL_DATA_CNF
EXTERN CONST 	@p_gsmcom - LLC_ORIGINATING_ENTITY@ 	LLC_ORIGINATING_ENTITY 	; mask for indicating the originating entity of a cause is LLC



VALTAB 	VAL_sapi
VAL 	1 	LL_SAPI_1 	"SAP for GMM"
VAL 	3 	LL_SAPI_3 	"SAP 1 for SNDCP"
VAL 	5 	LL_SAPI_5 	"SAP 2 for SNDCP"
VAL 	7 	LL_SAPI_7 	"SAP for SMS"
VAL 	9 	LL_SAPI_9 	"SAP 3 for SNDCP"
VAL 	11 	LL_SAPI_11 	"SAP 4 for SNDCP"
VAL 	255 	LL_SAPI_INVALID 	"invalid SAPI identifier"

VALTAB 	VAL_tlli
VAL 	0xFFFFFFFF 	LL_TLLI_INVALID 	"invalid TLLI value"

VALTAB 	VAL_xid_valid
VAL 	0 	LL_XID_INVALID 	"layer-3 XID parameters are not valid"
VAL 	1 	LL_XID_VALID 	"layer-3 XID parameters are valid"

VALTAB 	VAL_local
VAL 	0 	LL_REL_NOTLOCAL 	"release both sides of the connection"
VAL 	1 	LL_REL_LOCAL 	"local release only (no notification of the peer LLC)"

VALTAB 	VAL_cause
VAL 	0b0101000000000000 	LL_RELCS_INVALID_XID 	"invalid XID response"
VAL 	0b0101000000000001 	LL_RELCS_DM_RECEIVED 	"DM received"
VAL 	0b0101000000000010 	LL_RELCS_NO_PEER_RES 	"no peer response"
VAL 	0b0101000000000100 	LL_RELCS_NORMAL 	"normal release"

VALTAB 	VAL_cipher
VAL 	0 	LL_CIPHER_OFF 	"UI frame not ciphered"
VAL 	1 	LL_CIPHER_ON 	"UI frame ciphered"

VALTAB 	VAL_radio_prio
VAL 	0 	LL_RADIO_PRIO_1 	"Radio Priority Level 1 (higest)"
VAL 	1 	LL_RADIO_PRIO_2 	"Radio Priority Level 2"
VAL 	2 	LL_RADIO_PRIO_3 	"Radio Priority Level 3"
VAL 	3 	LL_RADIO_PRIO_4 	"Radio Priority Level 4 (lowest)"

VALTAB 	VAL_peak
VAL 	0 	LL_PEAK_SUB 	"Subscribed peak throughput"
VAL 	1 	LL_PEAK_1K 	"Up to 1 000 octet/s"
VAL 	2 	LL_PEAK_2K 	"Up to 2 000 octet/s"
VAL 	3 	LL_PEAK_4K 	"Up to 4 000 octet/s"
VAL 	4 	LL_PEAK_8K 	"Up to 8 000 octet/s"
VAL 	5 	LL_PEAK_16K 	"Up to 16 000 octet/s"
VAL 	6 	LL_PEAK_32K 	"Up to 32 000 octet/s"
VAL 	7 	LL_PEAK_64K 	"Up to 64 000 octet/s"
VAL 	8 	LL_PEAK_128K 	"Up to 128 000 octet/s"
VAL 	9 	LL_PEAK_256K 	"Up to 256 000 octet/s"

VALTAB 	VAL_relclass
VAL 	0 	LL_RELCLASS_SUB 	"Subscribed reliability class"
VAL 	1 	LL_GTP_LLC_RLC_PROT 	"Acknowledged GTP, LLC, and RLC; Protected data"
VAL 	2 	LL_LLC_RLC_PROT 	"Unacknowledged GTP; Acknowledged LLC and RLC, Protected data"
VAL 	3 	LL_RLC_PROT 	"Unacknowledged GTP and LLC; Acknowledged RLC, Protected data"
VAL 	4 	LL_PROT 	"Unacknowledged GTP, LLC, and RLC, Protected data"
VAL 	5 	LL_NO_REL 	"Unacknowledged GTP, LLC, and RLC, Unprotected data"

VALTAB 	VAL_delay
VAL 	0 	LL_DELAY_SUB 	"Subscribed delay class"
VAL 	1 	LL_DELAY_1 	"Delay class 1"
VAL 	2 	LL_DELAY_2 	"Delay class 2"
VAL 	3 	LL_DELAY_3 	"Delay class 3"
VAL 	4 	LL_DELAY_4 	"Delay class 4 (best effort)"

VALTAB 	VAL_mean
VAL 	0 	LL_MEAN_SUB 	"Subscribed mean throughput"
VAL 	1 	LL_MEAN_100 	"100 octet/h"
VAL 	2 	LL_MEAN_200 	"200 octet/h"
VAL 	3 	LL_MEAN_500 	"500 octet/h"
VAL 	4 	LL_MEAN_1K 	"1 000 octet/h"
VAL 	5 	LL_MEAN_2K 	"2 000 octet/h"
VAL 	6 	LL_MEAN_5K 	"5 000 octet/h"
VAL 	7 	LL_MEAN_10K 	"10 000 octet/h"
VAL 	8 	LL_MEAN_20K 	"20 000 octet/h"
VAL 	9 	LL_MEAN_50K 	"50 000 octet/h"
VAL 	10 	LL_MEAN_100K 	"100 000 octet/h"
VAL 	11 	LL_MEAN_200K 	"200 000 octet/h"
VAL 	12 	LL_MEAN_500K 	"500 000 octet/h"
VAL 	13 	LL_MEAN_1M 	"1 000 000 octet/h"
VAL 	14 	LL_MEAN_2M 	"2 000 000 octet/h"
VAL 	15 	LL_MEAN_5M 	"5 000 000 octet/h"
VAL 	16 	LL_MEAN_10M 	"10 000 000 octet/h"
VAL 	17 	LL_MEAN_20M 	"20 000 000 octet/h"
VAL 	18 	LL_MEAN_50M 	"50 000 000 octet/h"
VAL 	31 	LL_MEAN_BEST 	"Best effort"

VALTAB 	VAL_preced
VAL 	0 	LL_PRECED_SUB 	"Subscribed precedence"
VAL 	1 	LL_PRIO_HIGH 	"High priority"
VAL 	2 	LL_PRIO_NORM 	"Normal priority"
VAL 	3 	LL_PRIO_LOW 	"Low priority"

VALTAB 	VAL_error_cause
VAL 	0b0101000000000000 	LL_ERRCS_INVALID_XID 	"invalid XID response"
VAL 	0b0101000000000010 	LL_ERRCS_NO_PEER_RES 	"no peer response"

VALTAB 	VAL_attached_counter
VAL 	0 	LLC_NO_ATTACHE 	"no entity/service is attached to the primitive"

VALTAB 	VAL_seg_pos
VAL 	0 	LL_SEG_POS_NONE 	"In between"
VAL 	1 	LL_SEG_POS_FIRST 	"first"
VAL 	2 	LL_SEG_POS_LAST 	"last"
VAL 	3 	LL_SEG_POS_FIRST_LAST 	"both"

VALTAB 	VAL_pkt_flow_id 	%REL99%
VAL 	0x00 	LL_PFI_BEST_EFFORT 	%REL99% 	"best effort"
VAL 	0x01 	LL_PFI_SIGNALING 	%REL99% 	"signalling"
VAL 	0x02 	LL_PFI_SMS 	%REL99% 	"SMS"
VAL 	0xFF 	LL_PKT_FLOW_ID_NOT_PRES 	%REL99% 	"value FF is used to indicate when packet flwo identifier is not present"




VAR 	sapi 	"service access point identifier" 	B

VAL 	@p_ll - VAL_sapi@ 	

VAR 	tlli 	"temporary logical link identifier" 	L

VAL 	@p_ll - VAL_tlli@ 	

VAR 	xid_valid 	"layer-3 XID parameters valid or not" 	B

VAL 	@p_ll - VAL_xid_valid@ 	

VAR 	l_buf 	"length of content in bit" 	S


VAR 	o_buf 	"offset of content in bit" 	S


VAR 	buf 	"buffer content" 	B


VAR 	n201_u 	"maximum number of octets in an U or UI frame information field" 	S


VAR 	n201_i 	"maximum number of octets in an I frame information field" 	S


VAR 	local 	"local release or release both sides" 	B

VAL 	@p_ll - VAL_local@ 	

VAR 	cause 	"cause of ABM termination" 	S

VAL 	@p_ll - VAL_cause@ 	

VAR 	ref_nsapi 	"ref_nsapi" 	B


VAR 	ref_npdu_num 	"ref_npdu_num" 	S


VAR 	ref_seg_num 	"ref_seg_num" 	B


VAR 	cipher 	"ciphering indicator" 	B

VAL 	@p_ll - VAL_cipher@ 	

VAR 	radio_prio 	"Radio Priority" 	B

VAL 	@p_ll - VAL_radio_prio@ 	

VAR 	delay 	"delay class" 	B

VAL 	@p_ll - VAL_delay@ 	

VAR 	relclass 	"reliability class" 	B

VAL 	@p_ll - VAL_relclass@ 	

VAR 	peak 	"peak throughput" 	B

VAL 	@p_ll - VAL_peak@ 	

VAR 	preced 	"precedence class" 	B

VAL 	@p_ll - VAL_preced@ 	

VAR 	mean 	"main throughput" 	B

VAL 	@p_ll - VAL_mean@ 	

VAR 	reserved_1 	"reserved" 	B


VAR 	reserved_2 	"reserved" 	B


VAR 	reserved_3 	"reserved" 	B


VAR 	reserved_release_cnf 	"reserved octets for release confirm" 	B


VAR 	reserved_data_req1 	"reserved octets" 	B


VAR 	reserved_data_req4 	"reserved octets for data request" 	L


VAR 	reserved_data_req5 	%!REL99% 	"reserved octets" 	S


VAR 	reserved_unitdata_req4 	"reserved octets for unitdata request" 	L


VAR 	reserved_unitdata_req5 	%!REL99% 	"reserved octets" 	S


VAR 	reserved_data_ind1 	"reserved octets for data indication" 	L


VAR 	reserved_data_ind3 	"reserved octets for data indication" 	B


VAR 	reserved_data_ind4 	"reserved octets for data indication" 	B


VAR 	reserved_data_ind5 	"reserved octets for data indication" 	B


VAR 	reserved_data_ind6 	"reserved octets for data indication" 	B


VAR 	reserved_unitdata_ind1 	"reserved octets" 	L


VAR 	reserved_unitdata_ind3 	"reserved octets" 	B


VAR 	reserved_unitdata_ind4 	"reserved octets" 	B


VAR 	reserved_unitdata_ind5 	"reserved octets" 	B


VAR 	error_cause 	"error cause" 	S

VAL 	@p_ll - VAL_error_cause@ 	

VAR 	attached_counter 	"attached to primitive data counter" 	B

VAL 	@p_ll - VAL_attached_counter@ 	

VAR 	seg_pos 	"First and/or last segment of N-PDU?" 	B

VAL 	@p_ll - VAL_seg_pos@ 	

VAR 	list_len 	"length in octets of whole data" 	S


VAR 	first 	"pointer to first generic data descriptor" 	L


VAR 	next 	"next generic data descriptor" 	L


VAR 	offset 	"offset in octets" 	S


VAR 	len 	"length of content in octets" 	S


VAR 	buffer 	"pointer to buffer" 	L


VAR 	pkt_flow_id 	%REL99% 	"packet flow identifier" 	S

VAL 	@p_ll - VAL_pkt_flow_id@ 	




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



COMP 	reference1 	 "to the segment to be confirmed"
{
 	ref_nsapi 	 ; ref_nsapi
 	ref_npdu_num 	 ; ref_npdu_num
 	ref_seg_num 	 ; ref_seg_num
}
TYPEDEF COMP reference1 	reserved_unitdata_req1 	 "reserved octets"
TYPEDEF COMP reference1 	reserved_data_ind2 	 "reserved octets"
TYPEDEF COMP reference1 	reserved_unitdata_ind2 	 "reserved octets"



COMP 	ll_qos 	 "quality of service"
{
 	delay 	 ; delay class
 	relclass 	 ; reliability class
 	peak 	 ; peak throughput
 	preced 	 ; precedence class
 	mean 	 ; main throughput
 	reserved_1 	 ; reserved
 	reserved_2 	 ; reserved
 	reserved_3 	 ; reserved
}



COMP 	desc_list3 	 "List of generic data descriptors"
{
 	list_len 	 ; length in octets of whole data
 	first 	 ; pointer to first generic data descriptor
}



COMP 	desc3 	 "generic data descriptor"
{
 	next 	 ; next generic data descriptor
 	offset 	 ; offset in octets
 	len 	 ; length of content in octets
 	buffer 	 ; pointer to buffer
}






; LL_RESET_IND 	0x6200
; LL_ESTABLISH_REQ 	0x2200
; LL_ESTABLISH_CNF 	0x6201
; LL_ESTABLISH_IND 	0x6202
; LL_ESTABLISH_RES 	0x2201
; LL_RELEASE_REQ 	0x2202
; LL_RELEASE_CNF 	0x6203
; LL_RELEASE_IND 	0x6204
; LL_XID_REQ 	0x2203
; LL_XID_CNF 	0x6205
; LL_XID_IND 	0x6206
; LL_XID_RES 	0x2204
; LL_READY_IND 	0x6207
; LL_UNITREADY_IND 	0x6208
; LL_GETDATA_REQ 	0x2205
; LL_GETUNITDATA_REQ 	0x2206
; LL_DATA_REQ 	0x2207
; LL_DATA_CNF 	0x6209
; LL_DATA_IND 	0x620A
; LL_UNITDATA_REQ 	0x2208
; LL_UNITDATA_IND 	0x620B
; LL_STATUS_IND 	0x620C
; LL_DESC_REQ 	0x2209
; LL_UNITDESC_REQ 	0x220A
; LLC_DUMMY_REQ 	0x220B



PRIM 	LL_RESET_IND 	0x6200
{
 	sapi 	 ; service access point identifier
}






PRIM 	LL_ESTABLISH_REQ 	0x2200
{
 	sapi 	 ; service access point identifier
 	sdu 	 ; layer-3 XID parameters to be negotiated
}






PRIM 	LL_ESTABLISH_CNF 	0x6201
{
 	sapi 	 ; service access point identifier
 	n201_u 	 ; unacknowledged information field length
 	n201_i 	 ; acknowledged information field length
 	xid_valid 	 ; layer-3 XID parameters valid
 	sdu 	 ; negotiated layer-3 XID parameters
}






PRIM 	LL_ESTABLISH_IND 	0x6202
{
 	sapi 	 ; service access point identifier
 	n201_u 	 ; unacknowledged information field length
 	n201_i 	 ; acknowledged information field length
 	xid_valid 	 ; layer-3 XID parameters valid
 	sdu 	 ; layer-3 XID parameters to be negotiated
}






PRIM 	LL_ESTABLISH_RES 	0x2201
{
 	sapi 	 ; service access point identifier
 	xid_valid 	 ; layer-3 XID parameters valid
 	sdu 	 ; negotiated layer-3 XID parameters
}






PRIM 	LL_RELEASE_REQ 	0x2202
{
 	sapi 	 ; service access point identifier
 	local 	 ; local release
}






PRIM 	LL_RELEASE_CNF 	0x6203
{
 	sapi 	 ; service access point identifier
 	reserved_release_cnf 	 ; reserved octets for release confirm
}






PRIM 	LL_RELEASE_IND 	0x6204
{
 	sapi 	 ; service access point identifier
 	cause 	 ; cause of ABM termination
}






PRIM 	LL_XID_REQ 	0x2203
{
 	sapi 	 ; service access point identifier
 	sdu 	 ; service data unit
}






PRIM 	LL_XID_CNF 	0x6205
{
 	sapi 	 ; service access point identifier
 	n201_u 	 ; unacknowledged information field length
 	n201_i 	 ; acknowledged information field length
 	sdu 	 ; service data unit
}






PRIM 	LL_XID_IND 	0x6206
{
 	sapi 	 ; service access point identifier
 	n201_u 	 ; unacknowledged information field length
 	n201_i 	 ; acknowledged information field length
 	xid_valid 	 ; layer-3 XID parameters valid
 	sdu 	 ; layer-3 XID parameters to be negotiated
}






PRIM 	LL_XID_RES 	0x2204
{
 	sapi 	 ; service access point identifier
 	sdu 	 ; service data unit
}






PRIM 	LL_READY_IND 	0x6207
{
 	sapi 	 ; service access point identifier
}






PRIM 	LL_UNITREADY_IND 	0x6208
{
 	sapi 	 ; service access point identifier
}






PRIM 	LL_GETDATA_REQ 	0x2205
{
 	sapi 	 ; service access point identifier
}






PRIM 	LL_GETUNITDATA_REQ 	0x2206
{
 	sapi 	 ; service access point identifier
 	tlli 	 ; temporary logical link entity
}






PRIM 	LL_DATA_REQ 	0x2207
{
 	sapi 	 ; service access point identifier
 	tlli 	 ; temporary logical link entity
 	ll_qos 	 ; quality of service
 	radio_prio 	 ; radio priority
 	reserved_data_req1 	 ; reserved octet
 	reference1 	 ; reference to the PDU
 	seg_pos 	 ; reserved octets
 	attached_counter 	 ; attached to primitive counter
 	reserved_data_req4 	 ; reserved octets for data request
 	pkt_flow_id 	 	%REL99% ; packet flow identifier
 	reserved_data_req5 	 	%!REL99% ; reserved octets for data request
 	sdu 	 ; service data unit
}






PRIM 	LL_DATA_CNF 	0x6209
{
 	sapi 	 ; service access point identifier
 	reference1 	[1..LLC_MAX_CNF] 	 ; reference to the PDU
}






PRIM 	LL_DATA_IND 	0x620A
{
 	sapi 	 ; service access point identifier
 	tlli 	 ; temporary logical link entity
 	reserved_data_ind1 	 ; reserved octets
 	reserved_data_ind2 	 ; reserved octets
 	reserved_data_ind3 	 ; reserved octets
 	reserved_data_ind4 	 ; reserved octets
 	reserved_data_ind5 	 ; reserved octets
 	reserved_data_ind6 	 ; reserved octets
 	sdu 	 ; service data unit
}






PRIM 	LL_UNITDATA_REQ 	0x2208
{
 	sapi 	 ; service access point identifier
 	tlli 	 ; temporary logical link entity
 	ll_qos 	 ; quality of service
 	radio_prio 	 ; radio priority
 	cipher 	 ; ciphering indicator
 	reserved_unitdata_req1 	 ; reserved octets
 	seg_pos 	 ; reserved octets
 	attached_counter 	 ; attached to primitive counter
 	reserved_unitdata_req4 	 ; reserved octets for unitdata request
 	pkt_flow_id 	 	%REL99% ; packet flow identifier
 	reserved_unitdata_req5 	 	%!REL99% ; reserved octets
 	sdu 	 ; service data unit
}






PRIM 	LL_UNITDATA_IND 	0x620B
{
 	sapi 	 ; service access point identifier
 	tlli 	 ; temporary logical link entity
 	reserved_unitdata_ind1 	 ; reserved octets
 	reserved_unitdata_ind2 	 ; reserved octets
 	reserved_unitdata_ind3 	 ; reserved octets
 	reserved_unitdata_ind4 	 ; reserved octets
 	reserved_unitdata_ind5 	 ; reserved octets
 	cipher 	 ; ciphering indicator
 	sdu 	 ; service data unit
}






PRIM 	LL_STATUS_IND 	0x620C
{
 	sapi 	 ; service access point identifier
 	error_cause 	 ; error cause
}






PRIM 	LL_DESC_REQ 	0x2209
{
 	sapi 	 ; service access point identifier
 	tlli 	 ; temporary logical link entity
 	ll_qos 	 ; quality of service
 	radio_prio 	 ; radio priority
 	reserved_data_req1 	 ; reserved octet
 	reference1 	 ; reference to the PDU
 	seg_pos 	 ; reserved octets
 	attached_counter 	 ; attached to primitive counter
 	reserved_data_req4 	 ; reserved octets for data request
 	pkt_flow_id 	 	%REL99% ; packet flow identifier
 	reserved_data_req5 	 	%!REL99% ; reserved octets for data request
 	desc_list3 	 ; List of generic data descriptors
}






PRIM 	LL_UNITDESC_REQ 	0x220A
{
 	sapi 	 ; service access point identifier
 	tlli 	 ; temporary logical link entity
 	ll_qos 	 ; quality of service
 	radio_prio 	 ; radio priority
 	cipher 	 ; ciphering indicator
 	reserved_unitdata_req1 	 ; reserved octets
 	seg_pos 	 ; reserved octets
 	attached_counter 	 ; attached to primitive counter
 	reserved_unitdata_req4 	 ; reserved octets for unitdata request
 	pkt_flow_id 	 	%REL99% ; packet flow identifier
 	reserved_unitdata_req5 	 	%!REL99% ; reserved octets
 	desc_list3 	 ; List of generic data descriptors
}






PRIM 	LLC_DUMMY_REQ 	0x220B
{
 	desc3 	 ; generic data descriptor
}