MMModem3gpp: libmm-glib Reference Manual

MMModem3gpp

MMModem3gpp — The 3GPP interface

Functions

const gchar *	mm_modem_3gpp_network_get_operator_code ()
const gchar *	mm_modem_3gpp_network_get_operator_short ()
const gchar *	mm_modem_3gpp_network_get_operator_long ()
MMModemAccessTechnology	mm_modem_3gpp_network_get_access_technology ()
MMModem3gppNetworkAvailability	mm_modem_3gpp_network_get_availability ()
void	mm_modem_3gpp_network_free ()
const gchar *	mm_modem_3gpp_get_path ()
gchar *	mm_modem_3gpp_dup_path ()
const gchar *	mm_modem_3gpp_get_imei ()
gchar *	mm_modem_3gpp_dup_imei ()
const gchar *	mm_modem_3gpp_get_operator_code ()
gchar *	mm_modem_3gpp_dup_operator_code ()
const gchar *	mm_modem_3gpp_get_operator_name ()
gchar *	mm_modem_3gpp_dup_operator_name ()
MMModem3gppFacility	mm_modem_3gpp_get_enabled_facility_locks ()
MMModem3gppRegistrationState	mm_modem_3gpp_get_registration_state ()
MMModem3gppSubscriptionState	mm_modem_3gpp_get_subscription_state ()
void	mm_modem_3gpp_register ()
gboolean	mm_modem_3gpp_register_finish ()
gboolean	mm_modem_3gpp_register_sync ()
void	mm_modem_3gpp_scan ()
GList *	mm_modem_3gpp_scan_finish ()
GList *	mm_modem_3gpp_scan_sync ()

Types and Values

struct	MMModem3gpp
	MMModem3gppNetwork

Object Hierarchy

    GObject
    ╰── GDBusProxy
        ╰── MmGdbusModem3gppProxy
            ╰── MMModem3gpp

Implemented Interfaces

MMModem3gpp implements GDBusInterface, GInitable, GAsyncInitable and MmGdbusModem3gpp.

Description

The MMModem3gpp is an object providing access to the methods, signals and properties of the 3GPP interface.

The 3GPP interface is exposed whenever a modem has any of the 3GPP capabilities (MM_MODEM_CAPABILITY_GSM_UMTS, MM_MODEM_CAPABILITY_LTE or MM_MODEM_CAPABILITY_LTE_ADVANCED).

Functions

mm_modem_3gpp_network_get_operator_code ()

const gchar *
mm_modem_3gpp_network_get_operator_code
                               (const MMModem3gppNetwork *network);

Get the operator code (MCCMNC) of the 3GPP network.

Parameters

network

A MMModem3gppNetwork.

Returns

The operator code, or NULL if none available.

[transfer none]

mm_modem_3gpp_network_get_operator_short ()

const gchar *
mm_modem_3gpp_network_get_operator_short
                               (const MMModem3gppNetwork *network);

Get the short operator name of the 3GPP network.

Parameters

network

A MMModem3gppNetwork.

Returns

The long operator name, or NULL if none available.

[transfer none]

mm_modem_3gpp_network_get_operator_long ()

const gchar *
mm_modem_3gpp_network_get_operator_long
                               (const MMModem3gppNetwork *network);

Get the long operator name of the 3GPP network.

Parameters

network

A MMModem3gppNetwork.

Returns

The long operator name, or NULL if none available.

[transfer none]

mm_modem_3gpp_network_get_access_technology ()

MMModemAccessTechnology
mm_modem_3gpp_network_get_access_technology
                               (const MMModem3gppNetwork *network);

Get the technology used to access the 3GPP network.

Parameters

network

A MMModem3gppNetwork.

Returns

A MMModemAccessTechnology.

mm_modem_3gpp_network_get_availability ()

MMModem3gppNetworkAvailability
mm_modem_3gpp_network_get_availability
                               (const MMModem3gppNetwork *network);

Get availability of the 3GPP network.

Parameters

network

A MMModem3gppNetwork.

Returns

A MMModem3gppNetworkAvailability.

mm_modem_3gpp_network_free ()

void
mm_modem_3gpp_network_free (MMModem3gppNetwork *network);

Frees a MMModem3gppNetwork.

Parameters

network

A MMModem3gppNetwork.

mm_modem_3gpp_get_path ()

