Bug 809726 - Part 1: Add new interface in nsIRadioInterfaceLayer. r=allstars.chh

dom/system/gonk/nsIRadioInterfaceLayer.idl

@@ -138,6 +138,21 @@ interface nsIRILContactCallback : nsISupports
                            in jsval contacts);
 };
 
+[scriptable, function, uuid(ab954d56-12a1-4c6b-8753-14ad5664111d)]
+interface nsIRILContactUpdateCallback : nsISupports
+{
+  /**
+   * Called when an ICC contact is updated.
+   *
+   * @param errorMsg
+   *        Error message from RIL.
+   * @param contactType
+   *        Type of the contact, i.e. ADN.
+   */
+  void onUpdated(in DOMString errorMsg,
+                 in DOMString contactType);
+};
+
 [scriptable, uuid(c5e31c2c-a6a1-44c3-a30e-7fdfb4dc1750)]
 interface nsIRILCellBroadcastCallback : nsISupports
 {
@@ -291,7 +306,7 @@ interface nsIRilContext : nsISupports
   readonly attribute nsIDOMMozMobileConnectionInfo data;
 };
 
-[scriptable, uuid(a585a7f4-6a64-4d6b-a3fb-bcd90624dcd4)]
+[scriptable, uuid(385345ee-f78c-4be4-abd2-07d3dae4e208)]
 interface nsIRadioInterfaceLayer : nsISupports
 {
   const unsigned short CALL_STATE_UNKNOWN = 0;
@@ -360,4 +375,23 @@ interface nsIRadioInterfaceLayer : nsISupports
    */
   void getICCContacts(in DOMString contactType,
                       in nsIRILContactCallback callback);
+
+  /**
+   * Update ICC Contact.
+   *
+   * This function allows two operations: update the existing contact or
+   *                                      insert a new contact.
+   * If the contact has 'recordId' property, the corresponding record will be
+   * updated. If not, the contact will be inserted.
+   *
+   * @param contactType One of the values below.
+   *                    "ADN" (Abbreviated Dialling Numbers)
+   * @param contact     The contact will be updated.
+   *                    If has 'recordId' property, updates corresponding record.
+   *                    If not, finds a free record and updates it.
+   * @param callback    A nsIRILContactUpdateCallback object.
+   */
+  void updateICCContact(in DOMString contactType,
+                        in jsval contact,
+                        in nsIRILContactUpdateCallback callback);
 };