keys_tapi.h

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

// Property : TAPI_SS_DIVERT_UNREACHABLE
// Type     : TAPI_STATYPE_STRING (querystring: Divert condition description)
// Synchro  : R/W
// Descr.   : call diverting applicable when the local equipment cannot be reached by the network
#define TAPI_SS_DIVERT_UNREACHABLE "TAPI_SS_DIVERT_UNREACHABLE"
// Property : TAPI_SS_DIVERT_ALL_CALLS
// Type     : Action only. The value stored is meaningless.
// Synchro  : W
// Descr.   : this state can we written to cancel call diverting for any kind of call
#define TAPI_SS_DIVERT_ALL_CALLS "TAPI_SS_DIVERT_ALL_CALLS"
// Property : TAPI_SS_DIVERT_ALL_CONDITIONAL
// Type     : Action only. The value stored is meaningless.
// Synchro  : W
// Descr.   : this state can we written to cancel call diverting for all the conditions
#define TAPI_SS_DIVERT_ALL_CONDITIONAL "TAPI_SS_DIVERT_ALL_CONDITIONAL"

// querystring's fields used in "Divert condition description"
// act I: state 
//   Possible values are:
//		0: disabled
//		1: enabled
//		2: unknown
#define FWD_FIELD_STATE "state" /* obsolete */
#define DIV_FIELD_STATE "state"
// delay I: time (in seconds)
#define FWD_FIELD_TIME "time" /* obsolete */
#define DIV_FIELD_TIME "time"
// toadd I: type of addressphone number
#define FWD_FIELD_TOADD "toadd" /* obsolete */
#define DIV_FIELD_TOADD "toadd"
// add S: address
#define FWD_FIELD_ADD "add" /* obsolete */
#define DIV_FIELD_ADD "add"
// Class of call (Voice, Data ...) provide by USSD SiB (cf GSM 02.30)
#define DIV_FIELD_CLASS "class"


/*
 CALL BARRING : on some networks, this feature allows to restrict or bar certain or all types 
 of calls to and from a phone. Concerned calls may be outgoing calls, outgoing international calls, 
 incoming calls,... Barring is activated with a personal code.

 References: 3GPP TS  23.088 & 3GPP TS  24.088 

*/

// Property : TAPI_SS_BARRING_OUT
// Type     : TAPI_STATYPE_STRING (querystring: Barring condition description)
// Synchro  : R/W
// Descr.   : call barring applicable to all outgoing calls
#define TAPI_SS_BARRING_OUT "TAPI_SS_BARRING_OUT"
// Property : TAPI_SS_BARRING_OUT_TO_INTL
// Type     : TAPI_STATYPE_STRING (querystring: Barring condition description)
// Synchro  : R/W
// Descr.   : call barring applicable to outgoing calls to international numbers
#define TAPI_SS_BARRING_OUT_TO_INTL "TAPI_SS_BARRING_OUT_TO_INTL"
// Property : TAPI_SS_BARRING_OUT_TO_INTL_BUT_HOME
// Type     : TAPI_STATYPE_STRING (querystring: Barring condition description)
// Synchro  : R/W
// Descr.   : call barring applicable to outgoing calls to international numbers, excepted numbers situated in 
//            the country of origin of the subscription.
#define TAPI_SS_BARRING_OUT_TO_INTL_BUT_HOME "TAPI_SS_BARRING_OUT_TO_INTL_BUT_HOME"
// Property : TAPI_SS_BARRING_INC
// Type     : TAPI_STATYPE_STRING (querystring: Barring condition description)
// Synchro  : R/W
// Descr.   : call barring applicable to all incoming calls
#define TAPI_SS_BARRING_INC "TAPI_SS_BARRING_INC"
// Property : TAPI_SS_BARRING_INC_ROAMED
// Type     : TAPI_STATYPE_STRING (querystring: Barring condition description)
// Synchro  : R/W
// Descr.   : call barring applicable to all incoming calls when the mobile is in roaming conditions
#define TAPI_SS_BARRING_INC_ROAMED "TAPI_SS_BARRING_INC_ROAMED"
// Property : TAPI_SS_BARRING_CANCEL_ALL
// Type     : Action only. The value stored is meaningless.
// Synchro  : W
// Descr.   : this state can we written to cancel all the active call barring requests
#define TAPI_SS_BARRING_CANCEL_ALL "TAPI_SS_BARRING_CANCEL_ALL"
// Property : TAPI_SS_BARRING_CANCEL_ALL_OUT
// Type     : Action only. The value stored is meaningless.
// Synchro  : W
// Descr.   : this state can we written to cancel all the active call barring requests regarding outgoing calls.
#define TAPI_SS_BARRING_CANCEL_ALL_OUT "TAPI_SS_BARRING_CANCEL_ALL_OUT"
// Property : TAPI_SS_BARRING_CANCEL_ALL_OUT
// Type     : Action only. The value stored is meaningless.
// Synchro  : W
// Descr.   : this state can we written to cancel all the active call barring requests regarding incoming calls.
#define TAPI_SS_BARRING_CANCEL_ALL_INC "TAPI_SS_BARRING_CANCEL_ALL_INC"

