diff options
Diffstat (limited to 'libmm-glib/mm-modem-voice.c')
| -rw-r--r-- | libmm-glib/mm-modem-voice.c | 599 |
1 files changed, 599 insertions, 0 deletions
diff --git a/libmm-glib/mm-modem-voice.c b/libmm-glib/mm-modem-voice.c new file mode 100644 index 00000000..71e8b1f7 --- /dev/null +++ b/libmm-glib/mm-modem-voice.c @@ -0,0 +1,599 @@ +/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ +/* + * libmm -- Access modem status & information from glib applications + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the + * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + * Boston, MA 02110-1301 USA. + * + * Copyright (C) 2015 Aleksander Morgado <aleksander@gnu.org> + * Copyright (C) 2015 Marco Bascetta <marco.bascetta@sadel.it> + */ + +#include <gio/gio.h> + +#include "mm-helpers.h" +#include "mm-common-helpers.h" +#include "mm-errors-types.h" +#include "mm-modem-voice.h" + +/** + * SECTION: mm-modem-voice + * @title: MMModemVoice + * @short_description: The Voice interface + * + * The #MMModemVoice is an object providing access to the methods, signals and + * properties of the Voice interface. + * + * The Voice interface is exposed whenever a modem has voice capabilities. + */ + +G_DEFINE_TYPE (MMModemVoice, mm_modem_voice, MM_GDBUS_TYPE_MODEM_VOICE_PROXY) + +/*****************************************************************************/ + +/** + * mm_modem_voice_get_path: + * @self: A #MMModemVoice. + * + * Gets the DBus path of the #MMObject which implements this interface. + * + * Returns: (transfer none): The DBus path of the #MMObject object. + */ +const gchar * +mm_modem_voice_get_path (MMModemVoice *self) +{ + g_return_val_if_fail (MM_IS_MODEM_VOICE (self), NULL); + + RETURN_NON_EMPTY_CONSTANT_STRING ( + g_dbus_proxy_get_object_path (G_DBUS_PROXY (self))); +} + +/** + * mm_modem_voice_dup_path: + * @self: A #MMModemVoice. + * + * Gets a copy of the DBus path of the #MMObject object which implements this interface. + * + * Returns: (transfer full): The DBus path of the #MMObject. The returned value should be freed with g_free(). + */ +gchar * +mm_modem_voice_dup_path (MMModemVoice *self) +{ + gchar *value; + + g_return_val_if_fail (MM_IS_MODEM_VOICE (self), NULL); + + g_object_get (G_OBJECT (self), + "g-object-path", &value, + NULL); + RETURN_NON_EMPTY_STRING (value); +} + +/*****************************************************************************/ + +typedef struct { + MMModemVoice *self; + GSimpleAsyncResult *result; + GCancellable *cancellable; + gchar **call_paths; + GList *call_objects; + guint i; +} ListCallContext; + +static void +call_object_list_free (GList *list) +{ + g_list_free_full (list, (GDestroyNotify) g_object_unref); +} + +static void +list_call_context_complete_and_free (ListCallContext *ctx) +{ + g_simple_async_result_complete_in_idle (ctx->result); + + g_strfreev (ctx->call_paths); + call_object_list_free (ctx->call_objects); + g_object_unref (ctx->result); + if (ctx->cancellable) + g_object_unref (ctx->cancellable); + g_object_ref (ctx->self); + g_slice_free (ListCallContext, ctx); +} + +/** + * mm_modem_voice_list_call_finish: + * @self: A #MMModem. + * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_list_call(). + * @error: Return location for error or %NULL. + * + * Finishes an operation started with mm_modem_voice_list_call(). + * + * Returns: (element-type ModemManager.Call) (transfer full): A list of #MMCall objects, or #NULL if either not found or @error is set. The returned value should be freed with g_list_free_full() using g_object_unref() as #GDestroyNotify function. + */ +GList * +mm_modem_voice_list_call_finish (MMModemVoice *self, + GAsyncResult *res, + GError **error) +{ + GList *list; + + g_return_val_if_fail (MM_IS_MODEM_VOICE (self), FALSE); + + if (g_simple_async_result_propagate_error (G_SIMPLE_ASYNC_RESULT (res), error)) + return NULL; + + list = g_simple_async_result_get_op_res_gpointer (G_SIMPLE_ASYNC_RESULT (res)); + + /* The list we got, including the objects within, is owned by the async result; + * so we'll make sure we return a new list */ + g_list_foreach (list, (GFunc)g_object_ref, NULL); + return g_list_copy (list); +} + +static void create_next_call (ListCallContext *ctx); + +static void +list_build_object_ready (GDBusConnection *connection, + GAsyncResult *res, + ListCallContext *ctx) +{ + GError *error = NULL; + GObject *call; + GObject *source_object; + + source_object = g_async_result_get_source_object (res); + call = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, &error); + g_object_unref (source_object); + + if (error) { + g_simple_async_result_take_error (ctx->result, error); + list_call_context_complete_and_free (ctx); + return; + } + + /* Keep the object */ + ctx->call_objects = g_list_prepend (ctx->call_objects, call); + + /* If no more calls, just end here. */ + if (!ctx->call_paths[++ctx->i]) { + g_simple_async_result_set_op_res_gpointer (ctx->result, + ctx->call_objects, + (GDestroyNotify)call_object_list_free); + ctx->call_objects = NULL; + list_call_context_complete_and_free (ctx); + return; + } + + /* Keep on creating next object */ + create_next_call (ctx); +} + +static void +create_next_call (ListCallContext *ctx) +{ + g_async_initable_new_async (MM_TYPE_CALL, + G_PRIORITY_DEFAULT, + ctx->cancellable, + (GAsyncReadyCallback)list_build_object_ready, + ctx, + "g-flags", G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START, + "g-name", MM_DBUS_SERVICE, + "g-connection", g_dbus_proxy_get_connection (G_DBUS_PROXY (ctx->self)), + "g-object-path", ctx->call_paths[ctx->i], + "g-interface-name", "org.freedesktop.ModemManager1.Call", + NULL); +} + +/** + * mm_modem_voice_list_call: + * @self: A #MMModemVoice. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL. + * @user_data: User data to pass to @callback. + * + * Asynchronously lists the #MMCall objects in the modem. + * + * When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. + * You can then call mm_modem_voice_list_call_finish() to get the result of the operation. + * + * See mm_modem_voice_list_call_sync() for the synchronous, blocking version of this method. + */ +void +mm_modem_voice_list_call (MMModemVoice *self, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data) +{ + ListCallContext *ctx; + + g_return_if_fail (MM_IS_MODEM_VOICE (self)); + + ctx = g_slice_new0 (ListCallContext); + ctx->self = g_object_ref (self); + ctx->result = g_simple_async_result_new (G_OBJECT (self), + callback, + user_data, + mm_modem_voice_list_call); + if (cancellable) + ctx->cancellable = g_object_ref (cancellable); + + ctx->call_paths = mm_gdbus_modem_voice_dup_calls (MM_GDBUS_MODEM_VOICE (self)); + + /* If no CALL, just end here. */ + if (!ctx->call_paths || !ctx->call_paths[0]) { + g_simple_async_result_set_op_res_gpointer (ctx->result, NULL, NULL); + list_call_context_complete_and_free (ctx); + return; + } + + /* Got list of paths. If at least one found, start creating objects for each */ + ctx->i = 0; + create_next_call (ctx); +} + +/** + * mm_modem_voice_list_call_sync: + * @self: A #MMModemVoice. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @error: Return location for error or %NULL. + * + * Synchronously lists the #MMCall objects in the modem. + * + * The calling thread is blocked until a reply is received. See mm_modem_voice_list_call() + * for the asynchronous version of this method. + * + * Returns: (element-type MMCall) (transfer full): A list of #MMCall objects, or #NULL if either not found or @error is set. The returned value should be freed with g_list_free_full() using g_object_unref() as #GDestroyNotify function. + */ +GList * +mm_modem_voice_list_call_sync (MMModemVoice *self, + GCancellable *cancellable, + GError **error) +{ + GList *call_objects = NULL; + gchar **call_paths = NULL; + guint i; + + g_return_val_if_fail (MM_IS_MODEM_VOICE (self), NULL); + + call_paths = mm_gdbus_modem_voice_dup_calls (MM_GDBUS_MODEM_VOICE (self)); + + /* Only non-empty lists are returned */ + if (!call_paths) + return NULL; + + for (i = 0; call_paths[i]; i++) { + GObject *call; + + call = g_initable_new (MM_TYPE_CALL, + cancellable, + error, + "g-flags", G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START, + "g-name", MM_DBUS_SERVICE, + "g-connection", g_dbus_proxy_get_connection (G_DBUS_PROXY (self)), + "g-object-path", call_paths[i], + "g-interface-name", "org.freedesktop.ModemManager1.Call", + NULL); + if (!call) { + call_object_list_free (call_objects); + g_strfreev (call_paths); + return NULL; + } + + /* Keep the object */ + call_objects = g_list_prepend (call_objects, call); + } + + g_strfreev (call_paths); + return call_objects; +} + +/*****************************************************************************/ + +typedef struct { + GSimpleAsyncResult *result; + GCancellable *cancellable; +} CreateCallContext; + +static void +create_call_context_complete_and_free (CreateCallContext *ctx) +{ + g_simple_async_result_complete (ctx->result); + g_object_unref (ctx->result); + if (ctx->cancellable) + g_object_unref (ctx->cancellable); + g_slice_free (CreateCallContext, ctx); +} + +/** + * mm_modem_voice_create_call_finish: + * @self: A #MMModemVoice. + * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_create_call(). + * @error: Return location for error or %NULL. + * + * Finishes an operation started with mm_modem_voice_create_call(). + * + * Returns: (transfer full): A newly created #MMCall, or %NULL if @error is set. The returned value should be freed with g_object_unref(). + */ +MMCall * +mm_modem_voice_create_call_finish (MMModemVoice *self, + GAsyncResult *res, + GError **error) +{ + g_return_val_if_fail (MM_IS_MODEM_VOICE (self), NULL); + + if (g_simple_async_result_propagate_error (G_SIMPLE_ASYNC_RESULT (res), error)) + return NULL; + + return g_object_ref (g_simple_async_result_get_op_res_gpointer (G_SIMPLE_ASYNC_RESULT (res))); +} + +static void +new_call_object_ready (GDBusConnection *connection, + GAsyncResult *res, + CreateCallContext *ctx) +{ + GError *error = NULL; + GObject *call; + GObject *source_object; + + source_object = g_async_result_get_source_object (res); + call = g_async_initable_new_finish (G_ASYNC_INITABLE (source_object), res, &error); + g_object_unref (source_object); + + if (error) + g_simple_async_result_take_error (ctx->result, error); + else + g_simple_async_result_set_op_res_gpointer (ctx->result, + call, + (GDestroyNotify)g_object_unref); + + create_call_context_complete_and_free (ctx); +} + +static void +create_call_ready (MMModemVoice *self, + GAsyncResult *res, + CreateCallContext *ctx) +{ + GError *error = NULL; + gchar *call_path = NULL; + + if (!mm_gdbus_modem_voice_call_create_call_finish (MM_GDBUS_MODEM_VOICE (self), + &call_path, + res, + &error)) { + g_simple_async_result_take_error (ctx->result, error); + create_call_context_complete_and_free (ctx); + g_free (call_path); + return; + } + + g_async_initable_new_async (MM_TYPE_CALL, + G_PRIORITY_DEFAULT, + ctx->cancellable, + (GAsyncReadyCallback)new_call_object_ready, + ctx, + "g-flags", G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START, + "g-name", MM_DBUS_SERVICE, + "g-connection", g_dbus_proxy_get_connection (G_DBUS_PROXY (self)), + "g-object-path", call_path, + "g-interface-name", "org.freedesktop.ModemManager1.Call", + NULL); + g_free (call_path); +} + +/** + * mm_modem_voice_create_call: + * @self: A #MMModemVoice. + * @properties: A ##MMCallProperties object with the properties to use. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL. + * @user_data: User data to pass to @callback. + * + * Asynchronously creates a new #MMCall in the modem. + * + * When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. + * You can then call mm_modem_voice_create_call_finish() to get the result of the operation. + * + * See mm_modem_voice_create_call_sync() for the synchronous, blocking version of this method. + */ +void +mm_modem_voice_create_call (MMModemVoice *self, + MMCallProperties *properties, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data) +{ + CreateCallContext *ctx; + GVariant *dictionary; + + g_return_if_fail (MM_IS_MODEM_VOICE (self)); + + ctx = g_slice_new0 (CreateCallContext); + ctx->result = g_simple_async_result_new (G_OBJECT (self), + callback, + user_data, + mm_modem_voice_create_call); + if (cancellable) + ctx->cancellable = g_object_ref (cancellable); + + dictionary = (mm_call_properties_get_dictionary (properties)); + mm_gdbus_modem_voice_call_create_call ( + MM_GDBUS_MODEM_VOICE (self), + dictionary, + cancellable, + (GAsyncReadyCallback)create_call_ready, + ctx); + + g_variant_unref (dictionary); +} + +/** + * mm_modem_voice_create_call_sync: + * @self: A #MMModemVoice. + * @properties: A ##MMCallProperties object with the properties to use. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @error: Return location for error or %NULL. + * + * Synchronously creates a new #MMCall in the modem. + * + * The calling thread is blocked until a reply is received. See mm_modem_voice_create_call() + * for the asynchronous version of this method. + * + * Returns: (transfer full): A newly created #MMCall, or %NULL if @error is set. The returned value should be freed with g_object_unref(). + */ +MMCall * +mm_modem_voice_create_call_sync (MMModemVoice *self, + MMCallProperties *properties, + GCancellable *cancellable, + GError **error) +{ + MMCall *call = NULL; + gchar *call_path = NULL; + GVariant *dictionary; + + g_return_val_if_fail (MM_IS_MODEM_VOICE (self), NULL); + + dictionary = (mm_call_properties_get_dictionary (properties)); + mm_gdbus_modem_voice_call_create_call_sync (MM_GDBUS_MODEM_VOICE (self), + dictionary, + &call_path, + cancellable, + error); + if (call_path) { + call = g_initable_new (MM_TYPE_CALL, + cancellable, + error, + "g-flags", G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START, + "g-name", MM_DBUS_SERVICE, + "g-connection", g_dbus_proxy_get_connection (G_DBUS_PROXY (self)), + "g-object-path", call_path, + "g-interface-name", "org.freedesktop.ModemManager1.Call", + NULL); + g_free (call_path); + } + + g_variant_unref (dictionary); + + return (call ? MM_CALL (call) : NULL); +} + +/*****************************************************************************/ + +/** + * mm_modem_voice_delete_call_finish: + * @self: A #MMModemVoice. + * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_delete_call(). + * @error: Return location for error or %NULL. + * + * Finishes an operation started with mm_modem_voice_delete_call(). + * + * Returns: %TRUE if the call was deleted, %FALSE if @error is set. + */ +gboolean +mm_modem_voice_delete_call_finish (MMModemVoice *self, + GAsyncResult *res, + GError **error) +{ + g_return_val_if_fail (MM_IS_MODEM_VOICE (self), FALSE); + + return mm_gdbus_modem_voice_call_delete_call_finish (MM_GDBUS_MODEM_VOICE (self), res, error); +} + +/** + * mm_modem_voice_delete_call: + * @self: A #MMModemVoice. + * @call: Path of the #MMCall to delete. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL. + * @user_data: User data to pass to @callback. + * + * Asynchronously deletes a given #MMCall from the modem. + * + * When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from. + * You can then call mm_modem_voice_delete_finish() to get the result of the operation. + * + * See mm_modem_voice_delete_sync() for the synchronous, blocking version of this method. + */ +void +mm_modem_voice_delete_call (MMModemVoice *self, + const gchar *call, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data) +{ + g_return_if_fail (MM_IS_MODEM_VOICE (self)); + + mm_gdbus_modem_voice_call_delete_call (MM_GDBUS_MODEM_VOICE (self), + call, + cancellable, + callback, + user_data); +} + +/** + * mm_modem_voice_delete_call_sync: + * @self: A #MMModemVoice. + * @call: Path of the #MMCall to delete. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @error: Return location for error or %NULL. + + * Synchronously deletes a given #MMCall from the modem. + * + * The calling thread is blocked until a reply is received. See mm_modem_voice_delete_call() + * for the asynchronous version of this method. + * + * Returns: %TRUE if the CALL was deleted, %FALSE if @error is set. + */ +gboolean +mm_modem_voice_delete_call_sync (MMModemVoice *self, + const gchar *call, + GCancellable *cancellable, + GError **error) +{ + g_return_val_if_fail (MM_IS_MODEM_VOICE (self), FALSE); + + return mm_gdbus_modem_voice_call_delete_call_sync (MM_GDBUS_MODEM_VOICE (self), + call, + cancellable, + error); +} + +/*****************************************************************************/ + +static void +mm_modem_voice_init (MMModemVoice *self) +{ + /* Setup private data */ +} + +static void +finalize (GObject *object) +{ + //MMModemVoice *self = MM_MODEM_VOICE (object); + + G_OBJECT_CLASS (mm_modem_voice_parent_class)->finalize (object); +} + +static void +mm_modem_voice_class_init (MMModemVoiceClass *modem_class) +{ + GObjectClass *object_class = G_OBJECT_CLASS (modem_class); + + //g_type_class_add_private (object_class, sizeof (MMModemVoicePrivate)); + + /* Virtual methods */ + object_class->finalize = finalize; +} |