FreeCalypso > hg > fc-magnetite

view cdg211/prim/dti.pdf @ 600:8f50b202e81f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
board preprocessor conditionals: prep for more FC hw in the future This change eliminates the CONFIG_TARGET_FCDEV3B preprocessor symbol and all preprocessor conditionals throughout the code base that tested for it, replacing them with CONFIG_TARGET_FCFAM or CONFIG_TARGET_FCMODEM. These new symbols are specified as follows: CONFIG_TARGET_FCFAM is intended to cover all hardware designs created by Mother Mychaela under the FreeCalypso trademark. This family will include modem products (repackagings of the FCDEV3B, possibly with RFFE or even RF transceiver changes), and also my desired FreeCalypso handset product. CONFIG_TARGET_FCMODEM is intended to cover all FreeCalypso modem products (which will be firmware-compatible with the FCDEV3B if they use TI Rita transceiver, or will require a different fw build if we switch to one of Silabs Aero transceivers), but not the handset product. Right now this CONFIG_TARGET_FCMODEM preprocessor symbol is used to conditionalize everything dealing with MCSI. At the present moment the future of FC hardware evolution is still unknown: it is not known whether we will ever have any beyond-FCDEV3B hardware at all (contingent on uncertain funding), and if we do produce further FC hardware designs, it is not known whether they will retain the same FIC modem core (triband), if we are going to have a quadband design that still retains the classic Rita transceiver, or if we are going to switch to Silabs Aero II or some other transceiver. If we produce a quadband modem that still uses Rita, it will run exactly the same fw as the FCDEV3B thanks to the way we define TSPACT signals for the RF_FAM=12 && CONFIG_TARGET_FCFAM combination, and the current fcdev3b build target will be renamed to fcmodem. OTOH, if that putative quadband modem will be Aero-based, then it will require a different fw build target, the fcdev3b target will stay as it is, and the two targets will both define CONFIG_TARGET_FCFAM and CONFIG_TARGET_FCMODEM, but will have different RF_FAM numbers. But no matter which way we are going to evolve, it is not right to have conditionals on CONFIG_TARGET_FCDEV3B in places like ACI, and the present change clears the way for future evolution.
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 01 Apr 2019 01:05:24 +0000
parents 56abf6cf8a0b
children
line wrap: on
line source

;********************************************************************************
;*** File           : dti.pdf
;*** Creation       : Fri Jun 08 13:57:17 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  : dti
;*** Document No.   : 8411.110.00.007
;*** Document Date  : 2000-06-29
;*** Document Status: BEING_PROCESSED
;*** Document Author: MG
;********************************************************************************



PRAGMA 	SRC_FILE_TIME 	"Mon Nov 24 15:50:28 2003"
PRAGMA 	LAST_MODIFIED 	"2000-06-29"
PRAGMA 	ID_AND_VERSION 	"8411.110.00.007"






VALTAB 	VAL_c_id
VAL 	0 	DTI_NSAPI_0 	"escape mechanism for future extensions"
VAL 	1 	DTI_NSAPI_1 	"Point-To-Multipoint Multicast information"
VAL 	2 	DTI_NSAPI_2 	"reserved for future use"
VAL 	3 	DTI_NSAPI_3 	"reserved for future use"
VAL 	4 	DTI_NSAPI_4 	"reserved for future use"
VAL 	5 	DTI_NSAPI_5 	"dynamically allocated NSAPI value"
VAL 	6 	DTI_NSAPI_6 	"dynamically allocated NSAPI value"
VAL 	7 	DTI_NSAPI_7 	"dynamically allocated NSAPI value"
VAL 	8 	DTI_NSAPI_8 	"dynamically allocated NSAPI value"
VAL 	9 	DTI_NSAPI_9 	"dynamically allocated NSAPI value"
VAL 	10 	DTI_NSAPI_10 	"dynamically allocated NSAPI value"
VAL 	11 	DTI_NSAPI_11 	"dynamically allocated NSAPI value"
VAL 	12 	DTI_NSAPI_12 	"dynamically allocated NSAPI value"
VAL 	13 	DTI_NSAPI_13 	"dynamically allocated NSAPI value"
VAL 	14 	DTI_NSAPI_14 	"dynamically allocated NSAPI value"
VAL 	15 	DTI_NSAPI_15 	"dynamically allocated NSAPI value"
VAL 	5 	DTI_C_ID_DEFAULT 	"Default value for c_id"

VALTAB 	VAL_p_id
VAL 	0x21 	DTI_PID_IP 	"simple ip packet"
VAL 	0x2D 	DTI_PID_CTCP 	"Van Jacobson compressed TCP/IP header"
VAL 	0x2F 	DTI_PID_UTCP 	"Van Jacobson uncompressed TCP/IP header"
VAL 	0x00 	DTI_PID_FRAME 	"PPP frame"

VALTAB 	VAL_op_ack
VAL 	0x01 	OP_ACK 	"acknowledged operation mode"
VAL 	0x00 	OP_UNACK 	"unacknowledged operation mode"