// querystring's fields used in "Barring condition description"
// state I: state 
//   Possible values are:
//		0: disabled
//		1: enabled (=locked)
//		2: unknown / Query in Read Mode.
#define BAR_FIELD_STATE "state"
// pwd S: current password
#define BAR_FIELD_PWD "pwd"
// npwd S: new password. Used when there is a request to change the current password.for the concerned action.
#define BAR_FIELD_NPWD "npwd"
// Class of call (Voice, Data ...) provide by USSD SiB (cf GSM 02.30)
#define BAR_FIELD_CLASS "class"

// Property : TAPI_SS_UNSTRUCTURED_SUPP_SERVICE
// Type     : TAPI_STATYPE_STRING (USSD request in writting mode, anwser in reading mode)
// Synchro  : R/W
// Descr.   : Allows to send and USSD request directly to modem.
#define TAPI_SS_UNSTRUCTURED_SUPP_SERVICE "TAPI_SS_UNSTRUCTURED_SUPP_SERVICE"

// ****************************************************
// Property : TAPI_SS_UNSTRUCTURED_SUPP_SERVICE_MESSAGE_ACTION
// Type     : TAPI_STATYPE_INT
// Synchro  : R/W
// Descr.   : Allows to set the KREB message action subtype to indicate MMI, when 
// an unsolicited USSD message is received.
#define TAPI_SS_UNSTRUCTURED_SUPP_SERVICE_MESSAGE_ACTION     "TAPI_SS_UNSTRUCTURED_SUPP_SERVICE_MESSAGE_ACTION"
// ****************************************************


// Property : TAPI_AUTO_ANSWER
// Type     : TAPI_STATYPE_INT
// Synchro  : R/W
// Descr.   : Allows to define auto answer delay in secondes.
#define TAPI_AUTO_ANSWER	"TAPI_AUTO_ANSWER"


/*
 SIM APPLICATION TOOLKIT ( SAT or STK) : is a set of commands which defines how the SIM card should interact with the outside 
 world and extends the communication protocol between the card and the handset. With SIM Application Toolkit, the card has a 
 proactive role in the handset (this means that the SIM initiates commands independently of the handset and the network).

 References: 
   - 2G networks: GSM 11.14 standard. 
   - 3G networks: GSM 11.14 is replaced by 3GPP 31.111 which also includes specifications of  USIM Application Toolkit (USAT). 
*/


// Property : TAPI_STK_FROMSIM
// Type     : TAPI_STATYPE_SMALLARRAYLIST (querystrings: STK query/response)
// Synchro  : R
// Descr.   : This (read only) property contains the last STK request received from the SIM, or the one that is currently being received.
//            It contains a SmallArrayList containing one querystring / option. The first element of this SmallArrayList contains the header
//            of the request.
#define TAPI_STK_FROMSIM 	"TAPI_STK_FROMSIM"
// Property : TAPI_STK_SETUP
// Type     : TAPI_STATYPE_SMALLARRAYLIST (querystrings: STK query/response)
// Synchro  : R
// Descr.   : This (read only) property is very similar to TAPI_STK_FROMSIM but it is the "bootstrap" of the application and it needs to 
//            be permanently stored and kept.
#define TAPI_STK_SETUP 	"TAPI_STK_SETUP"
// Property : TAPI_STK_SETUP
// Type     : TAPI_STATYPE_STRING (querystring: STK query/response)
// Synchro  : W
// Descr.   : This (write only) property contains the current STK answer to send to the SIM. It is NULLized once it is sent.
#define TAPI_STK_TOSIM 	"TAPI_STK_TOSIM"

// Property : TAPI_STK_STATUS
// Type     : TAPI_STATYPE_INT (querystring: STK query/response)
// Synchro  : R
// Descr.   : Contain STK status.
#define TAPI_STK_STATUS 	"TAPI_STK_STATUS"

