Licensee TSY

A Licensee TSY (LTSY) is the platform-dependent part of a TSY. Licensees develop a LTSY to adapt the modem to Symbian platform. The LTSY should implement the functionality provided by the Common TSY (CTSY). This topic describes the Licensee TSY of the telephony server plug-ins.

CTSY sends the requests to the LTSY, the LTSY responds to the requests with a complete method. LTSY can return a KErrNone or one of the error codes to CTSY in the Complete method.

The CTSY and the telephony server run in the same thread and it is recommended that a LTSY also runs in this thread. An LTSY should have only one active scheduler and one or more static DLLs

Figure 1. LTSY Class diagram

LTSY tasks

A LTSY communicates with the baseband using proprietary software. A LTSY is an interface between the baseband and the CTSY. The main tasks of a LTSY are to:

  • translate the baseband specific data to Symbian platform data types

  • convert the Symbian platform request to the baseband request for the telephony client data

  • map the baseband specific error codes to Symbian platform error codes

  • process incoming calls, emergency calls and Class 2 Type 0 SMS even in out of memory situations

  • notify the CTSY of baseband status changes

  • maintain a state machine, if required

  • allocate memory for the baseband messages during initialisation of the LTSY

  • free the allocated memory when the baseband messages are sent back to the CTSY.

Related concepts
Licensee TSY Tutorial