498 lines
15 KiB
C
498 lines
15 KiB
C
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
|
|
/*
|
|
* libmm-glib -- 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 - 2012 Aleksander Morgado <aleksander@gnu.org>
|
|
* Copyright (C) 2012 Google, Inc.
|
|
*/
|
|
|
|
#include <gio/gio.h>
|
|
|
|
#include "mm-helpers.h"
|
|
#include "mm-errors-types.h"
|
|
#include "mm-modem-cdma.h"
|
|
|
|
/**
|
|
* SECTION: mm-modem-cdma
|
|
* @title: MMModemCdma
|
|
* @short_description: The CDMA interface
|
|
*
|
|
* The #MMModemCdma is an object providing access to the methods, signals and
|
|
* properties of the CDMA interface.
|
|
*
|
|
* The CDMA interface is exposed whenever a modem has CDMA capabilities
|
|
* (%MM_MODEM_CAPABILITY_CDMA_EVDO).
|
|
*/
|
|
|
|
G_DEFINE_TYPE (MMModemCdma, mm_modem_cdma, MM_GDBUS_TYPE_MODEM_CDMA_PROXY)
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_modem_cdma_get_path:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* Gets the DBus path of the #MMObject which implements this interface.
|
|
*
|
|
* Returns: (transfer none): The DBus path of the #MMObject object.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
const gchar *
|
|
mm_modem_cdma_get_path (MMModemCdma *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_CONSTANT_STRING (
|
|
g_dbus_proxy_get_object_path (G_DBUS_PROXY (self)));
|
|
}
|
|
|
|
/**
|
|
* mm_modem_cdma_dup_path:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* 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().
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
gchar *
|
|
mm_modem_cdma_dup_path (MMModemCdma *self)
|
|
{
|
|
gchar *value;
|
|
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), NULL);
|
|
|
|
g_object_get (G_OBJECT (self),
|
|
"g-object-path", &value,
|
|
NULL);
|
|
RETURN_NON_EMPTY_STRING (value);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_modem_cdma_get_meid:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* Gets the
|
|
* <ulink url="http://en.wikipedia.org/wiki/MEID">Mobile Equipment Identifier</ulink>,
|
|
* as reported by this #MMModemCdma.
|
|
*
|
|
* <warning>The returned value is only valid until the property changes so it is
|
|
* only safe to use this function on the thread where @self was constructed. Use
|
|
* mm_modem_cdma_dup_meid() if on another thread.</warning>
|
|
*
|
|
* Returns: (transfer none): The MEID, or %NULL if none available.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
const gchar *
|
|
mm_modem_cdma_get_meid (MMModemCdma *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_CONSTANT_STRING (
|
|
mm_gdbus_modem_cdma_get_meid (MM_GDBUS_MODEM_CDMA (self)));
|
|
}
|
|
|
|
/**
|
|
* mm_modem_cdma_dup_meid:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* Gets a copy of the
|
|
* <ulink url="http://en.wikipedia.org/wiki/MEID">Mobile Equipment Identifier</ulink>,
|
|
* as reported by this #MMModemCdma.
|
|
*
|
|
* Returns: (transfer full): The MEID, or %NULL if none available. The returned
|
|
* value should be freed with g_free().
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
gchar *
|
|
mm_modem_cdma_dup_meid (MMModemCdma *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_STRING (
|
|
mm_gdbus_modem_cdma_dup_meid (MM_GDBUS_MODEM_CDMA (self)));
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_modem_cdma_get_esn:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* Gets the
|
|
* <ulink url="http://en.wikipedia.org/wiki/Electronic_serial_number">Electronic Serial Number</ulink>,
|
|
* as reported by this #MMModemCdma.
|
|
*
|
|
* The ESN is superceded by MEID, but still used in older devices.
|
|
*
|
|
* <warning>The returned value is only valid until the property changes so it is
|
|
* only safe to use this function on the thread where @self was constructed. Use
|
|
* mm_modem_cdma_dup_esn() if on another thread.</warning>
|
|
*
|
|
* Returns: (transfer none): The ESN, or %NULL if none available.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
const gchar *
|
|
mm_modem_cdma_get_esn (MMModemCdma *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_CONSTANT_STRING (
|
|
mm_gdbus_modem_cdma_get_esn (MM_GDBUS_MODEM_CDMA (self)));
|
|
}
|
|
|
|
/**
|
|
* mm_modem_cdma_dup_esn:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* Gets a copy of the
|
|
* <ulink url="http://en.wikipedia.org/wiki/Electronic_serial_number">Electronic Serial Number</ulink>,
|
|
* as reported by this #MMModemCdma.
|
|
*
|
|
* The ESN is superceded by MEID, but still used in older devices.
|
|
*
|
|
* Returns: (transfer full): The ESN, or %NULL if none available. The returned
|
|
* value should be freed with g_free().
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
gchar *
|
|
mm_modem_cdma_dup_esn (MMModemCdma *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_STRING (
|
|
mm_gdbus_modem_cdma_dup_esn (MM_GDBUS_MODEM_CDMA (self)));
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_modem_cdma_get_sid:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* Gets the
|
|
* <ulink url="http://en.wikipedia.org/wiki/System_Identification_Number">System Identifier</ulink>
|
|
* of the serving CDMA 1x network, if known, and if the modem is registered with
|
|
* a CDMA 1x network.
|
|
*
|
|
* Returns: The SID, or %MM_MODEM_CDMA_SID_UNKNOWN.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
guint
|
|
mm_modem_cdma_get_sid (MMModemCdma *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), MM_MODEM_CDMA_SID_UNKNOWN);
|
|
|
|
return mm_gdbus_modem_cdma_get_sid (MM_GDBUS_MODEM_CDMA (self));
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_modem_cdma_get_nid:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* Gets the
|
|
* <ulink url="http://en.wikipedia.org/wiki/Network_Identification_Number">Network Identifier</ulink>
|
|
* of the serving CDMA 1x network, if known, and if the modem is registered with
|
|
* a CDMA 1x network.
|
|
*
|
|
* Returns: The NID, or %MM_MODEM_CDMA_NID_UNKNOWN.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
guint
|
|
mm_modem_cdma_get_nid (MMModemCdma *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), MM_MODEM_CDMA_NID_UNKNOWN);
|
|
|
|
return mm_gdbus_modem_cdma_get_nid (MM_GDBUS_MODEM_CDMA (self));
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_modem_cdma_get_cdma1x_registration_state:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* Gets the state of the registration in the CDMA 1x network.
|
|
*
|
|
* Returns: a #MMModemCdmaRegistrationState.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
MMModemCdmaRegistrationState
|
|
mm_modem_cdma_get_cdma1x_registration_state (MMModemCdma *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), MM_MODEM_CDMA_REGISTRATION_STATE_UNKNOWN);
|
|
|
|
return mm_gdbus_modem_cdma_get_cdma1x_registration_state (MM_GDBUS_MODEM_CDMA (self));
|
|
}
|
|
|
|
/**
|
|
* mm_modem_cdma_get_evdo_registration_state:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* Gets the state of the registration in the EV-DO network.
|
|
*
|
|
* Returns: a #MMModemCdmaRegistrationState.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
MMModemCdmaRegistrationState
|
|
mm_modem_cdma_get_evdo_registration_state (MMModemCdma *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), MM_MODEM_CDMA_REGISTRATION_STATE_UNKNOWN);
|
|
|
|
return mm_gdbus_modem_cdma_get_evdo_registration_state (MM_GDBUS_MODEM_CDMA (self));
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_modem_cdma_get_activation_state:
|
|
* @self: A #MMModemCdma.
|
|
*
|
|
* Gets the state of the activation in the 3GPP2 network.
|
|
*
|
|
* Returns: a #MMModemCdmaActivationState.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
MMModemCdmaActivationState
|
|
mm_modem_cdma_get_activation_state (MMModemCdma *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), MM_MODEM_CDMA_ACTIVATION_STATE_UNKNOWN);
|
|
|
|
return mm_gdbus_modem_cdma_get_activation_state (MM_GDBUS_MODEM_CDMA (self));
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_modem_cdma_activate_finish:
|
|
* @self: A #MMModemCdma.
|
|
* @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
|
|
* mm_modem_cdma_activate().
|
|
* @error: Return location for error or %NULL.
|
|
*
|
|
* Finishes an operation started with mm_modem_cdma_activate().
|
|
*
|
|
* Returns: %TRUE if the activation was successful, %FALSE if @error is set.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
gboolean
|
|
mm_modem_cdma_activate_finish (MMModemCdma *self,
|
|
GAsyncResult *res,
|
|
GError **error)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), FALSE);
|
|
|
|
return mm_gdbus_modem_cdma_call_activate_finish (MM_GDBUS_MODEM_CDMA (self), res, error);
|
|
}
|
|
|
|
/**
|
|
* mm_modem_cdma_activate:
|
|
* @self: A #MMModemCdma.
|
|
* @carrier: Name of the carrier.
|
|
* @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 requests to provision the modem for use with a given carrier
|
|
* using the modem's OTA activation functionality, if any.
|
|
*
|
|
* 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_cdma_activate_finish() to get the result of the operation.
|
|
*
|
|
* See mm_modem_cdma_activate_sync() for the synchronous, blocking version of
|
|
* this method.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
void
|
|
mm_modem_cdma_activate (MMModemCdma *self,
|
|
const gchar *carrier,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data)
|
|
{
|
|
g_return_if_fail (MM_IS_MODEM_CDMA (self));
|
|
|
|
mm_gdbus_modem_cdma_call_activate (MM_GDBUS_MODEM_CDMA (self), carrier, cancellable, callback, user_data);
|
|
}
|
|
|
|
/**
|
|
* mm_modem_cdma_activate_sync:
|
|
* @self: A #MMModemCdma.
|
|
* @carrier: Name of the carrier.
|
|
* @cancellable: (allow-none): A #GCancellable or %NULL.
|
|
* @error: Return location for error or %NULL.
|
|
*
|
|
* Synchronously requests to provision the modem for use with a given carrier
|
|
* using the modem's OTA activation functionality, if any.
|
|
*
|
|
* The calling thread is blocked until a reply is received. See
|
|
* mm_modem_cdma_activate() for the asynchronous version of this method.
|
|
*
|
|
* Returns: %TRUE if the activation was successful, %FALSE if @error is set.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
gboolean
|
|
mm_modem_cdma_activate_sync (MMModemCdma *self,
|
|
const gchar *carrier,
|
|
GCancellable *cancellable,
|
|
GError **error)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), FALSE);
|
|
|
|
return mm_gdbus_modem_cdma_call_activate_sync (MM_GDBUS_MODEM_CDMA (self), carrier, cancellable, error);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_modem_cdma_activate_manual_finish:
|
|
* @self: A #MMModemCdma.
|
|
* @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
|
|
* mm_modem_cdma_activate_manual().
|
|
* @error: Return location for error or %NULL.
|
|
*
|
|
* Finishes an operation started with mm_modem_cdma_activate_manual().
|
|
*
|
|
* Returns: %TRUE if the activation was successful, %FALSE if @error is set.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
gboolean
|
|
mm_modem_cdma_activate_manual_finish (MMModemCdma *self,
|
|
GAsyncResult *res,
|
|
GError **error)
|
|
{
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), FALSE);
|
|
|
|
return mm_gdbus_modem_cdma_call_activate_manual_finish (MM_GDBUS_MODEM_CDMA (self), res, error);
|
|
}
|
|
|
|
/**
|
|
* mm_modem_cdma_activate_manual:
|
|
* @self: A #MMModemCdma.
|
|
* @properties: A #MMCdmaManualActivationProperties.
|
|
* @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 requests to provision the modem with the given properties.
|
|
*
|
|
* 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_cdma_activate_manual_finish() to get the result of
|
|
* the operation.
|
|
*
|
|
* See mm_modem_cdma_activate_manual_sync() for the synchronous, blocking
|
|
* version of this method.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
void
|
|
mm_modem_cdma_activate_manual (MMModemCdma *self,
|
|
MMCdmaManualActivationProperties *properties,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data)
|
|
{
|
|
GVariant *dictionary;
|
|
|
|
g_return_if_fail (MM_IS_MODEM_CDMA (self));
|
|
|
|
dictionary = mm_cdma_manual_activation_properties_get_dictionary (properties);
|
|
mm_gdbus_modem_cdma_call_activate_manual (MM_GDBUS_MODEM_CDMA (self),
|
|
dictionary,
|
|
cancellable,
|
|
callback,
|
|
user_data);
|
|
g_variant_unref (dictionary);
|
|
}
|
|
|
|
/**
|
|
* mm_modem_cdma_activate_manual_sync:
|
|
* @self: A #MMModemCdma.
|
|
* @properties: A #MMCdmaManualActivationProperties.
|
|
* @cancellable: (allow-none): A #GCancellable or %NULL.
|
|
* @error: Return location for error or %NULL.
|
|
*
|
|
* Synchronously requests to provision the modem with the given properties.
|
|
*
|
|
* The calling thread is blocked until a reply is received. See
|
|
* mm_modem_cdma_activate_manual() for the asynchronous version of this method.
|
|
*
|
|
* Returns: %TRUE if the activation was successful, %FALSE if @error is set.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
gboolean
|
|
mm_modem_cdma_activate_manual_sync (MMModemCdma *self,
|
|
MMCdmaManualActivationProperties *properties,
|
|
GCancellable *cancellable,
|
|
GError **error)
|
|
{
|
|
GVariant *dictionary;
|
|
gboolean ret;
|
|
|
|
g_return_val_if_fail (MM_IS_MODEM_CDMA (self), FALSE);
|
|
|
|
dictionary = mm_cdma_manual_activation_properties_get_dictionary (properties);
|
|
ret = (mm_gdbus_modem_cdma_call_activate_manual_sync (
|
|
MM_GDBUS_MODEM_CDMA (self),
|
|
dictionary,
|
|
cancellable,
|
|
error));
|
|
g_variant_unref (dictionary);
|
|
return ret;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
static void
|
|
mm_modem_cdma_init (MMModemCdma *self)
|
|
{
|
|
}
|
|
|
|
static void
|
|
mm_modem_cdma_class_init (MMModemCdmaClass *modem_class)
|
|
{
|
|
}
|