FreeCalypso > hg > fc-tourmaline

view cdg-hybrid/sap/dl.pdf @ 220:0ed36de51973

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
ABB semaphore protection overhaul The ABB semaphone protection logic that came with TCS211 from TI was broken in several ways: * Some semaphore-protected functions were called from Application_Initialize() context. NU_Obtain_Semaphore() called with NU_SUSPEND fails with NU_INVALID_SUSPEND in this context, but the return value wasn't checked, and NU_Release_Semaphore() would be called unconditionally at the end. The latter call would increment the semaphore count past 1, making the semaphore no longer binary and thus no longer effective for resource protection. The fix is to check the return value from NU_Obtain_Semaphore() and skip the NU_Release_Semaphore() call if the semaphore wasn't properly obtained. * Some SPI hardware manipulation was being done before entering the semaphore- protected critical section. The fix is to reorder the code: first obtain the semaphore, then do everything else. * In the corner case of L1/DSP recovery, l1_abb_power_on() would call some non-semaphore-protected ABB & SPI init functions. The fix is to skip those calls in the case of recovery. * A few additional corner cases existed, all of which are fixed by making ABB semaphore protection 100% consistent for all ABB functions and code paths. There is still one remaining problem of priority inversion: suppose a low- priority task calls an ABB function, and some medium-priority task just happens to preempt right in the middle of that semaphore-protected ABB operation. Then the high-priority SPI task is locked out for a non-deterministic time until that medium-priority task finishes its work and goes back to sleep. This priority inversion problem remains outstanding for now.
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 26 Apr 2021 20:55:25 +0000
parents 35f7a1dc9f7d
children
line wrap: on
line source

;********************************************************************************
;*** File           : dl.pdf
;*** Creation       : Wed Mar 11 09:57:57 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  : dl
;*** Document No.   : 8010.100.02.010
;*** Document Date  : 2004-04-28
;*** Document Status: BEING_PROCESSED
;*** Document Author: MSB
;********************************************************************************



PRAGMA 	SRC_FILE_TIME 	"Thu Nov 29 09:40:06 2007"
PRAGMA 	LAST_MODIFIED 	"2004-04-28"
PRAGMA 	ID_AND_VERSION 	"8010.100.02.010"
PRAGMA 	PREFIX 	DL 	; Prefix for this document
PRAGMA 	ALLWAYS_ENUM_IN_VAL_FILE 	YES 	; Adds enumerations in the .val file.
PRAGMA 	ENABLE_GROUP 	NO 	; Enable h-file grouping
PRAGMA 	COMPATIBILITY_DEFINES 	NO 	; Compatible to the old #defines



CONST 	MAX_SDU_LEN 	1 	; Maximum number of bytes in an SDU (dummy value)
CONST 	N201_SACCH_A_B 	18 	; Maximum number of octets for the information field for frames of format A and B (SACCH)
CONST 	N201_DCCH_A_B 	20 	; Maximum number of octets for the information field for frames of format A and B (SDCCH, FACCH)
CONST 	N201_Bbis 	23 	; Maximum number of octets for the information field for frames of format Bbis (BCCH,AGCH,NCH,PCH)
CONST 	N201_SACCH_Bter 	21 	; Maximum number of octets for the information field for frames of format Bter (SACCH)
CONST 	N201_DCCH_Bter 	23 	; Maximum number of octets for the information field for frames of format Bter (FACCH,SDCCH)
EXTERN CONST 	@p_mphc - MAX_L2_FRAME_SIZE@ 	MAX_L2_FRAME_SIZE 	; Maximum number of octets for layer 2 frames of all formats
CONST 	SPD_PID 	16 	; Defines the Primitive number for DL_SHORTUNIT_DATA_REQ/IND



VALTAB 	VAL_l2_channel 	%!TI_DUAL_MODE%
VAL 	1 	L2_CHANNEL_SACCH 	"SACCH block"
VAL 	2 	L2_CHANNEL_SDCCH 	"SDCCH block"
VAL 	3 	L2_CHANNEL_FACCH_H 	"FACCH halfrate block"
VAL 	4 	L2_CHANNEL_FACCH_F 	"FACCH fullrate block"
VAL 	5 	L2_CHANNEL_CCCH 	"CCCH block"
VAL 	6 	L2_CHANNEL_NBCCH 	"normal BCCH block"
VAL 	7 	L2_CHANNEL_PCH 	"PCH block"
VAL 	8 	L2_CHANNEL_EPCH 	"extended PCH block"
VAL 	9 	L2_CHANNEL_CBCH 	"CBCH block"
VAL 	10 	L2_CHANNEL_EBCCH 	"extended BCCH"

VALTAB 	VAL_sapi
VAL 	0 	SAPI_0 	%!TI_DUAL_MODE% 	"SAPI 0"
VAL 	3 	SAPI_3 	%!TI_DUAL_MODE% 	"SAPI 3"

VALTAB 	VAL_indication
VAL 	0 	ALL_DONE 	"no unacknowledges or unserved data requests"
VAL 	1 	UNSERVED 	"unserved data requests"

