org.freesmartphone.GSM.Call changed

[Michael 'Mickey' Lauer]

Salve,

after processing the first bit of feedback, especially Heikki's and Vesa's 
comments comments, we decided that it makes sense to simplify 
org.freesmartphone.GSM.Call a bit.

Instead of having a lot of different signals for individual states, we now 
have only one signal which is:

* CallStatus( index, status, properties )

CallStatus is sent whenever there is any status or property change on a call 
in the system, no matter whether this is an incoming, active, held, or 
released call.

Parameter 1 = Index: The index of the call that changed its status or 
properties.

Parameter 2 = Status: The new status of the call. Expected values are:
          "incoming" = The call is incoming (but not yet accepted),
          "outgoing" = The call is outgoing (but not yet established),
          "active" = The call is the active call (you can talk),
          "held" = The call is being held,
          "released" = The call is being released.

Further information can then be part of the properties. With that, we have a 
clean separation between mandatory and optional/additional information.

Parameter 3 = Properties; example properties:
          ( "number", string ) = The number of the peer (on incoming calls 
only if we received a CLIP),
          ( "minutes", int ) = The duration of this call
          ( "auxstatus", string ) = An auxillary connection status (if your 
modem supports that).

Auxstatus will be useful for things like
* the %CPRI (extended call progress indicator) in the TI Calypso, or
* the ECAM (extended call monitoring) in the Telit.

Note that within the CallStatus signal we only send properties that are new or 
have been changed. If you do not want to remember status, then you can query 
explicitly by using

ListCalls() -> a{i}, which gives you all valid indices for calls currently 
known to the system,

and then

GetStatus(index) -> ( index, status, properties ) which has the same signature 
as the CallStatus.

Hope this is all clear, please check back with the actual docs in the xml 
file. If not, please speak up now! :) (Yes, a state diagram for calls will be 
helpful -- I will do one, promised!)

Cheers,

:M: