ATT Device Service: libmbim-glib Reference Manual

ATT Device Service

Types and Values

Description

Functions

mbim_atds_provider_array_free ()

void
mbim_atds_provider_array_free (MbimAtdsProvider **array);

Frees the memory allocated for the array of MbimAtdsProviders.

Parameters

array

a NULL terminated array of MbimAtdsProvider structs.

mbim_message_atds_signal_query_new ()

MbimMessage *
mbim_message_atds_signal_query_new (GError **error);

Create a new request for the 'Signal' query command in the 'ATDS' service.

Parameters

error

return location for error or NULL.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

mbim_message_atds_signal_response_parse ()

gboolean
mbim_message_atds_signal_response_parse
                               (const MbimMessage *message,
                                guint32 *rssi,
                                guint32 *error_rate,
                                guint32 *rscp,
                                guint32 *ecno,
                                guint32 *rsrq,
                                guint32 *rsrp,
                                guint32 *rssnr,
                                GError **error);

Parses and returns parameters of the 'Signal' response command in the 'ATDS' service.

Parameters

message	the MbimMessage.
rssi	return location for a guint32, or `NULL` if the 'Rssi' field is not needed.
error_rate	return location for a guint32, or `NULL` if the 'ErrorRate' field is not needed.
rscp	return location for a guint32, or `NULL` if the 'Rscp' field is not needed.
ecno	return location for a guint32, or `NULL` if the 'Ecno' field is not needed.
rsrq	return location for a guint32, or `NULL` if the 'Rsrq' field is not needed.
rsrp	return location for a guint32, or `NULL` if the 'Rsrp' field is not needed.
rssnr	return location for a guint32, or `NULL` if the 'Rssnr' field is not needed.
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

mbim_message_atds_location_query_new ()

MbimMessage *
mbim_message_atds_location_query_new (GError **error);

Create a new request for the 'Location' query command in the 'ATDS' service.

Parameters

error

return location for error or NULL.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

mbim_message_atds_location_response_parse ()

gboolean
mbim_message_atds_location_response_parse
                               (const MbimMessage *message,
                                guint32 *lac,
                                guint32 *tac,
                                guint32 *cell_id,
                                GError **error);

Parses and returns parameters of the 'Location' response command in the 'ATDS' service.

Parameters

message	the MbimMessage.
lac	return location for a guint32, or `NULL` if the 'Lac' field is not needed.
tac	return location for a guint32, or `NULL` if the 'Tac' field is not needed.
cell_id	return location for a guint32, or `NULL` if the 'CellId' field is not needed.
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

mbim_message_atds_operators_query_new ()

MbimMessage *
mbim_message_atds_operators_query_new (GError **error);

Create a new request for the 'Operators' query command in the 'ATDS' service.

Parameters

error

return location for error or NULL.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

mbim_message_atds_operators_response_parse ()

gboolean
mbim_message_atds_operators_response_parse
                               (const MbimMessage *message,
                                guint32 *providers_count,
                                MbimAtdsProvider ***providers,
                                GError **error);

Parses and returns parameters of the 'Operators' response command in the 'ATDS' service.

Parameters

message	the MbimMessage.
providers_count	return location for a guint32, or `NULL` if the 'ProvidersCount' field is not needed.
providers	return location for a newly allocated array of MbimAtdsProviders, or `NULL` if the 'Providers' field is not needed. Free the returned value with `mbim_atds_provider_array_free()`.
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

mbim_message_atds_rat_query_new ()

MbimMessage *
mbim_message_atds_rat_query_new (GError **error);

Create a new request for the 'RAT' query command in the 'ATDS' service.

Parameters

error

return location for error or NULL.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

mbim_message_atds_rat_set_new ()

MbimMessage *
mbim_message_atds_rat_set_new (MbimAtdsRatMode mode,
                               GError **error);

Create a new request for the 'RAT' set command in the 'ATDS' service.

Parameters

mode	the 'Mode' field, given as a MbimAtdsRatMode.
error	return location for error or `NULL`.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

mbim_message_atds_rat_response_parse ()

gboolean
mbim_message_atds_rat_response_parse (const MbimMessage *message,
                                      MbimAtdsRatMode *mode,
                                      GError **error);

Parses and returns parameters of the 'RAT' response command in the 'ATDS' service.

Parameters

message	the MbimMessage.
mode	return location for a MbimAtdsRatMode, or `NULL` if the 'Mode' field is not needed.
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

mbim_message_atds_register_state_query_new ()

MbimMessage *
mbim_message_atds_register_state_query_new
                               (GError **error);

Create a new request for the 'Register State' query command in the 'ATDS' service.

Parameters

error

return location for error or NULL.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

mbim_message_atds_register_state_response_parse ()

gboolean
mbim_message_atds_register_state_response_parse
                               (const MbimMessage *message,
                                MbimNwError *nw_error,
                                MbimRegisterState *register_state,
                                MbimRegisterMode *register_mode,
                                MbimDataClass *available_data_classes,
                                MbimCellularClass *current_cellular_class,
                                gchar **provider_id,
                                gchar **provider_name,
                                gchar **roaming_text,
                                MbimRegistrationFlag *registration_flag,
                                GError **error);

Parses and returns parameters of the 'Register State' response command in the 'ATDS' service.

Parameters

message	the MbimMessage.
nw_error	return location for a MbimNwError, or `NULL` if the 'NwError' field is not needed.
register_state	return location for a MbimRegisterState, or `NULL` if the 'RegisterState' field is not needed.
register_mode	return location for a MbimRegisterMode, or `NULL` if the 'RegisterMode' field is not needed.
available_data_classes	return location for a MbimDataClass, or `NULL` if the 'AvailableDataClasses' field is not needed.
current_cellular_class	return location for a MbimCellularClass, or `NULL` if the 'CurrentCellularClass' field is not needed.
provider_id	return location for a newly allocated string, or `NULL` if the 'ProviderId' field is not needed. Free the returned value with `g_free()`.
provider_name	return location for a newly allocated string, or `NULL` if the 'ProviderName' field is not needed. Free the returned value with `g_free()`.
roaming_text	return location for a newly allocated string, or `NULL` if the 'RoamingText' field is not needed. Free the returned value with `g_free()`.
registration_flag	return location for a MbimRegistrationFlag, or `NULL` if the 'RegistrationFlag' field is not needed.
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

Types and Values

MbimAtdsProvider

typedef struct {
    gchar *provider_id;
    guint32 provider_state;
    gchar *provider_name;
    guint32 plmn_mode;
    guint32 rssi;
    guint32 error_rate;
} MbimAtdsProvider;

Members

gchar *`provider_id`;	a string.
guint32 `provider_state`;	a guint32.
gchar *`provider_name`;	a string.
guint32 `plmn_mode`;	a guint32.
guint32 `rssi`;	a guint32.
guint32 `error_rate`;	a guint32.

void	mbim_atds_provider_array_free ()
MbimMessage *	mbim_message_atds_signal_query_new ()
gboolean	mbim_message_atds_signal_response_parse ()
MbimMessage *	mbim_message_atds_location_query_new ()
gboolean	mbim_message_atds_location_response_parse ()
MbimMessage *	mbim_message_atds_operators_query_new ()
gboolean	mbim_message_atds_operators_response_parse ()
MbimMessage *	mbim_message_atds_rat_query_new ()
MbimMessage *	mbim_message_atds_rat_set_new ()
gboolean	mbim_message_atds_rat_response_parse ()
MbimMessage *	mbim_message_atds_register_state_query_new ()
gboolean	mbim_message_atds_register_state_response_parse ()