keys_tapi.h

这是法国Kaleido公司提供了一个手机mmi设计平台

/*
 PASSWORD MANAGEMENT :  

 References: 

*/

// Property : TAPI_SIMCODE_TOUPDATE
// Type     : TAPI_STATYPE_STRING (querystring: SIM codes update)
// Synchro  : W
// Descr.   : a new code to set 
#define TAPI_SIMCODE_TOUPDATE 		"TAPI_SIMCODE_TOUPDATE"

// querystring's fields used in "SIM code update"
// upd S: queryString to get the pwd (e.g. "TAPI_PIN1_UPDATE").
#define SIMC_FIELD_UPDATE "upd"
// ste S: state to update (e.g. "TAPI_PIN1_STATE");
#define SIMC_FIELD_STATE "ste"



// Property : TAPI_PIN1_VALUE
// Type     : TAPI_STATYPE_STRING
// Synchro  : W
// Descr.   : Value of the last PIN1 code suggested by the user
#define TAPI_PIN1_VALUE 		"TAPI_PIN1_VALUE"
// Property : TAPI_PIN1_STATE
// Type     : TAPI_STATYPE_INT
// Accepted values:
//		0x00000000: unknown
//		0x00000001: PIN OK
//		0x0000001x: x failed attemps
//		0x00000020: SIM blocked
// Synchro  : W
// Descr.   : state of the PIN1.
#define TAPI_PIN1_STATE 			"TAPI_PIN1_STATE"
/* Possible states */
#define TAPI_PIN_STATE_UNKNOWN			0x00000000
#define TAPI_PIN_STATE_OK			0x00000001
/* FV : this one should be checked */
#define TAPI_PIN_STATE_PIN_REQUIRED		0x00000011
#define TAPI_PIN_STATE_PUK_REQUIRED		0x00000020
#define TAPI_PIN_STATE_PUK2_REQUIRED		0x00000030
#define TAPI_PIN_STATE_PIN2_REQUIRED		0x00000040
// Property : TAPI_PIN2_VALUE
// Type     : TAPI_STATYPE_STRING
// Synchro  : W
// Descr.   : Value of the last PIN2 code suggested by the user
#define TAPI_PIN2_VALUE 		"TAPI_PIN2_VALUE"
// Property : TAPI_PIN2_STATE
// Type     : TAPI_STATYPE_INT
// Accepted values:
//		0x00000000: unknown
//		0x00000001: PIN OK
//		0x0000001x: x failed attemps
//		0x00000020: SIM blocked
// Synchro  : W
// Descr.   : Value of the last PIN2 code suggested by the user
#define TAPI_PIN2_STATE 		"TAPI_PIN2_STATE"
// Property : TAPI_PUK1_VALUE
// Type     : TAPI_STATYPE_STRING
// Synchro  : W
// Descr.   : Value of the last PUK1 code suggested by the user
#define TAPI_PUK1_VALUE 		"TAPI_PUK1_VALUE"
// Property : TAPI_PUK2_VALUE
// Type     : TAPI_STATYPE_STRING
// Synchro  : W
// Descr.   : Value of the last PUK2 code suggested by the user
#define TAPI_PUK2_VALUE 		"TAPI_PUK2_VALUE"
// Property : TAPI_PHSIM_VALUE
// Type     : TAPI_STATYPE_STRING
// Synchro  : W
// Descr.   : Value of the last PHone-to-SIM card password suggested by the user
#define TAPI_PHSIM_VALUE 		"TAPI_PHSIM_VALUE"

// Property : TAPI_PIN1_UPDATE
// Type     : TAPI_STATYPE_STRING (querystring: Password update)
// Synchro  : W
// Descr.   : request to update (set/unset/modify) the PIN1 code
#define TAPI_PIN1_UPDATE 		"TAPI_PIN1_UPDATE"
// Property : TAPI_PIN2_UPDATE
// Type     : TAPI_STATYPE_STRING (querystring: Password update)
// Synchro  : W
// Descr.   : request to update (set/unset/modify) the PIN2 code
#define TAPI_PIN2_UPDATE 		"TAPI_PIN2_UPDATE"

