api,modem3gpp: add DRX cycle in 5G registration settings

docs/reference/api/ModemManager-sections.txt

@@ -28,6 +28,7 @@ MMModem3gppUssdSessionState
 MMModem3gppEpsUeModeOperation
 MMModem3gppPacketServiceState
 MMModem3gppMicoMode
+MMModem3gppDrxCycle
 MMModemAccessTechnology
 MMModemBand
 MMModemCapability

docs/reference/libmm-glib/libmm-glib-sections.txt

@@ -1719,6 +1719,7 @@ mm_modem_3gpp_ussd_session_state_get_string
 mm_modem_3gpp_eps_ue_mode_operation_get_string
 mm_modem_3gpp_packet_service_state_get_string
 mm_modem_3gpp_mico_mode_get_string
+mm_modem_3gpp_drx_cycle_get_string
 mm_modem_cdma_registration_state_get_string
 mm_modem_cdma_activation_state_get_string
 mm_modem_cdma_rm_protocol_get_string
@@ -1776,6 +1777,7 @@ mm_modem_cdma_rm_protocol_build_string_from_mask
 mm_modem_3gpp_registration_state_build_string_from_mask
 mm_modem_3gpp_packet_service_state_build_string_from_mask
 mm_modem_3gpp_mico_mode_build_string_from_mask
+mm_modem_3gpp_drx_cycle_build_string_from_mask
 mm_modem_3gpp_subscription_state_build_string_from_mask
 mm_modem_3gpp_facility_get_string
 mm_modem_3gpp_network_availability_build_string_from_mask
@@ -1810,6 +1812,7 @@ MM_TYPE_MODEM_3GPP_USSD_SESSION_STATE
 MM_TYPE_MODEM_3GPP_EPS_UE_MODE_OPERATION
 MM_TYPE_MODEM_3GPP_PACKET_SERVICE_STATE
 MM_TYPE_MODEM_3GPP_MICO_MODE
+MM_TYPE_MODEM_3GPP_DRX_CYCLE
 MM_TYPE_MODEM_ACCESS_TECHNOLOGY
 MM_TYPE_MODEM_BAND
 MM_TYPE_MODEM_CAPABILITY
@@ -1859,6 +1862,7 @@ mm_modem_3gpp_ussd_session_state_get_type
 mm_modem_3gpp_eps_ue_mode_operation_get_type
 mm_modem_3gpp_packet_service_state_get_type
 mm_modem_3gpp_mico_mode_get_type
+mm_modem_3gpp_drx_cycle_get_type
 mm_modem_access_technology_get_type
 mm_modem_band_get_type
 mm_modem_capability_get_type

include/ModemManager-enums.h

@@ -1797,4 +1797,28 @@ typedef enum { /*< underscore_name=mm_modem_3gpp_mico_mode >*/
     MM_MODEM_3GPP_MICO_MODE_ENABLED     = 3,
 } MMModem3gppMicoMode;
 
+/**
+ * MMModem3gppDrxCycle:
+ * @MM_MODEM_3GPP_DRX_CYCLE_UNKNOWN: Unknown or not specified.
+ * @MM_MODEM_3GPP_DRX_CYCLE_UNSUPPORTED: Unsupported.
+ * @MM_MODEM_3GPP_DRX_CYCLE_32: DRX cycle T=32.
+ * @MM_MODEM_3GPP_DRX_CYCLE_64: DRX cycle T=64.
+ * @MM_MODEM_3GPP_DRX_CYCLE_128: DRX cycle T=128.
+ * @MM_MODEM_3GPP_DRX_CYCLE_256: DRX cycle T=256.
+ *
+ * DRX cycle.
+ *
+ * This is a 5G-specific registration setting.
+ *
+ * Since: 1.20
+ */
+typedef enum { /*< underscore_name=mm_modem_3gpp_drx_cycle >*/
+    MM_MODEM_3GPP_DRX_CYCLE_UNKNOWN     = 0,
+    MM_MODEM_3GPP_DRX_CYCLE_UNSUPPORTED = 1,
+    MM_MODEM_3GPP_DRX_CYCLE_32          = 2,
+    MM_MODEM_3GPP_DRX_CYCLE_64          = 3,
+    MM_MODEM_3GPP_DRX_CYCLE_128         = 4,
+    MM_MODEM_3GPP_DRX_CYCLE_256         = 5,
+} MMModem3gppDrxCycle;
+
 #endif /*  _MODEMMANAGER_ENUMS_H_ */

introspection/org.freedesktop.ModemManager1.Modem.Modem3gpp.xml

@@ -132,7 +132,7 @@
 
         The allowed properties in this method are all the ones specified in the
         <link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Modem3gpp.Nr5gRegistrationSettings">Nr5gRegistrationSettings</link>;
-        i.e.: <literal>"mico-mode"</literal>.
+        i.e.: <literal>"mico-mode"</literal> and <literal>"drx-cycle"</literal>.
 
         Since: 1.20
     -->
@@ -352,6 +352,15 @@
             </para>
           </listitem>
         </varlistentry>
+        <varlistentry><term>"drx-cycle"</term>
+          <listitem>
+            <para>
+              A <link linkend="MMModem3gppDrxCycle">MMModem3gppDrxCycle</link> value,
+              representing the DRX settings requested by the host, given as an
+              unsigned integer (signature <literal>"u"</literal>).
+            </para>
+          </listitem>
+        </varlistentry>
         </variablelist>
 
         Since: 1.20