| Top |
MMModem3gpp implements GDBusInterface, GInitable, GAsyncInitable and MmGdbusModem3gpp.
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).
const gchar *
mm_modem_3gpp_network_get_operator_code
(const MMModem3gppNetwork *network);
Get the operator code (MCCMNC) of the 3GPP network.
const gchar *
mm_modem_3gpp_network_get_operator_short
(const MMModem3gppNetwork *network);
Get the short operator name of the 3GPP network.
const gchar *
mm_modem_3gpp_network_get_operator_long
(const MMModem3gppNetwork *network);
Get the long operator name of the 3GPP network.
MMModemAccessTechnology
mm_modem_3gpp_network_get_access_technology
(const MMModem3gppNetwork *network);
Get the technology used to access the 3GPP network.
MMModem3gppNetworkAvailability
mm_modem_3gpp_network_get_availability
(const MMModem3gppNetwork *network);
Get availability of the 3GPP network.
void
mm_modem_3gpp_network_free (MMModem3gppNetwork *network);
Frees a MMModem3gppNetwork.
const gchar *
mm_modem_3gpp_get_path (MMModem3gpp *self);
Gets the DBus path of the MMObject which implements this interface.
gchar *
mm_modem_3gpp_dup_path (MMModem3gpp *self);
Gets a copy of the DBus path of the MMObject object which implements this interface.
const gchar *
mm_modem_3gpp_get_imei (MMModem3gpp *self);
Gets the IMEI, as reported by this MMModem3gpp.
self was constructed. Use mm_modem_3gpp_dup_imei() if on another
thread.gchar *
mm_modem_3gpp_dup_imei (MMModem3gpp *self);
Gets a copy of the IMEI, as reported by this MMModem3gpp.
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.
self was constructed. Use mm_modem_3gpp_dup_operator_code() if on another
thread.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".
const gchar *
mm_modem_3gpp_get_operator_name (MMModem3gpp *self);
Gets the name of the operator to which the mobile is currently registered.
self was constructed. Use mm_modem_3gpp_dup_operator_name() if on another
thread.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.
MMModem3gppFacility
mm_modem_3gpp_get_enabled_facility_locks
(MMModem3gpp *self);
Get the list of facilities for which PIN locking is enabled.
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.
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.
MMModem3gppEpsUeModeOperation
mm_modem_3gpp_get_eps_ue_mode_operation
(MMModem3gpp *self);
Get the UE mode of operation for EPS.
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.
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 |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
gboolean mm_modem_3gpp_register_finish (MMModem3gpp *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_3gpp_register().
self |
A MMModem3gpp. |
|
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
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.
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 |
[allow-none] |
error |
Return location for error or |
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.
self |
A MMModem3gpp. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
GList * mm_modem_3gpp_scan_finish (MMModem3gpp *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_3gpp_scan().
self |
A MMModem3gpp. |
|
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
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]
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.
self |
A MMModem3gpp. |
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
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]
void mm_modem_3gpp_set_eps_ue_mode_operation (MMModem3gpp *self,MMModem3gppEpsUeModeOperation mode,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
gboolean mm_modem_3gpp_set_eps_ue_mode_operation_finish (MMModem3gpp *self,GAsyncResult *res,GError **error);
gboolean mm_modem_3gpp_set_eps_ue_mode_operation_sync (MMModem3gpp *self,MMModem3gppEpsUeModeOperation mode,GCancellable *cancellable,GError **error);
struct MMModem3gpp;
The MMModem3gpp structure contains private data and should only be accessed using the provided API.
typedef struct _MMModem3gppNetwork MMModem3gppNetwork;
The MMModem3gppNetwork structure contains private data and should only be accessed using the provided API.