Call

Data Structures
struct	GSM_Call
Enumerations
enum	GSM_CallStatus {   GSM_CALL_IncomingCall = 1, GSM_CALL_OutgoingCall, GSM_CALL_CallStart, GSM_CALL_CallEnd,   GSM_CALL_CallRemoteEnd, GSM_CALL_CallLocalEnd, GSM_CALL_CallEstablished, GSM_CALL_CallHeld,   GSM_CALL_CallResumed, GSM_CALL_CallSwitched }
enum	GSM_CallShowNumber { GSM_CALL_ShowNumber = 1, GSM_CALL_HideNumber, GSM_CALL_DefaultNumberPresence }
Functions
GSM_Error	GSM_DialVoice (GSM_StateMachine *s, char *Number, GSM_CallShowNumber ShowNumber)
GSM_Error	GSM_DialService (GSM_StateMachine *s, char *Number)
GSM_Error	GSM_AnswerCall (GSM_StateMachine *s, int ID, bool all)
GSM_Error	GSM_CancelCall (GSM_StateMachine *s, int ID, bool all)
GSM_Error	GSM_HoldCall (GSM_StateMachine *s, int ID)
GSM_Error	GSM_UnholdCall (GSM_StateMachine *s, int ID)
GSM_Error	GSM_ConferenceCall (GSM_StateMachine *s, int ID)
GSM_Error	GSM_SplitCall (GSM_StateMachine *s, int ID)
GSM_Error	GSM_TransferCall (GSM_StateMachine *s, int ID, bool next)
GSM_Error	GSM_SwitchCall (GSM_StateMachine *s, int ID, bool next)
GSM_Error	GSM_SetIncomingCall (GSM_StateMachine *s, bool enable)
GSM_Error	GSM_SendDTMF (GSM_StateMachine *s, char *sequence)

---

Detailed Description

Call entries manipulations.

---

Enumeration Type Documentation

enum GSM_CallShowNumber

How to handle number when initiating voice call.

Enumerator:

GSM_CALL_ShowNumber	Show number.
GSM_CALL_HideNumber	Hide number.
GSM_CALL_DefaultNumberPresence	Keep phone default settings.

Definition at line 191 of file gammu-call.h.

             {
        GSM_CALL_ShowNumber = 1,
        GSM_CALL_HideNumber,
        GSM_CALL_DefaultNumberPresence
} GSM_CallShowNumber;

enum GSM_CallStatus

Enum with status of call.

Enumerator:

GSM_CALL_IncomingCall	Somebody calls to us
GSM_CALL_OutgoingCall	We call somewhere
GSM_CALL_CallStart	Call started
GSM_CALL_CallEnd	End of call from unknown side
GSM_CALL_CallRemoteEnd	End of call from remote side
GSM_CALL_CallLocalEnd	End of call from our side
GSM_CALL_CallEstablished	Call established. Waiting for answer or dropping
GSM_CALL_CallHeld	Call held
GSM_CALL_CallResumed	Call resumed
GSM_CALL_CallSwitched	We switch to call

Definition at line 30 of file gammu-call.h.

             {
        GSM_CALL_IncomingCall = 1,
        GSM_CALL_OutgoingCall,
        GSM_CALL_CallStart,
        GSM_CALL_CallEnd,
        GSM_CALL_CallRemoteEnd,
        GSM_CALL_CallLocalEnd,
        GSM_CALL_CallEstablished,
        GSM_CALL_CallHeld,
        GSM_CALL_CallResumed,
        GSM_CALL_CallSwitched
} GSM_CallStatus;

---

Function Documentation

GSM_Error GSM_AnswerCall	(	GSM_StateMachine *	s,
		int	ID,
		bool	all
	)

Accept current incoming call.

Parameters:

	s	State machine pointer.
	ID	ID of call.
	all	Whether to handle all call and not only the one specified by ID.

Returns:

Error code

GSM_Error GSM_CancelCall	(	GSM_StateMachine *	s,
		int	ID,
		bool	all
	)

Deny current incoming call.

Parameters:

	s	State machine pointer.
	ID	ID of call.
	all	Whether to handle all call and not only the one specified by ID.

Returns:

Error code

GSM_Error GSM_ConferenceCall	(	GSM_StateMachine *	s,
		int	ID
	)

Initiates conference call.

Parameters:

	s	State machine pointer.
	ID	ID of call.

Returns:

Error code

GSM_Error GSM_DialService	(	GSM_StateMachine *	s,
		char *	Number
	)

Dials service number (usually for USSD).

Parameters:

	s	State machine pointer.
	Number	Number to dial.

Returns:

Error code

GSM_Error GSM_DialVoice	(	GSM_StateMachine *	s,
		char *	Number,
		GSM_CallShowNumber	ShowNumber
	)

Dials number and starts voice call.

Parameters:

	s	State machine pointer.
	Number	Number to dial.
	ShowNumber	Whether we want to display number on phone.

Returns:

Error code

GSM_Error GSM_HoldCall	(	GSM_StateMachine *	s,
		int	ID
	)

Holds call.

Parameters:

	s	State machine pointer.
	ID	ID of call.

Returns:

Error code

GSM_Error GSM_SendDTMF	(	GSM_StateMachine *	s,
		char *	sequence
	)

Sends DTMF (Dual Tone Multi Frequency) tone.

Parameters:

	s	State machine pointer.
	sequence	Sequence to press.

Returns:

Error code

GSM_Error GSM_SetIncomingCall	(	GSM_StateMachine *	s,
		bool	enable
	)

Activates/deactivates noticing about incoming calls.

Parameters:

	s	State machine pointer.
	enable	Whether to enable notifications.

Returns:

Error code

GSM_Error GSM_SplitCall	(	GSM_StateMachine *	s,
		int	ID
	)

Splits call.

Parameters:

	s	State machine pointer.
	ID	ID of call.

Returns:

Error code

GSM_Error GSM_SwitchCall	(	GSM_StateMachine *	s,
		int	ID,
		bool	next
	)

Switches call.

Parameters:

	s	State machine pointer.
	ID	ID of call.
	next	Switches next call and ignores ID.

Returns:

Error code

GSM_Error GSM_TransferCall	(	GSM_StateMachine *	s,
		int	ID,
		bool	next
	)

Transfers call.

Parameters:

	s	State machine pointer.
	ID	ID of call.
	next	Switches next call and ignores ID.

Returns:

Error code

GSM_Error GSM_UnholdCall	(	GSM_StateMachine *	s,
		int	ID
	)

Unholds call.

Parameters:

	s	State machine pointer.
	ID	ID of call.

Returns:

Error code