Intel Thermal Rf service: libmbim-glib Reference Manual

Intel Thermal Rf service

Intel Thermal Rf service — Support for the Intel Thermal Rf service.

Functions

void	mbim_intel_rfim_frequency_value_array_free ()
MbimMessage *	mbim_message_intel_thermal_rf_rfim_query_new ()
MbimMessage *	mbim_message_intel_thermal_rf_rfim_set_new ()
gboolean	mbim_message_intel_thermal_rf_rfim_response_parse ()
gboolean	mbim_message_intel_thermal_rf_rfim_notification_parse ()

Types and Values

	MbimIntelRfimFrequencyValue
typedef	MbimIntelRfimFrequencyValueArray

Description

This section implements support for requests, responses and notifications in the Intel Thermal Rf service.

Functions

mbim_intel_rfim_frequency_value_array_free ()

void
mbim_intel_rfim_frequency_value_array_free
                               (MbimIntelRfimFrequencyValueArray *array);

Frees the memory allocated for the array of MbimIntelRfimFrequencyValue structs.

Parameters

array

a NULL terminated array of MbimIntelRfimFrequencyValue structs.

Since: 1.28

mbim_message_intel_thermal_rf_rfim_query_new ()

MbimMessage *
mbim_message_intel_thermal_rf_rfim_query_new
                               (GError **error);

Create a new request for the 'RFIM' query command in the 'Intel Thermal RF' service.

Parameters

error

return location for error or NULL.

Returns

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

Since: 1.28

mbim_message_intel_thermal_rf_rfim_set_new ()

MbimMessage *
mbim_message_intel_thermal_rf_rfim_set_new
                               (gboolean activation_state,
                                GError **error);

Create a new request for the 'RFIM' set command in the 'Intel Thermal RF' service.

Parameters

activation_state	the 'ActivationState' field, given as a gboolean.	[in]
error	return location for error or `NULL`.

Returns

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

Since: 1.28

mbim_message_intel_thermal_rf_rfim_response_parse ()

gboolean
mbim_message_intel_thermal_rf_rfim_response_parse
                               (const MbimMessage *message,
                                guint32 *out_rfim_frequency_values_count,
                                MbimIntelRfimFrequencyValueArray **out_rfim_frequency_values,
                                GError **error);

Parses and returns parameters of the 'RFIM' response command in the 'Intel Thermal RF' service.

Parameters

message	the MbimMessage.
out_rfim_frequency_values_count	return location for a guint32, or `NULL` if the 'RfimFrequencyValuesCount' field is not needed.	[out][optional][transfer none]
out_rfim_frequency_values	return location for a newly allocated array of MbimIntelRfimFrequencyValue items, or `NULL` if the 'RfimFrequencyValues' field is not needed. Free the returned value with `mbim_intel_rfim_frequency_value_array_free()`.	[out][optional][transfer full][array zero-terminated=1][element-type MbimIntelRfimFrequencyValue]
error	return location for error or `NULL`.

Returns

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

Since: 1.28

mbim_message_intel_thermal_rf_rfim_notification_parse ()

gboolean
mbim_message_intel_thermal_rf_rfim_notification_parse
                               (const MbimMessage *message,
                                guint32 *out_rfim_frequency_values_count,
                                MbimIntelRfimFrequencyValueArray **out_rfim_frequency_values,
                                GError **error);

Parses and returns parameters of the 'RFIM' notification command in the 'Intel Thermal RF' service.

Parameters

message	the MbimMessage.
out_rfim_frequency_values_count	return location for a guint32, or `NULL` if the 'RfimFrequencyValuesCount' field is not needed.	[out][optional][transfer none]
out_rfim_frequency_values	return location for a newly allocated array of MbimIntelRfimFrequencyValue items, or `NULL` if the 'RfimFrequencyValues' field is not needed. Free the returned value with `mbim_intel_rfim_frequency_value_array_free()`.	[out][optional][transfer full][array zero-terminated=1][element-type MbimIntelRfimFrequencyValue]
error	return location for error or `NULL`.

Returns

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

Since: 1.28

Types and Values

MbimIntelRfimFrequencyValue

typedef struct {
    guint32 serving_cell_info;
    guint64 center_frequency;
    guint32 bandwidth;
    guint32 rsrp;
    guint32 rsrq;
    guint32 sinr;
    guint32 rssi;
    guint32 connection_status;
} MbimIntelRfimFrequencyValue;

A MbimIntelRfimFrequencyValue element.

Members

guint32 `serving_cell_info`;	a MbimIntelServingCellInfo given as a guint32.
guint64 `center_frequency`;	a guint64.
guint32 `bandwidth`;	a guint32.
guint32 `rsrp`;	a guint32.
guint32 `rsrq`;	a guint32.
guint32 `sinr`;	a guint32.
guint32 `rssi`;	a guint32.
guint32 `connection_status`;	a gboolean given as a guint32.

Since: 1.28

MbimIntelRfimFrequencyValueArray

typedef MbimIntelRfimFrequencyValue *MbimIntelRfimFrequencyValueArray;

A NULL-terminated array of MbimIntelRfimFrequencyValue elements.

Since: 1.28