// querystring's fields used in "Password update"
// pwd S: current password
#define PWD_FIELD_PWD "pwd"
// npwd S: new password. 
#define PWD_FIELD_NPWD "npwd"



/*
 NETWORK SETTING :  

 References: 

*/

// Property : TAPI_NETWORK_LEVEL
// Type     : TAPI_STATYPE_INT
// Accepted values:
//		0x00000000: unknown
//		0x000001xx: xx=% of network level
// Synchro  : R
// Descr.   : Current level of the attached network
#define TAPI_NETWORK_LEVEL 		"TAPI_NETWORK_LEVEL"

// Property : TAPI_NETWORK_NAME
// Type     : TAPI_STATYPE_STRING (querystring: network description)
// Synchro  : R
// Descr.   : name of the network that is currently used by the TSS
#define TAPI_NETWORK_NAME 	"TAPI_NETWORK_NAME"
// Property : TAPI_MANUAL_NETWORK
// Type     : TAPI_STATYPE_STRING (querystring: network description)
// Synchro  : W
// Descr.   : name of the network that is manually selected by the user
#define TAPI_MANUAL_NETWORK 	"TAPI_MANUAL_NETWORK"
// Property : TAPI_NETWORK_LIST
// Type     : TAPI_STATYPE_SMALLARRAYLIST (querystrings: network description)
// Synchro  : R
// Descr.   : name of the network that are currently available
#define TAPI_NETWORK_LIST 	"TAPI_NETWORK_LIST" 

// querystring's fields used in "network description"
// ident S: ident
#define OPER_FIELD_IDENT "ident"
// sname S: short name
#define OPER_FIELD_SNAME "sname"
// lname S: long name
#define OPER_FIELD_LNAME "lname"
// status I: status
//   Possible values are:
//		0=uknown
//		1=available
//		2=current
//		3=forbidden
#define OPER_FIELD_STATUS "status"



/*
 SHORT MESSAGE SERVICE :  

 References: 

*/

// Property : TAPI_SMS_MODE
// Type     : TAPI_STATYPE_INT
// Accepted values:
//		0: PDU mode
//		1:Text mode
// Synchro  : R/W
// Descr.   : mode used to send and receive SMS 
#define TAPI_SMS_MODE 	"TAPI_SMS_MODE"

// Property : TAPI_SMS_TOSEND
// Type     : TAPI_STATYPE_STRING (querystring: SMS description)
// Synchro  : W
// Descr.   : content of the SMS that must be sent 
#define TAPI_SMS_TOSEND 	"TAPI_SMS_TOSEND"
// Property : TAPI_SMS_TOREAD
// Type     : TAPI_STATYPE_SMALLARRAYLIST (querystrings: SMS description)
// Synchro  : R
// Descr.   : list of SMS that have been received but not yet read 
#define TAPI_SMS_TOREAD 	"TAPI_SMS_TOREAD"

// Property : TAPI_SMS_ALL
// Type     : TAPI_STATYPE_SMALLARRAYLIST (querystrings: SMS description)
// Synchro  : R
// Descr.   : list of SMS that have been received and sent.
#define TAPI_SMS_ALL 	"TAPI_SMS_ALL"

// Property : TAPI_SMS_SIZE
// Type     : TAPI_STATYPE_INT (querystrings: SMS description)
// Synchro  : R
// Descr.   : Number of SMS on SIM.
#define TAPI_SMS_SIZE	"TAPI_SMS_SIZE"
// Property : TAPI_PBK_PROGRESSION
// Type     : TAPI_STATYPE_INT (querystrings: SMS description)
// Synchro  : none. This key is automaticaly set into global store after a call of TAPI_SMS_ALL
// Descr.   : Indicate loading progression of SMS from SIM card in percent. Give -1 if not yet available.
#define TAPI_SMS_PROGRESSION	"TAPI_SMS_PROGRESSION"

