This section describes the SIM application Toolkits (SAT) and the APIs available to access them.
This section is aimed at the developers writing SAT engines, which is the client side implementation of the SAT functionality. The term Clients refers to the SAT engine in this document. The developers are assumed to have good knowledge of Symbian platform telephony architecture, 3GPP SAT specifications and TSY modules.
SIM application toolkit is the software present in the electronic card of the device. There can be more than one SAT application present on the card.
Integrated circuit card is the electronic card that can store the subscription details of the user and the network operator related details.
RSat provides an interface to the SIM application toolkits (SAT) stored in an electronic card (ICC) of the phone through a TSY.
The SAT interface is implemented as a TSY plug-in extension to the telephony server. The SAT defines the protocols, which instruct the phone to do various tasks such as display a menu item, add a menu item or create an URL link. The SAT engine request notification of these messages and they are executed through the TSY.
SAT application requires an error message to be returned when an envelope command or a proactive command fails. There are two types of error messages
The basic error messages are those defined by the ETel core API and the E32 base API. The extended error codes consists of error codes defined in ETelSat API, ETelPacket API, ETelMultimode API, ETelCDMA API and those defined by the licensees. Clients can choose to receive either basic or extended error codes by using RTelServer::SetExtendedErrorGranualirity(). The clients receive extended error codes when available, else the basic error code is returned.
The proactive commands are sometimes associated with an icon/image which is optional. The icons and images are stored in the ICC. The command gives and image id to the SAT engines which uses it to retrieve the elementary file from the ICC using RSat::GetIcon() for icons and RSat::GetImageInstance() for image files. The TSY retrieves the file and passes it to the SAT engine. The SAT engine has to choose an instance, which is best suited for the particular device and display it.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.