api,modem: new 'CarrierConfigurationRevision' property

Which reports the version of the currently active carrier
configuration.

We also update the firmware 'version' reported in the firmware
settings so that carrier-specific upgrades can be performed (e.g. when
the firmware stays the same but the MCFG is updated).
This commit is contained in:
Aleksander Morgado
2019-04-02 12:14:03 +02:00
parent c479d036f7
commit 52b67dc7c3
12 changed files with 128 additions and 38 deletions
+41
View File
@@ -543,6 +543,47 @@ mm_modem_dup_carrier_configuration (MMModem *self)
/*****************************************************************************/
/**
* mm_modem_get_carrier_configuration_revision:
* @self: A #MMModem.
*
* Gets the carrier-specific configuration revision in use, as reported by this #MMModem.
*
* <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_dup_carrier_configuration() if on another
* thread.</warning>
*
* Returns: (transfer none): The carrier configuration revision, or %NULL if none available. Do not free the returned value, it belongs to @self.
*/
const gchar *
mm_modem_get_carrier_configuration_revision (MMModem *self)
{
g_return_val_if_fail (MM_IS_MODEM (self), NULL);
RETURN_NON_EMPTY_CONSTANT_STRING (
mm_gdbus_modem_get_carrier_configuration_revision (MM_GDBUS_MODEM (self)));
}
/**
* mm_modem_dup_carrier_configuration_revision:
* @self: A #MMModem.
*
* Gets a copy of the carrier-specific configuration revision in use, as reported by this #MMModem.
*
* Returns: (transfer full): The carrier configuration revision, or %NULL if none available. The returned value should be freed with g_free().
*/
gchar *
mm_modem_dup_carrier_configuration_revision (MMModem *self)
{
g_return_val_if_fail (MM_IS_MODEM (self), NULL);
RETURN_NON_EMPTY_STRING (
mm_gdbus_modem_dup_carrier_configuration_revision (MM_GDBUS_MODEM (self)));
}
/*****************************************************************************/
/**
* mm_modem_get_hardware_revision:
* @self: A #MMModem.
+4 -2
View File
@@ -103,8 +103,10 @@ gchar *mm_modem_dup_model (MMModem *self);
const gchar *mm_modem_get_revision (MMModem *self);
gchar *mm_modem_dup_revision (MMModem *self);
const gchar *mm_modem_get_carrier_configuration (MMModem *self);
gchar *mm_modem_dup_carrier_configuration (MMModem *self);
const gchar *mm_modem_get_carrier_configuration (MMModem *self);
gchar *mm_modem_dup_carrier_configuration (MMModem *self);
const gchar *mm_modem_get_carrier_configuration_revision (MMModem *self);
gchar *mm_modem_dup_carrier_configuration_revision (MMModem *self);
const gchar *mm_modem_get_hardware_revision (MMModem *self);
gchar *mm_modem_dup_hardware_revision (MMModem *self);