// Property : TAPI_SMS_DELETE
// Type     : TAPI_STATYPE_INT (querystrings: SMS description)
// Synchro  : W
// Descr.   : Delete SMS with given index.
#define TAPI_SMS_DELETE	"TAPI_SMS_DELETE"

// querystring's fields used in "SMS description"
// index I: SMS' index.
#define SMS_FIELD_INDEX "index"
// status I: SMS' status
//   Possible values:
//		0: Received unread message (new) ["REC UNREAD"]
//		1: Received read message ["REC READ"]
//		2: stored unsent message ["STO UNSENT"]
//		3: stored sent message ["STO SENT"]
#define SMS_FIELD_STATUS "status"
//	tosca I: type of service center address
//   Possible values are:
//		129=national or unknown
//		145=international
//		161=national
#define SMS_FIELD_TOSCA "tosca"
//	scad   S: service center address
#define SMS_FIELD_SCAD	"scad"
//	tooa   I: type of originating address
#define SMS_FIELD_TOOA	"tooa"
//	oadd   S: originating address
#define SMS_FIELD_OADD	"oadd"
//	tora   I: type of recipient address
#define SMS_FIELD_TORA	"tora"
//	radd   S: recipient address
#define SMS_FIELD_RADD	"radd"
//	scts   S: service center time stamp ( "YY/MM/DD HH:MM:SS[-CC]" )
#define SMS_FIELD_SCTS	"scts"
//  msg    S: message 
#define SMS_FIELD_MSG	"msg"
//	alpha  S: <not used>
#define SMS_FIELD_ALPHA	"alpha"
//	fo     I: first octet
#define SMS_FIELD_FO	"fo"
//	pid    ?: protocol identifier
#define SMS_FIELD_PID	"pid"
//	dcs    I: data coding scheme
//   Possible values are: ???
//		0=GSM 7bit ???
//		4=GSM 8bit ???
//		8=UTF16 ???
#define SMS_FIELD_DCS	"dcs"
//	msg's len
#define SMS_FIELD_MSGLEN "msglen"
// SMS class :
// -1 : unknow class.
// 0 : SMS class 0
// 1 : SMS class 1
// 2 : SMS class 2
// 3 : SMS class 3
#define SMS_CLASS	"class"
// Property : TAPI_PBK_STORAGE
// Type     : TAPI_STATYPE_STRING
// Synchro  : R/W
// Descr.   : Select the current SIM phonebook.
#define TAPI_PBK_STORAGE 	"TAPI_PBK_STORAGE"

// Possible values for TAPI_PBK_STORAGE

#define TAPI_PBK_DC	"DC"
#define TAPI_PBK_EN	"EN"
#define TAPI_PBK_FD	"FD"
#define TAPI_PBK_LD	"LD"
#define TAPI_PBK_MC	"MC"
#define TAPI_PBK_ME	"ME"
#define TAPI_PBK_MT	"MT"
#define TAPI_PBK_ON	"ON"
#define TAPI_PBK_RC	"RC"
#define TAPI_PBK_SM	"SM"
#define TAPI_PBK_TA	"TA"

// Property : TAPI_PBK_CONTENT
// Type     : TAPI_STATYPE_SMALLARRAYLIST (querystrings: PhoneBook entry description)
// Synchro  : R/W
// Descr.   : content of the SIM PhoneBook
#define TAPI_PBK_CONTENT 	"TAPI_PBK_CONTENT"

