api: support location assistance data

Sometimes SUPL-server based A-GPS is not possible, e.g. if the module
doesn't have Internet connectivity. In such cases, the modem may
support injecting additional "assistance data" that may be downloaded
from the Internet using external means (e.g. WiFi), in order to keep
having a quick time to first fix.

We now support using this location assistance data, with the following
new API elements:

 * A new mask of supported assistance data types is provided in the
   SupportedAssistanceData property.

 * A new list of URLs from where the aassistance data may be
   downloaded is also provided in a new AssistanceDataServers
   property.

 * A new InjectAssistanceData() method is provided, to perform the
   data injection in the module once it's been downloaded to the host
   system.

1 files changed, 34 insertions, 0 deletions

diff --git a/introspection/org.freedesktop.ModemManager1.Modem.Location.xml b/introspection/org.freedesktop.ModemManager1.Modem.Location.xml
index fa51a6e2..7c490c6a 100644
--- a/introspection/org.freedesktop.ModemManager1.Modem.Location.xml
+++ b/introspection/org.freedesktop.ModemManager1.Modem.Location.xml
@@ -80,6 +80,24 @@
     </method>
 
     <!--
+        InjectAssistanceData:
+        @data: assistance data to be injected to the GNSS module.
+
+        Inject assistance data to the GNSS module.
+        The data files should be downloaded using external means from the URLs specified in
+        the <link linkend="AssistanceDataServers">AssistanceDataServers</link> property.
+
+        The user does not need to specify the assistance data type being given.
+
+        There is no maximum @data size limit specified, default DBus system bus limits apply.
+    -->
+    <method name="InjectAssistanceData">
+      <arg name="data" type="ay" direction="in">
+        <annotation name="org.gtk.GDBus.C.ForceGVariant" value="true"/>
+      </arg>
+    </method>
+
+    <!--
         SetGpsRefreshRate:
         @rate: Rate, in seconds.
 
@@ -102,6 +120,14 @@
     <property name="Capabilities" type="u" access="read" />
 
     <!--
+        SupportedAssistanceData:
+
+        Bitmask of <link linkend="MMModemLocationAssistanceDataType">MMModemLocationAssistanceDataType</link>
+        values, specifying the supported types of assistance data.
+    -->
+    <property name="SupportedAssistanceData" type="u" access="read" />
+
+    <!--
         Enabled:
 
         Bitmask specifying which of the supported
@@ -313,6 +339,14 @@
     <property name="SuplServer" type="s" access="read" />
 
     <!--
+        AssistanceDataServers:
+
+        URLs from where the user can download assistance data files to inject with
+        <link linkend="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.InjectAssistanceData">InjectAssistanceData()</link>.
+    -->
+    <property name="AssistanceDataServers" type="as" access="read" />
+
+    <!--
         GpsRefreshRate:
 
         Rate of refresh of the GPS information in the interface.