VALTAB 	VAL_mode
VAL 	0 	NORMAL_RELEASE 	"normal release procedure"
VAL 	1 	LOCAL_END_RELEASE 	"local end release procedure"

VALTAB 	VAL_cnf
VAL 	0 	NO_CONFIRMATION 	"no confimation necessary"

VALTAB 	VAL_cs
VAL 	0 	INFO_FIELD_MISMATCH 	%!TI_DUAL_MODE% 	"different information fields"




VAR 	l2_channel 	%!TI_DUAL_MODE% 	"Layer 2 channel-type" 	B

VAL 	@p_mphc - VAL_l2_channel@ 	

VAR 	indication 	"Indication for unserved data requests" 	B

VAL 	@p_dl - VAL_indication@ 	

VAR 	mode 	"release mode" 	B

VAL 	@p_dl - VAL_mode@ 	

VAR 	sapi 	%!TI_DUAL_MODE% 	"service access point identifier" 	B

VAL 	@p_dl - VAL_sapi@ 	

VAR 	cnf 	"Confimation demand" 	B

VAL 	@p_dl - VAL_cnf@ 	

VAR 	l_buf 	%!TI_DUAL_MODE% 	"Length in bits" 	S


VAR 	o_buf 	%!TI_DUAL_MODE% 	"Offset in bits" 	S


VAR 	buf 	%!TI_DUAL_MODE% 	"Message content" 	B


VAR 	cs 	%!TI_DUAL_MODE% 	"error cause" 	B

VAL 	@p_dl - VAL_cs@ 	

VAR 	error_flag 	"error cause" 	B

VAL 	@p_mphc - VAL_error_flag@ 	

VAR 	pwr_lev 	"Ordered mobile power level" 	B


VAR 	ta 	"Timing advance" 	B


VAR 	signal_data 	"Pointer to signal data" 	L


VAR 	fn 	"Frame number" 	L





COMP 	sdu 	 	%!TI_DUAL_MODE% "Container for a message"
{
 	l_buf 	 ; Length in bits
 	o_buf 	 ; Offset in bits
 	buf 	[MAX_SDU_LEN] 	 ; Message content
}






; DL_ESTABLISH_REQ 	0x80000003
; DL_ESTABLISH_CNF 	0x80014003
; DL_ESTABLISH_IND 	0x80004003
; DL_RELEASE_REQ 	0x80020003
; DL_RELEASE_CNF 	0x80034003
; DL_RELEASE_IND 	0x80024003
; DL_DATA_REQ 	0x80040003
; DL_DATA_CNF 	0x80050003
; DL_DATA_IND 	0x80044003
; DL_UNITDATA_REQ 	0x80060003
; DL_UNITDATA_IND 	0x80064003
; DL_SHORT_UNITDATA_REQ 	0x80100003
; DL_SHORT_UNITDATA_IND 	0x80104003
; DL_SUSPEND_REQ 	0x80080003
; DL_RESUME_REQ 	0x800A0003
; DL_RECONNECT_REQ 	0x800C0003
; DL_TRACE_REQ 	0x800E0003
; DL_SIGNAL_ESTABLISH_IND 	0x80124003
; DL_SIGNAL_ESTABLISH_CNF 	0x80134003
; DL_SIGNAL_DATA_IND 	0x80144003
; DL_SIGNAL_DATA_CNF 	0x80154003
; DL_SIGNAL_UNITDATA_IND 	0x80164003
; DL_SIGNAL_SHORT_UNITDATA_IND 	0x80184003
; DL_SIGNAL_RELEASE_IND 	0x801A4003
; DL_SIGNAL_RELEASE_CNF 	0x801B4003
; DL_SIGNAL_ERROR_IND 	0x801C4003
; DL_SIGNAL_FREE_POINTER 	0x801D4003
; DL_SIGNAL_CONCATENATE 	0x801E4003
; DL_SIGNAL_L2TRACE 	0x801F4003
; DL_SIGNAL_L3TRACE 	0x80204003
; DL_SIGNAL_EM_IND 	0x80214003
; DL_SIGNAL_EM_WRITE 	0x80224003
; DL_SIGNAL_EM_READ 	0x80234003



PRIM 	DL_ESTABLISH_REQ 	0x80000003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	EXTERN @p_8010_152_ps_include - sdu@ 	sdu 	 	%TI_DUAL_MODE% ; Service data unit
 	sdu 	 	%!TI_DUAL_MODE% ; Service data unit
}






PRIM 	DL_ESTABLISH_CNF 	0x80014003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	indication 	 ; Indication of outstanding acknowledgements or unserved DL-DATA-REQUEST primitives
}






PRIM 	DL_ESTABLISH_IND 	0x80004003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	indication 	 ; Indication of outstanding acknowledgements or unserved DL-DATA-REQUEST primitives
}






PRIM 	DL_RELEASE_REQ 	0x80020003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	mode 	 ; Release mode
}






PRIM 	DL_RELEASE_CNF 	0x80034003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	indication 	 ; Indication of outstanding acknowledgements or unserved DL-DATA-REQUEST primitives
}






