CHAPTER 6. PHONE INTERFACE

6.3 TAPI

C. APIs

The library, which is for the applications that want to communicate with phone, is called Telephony Application Interface (TAPI) and it can be divided into groups.

a. Environment

It is basic functions not to offer direct communication with phone, but to offer communication between phone server and application. Through this, abstract interface can be supplied to the applications that want to communicate with phone.

LXT_HANDLE* lxt_initialize(LXT_ID_CLIENT clientclass, LXT_CALLBACK cb);

Description

To communicate with phone server, application has to be assigned special data structure called handle.
The application can communicate with phone server via the handle.

Parameter

LXT_ID_CLIENT clientclass: ID of selected application
LXT_CALLBACK cb: Call back function that will receive the response of phone server

Return

LXT_HANDLE: Handle of phone server

int lxt_getDescriptor(LXT_HANDLE* handle);

Description

If application gets handle, socket descriptor is created internally to communicate with phone server. The function is to get the descriptor.
The application does socket communication via this descriptor.

Parameter

LXT_HANDLE* handle: TAPI handle that is taken through handle initialization

Return

Socket descriptor

int lxt_release(LXT_HANDLE* handle);

Description

When application quitted, it has to return its handle. Through the returned handle, phone server removes ID of the registered application.

Parameter

LXT_HANDLE* handle: TAPI handle

Return

Success or failure of the function

int lxt_requestCurruntState(LXT_HANDLE* handle);

Description

Phone server transits its status according to specified events, and this status transition can be used usefully by application.
The function queries current status.

Parameter

LXT_HANDLE* handle: TAPI handle

Return

Success or failure of the function

int lxt_requestPhoneNumber(LXT_HANDLE* handle);

Description

After phone booting, phone server internally saves the phone numbers that are registered in R-UIM card. The function can query the number.

Parameter

LXT_HANDLE* handle: TAPI handle

Return

Success or failure of the function

int lxt_callback(LXT_HANDLE* handle);

Description

Application requests to phone server and takes the response relevant to the request through TAPI.
The function analyzes the response and then calls call back function that application has registered.

Parameter

LXT_HANDLE* handle: TAPI handle

Return

Success or failure of the function

b. Power

It is the collection of interfaces related to phone power. Through this, the scenario of turning phone on and checking battery can be operated.

int lxt_factoryMode(LXT_HANDLE* handle, unsigned char type);

Description

When product is in factory line, basic test is automatically progressed to phone and PDA. At this time, special cable is used for it.
Through the cable, the product recognizes that it is in factory line and PDA enters to sleep mode.
Indicator recognizes factory cable and then informs phone server of the fact through the function.

Parameter

LXT_HANDLE* handle: TAPI handle
unsigned char type: Cable type

Return

Success or failure of the function

int lxt_power_on(LXT_HANDLE* handle);

Description

It turns phone on.

Parameter

LXT_HANDLE* handle: TAPI handle

Return

Success or failure of the function

int lxt_power_off(LXT_HANDLE* handle);

Description

It turns phone off.

Parameter

LXT_HANDLE* handle: TAPI handle

Return

Success or failure of the function

int lxt_power_reset(LXT_HANDLE* handle);

Description

It restarts phone.

Parameter

LXT_HANDLE* handle: TAPI handle

Return

Success or failure of the function

c. Display

Even though PDA is in sleep mode, phone always lays awake and progresses communication with base station.
It supplies the interfaces that is to display electric field which is changed through communicating with base station, service possibility, roaming, whether message is received or not, etc. at indicator area.

int lxt_display_ringTypeIconChange(LXT_HANDLE* handle, LXT_RING_TYPE_ICON ringTypeIcon);

Description

Whenever you have changed ringer type in phone client, indicator has to display the icon relevant to the ringer.
The function is used when ringer type is changed in phone client-phone setup-.
Phone server informs indicator of the changed values according to ringer type and then indicator displays the changed icons.

Parameter

LXT_RING_TYPE_ICON ringTypeIcon: Ringer type

typedef enum
{
    LXT_RING_TYPE_ICON_RING                                                 = 0x00,
    LXT_RING_TYPE_ICON_INCREASING_RING                                 = 0x01,
    LXT_RING_TYPE_ICON_VIBRATE                                             = 0x02,
    LXT_RING_TYPE_ICON_VIBRATE_THEN_RING                              = 0x03,
    LXT_RING_TYPE_ICON_LAMP                                                 = 0x04
} LXT_RING_TYPE_ICON;

