e8d63c1743
adding bandwidth information in mm-dbus interface for the serving cell. In serving cell, the details on whether the pcell/scell are from MCS or SCG is also updated. Co-author: Shilpa Shivakumar
513 lines
14 KiB
C
513 lines
14 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) 2022 Aleksander Morgado <aleksander@aleksander.es>
|
|
*/
|
|
|
|
#include "mm-helpers.h"
|
|
#include "mm-cell-info-nr5g.h"
|
|
|
|
/**
|
|
* SECTION: mm-cell-info-nr5g
|
|
* @title: MMCellInfoNr5g
|
|
* @short_description: Helper object to report 5GNR cell info
|
|
*
|
|
* The #MMCellInfoNr5g is an object used to report 5GNR cell
|
|
* information.
|
|
*
|
|
* The object inherits from the generic #MMCellInfo.
|
|
*/
|
|
|
|
G_DEFINE_TYPE (MMCellInfoNr5g, mm_cell_info_nr5g, MM_TYPE_CELL_INFO)
|
|
|
|
#define PROPERTY_OPERATOR_ID "operator-id"
|
|
#define PROPERTY_TAC "tac"
|
|
#define PROPERTY_CI "ci"
|
|
#define PROPERTY_PHYSICAL_CI "physical-ci"
|
|
#define PROPERTY_NRARFCN "nrarfcn"
|
|
#define PROPERTY_RSRP "rsrp"
|
|
#define PROPERTY_RSRQ "rsrq"
|
|
#define PROPERTY_SINR "sinr"
|
|
#define PROPERTY_TIMING_ADVANCE "timing-advance"
|
|
#define PROPERTY_SERVING_CELL_TYPE "serving-cell-type"
|
|
#define PROPERTY_BANDWIDTH "bandwidth"
|
|
|
|
|
|
struct _MMCellInfoNr5gPrivate {
|
|
gchar *operator_id;
|
|
gchar *tac;
|
|
gchar *ci;
|
|
gchar *physical_ci;
|
|
guint nrarfcn;
|
|
gdouble rsrp;
|
|
gdouble rsrq;
|
|
gdouble sinr;
|
|
guint timing_advance;
|
|
guint serving_cell_type;
|
|
guint bandwidth;
|
|
};
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_operator_id:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the PLMN MCC/MNC.
|
|
*
|
|
* Returns: (transfer none): the MCCMNC, or %NULL if not available.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
const gchar *
|
|
mm_cell_info_nr5g_get_operator_id (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_CONSTANT_STRING (self->priv->operator_id);
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_operator_id: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_operator_id (MMCellInfoNr5g *self,
|
|
const gchar *operator_id)
|
|
{
|
|
g_free (self->priv->operator_id);
|
|
self->priv->operator_id = g_strdup (operator_id);
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_tac:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the two- or three- byte Tracking Area Code of the base station.
|
|
*
|
|
* Encoded in upper-case hexadecimal format without leading zeros,
|
|
* as specified in 3GPP TS 27.007.
|
|
*
|
|
* Returns: (transfer none): the MCCMNC, or %NULL if not available.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
const gchar *
|
|
mm_cell_info_nr5g_get_tac (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_CONSTANT_STRING (self->priv->tac);
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_tac: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_tac (MMCellInfoNr5g *self,
|
|
const gchar *tac)
|
|
{
|
|
g_free (self->priv->tac);
|
|
self->priv->tac = g_strdup (tac);
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_ci:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the two- or four-byte Cell Identifier.
|
|
*
|
|
* Encoded in upper-case hexadecimal format without leading zeros,
|
|
* as specified in 3GPP TS 27.007.
|
|
*
|
|
* Returns: (transfer none): the MCCMNC, or %NULL if not available.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
const gchar *
|
|
mm_cell_info_nr5g_get_ci (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_CONSTANT_STRING (self->priv->ci);
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_ci: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_ci (MMCellInfoNr5g *self,
|
|
const gchar *ci)
|
|
{
|
|
g_free (self->priv->ci);
|
|
self->priv->ci = g_strdup (ci);
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_physical_ci:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the physical cell identifier.
|
|
*
|
|
* Encoded in upper-case hexadecimal format without leading zeros,
|
|
* as specified in 3GPP TS 27.007.
|
|
*
|
|
* Returns: (transfer none): the MCCMNC, or %NULL if not available.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
const gchar *
|
|
mm_cell_info_nr5g_get_physical_ci (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), NULL);
|
|
|
|
RETURN_NON_EMPTY_CONSTANT_STRING (self->priv->physical_ci);
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_physical_ci: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_physical_ci (MMCellInfoNr5g *self,
|
|
const gchar *physical_ci)
|
|
{
|
|
g_free (self->priv->physical_ci);
|
|
self->priv->physical_ci = g_strdup (physical_ci);
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_nrarfcn:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the NR absolute RF channel number.
|
|
*
|
|
* Returns: the NRARFCN, or %G_MAXUINT if not available.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
guint
|
|
mm_cell_info_nr5g_get_nrarfcn (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), G_MAXUINT);
|
|
|
|
return self->priv->nrarfcn;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_nrarfcn: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_nrarfcn (MMCellInfoNr5g *self,
|
|
guint nrarfcn)
|
|
{
|
|
self->priv->nrarfcn = nrarfcn;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_rsrp:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the average reference signal received power in dBm.
|
|
*
|
|
* Returns: the RSRP, or -%G_MAXDOUBLE if not available.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
gdouble
|
|
mm_cell_info_nr5g_get_rsrp (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), -G_MAXDOUBLE);
|
|
|
|
return self->priv->rsrp;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_rsrp: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_rsrp (MMCellInfoNr5g *self,
|
|
gdouble rsrp)
|
|
{
|
|
self->priv->rsrp = rsrp;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_rsrq:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the average reference signal received quality in dB.
|
|
*
|
|
* Returns: the RSRQ, or -%G_MAXDOUBLE if not available.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
gdouble
|
|
mm_cell_info_nr5g_get_rsrq (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), -G_MAXDOUBLE);
|
|
|
|
return self->priv->rsrq;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_rsrq: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_rsrq (MMCellInfoNr5g *self,
|
|
gdouble rsrq)
|
|
{
|
|
self->priv->rsrq = rsrq;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_sinr:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the signal to interference and noise ratio.
|
|
*
|
|
* Returns: the SINR, or -%G_MAXDOUBLE if not available.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
gdouble
|
|
mm_cell_info_nr5g_get_sinr (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), -G_MAXDOUBLE);
|
|
|
|
return self->priv->sinr;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_sinr: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_sinr (MMCellInfoNr5g *self,
|
|
gdouble sinr)
|
|
{
|
|
self->priv->sinr = sinr;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_timing_advance:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the timing advance.
|
|
*
|
|
* Returns: the timing advance, or %G_MAXUINT if not available.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
guint
|
|
mm_cell_info_nr5g_get_timing_advance (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), G_MAXUINT);
|
|
|
|
return self->priv->timing_advance;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_timing_advance: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_timing_advance (MMCellInfoNr5g *self,
|
|
guint timing_advance)
|
|
{
|
|
self->priv->timing_advance = timing_advance;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_serving_cell_type:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the serving cell type.
|
|
*
|
|
* Returns: the serving cell type, or %MM_SERVING_CELL_TYPE_INVALID if not available.
|
|
*
|
|
* Since: 1.22
|
|
*/
|
|
MMServingCellType
|
|
mm_cell_info_nr5g_get_serving_cell_type (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), MM_SERVING_CELL_TYPE_INVALID);
|
|
|
|
return self->priv->serving_cell_type;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_serving_cell_type: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_serving_cell_type (MMCellInfoNr5g *self,
|
|
MMServingCellType cell_type)
|
|
{
|
|
self->priv->serving_cell_type = cell_type;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_bandwidth:
|
|
* @self: a #MMCellInfoNr5g.
|
|
*
|
|
* Get the bandwidth of the particular carrier in downlink.
|
|
*
|
|
* Returns: the bandwidth, or %G_MAXUINT if not available.
|
|
*
|
|
* Since: 1.22
|
|
*/
|
|
guint
|
|
mm_cell_info_nr5g_get_bandwidth (MMCellInfoNr5g *self)
|
|
{
|
|
g_return_val_if_fail (MM_IS_CELL_INFO_NR5G (self), G_MAXUINT);
|
|
|
|
return self->priv->bandwidth;
|
|
}
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_set_bandwidth: (skip)
|
|
*/
|
|
void
|
|
mm_cell_info_nr5g_set_bandwidth (MMCellInfoNr5g *self,
|
|
guint bandwidth)
|
|
{
|
|
self->priv->bandwidth = bandwidth;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
static GString *
|
|
build_string (MMCellInfo *_self)
|
|
{
|
|
MMCellInfoNr5g *self = MM_CELL_INFO_NR5G (_self);
|
|
GString *str;
|
|
|
|
str = g_string_new (NULL);
|
|
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("operator id", "%s", operator_id, NULL);
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("tac", "%s", tac, NULL);
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("ci", "%s", ci, NULL);
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("physical ci", "%s", physical_ci, NULL);
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("nrarfcn", "%u", nrarfcn, G_MAXUINT);
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("rsrp", "%lf", rsrp, -G_MAXDOUBLE);
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("rsrq", "%lf", rsrq, -G_MAXDOUBLE);
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("sinr", "%lf", sinr, -G_MAXDOUBLE);
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("timing advance", "%u", timing_advance, G_MAXUINT);
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("serving cell type", "%u", serving_cell_type, MM_SERVING_CELL_TYPE_INVALID);
|
|
MM_CELL_INFO_BUILD_STRING_APPEND ("bandwidth", "%u", bandwidth, G_MAXUINT);
|
|
|
|
return str;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_get_dictionary: (skip)
|
|
*/
|
|
static GVariantDict *
|
|
get_dictionary (MMCellInfo *_self)
|
|
{
|
|
MMCellInfoNr5g *self = MM_CELL_INFO_NR5G (_self);
|
|
GVariantDict *dict;
|
|
|
|
dict = g_variant_dict_new (NULL);
|
|
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (OPERATOR_ID, operator_id, string, NULL);
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (TAC, tac, string, NULL);
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (CI, ci, string, NULL);
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (PHYSICAL_CI, physical_ci, string, NULL);
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (NRARFCN, nrarfcn, uint32, G_MAXUINT);
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (RSRP, rsrp, double, -G_MAXDOUBLE);
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (RSRQ, rsrq, double, -G_MAXDOUBLE);
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (SINR, sinr, double, -G_MAXDOUBLE);
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (TIMING_ADVANCE, timing_advance, uint32, G_MAXUINT);
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (SERVING_CELL_TYPE, serving_cell_type, uint32, MM_SERVING_CELL_TYPE_INVALID);
|
|
MM_CELL_INFO_GET_DICTIONARY_INSERT (BANDWIDTH, bandwidth, uint32, G_MAXUINT);
|
|
|
|
return dict;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* mm_cell_info_nr5g_new_from_dictionary: (skip)
|
|
*/
|
|
MMCellInfo *
|
|
mm_cell_info_nr5g_new_from_dictionary (GVariantDict *dict)
|
|
{
|
|
MMCellInfoNr5g *self;
|
|
|
|
self = MM_CELL_INFO_NR5G (g_object_new (MM_TYPE_CELL_INFO_NR5G, NULL));
|
|
|
|
if (dict) {
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_STRING_SET (nr5g, OPERATOR_ID, operator_id);
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_STRING_SET (nr5g, TAC, tac);
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_STRING_SET (nr5g, CI, ci);
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_STRING_SET (nr5g, PHYSICAL_CI, physical_ci);
|
|
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_NUM_SET (nr5g, NRARFCN, nrarfcn, UINT32, uint32);
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_NUM_SET (nr5g, RSRP, rsrp, DOUBLE, double);
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_NUM_SET (nr5g, RSRQ, rsrq, DOUBLE, double);
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_NUM_SET (nr5g, SINR, sinr, DOUBLE, double);
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_NUM_SET (nr5g, TIMING_ADVANCE, timing_advance, UINT32, uint32);
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_NUM_SET (nr5g, SERVING_CELL_TYPE, serving_cell_type, UINT32, uint32);
|
|
MM_CELL_INFO_NEW_FROM_DICTIONARY_NUM_SET (nr5g, BANDWIDTH, bandwidth, UINT32, uint32);
|
|
}
|
|
|
|
return MM_CELL_INFO (self);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
static void
|
|
mm_cell_info_nr5g_init (MMCellInfoNr5g *self)
|
|
{
|
|
self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, MM_TYPE_CELL_INFO_NR5G, MMCellInfoNr5gPrivate);
|
|
self->priv->nrarfcn = G_MAXUINT;
|
|
self->priv->rsrp = -G_MAXDOUBLE;
|
|
self->priv->rsrq = -G_MAXDOUBLE;
|
|
self->priv->sinr = -G_MAXDOUBLE;
|
|
self->priv->timing_advance = G_MAXUINT;
|
|
self->priv->serving_cell_type = MM_SERVING_CELL_TYPE_INVALID;
|
|
self->priv->bandwidth = G_MAXUINT;
|
|
}
|
|
|
|
static void
|
|
finalize (GObject *object)
|
|
{
|
|
MMCellInfoNr5g *self = MM_CELL_INFO_NR5G (object);
|
|
|
|
g_free (self->priv->operator_id);
|
|
g_free (self->priv->tac);
|
|
g_free (self->priv->ci);
|
|
g_free (self->priv->physical_ci);
|
|
|
|
G_OBJECT_CLASS (mm_cell_info_nr5g_parent_class)->finalize (object);
|
|
}
|
|
|
|
static void
|
|
mm_cell_info_nr5g_class_init (MMCellInfoNr5gClass *klass)
|
|
{
|
|
GObjectClass *object_class = G_OBJECT_CLASS (klass);
|
|
MMCellInfoClass *cell_info_class = MM_CELL_INFO_CLASS (klass);
|
|
|
|
g_type_class_add_private (object_class, sizeof (MMCellInfoNr5gPrivate));
|
|
|
|
object_class->finalize = finalize;
|
|
cell_info_class->get_dictionary = get_dictionary;
|
|
cell_info_class->build_string = build_string;
|
|
|
|
}
|