view cdg-hybrid/sap/mmi.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           : mmi.pdf
;*** Creation       : Wed Mar 11 09:58:20 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  : mmi
;*** Document No.   : 6147.113.97.103
;*** Document Date  : 2004-08-20
;*** Document Status: BEING_PROCESSED
;*** Document Author: FMA
;********************************************************************************



PRAGMA 	SRC_FILE_TIME 	"Thu Nov 29 09:46:32 2007"
PRAGMA 	LAST_MODIFIED 	"2004-08-20"
PRAGMA 	ID_AND_VERSION 	"6147.113.97.103"



CONST 	CBCH_MSG_LEN 	88 	; length of a CBCH message
CONST 	MAX_SDU_LEN 	1 	; length of service data unit for the display request
CONST 	MAX_IDENTS 	20 	; maximum identifiers
CONST 	MAX_IDENTS_SAT 	15 	; maximum identifiers for SIM Application Toolkit
CONST 	MAX_RPD_MSG_LEN 	120 	; maximum size of message to ESIM RPD



VALTAB 	VAL_control
VAL 	0 	CTL_NORMAL 	"normal operation"
VAL 	1 	CTL_HIDDEN 	"hidden attribut (used for cursor control)"

VALTAB 	VAL_content
VAL 	1 	CON_TEXT 	"sdu contains text"
VAL 	2 	CON_CURSOR 	"positioning the cursor"

VALTAB 	VAL_call_tone
VAL 	1 - 15 	"custom specific ringing tones"
VAL 	0 	CT_RING 	"ringing tone"
VAL 	16 	CT_AUTH_NUM_UNOBTAIN 	"authentication or number unobtainable"
VAL 	17 	CT_BUSY 	"busy tone"
VAL 	18 	CT_CONGESTION 	"congestion tone"
VAL 	19 	CT_CALL_DROPPED 	"call dropped"
VAL 	20 	CT_RADIO_ACK 	"radio acknowledge"
VAL 	21 	CT_CALL_WAIT 	"call waiting"
VAL 	22 	DTMF_0 	"digit 0"
VAL 	23 	DTMF_1 	"digit 1"
VAL 	24 	DTMF_2 	"digit 2"
VAL 	25 	DTMF_3 	"digit 3"
VAL 	26 	DTMF_4 	"digit 4"
VAL 	27 	DTMF_5 	"digit 5"
VAL 	28 	DTMF_6 	"digit 6"
VAL 	29 	DTMF_7 	"digit 7"
VAL 	30 	DTMF_8 	"digit 8"
VAL 	31 	DTMF_9 	"digit 9"
VAL 	32 	DTMF_A 	"character A"
VAL 	33 	DTMF_B 	"character B"
VAL 	34 	DTMF_C 	"character C"
VAL 	35 	DTMF_D 	"character D"
VAL 	36 	DTMF_STAR 	"character *"
VAL 	37 	DTMF_HASH 	"character #"
VAL 	38 	CT_KEYBEEP 	"Keybeep"
VAL 	39 	CT_RINGING 	"ringing tone"

VALTAB 	VAL_key_stat
VAL 	0 	KEY_STAT_PRS 	"pressed"
VAL 	1 	KEY_STAT_REL 	"released"

VALTAB 	VAL_mute_stat
VAL 	0 	MUTE_STAT_OFF 	"audio path is not muted"
VAL 	1 	MUTE_STAT_ON 	"audio path is muted"

VALTAB 	VAL_speech_stat
VAL 	0 	SPEECH_STAT_OFF 	"audio path switched off"
VAL 	1 	SPEECH_STAT_ON 	"audio path switched on"

VALTAB 	VAL_tone_stat
VAL 	0 	TONE_SWT_OFF 	"switch off"
VAL 	1 	TONE_SWT_ON_SINGLE 	"switch on one time"
VAL 	2 	TONE_SWT_ON_PERIODIC 	"switch on periodically"
VAL 	3 	TONE_SWT_ON_SILENT 	"switch on silent"

VALTAB 	VAL_mode
VAL 	0 	INDICATION_SINGLE 	"one single request"
VAL 	1 	INDICATION_ON_CHANGE 	"new indication after intervall change"
VAL 	2 	INDICATION_PERIODIC 	"new indication after time period"
VAL 	3 	INDICATION_OFF 	"no further indications"