Return

int lxt_display_missedIconChange(LXT_HANDLE* handle, LXT_MISSED_ICON type);

Description

If you receive call in PDA mode-the mode that phone client isn’t on the front-, only the popup window appears.
If the call becomes missed call, user can’t know that the missed call exists until returning to Phone mode-the mode that phone client is on the front-.
To solve this problem, missed icon is displayed at the area where indicator shows new message.
Missed icon has higher priority than new message icon and missed icon stays the status until user recognizes the missed call and presses any key.

Parameter

LXT_MISSED_ICON type: Existence and non-existence of missed icon

typedef enum
{
	LXT_MISSED_ICON_HIDE		= 0x00,
	LXT_MISSED_ICON_SHOW	= 0x01
} LXT_MISSED_ICON;

Return

int lxt_display_icon(LXT_HANDLE* handle);

Description

It is used to update current strength of electric field, battery level, service possibility, etc. It queries the data to phone.

Parameter

Return

d. Sound

It supplies the interface that is for occurring DTMF tone during call or for changing sound path of phone

int lxt_sound_startKeyTone(LXT_HANDLE* handle, LXT_TONE_LENGTH tone_type, int volume, int key_code);

Description

It is used to use DTMF tone that is embedded in phone.

Parameter

LXT_TONE_LENGTH tone_type: The length of tone (Long, Short)
int volume: Sound volume (0~8)
int key_code: The value of Key code (Correspond to ASCII code.)

Return

int lxt_sound_stopKeyTone(LXT_HANDLE* handle);

Description

It stops Key tone that is now occurring.

Parameter

Return

int lxt_sound_setSpeakerPhone(LXT_HANDLE* handle, LXT_SOUND_SPEAKER_PHONE_MODE mode);

Description

It switches to speakerphone mode.

Parameter

LXT_SOUND_SPEAKER_PHONE_MODE mode: Mode types of speakerphone

typedef enum
{
    LXT_SOUND_SPEAKER_PHONE_MODE_OFF                                        = 0x00,
    LXT_SOUND_SPEAKER_PHONE_MODE_ON                                         = 0x01,
} LXT_SOUND_SPEAKER_PHONE_MODE;

Return

int lxt_sound_setAudioPathControl(LXT_HANDLE* handle, LXT_SOUND_AUDIO_PATH path);

Description

It changes Audio path.

Parameter

LXT_SOUND_AUDIO_PATH path: Audio paths

typedef enum
{
    LXT_SOUND_AUDIO_PATH_HAND_SET                                           = 0x00,
    LXT_SOUND_AUDIO_PATH_HEAD_SET                                           = 0x01,
    LXT_SOUND_AUDIO_PATH_HANDS_FREE                                         = 0x02
    
} LXT_SOUND_AUDIO_PATH;

Return

e. R-UIM

It is composed of the interfaces that handle R-UIM card inserted to phone. It supplies the functions of initialization of R-UIM card-Phone book initialization, SMS initialization, and inserting/removing/altering the data-.

int lxt_uim_cardStatus(LXT_HANDLE* handle);

Description

It requests the status of R-UIM card. As the status of R-UIM card, there are whether the card is physically inserted, whether PIN code is set or not, whether the card is blocked or not, whether the card is locked or not, etc. The status is used to status transmission in phone server and according to the status, whether R-UIM card is initialized or not is decided.

Parameter

Return

int lxt_uim_requestPinCodeStatus(LXT_HANDLE* handle);

Description

The function is used when phone server queries whether PIN code of R-UIM card is set. According to this, the status transmission of phone server is decided.

Parameter

Return

int lxt_uim_setPinCheck(LXT_HANDLE* handle, LXT_UIM_PIN_CODE_STATUS pinCodeStatus, int pinCodeLength, char *pinCode);

Description

The function is used to enable or disable PIN code of R-UIM card. (Phone client)

Parameter

LXT_UIM_PIN_CODE_STATUS pinCodeStatus: Status of PIN code