const gchar *
mm_modem_3gpp_get_path (MMModem3gpp *self);

Gets the DBus path of the MMObject which implements this interface.

Parameters

self

A MMModem3gpp.

Returns

The DBus path of the MMObject object.

[transfer none]

mm_modem_3gpp_dup_path ()

gchar *
mm_modem_3gpp_dup_path (MMModem3gpp *self);

Gets a copy of the DBus path of the MMObject object which implements this interface.

Parameters

self

A MMModem3gpp.

Returns

The DBus path of the MMObject. The returned value should be freed with g_free().

[transfer full]

mm_modem_3gpp_get_imei ()

const gchar *
mm_modem_3gpp_get_imei (MMModem3gpp *self);

Gets the IMEI, as reported by this MMModem3gpp.

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_3gpp_dup_imei() if on another thread.

Parameters

self

A MMModem3gpp.

Returns

The IMEI, or NULL if none available.

[transfer none]

mm_modem_3gpp_dup_imei ()

gchar *
mm_modem_3gpp_dup_imei (MMModem3gpp *self);

Gets a copy of the IMEI, as reported by this MMModem3gpp.

Parameters

self

A MMModem3gpp.

Returns

The IMEI, or NULL if none available. The returned value should be freed with g_free().

[transfer full]

mm_modem_3gpp_get_operator_code ()

const gchar *
mm_modem_3gpp_get_operator_code (MMModem3gpp *self);

Gets the code of the operator to which the mobile is currently registered.

Returned in the format "MCCMNC", where MCC is the three-digit ITU E.212 Mobile Country Code and MNC is the two- or three-digit GSM Mobile Network Code. e.g. e"31026" or "310260".

If the MCC and MNC are not known or the mobile is not registered to a mobile network, this property will be a zero-length (blank) string.

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_3gpp_dup_operator_code() if on another thread.

Parameters

self

A MMModem3gpp.

Returns

The operator code, or NULL if none available.

[transfer none]

mm_modem_3gpp_dup_operator_code ()

gchar *
mm_modem_3gpp_dup_operator_code (MMModem3gpp *self);

Gets a copy of the code of the operator to which the mobile is currently registered.

Returned in the format "MCCMNC", where MCC is the three-digit ITU E.212 Mobile Country Code and MNC is the two- or three-digit GSM Mobile Network Code. e.g. e"31026" or "310260".

Parameters

self

A MMModem3gpp.

Returns

The operator code, or NULL if none available. The returned value should be freed with g_free().

[transfer full]

mm_modem_3gpp_get_operator_name ()

const gchar *
mm_modem_3gpp_get_operator_name (MMModem3gpp *self);

Gets the name of the operator to which the mobile is currently registered.

Parameters

self

A MMModem3gpp.

Returns

The operator name, or NULL if none available.

[transfer none]

mm_modem_3gpp_dup_operator_name ()

gchar *
mm_modem_3gpp_dup_operator_name (MMModem3gpp *self);

Gets a copy of the name of the operator to which the mobile is currently registered.

Parameters

self

A MMModem3gpp.

Returns

The operator name, or NULL if none available. The returned value should be freed with g_free().

[transfer full]

mm_modem_3gpp_get_enabled_facility_locks ()

MMModem3gppFacility
mm_modem_3gpp_get_enabled_facility_locks
                               (MMModem3gpp *self);

Get the list of facilities for which PIN locking is enabled.

Parameters

self

A MMModem3gpp.

Returns

A bitmask of MMModem3gppFacility flags, specifying which facilities have locks enabled.

mm_modem_3gpp_get_registration_state ()

MMModem3gppRegistrationState
mm_modem_3gpp_get_registration_state (MMModem3gpp *self);

Get the the mobile registration status as defined in 3GPP TS 27.007 section 10.1.19.

Parameters

self

A MMModem.

Returns

A MMModem3gppRegistrationState value, specifying the current registration state.

mm_modem_3gpp_get_subscription_state ()

MMModem3gppSubscriptionState
mm_modem_3gpp_get_subscription_state (MMModem3gpp *self);

Get the current subscription status of the account. This value is only available after the modem attempts to register with the network.

Parameters

self

A MMModem.

Returns

A MMModem3gppSubscriptionState value, specifying the current subscription state.

mm_modem_3gpp_register ()

