From d4b2be5f6b1a2e4e203dc6038bf31e63e4d80670 Mon Sep 17 00:00:00 2001
From: David Rochberg <rochberg@chromium.org>
Date: Mon, 11 Oct 2010 17:14:32 -0400
Subject: [PATCH] Replace ActivationCompleted with ActivationStateChanged, add
 CDMA error enums.

BUG=6885
TEST=mm-modem.h is correct, cromo compiles

Change-Id: I2b6a49bda5a6ff7bf6e4aac2e99914bf3c33c732

Review URL: http://codereview.chromium.org/3705001

Review URL: http://codereview.chromium.org/3702006
---
 ...rg.freedesktop.ModemManager.Modem.Cdma.xml | 79 ++++++++++++++++++-
 1 file changed, 77 insertions(+), 2 deletions(-)

diff --git a/introspection/org.freedesktop.ModemManager.Modem.Cdma.xml b/introspection/org.freedesktop.ModemManager.Modem.Cdma.xml
index fd6a4d3d..3e4c98b7 100644
--- a/introspection/org.freedesktop.ModemManager.Modem.Cdma.xml
+++ b/introspection/org.freedesktop.ModemManager.Modem.Cdma.xml
@@ -5,7 +5,9 @@
 
     <method name="Activate">
       <tp:docstring>
-        Activates the modem for use with a given carrier.
+        Activates the modem for use with a given carrier.  In the
+        event of immediate failure, returns an error value instead of
+        setting a DBus error.
       </tp:docstring>
       <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>
       <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_modem_cdma_activate"/>
@@ -14,6 +16,13 @@
           Name of carrier.
         </tp:docstring>
       </arg>
+      <arg name="immediate_error" type="u" direction="out">
+        <tp:docstring>
+          An enum from MM_MODEM_CDMA_ACTIVATION_ERROR.  This is
+          returned for immediate errors.  Delayed errors are returned
+          via an ActivationStateChanged signal
+        </tp:docstring>
+      </arg>
     </method>
 
     <method name="ActivateManual">
@@ -31,6 +40,24 @@
       </arg>
     </method>
 
+    <signal name="ActivationStateChanged">
+      <tp:docstring>
+	    The device activation state changed.
+      </tp:docstring>
+      <arg name="activation_state" type="u" tp:type="MM_MODEM_CDMA_ACTIVATION_STATE">
+        <tp:docstring>Current activation state</tp:docstring>
+      </arg>
+      <arg name="activation_error" type="u" tp:type="MM_MODEM_CDMA_ACTIVATION_ERROR">
+        <tp:docstring>Carrier-specific error code</tp:docstring>
+      </arg>
+      <arg name="status_changes" type="a{sv}">
+        <tp:docstring>Selected Modem.Simple.GetStatus keys that have changed as a
+          result of this activation state change.  Will include 'mdn'
+          and 'min'.
+        </tp:docstring>
+      </arg>
+    </signal>
+
     <method name="GetSignalQuality">
       <tp:docstring>
 	Get the current signal quality.
@@ -140,6 +167,54 @@
         <tp:docstring>Device is ready for use.</tp:docstring>
       </tp:enumvalue>
     </tp:enum>
+
+    <tp:enum name="MM_MODEM_CDMA_ACTIVATION_ERROR" type="u">
+      <tp:enumvalue suffix="NO_ERROR" value="0"/>
+      <tp:enumvalue suffix="ROAMING" value="1">
+        <tp:docstring>
+          Device cannot activate while roaming.
+        </tp:docstring>
+      </tp:enumvalue>
+      <tp:enumvalue suffix="WRONG_RADIO_INTERFACE" value="2">
+        <tp:docstring>
+          Device cannot activate on this network type (eg EVDO vs 1xRTT).
+        </tp:docstring>
+      </tp:enumvalue>
+      <tp:enumvalue suffix="COULD_NOT_CONNECT" value="3">
+        <tp:docstring>
+          Device could not connect to the network for activation.
+        </tp:docstring>
+      </tp:enumvalue>
+      <tp:enumvalue suffix="SECURITY_AUTHENTICATION_FAILED" value="4">
+        <tp:docstring>
+          Device could not authenticate to the network for activation.
+        </tp:docstring>
+      </tp:enumvalue>
+      <tp:enumvalue suffix="PROVISIONING_FAILED" value="5">
+        <tp:docstring>
+          Later stages of device provisioning failed.
+        </tp:docstring>
+      </tp:enumvalue>
+      <tp:enumvalue suffix="NO_SIGNAL" value="6">
+        <tp:docstring>
+          No signal available.
+        </tp:docstring>
+      </tp:enumvalue>
+      <tp:enumvalue suffix="UNKNOWN" value="7">
+        <tp:docstring>
+          An error occurred.
+        </tp:docstring>
+      </tp:enumvalue>
+      <tp:enumvalue suffix="TIMED_OUT" value="8">
+        <tp:docstring>
+          Activation timed out.
+        </tp:docstring>
+      </tp:enumvalue>
+      <tp:enumvalue suffix="START_FAILED" value="9">
+        <tp:docstring>
+          API call for initial activation failed.
+        </tp:docstring>
+      </tp:enumvalue>
+    </tp:enum>
   </interface>
 </node>
-