VALTAB 	VAL_modus
VAL 	0 	CBCH_ACCEPT 	"accept msg_id and dcs_id"
VAL 	1 	CBCH_IGNORE 	"ignore msg_id and dcs_id"
VAL 	2 	CBCH_HOMEZONE 	"Request homezone message after cell reseletion"
VAL 	255 	MMI_CBCH_STOP 	"stop cbch reading"

VALTAB 	VAL_ids_mode
VAL 	0 	IDS_SPEECH 	"Speech mode"
VAL 	1 	IDS_T_DATA 	"Transparent Data"
VAL 	2 	IDS_T_FAX 	"Transparent Fax"
VAL 	5 	IDS_NT_DATA 	"Non-Transparent Data"
VAL 	6 	IDS_NT_FAX 	"Non-Transparent Fax"

VALTAB 	VAL_vocoder_state
VAL 	0 	VOCODER_DISABLE 	"Enable the vocoder"
VAL 	1 	VOCODER_ENABLE 	"Disable the vocoder"




VAR 	content 	"content type" 	S

VAL 	@p_mmi - VAL_content@ 	

VAR 	control 	"control" 	S

VAL 	@p_mmi - VAL_control@ 	

VAR 	bl_level 	"Backlight Level in percent" 	B


VAR 	call_tone 	"Call tone" 	B

VAL 	@p_mmi - VAL_call_tone@ 	

VAR 	cbch_msg 	"CBCH message" 	B


VAR 	msg_id 	"CBCH message identifier" 	S


VAR 	rxlev 	"Fieldstrength of the serving cell" 	B


VAR 	key_code 	"Keypad Code" 	B


VAR 	key_stat 	"Key Status" 	B

VAL 	@p_mmi - VAL_key_stat@ 	

VAR 	mute_stat 	"Mute Status" 	B

VAL 	@p_mmi - VAL_mute_stat@ 	

VAR 	l_buf 	"length of content in bit" 	S


VAR 	o_buf 	"offset of content in bit" 	S


VAR 	buf 	"buffer content" 	B


VAR 	speech_stat 	"Speech Status" 	B

VAL 	@p_mmi - VAL_speech_stat@ 	

VAR 	temp 	"Battery Temperature" 	B


VAR 	tone_stat 	"Tone Status" 	B

VAL 	@p_mmi - VAL_tone_stat@ 	

VAR 	volt 	"Battery Voltage" 	B


VAR 	volume 	"volume in percent" 	B


VAR 	no_intervalls 	"number of intervalls" 	B


VAR 	mode 	"operaton mode" 	B

VAL 	@p_mmi - VAL_mode@ 	

VAR 	period 	"time period" 	S


VAR 	c_x 	"coordinate X" 	S


VAR 	c_y 	"coordinate Y" 	S


VAR 	dcs_id 	"CBCH data coding schemes" 	B


VAR 	modus 	"CBCH use" 	B

VAL 	@p_mmi - VAL_modus@ 	

VAR 	ids_mode 	"IDS mode" 	B

VAL 	@p_mmi - VAL_ids_mode@ 	

VAR 	cbch_len 	"CBCH length" 	B


VAR 	count 	"no. of msg id's" 	S


VAR 	rpd_msg_id 	"Basic Element" 	S


VAR 	rpd_msg 	"Basic Element" 	B


VAR 	gil_cb 	"Function callback" 	L


VAR 	gil_data 	"Message data" 	L


VAR 	vocoder_state 	"Vocoder state" 	B

VAL 	@p_mmi - VAL_vocoder_state@ 	

VAR 	headset_status 	"Headset status" 	B


VAR 	carkit_status 	"status" 	B





COMP 	attrib 	 "Attribute"
{
 	content 	 ; content type
 	control 	 ; control
}



COMP 	sdu 	 "Service Data Unit"
{
 	l_buf 	 ; length of content in bit
 	o_buf 	 ; offset of content in bit
 	buf 	[MAX_SDU_LEN] 	 ; buffer content
}






; MMI_KEYPAD_IND 	0x4E00
; MMI_AUDIO_INPUT_REQ 	0x0E00
; MMI_AUDIO_OUTPUT_REQ 	0x0E01
; MMI_SPEECH_MODE_REQ 	0x0E02
; MMI_AUDIO_MUTE_REQ 	0x0E03
; MMI_AUDIO_TONE_REQ 	0x0E05
; MMI_BACKLIGHT_REQ 	0x0E06
; MMI_CBCH_REQ 	0x0E07
; MMI_CBCH_IND 	0x4E01
; MMI_RXLEV_REQ 	0x0E08
; MMI_RXLEV_IND 	0x4E02
; MMI_BATTERY_REQ 	0x0E09
; MMI_BATTERY_IND 	0x4E03
; MMI_DISPLAY_REQ 	0x0E0A
; MMI_SAT_CBCH_DWNLD_REQ 	0x0E0B
; MMI_SAT_CBCH_DWNLD_IND 	0x4E04
; MMI_BT_CB_NOTIFY_IND 	0x4E05
; MMI_RPD_MSG 	0x4E06
; MMI_GIL_IND 	0x4E07
; MMI_TCH_VOCODER_CFG_REQ 	0x0E0C
; MMI_TCH_VOCODER_CFG_CON 	0x4E08
; MMI_HEADSET_IND 	0x4E0C
; MMI_CARKIT_IND 	0x4E0D



