api,bearer: new 'access-type-preference' setting

In 5G capable devices, which can support multiple types of access
types (either 3GPP or non-3GPP), the UE may request to use a 3GPP
access type exclusively, prefer a 3GPP access type, or just report no
preference.

When supported, this field may also be part of the settings that can
be stored as part of a profile.

docs/reference/api/ModemManager-sections.txt

@@ -16,6 +16,7 @@ MMBearerIpMethod
 MMBearerAllowedAuth
 MMBearerMultiplexSupport
 MMBearerApnType
+MMBearerAccessTypePreference
 MMCallDirection
 MMCallState
 MMCallStateReason

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

@@ -1705,6 +1705,7 @@ mm_bearer_apn_type_build_string_from_mask
 mm_sim_type_get_string
 mm_sim_esim_status_get_string
 mm_sim_removability_get_string
+mm_bearer_access_type_preference_get_string
 mm_modem_capability_build_string_from_mask
 mm_modem_state_get_string
 mm_modem_state_failed_reason_get_string
@@ -1775,6 +1776,7 @@ mm_bearer_apn_type_get_string
 mm_sim_type_build_string_from_mask
 mm_sim_esim_status_build_string_from_mask
 mm_sim_removability_build_string_from_mask
+mm_bearer_access_type_preference_build_string_from_mask
 mm_modem_cdma_registration_state_build_string_from_mask
 mm_modem_cdma_activation_state_build_string_from_mask
 mm_modem_cdma_rm_protocol_build_string_from_mask
@@ -1807,6 +1809,7 @@ MM_TYPE_BEARER_APN_TYPE
 MM_TYPE_SIM_TYPE
 MM_TYPE_ESIM_STATUS
 MM_TYPE_SIM_REMOVAL_STATUS
+MM_TYPE_BEARER_ACCESS_TYPE_PREFERENCE
 MM_TYPE_FIRMWARE_IMAGE_TYPE
 MM_TYPE_MODEM_3GPP_FACILITY
 MM_TYPE_MODEM_3GPP_NETWORK_AVAILABILITY
@@ -1857,6 +1860,7 @@ mm_bearer_apn_type_get_type
 mm_sim_type_get_type
 mm_sim_esim_status_get_type
 mm_sim_removability_get_type
+mm_bearer_access_type_preference_get_type
 mm_firmware_image_type_get_type
 mm_modem_3gpp_facility_get_type
 mm_modem_3gpp_network_availability_get_type

include/ModemManager-enums.h

@@ -1821,4 +1821,23 @@ typedef enum { /*< underscore_name=mm_modem_3gpp_drx_cycle >*/
     MM_MODEM_3GPP_DRX_CYCLE_256         = 5,
 } MMModem3gppDrxCycle;
 
+/**
+ * MMBearerAccessTypePreference:
+ * @MM_BEARER_ACCESS_TYPE_PREFERENCE_NONE: No access type preference, or unknown.
+ * @MM_BEARER_ACCESS_TYPE_PREFERENCE_3GPP_ONLY: 3GPP access type only.
+ * @MM_BEARER_ACCESS_TYPE_PREFERENCE_3GPP_PREFERRED: All access types allowed but 3GPP preferred.
+ * @MM_BEARER_ACCESS_TYPE_PREFERENCE_NON_3GPP_ONLY: Non-3GPP access type only.
+ *
+ * 5G network access type preference, such as 3GPP (NR, E-UTRA) or
+ * non-3GPP (untrusted WiFi, trusted WiFi, wireline).
+ *
+ * Since: 1.20
+ */
+typedef enum { /*< underscore_name=mm_bearer_access_type_preference >*/
+    MM_BEARER_ACCESS_TYPE_PREFERENCE_NONE           = 0,
+    MM_BEARER_ACCESS_TYPE_PREFERENCE_3GPP_ONLY      = 1,
+    MM_BEARER_ACCESS_TYPE_PREFERENCE_3GPP_PREFERRED = 2,
+    MM_BEARER_ACCESS_TYPE_PREFERENCE_NON_3GPP_ONLY  = 3,
+} MMBearerAccessTypePreference;
+
 #endif /*  _MODEMMANAGER_ENUMS_H_ */

introspection/org.freedesktop.ModemManager1.Bearer.xml

@@ -482,6 +482,13 @@
               value (signature <literal>"s"</literal>).
             </listitem>
           </varlistentry>
+          <varlistentry><term><literal>"access-type-preference"</literal></term>
+            <listitem><para>
+              Access type preference for 5G devices, given as a
+              <link linkend="MMBearerAccessTypePreference">MMBearerAccessTypePreference</link>
+              value (signature <literal>"u"</literal>. Since 1.20.
+            </para></listitem>
+          </varlistentry>
           <varlistentry><term><literal>"profile-id"</literal></term>
             <listitem>
               The ID of the 3GPP profile to connect to (signature