diff options
| -rw-r--r-- | include/ModemManager-enums.h | 56 | ||||
| -rw-r--r-- | introspection/all.xml | 2 | ||||
| -rw-r--r-- | introspection/org.freedesktop.ModemManager1.Call.xml | 88 | ||||
| -rw-r--r-- | introspection/org.freedesktop.ModemManager1.Modem.Voice.xml | 88 |
4 files changed, 234 insertions, 0 deletions
diff --git a/include/ModemManager-enums.h b/include/ModemManager-enums.h index 57a2b277..d19b2a75 100644 --- a/include/ModemManager-enums.h +++ b/include/ModemManager-enums.h @@ -1168,4 +1168,60 @@ typedef enum { /*< underscore_name=mm_oma_session_state_failed_reason >*/ MM_OMA_SESSION_STATE_FAILED_REASON_SESSION_CANCELLED = 5 } MMOmaSessionStateFailedReason; +/** + * MMCallState: + * @MM_CALL_STATE_UNKNOWN: default state for a new outgoing call. + * @MM_CALL_STATE_DIALING: outgoing call started. Wait for free channel. + * @MM_CALL_STATE_RINGING_IN: outgoing call attached to GSM network, waiting for an answer. + * @MM_CALL_STATE_RINGING_OUT: incoming call is waiting for an answer. + * @MM_CALL_STATE_ACTIVE: call is active between two peers. + * @MM_CALL_STATE_HELD: held call (by +CHLD AT command). + * @MM_CALL_STATE_WAITING: waiting call (by +CCWA AT command). + * @MM_CALL_STATE_TERMINATED: call is terminated. + * + * State of Call + */ +typedef enum { /*< underscore_name=mm_call_state >*/ + MM_CALL_STATE_UNKNOWN = 0, + MM_CALL_STATE_DIALING = 1, + MM_CALL_STATE_RINGING_OUT = 2, + MM_CALL_STATE_RINGING_IN = 3, + MM_CALL_STATE_ACTIVE = 4, + MM_CALL_STATE_HELD = 5, + MM_CALL_STATE_WAITING = 6, + MM_CALL_STATE_TERMINATED = 7 +} MMCallState; + +/** + * MMCallStateReason: + * @MM_CALL_STATE_REASON_UNKNOWN: Default value for a new outgoing call. + * @MM_CALL_STATE_REASON_OUTGOING_STARTED: Outgoing call is started. + * @MM_CALL_STATE_REASON_INCOMING_NEW: Received a new incoming call. + * @MM_CALL_STATE_REASON_ACCEPTED: Dialing or Ringing call is accepted. + * @MM_CALL_STATE_REASON_TERMINATED: Call is correctly terminated. + * @MM_CALL_STATE_REASON_REFUSED_OR_BUSY: Remote peer is busy or refused call + * @MM_CALL_STATE_REASON_ERROR: Wrong number or generic network error. + */ +typedef enum { /*< underscore_name=mm_call_state_reason >*/ + MM_CALL_STATE_REASON_UNKNOWN = 0, + MM_CALL_STATE_REASON_OUTGOING_STARTED = 1, + MM_CALL_STATE_REASON_INCOMING_NEW = 2, + MM_CALL_STATE_REASON_ACCEPTED = 3, + MM_CALL_STATE_REASON_TERMINATED = 4, + MM_CALL_STATE_REASON_REFUSED_OR_BUSY = 5, + MM_CALL_STATE_REASON_ERROR = 6 +} MMCallStateReason; + +/** + * MMCallDirection: + * @MM_CALL_DIRECTION_UNKNOWN: unknown. + * @MM_CALL_DIRECTION_INCOMING: call from network. + * @MM_CALL_DIRECTION_OUTGOING: call to network. + */ +typedef enum { /*< underscore_name=mm_call_direction >*/ + MM_CALL_DIRECTION_UNKNOWN = 0, + MM_CALL_DIRECTION_INCOMING = 1, + MM_CALL_DIRECTION_OUTGOING = 2 +} MMCallDirection; + #endif /* _MODEMMANAGER_ENUMS_H_ */ diff --git a/introspection/all.xml b/introspection/all.xml index 4d277e36..57c28d05 100644 --- a/introspection/all.xml +++ b/introspection/all.xml @@ -6,7 +6,9 @@ <xi:include href="org.freedesktop.ModemManager1.Sim.xml"/> <xi:include href="org.freedesktop.ModemManager1.Bearer.xml"/> <xi:include href="org.freedesktop.ModemManager1.Sms.xml"/> + <xi:include href="org.freedesktop.ModemManager1.Call.xml"/> <xi:include href="org.freedesktop.ModemManager1.Modem.xml"/> + <xi:include href="org.freedesktop.ModemManager1.Modem.Voice.xml"/> <xi:include href="org.freedesktop.ModemManager1.Modem.Modem3gpp.xml"/> <xi:include href="org.freedesktop.ModemManager1.Modem.Modem3gpp.Ussd.xml"/> <xi:include href="org.freedesktop.ModemManager1.Modem.ModemCdma.xml"/> diff --git a/introspection/org.freedesktop.ModemManager1.Call.xml b/introspection/org.freedesktop.ModemManager1.Call.xml new file mode 100644 index 00000000..41112d50 --- /dev/null +++ b/introspection/org.freedesktop.ModemManager1.Call.xml @@ -0,0 +1,88 @@ +<?xml version="1.0" encoding="UTF-8" ?> + +<!-- + ModemManager 1.0 Interface Specification + + Copyright (C) 2015 Marco Bascetta <marco.bascetta@sadel.it> + Copyright (C) 2015 Riccardo Vangelisti <riccardo.vangelisti@sadel.it> +--> + +<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd"> + + <!-- + org.freedesktop.ModemManager1.Call: + @short_description: The ModemManager Call interface. + + The Call interface Defines operations and properties of a single Call. + --> + <interface name="org.freedesktop.ModemManager1.Call"> + + <!-- + Start: + + If the outgoing call has not yet been started, start it. + Applicable only if state is MM_CALL_STATE_UNKNOWN and direction is MM_CALL_DIRECTION_OUTGOING. + --> + <method name="Start" /> + + <!-- + Accept: + + Accept incoming call (answer). + Applicable only if state is MM_CALL_STATE_RINGING and direction is MM_CALL_DIRECTION_INCOMING + --> + <method name="Accept" /> + + <!-- + Hangup: + + Hangup the active call. + Applicable only if states are MM_CALL_STATE_RINGING and MM_CALL_STATE_ACCEPTED + --> + <method name="Hangup"/> + + <!-- + StateChanged: + @old: Old state MMCallState + @new: New state MMCallState + @reason: A <link linkend="MMCallStateReason">MMCallStateReason</link> value, specifying the reason for this state change. + + Emitted when call changes state + --> + <signal name="StateChanged"> + <arg name="old" type="i" /> + <arg name="new" type="i" /> + <arg name="reason" type="u" /> + </signal> + + <!-- + State: + + A <link linkend="MMCallState">MMCallState</link> value, + describing the state of the call. + --> + <property name="State" type="i" access="read" /> + + <!-- + StateReason: + + A <link linkend="MMCallStateReason">MMCallStateReason</link> value, describing why the state is changed. + --> + <property name="StateReason" type="i" access="read" /> + + <!-- + Direction: + + A <link linkend="MMCallDirection">MMCallDirection</link> value, + describing the direction of the call. + --> + <property name="Direction" type="i" access="read" /> + + <!-- + Number: + + The remote phone number. + --> + <property name="Number" type="s" access="read" /> + </interface> +</node> diff --git a/introspection/org.freedesktop.ModemManager1.Modem.Voice.xml b/introspection/org.freedesktop.ModemManager1.Modem.Voice.xml new file mode 100644 index 00000000..82b3b09e --- /dev/null +++ b/introspection/org.freedesktop.ModemManager1.Modem.Voice.xml @@ -0,0 +1,88 @@ +<?xml version="1.0" encoding="UTF-8" ?> + +<!-- + ModemManager 1.0 Interface Specification + + Copyright (C) 2015 Marco Bascetta <marco.bascetta@sadel.it> + Copyright (C) 2015 Riccardo Vangelisti <riccardo.vangelisti@sadel.it> +--> + +<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd"> + + <!-- + org.freedesktop.ModemManager1.Modem.Voice: + @short_description: The ModemManager Voice interface. + + The Voice interface handles Calls. + --> + <interface name="org.freedesktop.ModemManager1.Modem.Voice"> + + <!-- + ListCalls: + @result: The list of call object paths. + + Retrieve all Calls. + + This method should only be used once and subsequent information + retrieved either by listening for the + #org.freedesktop.ModemManager1.Modem.Voice::Added signal, + or by querying the specific Call object of interest. + --> + <method name="ListCalls"> + <arg name="result" type="ao" direction="out" /> + </method> + + <!-- + DeleteCall: + @path: The object path of the Call to delete. + + Delete a Call from lists of calls. + If it is still active, Call.Hangup method is performed + --> + <method name="DeleteCall"> + <arg name="path" type="o" direction="in" /> + </method> + + <!-- + CreateCall: + @properties: Call properties from the <link linkend="gdbus-org.freedesktop.ModemManager1.Call">Call D-Bus interface</link>. + @path: The object path of the new call object. + + Creates a new call object. + + The '<link linkend="gdbus-property-org-freedesktop-ModemManager1-Call.Number">Number</link>' is mandatory + --> + <method name="CreateCall"> + <arg name="properties" type="a{sv}" direction="in" /> + <arg name="path" type="o" direction="out" /> + </method> + + <!-- + CallAdded: + @path: Object path of the new call. + + Emitted when any part of a Call has been received or added. + --> + <signal name="CallAdded"> + <arg name="path" type="o" /> + </signal> + + <!-- + CallDeleted: + @path: Object path of the now deleted Call. + + Emitted when a call has been deleted. + --> + <signal name="CallDeleted"> + <arg name="path" type="o" /> + </signal> + + <!-- + Calls: + + The list of calls object paths. + --> + <property name="Calls" type="ao" access="read" /> + + </interface> +</node> |