path: root/libmm-glib/mm-cell-info-nr5g.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;

}