// querystring's fields used in "STK query/response"
// typ I: STK request's type
//   Possible values are STK_TYP_***
#define STK_FIELD_TYPE	"typ"
// stat I: STK answer's status
//   Possible values are STK_STAT_***
#define STK_FIELD_STATUS "stat"
// tit S: STK request's title & answer's content
#define STK_FIELD_TITLE "tit"
// tout I: STK request's time-out (in seconds)
#define STK_FIELD_TIMEOUT "tout"
//** Additional records' fields **
// oidx I: STK option's index
#define STK_FIELD_OPT_IDX "oidx"
// otyp I: STK option's content type
//   Possible values are STK_ITEM_TYPE_***
#define STK_FIELD_OPT_TYP "otyp"
// oval S: STK option's content
#define STK_FIELD_OPT_VAL "oval"
// imsk I: STK request's input mask
//   Possible values are STK_INTYPE_***
#define STK_FIELD_INPU_MASK "imsk"
// ival S: STK request's basic input value
#define STK_FIELD_INPU_VAL "ival"
// imin I: STK request's min input value
#define STK_FIELD_INPU_MIN "imin"
// imax I: STK request's max input value
#define STK_FIELD_INPU_MAX "imax"

// Property : TAPI_EMERGENCY_NUMBER
// Type     : TAPI_STATYPE_STRING 
// Synchro  : R
// Descr.   : This (read only) property contains the emergency number.
#define TAPI_EMERGENCY_NUMBER			"TAPI_EMERGENCY_NUMBER"

// Property : TAPI_FIXED_DIALING_NUMBER
// Type     : TAPI_STATYPE_STRING (queryString)
// Synchro  : R/W
// Descr.   : This property allow to manage fixed dialing number operation. When writing this property
// you need to pass a queryString that contain new state with code pin2.
// 0 = Unlock, 1 = Lock, 2 = Query Status, 10 = Full Lock.
#define TAPI_FIXED_DIALING_NUMBER		"TAPI_FIXED_DIALING_NUMBER"
#define TAPI_FDN_FIELD_PWD			"TAPI_FDN_FIELD_PWD"
#define TAPI_FDN_FIELD_STATUS			"TAPI_FDN_FIELD_STATUS"

/*
 * List of all the NOT SYNCHRONIZABLE states that may only be stored in the global store,
 * but not synchronized with the TSS.
 */
//		"SIP_TAPI"
//		"GSM_TAPI"
#define TAPI_TYPE	"TAPI_TYPE" // TAPI_STATYPE_STRING

// SIP Specific definitions properties.
#define TAPI_SIP_PH_SERVER_IP	"TAPI_SIP_PH_SERVER_IP" // TAPI_STATYPE_STRING
#define TAPI_SIP_PORT			"TAPI_SIP_PORT"			// TAPI_STATYPE_STRING
#define TAPI_SIP_RTP_PROXY		"TAPI_SIP_PORT"			// TAPI_STATYPE_STRING
#define TAPI_SIP_USERAME		"TAPI_SIP_USERAME"		// TAPI_STATYPE_STRING
#define TAPI_SIP_USERID			"TAPI_SIP_USERID"		// TAPI_STATYPE_STRING
#define TAPI_SIP_REALM			"TAPI_SIP_REALM"		// TAPI_STATYPE_STRING
#define TAPI_SIP_PASSWORD		"TAPI_SIP_PASSWORD"		// TAPI_STATYPE_STRING
#define TAPI_SIP_HOST			"TAPI_SIP_HOST"			// TAPI_STATYPE_STRING
#define TAPI_SIP_PROXY			"TAPI_SIP_PROXY"		// TAPI_STATYPE_STRING
#define TAPI_SIP_TIME_OUT		"TAPI_SIP_TIME_OUT"		// TAPI_STATYPE_STRING
#define TAPI_SIP_PH_SERVER_IP	"TAPI_SIP_PH_SERVER_IP" /*TAPI_STATYPE_STRING [R/W]*/
#define TAPI_SIP_PORT			"TAPI_SIP_PORT"			/*TAPI_STATYPE_STRING [R/W]*/
#define TAPI_SIP_RTP_PROXY		"TAPI_SIP_PORT"			/*TAPI_STATYPE_STRING [R/W]*/
#define TAPI_SIP_USERAME		"TAPI_SIP_USERAME"		/*TAPI_STATYPE_STRING [R/W]*/
#define TAPI_SIP_USERID			"TAPI_SIP_USERID"		/*TAPI_STATYPE_STRING [R/W]*/
#define TAPI_SIP_REALM			"TAPI_SIP_REALM"		/*TAPI_STATYPE_STRING [R/W]*/
#define TAPI_SIP_PASSWORD		"TAPI_SIP_PASSWORD"		/*TAPI_STATYPE_STRING [R/W]*/
#define TAPI_SIP_HOST			"TAPI_SIP_HOST"			/*TAPI_STATYPE_STRING [R/W]*/
#define TAPI_SIP_PROXY			"TAPI_SIP_PROXY"		/*TAPI_STATYPE_STRING [R/W]*/
#define TAPI_SIP_TIME_OUT		"TAPI_SIP_TIME_OUT"		/*TAPI_STATYPE_STRING [R/W]*/



