Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]


ETel3rdParty: Using the Telephony Independent Software Vendor (ISV) API

This set of seven example applications demonstrate the use of the Telephony ISV API provided by the CTelephony public interface to the phone’s telephony system. This interface enables developers to access common mobile telephony services, such as finding phone information, dialling and answering voice calls.

The examples are located in the examples\Telephony\ETel3rdPartyExample folder.

Each example demonstrates a different set of mobile telephony services, and is stored in a subdirectory of ETel3rdPartyExample. These subdirectories are described in the next section.

[Top]


Description


AutoDTMFDialler

This example performs the following operations:


Configs

This example directory contains the config.txt and the TelephonyISVAppConfig.cfg files, which are required to configure the SIM TSY to run the application. For more information, see the Configuring the Simulator TSY section.


IncomingCalls

This example answers incoming calls using the CTelephony::AnswerIncomingCall() function. It also retrieves information about the call using the CTelephony::GetCallInfo() function.


NetworkInformation

This example retrieves the over-the-air network information about the currently registered mobile network using the CTelephony::GetCurrentNetworkInfo() function and also requests notification of changes to this information using the CTelephony::NotifyChange() function.


OutgoingCalls

This example performs the following operations:


PhoneId

This example retrieves information about a phone, such as the manufacturer name, serial number, phone and SIM card number using the CTelephony::GetPhoneId() function, and current subscriber information using the CTelephony::GetSubscriberId() function. It then prints this information to the console.


PhoneMonitoring

This example performs the following operations:


Shared

This example directory contains the shared files to be used by other directories for synchronous and asynchronous operations.


SuppleServices

This example retrieves the current status of the following services:

[Top]


Class Summary

The principal class used in this example is CTelephony.

[Top]


Configuring the Simulator TSY

To run the application you must configure the Simulator TSY. To do this, install the configuration files by performing the following steps:

  1. Copy the config.txt file and the TelephonyISVAppConfig.cfg file into the \epoc32\winscw\c\ directory of the phone.

  2. From the command prompt, go to the source root directory.

  3. Change directory to \epoc32\release\winscw\udeb and run the following command:

    > ced c:\TelephonyISVAppConfig.cfg

  4. Check the ced.log file to ensure that the configuration file has been read successfully.

[Top]


Building and running

The Symbian OS build process describes how to build an application.

The ETel3rdPartyExample builds the following executables in the standard location (\epoc32\release\winscw\<build_variant> for CodeWarrior):

Each executable must be run separately.

Note: Set the StartUpMode mode to 1 in the \epoc32\data\epoc.ini file to start the emulator in text shell mode as the applications use a console based interface.