442 lines
11 KiB
C
442 lines
11 KiB
C
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
|
|
/*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program 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 General Public License for more details:
|
|
*
|
|
* Copyright (C) 2013 Aleksander Morgado <aleksander@gnu.org>
|
|
*/
|
|
|
|
#include <string.h>
|
|
#include <ctype.h>
|
|
#include <stdlib.h>
|
|
|
|
#include "mm-signal.h"
|
|
#include "mm-errors-types.h"
|
|
|
|
/**
|
|
* SECTION: mm-signal
|
|
* @title: MMSignal
|
|
* @short_description: Helper object to handle extended Signal information.
|
|
*
|
|
* The #MMSignal is an object handling the signal information of the
|
|
* modem.
|
|
*/
|
|
|
|
G_DEFINE_TYPE (MMSignal, mm_signal, G_TYPE_OBJECT)
|
|
|
|
#define PROPERTY_RSSI "rssi"
|
|
#define PROPERTY_ECIO "ecio"
|
|
#define PROPERTY_SINR "sinr"
|
|
#define PROPERTY_IO "io"
|
|
#define PROPERTY_RSRQ "rsrq"
|
|
#define PROPERTY_RSRP "rsrp"
|
|
#define PROPERTY_SNR "snr"
|
|
|
|
struct _MMSignalPrivate {
|
|
gdouble rssi;
|
|
gdouble ecio;
|
|
gdouble sinr;
|
|
gdouble io;
|
|
gdouble rsrq;
|
|
gdouble rsrp;
|
|
gdouble snr;
|
|
};
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_signal_get_rssi:
|
|
* @self: a #MMSignal.
|
|
*
|
|
* Gets the RSSI (Received Signal Strength Indication), in dBm.
|
|
*
|
|
* Returns: the RSSI, or %MM_SIGNAL_UNKNOWN if unknown.
|
|
*/
|
|
gdouble
|
|
mm_signal_get_rssi (MMSignal *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_SIGNAL (self), MM_SIGNAL_UNKNOWN);
|
|
|
|
return self->priv->rssi;
|
|
}
|
|
|
|
void
|
|
mm_signal_set_rssi (MMSignal *self,
|
|
gdouble value)
|
|
{
|
|
g_return_if_fail (MM_IS_SIGNAL (self));
|
|
|
|
self->priv->rssi = value;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_signal_get_ecio:
|
|
* @self: a #MMSignal.
|
|
*
|
|
* Gets the Ec/Io, in dB.
|
|
*
|
|
* Only applicable to CDMA1x, CDMA EV-DO and UMTS (WCDMA).
|
|
*
|
|
* Returns: the ECIO, or %MM_SIGNAL_UNKNOWN if unknown.
|
|
*/
|
|
gdouble
|
|
mm_signal_get_ecio (MMSignal *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_SIGNAL (self), MM_SIGNAL_UNKNOWN);
|
|
|
|
return self->priv->ecio;
|
|
}
|
|
|
|
void
|
|
mm_signal_set_ecio (MMSignal *self,
|
|
gdouble value)
|
|
{
|
|
g_return_if_fail (MM_IS_SIGNAL (self));
|
|
|
|
self->priv->ecio = value;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_signal_get_sinr:
|
|
* @self: a #MMSignal.
|
|
*
|
|
* Gets the SINR level, in dB.
|
|
*
|
|
* Only applicable to CDMA EV-DO.
|
|
*
|
|
* Returns: the SINR, or %MM_SIGNAL_UNKNOWN if unknown.
|
|
*/
|
|
gdouble
|
|
mm_signal_get_sinr (MMSignal *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_SIGNAL (self), MM_SIGNAL_UNKNOWN);
|
|
|
|
return self->priv->sinr;
|
|
}
|
|
|
|
void
|
|
mm_signal_set_sinr (MMSignal *self,
|
|
gdouble value)
|
|
{
|
|
g_return_if_fail (MM_IS_SIGNAL (self));
|
|
|
|
self->priv->sinr = value;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_signal_get_io:
|
|
* @self: a #MMSignal.
|
|
*
|
|
* Gets the Io, in dBm.
|
|
*
|
|
* Only applicable to CDMA EV-DO.
|
|
*
|
|
* Returns: the Io, or %MM_SIGNAL_UNKNOWN if unknown.
|
|
*/
|
|
gdouble
|
|
mm_signal_get_io (MMSignal *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_SIGNAL (self), MM_SIGNAL_UNKNOWN);
|
|
|
|
return self->priv->io;
|
|
}
|
|
|
|
void
|
|
mm_signal_set_io (MMSignal *self,
|
|
gdouble value)
|
|
{
|
|
g_return_if_fail (MM_IS_SIGNAL (self));
|
|
|
|
self->priv->io = value;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_signal_get_rsrp:
|
|
* @self: a #MMSignal.
|
|
*
|
|
* Gets the RSRP (Reference Signal Received Power), in dBm.
|
|
*
|
|
* Only applicable to LTE.
|
|
*
|
|
* Returns: the RSRP, or %MM_SIGNAL_UNKNOWN if unknown.
|
|
*/
|
|
gdouble
|
|
mm_signal_get_rsrp (MMSignal *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_SIGNAL (self), MM_SIGNAL_UNKNOWN);
|
|
|
|
return self->priv->rsrp;
|
|
}
|
|
|
|
void
|
|
mm_signal_set_rsrp (MMSignal *self,
|
|
gdouble value)
|
|
{
|
|
g_return_if_fail (MM_IS_SIGNAL (self));
|
|
|
|
self->priv->rsrp = value;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_signal_get_rsrq:
|
|
* @self: a #MMSignal.
|
|
*
|
|
* Gets the RSRQ (Reference Signal Received Quality), in dB.
|
|
*
|
|
* Only applicable to LTE.
|
|
*
|
|
* Returns: the RSRQ, or %MM_SIGNAL_UNKNOWN if unknown.
|
|
*/
|
|
gdouble
|
|
mm_signal_get_rsrq (MMSignal *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_SIGNAL (self), MM_SIGNAL_UNKNOWN);
|
|
|
|
return self->priv->rsrq;
|
|
}
|
|
|
|
void
|
|
mm_signal_set_rsrq (MMSignal *self,
|
|
gdouble value)
|
|
{
|
|
g_return_if_fail (MM_IS_SIGNAL (self));
|
|
|
|
self->priv->rsrq = value;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_signal_get_snr:
|
|
* @self: a #MMSignal.
|
|
*
|
|
* Gets the S/R ration, in dB.
|
|
*
|
|
* Only applicable to LTE.
|
|
*
|
|
* Returns: the S/R ratio, or %MM_SIGNAL_UNKNOWN if unknown.
|
|
*/
|
|
gdouble
|
|
mm_signal_get_snr (MMSignal *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_SIGNAL (self), MM_SIGNAL_UNKNOWN);
|
|
|
|
return self->priv->snr;
|
|
}
|
|
|
|
void
|
|
mm_signal_set_snr (MMSignal *self,
|
|
gdouble value)
|
|
{
|
|
g_return_if_fail (MM_IS_SIGNAL (self));
|
|
|
|
self->priv->snr = value;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_signal_get_dictionary:
|
|
* @self: A #MMSignal.
|
|
*
|
|
* Gets a variant dictionary with the contents of @self.
|
|
*
|
|
* Returns: (transfer full): A dictionary with the signal values. The returned value should be freed with g_variant_unref().
|
|
*/
|
|
GVariant *
|
|
mm_signal_get_dictionary (MMSignal *self)
|
|
{
|
|
GVariantBuilder builder;
|
|
|
|
/* We do allow NULL */
|
|
if (!self)
|
|
return NULL;
|
|
|
|
g_return_val_if_fail (MM_IS_SIGNAL (self), NULL);
|
|
|
|
g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{sv}"));
|
|
|
|
if (self->priv->rssi != MM_SIGNAL_UNKNOWN)
|
|
g_variant_builder_add (&builder,
|
|
"{sv}",
|
|
PROPERTY_RSSI,
|
|
g_variant_new_double (self->priv->rssi));
|
|
|
|
if (self->priv->ecio != MM_SIGNAL_UNKNOWN)
|
|
g_variant_builder_add (&builder,
|
|
"{sv}",
|
|
PROPERTY_ECIO,
|
|
g_variant_new_double (self->priv->ecio));
|
|
|
|
if (self->priv->sinr != MM_SIGNAL_UNKNOWN)
|
|
g_variant_builder_add (&builder,
|
|
"{sv}",
|
|
PROPERTY_SINR,
|
|
g_variant_new_double (self->priv->sinr));
|
|
|
|
if (self->priv->io != MM_SIGNAL_UNKNOWN)
|
|
g_variant_builder_add (&builder,
|
|
"{sv}",
|
|
PROPERTY_IO,
|
|
g_variant_new_double (self->priv->io));
|
|
|
|
if (self->priv->rsrp != MM_SIGNAL_UNKNOWN)
|
|
g_variant_builder_add (&builder,
|
|
"{sv}",
|
|
PROPERTY_RSRP,
|
|
g_variant_new_double (self->priv->rsrp));
|
|
|
|
if (self->priv->rsrq != MM_SIGNAL_UNKNOWN)
|
|
g_variant_builder_add (&builder,
|
|
"{sv}",
|
|
PROPERTY_RSRQ,
|
|
g_variant_new_double (self->priv->rsrq));
|
|
|
|
if (self->priv->snr != MM_SIGNAL_UNKNOWN)
|
|
g_variant_builder_add (&builder,
|
|
"{sv}",
|
|
PROPERTY_SNR,
|
|
g_variant_new_double (self->priv->snr));
|
|
|
|
return g_variant_ref_sink (g_variant_builder_end (&builder));
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
static gboolean
|
|
consume_variant (MMSignal *self,
|
|
const gchar *key,
|
|
GVariant *value,
|
|
GError **error)
|
|
{
|
|
if (g_str_equal (key, PROPERTY_RSSI))
|
|
self->priv->rssi = g_variant_get_double (value);
|
|
else if (g_str_equal (key, PROPERTY_ECIO))
|
|
self->priv->ecio = g_variant_get_double (value);
|
|
else if (g_str_equal (key, PROPERTY_SINR))
|
|
self->priv->sinr = g_variant_get_double (value);
|
|
else if (g_str_equal (key, PROPERTY_IO))
|
|
self->priv->io = g_variant_get_double (value);
|
|
else if (g_str_equal (key, PROPERTY_RSRP))
|
|
self->priv->rsrp = g_variant_get_double (value);
|
|
else if (g_str_equal (key, PROPERTY_RSRQ))
|
|
self->priv->rsrq = g_variant_get_double (value);
|
|
else if (g_str_equal (key, PROPERTY_SNR))
|
|
self->priv->snr = g_variant_get_double (value);
|
|
else {
|
|
/* Set error */
|
|
g_set_error (error,
|
|
MM_CORE_ERROR,
|
|
MM_CORE_ERROR_INVALID_ARGS,
|
|
"Invalid signal dictionary, unexpected key '%s'",
|
|
key);
|
|
return FALSE;
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* mm_signal_new_from_dictionary:
|
|
* @dictionary: A variant dictionary with the signal information.
|
|
* @error: Return location for error or %NULL.
|
|
*
|
|
* Creates a new #MMSignal object with the values exposed in
|
|
* the dictionary.
|
|
*
|
|
* Returns: (transfer full): A #MMSignal or %NULL if @error is set. The returned value should be freed with g_object_unref().
|
|
*/
|
|
MMSignal *
|
|
mm_signal_new_from_dictionary (GVariant *dictionary,
|
|
GError **error)
|
|
{
|
|
GError *inner_error = NULL;
|
|
GVariantIter iter;
|
|
gchar *key;
|
|
GVariant *value;
|
|
MMSignal *self = NULL;
|
|
|
|
if (!dictionary) {
|
|
g_set_error (error,
|
|
MM_CORE_ERROR,
|
|
MM_CORE_ERROR_INVALID_ARGS,
|
|
"Cannot create Signal info from empty dictionary");
|
|
return NULL;
|
|
}
|
|
|
|
if (!g_variant_is_of_type (dictionary, G_VARIANT_TYPE ("a{sv}"))) {
|
|
g_set_error (error,
|
|
MM_CORE_ERROR,
|
|
MM_CORE_ERROR_INVALID_ARGS,
|
|
"Cannot create Signal info from dictionary: "
|
|
"invalid variant type received");
|
|
return NULL;
|
|
}
|
|
|
|
g_variant_iter_init (&iter, dictionary);
|
|
while (!inner_error && g_variant_iter_next (&iter, "{sv}", &key, &value)) {
|
|
if (!self)
|
|
self = mm_signal_new ();
|
|
consume_variant (self,
|
|
key,
|
|
value,
|
|
&inner_error);
|
|
g_free (key);
|
|
g_variant_unref (value);
|
|
}
|
|
|
|
/* If error, destroy the object */
|
|
if (inner_error) {
|
|
g_propagate_error (error, inner_error);
|
|
g_clear_object (&self);
|
|
}
|
|
|
|
return self;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
MMSignal *
|
|
mm_signal_new (void)
|
|
{
|
|
return MM_SIGNAL (g_object_new (MM_TYPE_SIGNAL, NULL));
|
|
}
|
|
|
|
static void
|
|
mm_signal_init (MMSignal *self)
|
|
{
|
|
self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, MM_TYPE_SIGNAL, MMSignalPrivate);
|
|
self->priv->rssi = MM_SIGNAL_UNKNOWN;
|
|
self->priv->ecio = MM_SIGNAL_UNKNOWN;
|
|
self->priv->sinr = MM_SIGNAL_UNKNOWN;
|
|
self->priv->io = MM_SIGNAL_UNKNOWN;
|
|
self->priv->rsrq = MM_SIGNAL_UNKNOWN;
|
|
self->priv->rsrp = MM_SIGNAL_UNKNOWN;
|
|
self->priv->snr = MM_SIGNAL_UNKNOWN;
|
|
}
|
|
|
|
static void
|
|
mm_signal_class_init (MMSignalClass *klass)
|
|
{
|
|
GObjectClass *object_class = G_OBJECT_CLASS (klass);
|
|
|
|
g_type_class_add_private (object_class, sizeof (MMSignalPrivate));
|
|
}
|