VALTAB 	VAL_st_flow
VAL 	0 	DTI_FLOW_ON 	"flow control is inactive"
VAL 	1 	DTI_FLOW_OFF 	"flow control is active"

VALTAB 	VAL_st_line_sa
VAL 	0 	DTI_SA_ON 	"SA is inactive"
VAL 	1 	DTI_SA_OFF 	"SA is active"

VALTAB 	VAL_st_line_sb
VAL 	0 	DTI_SB_ON 	"SB is inactive"
VAL 	1 	DTI_SB_OFF 	"SB is active"

VALTAB 	VAL_st_escape
VAL 	0 	DTI_ESC_OFF 	"No escape detected"
VAL 	1 	DTI_ESC_ON 	"Escape detected"




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 	len 	"length of content in octets" 	S


VAR 	buffer 	"buffer content" 	B


VAR 	tui 	"transmission unit identifier" 	S


VAR 	c_id 	"channel identifier" 	B

VAL 	@p_dti - VAL_c_id@ 	

VAR 	p_id 	"protocol identifier" 	B

VAL 	@p_dti - VAL_p_id@ 	

VAR 	op_ack 	"operation mode" 	B

VAL 	@p_dti - VAL_op_ack@ 	

VAR 	st_flow 	"flow control state" 	B

VAL 	@p_dti - VAL_st_flow@ 	

VAR 	st_line_sa 	"line state sa" 	B

VAL 	@p_dti - VAL_st_line_sa@ 	

VAR 	st_line_sb 	"line state sb" 	B

VAL 	@p_dti - VAL_st_line_sb@ 	

VAR 	st_escape 	"escape state" 	B

VAL 	@p_dti - VAL_st_escape@ 	

VAR 	l_buf 	"length of content in bit" 	S


VAR 	o_buf 	"offset of content in bit" 	S


VAR 	buf 	"test data" 	B





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



COMP 	desc 	 "generic data descriptor"
{
 	next 	 ; next generic data descriptor
 	len 	 ; length of content in octets
 	buffer 	[1] 	 ; buffer content
}



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






; DTI_READY_IND 	0x7700
; DTI_GETDATA_REQ 	0x3700
; DTI_DATA_REQ 	0x3701
; DTI_DATA_IND 	0x7701
; DTI_DATA_TEST_REQ 	0x3702
; DTI_DATA_TEST_IND 	0x7702
; DTI_DUMMY_REQ 	0x3703



PRIM 	DTI_READY_IND 	0x7700
{
 	tui 	 ; transmission unit identifier
 	c_id 	 ; channel identifier
 	op_ack 	 ; operation mode (acknowledged or not)
}






PRIM 	DTI_GETDATA_REQ 	0x3700
{
 	tui 	 ; transmission unit identifier
 	c_id 	 ; channel identifier
 	op_ack 	 ; operation mode (acknowledged or not)
}






PRIM 	DTI_DATA_REQ 	0x3701
{
 	tui 	 ; transmission unit identifier
 	c_id 	 ; channel identifier
 	p_id 	 ; protocol identifier
 	op_ack 	 ; operation mode (acknowledged or not)
 	st_flow 	 ; flow control state
 	st_line_sa 	 ; line state sa
 	st_line_sb 	 ; line state sb
 	st_escape 	 ; escape state
 	desc_list 	 ; list of generic data descriptors
}






PRIM 	DTI_DATA_IND 	0x7701
{
 	tui 	 ; transmission unit identifier
 	c_id 	 ; channel identifier
 	p_id 	 ; protocol identifier
 	op_ack 	 ; operation mode (acknowledged or not)
 	st_flow 	 ; flow control state
 	st_line_sa 	 ; line state sa
 	st_line_sb 	 ; line state sb
 	st_escape 	 ; escape state
 	desc_list 	 ; list of generic data descriptors
}






PRIM 	DTI_DATA_TEST_REQ 	0x3702
{
 	tui 	 ; transmission unit identifier
 	c_id 	 ; channel identifier
 	p_id 	 ; protocol identifier
 	op_ack 	 ; operation mode (acknowledged or not)
 	st_flow 	 ; flow control state
 	st_line_sa 	 ; line state sa
 	st_line_sb 	 ; line state sb
 	st_escape 	 ; escape state
 	sdu 	 ; test data
}






PRIM 	DTI_DATA_TEST_IND 	0x7702
{
 	tui 	 ; transmission unit identifier
 	c_id 	 ; channel identifier
 	p_id 	 ; protocol identifier
 	op_ack 	 ; operation mode (acknowledged or not)
 	st_flow 	 ; flow control state
 	st_line_sa 	 ; line state sa
 	st_line_sb 	 ; line state sb
 	st_escape 	 ; escape state
 	sdu 	 ; test data
}






PRIM 	DTI_DUMMY_REQ 	0x3703
{
 	desc 	 ; generic data descriptor
}