void
mm_modem_3gpp_register (MMModem3gpp *self,
                        const gchar *network_id,
                        GCancellable *cancellable,
                        GAsyncReadyCallback callback,
                        gpointer user_data);

Asynchronously requests registration with a given mobile network.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call mm_modem_3gpp_register_finish() to get the result of the operation.

See mm_modem_3gpp_register_sync() for the synchronous, blocking version of this method.

Parameters

self	A MMModem3gpp.
network_id	The operator ID to register. An empty string can be used to register to the home network.
cancellable	A GCancellable or `NULL`.	[allow-none]
callback	A GAsyncReadyCallback to call when the request is satisfied or `NULL`.
user_data	User data to pass to `callback` .

mm_modem_3gpp_register_finish ()

gboolean
mm_modem_3gpp_register_finish (MMModem3gpp *self,
                               GAsyncResult *res,
                               GError **error);

Finishes an operation started with mm_modem_3gpp_register().

Parameters

self	A MMModem3gpp.
res	The GAsyncResult obtained from the GAsyncReadyCallback passed to `mm_modem_3gpp_register()`.
error	Return location for error or `NULL`.

Returns

TRUE if the modem was registered, FALSE if error is set.

mm_modem_3gpp_register_sync ()

gboolean
mm_modem_3gpp_register_sync (MMModem3gpp *self,
                             const gchar *network_id,
                             GCancellable *cancellable,
                             GError **error);

Synchronously requests registration with a given mobile network.

The calling thread is blocked until a reply is received. See mm_modem_3gpp_register() for the asynchronous version of this method.

Parameters

self	A MMModem3gpp.
network_id	The operator ID to register. An empty string can be used to register to the home network.
cancellable	A GCancellable or `NULL`.	[allow-none]
error	Return location for error or `NULL`.

Returns

TRUE if the modem was registered, FALSE if error is set.

mm_modem_3gpp_scan ()

void
mm_modem_3gpp_scan (MMModem3gpp *self,
                    GCancellable *cancellable,
                    GAsyncReadyCallback callback,
                    gpointer user_data);

Asynchronously requests to scan available 3GPP networks.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call mm_modem_3gpp_scan_finish() to get the result of the operation.

See mm_modem_3gpp_scan_sync() for the synchronous, blocking version of this method.

Parameters

self	A MMModem3gpp.
cancellable	A GCancellable or `NULL`.	[allow-none]
callback	A GAsyncReadyCallback to call when the request is satisfied or `NULL`.
user_data	User data to pass to `callback` .

mm_modem_3gpp_scan_finish ()

GList *
mm_modem_3gpp_scan_finish (MMModem3gpp *self,
                           GAsyncResult *res,
                           GError **error);

Finishes an operation started with mm_modem_3gpp_scan().

Parameters

self	A MMModem3gpp.
res	The GAsyncResult obtained from the GAsyncReadyCallback passed to `mm_modem_3gpp_scan()`.
error	Return location for error or `NULL`.

Returns

a list of MMModem3gppNetwork structs, or NULL if error is set. The returned value should be freed with g_list_free_full() using mm_modem_3gpp_network_free() as GDestroyNotify function.

[transfer full][element-type ModemManager.Modem3gppNetwork]

mm_modem_3gpp_scan_sync ()

GList *
mm_modem_3gpp_scan_sync (MMModem3gpp *self,
                         GCancellable *cancellable,
                         GError **error);

Synchronously requests to scan available 3GPP networks.

The calling thread is blocked until a reply is received. See mm_modem_3gpp_scan() for the asynchronous version of this method.

Parameters

self	A MMModem3gpp.
cancellable	A GCancellable or `NULL`.	[allow-none]
error	Return location for error or `NULL`.

Returns

a list of MMModem3gppNetwork structs, or NULL if error is set. The returned value should be freed with g_list_free_full() using mm_modem_3gpp_network_free() as GDestroyNotify function.

[transfer full][element-type ModemManager.Modem3gppNetwork]

Types and Values

struct MMModem3gpp

struct MMModem3gpp;

The MMModem3gpp structure contains private data and should only be accessed using the provided API.

MMModem3gppNetwork

typedef struct _MMModem3gppNetwork MMModem3gppNetwork;

The MMModem3gppNetwork structure contains private data and should only be accessed using the provided API.