From b95bcfe6e37662e9947ded7b1c73ae9b6ada0631 Mon Sep 17 00:00:00 2001 From: Aleksander Morgado Date: Sun, 12 Apr 2020 17:49:36 +0200 Subject: [PATCH] api,location: improve InjectAssistanceData() method docs Explain when this method should be used instead of A-GPS. --- ...rg.freedesktop.ModemManager1.Modem.Location.xml | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/introspection/org.freedesktop.ModemManager1.Modem.Location.xml b/introspection/org.freedesktop.ModemManager1.Modem.Location.xml index 8344648a..e0ac537d 100644 --- a/introspection/org.freedesktop.ModemManager1.Modem.Location.xml +++ b/introspection/org.freedesktop.ModemManager1.Modem.Location.xml @@ -104,13 +104,19 @@ 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 AssistanceDataServers property. + Inject assistance data to the GNSS module, which will allow it to have a more + accurate positioning information. - The user does not need to specify the assistance data type being given. + The data files should be downloaded using external means from the URLs specified in + the AssistanceDataServers 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. + + This method may be used when the device does not have a mobile network connection by + itself, and therefore it cannot use any A-GPS server to improve the accuracy of the + position. In this case, the user can instead download the assistance data files using + a WiFi or LAN network, and inject them to the GNSS engine manually. -->