424 lines
13 KiB
C
424 lines
13 KiB
C
/* -*- 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 <gio/gio.h>
|
|
|
|
#include "mm-helpers.h"
|
|
#include "mm-modem-3gpp.h"
|
|
|
|
/**
|
|
* mm_modem_3gpp_get_path:
|
|
* @self: A #MMModem3gpp.
|
|
*
|
|
* 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_3gpp_get_path (MMModem3gpp *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_modem_3gpp_dup_path:
|
|
* @self: A #MMModem3gpp.
|
|
*
|
|
* 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_3gpp_dup_path (MMModem3gpp *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_modem_3gpp_get_imei:
|
|
* @self: A #MMModem3gpp.
|
|
*
|
|
* Gets the <ulink url="http://en.wikipedia.org/wiki/Imei">IMEI</ulink>,
|
|
* as reported by this #MMModem.
|
|
*
|
|
* <warning>It is only safe to use this function on the thread where @self was constructed. Use mm_modem_3gpp_dup_imei() if on another thread.</warning>
|
|
*
|
|
* Returns: (transfer none): The IMEI, or %NULL if none available.
|
|
*/
|
|
const gchar *
|
|
mm_modem_3gpp_get_imei (MMModem3gpp *self)
|
|
{
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_CONSTANT_STRING (
|
|
mm_gdbus_modem3gpp_get_imei (self));
|
|
}
|
|
|
|
/**
|
|
* mm_modem_3gpp_dup_imei:
|
|
* @self: A #MMModem3gpp.
|
|
*
|
|
* Gets a copy of the <ulink url="http://en.wikipedia.org/wiki/Imei">IMEI</ulink>,
|
|
* as reported by this #MMModem.
|
|
*
|
|
* Returns: (transfer full): The IMEI, or %NULL if none available. The returned value should be freed with g_free().
|
|
*/
|
|
gchar *
|
|
mm_modem_3gpp_dup_imei (MMModem3gpp *self)
|
|
{
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_STRING (
|
|
mm_gdbus_modem3gpp_dup_imei (self));
|
|
}
|
|
|
|
/**
|
|
* mm_modem_3gpp_get_operator_code:
|
|
* @self: A #MMModem3gpp.
|
|
*
|
|
* Gets the code of the operator to which the mobile is
|
|
* currently registered.
|
|
*
|
|
* Returned in the format <literal>"MCCMNC"</literal>, where
|
|
* <literal>MCC</literal> is the three-digit ITU E.212 Mobile Country Code
|
|
* and <literal>MNC</literal> is the two- or three-digit GSM Mobile Network
|
|
* Code. e.g. e<literal>"31026"</literal> or <literal>"310260"</literal>.
|
|
*
|
|
* If the <literal>MCC</literal> and <literal>MNC</literal> are not known
|
|
* or the mobile is not registered to a mobile network, this property will
|
|
* be a zero-length (blank) string.
|
|
*
|
|
* <warning>It is only safe to use this function on the thread where @self was constructed. Use mm_modem_3gpp_dup_operator_code() if on another thread.</warning>
|
|
*
|
|
* Returns: (transfer none): The operator code, or %NULL if none available.
|
|
*/
|
|
const gchar *
|
|
mm_modem_3gpp_get_operator_code (MMModem3gpp *self)
|
|
{
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_CONSTANT_STRING (
|
|
mm_gdbus_modem3gpp_get_operator_code (self));
|
|
}
|
|
|
|
/**
|
|
* mm_modem_3gpp_dup_operator_code:
|
|
* @self: A #MMModem3gpp.
|
|
*
|
|
* Gets a copy of the code of the operator to which the mobile is
|
|
* currently registered.
|
|
*
|
|
* Returned in the format <literal>"MCCMNC"</literal>, where
|
|
* <literal>MCC</literal> is the three-digit ITU E.212 Mobile Country Code
|
|
* and <literal>MNC</literal> is the two- or three-digit GSM Mobile Network
|
|
* Code. e.g. e<literal>"31026"</literal> or <literal>"310260"</literal>.
|
|
*
|
|
* Returns: (transfer full): The operator code, or %NULL if none available. The returned value should be freed with g_free().
|
|
*/
|
|
gchar *
|
|
mm_modem_3gpp_dup_operator_code (MMModem3gpp *self)
|
|
{
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_STRING (
|
|
mm_gdbus_modem3gpp_dup_operator_code (self));
|
|
}
|
|
|
|
/**
|
|
* mm_modem_3gpp_get_operator_name:
|
|
* @self: A #MMModem3gpp.
|
|
*
|
|
* Gets the name of the operator to which the mobile is
|
|
* currently registered.
|
|
*
|
|
* <warning>It is only safe to use this function on the thread where @self was constructed. Use mm_modem_3gpp_dup_operator_name() if on another thread.</warning>
|
|
*
|
|
* Returns: (transfer none): The operator name, or %NULL if none available.
|
|
*/
|
|
const gchar *
|
|
mm_modem_3gpp_get_operator_name (MMModem3gpp *self)
|
|
{
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_CONSTANT_STRING (
|
|
mm_gdbus_modem3gpp_get_operator_name (self));
|
|
}
|
|
|
|
/**
|
|
* mm_modem_3gpp_dup_operator_name:
|
|
* @self: A #MMModem3gpp.
|
|
*
|
|
* Gets a copy of the name of the operator to which the mobile is
|
|
* currently registered.
|
|
*
|
|
* Returns: (transfer full): The operator name, or %NULL if none available. The returned value should be freed with g_free().
|
|
*/
|
|
gchar *
|
|
mm_modem_3gpp_dup_operator_name (MMModem3gpp *self)
|
|
{
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_STRING (
|
|
mm_gdbus_modem3gpp_dup_operator_name (self));
|
|
}
|
|
|
|
/**
|
|
* mm_modem_3gpp_get_registration_state:
|
|
* @self: A #MMModem.
|
|
*
|
|
* Get the the mobile registration status as defined in 3GPP TS 27.007
|
|
* section 10.1.19.
|
|
*
|
|
* Returns: A #MMModem3gppRegistrationState value, specifying the current registration state.
|
|
*/
|
|
MMModem3gppRegistrationState
|
|
mm_modem_3gpp_get_registration_state (MMModem3gpp *self)
|
|
{
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), MM_MODEM_3GPP_REGISTRATION_STATE_IDLE);
|
|
|
|
return mm_gdbus_modem3gpp_get_registration_state (self);
|
|
}
|
|
|
|
/**
|
|
* mm_modem_3gpp_get_enabled_facility_locks:
|
|
* @self: A #MMModem3gpp.
|
|
*
|
|
* Get the list of facilities for which PIN locking is enabled.
|
|
*
|
|
* Returns: A bitmask of #MMModem3gppFacility flags, specifying which facilities have locks enabled.
|
|
*/
|
|
MMModem3gppFacility
|
|
mm_modem_3gpp_get_enabled_facility_locks (MMModem3gpp *self)
|
|
{
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), MM_MODEM_3GPP_FACILITY_NONE);
|
|
|
|
return mm_gdbus_modem3gpp_get_enabled_facility_locks (self);
|
|
}
|
|
|
|
void
|
|
mm_modem_3gpp_register (MMModem3gpp *self,
|
|
const gchar *network_id,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data)
|
|
{
|
|
g_return_if_fail (MM_GDBUS_IS_MODEM3GPP (self));
|
|
|
|
mm_gdbus_modem3gpp_call_register (self,
|
|
network_id,
|
|
cancellable,
|
|
callback,
|
|
user_data);
|
|
}
|
|
|
|
gboolean
|
|
mm_modem_3gpp_register_finish (MMModem3gpp *self,
|
|
GAsyncResult *res,
|
|
GError **error)
|
|
{
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), FALSE);
|
|
|
|
return mm_gdbus_modem3gpp_call_register_finish (self,
|
|
res,
|
|
error);
|
|
}
|
|
|
|
gboolean
|
|
mm_modem_3gpp_register_sync (MMModem3gpp *self,
|
|
const gchar *network_id,
|
|
GCancellable *cancellable,
|
|
GError **error)
|
|
{
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), FALSE);
|
|
|
|
return mm_gdbus_modem3gpp_call_register_sync (self,
|
|
network_id,
|
|
cancellable,
|
|
error);
|
|
}
|
|
|
|
struct _MMModem3gppNetwork {
|
|
MMModem3gppNetworkAvailability availability;
|
|
gchar *operator_long;
|
|
gchar *operator_short;
|
|
gchar *operator_code;
|
|
MMModemAccessTechnology access_technology;
|
|
};
|
|
|
|
void
|
|
mm_modem_3gpp_network_free (MMModem3gppNetwork *network)
|
|
{
|
|
if (!network)
|
|
return;
|
|
|
|
g_free (network->operator_long);
|
|
g_free (network->operator_short);
|
|
g_free (network->operator_code);
|
|
g_slice_free (MMModem3gppNetwork, network);
|
|
}
|
|
|
|
MMModem3gppNetworkAvailability
|
|
mm_modem_3gpp_network_get_availability (const MMModem3gppNetwork *network)
|
|
{
|
|
g_return_val_if_fail (network != NULL, MM_MODEM_3GPP_NETWORK_AVAILABILITY_UNKNOWN);
|
|
|
|
return network->availability;
|
|
}
|
|
|
|
const gchar *
|
|
mm_modem_3gpp_network_get_operator_long (const MMModem3gppNetwork *network)
|
|
{
|
|
g_return_val_if_fail (network != NULL, NULL);
|
|
|
|
return network->operator_long;
|
|
}
|
|
|
|
const gchar *
|
|
mm_modem_3gpp_network_get_operator_short (const MMModem3gppNetwork *network)
|
|
{
|
|
g_return_val_if_fail (network != NULL, NULL);
|
|
|
|
return network->operator_short;
|
|
}
|
|
|
|
const gchar *
|
|
mm_modem_3gpp_network_get_operator_code (const MMModem3gppNetwork *network)
|
|
{
|
|
g_return_val_if_fail (network != NULL, NULL);
|
|
|
|
return network->operator_code;
|
|
}
|
|
|
|
MMModemAccessTechnology
|
|
mm_modem_3gpp_network_get_access_technology (const MMModem3gppNetwork *network)
|
|
{
|
|
g_return_val_if_fail (network != NULL, MM_MODEM_ACCESS_TECHNOLOGY_UNKNOWN);
|
|
|
|
return network->access_technology;
|
|
}
|
|
|
|
static GList *
|
|
create_networks_list (GVariant *variant)
|
|
{
|
|
GList *list = NULL;
|
|
GVariantIter dict_iter;
|
|
GVariant *dict;
|
|
|
|
/* Input is aa{sv} */
|
|
g_variant_iter_init (&dict_iter, variant);
|
|
while ((dict = g_variant_iter_next_value (&dict_iter))) {
|
|
GVariantIter iter;
|
|
gchar *key;
|
|
GVariant *value;
|
|
MMModem3gppNetwork *network;
|
|
|
|
network = g_slice_new0 (MMModem3gppNetwork);
|
|
|
|
g_variant_iter_init (&iter, dict);
|
|
while (g_variant_iter_next (&iter, "{sv}", &key, &value)) {
|
|
if (g_str_equal (key, "status")) {
|
|
network->availability = (MMModem3gppNetworkAvailability)g_variant_get_uint32 (value);
|
|
} else if (g_str_equal (key, "operator-long")) {
|
|
g_warn_if_fail (network->operator_long == NULL);
|
|
network->operator_long = g_variant_dup_string (value, NULL);
|
|
} else if (g_str_equal (key, "operator-short")) {
|
|
g_warn_if_fail (network->operator_short == NULL);
|
|
network->operator_short = g_variant_dup_string (value, NULL);
|
|
} else if (g_str_equal (key, "operator-code")) {
|
|
g_warn_if_fail (network->operator_code == NULL);
|
|
network->operator_code = g_variant_dup_string (value, NULL);
|
|
} else if (g_str_equal (key, "access-technology")) {
|
|
network->access_technology = (MMModemAccessTechnology)g_variant_get_uint32 (value);
|
|
} else
|
|
g_warning ("Unexpected property '%s' found in Network info", key);
|
|
|
|
g_free (key);
|
|
g_variant_unref (value);
|
|
}
|
|
|
|
list = g_list_prepend (list, network);
|
|
g_variant_unref (dict);
|
|
}
|
|
|
|
return list;
|
|
}
|
|
|
|
void
|
|
mm_modem_3gpp_scan (MMModem3gpp *self,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data)
|
|
{
|
|
g_return_if_fail (MM_GDBUS_IS_MODEM3GPP (self));
|
|
|
|
mm_gdbus_modem3gpp_call_scan (self,
|
|
cancellable,
|
|
callback,
|
|
user_data);
|
|
}
|
|
|
|
GList *
|
|
mm_modem_3gpp_scan_finish (MMModem3gpp *self,
|
|
GAsyncResult *res,
|
|
GError **error)
|
|
{
|
|
GVariant *result = NULL;
|
|
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), FALSE);
|
|
|
|
if (!mm_gdbus_modem3gpp_call_scan_finish (self,
|
|
&result,
|
|
res,
|
|
error))
|
|
return NULL;
|
|
|
|
return create_networks_list (result);
|
|
}
|
|
|
|
GList *
|
|
mm_modem_3gpp_scan_sync (MMModem3gpp *self,
|
|
GCancellable *cancellable,
|
|
GError **error)
|
|
{
|
|
GVariant *result = NULL;
|
|
|
|
g_return_val_if_fail (MM_GDBUS_IS_MODEM3GPP (self), FALSE);
|
|
|
|
if (!mm_gdbus_modem3gpp_call_scan_sync (self,
|
|
&result,
|
|
cancellable,
|
|
error))
|
|
return NULL;
|
|
|
|
return create_networks_list (result);
|
|
}
|