Bug 1063304 - 3.a/3: add nsIMobileConnection. Interface changes. r=echen, r=htsai
authorVicamo Yang <vyang@mozilla.com>
Sun, 21 Sep 2014 15:24:42 +0800
changeset 206404 299482975a2ffe033fca09ba354b1e42998b9356
parent 206403 e27e309897fd19f6ab2846316c11d85d38116c0c
child 206405 09012bde18272a0cccca68af18c9d6a8848dd91e
push id27526
push usercbook@mozilla.com
push dateMon, 22 Sep 2014 11:06:35 +0000
treeherdermozilla-central@5e704397529b [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewersechen, htsai
bugs1063304
milestone35.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
Bug 1063304 - 3.a/3: add nsIMobileConnection. Interface changes. r=echen, r=htsai
dom/mobileconnection/interfaces/nsIMobileConnectionService.idl
--- a/dom/mobileconnection/interfaces/nsIMobileConnectionService.idl
+++ b/dom/mobileconnection/interfaces/nsIMobileConnectionService.idl
@@ -1,14 +1,15 @@
 /* This Source Code Form is subject to the terms of the Mozilla Public
  * License, v. 2.0. If a copy of the MPL was not distributed with this file,
  * You can obtain one at http://mozilla.org/MPL/2.0/. */
 
 #include "nsISupports.idl"
 
+interface nsIMobileConnection;
 interface nsIMobileConnectionInfo;
 interface nsIMobileNetworkInfo;
 interface nsIVariant;
 
 [scriptable, uuid(bc0d4d76-fd3a-4593-818f-cb6ff87fbb55)]
 interface nsIMobileConnectionListener : nsISupports
 {
   /**
@@ -195,23 +196,27 @@ interface nsIMobileConnectionCallback : 
 %{C++
 #define NS_MOBILE_CONNECTION_SERVICE_CID \
   { 0xc6f229d4, 0x16e2, 0x4600, \
     { 0x87, 0x2a, 0x3d, 0x3d, 0xc5, 0xb8, 0x55, 0x41 } }
 #define NS_MOBILE_CONNECTION_SERVICE_CONTRACTID \
   "@mozilla.org/mobileconnection/mobileconnectionservice;1"
 %}
 
-/**
- * XPCOM component (in the content process) that provides the mobile
- * network information.
- */
-[scriptable, uuid(b50ad32d-f70e-4729-a947-e8cfdb6ba81f)]
+[scriptable, uuid(eaba3c4a-0dd5-4919-b1a2-7812e49dbbcb)]
 interface nsIMobileConnectionService : nsISupports
 {
+  readonly attribute unsigned long numItems;
+
+  nsIMobileConnection getItemByServiceId(in unsigned long serviceId);
+};
+
+[scriptable, uuid(04db7331-54fe-4cf7-9347-b9481350f4c2)]
+interface nsIMobileConnection : nsISupports
+{
   const long ICC_SERVICE_CLASS_VOICE      = (1 << 0);
   const long ICC_SERVICE_CLASS_DATA       = (1 << 1);
   const long ICC_SERVICE_CLASS_FAX        = (1 << 2);
   const long ICC_SERVICE_CLASS_SMS        = (1 << 3);
   const long ICC_SERVICE_CLASS_DATA_SYNC  = (1 << 4);
   const long ICC_SERVICE_CLASS_DATA_ASYNC = (1 << 5);
   const long ICC_SERVICE_CLASS_PACKET     = (1 << 6);
   const long ICC_SERVICE_CLASS_PAD        = (1 << 7);
@@ -253,540 +258,447 @@ interface nsIMobileConnectionService : n
    * Calling line identification restriction constants.
    *
    * @see 3GPP TS 27.007 7.7 Defined values.
    */
   const long CLIR_DEFAULT     = 0;
   const long CLIR_INVOCATION  = 1;
   const long CLIR_SUPPRESSION = 2;
 
+  readonly attribute unsigned long serviceId;
+
   /**
-   * Called when a content process registers receiving unsolicited messages from
-   * RadioInterfaceLayer in the chrome process. Only a content process that has
-   * the 'mobileconnection' permission is allowed to register.
+   * Called when any one who is interested in receiving unsolicited messages
+   * from this nsIMobileConnection instance.
    */
-  void registerListener(in unsigned long clientId,
-                        in nsIMobileConnectionListener listener);
-  void unregisterListener(in unsigned long clientId,
-                          in nsIMobileConnectionListener listener);
+  void registerListener(in nsIMobileConnectionListener listener);
+  void unregisterListener(in nsIMobileConnectionListener listener);
 
   /**
-   * These two fields require the 'mobilenetwork' permission.
+   * String of format '<mcc>-<mnc>'. When changed, listener method
+   * 'notifyLastKnownNetworkChanged' is called.
    */
-  DOMString getLastKnownNetwork(in unsigned long clientId);
-  DOMString getLastKnownHomeNetwork(in unsigned long clientId);
+  readonly attribute DOMString lastKnownNetwork;
 
   /**
-   * All fields below require the 'mobileconnection' permission.
+   * String of format '<mcc>-<mnc>[-<spn>]'. When changed, listener method
+   * 'notifyLastKnownHomeNetworkChanged' is called.
    */
-
-  /**
-   * Get the connection information about the voice.
-   *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
-   *
-   * @return a nsIMobileConnectionInfo
-   */
-  nsIMobileConnectionInfo getVoiceConnectionInfo(in unsigned long clientId);
+  readonly attribute DOMString lastKnownHomeNetwork;
 
   /**
-   * Get the connection information about the data.
-   *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
-   *
-   * @return a nsIMobileConnectionInfo
+   * Connection information about the voice.
    */
-  nsIMobileConnectionInfo getDataConnectionInfo(in unsigned long clientId);
+  readonly attribute nsIMobileConnectionInfo voice;
 
   /**
-   * Get the integrated circuit card identifier of the SIM.
-   *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
-   *
-   * @return a DOMString indicates the iccId
+   * Connection information about the data.
    */
-  DOMString getIccId(in unsigned long clientId);
+  readonly attribute nsIMobileConnectionInfo data;
 
   /**
-   * Get the selection mode of the voice and data networks.
-   *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
-   *
-   * @return a DOMString
-   *         Possible values: 'automatic', 'manual', null (unknown).
+   * The integrated circuit card identifier of the SIM.
    */
-  DOMString getNetworkSelectionMode(in unsigned long clientId);
+  readonly attribute DOMString iccId;
 
   /**
-   * Get the current radio state.
-   *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
-   *
-   * @return a DOMString
-   *         Possible values: 'enabling', 'enabled', 'disabling', 'disabled',
-   *         null (unknown).
+   * The selection mode of the voice and data networks. Possible values are
+   * 'automatic', 'manual', null (unknown).
    */
-  DOMString getRadioState(in unsigned long clientId);
+  readonly attribute DOMString networkSelectionMode;
 
   /**
-   * Get the network types that are supported by this radio.
-   *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
+   * Current radio state. Possible values are 'enabling', 'enabled',
+   * 'disabling', 'disabled', null (unknown).
+   */
+  readonly attribute DOMString radioState;
+
+  /**
+   * The network types supported by this radio.
    *
    * @return an array of DOMString
    *         Possible values: 'gsm', 'wcdma', 'cdma', 'evdo', 'lte'.
    */
-  nsIVariant getSupportedNetworkTypes(in unsigned long clientId);
+  void getSupportedNetworkTypes([array, size_is(length)] out wstring types,
+                                [retval] out unsigned long length);
 
   /**
    * Search for available networks.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifyGetNetworksSuccess() will be called. And the
    * result will be an array of nsIMobileNetworkInfo.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void getNetworks(in unsigned long clientId,
-                   in nsIMobileConnectionCallback requestCallback);
+  void getNetworks(in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Manually selects the passed in network, overriding the radio's current
    * selection.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param network
    *        The manually selecting network.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void selectNetwork(in unsigned long clientId,
-                     in nsIMobileNetworkInfo network,
+  void selectNetwork(in nsIMobileNetworkInfo network,
                      in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Tell the radio to automatically select a network.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void selectNetworkAutomatically(in unsigned long clientId,
-                                  in nsIMobileConnectionCallback requestCallback);
+  void selectNetworkAutomatically(in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Set preferred network type.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param type
    *        DOMString indicates the desired preferred network type.
    *        Possible values: 'wcdma/gsm', 'gsm', 'wcdma', 'wcdma/gsm-auto',
    *        'cdma/evdo', 'cdma', 'evdo', 'wcdma/gsm/cdma/evdo',
    *        'lte/cdma/evdo', 'lte/wcdma/gsm', 'lte/wcdma/gsm/cdma/evdo' or
    *        'lte'.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'InvalidParameter',
    * 'IllegalSIMorME', or 'GenericFailure'.
    */
-  void setPreferredNetworkType(in unsigned long clientId,
-                               in DOMString type,
+  void setPreferredNetworkType(in DOMString type,
                                in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Query current preferred network type.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccessString() will be called. And the result
    * will be a string indicating the current preferred network type. The value
    * will be either 'wcdma/gsm', 'gsm', 'wcdma', 'wcdma/gsm-auto', 'cdma/evdo',
    * 'cdma', 'evdo', 'wcdma/gsm/cdma/evdo', 'lte/cdma/evdo', 'lte/wcdma/gsm',
    * 'lte/wcdma/gsm/cdma/evdo' or 'lte'.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void getPreferredNetworkType(in unsigned long clientId,
-                               in nsIMobileConnectionCallback requestCallback);
+  void getPreferredNetworkType(in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Set roaming preference.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param mode
    *        DOMString indicates the desired roaming preference.
    *        Possible values: 'home', 'affiliated', or 'any'.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', InvalidParameter',
    * 'IllegalSIMorME', or 'GenericFailure'.
    */
-  void setRoamingPreference(in unsigned long clientId,
-                            in DOMString mode,
+  void setRoamingPreference(in DOMString mode,
                             in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Query current roaming preference.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccessWithString() will be called. And the result
    * will be a string indicating the current roaming preference. The value will
    * be either 'home', 'affiliated', or 'any'.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void getRoamingPreference(in unsigned long clientId,
-                            in nsIMobileConnectionCallback requestCallback);
+  void getRoamingPreference(in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Set voice privacy preference.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param enabled
    *        Boolean indicates the preferred voice privacy mode used in voice
    *        scrambling in CDMA networks. 'True' means the enhanced voice security
    *        is required.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void setVoicePrivacyMode(in unsigned long clientId,
-                           in bool enabled,
+  void setVoicePrivacyMode(in bool enabled,
                            in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Query current voice privacy mode.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccessWithBoolean() will be called. And the result
    * will be a boolean indicating the current voice privacy mode.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void getVoicePrivacyMode(in unsigned long clientId,
-                           in nsIMobileConnectionCallback requestCallback);
+  void getVoicePrivacyMode(in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Send a MMI message.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param mmi
    *        DOMString containing an MMI string that can be associated to a
    *        USSD request or other RIL functionality.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySendCancelMmiSuccess() will be called. And the
    * result will contain the information about the mmi operation.
    *
    * Otherwise, the notifyError() will be called.
    */
-  void sendMMI(in unsigned long clientId,
-               in DOMString mmi,
+  void sendMMI(in DOMString mmi,
                in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Cancel the current MMI request if one exists.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySendCancelMmiSuccess() will be called. And the
    * result will contain the information about the mmi operation.
    *
    * Otherwise, the notifyError() will be called.
    */
-  void cancelMMI(in unsigned long clientId,
-                 in nsIMobileConnectionCallback requestCallback);
+  void cancelMMI(in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Queries current call forwarding options.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param reason
    *        Indicates the reason the call is being forwarded. It shall be one of
    *        the nsIMobileConnectionService.CALL_FORWARD_REASON_* values.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifyGetCallForwardingSuccess() will be called. And the
    * result will be an array of MozCallForwardingOptions.
    * @see MozCallForwardingOptions for the detail of result.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'InvalidParameter',
    * 'IllegalSIMorME', or 'GenericFailure'.
    */
-  void getCallForwarding(in unsigned long clientId,
-                         in unsigned short reason,
+  void getCallForwarding(in unsigned short reason,
                          in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Configures call forwarding options.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param options
    *        An object containing the call forward rule to set.
    * @see MozCallForwardingOptions for the detail of options.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'InvalidParameter',
    * 'IllegalSIMorME', or 'GenericFailure'.
    */
-  void setCallForwarding(in unsigned long clientId,
-                         in jsval options,
+  void setCallForwarding(in jsval options,
                          in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Queries current call barring status.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param options
    *        An object containing the call barring rule to query. No need to
    *        specify 'enabled' property.
    * @see MozCallBarringOptions for the detail of options.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifyGetCallBarringSuccess() will be called. And the
    * result will contain correct 'enabled' property indicating the status of
    * this rule.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'InvalidParameter',
    * 'IllegalSIMorME', or 'GenericFailure'.
    */
-  void getCallBarring(in unsigned long clientId,
-                      in jsval options,
+  void getCallBarring(in jsval options,
                       in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Configures call barring option.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param options
    *        An object containing the call barring rule to set.
    * @see MozCallBarringOptions for the detail of options.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'InvalidParameter',
    * 'IllegalSIMorME', or 'GenericFailure'.
    */
-  void setCallBarring(in unsigned long clientId,
-                      in jsval options,
+  void setCallBarring(in jsval options,
                       in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Change call barring facility password.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param options
    *        An object containing information about pin and newPin, and,
    *        this object must have both "pin" and "newPin" attributes
    *        to change the call barring facility password.
    * @see MozCallBarringOptions for the detail of options.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'InvalidParameter',
    * 'IllegalSIMorME', or 'GenericFailure'.
    */
-  void changeCallBarringPassword(in unsigned long clientId,
-                                 in jsval options,
+  void changeCallBarringPassword(in jsval options,
                                  in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Configures call waiting options.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param enabled
    *        Boolean indicates the desired call waiting status.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void setCallWaiting(in unsigned long clientId,
-                      in bool enabled,
+  void setCallWaiting(in bool enabled,
                       in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Queries current call waiting options.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccessWithBoolean() will be called. And the result
    * will be a boolean indicating the call waiting status.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void getCallWaiting(in unsigned long clientId,
-                      in nsIMobileConnectionCallback requestCallback);
+  void getCallWaiting(in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Enables or disables the presentation of the calling line identity (CLI) to
    * the called party when originating a call.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param clirMode
    *        One of the nsIMobileConnectionService.CLIR_* values.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'InvalidParameter',
    * 'IllegalSIMorME', or 'GenericFailure'.
    */
-  void setCallingLineIdRestriction(in unsigned long clientId,
-                                   in unsigned short clirMode,
+  void setCallingLineIdRestriction(in unsigned short clirMode,
                                    in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Queries current CLIR status.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifyGetClirStatusSuccess() will be called. And the
    * result will be a an object containing CLIR 'n' and 'm' parameter.
    * @see MozClirStatus for the detail of result.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void getCallingLineIdRestriction(in unsigned long clientId,
-                                   in nsIMobileConnectionCallback requestCallback);
+  void getCallingLineIdRestriction(in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Exit emergency callback mode.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'RadioNotAvailable', 'RequestNotSupported', 'IllegalSIMorME', or
    * 'GenericFailure'.
    */
-  void exitEmergencyCbMode(in unsigned long clientId,
-                           in nsIMobileConnectionCallback requestCallback);
+  void exitEmergencyCbMode(in nsIMobileConnectionCallback requestCallback);
 
   /**
    * Set radio enabled/disabled.
    *
-   * @param clientId
-   *        Indicate the RIL client, 0 ~ (number of client - 1).
    * @param enabled
    *        Boolean indicates the desired radio power. True to enable the radio.
    * @param requestCallback
    *        Called when request is finished.
    *
    * If successful, the notifySuccess() will be called.
    *
    * Otherwise, the notifyError() will be called, and the error will be either
    * 'InvalidStateError', 'RadioNotAvailable', 'IllegalSIMorME', or
    * 'GenericFailure'.
    *
    * Note: Request is not available when radioState is null, 'enabling', or
    * 'disabling'. Calling the function in above conditions will receive
    * 'InvalidStateError' error.
    */
-  void setRadioEnabled(in unsigned long clientId,
-                       in bool enabled,
+  void setRadioEnabled(in bool enabled,
                        in nsIMobileConnectionCallback requestCallback);
 };