api,modem-3gpp: new 'InitialEpsBearer' property

This property contains the DBus path of a Bearer object of type
MM_BEARER_TYPE_DEFAULT_ATTACH, which is automatically exposed by the
modem when registered in the LTE network.

Unlike standard bearer objects created by the user, this bearer won't
allow any connection/disconnection request, as its status is bound to
the LTE registration exclusively.

The bearer settings exposed by the object include the APN details that
have been used during the initial packet network attach, which may be
defined by modem settings (e.g. if previously configured in the
firmware which APN to use for the given SIM card operator) or by the
network itself (e.g. if none configured, or if a network override is
required as when roaming).

The bearer object will be created as soon as the LTE attach status
details are known, and only while the modem is enabled. The
implementation allows modems to update the LTE attach status details
during runtime, so the bearer object with the settings may be
recreated during runtime as well.

1 files changed, 16 insertions, 1 deletions

diff --git a/libmm-glib/mm-modem-3gpp.h b/libmm-glib/mm-modem-3gpp.h
index f71d8a61..6d87a47d 100644
--- a/libmm-glib/mm-modem-3gpp.h
+++ b/libmm-glib/mm-modem-3gpp.h
@@ -30,6 +30,7 @@
 
 #include <ModemManager.h>
 
+#include "mm-bearer.h"
 #include "mm-gdbus-modem.h"
 
 G_BEGIN_DECLS
@@ -81,7 +82,10 @@ MMModem3gppFacility           mm_modem_3gpp_get_enabled_facility_locks (MMModem3
 
 MMModem3gppEpsUeModeOperation mm_modem_3gpp_get_eps_ue_mode_operation  (MMModem3gpp *self);
 
-GList   *mm_modem_3gpp_get_pco         (MMModem3gpp *self);
+GList       *mm_modem_3gpp_get_pco (MMModem3gpp *self);
+
+const gchar *mm_modem_3gpp_get_initial_eps_bearer_path (MMModem3gpp *self);
+gchar       *mm_modem_3gpp_dup_initial_eps_bearer_path (MMModem3gpp *self);
 
 void     mm_modem_3gpp_register        (MMModem3gpp *self,
                                         const gchar *network_id,
@@ -135,6 +139,17 @@ gboolean mm_modem_3gpp_set_eps_ue_mode_operation_sync   (MMModem3gpp
                                                          GCancellable                   *cancellable,
                                                          GError                        **error);
 
+void      mm_modem_3gpp_get_initial_eps_bearer        (MMModem3gpp          *self,
+                                                       GCancellable         *cancellable,
+                                                       GAsyncReadyCallback   callback,
+                                                       gpointer              user_data);
+MMBearer *mm_modem_3gpp_get_initial_eps_bearer_finish (MMModem3gpp          *self,
+                                                       GAsyncResult         *res,
+                                                       GError              **error);
+MMBearer *mm_modem_3gpp_get_initial_eps_bearer_sync   (MMModem3gpp          *self,
+                                                       GCancellable         *cancellable,
+                                                       GError              **error);
+
 /* Deprecated APIs */
 G_DEPRECATED
 MMModem3gppSubscriptionState mm_modem_3gpp_get_subscription_state (MMModem3gpp *self);