From 24c40e32bd6b5a9becbba05d18f8fbbdc3592d51 Mon Sep 17 00:00:00 2001
From: Aleksander Morgado <aleksander@lanedo.com>
Date: Wed, 31 Oct 2012 12:34:07 +0100
Subject: [PATCH] api: new source for the CDMA Base Station location

---
 include/ModemManager-enums.h                  |  2 ++
 ...eedesktop.ModemManager1.Modem.Location.xml | 24 +++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/include/ModemManager-enums.h b/include/ModemManager-enums.h
index ad74037f..543baab2 100644
--- a/include/ModemManager-enums.h
+++ b/include/ModemManager-enums.h
@@ -493,6 +493,7 @@ typedef enum { /*< underscore_name=mm_sms_storage >*/
  * @MM_MODEM_LOCATION_SOURCE_3GPP_LAC_CI: Location Area Code and Cell ID.
  * @MM_MODEM_LOCATION_SOURCE_GPS_RAW: GPS location given by predefined keys.
  * @MM_MODEM_LOCATION_SOURCE_GPS_NMEA: GPS location given as NMEA traces.
+ * @MM_MODEM_LOCATION_SOURCE_CDMA_BS: CDMA base station position.
  *
  * Sources of location information supported by the modem.
  */
@@ -501,6 +502,7 @@ typedef enum { /*< underscore_name=mm_modem_location_source >*/
     MM_MODEM_LOCATION_SOURCE_3GPP_LAC_CI = 1 << 0,
     MM_MODEM_LOCATION_SOURCE_GPS_RAW     = 1 << 1,
     MM_MODEM_LOCATION_SOURCE_GPS_NMEA    = 1 << 2,
+    MM_MODEM_LOCATION_SOURCE_CDMA_BS     = 1 << 3,
 } MMModemLocationSource;
 
 /**
diff --git a/introspection/org.freedesktop.ModemManager1.Modem.Location.xml b/introspection/org.freedesktop.ModemManager1.Modem.Location.xml
index 42e2b767..a23ec75d 100644
--- a/introspection/org.freedesktop.ModemManager1.Modem.Location.xml
+++ b/introspection/org.freedesktop.ModemManager1.Modem.Location.xml
@@ -237,6 +237,30 @@
             </para>
           </listitem>
         </varlistentry>
+        <varlistentry><term><link linkend="MM-MODEM-LOCATION-SOURCE-CDMA-BS:CAPS">MM_MODEM_LOCATION_SOURCE_CDMA_BS</link></term>
+          <listitem>
+            <para>
+              Devices supporting this
+              capability return a D-Bus dictionary (signature <literal>"a{sv}"</literal>) mapping well-known
+              keys to values with defined formats.
+            </para>
+            <para>
+              The allowed key/value pairs and their formats are:
+            </para>
+            <variablelist>
+              <varlistentry><term><literal>"latitude"</literal></term>
+                <listitem>
+                  (Required) Latitude in Decimal Degrees (positive numbers mean N quadrasphere, negative mean S quadrasphere), given as a double value (signature <literal>"d"</literal>). e.g. <literal>38.889722</literal>, meaning 38d 53' 22" N.
+                </listitem>
+              </varlistentry>
+              <varlistentry><term><literal>"longitude"</literal></term>
+                <listitem>
+                  (Required) Longitude in Decimal Degrees (positive numbers mean E quadrasphere, negative mean W quadrasphere), given as a double value (signature <literal>"d"</literal>). e.g. <literal>-77.008889</literal>, meaning 77d 0' 32" W.
+                </listitem>
+              </varlistentry>
+            </variablelist>
+          </listitem>
+        </varlistentry>
         </variablelist>
     -->
     <property name="Location" type="a{uv}" access="read" />