Home · All Classes · Annotated · Functions

Tutorial: Phone Server

This section provides an example of the methods to route applications requests through the phone server to the AT command handlers and describes how the responses are returned to the application.

Using the SIMIdentity query type, which returns the IMSI number of the SIM the method is as follows:

1. create PhoneLine object to handle the request:

       PhoneLine *line = new PhoneLine();

2. create the PhoneLineQCop object to transmit requests from the application to the phone server.
3. return responses to queries via the queryResult signal
4. A slot is created and the signal is connected:

       connect( line, SIGNAL(queryResult(PhoneLine::QueryType, const QString&)),
                this, SLOT(simIdResult(PhoneLine::QueryType, const QString&)) );
       ...
       void AppClass::simIdResult( PhoneLine::QueryType type, const QString& value )
       {
           // Process the result "value".
           ...
       }

5. Once the signal has been connected, the application issues the query as follows:

       line->query( PhoneLine::SIMIdentity );

6. PhoneLine::query calls the private phone handler method query.

   For this example the query method is PhoneLineQCop::query which sends a QCop message to the phone server on the QPE/Phone channel.

7. The phone server listening on the QPE/Phone channel, receives the message in PhoneServerQCop::phoneMessage and dispatches it to its PhoneLine object.

   Note: The PhoneLine for the phone server contains a private PhoneLineAt object rather than the PhoneLineQCop object used by applications.

8. The phone server calls PhoneLineAt::query which determines the AT command to execute to perform the request. In this case, the command is AT+CIMI.
9. After the command is executed, the PhoneLineAt::queryDone method decodes the response and emits the queryResult signal.
10. The queryResult signal is intercepted by the phone server PhoneServerQCop::queryResult in phoneserver.cpp) and turned into a QCop message on the QPE/Phone channel.
11. The QCop message is received in the application by PhoneLineQCop::stateListen which emits the queryResult signal to the application's AppClass::simIdResult slot.

This completes the example. Other commands and notifications within the phone library follow a similar pattern.