PRIM 	DL_RELEASE_IND 	0x80024003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	EXTERN @p_8010_153_cause_include - ps_cause@ 	ps_cause 	 	%TI_DUAL_MODE% ; Error cause
 	cs 	 	%!TI_DUAL_MODE% ; Error cause
}






PRIM 	DL_DATA_REQ 	0x80040003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	cnf 	 ; confirmation demand
 	EXTERN @p_8010_152_ps_include - sdu@ 	sdu 	 	%TI_DUAL_MODE% ; Service data unit
 	sdu 	 	%!TI_DUAL_MODE% ; Service data unit
}






PRIM 	DL_DATA_CNF 	0x80050003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	cnf 	 ; confirmation demand
}






PRIM 	DL_DATA_IND 	0x80044003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	EXTERN @p_8010_147_l1_include - fn@ 	fn 	 	%TI_DUAL_MODE% ; Frame number
 	fn 	 	%!TI_DUAL_MODE% ; Frame number
 	EXTERN @p_8010_152_ps_include - sdu@ 	sdu 	 	%TI_DUAL_MODE% ; Service data unit
 	sdu 	 	%!TI_DUAL_MODE% ; Service data unit
}






PRIM 	DL_UNITDATA_REQ 	0x80060003
{
 	EXTERN @p_8010_152_ps_include - sdu@ 	sdu 	 	%TI_DUAL_MODE% ; Service data unit
 	sdu 	 	%!TI_DUAL_MODE% ; Service data unit
}






PRIM 	DL_UNITDATA_IND 	0x80064003
{
 	error_flag 	 ; Indicates if l2_frame data is invalid
 	pwr_lev 	 ; Ordered mobile power level
 	ta 	 ; Timing advance
 	EXTERN @p_8010_147_l1_include - fn@ 	fn 	 	%TI_DUAL_MODE% ; Frame number
 	fn 	 	%!TI_DUAL_MODE% ; Frame number
 	EXTERN @p_8010_152_ps_include - sdu@ 	sdu 	 	%TI_DUAL_MODE% ; Service data unit
 	sdu 	 	%!TI_DUAL_MODE% ; Service data unit
}






PRIM 	DL_SHORT_UNITDATA_REQ 	0x80100003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sdu@ 	sdu 	 	%TI_DUAL_MODE% ; Service data unit
 	sdu 	 	%!TI_DUAL_MODE% ; Service data unit
}






PRIM 	DL_SHORT_UNITDATA_IND 	0x80104003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	error_flag 	 ; Indicates if l2_frame data is invalid
 	pwr_lev 	 ; Ordered mobile power level
 	ta 	 ; Timing advance
 	EXTERN @p_8010_147_l1_include - fn@ 	fn 	 	%TI_DUAL_MODE% ; Frame number
 	fn 	 	%!TI_DUAL_MODE% ; Frame number
 	EXTERN @p_8010_152_ps_include - sdu@ 	sdu 	 	%TI_DUAL_MODE% ; Service data unit
 	sdu 	 	%!TI_DUAL_MODE% ; Service data unit
}






PRIM 	DL_SUSPEND_REQ 	0x80080003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
}






PRIM 	DL_RESUME_REQ 	0x800A0003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	EXTERN @p_8010_152_ps_include - sdu@ 	sdu 	 	%TI_DUAL_MODE% ; Service data unit
 	sdu 	 	%!TI_DUAL_MODE% ; Service data unit
}






PRIM 	DL_RECONNECT_REQ 	0x800C0003
{
 	EXTERN @p_8010_147_l1_include - l2_channel@ 	l2_channel AS ch_type 	 	%TI_DUAL_MODE% ; Channel type
 	l2_channel AS ch_type 	 	%!TI_DUAL_MODE% ; Channel type
 	EXTERN @p_8010_152_ps_include - sapi@ 	sapi 	 	%TI_DUAL_MODE% ; Service access point identifier
 	sapi 	 	%!TI_DUAL_MODE% ; Service access point identifier
 	EXTERN @p_8010_152_ps_include - sdu@ 	sdu 	 	%TI_DUAL_MODE% ; Service data unit
 	sdu 	 	%!TI_DUAL_MODE% ; Service data unit
}






PRIM 	DL_TRACE_REQ 	0x800E0003
{
}






PRIM 	DL_SIGNAL_ESTABLISH_IND 	0x80124003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_ESTABLISH_CNF 	0x80134003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_DATA_IND 	0x80144003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_DATA_CNF 	0x80154003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_UNITDATA_IND 	0x80164003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_SHORT_UNITDATA_IND 	0x80184003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_RELEASE_IND 	0x801A4003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_RELEASE_CNF 	0x801B4003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_ERROR_IND 	0x801C4003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_FREE_POINTER 	0x801D4003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_CONCATENATE 	0x801E4003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_L2TRACE 	0x801F4003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_L3TRACE 	0x80204003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_EM_IND 	0x80214003
{
}






PRIM 	DL_SIGNAL_EM_WRITE 	0x80224003
{
 	signal_data AS signal_data 	 ; Pointer
}






PRIM 	DL_SIGNAL_EM_READ 	0x80234003
{
}