/**********************************************************************************************/
//****  INTERFACE DECLARATION AND CONSTANTS FOR STK API ****//
#define STK_TYP_SETUP_MENU   0 /* This is the default state when there is no current session */
#define STK_TYP_SELECT_ITEM  1
#define STK_TYP_DISPLAY_TEXT 2
#define STK_TYP_GET_INPUT    3
#define STK_TYP_GET_INKEY    4
#define STK_TYP_SEND_CALL    5
#define STK_TYP_SEND_SMS     6 
#define STK_TYP_SEND_SS      7
#define STK_TYP_SEND_USSD    8
#define STK_TYP_UNDEFINED    -1 /* Undefined. Certainly being updated */

#define STK_ITEM_TYPE_UNKOWN '0' /* unknwon (=unusable!) */
#define STK_ITEM_TYPE_TXT    '1' /* simple text */
#define STK_ITEM_TYPE_INPUT  '2' /* input box */
#define STK_ITEM_TYPE_IMG    '3' /* pictogram */
#define STK_ITEM_TYPE_HIP    '4' /* high priority text */

#define STK_INTYPE_NUM    'N'
#define STK_INTYPE_CHAR   'M'
#define STK_INTYPE_HINUM  'n' /* Hidden */
#define STK_INTYPE_HICHAR 'm' /* Hidden */
#define STK_INTYPE_YESNO  'Y'
#define STK_INTYPE_ACK    'A'


// Comments show the values purposed by the GSM 11.14 standard */
#define STK_STAT_SUCCESS    00 /* "00" */
#define STK_STAT_ABORT      10 /* "10" User termination */
#define STK_STAT_BACK       11 /* "11" Backward move */
#define STK_STAT_TIMEOUT    12 /* "12" No response */
#define STK_STAT_SCREENBUSY 99 /* "" */



//****  END INTERFACE DECLARATION AND CONSTANTS FOR STK API ****//


// Property : TAPI_CURRENT_TIME 
// Type     :  TAPI_STATYPE_STRING (querystring: time description)
// Synchro  : R/W
// Descr.   :  current time/date
#define TAPI_CURRENT_TIME 		"TAPI_CURRENT_TIME"

// Property : TAPI_SET_TIME 
// Type     :  TAPI_STATYPE_STRING (querystring: time description)
// Synchro  : R/W
// Descr.   :  set a new time/date
#define TAPI_SET_TIME 		"TAPI_SET_TIME"


// querystring's fields used in "time description"

// min I: minutes [0-59]
#define TIME_FIELD_MIN "min"  
// hour I: Hours.	[0-23]
#define TIME_FIELD_HOUR "hour"
// day I : Day.		[1-31]
#define TIME_FIELD_DAY "day"
// mon I:  Month.	[1-12] 
#define TIME_FIELD_MON "mon"
// year I: Year
#define TIME_FIELD_YEAR "year"
//wday I: Day of week.	[0-6]  0 is Sunday 1 Monday ...
#define TIME_FIELD_WDAY "wday"
// yday I: Days in year.[0-365]
#define TIME_FIELD_YDAY "yday" 



/* GSM STRINGS : used to debug */
// Property : TAPI_GSMSTRING
// Type     :  TAPI_STATYPE_STRING (querystring: GSM string description)
// Synchro  : R/W
// Descr.   :  set GSM string to send
#define TAPI_GSMSTRING "TAPI_GSMSTRING"

// querystring's fields used in "GSM string description"

//request S: the gsm string request
#define GSMSTRING_FIELD_REQUEST "request"
//title S: the title of the answer
#define GSMSTRING_FIELD_TITLE "title"
//title S: an undefined 1st answer argument
#define GSMSTRING_FIELD_ARG1 "arg1"
//title S: an undefined 2nd answer argument
#define GSMSTRING_FIELD_ARG2 "arg2"
//title S: an undefined 3th answer argument
#define GSMSTRING_FIELD_ARG3 "arg3"
//title S: an undefined 4th answer argument
#define GSMSTRING_FIELD_ARG4 "arg4"
//title S: an undefined 5th answer argument
#define GSMSTRING_FIELD_ARG5 "arg5"
//title S: an undefined 6th answer argument
#define GSMSTRING_FIELD_ARG6 "arg6"


/*  MULTIMEDIA : used to describe a multimedia content */
// Property : TAPI_MULTIMEDIA
// Type     :  TAPI_STATYPE_STRING (querystring: multimedia description)
// Synchro  : R/W
// Descr.   :  describe a multimedia content
#define TAPI_MULTIMEDIA "TAPI_MULTIMEDIA"

// querystring's fields used in "GSM string description"

// src S : path of the file to read
#define MULTIMEDIA_FIELD_SRC "src"
// bfr S : name of the globalStore key that could be used to store the pointer on the video buffer
#define TAPI_MULTIMEDIA_FIELD_BUFFER "bfr"


#endif // ndef KEYS_TAPI_H