typedef enum
{
    LXT_UIM_PIN_CODE_STATUS_DISABLE                                         = 0x00,
    LXT_UIM_PIN_CODE_STATUS_ENABLE                                          = 0x01

int pinCodeLength: Length of PIN code
char *pinCode: PIN code

Return

int lxt_uim_pinVerify(LXT_HANDLE* handle, int codeLength, char *code);

Description

If PIN code is set in R-UIM card, phone server stops status transmission and waits user authentication.
At this time, the function is used to check user ID is correct. (Phone client)

Parameter

int codeLength: Length of PIN code ID
char *code: PIN code

Return

int lxt_uim_changePin(LXT_HANDLE* handle, int currentcodeLength, char *currentcode, int newcodeLength, char *newcode);

Description

The function is used to change ID that is set in R-UIM card. (Phone client)

Parameter

int currentcodeLength: Length of ID that is set now
char *currentcode: ID that is set now
int newcodeLength: Length of ID that is to be set
char *newcode: ID that is to be set

Return

int lxt_uim_getICCID(LXT_HANDLE* handle);

Description

R-UIM card has own serial number and the function is used to query the number.
Phone server saves the serial number at PDA after phone booting and prepares phone lock.

Parameter

Return

int lxt_uim_chvUnlock(LXT_HANDLE* handle, int chvUnblockCodeLength, char *chvUnblockCode, int newPinCodeLength, char *newPinCode);

Description

If you enter wrong ID for three times at the state that PIN code of R-UIM card is enable, the card falls into block state. The function is used to recover the state.

Parameter

int chvUnblockCodeLength : Length of block code that is set now
char *chvUnblockCode : Block code that is set now
int newPinCodeLength : Length of new ID
char *newPinCode : New ID

Return

int lxt_uim_getlock(LXT_HANDLE* handle);

Description

Phone lock is set to protect your phone from others’ R-UIM card. The function is used to query whether phone lock is set or not. (Phone client)

Parameter

Return

int lxt_uim_setlock(LXT_HANDLE* handle, LXT_UIM_LOCK_STATUS status);

Description

Phone lock is set to protect your phone from others’ R-UIM card. The function is used to decide whether phone lock is set or not. (Phone client)

Parameter

LXT_UIM_LOCK_STATUS status: The status of phone lock

typedef enum
{

Return

int lxt_uim_lockVerifyIndication(LXT_HANDLE* handle, LXT_UIM_LOCK_VERIFY status);

Description

The function is used to query whether PIN code of R-UIM card is set or not to phone server.

Parameter

LXT_UIM_LOCK_VERIFY status: Verification status of R-UIM lock

typedef enum
{
    LXT_UIM_LOCK_VERIFY_OK                                                  = 0x00,
    LXT_UIM_LOCK_VERIFY_FAIL                                                = 0x01

Return

int lxt_uim_smsInformation(LXT_HANDLE* handle);

Description

After ending initialization of R-UIM card, phone server gets to enter R-UIM card mirroring process according to the request of Indicator.
The function is used to query basic information, which is for starting SMS mirroring process, to phone.
As the information, there is maximum number of storing SMS.

Parameter

Return

int lxt_uim_smsRead(LXT_HANDLE* handle, int address);

Description

The function is used only when phone server does R-UIM card SMS mirroring and it reads SMS that are saved physically in R-UIM card.

Parameter

int address: Physical address of R-UIM card

Return

int lxt_uim_smsWrite(LXT_HANDLE* handle, int address, int tag, char* parm_mask, char* destination, char* callbacknumber, char* timestemp, char encoding, int messagesize, unsigned char *message);

Description

The function is used to save SMS physically to R-UIM card. (Message box)

Parameter

int address: Physical address of R-UIM card
int tag: Identifier that identifies MT(Incoming), MO(Outgoing), Read, Unread

typedef enum
{
    LXT_SMS_TAG_SMSI_INVALID = 0x00,
    LXT_SMS_TAG_SMSI_MT_READ = 0x01,
    LXT_SMS_TAG_SMSI_MT_NOT_READ = 0x03,
    LXT_SMS_TAG_SMSI_MO_SENT = 0x05,
    LXT_SMS_TAG_SMSI_MO_NOT_SENT = 0x07

char* parm_mask : In case of MT, SMS is received in SMSI form from network and there is mask value that decides what value to receive among those.
To restore this, the mask value has to be controlled in PDA. The mask value stored in PDA is valid only in case of MT and doesn’t exist in case of MO.
char* destination : Destination address. It is phone number of sender in case of MT and phone number of receiver in case of TO.
char* callbacknumber : Phone number to be called back
char* timestamp : Time stamp. It is the time created at base station in case of MT, and the time send from PDA in case of MO.
char encoding : Encoding information of User data

Octet 0x00
7bit ASCII 0x02
UNICODE 0x04
KSC5601_KOREAN 0x10

int messagesize : The length of User data
unsigned char *message : User data

Return

int lxt_uim_smsErase(LXT_HANDLE* handle, int address);

Description

The function is used to delete SMS that are physically stored in R-UIM card. (Message box)

Parameter

int address: Address

Return

int lxt_uim_smsAllList(LXT_HANDLE* handle);

Description

The function is used to query to phone server to receive all SMS mirroring data of R-UIM card.

Parameter

Return

int lxt_uim_smsMirroring(LXT_HANDLE* handle);

Description

After phone initialization, R-UIM card mirroring is started by Indicator request. At this time, the function is used to start SMS mirroring. (Indicator)

Parameter

Return

int lxt_uim_smsSetTag(LXT_HANDLE* handle, int address, LXT_SMS_TAG tag);

Description

The function is used to change TAG value of SMS that are stored in R-UIM card. (Message box)

Parameter

int address: Address that is stored in R-UIM card
LXT_SMS_TAG tag: TAG value

Return

int lxt_uim_phoneBookInformation(LXT_HANDLE* handle);

Description

The function is used to get basic information for starting Phone book mirroring while R-UIM card mirroring process of phone server.
As basic information, there are the length of Name field and maximum storage number of phone book.

Parameter

Return

int lxt_uim_phoneBookRead(LXT_HANDLE* handle, int startAddress, int endAddress);

Description

The function is used to phone book mirroring process of phone server. It reads phone book data through physical address.

Parameter

int startAddress: Start address
int endAddress: End address

Return

int lxt_uim_phoneBookWrite(LXT_HANDLE* handle, int address, int alphaLength, char *alpha, int digitLength, char *digit);

Description

The function is used to write data physically to phone book of R-UIM card. (Address book)

Parameter

int address : Phone book address that is in R-UIM card
int alphaLength : Length of Name field
char *alpha : Content of Name field
int digitLength : Length of phone number
char *digit : Content of phone number

Return

int lxt_uim_phoneBookErase(LXT_HANDLE* handle, int address);

Description

The function is used to delete one record of phone book that is in R-UIM card.

Parameter

int address: Phone book address that is in R-UIM card

Return

int lxt_uim_phoneBookClear(LXT_HANDLE* handle);

Description

The function is used to delete all records of phone book that is in R-UIM card. (Phone setup, address book)

Parameter

Return

int lxt_uim_smsClear(LXT_HANDLE* handle);

Description

The function is used to delete all SMS that is in R-UIM card. (Phone setup, message box)

Parameter

Return

int lxt_uim_phoneBookAllList(LXT_HANDLE* handle);

Description

The function is used to query all contents of phone book to phone server. (Indicator, Address book)

Parameter

Return

int lxt_uim_phoneBookMirroring(LXT_HANDLE* handle);

Description

The function is used to make phone server start phone book mirroring through indicator.

Parameter

Return

int lxt_uim_dirNameRead(LXT_HANDLE* handle);

Description

The function is used to read the MIN value that is in R-UIM card. There are MDN and MIN as phone number.
MIN is general phone number and MDN is special serial number for communication between base station and terminal.
The two numbers are same in the interior of the country but those are different in china and MIN value can be changed by the user request.

Parameter

Return

int lxt_uim_dirNameWrite(LXT_HANDLE* handle, int length, char * data);

Description

The function is used to save MIN value that is in R-UIM card.

Parameter

int length: Length of MDN
char * data: MDN data

Return

int lxt_uim_getPermissionStatus(LXT_HANDLE* handle);

Description

When factory line starts to produce, it progresses without R-UIM card.
The function is used to set the mode that makes terminal operate normally without R-UIM card. The function is used only in factory line.

Parameter

Return

int lxt_uim_writeUIMLockPassword(LXT_HANDLE* handle, int length, char * data);

Description

The function is used to set authentication code of R-UIM card lock.

Parameter

int length : The length of authentication code
char * data : Authentication code

Return

f. Configuration

It is composed of the interfaces that are to change set values set in phone. It is used to set the environment of phone.

int lxt_configuration_requestCurrentTime(LXT_HANDLE* handle);

Description

After booted and completing the communication with base station, phone starts service.
At this time, phone can get current time through synchronizing the time with base station.

Parameter

Return

int lxt_configuration_requestPhoneNumber(LXT_HANDLE* handle);

Description

The function is used to get own phone number that is stored in R-UIM card.

Parameter

Return

int lxt_configuration_requestPhoneVersion(LXT_HANDLE* handle);

Description

The function is used to get the version of phone firmware.

Parameter

Return

int lxt_configuration_requestPhoneLockInfo(LXT_HANDLE* handle);

Description

The function is used to query whether phone lock is set or not.

Parameter

Return

int lxt_configuration_setPhoneLock(LXT_HANDLE* handle, LXT_CONFIGURATION_PHONE_LOCK lock);

Description

The function is used to set phone lock.

Parameter

LXT_CONFIGURATION_PHONE_LOCK lock: Whether phone lock is set or not

typedef enum
{
    LXT_CONFIGURATION_PHONE_LOCK_NON_ACTIVE                                 = 0x00,
    LXT_CONFIGURATION_PHONE_LOCK_ACTIVE                                     = 0x01
    
} LXT_CONFIGURATION_PHONE_LOCK;

Return

int lxt_configuration_requestRadioConfiguration(LXT_HANDLE* handle);

Description

The function is used to query value of RF mode currently set.

Parameter

Return

int lxt_configuration_setRadioConfiguration(LXT_HANDLE* handle, LXT_CONFIGURATION_RADIO_MODE mode);

Description

The function is used to change value of RF mode currently set.

Parameter

LXT_CONFIGURATION_RADIO_MODE mode: RF Mode

typedef enum
{
    LXT_CONFIGURATION_RADIO_MODE_DIS_TEST_RC = 0x00,
    LXT_CONFIGURATION_RADIO_MODE_F_RC1R_RC1 = 0x01,
    LXT_CONFIGURATION_RADIO_MODE_F_RC2R_RC2 = 0x02,
    LXT_CONFIGURATION_RADIO_MODE_F_RC3R_RC3 = 0x03,
    LXT_CONFIGURATION_RADIO_MODE_F_RC4R_RC3 = 0x04,
    LXT_CONFIGURATION_RADIO_MODE_F_RC5R_RC4 = 0x05
    
} LXT_CONFIGURATION_RADIO_MODE;

Return

int lxt_configuration_requestSystemPreference(LXT_HANDLE* handle);

Description

The function is used to query preference currently set in phone.

Parameter

Return

int lxt_configuration_setSystemPreference(LXT_HANDLE* handle, LXT_CONFIGURATION_PREF_MODE mode);

Description

The function is used to change preference currently set in phone.

Parameter

LXT_CONFIGURATION_PREF_MODE mode: preference mode

typedef enum
{
    LXT_CONFIGURATION_PREF_MODE_HOME_ONLY = 0x00,
    LXT_CONFIGURATION_PREF_MODE_ATOMATIC_A = 0x01,
    LXT_CONFIGURATION_PREF_MODE_ATOMATIC_B = 0x02,
    LXT_CONFIGURATION_PREF_MODE_STANDARD = 0x03
    
} LXT_CONFIGURATION_PREF_MODE;

Return

int lxt_configuration_requestSystemParameter(LXT_HANDLE* handle);

Description

The function is used to inquire system parameter currently set in phone.
As system parameter, there are Protocol Revision, Base station id, network id, BS id, etc.

Parameter

Return

int lxt_configuration_setSystemParameter(LXT_HANDLE* handle, LXT_CONFIGURATION_PARA_MODE mode);

Description

The function is used to change system parameter currently set in phone.

Parameter

LXT_CONFIGURATION_PARA_MODE mode: System parameter mode

typedef enum
{
    LXT_CONFIGURATION_PARA_MODE_IS95A                                       = 0x03,
    LXT_CONFIGURATION_PARA_MODE_IS95B                                       = 0x04,
    LXT_CONFIGURATION_PARA_MODE_IS2000                                      = 0x06
    
} LXT_CONFIGURATION_PARA_MODE;

Return

int lxt_configuration_requestNAMInformation(LXT_HANDLE* handle);

Description

The function is used to inquire NAM mode that is set at phone.

Parameter

Return

int lxt_configuration_requestNAMData(LXT_HANDLE* handle, int index);

Description

The function is used to inquire the information such as NAM, MIN, etc that are set in phone.

Parameter

int index: The index of NAM

Return

int lxt_configuration_requestPhoneState(LXT_HANDLE* handle);

Description

The function is used to inquire current phone state.

0x00: Normal State (ON Line)
0x01: Off Line (Download etc.)
0x02: Maintenance Required Order
0x03: OTA state
0x04: Phone Reset
0x05: Deep sleep Mode

Parameter

Return

int lxt_configuration_setPhoneState(LXT_HANDLE* handle, LXT_CONFIGURATION_PHONE_STATE state);

Description

The function is used to change current phone state.

Parameter

LXT_CONFIGURATION_PHONE_STATE state: Phone state

typedef enum
{
    LXT_CONFIGURATION_PHONE_STATE_ON_LINE = 0x00,
    LXT_CONFIGURATION_PHONE_STATE_OFF_LINE = 0x01
    
} LXT_CONFIGURATION_PHONE_STATE;

Return

int lxt_configuration_confirmBatteryMediateness(LXT_HANDLE* handle, int value);

Description

The function is used to send battery state to phone. Battery type is divided into standard and extended, and the type can be recognized in PDA.
If phone is ready, phone server queries battery type to IOM and sends the response to phone.
Phone measures remain source of electricity through reflecting battery algorithm according to battery type.

Parameter

int value: Battery type

Return

int lxt_configuration_reqeustPDABattery(LXT_HANDLE* handle);

Description

The function is used to inquire battery type to phone server.

Parameter

Return

g. Voice Call

It supplies basic interface for voice call. There are the functions of receiving call, sending call, disconnecting call, etc.

int lxt_call_originaton(LXT_HANDLE* handle, char* callnumber);

Description

The function is used to send call.

Parameter

char* callnumber : Phone number

Return

int lxt_call_originaton2(LXT_HANDLE* handle, LXT_CALL_IPC_SO so, char* callnumber);

Description

The function is used to send call according to service option.

Parameter

LXT_CALL_IPC_SO so: Service option

typedef enum
{
    LXT_CALL_IPC_SO_MARKOV_8K                                               = 0x0501,
    LXT_CALL_IPC_SO_MARKOV_13K                                              = 0x0502,
    LXT_CALL_IPC_SO_LOOPBACK_8K                                             = 0x0401,
    LXT_CALL_IPC_SO_LOOPBACK_13K                                            = 0x0402,
    LXT_CALL_IPC_SO_SIMPLE_TDSO                                             = 0x0404,
    LXT_CALL_IPC_SO_FULL_TDSO                                               = 0x0405
    
} LXT_CALL_IPC_SO;

char* callnumber: Phone number

Return

int lxt_call_end(LXT_HANDLE* handle);

Description

The function is used to quit call during the call.

Parameter

Return

int lxt_call_answer(LXT_HANDLE* handle);

Description

The function is used to take received call.

Parameter

Return

int lxt_call_sendBurstDTMF(LXT_HANDLE* handle, LXT_TONE_LENGTH toneLength, int digitNum, char *dtmfDigit);

Description

The function is used to send DTMF tone.

Parameter

LXT_TONE_LENGTH toneLength: Tone length of DTMF tone

typedef enum
{
    LXT_TONE_LENGTH_SHORT = 0x00,
    LXT_TONE_LENGTH_LONG = 0x01

int digitNum : Length of number
char *dtmfDigit : Number

Return

int lxt_call_sendContinuousDTMF(LXT_HANDLE* handle, char digit);

Description

The function occurs DTMF tone.

Parameter

char digit: Number

Return

int lxt_call_stopContinuousDTMF(LXT_HANDLE* handle);

Description

The function suspends DTMF tone.

Parameter

char digit: Number

Return

int lxt_call_requestCallTime(LXT_HANDLE* handle);

Description

The function is used to inquiry call time to phone.

Parameter

Return

int lxt_call_setE911NumberRegistration(LXT_HANDLE* handle, int index, char* digit);

Description

The function is used to register emergency call.

Parameter

int index: Index relevant to emergency call
char* digit: Emergency call number

Return

int lxt_call_flashInformation(LXT_HANDLE* handle, char* callnumber);

Description

The function is used to transfer call during call.

Parameter

char* callnumber: Phone number for transfer

Return

int lxt_call_retry(LXT_HANDLE* handle, LXT_CALL_RETRY mode);

Description

The function sets retry mode when phone tries call connection.

Parameter

LXT_CALL_RETRY mode: retry mode

typedef enum
{
    LXT_CALL_RETRY_DISABLE                                                  = 0x00,
    LXT_CALL_RETRY_ENABLE                                                   = 0x01
    
} LXT_CALL_RETRY;

Return

h. Message Call

It supplies the interfaces that are for handling SMS (Simple Message Service).

int lxt_sms_sendMessage(LXT_HANDLE* handle, char* destination, char* callbacknumber, int messagesize, unsigned char *message, char encoding, int memoryIndex, char tag, char priority, char reply_option);

Description

The function is used to send SMS (Simple Message Service).

Parameter

char* destination : Phone number of destination or receiver
char* callbacknumber : Phone number to be called back
int messagesize : The length of User data
unsigned char *message : User data
char encoding : Encoding information of User data

Octet 0x00
7bit ASCII 0x02
UNICODE 0x04
KSC5601_KOREAN 0x10

int memoryIndex: Address of R-UIM card. In case of 0, the function doesn’t save to R-UIM card. When it is bigger than 0, the function saves to the relevant address.
char tag: Identifier that identify MT(Incoming), MO(Outgoing), Read, Unread

typedef enum
{
    LXT_SMS_TAG_SMSI_INVALID = 0x00,
    LXT_SMS_TAG_SMSI_MT_READ = 0x01,
    LXT_SMS_TAG_SMSI_MT_NOT_READ = 0x03,
    LXT_SMS_TAG_SMSI_MO_SENT = 0x05,
    LXT_SMS_TAG_SMSI_MO_NOT_SENT = 0x07

char priority: The value of priority of SMS. Priority is divided into Normal, Interactive, Urgent, and Emergency.
char reply_option: The value that decides whether Delivery ack is received or not after SMS sent

Return

int lxt_sms_setLocalCount(LXT_HANDLE* handle, unsigned char total, unsigned char unread, unsigned char spool, unsigned char unread_urgent);

Description

The function is used to inform phone server of the number of SMS that are currently stored in PDA. (Indicator)

Parameter

unsigned char total : Total message number that are stored in PDA
unsigned char unread : Message number that aren’t read
unsigned char spool : Message number that aren’t taken by application
unsigned char unread_urgent : The number of Urgent message

Return

int lxt_sms_setLocalStorageSize(LXT_HANDLE* handle, unsigned char size);

Description

The function is used to inform phone server of the maximum number of message that PDA can store.
(Indicator) Through the number, when new message is received, phone server informs base station of whether receiving the message succeeds or not.

Parameter

unsigned char size: Maximum message number

Return

int lxt_sms_requestLocalStorageSize(LXT_HANDLE* handle);

Description

The function is used to query the maximum number of message that PDA can store to phone server.

Parameter

Return

i. Data Call

It supplies the interfaces that are for controlling PIN to use data service.

int lxt_dataservice_pinControl(LXT_HANDLE* handle, LXT_RS232_SIGNAL_TYPE signal, LXT_RS232_SIGNAL_STATUS status);

Description

To use data communication, RS232 PIN of modem has to be controlled. The function is used to control the PIN.

Parameter

LXT_RS232_SIGNAL_TYPE signal: RS232 PIN number

typedef enum
{
    LXT_RS232_SIGNAL_TYPE_DCD = 0x01,
    LXT_RS232_SIGNAL_TYPE_RX = 0x02,
    LXT_RS232_SIGNAL_TYPE_TX = 0x03,
    LXT_RS232_SIGNAL_TYPE_DTR = 0x04,
    LXT_RS232_SIGNAL_TYPE_GND = 0x05,
    LXT_RS232_SIGNAL_TYPE_DSR = 0x06,
    LXT_RS232_SIGNAL_TYPE_RTS = 0x07,
    LXT_RS232_SIGNAL_TYPE_CTS = 0x08,
    LXT_RS232_SIGNAL_TYPE_RI = 0x09

LXT_RS232_SIGNAL_STATUS status: RS232 PIN status

typedef enum
{
    LXT_RS232_SIGNAL_STATUS_DEASSERT = 0x00,
    LXT_RS232_SIGNAL_STATUS_ASSERT = 0x01,

Return