ATDS

ATDS

Functions

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.