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, gboolean all)
GSM_Error	GSM_CancelCall (GSM_StateMachine *s, int ID, gboolean 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, gboolean next)
GSM_Error	GSM_SwitchCall (GSM_StateMachine *s, int ID, gboolean next)
GSM_Error	GSM_SetIncomingCall (GSM_StateMachine *s, gboolean enable)
GSM_Error	GSM_SendDTMF (GSM_StateMachine *s, char *sequence)

Detailed Description

Call entries manipulations.

Enumeration Type Documentation

GSM_CallShowNumber

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 192 of file gammu-call.h.

             {
        GSM_CALL_ShowNumber = 1,
        GSM_CALL_HideNumber,
        GSM_CALL_DefaultNumberPresence
} GSM_CallShowNumber;

GSM_CallStatus

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 34 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_AnswerCall()

GSM_Error GSM_AnswerCall	(	GSM_StateMachine *	s,
		int	ID,
		gboolean	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

Accept current incoming call.

Definition at line 871 of file api.c.

References GSM_Phone_Functions::AnswerCall, CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, and PRINT_LOG_ERROR.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->AnswerCall(s, ID, all);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_CancelCall()

GSM_Error GSM_CancelCall	(	GSM_StateMachine *	s,
		int	ID,
		gboolean	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

Deny current incoming call.

Definition at line 884 of file api.c.

References GSM_Phone_Functions::CancelCall, CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, and PRINT_LOG_ERROR.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->CancelCall(s, ID, all);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_ConferenceCall()

GSM_Error GSM_ConferenceCall	(	GSM_StateMachine *	s,
		int	ID
	)

Initiates conference call.

Parameters

s	State machine pointer.
ID	ID of call.

Returns

Error code

Initiates a conference call.

Definition at line 923 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone_Functions::ConferenceCall, GSM_Phone::Functions, _GSM_StateMachine::Phone, and PRINT_LOG_ERROR.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->ConferenceCall(s, ID);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_DialService()

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

Dials service number (usually for USSD).

Definition at line 858 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone_Functions::DialService, GSM_Phone::Functions, _GSM_StateMachine::Phone, and PRINT_LOG_ERROR.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->DialService(s, Number);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_DialVoice()

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

Dials number and starts voice call.

Definition at line 845 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone_Functions::DialVoice, GSM_Phone::Functions, _GSM_StateMachine::Phone, and PRINT_LOG_ERROR.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->DialVoice(s, Number, ShowNumber);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_HoldCall()

GSM_Error GSM_HoldCall	(	GSM_StateMachine *	s,
		int	ID
	)

Holds call.

Parameters

s	State machine pointer.
ID	ID of call.

Returns

Error code

Holds call.

Definition at line 897 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, GSM_Phone_Functions::HoldCall, _GSM_StateMachine::Phone, and PRINT_LOG_ERROR.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->HoldCall(s, ID);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_SendDTMF()

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

Sends DTMF (Dual Tone Multi Frequency) tone.

Definition at line 1040 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, and GSM_Phone_Functions::SendDTMF.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->SendDTMF(s, sequence);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_SetIncomingCall()

GSM_Error GSM_SetIncomingCall	(	GSM_StateMachine *	s,
		gboolean	enable
	)

Activates/deactivates noticing about incoming calls.

Parameters

s	State machine pointer.
enable	Whether to enable notifications.

Returns

Error code

Activates/deactivates noticing about incoming calls.

Definition at line 1014 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, and GSM_Phone_Functions::SetIncomingCall.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->SetIncomingCall(s, enable);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_SplitCall()

GSM_Error GSM_SplitCall	(	GSM_StateMachine *	s,
		int	ID
	)

Splits call.

Parameters

s	State machine pointer.
ID	ID of call.

Returns

Error code

Splits call.

Definition at line 936 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, and GSM_Phone_Functions::SplitCall.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->SplitCall(s, ID);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_SwitchCall()

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

Switches call.

Parameters

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

Returns

Error code

Switches call.

Definition at line 962 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, and GSM_Phone_Functions::SwitchCall.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->SwitchCall(s, ID, next);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_TransferCall()

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

Transfers call.

Parameters

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

Returns

Error code

Transfers call.

Definition at line 949 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, and GSM_Phone_Functions::TransferCall.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->TransferCall(s, ID, next);
        PRINT_LOG_ERROR(err);
        return err;
}

GSM_UnholdCall()

GSM_Error GSM_UnholdCall	(	GSM_StateMachine *	s,
		int	ID
	)

Unholds call.

Parameters

s	State machine pointer.
ID	ID of call.

Returns

Error code

Unholds call.

Definition at line 910 of file api.c.

References CHECK_PHONE_CONNECTION, GSM_Phone::Functions, _GSM_StateMachine::Phone, PRINT_LOG_ERROR, and GSM_Phone_Functions::UnholdCall.

{
        GSM_Error err;

        CHECK_PHONE_CONNECTION();

        err = s->Phone.Functions->UnholdCall(s, ID);
        PRINT_LOG_ERROR(err);
        return err;
}