diff options
Diffstat (limited to 'libmm-glib/mm-sim.c')
| -rw-r--r-- | libmm-glib/mm-sim.c | 609 |
1 files changed, 609 insertions, 0 deletions
diff --git a/libmm-glib/mm-sim.c b/libmm-glib/mm-sim.c new file mode 100644 index 00000000..46722fdd --- /dev/null +++ b/libmm-glib/mm-sim.c @@ -0,0 +1,609 @@ +/* -*- 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) 2011 Aleksander Morgado <aleksander@gnu.org> + */ + +#include "mm-sim.h" + +/** + * mm_sim_get_path: + * @self: A #MMSim. + * + * Gets the DBus path of the #MMSim object. + * + * Returns: (transfer none): The DBus path of the #MMSim object. + */ +const gchar * +mm_sim_get_path (MMSim *self) +{ + g_return_val_if_fail (G_IS_DBUS_PROXY (self), NULL); + + RETURN_NON_EMPTY_CONSTANT_STRING ( + g_dbus_proxy_get_object_path (G_DBUS_PROXY (self))); +} + +/** + * mm_sim_dup_path: + * @self: A #MMSim. + * + * Gets a copy of the DBus path of the #MMSim object. + * + * Returns: (transfer full): The DBus path of the #MMSim object. The returned value should be freed with g_free(). + */ +gchar * +mm_sim_dup_path (MMSim *self) +{ + gchar *value; + + g_return_val_if_fail (G_IS_DBUS_PROXY (self), NULL); + + g_object_get (G_OBJECT (self), + "g-object-path", &value, + NULL); + + RETURN_NON_EMPTY_STRING (value); +} + +/** + * mm_sim_get_identifier: + * @self: A #MMSim. + * + * Gets the unique SIM identifier of the #MMSim object. + * + * <warning>It is only safe to use this function on the thread where @self was constructed. Use mm_sim_dup_identifier() if on another thread.</warning> + * + * Returns: (transfer none): The unique identifier of the #MMSim object, or %NULL if it couldn't be retrieved. + */ +const gchar * +mm_sim_get_identifier (MMSim *self) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), NULL); + + return mm_gdbus_sim_get_sim_identifier (self); +} + +/** + * mm_sim_dup_identifier: + * @self: A #MMSim. + * + * Gets a copy of the unique SIM identifier of the #MMSim object. + * + * Returns: (transfer full): The unique identifier of the #MMSim object, or %NULL if it couldn't be retrieved. The returned value should be freed with g_free(). + */ +gchar * +mm_sim_dup_identifier (MMSim *self) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), NULL); + + return mm_gdbus_sim_dup_sim_identifier (self); +} + +/** + * mm_sim_get_imsi: + * @self: A #MMSim. + * + * Gets the International Mobile Subscriber Identity (IMSI) of the #MMSim object. + * + * <warning>It is only safe to use this function on the thread where @self was constructed. Use mm_sim_dup_imsi() if on another thread.</warning> + * + * Returns: (transfer none): The IMSI of the #MMSim object, or %NULL if it couldn't be retrieved. + */ +const gchar * +mm_sim_get_imsi (MMSim *self) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), NULL); + + return mm_gdbus_sim_get_imsi (self); +} + +/** + * mm_sim_dup_imsi: + * @self: A #MMSim. + * + * Gets a copy of the International Mobile Subscriber Identity (IMSI) of the #MMSim object. + * + * Returns: (transfer full): The IMSI of the #MMSim object, or %NULL if it couldn't be retrieved. The returned value should be freed with g_free(). + */ +gchar * +mm_sim_dup_imsi (MMSim *self) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), NULL); + + return mm_gdbus_sim_dup_imsi (self); +} + +/** + * mm_sim_get_operator_identifier: + * @self: A #MMSim. + * + * Gets the Operator Identifier of the #MMSim object. + * + * <warning>It is only safe to use this function on the thread where @self was constructed. Use mm_sim_dup_operator_identifier() if on another thread.</warning> + * + * Returns: (transfer none): The Operator Identifier of the #MMSim object, or %NULL if it couldn't be retrieved. + */ +const gchar * +mm_sim_get_operator_identifier (MMSim *self) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), NULL); + + return mm_gdbus_sim_get_operator_identifier (self); +} + +/** + * mm_sim_dup_operator_identifier: + * @self: A #MMSim. + * + * Gets a copy of the Operator Identifier of the #MMSim object. + * + * Returns: (transfer full): The Operator Identifier of the #MMSim object, or %NULL if it couldn't be retrieved. The returned value should be freed with g_free(). + */ +gchar * +mm_sim_dup_operator_identifier (MMSim *self) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), NULL); + + return mm_gdbus_sim_dup_operator_identifier (self); +} + +/** + * mm_sim_get_operator_name: + * @self: A #MMSim. + * + * Gets the Operator Name of the #MMSim object. + * + * <warning>It is only safe to use this function on the thread where @self was constructed. Use mm_sim_dup_operator_name() if on another thread.</warning> + * + * Returns: (transfer none): The Operator Name of the #MMSim object, or %NULL if it couldn't be retrieved. + */ +const gchar * +mm_sim_get_operator_name (MMSim *self) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), NULL); + + return mm_gdbus_sim_get_operator_name (self); +} + +/** + * mm_sim_dup_operator_name: + * @self: A #MMSim. + * + * Gets a copy of the Operator Name of the #MMSim object. + * + * Returns: (transfer full): The Operator Name of the #MMSim object, or %NULL if it couldn't be retrieved. The returned value should be freed with g_free(). + */ +gchar * +mm_sim_dup_operator_name (MMSim *self) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), NULL); + + return mm_gdbus_sim_dup_operator_name (self); +} + +/** + * mm_sim_send_pin: + * @self: A #MMSim. + * @pin: The PIN code. + * @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 sends the PIN code to the SIM card. + * + * 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_sim_send_pin_finish() to get the result of the operation. + * + * See mm_sim_send_pin_sync() for the synchronous, blocking version of this method. + */ +void +mm_sim_send_pin (MMSim *self, + const gchar *pin, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data) +{ + g_return_if_fail (MM_GDBUS_IS_SIM (self)); + + mm_gdbus_sim_call_send_pin (self, + pin, + cancellable, + callback, + user_data); +} + +/** + * mm_sim_send_pin_finish: + * @self: A #MMSim. + * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_sim_send_pin(). + * @error: Return location for error or %NULL. + * + * Finishes an operation started with mm_sim_send_pin(). + * + * Returns: (skip): %TRUE if the operation succeded, %FALSE if @error is set. + */ +gboolean +mm_sim_send_pin_finish (MMSim *self, + GAsyncResult *res, + GError **error) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), FALSE); + + return mm_gdbus_sim_call_send_pin_finish (self, res, error); +} + +/** + * mm_sim_send_pin_sync: + * @self: A #MMSim. + * @pin: The PIN code. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @error: Return location for error or %NULL. + * + * Synchronously sends the PIN to the SIM card. + * + * The calling thread is blocked until a reply is received. + * See mm_sim_send_pin() for the asynchronous version of this method. + * + * Returns: (skip): %TRUE if the operation succeded, %FALSE if @error is set. + */ +gboolean +mm_sim_send_pin_sync (MMSim *self, + const gchar *pin, + GCancellable *cancellable, + GError **error) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), FALSE); + + return (mm_gdbus_sim_call_send_pin_sync (self, + pin, + cancellable, + error)); +} + +/** + * mm_sim_send_puk: + * @self: A #MMSim. + * @puk: The PUK code. + * @pin: The PIN code. + * @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 sends the PUK code to the SIM card. + * + * 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_sim_send_puk_finish() to get the result of the operation. + * + * See mm_sim_send_puk_sync() for the synchronous, blocking version of this method. + */ +void +mm_sim_send_puk (MMSim *self, + const gchar *puk, + const gchar *pin, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data) +{ + g_return_if_fail (MM_GDBUS_IS_SIM (self)); + + mm_gdbus_sim_call_send_puk (self, + puk, + pin, + cancellable, + callback, + user_data); +} + +/** + * mm_sim_send_puk_finish: + * @self: A #MMSim. + * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_sim_send_puk(). + * @error: Return location for error or %NULL. + * + * Finishes an operation started with mm_sim_send_puk(). + * + * Returns: (skip): %TRUE if the operation succeded, %FALSE if @error is set. + */ +gboolean +mm_sim_send_puk_finish (MMSim *self, + GAsyncResult *res, + GError **error) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), FALSE); + + return mm_gdbus_sim_call_send_puk_finish (self, res, error); +} + +/** + * mm_sim_send_puk_sync: + * @self: A #MMSim. + * @puk: The PUK code. + * @pin: The PIN code. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @error: Return location for error or %NULL. + * + * Synchronously sends the PUK to the SIM card. + * + * The calling thread is blocked until a reply is received. + * See mm_sim_send_puk() for the asynchronous version of this method. + * + * Returns: (skip): %TRUE if the operation succeded, %FALSE if @error is set. + */ +gboolean +mm_sim_send_puk_sync (MMSim *self, + const gchar *puk, + const gchar *pin, + GCancellable *cancellable, + GError **error) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), FALSE); + + return (mm_gdbus_sim_call_send_puk_sync (self, + puk, + pin, + cancellable, + error)); +} + +/** + * mm_sim_enable_pin: + * @self: A #MMSim. + * @pin: The PIN code. + * @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 enables requesting the PIN code in the SIM card. + * + * 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_sim_enable_pin_finish() to get the result of the operation. + * + * See mm_sim_enable_pin_sync() for the synchronous, blocking version of this method. + */ +void +mm_sim_enable_pin (MMSim *self, + const gchar *pin, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data) +{ + g_return_if_fail (MM_GDBUS_IS_SIM (self)); + + mm_gdbus_sim_call_enable_pin (self, + pin, + TRUE, + cancellable, + callback, + user_data); +} + +/** + * mm_sim_enable_pin_finish: + * @self: A #MMSim. + * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_sim_enable_pin(). + * @error: Return location for error or %NULL. + * + * Finishes an operation started with mm_sim_enable_pin(). + * + * Returns: (skip): %TRUE if the operation succeded, %FALSE if @error is set. + */ +gboolean +mm_sim_enable_pin_finish (MMSim *self, + GAsyncResult *res, + GError **error) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), FALSE); + + return mm_gdbus_sim_call_enable_pin_finish (self, res, error); +} + +/** + * mm_sim_enable_pin_sync: + * @self: A #MMSim. + * @pin: The PIN code. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @error: Return location for error or %NULL. + * + * Synchronously enables requesting the PIN code in the SIM card. + * + * The calling thread is blocked until a reply is received. + * See mm_sim_enable_pin() for the asynchronous version of this method. + * + * Returns: (skip): %TRUE if the operation succeded, %FALSE if @error is set. + */ +gboolean +mm_sim_enable_pin_sync (MMSim *self, + const gchar *pin, + GCancellable *cancellable, + GError **error) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), FALSE); + + return (mm_gdbus_sim_call_enable_pin_sync (self, + pin, + TRUE, + cancellable, + error)); +} + +/** + * mm_sim_disable_pin: + * @self: A #MMSim. + * @pin: The PIN code. + * @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 disables requesting the PIN code in the SIM card. + * + * 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_sim_disable_pin_finish() to get the result of the operation. + * + * See mm_sim_disable_pin_sync() for the synchronous, blocking version of this method. + */ +void +mm_sim_disable_pin (MMSim *self, + const gchar *pin, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data) +{ + g_return_if_fail (MM_GDBUS_IS_SIM (self)); + + mm_gdbus_sim_call_enable_pin (self, + pin, + FALSE, + cancellable, + callback, + user_data); +} + +/** + * mm_sim_disable_pin_finish: + * @self: A #MMSim. + * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_sim_disable_pin(). + * @error: Return location for error or %NULL. + * + * Finishes an operation started with mm_sim_disable_pin(). + * + * Returns: (skip): %TRUE if the operation succeded, %FALSE if @error is set. + */ +gboolean +mm_sim_disable_pin_finish (MMSim *self, + GAsyncResult *res, + GError **error) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), FALSE); + + return mm_gdbus_sim_call_enable_pin_finish (self, res, error); +} + +/** + * mm_sim_disable_pin_sync: + * @self: A #MMSim. + * @pin: The PIN code. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @error: Return location for error or %NULL. + * + * Synchronously disables requesting the PIN code in the SIM card. + * + * The calling thread is blocked until a reply is received. + * See mm_sim_disable_pin() for the asynchronous version of this method. + * + * Returns: (skip): %TRUE if the operation succeded, %FALSE if @error is set. + */ +gboolean +mm_sim_disable_pin_sync (MMSim *self, + const gchar *pin, + GCancellable *cancellable, + GError **error) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), FALSE); + + return (mm_gdbus_sim_call_enable_pin_sync (self, + pin, + FALSE, + cancellable, + error)); +} + +/** + * mm_sim_change_pin: + * @self: A #MMSim. + * @old_pin: The current PIN code. + * @new_pin: The new PIN code to be set. + * @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 changes the PIN code in the SIM card. + * + * 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_sim_change_pin_finish() to get the result of the operation. + * + * See mm_sim_change_pin_sync() for the synchronous, blocking version of this method. + */ +void +mm_sim_change_pin (MMSim *self, + const gchar *old_pin, + const gchar *new_pin, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data) +{ + g_return_if_fail (MM_GDBUS_IS_SIM (self)); + + mm_gdbus_sim_call_change_pin (self, + old_pin, + new_pin, + cancellable, + callback, + user_data); +} + +/** + * mm_sim_change_pin_finish: + * @self: A #MMSim. + * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_sim_change_pin(). + * @error: Return location for error or %NULL. + * + * Finishes an operation started with mm_sim_change_pin(). + * + * Returns: (skip): %TRUE if the operation succeded, %FALSE if @error is set. + */ +gboolean +mm_sim_change_pin_finish (MMSim *self, + GAsyncResult *res, + GError **error) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), FALSE); + + return mm_gdbus_sim_call_change_pin_finish (self, res, error); +} + +/** + * mm_sim_change_pin_sync: + * @self: A #MMSim. + * @old_pin: The current PIN code. + * @new_pin: The new PIN code to be set. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @error: Return location for error or %NULL. + * + * Synchronously changes the PIN code in the SIM card. + * + * The calling thread is blocked until a reply is received. + * See mm_sim_change_pin() for the asynchronous version of this method. + * + * Returns: (skip): %TRUE if the operation succeded, %FALSE if @error is set. + */ +gboolean +mm_sim_change_pin_sync (MMSim *self, + const gchar *old_pin, + const gchar *new_pin, + GCancellable *cancellable, + GError **error) +{ + g_return_val_if_fail (MM_GDBUS_IS_SIM (self), FALSE); + + return (mm_gdbus_sim_call_change_pin_sync (self, + old_pin, + new_pin, + cancellable, + error)); +} |