From 51631244ece5fa3033435c72a518bed0b3040f51 Mon Sep 17 00:00:00 2001 From: Aleksander Morgado Date: Fri, 10 Feb 2017 13:39:52 +0100 Subject: docs: update enums, flags and errors documentation --- build-aux/templates/qmi-enum-types-template.c | 17 - build-aux/templates/qmi-enum-types-template.h | 17 + build-aux/templates/qmi-error-types-template.h | 9 + build-aux/templates/qmi-flags64-types-template.c | 9 - build-aux/templates/qmi-flags64-types-template.h | 9 + src/libqmi-glib/qmi-enums-dms.h | 135 +++++++ src/libqmi-glib/qmi-enums-nas.h | 336 ++++++++++++++++- src/libqmi-glib/qmi-enums-oma.h | 32 ++ src/libqmi-glib/qmi-enums-pbm.h | 24 ++ src/libqmi-glib/qmi-enums-pdc.h | 7 + src/libqmi-glib/qmi-enums-pds.h | 48 +++ src/libqmi-glib/qmi-enums-uim.h | 96 +++++ src/libqmi-glib/qmi-enums-voice.h | 87 +++++ src/libqmi-glib/qmi-enums-wda.h | 16 + src/libqmi-glib/qmi-enums-wds.h | 455 +++++++++++++++++++++-- src/libqmi-glib/qmi-enums-wms.h | 138 ++++++- src/libqmi-glib/qmi-enums.h | 60 +-- src/libqmi-glib/qmi-errors.h | 98 +++-- src/libqmi-glib/qmi-flags64-dms.h | 12 + src/libqmi-glib/qmi-flags64-nas.h | 16 + 20 files changed, 1496 insertions(+), 125 deletions(-) diff --git a/build-aux/templates/qmi-enum-types-template.c b/build-aux/templates/qmi-enum-types-template.c index 635147f..a5c134d 100644 --- a/build-aux/templates/qmi-enum-types-template.c +++ b/build-aux/templates/qmi-enum-types-template.c @@ -37,14 +37,6 @@ GType * We get the nick of the GEnumValue. Note that this will be * valid even if the GEnumClass is not referenced anywhere. */ #if defined __@ENUMNAME@_IS_ENUM__ -/** - * @enum_name@_get_string: - * @val: a @EnumName@. - * - * Gets the nickname string for the #@EnumName@ specified at @val. - * - * Returns: (transfer none): a string with the nickname, or %NULL if not found. Do not free the returned value. - */ const gchar * @enum_name@_get_string (@EnumName@ val) { @@ -64,15 +56,6 @@ const gchar * * Note that this will be valid even if the GFlagsClass is not referenced * anywhere. */ #if defined __@ENUMNAME@_IS_FLAGS__ -/** - * @enum_name@_build_string_from_mask: - * @mask: bitmask of @EnumName@ values. - * - * Builds a string containing a comma-separated list of nicknames for - * each #@EnumName@ in @mask. - * - * Returns: (transfer full): a string with the list of nicknames, or %NULL if none given. The returned value should be freed with g_free(). - */ gchar * @enum_name@_build_string_from_mask (@EnumName@ mask) { diff --git a/build-aux/templates/qmi-enum-types-template.h b/build-aux/templates/qmi-enum-types-template.h index 31e0732..3457e9b 100644 --- a/build-aux/templates/qmi-enum-types-template.h +++ b/build-aux/templates/qmi-enum-types-template.h @@ -18,10 +18,27 @@ GType @enum_name@_get_type (void) G_GNUC_CONST; #define __@ENUMNAME@_IS_@TYPE@__ #if defined __@ENUMNAME@_IS_ENUM__ +/** + * @enum_name@_get_string: + * @val: a @EnumName@. + * + * Gets the nickname string for the #@EnumName@ specified at @val. + * + * Returns: (transfer none): a string with the nickname, or %NULL if not found. Do not free the returned value. + */ const gchar *@enum_name@_get_string (@EnumName@ val); #endif #if defined __@ENUMNAME@_IS_FLAGS__ +/** + * @enum_name@_build_string_from_mask: + * @mask: bitmask of @EnumName@ values. + * + * Builds a string containing a comma-separated list of nicknames for + * each #@EnumName@ in @mask. + * + * Returns: (transfer full): a string with the list of nicknames, or %NULL if none given. The returned value should be freed with g_free(). + */ gchar *@enum_name@_build_string_from_mask (@EnumName@ mask); #endif diff --git a/build-aux/templates/qmi-error-types-template.h b/build-aux/templates/qmi-error-types-template.h index 217f006..b0dfdb2 100644 --- a/build-aux/templates/qmi-error-types-template.h +++ b/build-aux/templates/qmi-error-types-template.h @@ -15,6 +15,15 @@ GQuark @enum_name@_quark (void); GType @enum_name@_get_type (void) G_GNUC_CONST; #define @ENUMNAME@ (@enum_name@_quark ()) #define @ENUMPREFIX@_TYPE_@ENUMSHORT@ (@enum_name@_get_type ()) + +/** + * @enum_name@_get_string: + * @val: a @EnumName@. + * + * Gets the nickname string for the #@EnumName@ specified at @val. + * + * Returns: (transfer none): a string with the nickname, or %NULL if not found. Do not free the returned value. + */ const gchar *@enum_name@_get_string (@EnumName@ val); /*** END value-header ***/ diff --git a/build-aux/templates/qmi-flags64-types-template.c b/build-aux/templates/qmi-flags64-types-template.c index a92824c..61d541c 100644 --- a/build-aux/templates/qmi-flags64-types-template.c +++ b/build-aux/templates/qmi-flags64-types-template.c @@ -22,15 +22,6 @@ static const GFlags64Value @enum_name@_values[] = { { 0, NULL, NULL } }; -/** - * @enum_name@_build_string_from_mask: - * @mask: bitmask of @EnumName@ values. - * - * Builds a string containing a comma-separated list of nicknames for - * each #@EnumName@ in @mask. - * - * Returns: (transfer full): a string with the list of nicknames, or %NULL if none given. The returned value should be freed with g_free(). - */ gchar * @enum_name@_build_string_from_mask (@EnumName@ mask) { diff --git a/build-aux/templates/qmi-flags64-types-template.h b/build-aux/templates/qmi-flags64-types-template.h index 981d0e1..f471c29 100644 --- a/build-aux/templates/qmi-flags64-types-template.h +++ b/build-aux/templates/qmi-flags64-types-template.h @@ -18,6 +18,15 @@ G_BEGIN_DECLS #error Only flags expected, @EnumName@ is an enumeration #endif +/** + * @enum_name@_build_string_from_mask: + * @mask: bitmask of @EnumName@ values. + * + * Builds a string containing a comma-separated list of nicknames for + * each #@EnumName@ in @mask. + * + * Returns: (transfer full): a string with the list of nicknames, or %NULL if none given. The returned value should be freed with g_free(). + */ gchar *@enum_name@_build_string_from_mask (@EnumName@ mask); /*** END value-header ***/ diff --git a/src/libqmi-glib/qmi-enums-dms.h b/src/libqmi-glib/qmi-enums-dms.h index 2597187..7e2ce5d 100644 --- a/src/libqmi-glib/qmi-enums-dms.h +++ b/src/libqmi-glib/qmi-enums-dms.h @@ -48,6 +48,8 @@ * @QMI_DMS_DATA_SERVICE_CAPABILITY_NON_SIMULTANEOUS_CS_PS: Non simultaneous CS and PS supported. * * Data service capability. + * + * Since: 1.0 */ typedef enum { QMI_DMS_DATA_SERVICE_CAPABILITY_NONE = 0, @@ -57,18 +59,32 @@ typedef enum { QMI_DMS_DATA_SERVICE_CAPABILITY_NON_SIMULTANEOUS_CS_PS = 4 } QmiDmsDataServiceCapability; +/** + * qmi_dms_data_service_capability_get_string: + * + * Since: 1.0 + */ + /** * QmiDmsSimCapability: * @QMI_DMS_SIM_CAPABILITY_NOT_SUPPORTED: SIM not supported. * @QMI_DMS_SIM_CAPABILITY_SUPPORTED: SIM is supported. * * SIM capability. + * + * Since: 1.0 */ typedef enum { QMI_DMS_SIM_CAPABILITY_NOT_SUPPORTED = 1, QMI_DMS_SIM_CAPABILITY_SUPPORTED = 2 } QmiDmsSimCapability; +/** + * qmi_dms_sim_capability_get_string: + * + * Since: 1.0 + */ + /** * QmiDmsRadioInterface: * @QMI_DMS_RADIO_INTERFACE_CDMA20001X: CDMA2000 1x. @@ -78,6 +94,8 @@ typedef enum { * @QMI_DMS_RADIO_INTERFACE_LTE: LTE. * * Radio interface type. + * + * Since: 1.0 */ typedef enum { QMI_DMS_RADIO_INTERFACE_CDMA20001X = 1, @@ -87,6 +105,11 @@ typedef enum { QMI_DMS_RADIO_INTERFACE_LTE = 8 } QmiDmsRadioInterface; +/** + * qmi_dms_radio_interface_get_string: + * + * Since: 1.0 + */ /*****************************************************************************/ /* Helper enums for the 'QMI DMS Get Power State' message */ @@ -110,6 +133,8 @@ typedef enum { * otherwise the battery is not being charged. * * If @QMI_DMS_POWER_STATE_FAULT is set, a power fault has been detected. + * + * Since: 1.0 */ typedef enum { QMI_DMS_POWER_STATE_EXTERNAL_SOURCE = 1 << 0, @@ -118,6 +143,11 @@ typedef enum { QMI_DMS_POWER_STATE_FAULT = 1 << 3, } QmiDmsPowerState; +/** + * qmi_dms_power_state_get_string: + * + * Since: 1.0 + */ /*****************************************************************************/ /* Helper enums for the 'QMI DMS UIM Set PIN Protection' message */ @@ -128,12 +158,19 @@ typedef enum { * @QMI_DMS_UIM_PIN_ID_PIN2: PIN2. * * The PIN identifier. + * + * Since: 1.0 */ typedef enum { QMI_DMS_UIM_PIN_ID_PIN = 1, QMI_DMS_UIM_PIN_ID_PIN2 = 2 } QmiDmsUimPinId; +/** + * qmi_dms_uim_pin_id_get_string: + * + * Since: 1.0 + */ /*****************************************************************************/ /* Helper enums for the 'QMI DMS UIM Get PIN Status' message */ @@ -150,6 +187,8 @@ typedef enum { * @QMI_DMS_UIM_PIN_STATUS_CHANGED: Changed. * * The PIN status. + * + * Since: 1.0 */ typedef enum { QMI_DMS_UIM_PIN_STATUS_NOT_INITIALIZED = 0, @@ -162,6 +201,12 @@ typedef enum { QMI_DMS_UIM_PIN_STATUS_CHANGED = 7, } QmiDmsUimPinStatus; +/** + * qmi_dms_uim_pin_status_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI DMS Get Operating Mode' message */ @@ -178,6 +223,8 @@ typedef enum { * @QMI_DMS_OPERATING_MODE_UNKNOWN: Unknown. * * Operating mode of the device. + * + * Since: 1.0 */ typedef enum { QMI_DMS_OPERATING_MODE_ONLINE = 0, @@ -191,6 +238,12 @@ typedef enum { QMI_DMS_OPERATING_MODE_UNKNOWN = 0xFF } QmiDmsOperatingMode; +/** + * qmi_dms_operating_mode_get_string: + * + * Since: 1.0 + */ + /** * QmiDmsOfflineReason: * @QMI_DMS_OFFLINE_REASON_HOST_IMAGE_MISCONFIGURATION: Host image misconfiguration. @@ -199,6 +252,8 @@ typedef enum { * @QMI_DMS_OFFLINE_REASON_DEVICE_MEMORY_FULL: Memory full, cannot copy PRI information. * * Reasons for being in Offline (@QMI_DMS_OPERATING_MODE_OFFLINE) state. + * + * Since: 1.0 */ typedef enum { QMI_DMS_OFFLINE_REASON_HOST_IMAGE_MISCONFIGURATION = 1 << 0, @@ -207,6 +262,12 @@ typedef enum { QMI_DMS_OFFLINE_REASON_DEVICE_MEMORY_FULL = 1 << 3 } QmiDmsOfflineReason; +/** + * qmi_dms_offline_reason_build_string_from_mask: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI DMS Get Time' message */ @@ -217,6 +278,8 @@ typedef enum { * @QMI_DMS_TIME_SOURCE_HDR_NETWORK: HDR network. * * Source of the timestamp. + * + * Since: 1.0 */ typedef enum { QMI_DMS_TIME_SOURCE_DEVICE = 0, @@ -224,6 +287,12 @@ typedef enum { QMI_DMS_TIME_SOURCE_HDR_NETWORK = 2, } QmiDmsTimeSource; +/** + * qmi_dms_time_source_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI DMS Get Activation State' message */ @@ -242,6 +311,8 @@ typedef enum { * @QMI_DMS_ACTIVATION_STATE_OTASP_COMMITED: OTASP settings committed. * * State of the service activation. + * + * Since: 1.0 */ typedef enum { QMI_DMS_ACTIVATION_STATE_NOT_ACTIVATED = 0x00, @@ -257,6 +328,12 @@ typedef enum { QMI_DMS_ACTIVATION_STATE_OTASP_COMMITED = 0x0A } QmiDmsActivationState; +/** + * qmi_dms_activation_state_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI DMS UIM Get CK Status' message */ @@ -269,6 +346,8 @@ typedef enum { * @QMI_DMS_UIM_FACILITY_PF: UIM personalization facility. * * UIM personalization facilities. + * + * Since: 1.0 */ typedef enum { QMI_DMS_UIM_FACILITY_PN = 0, @@ -278,11 +357,21 @@ typedef enum { QMI_DMS_UIM_FACILITY_PF = 4 } QmiDmsUimFacility; +/** + * qmi_dms_uim_facility_get_string: + * + * Since: 1.0 + */ + /** * QmiDmsUimFacilityState: * @QMI_DMS_UIM_FACILITY_STATE_DEACTIVATED: Facility is deactivated. * @QMI_DMS_UIM_FACILITY_STATE_ACTIVATED: Facility is activated. * @QMI_DMS_UIM_FACILITY_STATE_BLOCKED: Facility is blocked. + * + * State of the UIM facility. + * + * Since: 1.0 */ typedef enum { QMI_DMS_UIM_FACILITY_STATE_DEACTIVATED = 0, @@ -290,6 +379,12 @@ typedef enum { QMI_DMS_UIM_FACILITY_STATE_BLOCKED = 2 } QmiDmsUimFacilityState; +/** + * qmi_dms_uim_facility_state_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI DMS UIM Get State' message */ @@ -302,6 +397,8 @@ typedef enum { * @QMI_DMS_UIM_STATE_UNKNOWN: UIM state currently unavailable. * * State of the UIM. + * + * Since: 1.0 */ typedef enum { QMI_DMS_UIM_STATE_INITIALIZATION_COMPLETED = 0x00, @@ -311,6 +408,12 @@ typedef enum { QMI_DMS_UIM_STATE_UNKNOWN = 0xFF } QmiDmsUimState; +/** + * qmi_dms_uim_state_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI DMS Set Time' message */ @@ -319,11 +422,19 @@ typedef enum { * @QMI_DMS_TIME_REFERENCE_TYPE_USER: User time. * * Time reference type. + * + * Since: 1.0 */ typedef enum { QMI_DMS_TIME_REFERENCE_TYPE_USER = 0 } QmiDmsTimeReferenceType; +/** + * qmi_dms_time_reference_type_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI DMS Get Firmware Preference' message */ @@ -333,12 +444,20 @@ typedef enum { * @QMI_DMS_FIRMWARE_IMAGE_TYPE_PRI: PRI image. * * Type of firmware image. + * + * Since: 1.0 */ typedef enum { QMI_DMS_FIRMWARE_IMAGE_TYPE_MODEM = 0, QMI_DMS_FIRMWARE_IMAGE_TYPE_PRI = 1 } QmiDmsFirmwareImageType; +/** + * qmi_dms_firmware_image_type_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI DMS Get Boot Image Download Mode' message */ @@ -348,12 +467,20 @@ typedef enum { * @QMI_DMS_BOOT_IMAGE_DOWNLOAD_MODE_BOOT_AND_RECOVERY: Boot and recovery image download mode. * * Specifies the mode for the next boot. + * + * Since: 1.18 */ typedef enum { QMI_DMS_BOOT_IMAGE_DOWNLOAD_MODE_NORMAL = 0, QMI_DMS_BOOT_IMAGE_DOWNLOAD_MODE_BOOT_AND_RECOVERY = 1, } QmiDmsBootImageDownloadMode; +/** + * qmi_dms_boot_image_download_mode_get_string: + * + * Since: 1.18 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI DMS HP Change Device Mode' message */ @@ -362,9 +489,17 @@ typedef enum { * @QMI_DMS_HP_DEVICE_MODE_FASTBOOT: Fastboot download mode. * * HP specific device modes. + * + * Since: 1.18 */ typedef enum { QMI_DMS_HP_DEVICE_MODE_FASTBOOT = 5, } QmiDmsHpDeviceMode; +/** + * qmi_dms_hp_device_mode_get_string: + * + * Since: 1.18 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_DMS_H_ */ diff --git a/src/libqmi-glib/qmi-enums-nas.h b/src/libqmi-glib/qmi-enums-nas.h index 6c4cc21..1195328 100644 --- a/src/libqmi-glib/qmi-enums-nas.h +++ b/src/libqmi-glib/qmi-enums-nas.h @@ -51,6 +51,8 @@ * @QMI_NAS_RADIO_INTERFACE_TD_SCDMA: TD-SCDMA. * * Radio interface technology. + * + * Since: 1.0 */ typedef enum { QMI_NAS_RADIO_INTERFACE_UNKNOWN = -1, @@ -64,6 +66,12 @@ typedef enum { QMI_NAS_RADIO_INTERFACE_TD_SCDMA = 0x09 } QmiNasRadioInterface; +/** + * qmi_nas_radio_interface_get_string: + * + * Since: 1.0 + */ + /** * QmiNasActiveBand: * @QMI_NAS_ACTIVE_BAND_BC_0: Band class 0. @@ -146,6 +154,8 @@ typedef enum { * @QMI_NAS_ACTIVE_BAND_TDSCDMA_F: TD-SCDMA Band F. * * Band classes. + * + * Since: 1.0 */ typedef enum { QMI_NAS_ACTIVE_BAND_BC_0 = 0, @@ -228,6 +238,12 @@ typedef enum { QMI_NAS_ACTIVE_BAND_TDSCDMA_F = 205 } QmiNasActiveBand; +/** + * qmi_nas_active_band_get_string: + * + * Since: 1.0 + */ + /** * QmiNasNetworkServiceDomain: * @QMI_NAS_NETWORK_SERVICE_DOMAIN_NONE: No service. @@ -237,6 +253,8 @@ typedef enum { * @QMI_NAS_NETWORK_SERVICE_DOMAIN_UNKNOWN: Unknown service. * * Network Service Domain. + * + * Since: 1.0 */ typedef enum { QMI_NAS_NETWORK_SERVICE_DOMAIN_NONE = 0x00, @@ -246,6 +264,12 @@ typedef enum { QMI_NAS_NETWORK_SERVICE_DOMAIN_UNKNOWN = 0x04, } QmiNasNetworkServiceDomain; +/** + * qmi_nas_network_service_domain_get_string: + * + * Since: 1.0 + */ + /** * QmiNasEvdoSinrLevel: * @QMI_NAS_EVDO_SINR_LEVEL_0: -9 dB. @@ -259,6 +283,8 @@ typedef enum { * @QMI_NAS_EVDO_SINR_LEVEL_8: +9 dB. * * EV-DO SINR level. + * + * Since: 1.0 */ typedef enum { QMI_NAS_EVDO_SINR_LEVEL_0 = 0, @@ -272,6 +298,12 @@ typedef enum { QMI_NAS_EVDO_SINR_LEVEL_8 = 8 } QmiNasEvdoSinrLevel; +/** + * qmi_nas_evdo_sinr_level_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI NAS Get Signal Strength' request/response */ @@ -288,6 +320,8 @@ typedef enum { * @QMI_NAS_SIGNAL_STRENGTH_REQUEST_LTE_RSRP: Request LTE RSRP information. * * Extra information to request when gathering Signal Strength. + * + * Since: 1.0 */ typedef enum { QMI_NAS_SIGNAL_STRENGTH_REQUEST_NONE = 0, @@ -301,6 +335,12 @@ typedef enum { QMI_NAS_SIGNAL_STRENGTH_REQUEST_LTE_RSRP = 1 << 7 } QmiNasSignalStrengthRequest; +/** + * qmi_nas_signal_strength_request_build_string_from_mask: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI NAS Network Scan' request/response */ @@ -312,6 +352,8 @@ typedef enum { * @QMI_NAS_NETWORK_SCAN_TYPE_TD_SCDMA: TD-SCDMA network. * * Flags to use when specifying which networks to scan. + * + * Since: 1.0 */ typedef enum { QMI_NAS_NETWORK_SCAN_TYPE_GSM = 1 << 0, @@ -320,6 +362,12 @@ typedef enum { QMI_NAS_NETWORK_SCAN_TYPE_TD_SCDMA = 1 << 3 } QmiNasNetworkScanType; +/** + * qmi_nas_network_scan_type_build_string_from_mask: + * + * Since: 1.0 + */ + /** * QmiNasNetworkStatus: * @QMI_NAS_NETWORK_STATUS_CURRENT_SERVING: Network is in use, current serving. @@ -332,6 +380,8 @@ typedef enum { * @QMI_NAS_NETWORK_STATUS_NOT_PREFERRED: Network is not preferred. * * Flags to specify the status of a given network. + * + * Since: 1.0 */ typedef enum { QMI_NAS_NETWORK_STATUS_CURRENT_SERVING = 1 << 0, @@ -344,6 +394,12 @@ typedef enum { QMI_NAS_NETWORK_STATUS_NOT_PREFERRED = 1 << 7 } QmiNasNetworkStatus; +/** + * qmi_nas_network_status_build_string_from_mask: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI NAS Initiate Network Register' request/response */ @@ -353,12 +409,20 @@ typedef enum { * @QMI_NAS_NETWORK_REGISTER_TYPE_MANUAL: Manual network registration. * * Type of network registration. + * + * Since: 1.0 */ typedef enum { QMI_NAS_NETWORK_REGISTER_TYPE_AUTOMATIC = 0x01, QMI_NAS_NETWORK_REGISTER_TYPE_MANUAL = 0x02 } QmiNasNetworkRegisterType; +/** + * qmi_nas_network_register_type_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI NAS Get Serving System' request/response */ @@ -371,6 +435,8 @@ typedef enum { * @QMI_NAS_REGISTRATION_STATE_UNKNOWN: Unknown. * * Status of the network registration. + * + * Since: 1.0 */ typedef enum { QMI_NAS_REGISTRATION_STATE_NOT_REGISTERED = 0x00, @@ -380,6 +446,12 @@ typedef enum { QMI_NAS_REGISTRATION_STATE_UNKNOWN = 0x04 } QmiNasRegistrationState; +/** + * qmi_nas_registration_state_get_string: + * + * Since: 1.0 + */ + /** * QmiNasAttachState: * @QMI_NAS_ATTACH_STATE_UNKNOWN: Unknown attach state. @@ -387,6 +459,8 @@ typedef enum { * @QMI_NAS_ATTACH_STATE_DETACHED: Detached. * * Domain attach state. + * + * Since: 1.0 */ typedef enum { QMI_NAS_ATTACH_STATE_UNKNOWN = 0x00, @@ -394,6 +468,12 @@ typedef enum { QMI_NAS_ATTACH_STATE_DETACHED = 0x02, } QmiNasAttachState; +/** + * qmi_nas_attach_state_get_string: + * + * Since: 1.0 + */ + /** * QmiNasNetworkType: * @QMI_NAS_NETWORK_TYPE_UNKNOWN: Unknown. @@ -401,6 +481,8 @@ typedef enum { * @QMI_NAS_NETWORK_TYPE_3GPP: 3GPP network. * * Type of network. + * + * Since: 1.0 */ typedef enum { QMI_NAS_NETWORK_TYPE_UNKNOWN = 0x00, @@ -408,12 +490,20 @@ typedef enum { QMI_NAS_NETWORK_TYPE_3GPP = 0x02, } QmiNasNetworkType; +/** + * qmi_nas_network_type_get_string: + * + * Since: 1.0 + */ + /** * QmiNasRoamingIndicatorStatus: * @QMI_NAS_ROAMING_INDICATOR_STATUS_ON: Roaming. * @QMI_NAS_ROAMING_INDICATOR_STATUS_OFF: Home. * * Status of the roaming indication. + * + * Since: 1.0 */ typedef enum { QMI_NAS_ROAMING_INDICATOR_STATUS_ON = 0x00, @@ -421,6 +511,12 @@ typedef enum { /* next values only for 3GPP2 */ } QmiNasRoamingIndicatorStatus; +/** + * qmi_nas_roaming_indicator_status_get_string: + * + * Since: 1.0 + */ + /** * QmiNasDataCapability: * @QMI_NAS_DATA_CAPABILITY_NONE: None or unknown. @@ -439,6 +535,8 @@ typedef enum { * @QMI_NAS_DATA_CAPABILITY_DC_HSDPA_PLUS: DC-HSDPA+. * * Data capability of the network. + * + * Since: 1.0 */ typedef enum { QMI_NAS_DATA_CAPABILITY_NONE = 0x00, @@ -457,6 +555,12 @@ typedef enum { QMI_NAS_DATA_CAPABILITY_DC_HSDPA_PLUS = 0x0D } QmiNasDataCapability; +/** + * qmi_nas_data_capability_get_string: + * + * Since: 1.0 + */ + /** * QmiNasServiceStatus: * @QMI_NAS_SERVICE_STATUS_NONE: No service. @@ -466,6 +570,8 @@ typedef enum { * @QMI_NAS_SERVICE_STATUS_POWER_SAVE: Device in power save mode. * * Status of the service. + * + * Since: 1.0 */ typedef enum { QMI_NAS_SERVICE_STATUS_NONE = 0x00, @@ -475,6 +581,12 @@ typedef enum { QMI_NAS_SERVICE_STATUS_POWER_SAVE = 0x04 } QmiNasServiceStatus; +/** + * qmi_nas_service_status_get_string: + * + * Since: 1.0 + */ + /** * QmiNasHdrPersonality: * @QMI_NAS_HDR_PERSONALITY_UNKNOWN: Unknown. @@ -482,6 +594,8 @@ typedef enum { * @QMI_NAS_HDR_PERSONALITY_EHRPD: eHRPD. * * HDR personality type. + * + * Since: 1.0 */ typedef enum { QMI_NAS_HDR_PERSONALITY_UNKNOWN = 0x00, @@ -489,6 +603,12 @@ typedef enum { QMI_NAS_HDR_PERSONALITY_EHRPD = 0x02, } QmiNasHdrPersonality; +/** + * qmi_nas_hdr_personality_get_string: + * + * Since: 1.0 + */ + /** * QmiNasCallBarringStatus: * @QMI_NAS_CALL_BARRING_STATUS_NORMAL_ONLY: Normal calls only. @@ -498,6 +618,8 @@ typedef enum { * @QMI_NAS_CALL_BARRING_STATUS_UNKNOWN: Unknown. * * Status of the call barring functionality. + * + * Since: 1.0 */ typedef enum { QMI_NAS_CALL_BARRING_STATUS_NORMAL_ONLY = 0x00, @@ -507,6 +629,12 @@ typedef enum { QMI_NAS_CALL_BARRING_STATUS_UNKNOWN = -1 } QmiNasCallBarringStatus; +/** + * qmi_nas_call_barring_status_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI NAS Get Home Network' request/response */ @@ -517,6 +645,8 @@ typedef enum { * @QMI_NAS_NETWORK_DESCRIPTION_DISPLAY_UNKNOWN: Unknown. * * Setup to define whether the network description should be displayed. + * + * Since: 1.0 */ typedef enum { QMI_NAS_NETWORK_DESCRIPTION_DISPLAY_NO = 0x00, @@ -524,6 +654,12 @@ typedef enum { QMI_NAS_NETWORK_DESCRIPTION_DISPLAY_UNKNOWN = 0xFF } QmiNasNetworkDescriptionDisplay; +/** + * qmi_nas_network_description_display_get_string: + * + * Since: 1.0 + */ + /** * QmiNasNetworkDescriptionEncoding: * @QMI_NAS_NETWORK_DESCRIPTION_ENCODING_UNSPECIFIED: Unspecified. @@ -532,6 +668,8 @@ typedef enum { * @QMI_NAS_NETWORK_DESCRIPTION_ENCODING_GSM: GSM 7-bit. * * Type of encoding used in the network description. + * + * Since: 1.0 */ typedef enum { QMI_NAS_NETWORK_DESCRIPTION_ENCODING_UNSPECIFIED = 0x00, @@ -540,6 +678,12 @@ typedef enum { QMI_NAS_NETWORK_DESCRIPTION_ENCODING_GSM = 0x09 } QmiNasNetworkDescriptionEncoding; +/** + * qmi_nas_network_description_encoding_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI NAS Get Technology Preference' request/response */ @@ -554,6 +698,8 @@ typedef enum { * @QMI_NAS_RADIO_TECHNOLOGY_PREFERENCE_LTE: LTE. * * Flags to specify the radio technology preference. + * + * Since: 1.0 */ typedef enum { QMI_NAS_RADIO_TECHNOLOGY_PREFERENCE_AUTO = 0, @@ -565,6 +711,12 @@ typedef enum { QMI_NAS_RADIO_TECHNOLOGY_PREFERENCE_LTE = 1 << 5 } QmiNasRadioTechnologyPreference; +/** + * qmi_nas_radio_technology_preference_build_string_from_mask: + * + * Since: 1.0 + */ + /** * QmiNasPreferenceDuration: * @QMI_NAS_PREFERENCE_DURATION_PERMANENT: Permanent. @@ -576,6 +728,8 @@ typedef enum { * @QMI_NAS_PREFERENCE_DURATION_INTERNAL_ONE_CALL_3: Internal reason 3, one call. * * Duration of the preference setting. + * + * Since: 1.0 */ typedef enum { QMI_NAS_PREFERENCE_DURATION_PERMANENT = 0x00, @@ -587,6 +741,12 @@ typedef enum { QMI_NAS_PREFERENCE_DURATION_INTERNAL_ONE_CALL_3 = 0x06 } QmiNasPreferenceDuration; +/** + * qmi_nas_preference_duration_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI NAS Get/Set System Selection Preference' * requests/responses */ @@ -601,6 +761,8 @@ typedef enum { * @QMI_NAS_RAT_MODE_PREFERENCE_TD_SCDMA: TD-SCDMA. * * Flags specifying radio access technology mode preference. + * + * Since: 1.0 */ typedef enum { QMI_NAS_RAT_MODE_PREFERENCE_CDMA_1X = 1 << 0, @@ -611,6 +773,12 @@ typedef enum { QMI_NAS_RAT_MODE_PREFERENCE_TD_SCDMA = 1 << 5 } QmiNasRatModePreference; +/** + * qmi_nas_rat_mode_preference_build_string_from_mask: + * + * Since: 1.0 + */ + /** * QmiNasCdmaPrlPreference: * @QMI_NAS_CDMA_PRL_PREFERENCE_A_SIDE_ONLY: System A only. @@ -618,6 +786,8 @@ typedef enum { * @QMI_NAS_CDMA_PRL_PREFERENCE_ANY: Any system. * * Flags specifying the preference when using CDMA Band Class 0. + * + * Since: 1.0 */ typedef enum { QMI_NAS_CDMA_PRL_PREFERENCE_A_SIDE_ONLY = 0x0001, @@ -625,6 +795,12 @@ typedef enum { QMI_NAS_CDMA_PRL_PREFERENCE_ANY = 0x3FFF } QmiNasCdmaPrlPreference; +/** + * qmi_nas_cdma_prl_preference_get_string: + * + * Since: 1.0 + */ + /** * QmiNasRoamingPreference: * @QMI_NAS_ROAMING_PREFERENCE_OFF: Only non-roaming networks. @@ -633,6 +809,8 @@ typedef enum { * @QMI_NAS_ROAMING_PREFERENCE_ANY: Don't filter by roaming when acquiring networks. * * Roaming preference. + * + * Since: 1.0 */ typedef enum { QMI_NAS_ROAMING_PREFERENCE_OFF = 0x01, @@ -641,30 +819,52 @@ typedef enum { QMI_NAS_ROAMING_PREFERENCE_ANY = 0xFF } QmiNasRoamingPreference; +/** + * qmi_nas_roaming_preference_get_string: + * + * Since: 1.0 + */ + /** * QmiNasNetworkSelectionPreference: * @QMI_NAS_NETWORK_SELECTION_PREFERENCE_AUTOMATIC: Automatic. * @QMI_NAS_NETWORK_SELECTION_PREFERENCE_MANUAL: Manual. * * Network selection preference. + * + * Since: 1.0 */ typedef enum { QMI_NAS_NETWORK_SELECTION_PREFERENCE_AUTOMATIC = 0x00, QMI_NAS_NETWORK_SELECTION_PREFERENCE_MANUAL = 0x01 } QmiNasNetworkSelectionPreference; +/** + * qmi_nas_network_selection_preference_get_string: + * + * Since: 1.0 + */ + /** * QmiNasChangeDuration: * @QMI_NAS_CHANGE_DURATION_PERMANENT: Permanent. * @QMI_NAS_CHANGE_DURATION_POWER_CYCLE: Until the next power cycle. * * Duration of the change setting. + * + * Since: 1.0 */ typedef enum { QMI_NAS_CHANGE_DURATION_POWER_CYCLE = 0x00, QMI_NAS_CHANGE_DURATION_PERMANENT = 0x01 } QmiNasChangeDuration; +/** + * qmi_nas_change_duration_get_string: + * + * Since: 1.0 + */ + /** * QmiNasServiceDomainPreference: * @QMI_NAS_SERVICE_DOMAIN_PREFERENCE_CS_ONLY: Circuit-switched only. @@ -674,6 +874,8 @@ typedef enum { * @QMI_NAS_SERVICE_DOMAIN_PREFERENCE_PS_DETACH:Packet-switched dettach. * * Service domain preference. + * + * Since: 1.0 */ typedef enum { QMI_NAS_SERVICE_DOMAIN_PREFERENCE_CS_ONLY = 0x00, @@ -683,6 +885,12 @@ typedef enum { QMI_NAS_SERVICE_DOMAIN_PREFERENCE_PS_DETACH = 0x04, } QmiNasServiceDomainPreference; +/** + * qmi_nas_service_domain_preference_get_string: + * + * Since: 1.0 + */ + /** * QmiNasGsmWcdmaAcquisitionOrderPreference: * @QMI_NAS_GSM_WCDMA_ACQUISITION_ORDER_PREFERENCE_AUTOMATIC: Automatic. @@ -690,6 +898,8 @@ typedef enum { * @QMI_NAS_GSM_WCDMA_ACQUISITION_ORDER_PREFERENCE_WCDMA: WCDMA first, then GSM. * * GSM/WCDMA acquisition order preference. + * + * Since: 1.0 */ typedef enum { QMI_NAS_GSM_WCDMA_ACQUISITION_ORDER_PREFERENCE_AUTOMATIC = 0x00, @@ -697,6 +907,12 @@ typedef enum { QMI_NAS_GSM_WCDMA_ACQUISITION_ORDER_PREFERENCE_WCDMA = 0x02 } QmiNasGsmWcdmaAcquisitionOrderPreference; +/** + * qmi_nas_gsm_wcdma_acquisition_order_preference_get_string: + * + * Since: 1.0 + */ + /** * QmiNasTdScdmaBandPreference: * @QMI_NAS_TD_SCDMA_BAND_PREFERENCE_A: Band A. @@ -707,6 +923,8 @@ typedef enum { * @QMI_NAS_TD_SCDMA_BAND_PREFERENCE_F: Band F. * * Flags to specify TD-SCDMA-specific frequency band preferences. + * + * Since: 1.0 */ typedef enum { QMI_NAS_TD_SCDMA_BAND_PREFERENCE_A = 1 << 0, @@ -717,6 +935,12 @@ typedef enum { QMI_NAS_TD_SCDMA_BAND_PREFERENCE_F = 1 << 5 } QmiNasTdScdmaBandPreference; +/** + * qmi_nas_td_scdma_band_preference_build_string_from_mask: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI NAS Get System Info' request/response */ @@ -735,7 +959,11 @@ typedef enum { * @QMI_NAS_ROAMING_STATUS_PARTIAL_SERVICE: Partial service. * @QMI_NAS_ROAMING_STATUS_BANNER_ON: Banner on. * @QMI_NAS_ROAMING_STATUS_BANNER_OFF: Banner off. -*/ + * + * Roaming status. + * + * Since: 1.0 + */ typedef enum { QMI_NAS_ROAMING_STATUS_OFF = 0x00, QMI_NAS_ROAMING_STATUS_ON = 0x01, @@ -753,6 +981,12 @@ typedef enum { QMI_NAS_ROAMING_STATUS_BANNER_OFF = 0x0C } QmiNasRoamingStatus; +/** + * qmi_nas_roaming_status_get_string: + * + * Since: 1.0 + */ + /** * QmiNasHdrProtocolRevision: * @QMI_NAS_HDR_PROTOCOL_REVISION_NONE: None. @@ -761,6 +995,8 @@ typedef enum { * @QMI_NAS_HDR_PROTOCOL_REVISION_REL_B: HDR Rel B. * * HDR protocol revision. + * + * Since: 1.0 */ typedef enum { QMI_NAS_HDR_PROTOCOL_REVISION_NONE = 0x00, @@ -769,6 +1005,12 @@ typedef enum { QMI_NAS_HDR_PROTOCOL_REVISION_REL_B = 0x03 } QmiNasHdrProtocolRevision; +/** + * qmi_nas_hdr_protocol_revision_get_string: + * + * Since: 1.0 + */ + /** * QmiNasWcdmaHsService: * @QMI_NAS_WCDMA_HS_SERVICE_HSDPA_HSUPA_UNSUPPORTED: HSDPA and HSUPA not supported. @@ -779,7 +1021,10 @@ typedef enum { * @QMI_NAS_WCDMA_HS_SERVICE_HSDPA_PLUS_HSUPA_SUPPORTED: HSDPA+ and HSUPA supported. * @QMI_NAS_WCDMA_HS_SERVICE_DC_HSDPA_PLUS_SUPPORTED: DC-HSDPA+ supported. * @QMI_NAS_WCDMA_HS_SERVICE_DC_HSDPA_PLUS_HSUPA_SUPPORTED: DC-HSDPA+ and HSUPA supported. + * * Call status on high speed. + * + * Since: 1.0 */ typedef enum { QMI_NAS_WCDMA_HS_SERVICE_HSDPA_HSUPA_UNSUPPORTED = 0x00, @@ -792,6 +1037,12 @@ typedef enum { QMI_NAS_WCDMA_HS_SERVICE_DC_HSDPA_PLUS_HSUPA_SUPPORTED = 0x07 } QmiNasWcdmaHsService; +/** + * qmi_nas_wcdma_hs_service_get_string: + * + * Since: 1.0 + */ + /** * QmiNasCellBroadcastCapability: * @QMI_NAS_CELL_BROADCAST_CAPABILITY_UNKNOWN: Unknown. @@ -799,6 +1050,8 @@ typedef enum { * @QMI_NAS_CELL_BROADCAST_CAPABILITY_ON: Cell broadcast supported. * * Cell broadcast support. + * + * Since: 1.0 */ typedef enum { QMI_NAS_CELL_BROADCAST_CAPABILITY_UNKNOWN = 0x00, @@ -806,6 +1059,12 @@ typedef enum { QMI_NAS_CELL_BROADCAST_CAPABILITY_ON = 0x02 } QmiNasCellBroadcastCapability; +/** + * qmi_nas_cell_broadcast_capability_get_string: + * + * Since: 1.0 + */ + /** * QmiNasSimRejectState: * @QMI_NAS_SIM_REJECT_STATE_SIM_UNAVAILABLE: SIM not available. @@ -815,6 +1074,8 @@ typedef enum { * @QMI_NAS_SIM_REJECT_STATE_SIM_CS_PS_INVALID: SIM invalid for circuit-switched and packet-switched connections. * * Reject information of the SIM. + * + * Since: 1.0 */ typedef enum { QMI_NAS_SIM_REJECT_STATE_SIM_UNAVAILABLE = 0, @@ -824,18 +1085,32 @@ typedef enum { QMI_NAS_SIM_REJECT_STATE_SIM_CS_PS_INVALID = 4 } QmiNasSimRejectState; +/** + * qmi_nas_sim_reject_state_get_string: + * + * Since: 1.0 + */ + /** * QmiNasCdmaPilotType: * @QMI_NAS_CDMA_PILOT_TYPE_ACTIVE: the pilot is part of the active set. * @QMI_NAS_CDMA_PILOT_TYPE_NEIGHBOR: the pilot is part of the neighbor set. * * The pilot set the pilot belongs to. + * + * Since: 1.0 */ typedef enum { QMI_NAS_CDMA_PILOT_TYPE_ACTIVE = 0, QMI_NAS_CDMA_PILOT_TYPE_NEIGHBOR = 1, } QmiNasCdmaPilotType; +/** + * qmi_nas_cdma_pilot_type_get_string: + * + * Since: 1.0 + */ + /** * QmiNasDayOfWeek: * @QMI_NAS_DAY_OF_WEEK_MONDAY: Monday @@ -847,6 +1122,8 @@ typedef enum { * @QMI_NAS_DAY_OF_WEEK_SUNDAY: Sunday * * The day of the week. + * + * Since: 1.4 */ typedef enum { QMI_NAS_DAY_OF_WEEK_MONDAY = 0, @@ -858,6 +1135,12 @@ typedef enum { QMI_NAS_DAY_OF_WEEK_SUNDAY = 6 } QmiNasDayOfWeek; +/** + * qmi_nas_day_of_week_get_string: + * + * Since: 1.4 + */ + /** * QmiNasDaylightSavingsAdjustment: * @QMI_NAS_DAYLIGHT_SAVINGS_ADJUSTMENT_NONE: no adjustment @@ -865,6 +1148,8 @@ typedef enum { * @QMI_NAS_DAYLIGHT_SAVINGS_ADJUSTMENT_TWO_HOURS: two hours adjustment * * The number of hours a time is adjusted for daylight savings. + * + * Since: 1.4 */ typedef enum { QMI_NAS_DAYLIGHT_SAVINGS_ADJUSTMENT_NONE = 0, @@ -872,6 +1157,12 @@ typedef enum { QMI_NAS_DAYLIGHT_SAVINGS_ADJUSTMENT_TWO_HOURS = 2 } QmiNasDaylightSavingsAdjustment; +/** + * qmi_nas_daylight_savings_adjustment_get_string: + * + * Since: 1.4 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI NAS Get Cell Location Info' request/response */ @@ -884,6 +1175,8 @@ typedef enum { * @QMI_NAS_WCDMA_RRC_STATE_CELL_DCH: WCDMA RRC state is CELL_DCH. * * RRC state. + * + * Since: 1.10 */ typedef enum { QMI_NAS_WCDMA_RRC_STATE_DISCONNECTED = 0, @@ -893,8 +1186,15 @@ typedef enum { QMI_NAS_WCDMA_RRC_STATE_CELL_DCH = 4 } QmiNasWcdmaRrcState; +/** + * qmi_nas_wcdma_rrc_state_get_string: + * + * Since: 1.10 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI NAS Get LTE Cphy CA Info' request/response */ + /** * QmiNasDLBandwidth: * @QMI_NAS_DL_BANDWIDTH_1_4: 1.4 MHz @@ -907,18 +1207,26 @@ typedef enum { * @QMI_NAS_DL_BANDWIDTH_UNKNOWN: Unknown * * DL Bandwidth. + * + * Since: 1.16 */ typedef enum { - QMI_NAS_DL_BANDWIDTH_1_4 = 0, - QMI_NAS_DL_BANDWIDTH_3, - QMI_NAS_DL_BANDWIDTH_5, - QMI_NAS_DL_BANDWIDTH_10, - QMI_NAS_DL_BANDWIDTH_15, - QMI_NAS_DL_BANDWIDTH_20, - QMI_NAS_DL_BANDWIDTH_INVALID, + QMI_NAS_DL_BANDWIDTH_1_4 = 0, + QMI_NAS_DL_BANDWIDTH_3 = 1, + QMI_NAS_DL_BANDWIDTH_5 = 2, + QMI_NAS_DL_BANDWIDTH_10 = 3, + QMI_NAS_DL_BANDWIDTH_15 = 4, + QMI_NAS_DL_BANDWIDTH_20 = 5, + QMI_NAS_DL_BANDWIDTH_INVALID = 6, QMI_NAS_DL_BANDWIDTH_UNKNOWN = 0xFF } QmiNasDLBandwidth; +/** + * qmi_nas_dl_bandwidth_get_string: + * + * Since: 1.16 + */ + /** * QmiNasScellState: * @QMI_NAS_SCELL_STATE_DECONFIGURED: Deconfigured @@ -926,11 +1234,19 @@ typedef enum { * @QMI_NAS_SCELL_STATE_ACTIVATED: Activated * * SCell State. + * + * Since: 1.16 */ typedef enum { QMI_NAS_SCELL_STATE_DECONFIGURED = 0, - QMI_NAS_SCELL_STATE_DEACTIVATED, - QMI_NAS_SCELL_STATE_ACTIVATED + QMI_NAS_SCELL_STATE_DEACTIVATED = 1, + QMI_NAS_SCELL_STATE_ACTIVATED = 2 } QmiNasScellState; +/** + * qmi_nas_scell_state_get_string: + * + * Since: 1.16 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_NAS_H_ */ diff --git a/src/libqmi-glib/qmi-enums-oma.h b/src/libqmi-glib/qmi-enums-oma.h index 6d4e826..66f56be 100644 --- a/src/libqmi-glib/qmi-enums-oma.h +++ b/src/libqmi-glib/qmi-enums-oma.h @@ -46,6 +46,8 @@ * @QMI_OMA_SESSION_TYPE_DEVICE_INITIATED_PRL_UPDATE: Device-initiated PRL update. * * Type of OMA-DM session. + * + * Since: 1.6 */ typedef enum { QMI_OMA_SESSION_TYPE_CLIENT_INITIATED_DEVICE_CONFIGURE = 0, @@ -57,6 +59,12 @@ typedef enum { QMI_OMA_SESSION_TYPE_DEVICE_INITIATED_PRL_UPDATE = 6 } QmiOmaSessionType; +/** + * qmi_oma_session_type_get_string: + * + * Since: 1.6 + */ + /** * QmiOmaSessionState: * @QMI_OMA_SESSION_STATE_COMPLETE_INFORMATION_UPDATED: Session complete and information updated. @@ -72,6 +80,8 @@ typedef enum { * @QMI_OMA_SESSION_STATE_MIP_PROFILE_DOWNLOADED: MIP profile downloaded. * * State of the OMA-DM session. + * + * Since: 1.6 */ typedef enum { QMI_OMA_SESSION_STATE_COMPLETE_INFORMATION_UPDATED = 0, @@ -87,6 +97,12 @@ typedef enum { QMI_OMA_SESSION_STATE_MIP_PROFILE_DOWNLOADED = 10 } QmiOmaSessionState; +/** + * qmi_oma_session_state_get_string: + * + * Since: 1.6 + */ + /** * QmiOmaSessionFailedReason: * @QMI_OMA_SESSION_FAILED_REASON_UNKNOWN: Unknown reason. @@ -97,6 +113,8 @@ typedef enum { * @QMI_OMA_SESSION_FAILED_REASON_SESSION_CANCELLED: Session cancelled. * * Session failure reason. + * + * Since: 1.6 */ typedef enum { QMI_OMA_SESSION_FAILED_REASON_UNKNOWN = 0, @@ -107,6 +125,12 @@ typedef enum { QMI_OMA_SESSION_FAILED_REASON_SESSION_CANCELLED = 5 } QmiOmaSessionFailedReason; +/** + * qmi_oma_session_failed_reason_get_string: + * + * Since: 1.6 + */ + /** * QmiOmaHfaFeatureDoneState: * @QMI_OMA_HFA_FEATURE_DONE_STATE_NONE: None. @@ -114,6 +138,8 @@ typedef enum { * @QMI_OMA_HFA_FEATURE_DONE_STATE_FAILED: Failed. * * HFA feature done state. + * + * Since: 1.6 */ typedef enum { QMI_OMA_HFA_FEATURE_DONE_STATE_NONE = 0, @@ -121,4 +147,10 @@ typedef enum { QMI_OMA_HFA_FEATURE_DONE_STATE_FAILED = 2 } QmiOmaHfaFeatureDoneState; +/** + * qmi_oma_hfa_feature_done_state_get_string: + * + * Since: 1.6 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_OMA_H_ */ diff --git a/src/libqmi-glib/qmi-enums-pbm.h b/src/libqmi-glib/qmi-enums-pbm.h index 2b10872..e0f6855 100644 --- a/src/libqmi-glib/qmi-enums-pbm.h +++ b/src/libqmi-glib/qmi-enums-pbm.h @@ -48,6 +48,8 @@ * @QMI_PBM_EVENT_REGISTRATION_FLAG_GAS_UPDATE: Request indications when Grouping information Alpha String records are added/edited/deleted. * * Flags to use to register to phonebook indications. + * + * Since: 1.6 */ typedef enum { QMI_PBM_EVENT_REGISTRATION_FLAG_RECORD_UPDATE = 1 << 0, @@ -58,6 +60,12 @@ typedef enum { QMI_PBM_EVENT_REGISTRATION_FLAG_GAS_UPDATE = 1 << 5, } QmiPbmEventRegistrationFlag; +/** + * qmi_pbm_event_registration_flag_build_string_from_mask: + * + * Since: 1.6 + */ + /*****************************************************************************/ /* Helper enums for the 'Get Capabilities' request */ @@ -73,6 +81,8 @@ typedef enum { * @QMI_PBM_PHONEBOOK_TYPE_MBN: Mail Box Number. * * Phonebook type. + * + * Since: 1.6 */ typedef enum { QMI_PBM_PHONEBOOK_TYPE_ADN = 1 << 0, @@ -85,6 +95,12 @@ typedef enum { QMI_PBM_PHONEBOOK_TYPE_MBN = 1 << 7, } QmiPbmPhonebookType; +/** + * qmi_pbm_phonebook_type_build_string_from_mask: + * + * Since: 1.6 + */ + /** * QmiPbmSessionType: * @QMI_PBM_SESSION_TYPE_GW_PRIMARY: Access phonebooks under GSM DF (ICC) or USIM application (UICC). @@ -97,6 +113,8 @@ typedef enum { * @QMI_PBM_SESSION_TYPE_GLOBAL_PHONEBOOK_SLOT_2: Access phonebooks that are not in any application of the card in slot 2. * * Type of phonebook management session. + * + * Since: 1.6 */ typedef enum { QMI_PBM_SESSION_TYPE_GW_PRIMARY = 0, @@ -109,4 +127,10 @@ typedef enum { QMI_PBM_SESSION_TYPE_GLOBAL_PHONEBOOK_SLOT_2 = 7, } QmiPbmSessionType; +/** + * qmi_pbm_session_type_get_string: + * + * Since: 1.6 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_PBM_H_ */ diff --git a/src/libqmi-glib/qmi-enums-pdc.h b/src/libqmi-glib/qmi-enums-pdc.h index a3ae19e..aea55c0 100644 --- a/src/libqmi-glib/qmi-enums-pdc.h +++ b/src/libqmi-glib/qmi-enums-pdc.h @@ -44,11 +44,18 @@ * @QMI_PDC_CONFIGURATION_TYPE_SOFTWARE: Software * * Configuration type for change/load configuration. + * + * Since: 1.18 */ typedef enum { QMI_PDC_CONFIGURATION_TYPE_PLATFORM = 0, QMI_PDC_CONFIGURATION_TYPE_SOFTWARE = 1, } QmiPdcConfigurationType; +/** + * qmi_pdc_configuration_type_get_string: + * + * Since: 1.18 + */ #endif /* _LIBQMI_GLIB_QMI_ENUMS_PDC_H_ */ diff --git a/src/libqmi-glib/qmi-enums-pds.h b/src/libqmi-glib/qmi-enums-pds.h index d9ced54..9bc0122 100644 --- a/src/libqmi-glib/qmi-enums-pds.h +++ b/src/libqmi-glib/qmi-enums-pds.h @@ -46,6 +46,8 @@ * @QMI_PDS_OPERATION_MODE_MS_ASSISTED: MS assisted. * * Operation mode used to compute the position. + * + * Since: 1.0 */ typedef enum { QMI_PDS_OPERATION_MODE_UNKNOWN = -1, @@ -54,6 +56,12 @@ typedef enum { QMI_PDS_OPERATION_MODE_MS_ASSISTED = 2 } QmiPdsOperationMode; +/** + * qmi_pds_operation_mode_get_string: + * + * Since: 1.0 + */ + /** * QmiPdsPositionSessionStatus: * @QMI_PDS_POSITION_SESSION_STATUS_SUCCESS: Success. @@ -67,6 +75,8 @@ typedef enum { * @QMI_PDS_POSITION_SESSION_STATUS_E911_SESSION_IN_PROGRESS: Emergency call in progress. * * Status of the positioning session. + * + * Since: 1.0 */ typedef enum { QMI_PDS_POSITION_SESSION_STATUS_SUCCESS = 0x00, @@ -80,6 +90,12 @@ typedef enum { QMI_PDS_POSITION_SESSION_STATUS_E911_SESSION_IN_PROGRESS = 0x08 } QmiPdsPositionSessionStatus; +/** + * qmi_pds_position_session_status_get_string: + * + * Since: 1.0 + */ + /** * QmiPdsDataValid: * @QMI_PDS_DATA_VALID_TIMESTAMP_CALENDAR: Timestamp calendar (GPS time). @@ -107,6 +123,8 @@ typedef enum { * @QMI_PDS_DATA_VALID_OPERATING_MODE: Operating mode. * * Flags to indicate which position data parameters are valid. + * + * Since: 1.0 */ typedef enum { QMI_PDS_DATA_VALID_TIMESTAMP_CALENDAR = 1 << 0, @@ -134,6 +152,12 @@ typedef enum { QMI_PDS_DATA_VALID_OPERATING_MODE = 1 << 22 } QmiPdsDataValid; +/** + * qmi_pds_data_valid_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI PDS Get GPS Service State' request/response */ @@ -144,6 +168,8 @@ typedef enum { * @QMI_PDS_TRACKING_SESSION_STATE_ACTIVE: Session active. * * State of the tracking session. + * + * Since: 1.0 */ typedef enum { QMI_PDS_TRACKING_SESSION_STATE_UNKNOWN = 0, @@ -151,6 +177,12 @@ typedef enum { QMI_PDS_TRACKING_SESSION_STATE_ACTIVE = 2 } QmiPdsTrackingSessionState; +/** + * qmi_pds_tracking_session_state_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI PDS Get Default Tracking Session' request/response */ @@ -161,6 +193,8 @@ typedef enum { * @QMI_PDS_OPERATING_MODE_MS_ASSISTED: MS-assisted (A-GPS). * * GPS operating mode. + * + * Since: 1.12 */ typedef enum { QMI_PDS_OPERATING_MODE_STANDALONE = 0, @@ -168,6 +202,12 @@ typedef enum { QMI_PDS_OPERATING_MODE_MS_ASSISTED = 2, } QmiPdsOperatingMode; +/** + * qmi_pds_operating_mode_get_string: + * + * Since: 1.12 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI PDS Get AGPS Config' request/response */ @@ -177,10 +217,18 @@ typedef enum { * @QMI_PDS_NETWORK_MODE_CDMA: CDMA. * * Network mode used during the A-GPS setup. + * + * Since: 1.12 */ typedef enum { QMI_PDS_NETWORK_MODE_UMTS = 0, QMI_PDS_NETWORK_MODE_CDMA = 1, } QmiPdsNetworkMode; +/** + * qmi_pds_network_mode_get_string: + * + * Since: 1.12 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_PDS_H_ */ diff --git a/src/libqmi-glib/qmi-enums-uim.h b/src/libqmi-glib/qmi-enums-uim.h index 58ea549..13db6be 100644 --- a/src/libqmi-glib/qmi-enums-uim.h +++ b/src/libqmi-glib/qmi-enums-uim.h @@ -52,6 +52,8 @@ * @QMI_UIM_SESSION_TYPE_LOGICAL_CHANNEL_SLOT_2: Logical channel on slot 2. * * Type of UIM session. + * + * Since: 1.6 */ typedef enum { QMI_UIM_SESSION_TYPE_PRIMARY_GW_PROVISIONING = 0, @@ -66,6 +68,12 @@ typedef enum { QMI_UIM_SESSION_TYPE_LOGICAL_CHANNEL_SLOT_2 = 9 } QmiUimSessionType; +/** + * qmi_uim_session_type_get_string: + * + * Since: 1.6 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI UIM Get File Attributes' request/response */ @@ -78,6 +86,8 @@ typedef enum { * @QMI_UIM_FILE_TYPE_MASTER_FILE: Master file. * * Type of UIM file. + * + * Since: 1.6 */ typedef enum { QMI_UIM_FILE_TYPE_TRANSPARENT = 0, @@ -87,6 +97,12 @@ typedef enum { QMI_UIM_FILE_TYPE_MASTER_FILE = 4 } QmiUimFileType; +/** + * qmi_uim_file_type_get_string: + * + * Since: 1.6 + */ + /** * QmiUimSecurityAttributeLogic: * @QMI_UIM_SECURITY_ATTRIBUTE_LOGIC_ALWAYS: Always. @@ -96,6 +112,8 @@ typedef enum { * @QMI_UIM_SECURITY_ATTRIBUTE_LOGIC_SINGLE: Single. * * Logic applicable to security attributes. + * + * Since: 1.6 */ typedef enum { QMI_UIM_SECURITY_ATTRIBUTE_LOGIC_ALWAYS = 0, @@ -105,6 +123,12 @@ typedef enum { QMI_UIM_SECURITY_ATTRIBUTE_LOGIC_SINGLE = 4 } QmiUimSecurityAttributeLogic; +/** + * qmi_uim_security_attribute_logic_get_string: + * + * Since: 1.6 + */ + /** * QmiUimSecurityAttribute: * @QMI_UIM_SECURITY_ATTRIBUTE_PIN1: PIN1. @@ -113,6 +137,8 @@ typedef enum { * @QMI_UIM_SECURITY_ATTRIBUTE_ADM: ADM. * * Security Attributes. + * + * Since: 1.6 */ typedef enum { QMI_UIM_SECURITY_ATTRIBUTE_PIN1 = 1 << 0, @@ -121,6 +147,12 @@ typedef enum { QMI_UIM_SECURITY_ATTRIBUTE_ADM = 1 << 3 } QmiUimSecurityAttribute; +/** + * qmi_uim_security_attribute_build_string_from_mask: + * + * Since: 1.6 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI UIM Set PIN Protection' */ @@ -133,6 +165,8 @@ typedef enum { * @QMI_UIM_PIN_ID_HIDDEN_KEY: Hidden key. * * PIN ID. + * + * Since: 1.14 */ typedef enum { QMI_UIM_PIN_ID_UNKNOWN = 0, @@ -142,6 +176,12 @@ typedef enum { QMI_UIM_PIN_ID_HIDDEN_KEY = 4 } QmiUimPinId; +/** + * qmi_uim_pin_id_get_string: + * + * Since: 1.14 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI UIM Get Card Status' request/response */ @@ -152,6 +192,8 @@ typedef enum { * @QMI_UIM_CARD_STATE_ERROR: Error. * * State of the card. + * + * Since: 1.10 */ typedef enum { QMI_UIM_CARD_STATE_ABSENT = 0, @@ -159,6 +201,12 @@ typedef enum { QMI_UIM_CARD_STATE_ERROR = 2 } QmiUimCardState; +/** + * qmi_uim_card_state_get_string: + * + * Since: 1.10 + */ + /** * QmiUimPinState: * @QMI_UIM_PIN_STATE_NOT_INITIALIZED: Not initialized. @@ -169,6 +217,8 @@ typedef enum { * @QMI_UIM_PIN_STATE_PERMANENTLY_BLOCKED: Permanently Blocked. * * The PIN state. + * + * Since: 1.10 */ typedef enum { QMI_UIM_PIN_STATE_NOT_INITIALIZED = 0, @@ -179,6 +229,12 @@ typedef enum { QMI_UIM_PIN_STATE_PERMANENTLY_BLOCKED = 5, } QmiUimPinState; +/** + * qmi_uim_pin_state_get_string: + * + * Since: 1.10 + */ + /** * QmiUimCardError: * @QMI_UIM_CARD_ERROR_UNKNOWN: Unknown error. @@ -191,6 +247,8 @@ typedef enum { * @QMI_UIM_CARD_ERROR_TECHNICAL: Technical problem. * * Card error. + * + * Since: 1.10 */ typedef enum { QMI_UIM_CARD_ERROR_UNKNOWN = 0, @@ -203,6 +261,12 @@ typedef enum { QMI_UIM_CARD_ERROR_TECHNICAL = 7 } QmiUimCardError; +/** + * qmi_uim_card_error_get_string: + * + * Since: 1.10 + */ + /** * QmiUimCardApplicationType: * @QMI_UIM_CARD_APPLICATION_TYPE_UNKNOWN: Unknown. @@ -213,6 +277,8 @@ typedef enum { * @QMI_UIM_CARD_APPLICATION_TYPE_ISIM: ISIM. * * Card application type. + * + * Since: 1.10 */ typedef enum { QMI_UIM_CARD_APPLICATION_TYPE_UNKNOWN = 0, @@ -223,6 +289,12 @@ typedef enum { QMI_UIM_CARD_APPLICATION_TYPE_ISIM = 5, } QmiUimCardApplicationType; +/** + * qmi_uim_card_application_type_get_string: + * + * Since: 1.10 + */ + /** * QmiUimCardApplicationState: * @QMI_UIM_CARD_APPLICATION_STATE_UNKNOWN: Unknown. @@ -235,6 +307,8 @@ typedef enum { * @QMI_UIM_CARD_APPLICATION_STATE_READY: Ready * * Card application state. + * + * Since: 1.10 */ typedef enum { QMI_UIM_CARD_APPLICATION_STATE_UNKNOWN = 0, @@ -247,6 +321,12 @@ typedef enum { QMI_UIM_CARD_APPLICATION_STATE_READY = 7, } QmiUimCardApplicationState; +/** + * qmi_uim_card_application_state_get_string: + * + * Since: 1.10 + */ + /** * QmiUimCardApplicationPersonalizationState: * @QMI_UIM_CARD_APPLICATION_PERSONALIZATION_STATE_UNKNOWN: Unknown. @@ -257,6 +337,8 @@ typedef enum { * @QMI_UIM_CARD_APPLICATION_PERSONALIZATION_STATE_PERMANENTLY_BLOCKED: Permanently blocked- * * Card application personalization state. + * + * Since: 1.10 */ typedef enum { QMI_UIM_CARD_APPLICATION_PERSONALIZATION_STATE_UNKNOWN = 0, @@ -267,6 +349,12 @@ typedef enum { QMI_UIM_CARD_APPLICATION_PERSONALIZATION_STATE_PERMANENTLY_BLOCKED = 5, } QmiUimCardApplicationPersonalizationState; +/** + * qmi_uim_card_application_personalization_state_get_string: + * + * Since: 1.10 + */ + /** * QmiUimCardApplicationPersonalizationFeature: * @QMI_UIM_CARD_APPLICATION_PERSONALIZATION_FEATURE_GW_NETWORK: GW network. @@ -283,6 +371,8 @@ typedef enum { * @QMI_UIM_CARD_APPLICATION_PERSONALIZATION_FEATURE_UNKNOWN: Unknown. * * Card application personalization feature, when a code is required. + * + * Since: 1.10 */ typedef enum { QMI_UIM_CARD_APPLICATION_PERSONALIZATION_FEATURE_GW_NETWORK = 0, @@ -299,4 +389,10 @@ typedef enum { QMI_UIM_CARD_APPLICATION_PERSONALIZATION_FEATURE_UNKNOWN = 11 } QmiUimCardApplicationPersonalizationFeature; +/** + * qmi_uim_card_application_personalization_feature_get_string: + * + * Since: 1.10 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_UIM_H_ */ diff --git a/src/libqmi-glib/qmi-enums-voice.h b/src/libqmi-glib/qmi-enums-voice.h index 1eb576c..1fc1941 100644 --- a/src/libqmi-glib/qmi-enums-voice.h +++ b/src/libqmi-glib/qmi-enums-voice.h @@ -53,6 +53,8 @@ * @QMI_VOICE_CALL_STATE_SETUP: MT call is in setup state (3GPP). * * State of a call. + * + * Since: 1.14 */ typedef enum { QMI_VOICE_CALL_STATE_UNKNOWN = 0x00, @@ -68,6 +70,12 @@ typedef enum { QMI_VOICE_CALL_STATE_SETUP = 0x0A, } QmiVoiceCallState; +/** + * qmi_voice_call_state_get_string: + * + * Since: 1.14 + */ + /** * QmiVoiceCallType: * @QMI_VOICE_CALL_TYPE_VOICE: Voice call. @@ -78,6 +86,8 @@ typedef enum { * @QMI_VOICE_CALL_TYPE_SUPS: Supplementary service. * * Type of a voice call. + * + * Since: 1.14 */ typedef enum { QMI_VOICE_CALL_TYPE_VOICE = 0x00, @@ -88,6 +98,12 @@ typedef enum { QMI_VOICE_CALL_TYPE_SUPS = 0x0A, } QmiVoiceCallType; +/** + * qmi_voice_call_type_get_string: + * + * Since: 1.14 + */ + /** * QmiVoiceCallDirection: * @QMI_VOICE_CALL_DIRECTION_UNKNOWN: Unknown. @@ -95,6 +111,8 @@ typedef enum { * @QMI_VOICE_CALL_DIRECTION_MT: Mobile-terminated. * * Call direction. + * + * Since: 1.14 */ typedef enum { QMI_VOICE_CALL_DIRECTION_UNKNOWN = 0x00, @@ -102,6 +120,12 @@ typedef enum { QMI_VOICE_CALL_DIRECTION_MT = 0x02, } QmiVoiceCallDirection; +/** + * qmi_voice_call_direction_get_string: + * + * Since: 1.14 + */ + /** * QmiVoiceCallMode: * @QMI_VOICE_CALL_MODE_UNKNOWN: Unknown. @@ -111,6 +135,8 @@ typedef enum { * @QMI_VOICE_CALL_MODE_LTE: LTE. * * Call mode. + * + * Since: 1.14 */ typedef enum { QMI_VOICE_CALL_MODE_UNKNOWN = 0x00, @@ -120,18 +146,32 @@ typedef enum { QMI_VOICE_CALL_MODE_LTE = 0x04, } QmiVoiceCallMode; +/** + * qmi_voice_call_mode_get_string: + * + * Since: 1.14 + */ + /** * QmiVoiceAls: * @QMI_VOICE_ALS_LINE_1: Line 1 (default). * @QMI_VOICE_ALS_LINE_2: Line 2. * * ALS line indicator. + * + * Since: 1.14 */ typedef enum { QMI_VOICE_ALS_LINE_1 = 0x00, QMI_VOICE_ALS_LINE_2 = 0x01, } QmiVoiceAls; +/** + * qmi_voice_als_get_string: + * + * Since: 1.14 + */ + /** * QmiVoicePresentation: * @QMI_VOICE_PRESENTATION_ALLOWED: Allowed presentation. @@ -140,6 +180,8 @@ typedef enum { * @QMI_VOICE_PRESENTATION_PAYPHONE: Payphone presentation (3GPP only). * * Remote party number presentation indicator. + * + * Since: 1.14 */ typedef enum { QMI_VOICE_PRESENTATION_ALLOWED = 0x00, @@ -148,6 +190,12 @@ typedef enum { QMI_VOICE_PRESENTATION_PAYPHONE = 0x04, } QmiVoicePresentation; +/** + * qmi_voice_presentation_get_string: + * + * Since: 1.14 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI Voice Get Config' request/response */ @@ -160,6 +208,7 @@ typedef enum { * * TTY mode. * + * Since: 1.14 */ typedef enum { QMI_VOICE_TTY_MODE_FULL = 0x00, @@ -168,6 +217,12 @@ typedef enum { QMI_VOICE_TTY_MODE_OFF = 0x03, } QmiVoiceTtyMode; +/** + * qmi_voice_tty_mode_get_string: + * + * Since: 1.14 + */ + /** * QmiVoiceServiceOption: * @QMI_VOICE_SERVICE_OPTION_WILD: Any service option. @@ -182,6 +237,8 @@ typedef enum { * @QMI_VOICE_SERVICE_OPTION_WVRC: WVRC. * * Service option. + * + * Since: 1.14 */ typedef enum { QMI_VOICE_SERVICE_OPTION_WILD = 0x0000, @@ -196,6 +253,12 @@ typedef enum { QMI_VOICE_SERVICE_OPTION_WVRC = 0x8023, } QmiVoiceServiceOption; +/** + * qmi_voice_service_option_get_string: + * + * Since: 1.14 + */ + /** * QmiVoiceWcdmaAmrStatus: * @QMI_VOICE_WCDMA_AMR_STATUS_NOT_SUPPORTED: Not supported. @@ -205,6 +268,8 @@ typedef enum { * @QMI_VOICE_WCDMA_AMR_STATUS_GSM_AMR_NB: GSM AMR narrowband. * * WCDMA AMR status. + * + * Since: 1.14 */ typedef enum { QMI_VOICE_WCDMA_AMR_STATUS_NOT_SUPPORTED = 1 << 0, @@ -214,18 +279,32 @@ typedef enum { QMI_VOICE_WCDMA_AMR_STATUS_GSM_AMR_NB = 1 << 4, } QmiVoiceWcdmaAmrStatus; +/** + * qmi_voice_wcdma_amr_status_build_string_from_mask: + * + * Since: 1.14 + */ + /** * QmiVoicePrivacy: * @QMI_VOICE_PRIVACY_STANDARD: Standard. * @QMI_VOICE_PRIVACY_ENHANCED: Enhanced. * * Voice privacy. + * + * Since: 1.14 */ typedef enum { QMI_VOICE_PRIVACY_STANDARD = 0x00, QMI_VOICE_PRIVACY_ENHANCED = 0x01, } QmiVoicePrivacy; +/** + * qmi_voice_privacy_get_string: + * + * Since: 1.14 + */ + /** * QmiVoiceDomain: * @QMI_VOICE_DOMAIN_CS_ONLY: CS-only. @@ -234,6 +313,8 @@ typedef enum { * @QMI_VOICE_DOMAIN_PS_PREFERRED: PS preferred, CS secondary. * * Voice domain preference. + * + * Since: 1.14 */ typedef enum { QMI_VOICE_DOMAIN_CS_ONLY = 0x00, @@ -242,4 +323,10 @@ typedef enum { QMI_VOICE_DOMAIN_PS_PREFERRED = 0x03, } QmiVoiceDomain; +/** + * qmi_voice_domain_get_string: + * + * Since: 1.14 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_VOICE_H_ */ diff --git a/src/libqmi-glib/qmi-enums-wda.h b/src/libqmi-glib/qmi-enums-wda.h index d197d4e..15fe405 100644 --- a/src/libqmi-glib/qmi-enums-wda.h +++ b/src/libqmi-glib/qmi-enums-wda.h @@ -42,6 +42,8 @@ * @QMI_WDA_LINK_LAYER_PROTOCOL_RAW_IP: Raw IP mode. * * Link layer protocol. + * + * Since: 1.10 */ typedef enum { QMI_WDA_LINK_LAYER_PROTOCOL_UNKNOWN = 0x00, @@ -49,6 +51,12 @@ typedef enum { QMI_WDA_LINK_LAYER_PROTOCOL_RAW_IP = 0x02, } QmiWdaLinkLayerProtocol; +/** + * qmi_wda_link_layer_protocol_get_string: + * + * Since: 1.10 + */ + /** * QmiWdaDataAggregationProtocol: * @QMI_WDA_DATA_AGGREGATION_PROTOCOL_DISABLED: Disabled. @@ -59,6 +67,8 @@ typedef enum { * @QMI_WDA_DATA_AGGREGATION_PROTOCOL_QMAP: QMAP enabled. * * Data aggregation protocol in uplink or downlink. + * + * Since: 1.10 */ typedef enum { QMI_WDA_DATA_AGGREGATION_PROTOCOL_DISABLED = 0x00, @@ -69,4 +79,10 @@ typedef enum { QMI_WDA_DATA_AGGREGATION_PROTOCOL_QMAP = 0x05, } QmiWdaDataAggregationProtocol; +/** + * qmi_wda_data_aggregation_protocol_get_string: + * + * Since: 1.10 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_WDA_H_ */ diff --git a/src/libqmi-glib/qmi-enums-wds.h b/src/libqmi-glib/qmi-enums-wds.h index a8ebadc..094c4fd 100644 --- a/src/libqmi-glib/qmi-enums-wds.h +++ b/src/libqmi-glib/qmi-enums-wds.h @@ -44,12 +44,14 @@ /** * QmiWdsIpFamily: - * @QMI_WDS_IP_FAMILY_UNKNOWN: unknown. + * @QMI_WDS_IP_FAMILY_UNKNOWN: unknown. Since: 1.18. * @QMI_WDS_IP_FAMILY_IPV4: IPv4. * @QMI_WDS_IP_FAMILY_IPV6: IPv6. * @QMI_WDS_IP_FAMILY_UNSPECIFIED: None specified. * * Type of IP family. + * + * Since: 1.0 */ typedef enum { QMI_WDS_IP_FAMILY_UNKNOWN = 0, @@ -58,18 +60,32 @@ typedef enum { QMI_WDS_IP_FAMILY_UNSPECIFIED = 8 } QmiWdsIpFamily; +/** + * qmi_wds_ip_family_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsTechnologyPreference: * @QMI_WDS_TECHNOLOGY_PREFERENCE_ALLOW_3GPP: 3GPP allowed. * @QMI_WDS_TECHNOLOGY_PREFERENCE_ALLOW_3GPP2: 3GPP2 allowed. * * Type of network allowed when trying to connect. + * + * Since: 1.0 */ typedef enum { QMI_WDS_TECHNOLOGY_PREFERENCE_ALLOW_3GPP = 1 << 0, QMI_WDS_TECHNOLOGY_PREFERENCE_ALLOW_3GPP2 = 1 << 1 } QmiWdsTechnologyPreference; +/** + * qmi_wds_technology_preference_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsExtendedTechnologyPreference: * @QMI_WDS_EXTENDED_TECHNOLOGY_PREFERENCE_CDMA: Use CDMA. @@ -79,6 +95,8 @@ typedef enum { * @QMI_WDS_EXTENDED_TECHNOLOGY_PREFERENCE_MODEM_LINK_LOCAL: Use modem link-local. * * Type of network allowed when trying to connect. + * + * Since: 1.0 */ typedef enum { QMI_WDS_EXTENDED_TECHNOLOGY_PREFERENCE_CDMA = 32769, @@ -88,18 +106,32 @@ typedef enum { QMI_WDS_EXTENDED_TECHNOLOGY_PREFERENCE_MODEM_LINK_LOCAL = 34952, } QmiWdsExtendedTechnologyPreference; +/** + * qmi_wds_extended_technology_preference_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsCallType: * @QMI_WDS_CALL_TYPE_LAPTOP: Laptop call. * @QMI_WDS_CALL_TYPE_EMBEDDED: Embedded call. * * Type of call to originate. + * + * Since: 1.0 */ typedef enum { QMI_WDS_CALL_TYPE_LAPTOP = 0, QMI_WDS_CALL_TYPE_EMBEDDED = 1 } QmiWdsCallType; +/** + * qmi_wds_call_type_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsCallEndReason: * @QMI_WDS_CALL_END_REASON_GENERIC_UNSPECIFIED: Unspecified reason. @@ -176,6 +208,8 @@ typedef enum { * @QMI_WDS_CALL_END_REASON_EVDO_HDR_RELEASED_BY_CM: (EV-DO) Released HDR call by call manager. * * Reason for ending the call. + * + * Since: 1.0 */ typedef enum { /* Generic reasons */ @@ -259,6 +293,12 @@ typedef enum { QMI_WDS_CALL_END_REASON_EVDO_HDR_RELEASED_BY_CM = 1507 } QmiWdsCallEndReason; +/** + * qmi_wds_call_end_reason_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsVerboseCallEndReasonType: * @QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_MIP: Mobile IP. @@ -268,8 +308,10 @@ typedef enum { * @QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_PPP: PPP. * @QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_EHRPD: eHRPD. * @QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_IPV6: IPv6. - * + * * Type of verbose call end reason. + * + * Since: 1.0 */ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_MIP = 1, @@ -281,8 +323,23 @@ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_IPV6 = 9 } QmiWdsVerboseCallEndReasonType; +/** + * qmi_wds_verbose_call_end_reason_type_get_string: + * + * Since: 1.0 + */ + +/** + * qmi_wds_verbose_call_end_reason_get_string: + * @type: a #QmiWdsVerboseCallEndReasonType. + * @reason: the reason id. + * + * Get verbose call end reason based on the reason type. + * + * Since: 1.0 + */ const gchar *qmi_wds_verbose_call_end_reason_get_string (QmiWdsVerboseCallEndReasonType type, - gint16 reason); + gint16 reason); /** * QmiWdsVerboseCallEndReasonMip: @@ -319,6 +376,8 @@ const gchar *qmi_wds_verbose_call_end_reason_get_string (QmiWdsVerboseCallEndRea * @QMI_WDS_VERBOSE_CALL_END_REASON_MIP_HA_ERROR_ENCAPSULATION_UNAVAILABLE: (HA error) Encapsulation unavailable. * * Mobile IP specific call end reasons, given when the @QmiWdsVerboseCallEndReasonType is #QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_MIP. + * + * Since: 1.0 */ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_MIP_ERROR_REASON_UNKNOWN = -1, @@ -358,6 +417,12 @@ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_MIP_HA_ERROR_ENCAPSULATION_UNAVAILABLE = 139 } QmiWdsVerboseCallEndReasonMip; +/** + * qmi_wds_verbose_call_end_reason_mip_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsVerboseCallEndReasonInternal: * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_ERROR: Internal error. @@ -367,24 +432,26 @@ typedef enum { * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_CLOSE_IN_PROGRESS: Close in progress. * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_NETWORK_INITIATED_TERMINATION: Network initiated termination. * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_APP_PREEMPTED: App preempted. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PDN_IPV4_CALL_DISALLOWED: PDN IPv4 call disallowed. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PDN_IPV4_CALL_THROTTLED: PDN IPv4 call throttled. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PDN_IPV6_CALL_DISALLOWED: PDN IPv6 call disallowed. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PDN_IPV6_CALL_THROTTLED: PDN IPv6 call throttled. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_MODEM_RESTART: Modem restart. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PDP_PPP_NOT_SUPPORTED: PDP PPP not supported. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_UNPREFERRED_RAT: Unpreferred RAT. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PHYSICAL_LINK_CLOSE_IN_PROGRESS: Physical link close in progress. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_APN_PENDING_HANDOVER: APN pending handover. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PROFILE_BEARER_INCOMPATIBLE: Profile bearer incompatible. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_MMGDSI_CARD_EVENT: MMGDSI Card event. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_LPM_OR_POWER_DOWN: LPM or power down. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_APN_DISABLED: APN disabled. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_MPIT_EXPIRED: MPIT expired. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_IPV6_ADDRESS_TRANSFER_FAILED: IPv6 address transfer failed. - * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_TRAT_SWAP_FAILED: TRAT swap failed. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PDN_IPV4_CALL_DISALLOWED: PDN IPv4 call disallowed. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PDN_IPV4_CALL_THROTTLED: PDN IPv4 call throttled. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PDN_IPV6_CALL_DISALLOWED: PDN IPv6 call disallowed. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PDN_IPV6_CALL_THROTTLED: PDN IPv6 call throttled. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_MODEM_RESTART: Modem restart. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PDP_PPP_NOT_SUPPORTED: PDP PPP not supported. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_UNPREFERRED_RAT: Unpreferred RAT. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PHYSICAL_LINK_CLOSE_IN_PROGRESS: Physical link close in progress. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_APN_PENDING_HANDOVER: APN pending handover. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_PROFILE_BEARER_INCOMPATIBLE: Profile bearer incompatible. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_MMGDSI_CARD_EVENT: MMGDSI Card event. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_LPM_OR_POWER_DOWN: LPM or power down. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_APN_DISABLED: APN disabled. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_MPIT_EXPIRED: MPIT expired. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_IPV6_ADDRESS_TRANSFER_FAILED: IPv6 address transfer failed. Since: 1.14. + * @QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_TRAT_SWAP_FAILED: TRAT swap failed. Since: 1.14. * * Internal call end reasons, given when the @QmiWdsVerboseCallEndReasonType is #QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_INTERNAL. + * + * Since: 1.0 */ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_ERROR = 201, @@ -412,6 +479,12 @@ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_INTERNAL_TRAT_SWAP_FAILED = 223, } QmiWdsVerboseCallEndReasonInternal; +/** + * qmi_wds_verbose_call_end_reason_internal_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsVerboseCallEndReasonCm: * @QMI_WDS_VERBOSE_CALL_END_REASON_CM_CDMA_LOCK: (CDMA) Phone is CDMA-locked. @@ -467,6 +540,8 @@ typedef enum { * @QMI_WDS_VERBOSE_CALL_END_REASON_CM_REDIRECTION_OR_HANDOFF: Redirection or handoff. * * Call manager specific call end reasons, given when the @QmiWdsVerboseCallEndReasonType is #QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_CM. + * + * Since: 1.0 */ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_CM_CDMA_LOCK = 500, @@ -525,6 +600,12 @@ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_CM_REDIRECTION_OR_HANDOFF = 2006 } QmiWdsVerboseCallEndReasonCm; +/** + * qmi_wds_verbose_call_end_reason_cm_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsVerboseCallEndReason3gpp: * @QMI_WDS_VERBOSE_CALL_END_REASON_3GPP_OPERATOR_DETERMINED_BARRING: Operator-determined barring. @@ -568,6 +649,8 @@ typedef enum { * @QMI_WDS_VERBOSE_CALL_END_REASON_3GPP_APN_TYPE_CONFLICT: APN type conflict. * * 3GPP-specific call end reasons, given when the @QmiWdsVerboseCallEndReasonType is #QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_3GPP. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_wds_verbose_call_end_reason_3gpp >*/ QMI_WDS_VERBOSE_CALL_END_REASON_3GPP_OPERATOR_DETERMINED_BARRING = 8, @@ -616,6 +699,12 @@ typedef enum { /*< underscore_name=qmi_wds_verbose_call_end_reason_3gpp >*/ QMI_WDS_VERBOSE_CALL_END_REASON_3GPP_APN_TYPE_CONFLICT = 112 } QmiWdsVerboseCallEndReason3gpp; +/** + * qmi_wds_verbose_call_end_reason_3gpp_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsVerboseCallEndReasonPpp: * @QMI_WDS_VERBOSE_CALL_END_REASON_PPP_UNKNOWN: Unknown error. @@ -626,6 +715,8 @@ typedef enum { /*< underscore_name=qmi_wds_verbose_call_end_reason_3gpp >*/ * @QMI_WDS_VERBOSE_CALL_END_REASON_PPP_CHAP_FAILURE: CHAP failure. * * PPP-specific call end reasons, given when the @QmiWdsVerboseCallEndReasonType is #QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_PPP. + * + * Since: 1.0 */ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_PPP_UNKNOWN = -1, @@ -638,6 +729,12 @@ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_PPP_CHAP_FAILURE = 32 } QmiWdsVerboseCallEndReasonPpp; +/** + * qmi_wds_verbose_call_end_reason_ppp_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsVerboseCallEndReasonEhrpd: * @QMI_WDS_VERBOSE_CALL_END_REASON_EHRPD_SUBSCRIPTION_LIMITED_TO_IPV4: Subscription limited to IPv4. @@ -658,6 +755,8 @@ typedef enum { * @QMI_WDS_VERBOSE_CALL_END_REASON_EHRPD_VSNCP_3GPP2_PDN_EXISTS_FOR_THIS_APN: (VSCNP) 3GPP2 PDN exists for this APN. * * eHRPD-specific call end reasons, given when the @QmiWdsVerboseCallEndReasonType is #QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_EHRPD. + * + * Since: 1.0 */ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_EHRPD_SUBSCRIPTION_LIMITED_TO_IPV4 = 1, @@ -679,18 +778,32 @@ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_EHRPD_VSNCP_3GPP2_PDN_EXISTS_FOR_THIS_APN = 17 } QmiWdsVerboseCallEndReasonEhrpd; +/** + * qmi_wds_verbose_call_end_reason_ehrpd_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsVerboseCallEndReasonIpv6: * @QMI_WDS_VERBOSE_CALL_END_REASON_IPV6_PREFIX_UNAVAILABLE: Prefix unavailable. * @QMI_WDS_VERBOSE_CALL_END_REASON_IPV6_HRPD_IPV6_DISABLED: HRDP IPv6 disabled. * * IPv6-specific call end reasons, given when the @QmiWdsVerboseCallEndReasonType is #QMI_WDS_VERBOSE_CALL_END_REASON_TYPE_IPV6. + * + * Since: 1.0 */ typedef enum { QMI_WDS_VERBOSE_CALL_END_REASON_IPV6_PREFIX_UNAVAILABLE = 1, QMI_WDS_VERBOSE_CALL_END_REASON_IPV6_HRPD_IPV6_DISABLED = 2 } QmiWdsVerboseCallEndReasonIpv6; +/** + * qmi_wds_verbose_call_end_reason_ipv6_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI WDS Get Packet Service Status' message */ @@ -703,6 +816,8 @@ typedef enum { * @QMI_WDS_CONNECTION_STATUS_AUTHENTICATING: Network authentication is ongoing. * * Status of the network connection. + * + * Since: 1.0 */ typedef enum { QMI_WDS_CONNECTION_STATUS_UNKNOWN = 0, @@ -712,6 +827,11 @@ typedef enum { QMI_WDS_CONNECTION_STATUS_AUTHENTICATING = 4 } QmiWdsConnectionStatus; +/** + * qmi_wds_connection_status_get_string: + * + * Since: 1.0 + */ /*****************************************************************************/ /* Helper enums for the 'QMI WDS Get Data Bearer Technology' message */ @@ -734,13 +854,15 @@ typedef enum { * @QMI_WDS_DATA_BEARER_TECHNOLOGY_HSDPAPLUS_HSUPA: HSDPA+ and HSUPA. * @QMI_WDS_DATA_BEARER_TECHNOLOGY_DCHSDPAPLUS: DC-HSDPA+ and WCDMA. * @QMI_WDS_DATA_BEARER_TECHNOLOGY_DCHSDPAPLUS_HSUPA: DC-HSDPA+ and HSUPA. - * @QMI_WDS_DATA_BEARER_TECHNOLOGY_HSDPAPLUS_PLUS_64QAM: HSDPA+ with 64QAM. - * @QMI_WDS_DATA_BEARER_TECHNOLOGY_HSDPAPLUS_PLUS_64QAM_HSUPA: HSDPA+ with 64QAM and HSUPA. - * @QMI_WDS_DATA_BEARER_TECHNOLOGY_TDSCDMA: TD-SCDMA. - * @QMI_WDS_DATA_BEARER_TECHNOLOGY_TDSCDMA_HSDPA: TD-SCDMA and HSDPA. - * @QMI_WDS_DATA_BEARER_TECHNOLOGY_TDSCDMA_HSUPA: TD-SCDMA and HSUPA. + * @QMI_WDS_DATA_BEARER_TECHNOLOGY_HSDPAPLUS_PLUS_64QAM: HSDPA+ with 64QAM. Since: 1.18. + * @QMI_WDS_DATA_BEARER_TECHNOLOGY_HSDPAPLUS_PLUS_64QAM_HSUPA: HSDPA+ with 64QAM and HSUPA. Since: 1.18. + * @QMI_WDS_DATA_BEARER_TECHNOLOGY_TDSCDMA: TD-SCDMA. Since: 1.18. + * @QMI_WDS_DATA_BEARER_TECHNOLOGY_TDSCDMA_HSDPA: TD-SCDMA and HSDPA. Since: 1.18. + * @QMI_WDS_DATA_BEARER_TECHNOLOGY_TDSCDMA_HSUPA: TD-SCDMA and HSUPA. Since: 1.18. * * Data bearer technology. + * + * Since: 1.0 */ typedef enum { QMI_WDS_DATA_BEARER_TECHNOLOGY_UNKNOWN = -1, @@ -766,6 +888,11 @@ typedef enum { QMI_WDS_DATA_BEARER_TECHNOLOGY_TDSCDMA_HSUPA = 0x14, } QmiWdsDataBearerTechnology; +/** + * qmi_wds_data_bearer_technology_get_string: + * + * Since: 1.0 + */ /*****************************************************************************/ /* Helper enums for the 'QMI WDS Get Current Data Bearer Technology' message */ @@ -777,6 +904,8 @@ typedef enum { * @QMI_WDS_NETWORK_TYPE_3GPP: 3GPP network type. * * Network type of the data bearer. + * + * Since: 1.0 */ typedef enum { QMI_WDS_NETWORK_TYPE_UNKNOWN = 0, @@ -784,18 +913,32 @@ typedef enum { QMI_WDS_NETWORK_TYPE_3GPP = 2 } QmiWdsNetworkType; +/** + * qmi_wds_network_type_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsDataSystemNetworkType: * @QMI_WDS_DATA_SYSTEM_NETWORK_TYPE_3GPP2: 3GPP2 network type. * @QMI_WDS_DATA_SYSTEM_NETWORK_TYPE_3GPP: 3GPP network type. * * Network type of the data system. + * + * Since: 1.14 */ typedef enum { - QMI_WDS_DATA_SYSTEM_NETWORK_TYPE_3GPP = 0, - QMI_WDS_DATA_SYSTEM_NETWORK_TYPE_3GPP2 = 1, + QMI_WDS_DATA_SYSTEM_NETWORK_TYPE_3GPP = 0, + QMI_WDS_DATA_SYSTEM_NETWORK_TYPE_3GPP2 = 1, } QmiWdsDataSystemNetworkType; +/** + * qmi_wds_data_system_network_type_get_string: + * + * Since: 1.14 + */ + /** * QmiWdsDataSystem: * @QMI_WDS_DATA_SYSTEM_UNKNOWN: unknown @@ -807,6 +950,8 @@ typedef enum { * @QMI_WDS_DATA_SYSTEM_TDSCDMA: TD-SCDMA. * * Data system type. + * + * Since: 1.18 */ typedef enum { QMI_WDS_DATA_SYSTEM_UNKNOWN = 0, @@ -818,6 +963,12 @@ typedef enum { QMI_WDS_DATA_SYSTEM_TDSCDMA = 6, } QmiWdsDataSystem; +/** + * qmi_wds_data_system_type_get_string: + * + * Since: 1.18 + */ + /** * QmiWdsRat3gpp2: * @QMI_WDS_RAT_3GPP2_NONE: Unknown, to be ignored. @@ -825,12 +976,14 @@ typedef enum { * @QMI_WDS_RAT_3GPP2_EVDO_REV0: EVDO Rev0. * @QMI_WDS_RAT_3GPP2_EVDO_REVA: EVDO RevA. * @QMI_WDS_RAT_3GPP2_EVDO_REVB: EVDO RevB. - * @QMI_WDS_RAT_3GPP2_EHRPD: eHRPD. - * @QMI_WDS_RAT_3GPP2_FMC: FMC. + * @QMI_WDS_RAT_3GPP2_EHRPD: eHRPD. Since: 1.18. + * @QMI_WDS_RAT_3GPP2_FMC: FMC. Since: 1.18. * @QMI_WDS_RAT_3GPP2_NULL_BEARER: No bearer. * * Flags specifying the 3GPP2-specific Radio Access Technology, when the data * bearer network type is @QMI_WDS_NETWORK_TYPE_3GPP2. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_wds_rat_3gpp2 >*/ QMI_WDS_RAT_3GPP2_NONE = 0, @@ -843,6 +996,12 @@ typedef enum { /*< underscore_name=qmi_wds_rat_3gpp2 >*/ QMI_WDS_RAT_3GPP2_NULL_BEARER = 1 << 15 } QmiWdsRat3gpp2; +/** + * qmi_wds_rat_3gpp2_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsRat3gpp: * @QMI_WDS_RAT_3GPP_NONE: Unknown, to be ignored. @@ -854,12 +1013,14 @@ typedef enum { /*< underscore_name=qmi_wds_rat_3gpp2 >*/ * @QMI_WDS_RAT_3GPP_LTE: LTE. * @QMI_WDS_RAT_3GPP_HSDPAPLUS: HSDPA+. * @QMI_WDS_RAT_3GPP_DCHSDPAPLUS: DC-HSDPA+. - * @QMI_WDS_RAT_3GPP_64QAM: 64QAM. - * @QMI_WDS_RAT_3GPP_TDSCDMA: TD-SCDMA. + * @QMI_WDS_RAT_3GPP_64QAM: 64QAM. Since: 1.18. + * @QMI_WDS_RAT_3GPP_TDSCDMA: TD-SCDMA. Since: 1.18. * @QMI_WDS_RAT_3GPP_NULL_BEARER: No bearer. * * Flags specifying the 3GPP-specific Radio Access Technology, when the data * bearer network type is @QMI_WDS_NETWORK_TYPE_3GPP. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_wds_rat_3gpp >*/ QMI_WDS_RAT_3GPP_NONE = 0, @@ -876,6 +1037,12 @@ typedef enum { /*< underscore_name=qmi_wds_rat_3gpp >*/ QMI_WDS_RAT_3GPP_NULL_BEARER = 1 << 15 } QmiWdsRat3gpp; +/** + * qmi_wds_rat_3gpp_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsSoCdma1x: * @QMI_WDS_SO_CDMA1X_NONE: Unknown, to be ignored. @@ -886,6 +1053,8 @@ typedef enum { /*< underscore_name=qmi_wds_rat_3gpp >*/ * Flags specifying the Service Option when the bearer network type is * @QMI_WDS_NETWORK_TYPE_3GPP2 and when the Radio Access Technology mask * contains @QMI_WDS_RAT_3GPP2_CDMA1X. + * + * Since: 1.0 */ typedef enum { QMI_WDS_SO_CDMA1X_NONE = 0, @@ -894,6 +1063,12 @@ typedef enum { QMI_WDS_SO_CDMA1X_IS2000_REL_A = 1 << 2 } QmiWdsSoCdma1x; +/** + * qmi_wds_so_cdma1x_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsSoEvdoRev0: * @QMI_WDS_SO_EVDO_REV0_NONE: Unknown, to be ignored. @@ -902,12 +1077,20 @@ typedef enum { * Flags specifying the Service Option when the bearer network type is * @QMI_WDS_NETWORK_TYPE_3GPP2 and when the Radio Access Technology mask * contains @QMI_WDS_RAT_3GPP2_EVDO_REV0. + * + * Since: 1.18 */ typedef enum { /*< underscore_name=qmi_wds_so_evdo_rev0 >*/ - QMI_WDS_SO_EVDO_REV0_NONE = 0, - QMI_WDS_SO_EVDO_REV0_DPA = 1 << 0, + QMI_WDS_SO_EVDO_REV0_NONE = 0, + QMI_WDS_SO_EVDO_REV0_DPA = 1 << 0, } QmiWdsSoEvdoRev0; +/** + * qmi_wds_so_evdo_rev0_get_string: + * + * Since: 1.18 + */ + /** * QmiWdsSoEvdoRevA: * @QMI_WDS_SO_EVDO_REVA_NONE: Unknown, to be ignored. @@ -919,6 +1102,8 @@ typedef enum { /*< underscore_name=qmi_wds_so_evdo_rev0 >*/ * Flags specifying the Service Option when the bearer network type is * @QMI_WDS_NETWORK_TYPE_3GPP2 and when the Radio Access Technology mask * contains @QMI_WDS_RAT_3GPP2_EVDO_REVA. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_wds_so_evdo_reva >*/ QMI_WDS_SO_EVDO_REVA_NONE = 0, @@ -928,6 +1113,12 @@ typedef enum { /*< underscore_name=qmi_wds_so_evdo_reva >*/ QMI_WDS_SO_EVDO_REVA_EMPA_EHRPD = 1 << 3, } QmiWdsSoEvdoRevA; +/** + * qmi_wds_so_evdo_reva_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsSoEvdoRevB: * @QMI_WDS_SO_EVDO_REVB_NONE: Unknown, to be ignored. @@ -941,6 +1132,8 @@ typedef enum { /*< underscore_name=qmi_wds_so_evdo_reva >*/ * Flags specifying the Service Option when the bearer network type is * @QMI_WDS_NETWORK_TYPE_3GPP2 and when the Radio Access Technology mask * contains @QMI_WDS_RAT_3GPP2_EVDO_REVB. + * + * Since: 1.18 */ typedef enum { /*< underscore_name=qmi_wds_so_evdo_revb >*/ QMI_WDS_SO_EVDO_REVB_NONE = 0, @@ -952,6 +1145,12 @@ typedef enum { /*< underscore_name=qmi_wds_so_evdo_revb >*/ QMI_WDS_SO_EVDO_REVB_MMPA_EHRPD = 1 << 5, } QmiWdsSoEvdoRevB; +/** + * qmi_wds_so_evdo_revb_get_string: + * + * Since: 1.18 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI WDS Get Current Settings' message */ @@ -979,6 +1178,8 @@ typedef enum { /*< underscore_name=qmi_wds_so_evdo_revb >*/ * * Flags specifying which specific settings to return when requesting the * current WDS bearer settings. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_wds_get_current_settings_requested_settings >*/ QMI_WDS_GET_CURRENT_SETTINGS_REQUESTED_SETTINGS_NONE = 0, @@ -1002,6 +1203,12 @@ typedef enum { /*< underscore_name=qmi_wds_get_current_settings_requested_settin QMI_WDS_GET_CURRENT_SETTINGS_REQUESTED_SETTINGS_EXTENDED_TECHNOLOGY = 1 << 17, } QmiWdsGetCurrentSettingsRequestedSettings; +/** + * qmi_wds_get_current_settings_requested_settings_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsPdpType: * @QMI_WDS_PDP_TYPE_IPV4: IPv4 @@ -1010,6 +1217,8 @@ typedef enum { /*< underscore_name=qmi_wds_get_current_settings_requested_settin * @QMI_WDS_PDP_TYPE_IPV4_OR_IPV6: IPv4 and IPv6 combined context * * PDP context type. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_wds_pdp_type >*/ QMI_WDS_PDP_TYPE_IPV4 = 0, @@ -1018,6 +1227,12 @@ typedef enum { /*< underscore_name=qmi_wds_pdp_type >*/ QMI_WDS_PDP_TYPE_IPV4_OR_IPV6 = 3 } QmiWdsPdpType; +/** + * qmi_wds_pdp_type_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsTrafficClass: * @QMI_WDS_TRAFFIC_CLASS_SUBSCRIBED: default (?) class, best-effort @@ -1027,6 +1242,8 @@ typedef enum { /*< underscore_name=qmi_wds_pdp_type >*/ * @QMI_WDS_TRAFFIC_CLASS_BACKGROUND: delay-insensitive (downloads, email) * * QoS Traffic Classes. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_wds_traffic_class >*/ QMI_WDS_TRAFFIC_CLASS_SUBSCRIBED = 0, @@ -1036,6 +1253,12 @@ typedef enum { /*< underscore_name=qmi_wds_traffic_class >*/ QMI_WDS_TRAFFIC_CLASS_BACKGROUND = 4 } QmiWdsTrafficClass; +/** + * qmi_wds_traffic_class_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsAuthentication: * @QMI_WDS_AUTHENTICATION_NONE: no authentication @@ -1043,6 +1266,8 @@ typedef enum { /*< underscore_name=qmi_wds_traffic_class >*/ * @QMI_WDS_AUTHENTICATION_CHAP: CHAP authentication * * PDP context authentication protocols. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_wds_authentication >*/ QMI_WDS_AUTHENTICATION_NONE = 0, @@ -1050,18 +1275,32 @@ typedef enum { /*< underscore_name=qmi_wds_authentication >*/ QMI_WDS_AUTHENTICATION_CHAP = 1 << 1 } QmiWdsAuthentication; +/** + * qmi_wds_authentication_build_string_from_mask: + * + * Since: 1.0 + */ + /** * QmiWdsProfileType: * @QMI_WDS_PROFILE_TYPE_3GPP: 3GPP profile type. * @QMI_WDS_PROFILE_TYPE_3GPP2: 3GPP2 profile type. * * Profile network type family. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_wds_profile_type >*/ QMI_WDS_PROFILE_TYPE_3GPP = 0, QMI_WDS_PROFILE_TYPE_3GPP2 = 1 } QmiWdsProfileType; +/** + * qmi_wds_profile_type_get_string: + * + * Since: 1.0 + */ + /** * QmiWdsDeliveryOrder: * @QMI_WDS_QOS_DELIVERY_ORDER_SUBSCRIBE: Subscribe. @@ -1069,6 +1308,8 @@ typedef enum { /*< underscore_name=qmi_wds_profile_type >*/ * @QMI_WDS_QOS_DELIVERY_ORDER_OFF: Off. * * QoS delivery order. + * + * Since: 1.14 */ typedef enum { /*< underscore_name=qmi_wds_delivery_order >*/ QMI_WDS_QOS_DELIVERY_ORDER_SUBSCRIBE = 0, @@ -1076,6 +1317,12 @@ typedef enum { /*< underscore_name=qmi_wds_delivery_order >*/ QMI_WDS_QOS_DELIVERY_ORDER_OFF = 2 } QmiWdsDeliveryOrder; +/** + * qmi_wds_delivery_order_get_string: + * + * Since: 1.14 + */ + /** * QmiWdsSduErrorRatio: * @QMI_WDS_SDU_ERROR_RATIO_SUBSCRIBE: Subscribe. @@ -1088,6 +1335,8 @@ typedef enum { /*< underscore_name=qmi_wds_delivery_order >*/ * @QMI_WDS_SDU_ERROR_RATIO_1E1: 1x10^7. * * Target value for the fraction of SDUs lost or detected as erroneous. + * + * Since: 1.14 */ typedef enum { /*< underscore_name=qmi_wds_sdu_error_ratio >*/ QMI_WDS_SDU_ERROR_RATIO_SUBSCRIBE = 0, @@ -1100,6 +1349,12 @@ typedef enum { /*< underscore_name=qmi_wds_sdu_error_ratio >*/ QMI_WDS_SDU_ERROR_RATIO_1E1 = 7 } QmiWdsSduErrorRatio; +/** + * qmi_wds_sdu_error_ratio_get_string: + * + * Since: 1.14 + */ + /** * QmiWdsSduResidualBitErrorRatio: * @QMI_WDS_SDU_RESIDUAL_BIT_ERROR_RATIO_SUBSCRIBE: Subscribe. @@ -1114,6 +1369,8 @@ typedef enum { /*< underscore_name=qmi_wds_sdu_error_ratio >*/ * @QMI_WDS_SDU_RESIDUAL_BIT_ERROR_RATIO_6E8: 6x10^8. * * Target value for the undetected bit error ratio in the delivered SDUs. + * + * Since: 1.14 */ typedef enum { /*< underscore_name=qmi_wds_sdu_residual_bit_error_ratio >*/ QMI_WDS_SDU_RESIDUAL_BIT_ERROR_RATIO_SUBSCRIBE = 0, @@ -1128,6 +1385,12 @@ typedef enum { /*< underscore_name=qmi_wds_sdu_residual_bit_error_ratio >*/ QMI_WDS_SDU_RESIDUAL_BIT_ERROR_RATIO_6E8 = 9 } QmiWdsSduResidualBitErrorRatio; +/** + * qmi_wds_sdu_residual_bit_error_ratio_get_string: + * + * Since: 1.14 + */ + /** * QmiWdsSduErroneousDelivery: * @QMI_WDS_SDU_ERRONEOUS_DELIVERY_SUBSCRIBE: Subscribe. @@ -1136,6 +1399,8 @@ typedef enum { /*< underscore_name=qmi_wds_sdu_residual_bit_error_ratio >*/ * @QMI_WDS_SDU_ERRONEOUS_DELIVERY_DISABLED: Erroneous SDUs are delivered. * * Whether SDUs detected as erroneous are delivered or not. + * + * Since: 1.14 */ typedef enum { /*< underscore_name=qmi_wds_sdu_erroneous_delivery >*/ QMI_WDS_SDU_ERRONEOUS_DELIVERY_SUBSCRIBE = 0, @@ -1144,6 +1409,12 @@ typedef enum { /*< underscore_name=qmi_wds_sdu_erroneous_delivery >*/ QMI_WDS_SDU_ERRONEOUS_DELIVERY_DISABLED = 3 } QmiWdsSduErroneousDelivery; +/** + * qmi_wds_sdu_erroneous_delivery_get_string: + * + * Since: 1.14 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI WDS Get Packet Statistics' message */ @@ -1161,6 +1432,8 @@ typedef enum { /*< underscore_name=qmi_wds_sdu_erroneous_delivery >*/ * @QMI_WDS_PACKET_STATISTICS_MASK_FLAG_RX_PACKETS_DROPPED: Request count of dropped packets in reception. * * Mask to use when requesting packet statistics. + * + * Since: 1.6 */ typedef enum { QMI_WDS_PACKET_STATISTICS_MASK_FLAG_TX_PACKETS_OK = 1 << 0, @@ -1175,6 +1448,12 @@ typedef enum { QMI_WDS_PACKET_STATISTICS_MASK_FLAG_RX_PACKETS_DROPPED = 1 << 9 } QmiWdsPacketStatisticsMaskFlag; +/** + * qmi_wds_packet_statistics_mask_flag_build_string_from_mask: + * + * Since: 1.6 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI WDS Get Profile List' message */ @@ -1202,6 +1481,8 @@ typedef enum { * @QMI_WDS_DS_PROFILE_ERROR_3GPP2_INVALID_PROFILE_ID: Invalid 3GPP2 profile identifier. * * Extended DS profile errors. + * + * Since: 1.8 */ typedef enum { QMI_WDS_DS_PROFILE_ERROR_UNKNOWN = 0, @@ -1226,6 +1507,12 @@ typedef enum { QMI_WDS_DS_PROFILE_ERROR_3GPP2_INVALID_PROFILE_ID = 1101, } QmiWdsDsProfileError; +/** + * qmi_wds_ds_profile_error_get_string: + * + * Since: 1.8 + */ + /** * QmiWdsAutoconnectSetting: * @QMI_WDS_AUTOCONNECT_SETTING_DISABLED: Disabled. @@ -1233,6 +1520,8 @@ typedef enum { * @QMI_WDS_AUTOCONNECT_SETTING_PAUSED: Paused (resume on power cycle). * * Status of the autoconnect setting. + * + * Since: 1.14 */ typedef enum { QMI_WDS_AUTOCONNECT_SETTING_DISABLED = 0, @@ -1240,18 +1529,32 @@ typedef enum { QMI_WDS_AUTOCONNECT_SETTING_PAUSED = 2, } QmiWdsAutoconnectSetting; +/** + * qmi_wds_autoconnect_setting_get_string: + * + * Since: 1.14 + */ + /** * QmiWdsAutoconnectSettingRoaming: * @QMI_WDS_AUTOCONNECT_SETTING_ROAMING_ALLOWED: Autoconnect always allowed, even when roaming. * @QMI_WDS_AUTOCONNECT_SETTING_ROAMING_HOME_ONLY: Autoconnect allowed only in home network. * * Status of the autoconnect setting while roaming. + * + * Since: 1.14 */ typedef enum { QMI_WDS_AUTOCONNECT_SETTING_ROAMING_ALLOWED = 0, QMI_WDS_AUTOCONNECT_SETTING_ROAMING_HOME_ONLY = 1, } QmiWdsAutoconnectSettingRoaming; +/** + * qmi_wds_autoconnect_setting_roaming_get_string: + * + * Since: 1.14 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI WDS Set Event Report' message */ @@ -1270,6 +1573,8 @@ typedef enum { * * Flags indicating which WDS Set Event Report Transfer Statistics indicators * should be emitted. + * + * Since: 1.18 */ typedef enum { QMI_WDS_SET_EVENT_REPORT_TRANSFER_STATISTICS_REPORT_TX_PACKETS_OK = 1 << 0, @@ -1284,6 +1589,12 @@ typedef enum { QMI_WDS_SET_EVENT_REPORT_TRANSFER_STATISTICS_REPORT_RX_PACKETS_DROPPED = 1 << 9, } QmiWdsSetEventReportTransferStatistics; +/** + * qmi_wds_set_event_report_transfer_statistics_get_string: + * + * Since: 1.18 + */ + /** * QmiWdsDormancyStatus: * @QMI_WDS_DORMANCY_STATUS_UNKNOWN: dormancy status unknown. @@ -1291,6 +1602,8 @@ typedef enum { * @QMI_WDS_DORMANCY_STATUS_TRAFFIC_CHANNEL_ACTIVE: traffic channel is active. * * Dormancy status. + * + * Since: 1.18 */ typedef enum { QMI_WDS_DORMANCY_STATUS_UNKNOWN = 0, @@ -1298,6 +1611,12 @@ typedef enum { QMI_WDS_DORMANCY_STATUS_TRAFFIC_CHANNEL_ACTIVE = 2, } QmiWdsDormancyStatus; +/** + * qmi_wds_dormancy_status_get_string: + * + * Since: 1.18 + */ + /** * QmiWdsDataCallStatus: * @QMI_WDS_DATA_CALL_STATUS_UNKNOWN: data call status unknown. @@ -1305,6 +1624,8 @@ typedef enum { * @QMI_WDS_DATA_CALL_STATUS_TERMINATED: data call status terminated. * * Data call status. + * + * Since: 1.18 */ typedef enum { QMI_WDS_DATA_CALL_STATUS_UNKNOWN = 0, @@ -1312,6 +1633,12 @@ typedef enum { QMI_WDS_DATA_CALL_STATUS_TERMINATED = 2, } QmiWdsDataCallStatus; +/** + * qmi_wds_data_call_status_get_string: + * + * Since: 1.18 + */ + /** * QmiWdsDataCallType: * @QMI_WDS_DATA_CALL_TYPE_UNKNOWN: data call type unknown. @@ -1320,6 +1647,8 @@ typedef enum { * @QMI_WDS_DATA_CALL_TYPE_MODEM_EMBEDDED: modem embedded data call. * * Data call type. + * + * Since: 1.18 */ typedef enum { QMI_WDS_DATA_CALL_TYPE_UNKNOWN = 0, @@ -1328,6 +1657,12 @@ typedef enum { QMI_WDS_DATA_CALL_TYPE_MODEM_EMBEDDED = 3, } QmiWdsDataCallType; +/** + * qmi_wds_data_call_type_get_string: + * + * Since: 1.18 + */ + /** * QmiWdsTetheredCallType: * @QMI_WDS_TETHERED_CALL_TYPE_NON_TETHERED: non-tethered. @@ -1335,6 +1670,8 @@ typedef enum { * @QMI_WDS_TETHERED_CALL_TYPE_DUN: DUN. * * Tethered call type. + * + * Since: 1.18 */ typedef enum { QMI_WDS_TETHERED_CALL_TYPE_NON_TETHERED = 0, @@ -1342,6 +1679,12 @@ typedef enum { QMI_WDS_TETHERED_CALL_TYPE_DUN = 2, } QmiWdsTetheredCallType; +/** + * qmi_wds_tethered_call_type_get_string: + * + * Since: 1.18 + */ + /** * QmiWdsRadioAccessTechnology: * @QMI_WDS_RADIO_ACCESS_TECHNOLOGY_NULL_BEARER: null bearer @@ -1358,6 +1701,8 @@ typedef enum { * @QMI_WDS_RADIO_ACCESS_TECHNOLOGY_3GPP2_MAXIMUM: 3GPP2 maximum. * * Radio access technology. + * + * Since: 1.18 */ typedef enum { QMI_WDS_RADIO_ACCESS_TECHNOLOGY_NULL_BEARER = 0, @@ -1374,6 +1719,12 @@ typedef enum { QMI_WDS_RADIO_ACCESS_TECHNOLOGY_3GPP2_MAXIMUM = 200, } QmiWdsRadioAccessTechnology; +/** + * qmi_wds_radio_access_technology_get_string: + * + * Since: 1.18 + */ + /** * QmiWdsExtendedDataBearerTechnology3gpp: * @QMI_WDS_EXTENDED_DATA_BEARER_TECHNOLOGY_3GPP_UNKNOWN: unknown. @@ -1393,6 +1744,8 @@ typedef enum { * @QMI_WDS_EXTENDED_DATA_BEARER_TECHNOLOGY_3GPP_LTE_TDD: LTE TDD. * * 3GPP extended data bearer technologies. + * + * Since: 1.18 */ typedef enum { QMI_WDS_EXTENDED_DATA_BEARER_TECHNOLOGY_3GPP_UNKNOWN = 0, @@ -1412,6 +1765,12 @@ typedef enum { QMI_WDS_EXTENDED_DATA_BEARER_TECHNOLOGY_3GPP_LTE_TDD = 1 << 13, } QmiWdsExtendedDataBearerTechnology3gpp; +/** + * qmi_wds_extended_data_bearer_technology_3gpp_build_string_from_mask: + * + * Since: 1.18 + */ + /** * QmiWdsExtendedDataBearerTechnology3gpp2: * @QMI_WDS_EXTENDED_DATA_BEARER_TECHNOLOGY_3GPP2_UNKNOWN: unknown. @@ -1430,6 +1789,8 @@ typedef enum { * @QMI_WDS_EXTENDED_DATA_BEARER_TECHNOLOGY_3GPP2_HDR_EVDO_FMC: HDR EVDO FMC. * * 3GPP2 extended data bearer technologies. + * + * Since: 1.18 */ typedef enum { QMI_WDS_EXTENDED_DATA_BEARER_TECHNOLOGY_3GPP2_UNKNOWN = 0, @@ -1448,6 +1809,12 @@ typedef enum { QMI_WDS_EXTENDED_DATA_BEARER_TECHNOLOGY_3GPP2_HDR_EVDO_FMC = 1 << 12, } QmiWdsExtendedDataBearerTechnology3gpp2; +/** + * qmi_wds_extended_data_bearer_technology_3gpp2_build_string_from_mask: + * + * Since: 1.18 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI WDS Profile'-related messages */ @@ -1460,6 +1827,8 @@ typedef enum { * @QMI_WDS_PDP_HEADER_COMPRESSION_TYPE_RFC3095: RFC3095 * * PDP header compression types. + * + * Since: 1.18 */ typedef enum { /*< underscore_name=qmi_wds_pdp_header_compression_type >*/ QMI_WDS_PDP_HEADER_COMPRESSION_TYPE_OFF = 0, @@ -1469,6 +1838,12 @@ typedef enum { /*< underscore_name=qmi_wds_pdp_header_compression_type >*/ QMI_WDS_PDP_HEADER_COMPRESSION_TYPE_RFC3095 = 4, } QmiWdsPdpHeaderCompressionType; +/** + * qmi_wds_pdp_header_compression_type_get_string: + * + * Since: 1.18 + */ + /** * QmiWdsPdpDataCompressionType: * @QMI_WDS_PDP_DATA_COMPRESSION_TYPE_OFF: no data compression @@ -1477,6 +1852,8 @@ typedef enum { /*< underscore_name=qmi_wds_pdp_header_compression_type >*/ * @QMI_WDS_PDP_DATA_COMPRESSION_TYPE_V44: V44 * * PDP data compression types. + * + * Since: 1.18 */ typedef enum { /*< underscore_name=qmi_wds_pdp_data_compression_type >*/ QMI_WDS_PDP_DATA_COMPRESSION_TYPE_OFF = 0, @@ -1485,6 +1862,12 @@ typedef enum { /*< underscore_name=qmi_wds_pdp_data_compression_type >*/ QMI_WDS_PDP_DATA_COMPRESSION_TYPE_V44 = 3, } QmiWdsPdpDataCompressionType; +/** + * qmi_wds_pdp_data_compression_type_get_string: + * + * Since: 1.18 + */ + /** * QmiWdsQosClassIdentifier: * @QMI_WDS_QOS_CLASS_IDENTIFIER_NETWORK_ASSIGN: network assigned @@ -1498,6 +1881,8 @@ typedef enum { /*< underscore_name=qmi_wds_pdp_data_compression_type >*/ * @QMI_WDS_QOS_CLASS_IDENTIFIER_NON_GUARANTEED_BITRATE8: non-guaranteed bitrate 8 * * QoS Class Identifier. + * + * Since: 1.18 */ typedef enum { /*< underscore_name=qmi_wds_qos_class_identifier >*/ QMI_WDS_QOS_CLASS_IDENTIFIER_NETWORK_ASSIGN = 0, @@ -1511,4 +1896,10 @@ typedef enum { /*< underscore_name=qmi_wds_qos_class_identifier >*/ QMI_WDS_QOS_CLASS_IDENTIFIER_NON_GUARANTEED_BITRATE8 = 8, } QmiWdsQosClassIdentifier; +/** + * qmi_wds_qos_class_identifier_get_string: + * + * Since: 1.18 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_WDS_H_ */ diff --git a/src/libqmi-glib/qmi-enums-wms.h b/src/libqmi-glib/qmi-enums-wms.h index d2df5bc..b2ca126 100644 --- a/src/libqmi-glib/qmi-enums-wms.h +++ b/src/libqmi-glib/qmi-enums-wms.h @@ -44,7 +44,9 @@ * @QMI_WMS_STORAGE_TYPE_NV: Message stored in non-volatile memory. * @QMI_WMS_STORAGE_TYPE_NONE: None. * - * Type of messaging storage + * Type of messaging storage. + * + * Since: 1.0 */ typedef enum { QMI_WMS_STORAGE_TYPE_UIM = 0x00, @@ -52,18 +54,32 @@ typedef enum { QMI_WMS_STORAGE_TYPE_NONE = 0xFF } QmiWmsStorageType; +/** + * qmi_wms_storage_type_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsAckIndicator: * @QMI_WMS_ACK_INDICATOR_SEND: ACK needs to be sent. * @QMI_WMS_ACK_INDICATOR_DO_NOT_SEND: ACK doesn't need to be sent. * * Indication of whether ACK needs to be sent or not. + * + * Since: 1.0 */ typedef enum { QMI_WMS_ACK_INDICATOR_SEND = 0x00, QMI_WMS_ACK_INDICATOR_DO_NOT_SEND = 0x01 } QmiWmsAckIndicator; +/** + * qmi_wms_ack_indicator_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsMessageFormat: * @QMI_WMS_MESSAGE_FORMAT_CDMA: CDMA message. @@ -72,6 +88,8 @@ typedef enum { * @QMI_WMS_MESSAGE_FORMAT_MWI: Message Waiting Indicator. * * Type of message. + * + * Since: 1.0 */ typedef enum { QMI_WMS_MESSAGE_FORMAT_CDMA = 0x00, @@ -80,18 +98,32 @@ typedef enum { QMI_WMS_MESSAGE_FORMAT_MWI = 0x08 } QmiWmsMessageFormat; +/** + * qmi_wms_message_format_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsMessageMode: * @QMI_WMS_MESSAGE_MODE_CDMA: Message sent using 3GPP2 technologies. * @QMI_WMS_MESSAGE_MODE_GSM_WCDMA: Message sent using 3GPP technologies. * * Message mode. + * + * Since: 1.0 */ typedef enum { QMI_WMS_MESSAGE_MODE_CDMA = 0x00, QMI_WMS_MESSAGE_MODE_GSM_WCDMA = 0x01 } QmiWmsMessageMode; +/** + * qmi_wms_message_mode_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsNotificationType: * @QMI_WMS_NOTIFICATION_TYPE_PRIMARY: Primary. @@ -99,6 +131,8 @@ typedef enum { * @QMI_WMS_NOTIFICATION_TYPE_SECONDARY_UMTS: Secondary UMTS. * * Type of notification. + * + * Since: 1.0 */ typedef enum { QMI_WMS_NOTIFICATION_TYPE_PRIMARY = 0x00, @@ -106,6 +140,12 @@ typedef enum { QMI_WMS_NOTIFICATION_TYPE_SECONDARY_UMTS = 0x02 } QmiWmsNotificationType; +/** + * qmi_wms_notification_type_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI WMS Raw Send' request/response */ @@ -116,6 +156,8 @@ typedef enum { * @QMI_WMS_CDMA_SERVICE_OPTION_14: Use service option 14. * * CDMA service option selection. + * + * Since: 1.0 */ typedef enum { QMI_WMS_CDMA_SERVICE_OPTION_AUTO = 0x00, @@ -123,6 +165,12 @@ typedef enum { QMI_WMS_CDMA_SERVICE_OPTION_14 = 0x0E } QmiWmsCdmaServiceOption; +/** + * qmi_wms_cdma_service_option_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsCdmaCauseCode: * @QMI_WDS_CDMA_CAUSE_CODE_NETWORK_ADDRESS_VACANT: Address is valid but not yet allocated. @@ -155,6 +203,8 @@ typedef enum { * @QMI_WDS_CDMA_CAUSE_CODE_GENERAL_OTHER: Other general error. * * Cause codes when failed to send an SMS in CDMA. + * + * Since: 1.0 */ typedef enum { /* Network errors */ @@ -194,18 +244,32 @@ typedef enum { QMI_WDS_CDMA_CAUSE_CODE_GENERAL_OTHER = 0x6A } QmiWmsCdmaCauseCode; +/** + * qmi_wms_cdma_cause_code_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsCdmaErrorClass: * @QMI_WMS_CDMA_ERROR_CLASS_TEMPORARY: Temporary error. * @QMI_WMS_CDMA_ERROR_CLASS_PERMANENT: Permanent error. * * Error class when failed to send an SMS in CDMA. + * + * Since: 1.0 */ typedef enum { QMI_WMS_CDMA_ERROR_CLASS_TEMPORARY = 0x00, QMI_WMS_CDMA_ERROR_CLASS_PERMANENT = 0x01 } QmiWmsCdmaErrorClass; +/** + * qmi_wms_cdma_error_class_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsGsmUmtsRpCause: * @QMI_WMS_GSM_UMTS_RP_CAUSE_UNASSIGNED_NUMBER: Unassigned number. @@ -234,6 +298,8 @@ typedef enum { * @QMI_WMS_GSM_UMTS_RP_CAUSE_INTERWORKING: Interworking error. * * RP cause codes when failed to send an SMS in GSM/WCDMA. + * + * Since: 1.0 */ typedef enum { QMI_WMS_GSM_UMTS_RP_CAUSE_UNASSIGNED_NUMBER = 0x01, @@ -262,6 +328,12 @@ typedef enum { QMI_WMS_GSM_UMTS_RP_CAUSE_INTERWORKING = 0x7F } QmiWmsGsmUmtsRpCause; +/** + * qmi_wms_gsm_umts_rp_cause_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsGsmUmtsTpCause: * @QMI_WMS_GSM_UMTS_TP_CAUSE_TELE_INTERWORKING_NOT_SUPPORTED: Tele interworking not supported. @@ -292,6 +364,8 @@ typedef enum { * @QMI_WMS_GSM_UMTS_TP_CAUSE_UNSPECIFIED_ERROR: Unspecified error. * * RT cause codes when failed to send an SMS in GSM/WCDMA. + * + * Since: 1.0 */ typedef enum { QMI_WMS_GSM_UMTS_TP_CAUSE_TELE_INTERWORKING_NOT_SUPPORTED = 0x80, @@ -322,18 +396,32 @@ typedef enum { QMI_WMS_GSM_UMTS_TP_CAUSE_UNSPECIFIED_ERROR = 0xFF } QmiWmsGsmUmtsTpCause; +/** + * qmi_wms_gsm_umts_tp_cause_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsMessageDeliveryFailureType: * @QMI_WMS_MESSAGE_DELIVERY_FAILURE_TYPE_TEMPORARY: Temporary failure. * @QMI_WMS_MESSAGE_DELIVERY_FAILURE_TYPE_PERMANENT: Permanent failure. * * Type of message delivery failure. + * + * Since: 1.0 */ typedef enum { QMI_WMS_MESSAGE_DELIVERY_FAILURE_TYPE_TEMPORARY = 0x00, QMI_WMS_MESSAGE_DELIVERY_FAILURE_TYPE_PERMANENT = 0x01 } QmiWmsMessageDeliveryFailureType; +/** + * qmi_wms_message_delivery_failure_type_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI WMS Read Raw' request/response */ @@ -345,6 +433,8 @@ typedef enum { * @QMI_WMS_MESSAGE_TAG_TYPE_MO_NOT_SENT: Not yet sent SMS. * * Type of message tag. + * + * Since: 1.0 */ typedef enum { QMI_WMS_MESSAGE_TAG_TYPE_MT_READ = 0x00, @@ -353,18 +443,32 @@ typedef enum { QMI_WMS_MESSAGE_TAG_TYPE_MO_NOT_SENT = 0x03 } QmiWmsMessageTagType; +/** + * qmi_wms_message_tag_type_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsMessageProtocol: * @QMI_WMS_MESSAGE_PROTOCOL_CDMA: CDMA. * @QMI_WMS_MESSAGE_PROTOCOL_WCDMA: WCDMA. * * Type of message protocol. + * + * Since: 1.0 */ typedef enum { QMI_WMS_MESSAGE_PROTOCOL_CDMA = 0x00, QMI_WMS_MESSAGE_PROTOCOL_WCDMA = 0x01 } QmiWmsMessageProtocol; +/** + * qmi_wms_message_protocol_get_string: + * + * Since: 1.0 + */ + /*****************************************************************************/ /* Helper enums for the 'QMI WMS Set Routes' request/response */ @@ -373,11 +477,19 @@ typedef enum { * @QMI_WMS_MESSAGE_TYPE_POINT_TO_POINT: Point to point message. * * Type of message. + * + * Since: 1.0 */ typedef enum { QMI_WMS_MESSAGE_TYPE_POINT_TO_POINT = 0x00 } QmiWmsMessageType; +/** + * qmi_wms_message_type_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsMessageClass: * @QMI_WMS_MESSAGE_CLASS_0: Class 0. @@ -388,6 +500,8 @@ typedef enum { * @QMI_WMS_MESSAGE_CLASS_CDMA: Class CDMA. * * Message class. + * + * Since: 1.0 */ typedef enum { QMI_WMS_MESSAGE_CLASS_0 = 0x00, @@ -398,6 +512,12 @@ typedef enum { QMI_WMS_MESSAGE_CLASS_CDMA = 0x05 } QmiWmsMessageClass; +/** + * qmi_wms_message_class_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsReceiptAction: * @QMI_WMS_RECEIPT_ACTION_DISCARD: Discard message. @@ -407,6 +527,8 @@ typedef enum { * @QMI_WMS_RECEIPT_ACTION_UNKNOWN: Unknown action. * * Action to perform when a message is received. + * + * Since: 1.0 */ typedef enum { QMI_WMS_RECEIPT_ACTION_DISCARD = 0x00, @@ -416,14 +538,28 @@ typedef enum { QMI_WMS_RECEIPT_ACTION_UNKNOWN = 0xFF } QmiWmsReceiptAction; +/** + * qmi_wms_receipt_action_get_string: + * + * Since: 1.0 + */ + /** * QmiWmsTransferIndication: * @QMI_WMS_TRANSFER_INDICATION_CLIENT: Status reports transferred to the client. * * Transfer indication actions. + * + * Since: 1.0 */ typedef enum { QMI_WMS_TRANSFER_INDICATION_CLIENT = 0x01 } QmiWmsTransferIndication; +/** + * qmi_wms_transfer_indication_get_string: + * + * Since: 1.0 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_WMS_H_ */ diff --git a/src/libqmi-glib/qmi-enums.h b/src/libqmi-glib/qmi-enums.h index 9e9081b..bba0bc2 100644 --- a/src/libqmi-glib/qmi-enums.h +++ b/src/libqmi-glib/qmi-enums.h @@ -50,40 +50,42 @@ * @QMI_SERVICE_CAT2: Card Application Toolkit service (v2). * @QMI_SERVICE_UIM: User Identity Module service. * @QMI_SERVICE_PBM: Phonebook Management service. - * @QMI_SERVICE_QCHAT: QCHAT service. + * @QMI_SERVICE_QCHAT: QCHAT service. Since: 1.8. * @QMI_SERVICE_RMTFS: Remote file system service. - * @QMI_SERVICE_TEST: Test service. + * @QMI_SERVICE_TEST: Test service. Since: 1.8. * @QMI_SERVICE_LOC: Location service (~ PDS v2). * @QMI_SERVICE_SAR: Service access proxy service. - * @QMI_SERVICE_IMS: IMS settings service. - * @QMI_SERVICE_ADC: Analog to digital converter driver service. - * @QMI_SERVICE_CSD: Core sound driver service. - * @QMI_SERVICE_MFS: Modem embedded file system service. - * @QMI_SERVICE_TIME: Time service. - * @QMI_SERVICE_TS: Thermal sensors service. - * @QMI_SERVICE_TMD: Thermal mitigation device service. - * @QMI_SERVICE_SAP: Service access proxy service. - * @QMI_SERVICE_WDA: Wireless data administrative service. - * @QMI_SERVICE_TSYNC: TSYNC control service. - * @QMI_SERVICE_RFSA: Remote file system access service. - * @QMI_SERVICE_CSVT: Circuit switched videotelephony service. - * @QMI_SERVICE_QCMAP: Qualcomm mobile access point service. - * @QMI_SERVICE_IMSP: IMS presence service. - * @QMI_SERVICE_IMSVT: IMS videotelephony service. - * @QMI_SERVICE_IMSA: IMS application service. - * @QMI_SERVICE_COEX: Coexistence service. - * @QMI_SERVICE_PDC: Persistent device configuration service. - * @QMI_SERVICE_STX: Simultaneous transmit service. - * @QMI_SERVICE_BIT: Bearer independent transport service. - * @QMI_SERVICE_IMSRTP: IMS RTP service. - * @QMI_SERVICE_RFRPE: RF radiated performance enhancement service. - * @QMI_SERVICE_DSD: Data system determination service. - * @QMI_SERVICE_SSCTL: Subsystem control service. + * @QMI_SERVICE_IMS: IMS settings service. Since: 1.8. + * @QMI_SERVICE_ADC: Analog to digital converter driver service. Since: 1.8. + * @QMI_SERVICE_CSD: Core sound driver service. Since: 1.8. + * @QMI_SERVICE_MFS: Modem embedded file system service. Since: 1.8. + * @QMI_SERVICE_TIME: Time service. Since: 1.8. + * @QMI_SERVICE_TS: Thermal sensors service. Since: 1.8. + * @QMI_SERVICE_TMD: Thermal mitigation device service. Since: 1.8. + * @QMI_SERVICE_SAP: Service access proxy service. Since: 1.8. + * @QMI_SERVICE_WDA: Wireless data administrative service. Since: 1.8. + * @QMI_SERVICE_TSYNC: TSYNC control service. Since: 1.8. + * @QMI_SERVICE_RFSA: Remote file system access service. Since: 1.8. + * @QMI_SERVICE_CSVT: Circuit switched videotelephony service. Since: 1.8. + * @QMI_SERVICE_QCMAP: Qualcomm mobile access point service. Since: 1.8. + * @QMI_SERVICE_IMSP: IMS presence service. Since: 1.8. + * @QMI_SERVICE_IMSVT: IMS videotelephony service. Since: 1.8. + * @QMI_SERVICE_IMSA: IMS application service. Since: 1.8. + * @QMI_SERVICE_COEX: Coexistence service. Since: 1.8. + * @QMI_SERVICE_PDC: Persistent device configuration service. Since: 1.8. + * @QMI_SERVICE_STX: Simultaneous transmit service. Since: 1.8. + * @QMI_SERVICE_BIT: Bearer independent transport service. Since: 1.8. + * @QMI_SERVICE_IMSRTP: IMS RTP service. Since: 1.8. + * @QMI_SERVICE_RFRPE: RF radiated performance enhancement service. Since: 1.8. + * @QMI_SERVICE_DSD: Data system determination service. Since: 1.8. + * @QMI_SERVICE_SSCTL: Subsystem control service. Since: 1.8. * @QMI_SERVICE_CAT: Card Application Toolkit service (v1). * @QMI_SERVICE_RMS: Remote Management Service. * @QMI_SERVICE_OMA: Open Mobile Alliance device management service. * * QMI services. + * + * Since: 1.0 */ typedef enum { QMI_SERVICE_UNKNOWN = -1, @@ -136,4 +138,10 @@ typedef enum { QMI_SERVICE_OMA = 226 } QmiService; +/** + * qmi_service_get_string: + * + * Since: 1.0 + */ + #endif /* _LIBQMI_GLIB_QMI_ENUMS_H_ */ diff --git a/src/libqmi-glib/qmi-errors.h b/src/libqmi-glib/qmi-errors.h index 9553330..653b6fd 100644 --- a/src/libqmi-glib/qmi-errors.h +++ b/src/libqmi-glib/qmi-errors.h @@ -34,9 +34,31 @@ * This section defines common error types used in the interface. */ -/* Prefixes for errors registered in DBus */ -#define QMI_DBUS_ERROR_PREFIX "org.freedesktop.libqmi.Error" -#define QMI_CORE_ERROR_DBUS_PREFIX QMI_DBUS_ERROR_PREFIX ".Core" +/** + * QMI_DBUS_ERROR_PREFIX: + * + * Symbol defining the common string prefix used for all libqmi errors in DBus. + * + * Since: 1.0 + */ +#define QMI_DBUS_ERROR_PREFIX "org.freedesktop.libqmi.Error" + +/** + * QMI_CORE_ERROR_DBUS_PREFIX: + * + * Symbol defining the common string prefix used for all #QmiCoreError errors in DBus. + * + * Since: 1.0 + */ +#define QMI_CORE_ERROR_DBUS_PREFIX QMI_DBUS_ERROR_PREFIX ".Core" + +/** + * QMI_PROTOCOL_ERROR_DBUS_PREFIX: + * + * Symbol defining the common string prefix used for all #QmiProtocolError errors in DBus. + * + * Since: 1.0 + */ #define QMI_PROTOCOL_ERROR_DBUS_PREFIX QMI_DBUS_ERROR_PREFIX ".Protocol" /** @@ -49,10 +71,12 @@ * @QMI_CORE_ERROR_TLV_NOT_FOUND: TLV not found. * @QMI_CORE_ERROR_TLV_TOO_LONG: TLV is too long. * @QMI_CORE_ERROR_UNSUPPORTED: Not supported. - * @QMI_CORE_ERROR_TLV_EMPTY: TLV has no value. - * @QMI_CORE_ERROR_UNEXPECTED_MESSAGE: QMI message is unexpected. + * @QMI_CORE_ERROR_TLV_EMPTY: TLV has no value. Since: 1.12. + * @QMI_CORE_ERROR_UNEXPECTED_MESSAGE: QMI message is unexpected. Since: 1.16. * * Common errors that may be reported by libqmi-glib. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_core_error >*/ QMI_CORE_ERROR_FAILED = 0, /*< nick=Failed >*/ @@ -67,6 +91,12 @@ typedef enum { /*< underscore_name=qmi_core_error >*/ QMI_CORE_ERROR_UNEXPECTED_MESSAGE = 9, /*< nick=UnexpectedMessage >*/ } QmiCoreError; +/** + * qmi_core_error_get_string: + * + * Since: 1.0 + */ + /** * QmiProtocolError: * @QMI_PROTOCOL_ERROR_NONE: No error. @@ -138,34 +168,34 @@ typedef enum { /*< underscore_name=qmi_core_error >*/ * @QMI_PROTOCOL_ERROR_SEGMENT_TOO_LONG: Segment too long. * @QMI_PROTOCOL_ERROR_SEGMENT_ORDER: Segment order. * @QMI_PROTOCOL_ERROR_BUNDLING_NOT_SUPPORTED: Bundling not supported. - * @QMI_PROTOCOL_ERROR_POLICY_MISMATCH: Policy mismatch. + * @QMI_PROTOCOL_ERROR_POLICY_MISMATCH: Policy mismatch. Since: 1.6. * @QMI_PROTOCOL_ERROR_SIM_FILE_NOT_FOUND: SIM file not found. - * @QMI_PROTOCOL_ERROR_EXTENDED_INTERNAL: Extended internal error. + * @QMI_PROTOCOL_ERROR_EXTENDED_INTERNAL: Extended internal error. Since: 1.6. * @QMI_PROTOCOL_ERROR_ACCESS_DENIED: Access denied. * @QMI_PROTOCOL_ERROR_HARDWARE_RESTRICTED: Hardware restricted. - * @QMI_PROTOCOL_ERROR_ACK_NOT_SENT: ACK not sent. - * @QMI_PROTOCOL_ERROR_INJECT_TIMEOUT: Inject timeout. - * @QMI_PROTOCOL_ERROR_INCOMPATIBLE_STATE: Incompatible state. - * @QMI_PROTOCOL_ERROR_FDN_RESTRICT: FDN restrict. - * @QMI_PROTOCOL_ERROR_SUPS_FAILURE_CASE: SUPS failure case. - * @QMI_PROTOCOL_ERROR_NO_RADIO: No radio. - * @QMI_PROTOCOL_ERROR_NOT_SUPPORTED: Not supported. - * @QMI_PROTOCOL_ERROR_NO_SUBSCRIPTION: No subscription. - * @QMI_PROTOCOL_ERROR_CARD_CALL_CONTROL_FAILED: Card call control failed. - * @QMI_PROTOCOL_ERROR_NETWORK_ABORTED: Network aborted. - * @QMI_PROTOCOL_ERROR_MSG_BLOCKED: Message blocked. - * @QMI_PROTOCOL_ERROR_INVALID_SESSION_TYPE: Invalid session type. - * @QMI_PROTOCOL_ERROR_INVALID_PB_TYPE: Invalid PB type. - * @QMI_PROTOCOL_ERROR_NO_SIM: No SIM. - * @QMI_PROTOCOL_ERROR_PB_NOT_READY: PB not ready. - * @QMI_PROTOCOL_ERROR_PIN_RESTRICTION: PIN restriction. - * @QMI_PROTOCOL_ERROR_PIN2_RESTRICTION: PIN2 restriction. - * @QMI_PROTOCOL_ERROR_PUK_RESTRICTION: PUK restriction. - * @QMI_PROTOCOL_ERROR_PUK2_RESTRICTION: PUK2 restriction. - * @QMI_PROTOCOL_ERROR_PB_ACCESS_RESTRICTED: PB access restricted. - * @QMI_PROTOCOL_ERROR_PB_TEXT_TOO_LONG: PB text too long. - * @QMI_PROTOCOL_ERROR_PB_NUMBER_TOO_LONG: PB number too long. - * @QMI_PROTOCOL_ERROR_PB_HIDDEN_KEY_RESTRICTION: PB hidden key restriction. + * @QMI_PROTOCOL_ERROR_ACK_NOT_SENT: ACK not sent. Since: 1.6. + * @QMI_PROTOCOL_ERROR_INJECT_TIMEOUT: Inject timeout. Since: 1.6. + * @QMI_PROTOCOL_ERROR_INCOMPATIBLE_STATE: Incompatible state. Since: 1.6. + * @QMI_PROTOCOL_ERROR_FDN_RESTRICT: FDN restrict. Since: 1.6. + * @QMI_PROTOCOL_ERROR_SUPS_FAILURE_CASE: SUPS failure case. Since: 1.6. + * @QMI_PROTOCOL_ERROR_NO_RADIO: No radio. Since: 1.6. + * @QMI_PROTOCOL_ERROR_NOT_SUPPORTED: Not supported. Since: 1.6. + * @QMI_PROTOCOL_ERROR_NO_SUBSCRIPTION: No subscription. Since: 1.6. + * @QMI_PROTOCOL_ERROR_CARD_CALL_CONTROL_FAILED: Card call control failed. Since: 1.6. + * @QMI_PROTOCOL_ERROR_NETWORK_ABORTED: Network aborted. Since: 1.6. + * @QMI_PROTOCOL_ERROR_MSG_BLOCKED: Message blocked. Since: 1.6. + * @QMI_PROTOCOL_ERROR_INVALID_SESSION_TYPE: Invalid session type. Since: 1.6. + * @QMI_PROTOCOL_ERROR_INVALID_PB_TYPE: Invalid PB type. Since: 1.6. + * @QMI_PROTOCOL_ERROR_NO_SIM: No SIM. Since: 1.6. + * @QMI_PROTOCOL_ERROR_PB_NOT_READY: PB not ready. Since: 1.6. + * @QMI_PROTOCOL_ERROR_PIN_RESTRICTION: PIN restriction. Since: 1.6. + * @QMI_PROTOCOL_ERROR_PIN2_RESTRICTION: PIN2 restriction. Since: 1.6. + * @QMI_PROTOCOL_ERROR_PUK_RESTRICTION: PUK restriction. Since: 1.6. + * @QMI_PROTOCOL_ERROR_PUK2_RESTRICTION: PUK2 restriction. Since: 1.6. + * @QMI_PROTOCOL_ERROR_PB_ACCESS_RESTRICTED: PB access restricted. Since: 1.6. + * @QMI_PROTOCOL_ERROR_PB_TEXT_TOO_LONG: PB text too long. Since: 1.6. + * @QMI_PROTOCOL_ERROR_PB_NUMBER_TOO_LONG: PB number too long. Since: 1.6. + * @QMI_PROTOCOL_ERROR_PB_HIDDEN_KEY_RESTRICTION: PB hidden key restriction. Since: 1.6. * @QMI_PROTOCOL_ERROR_CAT_EVENT_REGISTRATION_FAILED: Event registration failed. * @QMI_PROTOCOL_ERROR_CAT_INVALID_TERMINAL_RESPONSE: Invalid terminal response. * @QMI_PROTOCOL_ERROR_CAT_INVALID_ENVELOPE_COMMAND: Invalid envelope command. @@ -173,6 +203,8 @@ typedef enum { /*< underscore_name=qmi_core_error >*/ * @QMI_PROTOCOL_ERROR_CAT_ENVELOPE_COMMAND_FAILED: Envelope command failed. * * QMI protocol errors. + * + * Since: 1.0 */ typedef enum { /*< underscore_name=qmi_protocol_error >*/ QMI_PROTOCOL_ERROR_NONE = 0, /*< nick=None >*/ @@ -280,4 +312,10 @@ typedef enum { /*< underscore_name=qmi_protocol_error >*/ QMI_PROTOCOL_ERROR_CAT_ENVELOPE_COMMAND_FAILED = 61445 /*< nick=Cat.EnvelopeCommandFailed >*/ } QmiProtocolError; +/** + * qmi_protocol_error_get_string: + * + * Since: 1.0 + */ + #endif /* _LIBQMI_GLIB_QMI_ERRORS_H_ */ diff --git a/src/libqmi-glib/qmi-flags64-dms.h b/src/libqmi-glib/qmi-flags64-dms.h index b416569..3df35a3 100644 --- a/src/libqmi-glib/qmi-flags64-dms.h +++ b/src/libqmi-glib/qmi-flags64-dms.h @@ -126,6 +126,12 @@ typedef enum { /* Bits 62-63 reserved */ } QmiDmsBandCapability; +/** + * qmi_dms_band_capability_build_string_from_mask: + * + * Since: 1.0 + */ + /** * QmiDmsLteBandCapability: * @QMI_DMS_LTE_BAND_CAPABILITY_EUTRAN_1: LTE EUTRAN Band 1 @@ -202,4 +208,10 @@ typedef enum { /* Bit 43-64 reserved */ } QmiDmsLteBandCapability; +/** + * qmi_dms_lte_band_capability_build_string_from_mask: + * + * Since: 1.0 + */ + #endif /* _LIBQMI_GLIB_QMI_FLAGS64_DMS_H_ */ diff --git a/src/libqmi-glib/qmi-flags64-nas.h b/src/libqmi-glib/qmi-flags64-nas.h index ef0c621..dbac27e 100644 --- a/src/libqmi-glib/qmi-flags64-nas.h +++ b/src/libqmi-glib/qmi-flags64-nas.h @@ -75,6 +75,8 @@ * @QMI_NAS_BAND_PREFERENCE_WCDMA_1700_JAPAN: WCDMA 1700 (Japan). * * Flags to specify frequency band preferences. + * + * Since: 1.0 */ typedef enum { QMI_NAS_BAND_PREFERENCE_BC_0_A_SYSTEM = 1 << 0, @@ -121,6 +123,12 @@ typedef enum { /* Bits 60-63 reserved */ } QmiNasBandPreference; +/** + * qmi_nas_band_preference_build_string_from_mask: + * + * Since: 1.0 + */ + /** * QmiNasLteBandPreference: * @QMI_NAS_LTE_BAND_PREFERENCE_EUTRAN_1: LTE EUTRAN Band 1 @@ -157,6 +165,8 @@ typedef enum { * @QMI_NAS_LTE_BAND_PREFERENCE_EUTRAN_43: LTE EUTRAN Band 43. * * Flags to specify LTE-specific frequency band preferences. + * + * Since: 1.0 */ typedef enum { QMI_NAS_LTE_BAND_PREFERENCE_EUTRAN_1 = 1 << 0, @@ -197,4 +207,10 @@ typedef enum { /* Bit 43-64 reserved */ } QmiNasLteBandPreference; +/** + * qmi_nas_lte_band_preference_build_string_from_mask: + * + * Since: 1.0 + */ + #endif /* _LIBQMI_GLIB_QMI_FLAGS64_NAS_H_ */ -- cgit v1.2.3