// querystring's fields used in "PhoneBook entry description"
//	index I: entry's index in the SIM
#define PBK_FIELD_INDEX "index"
// synchro I: entry's synchro status
//   Possible values:
//		1: obtained from the SIM
//		2: modified and not yet synchronized with the SIM
//		3: added and not yet synchronized with the SIM
//		4: deleted and not yet synchronized with the SIM
//		5: modified but synchronized with the SIM
#define PBK_FIELD_STATUS "status"
//	toadd I: type of address
//   Possible values are:
//		129=national or unknown
//		145=international
//		161=national
#define PBK_FIELD_TOADD "toadd"
//	name   S: entry's name
#define PBK_FIELD_NAME	"name"
//	addr   S: address / number
#define PBK_FIELD_ADDR	"addr"

// Property : TAPI_PBK_PROGRESSION
// Type     : TAPI_STATYPE_INT 
// Synchro  : none. This key is automaticaly set into global store after a call of TAPI_PBK_CONTENT
// Descr.   : Indicate loading progression of SIM card in percent. Give -1 if not yet available.
#define TAPI_PBK_PROGRESSION		"TAPI_PBK_PROGRESSION"

// Property : TAPI_PBK_SIM_MAX_RECORD
// Type     : TAPI_STATYPE_INT 
// Synchro  : none. This key is automaticaly set into global store after a call of TAPI_PBK_CONTENT
// Descr.   : Indicate the number of maximum records
#define TAPI_PBK_SIM_MAX_RECORD		"TAPI_PBK_SIM_MAX_RECORD"


// Property : TAPI_CALL_WAITING
// Type     : TAPI_STATYPE_INT 
// Synchro  : R/W
// Descr.   : Contain the status of call waiting.
// 0 : Disable
// 1 : Enable
#define TAPI_CALL_WAITING 	"TAPI_CALL_WAITING"

// Property : TAPI_CONNECTED_LINE_INDENTIFICATION_PRESENTATION
// Type     : TAPI_STATYPE_INT 
// Synchro  : R/W
// Descr.   : Contain the status of COLP.
// 0 : Disable
// 1 : Enable
#define TAPI_CONNECTED_LINE_INDENTIFICATION_PRESENTATION 	"TAPI_CONNECTED_LINE_INDENTIFICATION_PRESENTATION"

// Property : TAPI_CONNECTED_LINE_INDENTIFICATION_RESTRICTION
// Type     : TAPI_STATYPE_INT 
// Synchro  : R/W
// Descr.   : Contain the status of COLR.
// 0 : Disable
// 1 : Enable
#define TAPI_CONNECTED_LINE_INDENTIFICATION_RESTRICTION 	"TAPI_CONNECTED_LINE_INDENTIFICATION_RESTRICTION"

/*
 CALL DIVERTING : on some networks, this feature gives the subscriber the ability to forward incoming calls to another number 
 if the called mobile unit is not reachable, if it is busy, if there is no reply, or if call forwarding is allowed unconditionally. 

 References: 3GPP TS  23.082 & 3GPP TS  24.082 

*/

// Property : TAPI_SS_DIVERT_UNCONDITIONAL
// Type     : TAPI_STATYPE_STRING (querystring: Divert condition description)
// Synchro  : R/W
// Descr.   : call diverting applicable unconditionally
#define TAPI_SS_DIVERT_UNCONDITIONAL "TAPI_SS_DIVERT_UNCONDITIONAL"
// Property : TAPI_SS_DIVERT_BUSY
// Type     : TAPI_STATYPE_STRING (querystring: Divert condition description)
// Synchro  : R/W
// Descr.   : call diverting applicable when the local equipment is busy
#define TAPI_SS_DIVERT_BUSY "TAPI_SS_DIVERT_BUSY" 
// Property : TAPI_SS_DIVERT_NO_ANSWER
// Type     : TAPI_STATYPE_STRING (querystring: Divert condition description)
// Synchro  : R/W
// Descr.   : call diverting applicable when the local equipment does not answer
#define TAPI_SS_DIVERT_NO_ANSWER "TAPI_SS_DIVERT_NO_ANSWER"