PRIM 	MMI_KEYPAD_IND 	0x4E00
{
 	key_code 	 ; key code
 	key_stat 	 ; key status
}






PRIM 	MMI_AUDIO_INPUT_REQ 	0x0E00
{
 	volume 	 ; input volume
}






PRIM 	MMI_AUDIO_OUTPUT_REQ 	0x0E01
{
 	volume 	 ; output volume
}






PRIM 	MMI_SPEECH_MODE_REQ 	0x0E02
{
 	speech_stat 	 ; speech status
 	ids_mode 	 ; Ids mode
}






PRIM 	MMI_AUDIO_MUTE_REQ 	0x0E03
{
 	mute_stat 	 ; mute status
}






PRIM 	MMI_AUDIO_TONE_REQ 	0x0E05
{
 	tone_stat 	 ; tone status
 	volume 	 ; volume
 	call_tone 	 ; call tone
}






PRIM 	MMI_BACKLIGHT_REQ 	0x0E06
{
 	bl_level 	 ; backlight level
}






PRIM 	MMI_CBCH_REQ 	0x0E07
{
 	msg_id 	[MAX_IDENTS] 	 ; Message Identifier
 	dcs_id 	[MAX_IDENTS] 	 ; Data Coding Scheme
 	modus 	 ; mode
}






PRIM 	MMI_CBCH_IND 	0x4E01
{
 	cbch_msg 	[CBCH_MSG_LEN] 	 ; CBCH message
 	cbch_len 	 ; CBCH length
}






PRIM 	MMI_RXLEV_REQ 	0x0E08
{
 	mode 	 ; request mode
 	no_intervalls 	 ; no of intervalls
 	period 	 ; period
}






PRIM 	MMI_RXLEV_IND 	0x4E02
{
 	rxlev 	 ; fieldstrength
}






PRIM 	MMI_BATTERY_REQ 	0x0E09
{
 	mode 	 ; request mode
 	no_intervalls 	 ; no of intervalls
 	period 	 ; period
}






PRIM 	MMI_BATTERY_IND 	0x4E03
{
 	temp 	 ; temperature
 	volt 	 ; voltage
}






PRIM 	MMI_DISPLAY_REQ 	0x0E0A
{
 	attrib 	 ; attribute
 	c_y 	 ; y-coordinate
 	c_x 	 ; x-coordinate
 	sdu 	 ; service data unit
}






PRIM 	MMI_SAT_CBCH_DWNLD_REQ 	0x0E0B
{
 	count 	 ; Size
 	msg_id 	[MAX_IDENTS_SAT] 	 ; Message Identifier
}






PRIM 	MMI_SAT_CBCH_DWNLD_IND 	0x4E04
{
 	cbch_msg 	[CBCH_MSG_LEN] 	 ; CBCH message
 	cbch_len 	 ; CBCH length
}






PRIM 	MMI_BT_CB_NOTIFY_IND 	0x4E05
{
}






PRIM 	MMI_RPD_MSG 	0x4E06
{
 	rpd_msg_id 	 ; Primitive Item
 	rpd_msg 	[MAX_RPD_MSG_LEN] 	 ; Primitive Item
}






PRIM 	MMI_GIL_IND 	0x4E07
{
 	gil_cb 	 ; GIL callback function
 	gil_data 	 ; GIL data argument of the callback function
}






PRIM 	MMI_TCH_VOCODER_CFG_REQ 	0x0E0C
{
 	vocoder_state 	 ; Primitive Item
}






PRIM 	MMI_TCH_VOCODER_CFG_CON 	0x4E08
{
}






PRIM 	MMI_HEADSET_IND 	0x4E0C
{
 	headset_status 	 ; Primitive Item
}






PRIM 	MMI_CARKIT_IND 	0x4E0D
{
 	carkit_status 	 ; Primitive Item
}