/*
|
* Copyright (C) 2007 The Android Open Source Project
|
*
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
* you may not use this file except in compliance with the License.
|
* You may obtain a copy of the License at
|
*
|
* http://www.apache.org/licenses/LICENSE-2.0
|
*
|
* Unless required by applicable law or agreed to in writing, software
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
* See the License for the specific language governing permissions and
|
* limitations under the License.
|
*/
|
|
package com.android.internal.telephony;
|
|
import android.app.PendingIntent;
|
import android.content.Intent;
|
import android.content.IntentSender;
|
import android.os.Bundle;
|
import android.os.IBinder;
|
import android.os.Messenger;
|
import android.os.ResultReceiver;
|
import android.os.WorkSource;
|
import android.net.NetworkStats;
|
import android.net.Uri;
|
import android.service.carrier.CarrierIdentifier;
|
import android.telecom.PhoneAccount;
|
import android.telecom.PhoneAccountHandle;
|
import android.telephony.CarrierRestrictionRules;
|
import android.telephony.CellInfo;
|
import android.telephony.ClientRequestStats;
|
import android.telephony.IccOpenLogicalChannelResponse;
|
import android.telephony.ICellInfoCallback;
|
import android.telephony.ModemActivityInfo;
|
import android.telephony.NeighboringCellInfo;
|
import android.telephony.NetworkScanRequest;
|
import android.telephony.PhoneNumberRange;
|
import android.telephony.RadioAccessFamily;
|
import android.telephony.ServiceState;
|
import android.telephony.SignalStrength;
|
import android.telephony.TelephonyHistogram;
|
import android.telephony.VisualVoicemailSmsFilterSettings;
|
import android.telephony.emergency.EmergencyNumber;
|
import android.telephony.ims.aidl.IImsCapabilityCallback;
|
import android.telephony.ims.aidl.IImsConfig;
|
import android.telephony.ims.aidl.IImsConfigCallback;
|
import android.telephony.ims.aidl.IImsMmTelFeature;
|
import android.telephony.ims.aidl.IImsRcsFeature;
|
import android.telephony.ims.aidl.IImsRegistration;
|
import android.telephony.ims.aidl.IImsRegistrationCallback;
|
import com.android.ims.internal.IImsServiceFeatureCallback;
|
import com.android.internal.telephony.CellNetworkScanResult;
|
import com.android.internal.telephony.IIntegerConsumer;
|
import com.android.internal.telephony.INumberVerificationCallback;
|
import com.android.internal.telephony.OperatorInfo;
|
|
import java.util.List;
|
import java.util.Map;
|
|
import android.telephony.UiccCardInfo;
|
import android.telephony.UiccSlotInfo;
|
|
/**
|
* Interface used to interact with the phone. Mostly this is used by the
|
* TelephonyManager class. A few places are still using this directly.
|
* Please clean them up if possible and use TelephonyManager instead.
|
*
|
* {@hide}
|
*/
|
interface ITelephony {
|
|
/**
|
* Dial a number. This doesn't place the call. It displays
|
* the Dialer screen.
|
* @param number the number to be dialed. If null, this
|
* would display the Dialer screen with no number pre-filled.
|
*/
|
@UnsupportedAppUsage
|
void dial(String number);
|
|
/**
|
* Place a call to the specified number.
|
* @param callingPackage The package making the call.
|
* @param number the number to be called.
|
*/
|
@UnsupportedAppUsage
|
void call(String callingPackage, String number);
|
|
/**
|
* Check to see if the radio is on or not.
|
* @param callingPackage the name of the package making the call.
|
* @return returns true if the radio is on.
|
*/
|
boolean isRadioOn(String callingPackage);
|
|
/**
|
* Check to see if the radio is on or not on particular subId.
|
* @param subId user preferred subId.
|
* @param callingPackage the name of the package making the call.
|
* @return returns true if the radio is on.
|
*/
|
@UnsupportedAppUsage
|
boolean isRadioOnForSubscriber(int subId, String callingPackage);
|
|
/**
|
* Supply a pin to unlock the SIM. Blocks until a result is determined.
|
* @param pin The pin to check.
|
* @return whether the operation was a success.
|
*/
|
@UnsupportedAppUsage
|
boolean supplyPin(String pin);
|
|
/**
|
* Supply a pin to unlock the SIM for particular subId.
|
* Blocks until a result is determined.
|
* @param pin The pin to check.
|
* @param subId user preferred subId.
|
* @return whether the operation was a success.
|
*/
|
boolean supplyPinForSubscriber(int subId, String pin);
|
|
/**
|
* Supply puk to unlock the SIM and set SIM pin to new pin.
|
* Blocks until a result is determined.
|
* @param puk The puk to check.
|
* pin The new pin to be set in SIM
|
* @return whether the operation was a success.
|
*/
|
boolean supplyPuk(String puk, String pin);
|
|
/**
|
* Supply puk to unlock the SIM and set SIM pin to new pin.
|
* Blocks until a result is determined.
|
* @param puk The puk to check.
|
* pin The new pin to be set in SIM
|
* @param subId user preferred subId.
|
* @return whether the operation was a success.
|
*/
|
boolean supplyPukForSubscriber(int subId, String puk, String pin);
|
|
/**
|
* Supply a pin to unlock the SIM. Blocks until a result is determined.
|
* Returns a specific success/error code.
|
* @param pin The pin to check.
|
* @return retValue[0] = Phone.PIN_RESULT_SUCCESS on success. Otherwise error code
|
* retValue[1] = number of attempts remaining if known otherwise -1
|
*/
|
int[] supplyPinReportResult(String pin);
|
|
/**
|
* Supply a pin to unlock the SIM. Blocks until a result is determined.
|
* Returns a specific success/error code.
|
* @param pin The pin to check.
|
* @return retValue[0] = Phone.PIN_RESULT_SUCCESS on success. Otherwise error code
|
* retValue[1] = number of attempts remaining if known otherwise -1
|
*/
|
int[] supplyPinReportResultForSubscriber(int subId, String pin);
|
|
/**
|
* Supply puk to unlock the SIM and set SIM pin to new pin.
|
* Blocks until a result is determined.
|
* Returns a specific success/error code
|
* @param puk The puk to check
|
* pin The pin to check.
|
* @return retValue[0] = Phone.PIN_RESULT_SUCCESS on success. Otherwise error code
|
* retValue[1] = number of attempts remaining if known otherwise -1
|
*/
|
int[] supplyPukReportResult(String puk, String pin);
|
|
/**
|
* Supply puk to unlock the SIM and set SIM pin to new pin.
|
* Blocks until a result is determined.
|
* Returns a specific success/error code
|
* @param puk The puk to check
|
* pin The pin to check.
|
* @return retValue[0] = Phone.PIN_RESULT_SUCCESS on success. Otherwise error code
|
* retValue[1] = number of attempts remaining if known otherwise -1
|
*/
|
int[] supplyPukReportResultForSubscriber(int subId, String puk, String pin);
|
|
/**
|
* Handles PIN MMI commands (PIN/PIN2/PUK/PUK2), which are initiated
|
* without SEND (so <code>dial</code> is not appropriate).
|
*
|
* @param dialString the MMI command to be executed.
|
* @return true if MMI command is executed.
|
*/
|
@UnsupportedAppUsage
|
boolean handlePinMmi(String dialString);
|
|
|
/**
|
* Handles USSD commands.
|
*
|
* @param subId The subscription to use.
|
* @param ussdRequest the USSD command to be executed.
|
* @param wrappedCallback receives a callback result.
|
*/
|
void handleUssdRequest(int subId, String ussdRequest, in ResultReceiver wrappedCallback);
|
|
/**
|
* Handles PIN MMI commands (PIN/PIN2/PUK/PUK2), which are initiated
|
* without SEND (so <code>dial</code> is not appropriate) for
|
* a particular subId.
|
* @param dialString the MMI command to be executed.
|
* @param subId user preferred subId.
|
* @return true if MMI command is executed.
|
*/
|
@UnsupportedAppUsage
|
boolean handlePinMmiForSubscriber(int subId, String dialString);
|
|
/**
|
* Toggles the radio on or off.
|
*/
|
@UnsupportedAppUsage
|
void toggleRadioOnOff();
|
|
/**
|
* Toggles the radio on or off on particular subId.
|
* @param subId user preferred subId.
|
*/
|
void toggleRadioOnOffForSubscriber(int subId);
|
|
/**
|
* Set the radio to on or off
|
*/
|
@UnsupportedAppUsage
|
boolean setRadio(boolean turnOn);
|
|
/**
|
* Set the radio to on or off on particular subId.
|
* @param subId user preferred subId.
|
*/
|
boolean setRadioForSubscriber(int subId, boolean turnOn);
|
|
/**
|
* Set the radio to on or off unconditionally
|
*/
|
boolean setRadioPower(boolean turnOn);
|
|
/**
|
* Request to update location information in service state
|
*/
|
@UnsupportedAppUsage
|
void updateServiceLocation();
|
|
/**
|
* Request to update location information for a subscrition in service state
|
* @param subId user preferred subId.
|
*/
|
void updateServiceLocationForSubscriber(int subId);
|
|
/**
|
* Enable location update notifications.
|
*/
|
@UnsupportedAppUsage
|
void enableLocationUpdates();
|
|
/**
|
* Enable location update notifications.
|
* @param subId user preferred subId.
|
*/
|
void enableLocationUpdatesForSubscriber(int subId);
|
|
/**
|
* Disable location update notifications.
|
*/
|
@UnsupportedAppUsage
|
void disableLocationUpdates();
|
|
/**
|
* Disable location update notifications.
|
* @param subId user preferred subId.
|
*/
|
void disableLocationUpdatesForSubscriber(int subId);
|
|
/**
|
* Allow mobile data connections.
|
*/
|
@UnsupportedAppUsage
|
boolean enableDataConnectivity();
|
|
/**
|
* Disallow mobile data connections.
|
*/
|
@UnsupportedAppUsage
|
boolean disableDataConnectivity();
|
|
/**
|
* Report whether data connectivity is possible.
|
*/
|
boolean isDataConnectivityPossible(int subId);
|
|
Bundle getCellLocation(String callingPkg);
|
|
/**
|
* Returns the ISO country code equivalent of the current registered
|
* operator's MCC (Mobile Country Code).
|
* @see android.telephony.TelephonyManager#getNetworkCountryIso
|
*/
|
String getNetworkCountryIsoForPhone(int phoneId);
|
|
/**
|
* Returns the neighboring cell information of the device.
|
*/
|
List<NeighboringCellInfo> getNeighboringCellInfo(String callingPkg);
|
|
@UnsupportedAppUsage
|
int getCallState();
|
|
/**
|
* Returns the call state for a slot.
|
*/
|
int getCallStateForSlot(int slotIndex);
|
|
@UnsupportedAppUsage
|
int getDataActivity();
|
@UnsupportedAppUsage
|
int getDataState();
|
|
/**
|
* Returns the current active phone type as integer.
|
* Returns TelephonyManager.PHONE_TYPE_CDMA if RILConstants.CDMA_PHONE
|
* and TelephonyManager.PHONE_TYPE_GSM if RILConstants.GSM_PHONE
|
*/
|
@UnsupportedAppUsage
|
int getActivePhoneType();
|
|
/**
|
* Returns the current active phone type as integer for particular slot.
|
* Returns TelephonyManager.PHONE_TYPE_CDMA if RILConstants.CDMA_PHONE
|
* and TelephonyManager.PHONE_TYPE_GSM if RILConstants.GSM_PHONE
|
* @param slotIndex - slot to query.
|
*/
|
int getActivePhoneTypeForSlot(int slotIndex);
|
|
/**
|
* Returns the CDMA ERI icon index to display
|
* @param callingPackage package making the call.
|
*/
|
int getCdmaEriIconIndex(String callingPackage);
|
|
/**
|
* Returns the CDMA ERI icon index to display on particular subId.
|
* @param subId user preferred subId.
|
* @param callingPackage package making the call.
|
*/
|
int getCdmaEriIconIndexForSubscriber(int subId, String callingPackage);
|
|
/**
|
* Returns the CDMA ERI icon mode,
|
* 0 - ON
|
* 1 - FLASHING
|
* @param callingPackage package making the call.
|
*/
|
int getCdmaEriIconMode(String callingPackage);
|
|
/**
|
* Returns the CDMA ERI icon mode on particular subId,
|
* 0 - ON
|
* 1 - FLASHING
|
* @param subId user preferred subId.
|
* @param callingPackage package making the call.
|
*/
|
int getCdmaEriIconModeForSubscriber(int subId, String callingPackage);
|
|
/**
|
* Returns the CDMA ERI text,
|
* @param callingPackage package making the call.
|
*/
|
String getCdmaEriText(String callingPackage);
|
|
/**
|
* Returns the CDMA ERI text for particular subId,
|
* @param subId user preferred subId.
|
* @param callingPackage package making the call.
|
*/
|
String getCdmaEriTextForSubscriber(int subId, String callingPackage);
|
|
/**
|
* Returns true if OTA service provisioning needs to run.
|
* Only relevant on some technologies, others will always
|
* return false.
|
*/
|
boolean needsOtaServiceProvisioning();
|
|
/**
|
* Sets the voicemail number for a particular subscriber.
|
*/
|
boolean setVoiceMailNumber(int subId, String alphaTag, String number);
|
|
/**
|
* Sets the voice activation state for a particular subscriber.
|
*/
|
void setVoiceActivationState(int subId, int activationState);
|
|
/**
|
* Sets the data activation state for a particular subscriber.
|
*/
|
void setDataActivationState(int subId, int activationState);
|
|
/**
|
* Returns the voice activation state for a particular subscriber.
|
* @param subId user preferred sub
|
* @param callingPackage package queries voice activation state
|
*/
|
int getVoiceActivationState(int subId, String callingPackage);
|
|
/**
|
* Returns the data activation state for a particular subscriber.
|
* @param subId user preferred sub
|
* @param callingPackage package queris data activation state
|
*/
|
int getDataActivationState(int subId, String callingPackage);
|
|
/**
|
* Returns the unread count of voicemails for a subId.
|
* @param subId user preferred subId.
|
* Returns the unread count of voicemails
|
*/
|
int getVoiceMessageCountForSubscriber(int subId, String callingPackage);
|
|
/**
|
* Returns true if current state supports both voice and data
|
* simultaneously. This can change based on location or network condition.
|
*/
|
boolean isConcurrentVoiceAndDataAllowed(int subId);
|
|
Bundle getVisualVoicemailSettings(String callingPackage, int subId);
|
|
String getVisualVoicemailPackageName(String callingPackage, int subId);
|
|
// Not oneway, caller needs to make sure the vaule is set before receiving a SMS
|
void enableVisualVoicemailSmsFilter(String callingPackage, int subId,
|
in VisualVoicemailSmsFilterSettings settings);
|
|
oneway void disableVisualVoicemailSmsFilter(String callingPackage, int subId);
|
|
// Get settings set by the calling package
|
VisualVoicemailSmsFilterSettings getVisualVoicemailSmsFilterSettings(String callingPackage,
|
int subId);
|
|
/**
|
* Get settings set by the current default dialer, Internal use only.
|
* Requires READ_PRIVILEGED_PHONE_STATE permission.
|
*/
|
VisualVoicemailSmsFilterSettings getActiveVisualVoicemailSmsFilterSettings(int subId);
|
|
/**
|
* Send a visual voicemail SMS. Internal use only.
|
* Requires caller to be the default dialer and have SEND_SMS permission
|
*/
|
void sendVisualVoicemailSmsForSubscriber(in String callingPackage, in int subId,
|
in String number, in int port, in String text, in PendingIntent sentIntent);
|
|
// Send the special dialer code. The IPC caller must be the current default dialer.
|
void sendDialerSpecialCode(String callingPackageName, String inputCode);
|
|
/**
|
* Returns the network type of a subId.
|
* @param subId user preferred subId.
|
* @param callingPackage package making the call.
|
*/
|
int getNetworkTypeForSubscriber(int subId, String callingPackage);
|
|
/**
|
* Returns the network type for data transmission
|
* @param callingPackage package making the call.
|
*/
|
int getDataNetworkType(String callingPackage);
|
|
/**
|
* Returns the data network type of a subId
|
* @param subId user preferred subId.
|
* @param callingPackage package making the call.
|
*/
|
int getDataNetworkTypeForSubscriber(int subId, String callingPackage);
|
|
/**
|
* Returns the voice network type of a subId
|
* @param subId user preferred subId.
|
* @param callingPackage package making the call.
|
* Returns the network type
|
*/
|
int getVoiceNetworkTypeForSubscriber(int subId, String callingPackage);
|
|
/**
|
* Return true if an ICC card is present
|
*/
|
@UnsupportedAppUsage
|
boolean hasIccCard();
|
|
/**
|
* Return true if an ICC card is present for a subId.
|
* @param slotIndex user preferred slotIndex.
|
* Return true if an ICC card is present
|
*/
|
boolean hasIccCardUsingSlotIndex(int slotIndex);
|
|
/**
|
* Return if the current radio is LTE on CDMA. This
|
* is a tri-state return value as for a period of time
|
* the mode may be unknown.
|
*
|
* @param callingPackage the name of the calling package
|
* @return {@link Phone#LTE_ON_CDMA_UNKNOWN}, {@link Phone#LTE_ON_CDMA_FALSE}
|
* or {@link PHone#LTE_ON_CDMA_TRUE}
|
*/
|
int getLteOnCdmaMode(String callingPackage);
|
|
/**
|
* Return if the current radio is LTE on CDMA. This
|
* is a tri-state return value as for a period of time
|
* the mode may be unknown.
|
*
|
* @param callingPackage the name of the calling package
|
* @return {@link Phone#LTE_ON_CDMA_UNKNOWN}, {@link Phone#LTE_ON_CDMA_FALSE}
|
* or {@link PHone#LTE_ON_CDMA_TRUE}
|
*/
|
int getLteOnCdmaModeForSubscriber(int subId, String callingPackage);
|
|
/**
|
* Returns all observed cell information of the device.
|
*/
|
List<CellInfo> getAllCellInfo(String callingPkg);
|
|
/**
|
* Request a cell information update for the specified subscription,
|
* reported via the CellInfoCallback.
|
*/
|
void requestCellInfoUpdate(int subId, in ICellInfoCallback cb, String callingPkg);
|
|
/**
|
* Request a cell information update for the specified subscription,
|
* reported via the CellInfoCallback.
|
*
|
* @param workSource the requestor to whom the power consumption for this should be attributed.
|
*/
|
void requestCellInfoUpdateWithWorkSource(
|
int subId, in ICellInfoCallback cb, in String callingPkg, in WorkSource ws);
|
|
/**
|
* Sets minimum time in milli-seconds between onCellInfoChanged
|
*/
|
void setCellInfoListRate(int rateInMillis);
|
|
/**
|
* Opens a logical channel to the ICC card using the physical slot index.
|
*
|
* Input parameters equivalent to TS 27.007 AT+CCHO command.
|
*
|
* @param slotIndex The physical slot index of the target ICC card
|
* @param callingPackage the name of the package making the call.
|
* @param AID Application id. See ETSI 102.221 and 101.220.
|
* @param p2 P2 parameter (described in ISO 7816-4).
|
* @return an IccOpenLogicalChannelResponse object.
|
*/
|
IccOpenLogicalChannelResponse iccOpenLogicalChannelBySlot(
|
int slotIndex, String callingPackage, String AID, int p2);
|
|
/**
|
* Opens a logical channel to the ICC card.
|
*
|
* Input parameters equivalent to TS 27.007 AT+CCHO command.
|
*
|
* @param subId The subscription to use.
|
* @param callingPackage the name of the package making the call.
|
* @param AID Application id. See ETSI 102.221 and 101.220.
|
* @param p2 P2 parameter (described in ISO 7816-4).
|
* @return an IccOpenLogicalChannelResponse object.
|
*/
|
IccOpenLogicalChannelResponse iccOpenLogicalChannel(
|
int subId, String callingPackage, String AID, int p2);
|
|
/**
|
* Closes a previously opened logical channel to the ICC card using the physical slot index.
|
*
|
* Input parameters equivalent to TS 27.007 AT+CCHC command.
|
*
|
* @param slotIndex The physical slot index of the target ICC card
|
* @param channel is the channel id to be closed as returned by a
|
* successful iccOpenLogicalChannel.
|
* @return true if the channel was closed successfully.
|
*/
|
boolean iccCloseLogicalChannelBySlot(int slotIndex, int channel);
|
|
/**
|
* Closes a previously opened logical channel to the ICC card.
|
*
|
* Input parameters equivalent to TS 27.007 AT+CCHC command.
|
*
|
* @param subId The subscription to use.
|
* @param channel is the channel id to be closed as returned by a
|
* successful iccOpenLogicalChannel.
|
* @return true if the channel was closed successfully.
|
*/
|
@UnsupportedAppUsage
|
boolean iccCloseLogicalChannel(int subId, int channel);
|
|
/**
|
* Transmit an APDU to the ICC card over a logical channel using the physical slot index.
|
*
|
* Input parameters equivalent to TS 27.007 AT+CGLA command.
|
*
|
* @param slotIndex The physical slot index of the target ICC card
|
* @param channel is the channel id to be closed as returned by a
|
* successful iccOpenLogicalChannel.
|
* @param cla Class of the APDU command.
|
* @param instruction Instruction of the APDU command.
|
* @param p1 P1 value of the APDU command.
|
* @param p2 P2 value of the APDU command.
|
* @param p3 P3 value of the APDU command. If p3 is negative a 4 byte APDU
|
* is sent to the SIM.
|
* @param data Data to be sent with the APDU.
|
* @return The APDU response from the ICC card with the status appended at
|
* the end.
|
*/
|
String iccTransmitApduLogicalChannelBySlot(int slotIndex, int channel, int cla, int instruction,
|
int p1, int p2, int p3, String data);
|
|
/**
|
* Transmit an APDU to the ICC card over a logical channel.
|
*
|
* Input parameters equivalent to TS 27.007 AT+CGLA command.
|
*
|
* @param subId The subscription to use.
|
* @param channel is the channel id to be closed as returned by a
|
* successful iccOpenLogicalChannel.
|
* @param cla Class of the APDU command.
|
* @param instruction Instruction of the APDU command.
|
* @param p1 P1 value of the APDU command.
|
* @param p2 P2 value of the APDU command.
|
* @param p3 P3 value of the APDU command. If p3 is negative a 4 byte APDU
|
* is sent to the SIM.
|
* @param data Data to be sent with the APDU.
|
* @return The APDU response from the ICC card with the status appended at
|
* the end.
|
*/
|
@UnsupportedAppUsage
|
String iccTransmitApduLogicalChannel(int subId, int channel, int cla, int instruction,
|
int p1, int p2, int p3, String data);
|
|
/**
|
* Transmit an APDU to the ICC card over the basic channel using the physical slot index.
|
*
|
* Input parameters equivalent to TS 27.007 AT+CSIM command.
|
*
|
* @param slotIndex The physical slot index of the target ICC card
|
* @param callingPackage the name of the package making the call.
|
* @param cla Class of the APDU command.
|
* @param instruction Instruction of the APDU command.
|
* @param p1 P1 value of the APDU command.
|
* @param p2 P2 value of the APDU command.
|
* @param p3 P3 value of the APDU command. If p3 is negative a 4 byte APDU
|
* is sent to the SIM.
|
* @param data Data to be sent with the APDU.
|
* @return The APDU response from the ICC card with the status appended at
|
* the end.
|
*/
|
String iccTransmitApduBasicChannelBySlot(int slotIndex, String callingPackage, int cla,
|
int instruction, int p1, int p2, int p3, String data);
|
|
/**
|
* Transmit an APDU to the ICC card over the basic channel.
|
*
|
* Input parameters equivalent to TS 27.007 AT+CSIM command.
|
*
|
* @param subId The subscription to use.
|
* @param callingPackage the name of the package making the call.
|
* @param cla Class of the APDU command.
|
* @param instruction Instruction of the APDU command.
|
* @param p1 P1 value of the APDU command.
|
* @param p2 P2 value of the APDU command.
|
* @param p3 P3 value of the APDU command. If p3 is negative a 4 byte APDU
|
* is sent to the SIM.
|
* @param data Data to be sent with the APDU.
|
* @return The APDU response from the ICC card with the status appended at
|
* the end.
|
*/
|
String iccTransmitApduBasicChannel(int subId, String callingPackage, int cla, int instruction,
|
int p1, int p2, int p3, String data);
|
|
/**
|
* Returns the response APDU for a command APDU sent through SIM_IO.
|
*
|
* @param subId The subscription to use.
|
* @param fileID
|
* @param command
|
* @param p1 P1 value of the APDU command.
|
* @param p2 P2 value of the APDU command.
|
* @param p3 P3 value of the APDU command.
|
* @param filePath
|
* @return The APDU response.
|
*/
|
byte[] iccExchangeSimIO(int subId, int fileID, int command, int p1, int p2, int p3,
|
String filePath);
|
|
/**
|
* Send ENVELOPE to the SIM and returns the response.
|
*
|
* @param subId The subscription to use.
|
* @param contents String containing SAT/USAT response in hexadecimal
|
* format starting with command tag. See TS 102 223 for
|
* details.
|
* @return The APDU response from the ICC card, with the last 4 bytes
|
* being the status word. If the command fails, returns an empty
|
* string.
|
*/
|
String sendEnvelopeWithStatus(int subId, String content);
|
|
/**
|
* Read one of the NV items defined in {@link RadioNVItems} / {@code ril_nv_items.h}.
|
* Used for device configuration by some CDMA operators.
|
*
|
* @param itemID the ID of the item to read.
|
* @return the NV item as a String, or null on any failure.
|
*/
|
String nvReadItem(int itemID);
|
|
/**
|
* Write one of the NV items defined in {@link RadioNVItems} / {@code ril_nv_items.h}.
|
* Used for device configuration by some CDMA operators.
|
*
|
* @param itemID the ID of the item to read.
|
* @param itemValue the value to write, as a String.
|
* @return true on success; false on any failure.
|
*/
|
boolean nvWriteItem(int itemID, String itemValue);
|
|
/**
|
* Update the CDMA Preferred Roaming List (PRL) in the radio NV storage.
|
* Used for device configuration by some CDMA operators.
|
*
|
* @param preferredRoamingList byte array containing the new PRL.
|
* @return true on success; false on any failure.
|
*/
|
boolean nvWriteCdmaPrl(in byte[] preferredRoamingList);
|
|
/**
|
* Rollback modem configurations to factory default except some config which are in whitelist.
|
* Used for device configuration by some CDMA operators.
|
*
|
* <p>Requires Permission:
|
* {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE} or that the calling
|
* app has carrier privileges (see {@link #hasCarrierPrivileges}).
|
*
|
* @param slotIndex - device slot.
|
* @return {@code true} on success; {@code false} on any failure.
|
*/
|
boolean resetModemConfig(int slotIndex);
|
|
/**
|
* Generate a radio modem reset. Used for device configuration by some CDMA operators.
|
* Different than {@link #setRadioPower(boolean)}, modem reboot will power down sim card.
|
*
|
* <p>Requires Permission:
|
* {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE} or that the calling
|
* app has carrier privileges (see {@link #hasCarrierPrivileges}).
|
*
|
* @param slotIndex - device slot.
|
* @return {@code true} on success; {@code false} on any failure.
|
*/
|
boolean rebootModem(int slotIndex);
|
/*
|
* Get the calculated preferred network type.
|
* Used for device configuration by some CDMA operators.
|
* @param callingPackage The package making the call.
|
*
|
* @return the calculated preferred network type, defined in RILConstants.java.
|
*/
|
int getCalculatedPreferredNetworkType(String callingPackage);
|
|
/*
|
* Get the preferred network type.
|
* Used for device configuration by some CDMA operators.
|
*
|
* @param subId the id of the subscription to query.
|
* @return the preferred network type, defined in RILConstants.java.
|
*/
|
int getPreferredNetworkType(int subId);
|
|
/**
|
* Check whether DUN APN is required for tethering with subId.
|
*
|
* @param subId the id of the subscription to require tethering.
|
* @return {@code true} if DUN APN is required for tethering.
|
* @hide
|
*/
|
boolean getTetherApnRequiredForSubscriber(int subId);
|
|
/**
|
* Enables framework IMS and triggers IMS Registration.
|
*/
|
void enableIms(int slotId);
|
|
/**
|
* Disables framework IMS and triggers IMS deregistration.
|
*/
|
void disableIms(int slotId);
|
|
/**
|
* Get IImsMmTelFeature binder from ImsResolver that corresponds to the subId and MMTel feature
|
* as well as registering the MmTelFeature for callbacks using the IImsServiceFeatureCallback
|
* interface.
|
*/
|
IImsMmTelFeature getMmTelFeatureAndListen(int slotId, in IImsServiceFeatureCallback callback);
|
|
/**
|
* Get IImsRcsFeature binder from ImsResolver that corresponds to the subId and RCS feature
|
* as well as registering the RcsFeature for callbacks using the IImsServiceFeatureCallback
|
* interface.
|
*/
|
IImsRcsFeature getRcsFeatureAndListen(int slotId, in IImsServiceFeatureCallback callback);
|
|
/**
|
* Returns the IImsRegistration associated with the slot and feature specified.
|
*/
|
IImsRegistration getImsRegistration(int slotId, int feature);
|
|
/**
|
* Returns the IImsConfig associated with the slot and feature specified.
|
*/
|
IImsConfig getImsConfig(int slotId, int feature);
|
|
/**
|
* @return true if the ImsService to bind to for the slot id specified was set, false otherwise.
|
*/
|
boolean setImsService(int slotId, boolean isCarrierImsService, String packageName);
|
|
/**
|
* @return the package name of the carrier/device ImsService associated with this slot.
|
*/
|
String getImsService(int slotId, boolean isCarrierImsService);
|
|
/**
|
* Set the network selection mode to automatic.
|
*
|
* @param subId the id of the subscription to update.
|
*/
|
void setNetworkSelectionModeAutomatic(int subId);
|
|
/**
|
* Perform a radio scan and return the list of avialble networks.
|
*
|
* @param subId the id of the subscription.
|
* @return CellNetworkScanResult containing status of scan and networks.
|
*/
|
CellNetworkScanResult getCellNetworkScanResults(int subId, String callingPackage);
|
|
/**
|
* Perform a radio network scan and return the id of this scan.
|
*
|
* @param subId the id of the subscription.
|
* @param request Defines all the configs for network scan.
|
* @param messenger Callback messages will be sent using this messenger.
|
* @param binder the binder object instantiated in TelephonyManager.
|
* @param callingPackage the calling package
|
* @return An id for this scan.
|
*/
|
int requestNetworkScan(int subId, in NetworkScanRequest request, in Messenger messenger,
|
in IBinder binder, in String callingPackage);
|
|
/**
|
* Stop an existing radio network scan.
|
*
|
* @param subId the id of the subscription.
|
* @param scanId The id of the scan that is going to be stopped.
|
*/
|
void stopNetworkScan(int subId, int scanId);
|
|
/**
|
* Ask the radio to connect to the input network and change selection mode to manual.
|
*
|
* @param subId the id of the subscription.
|
* @param operatorInfo the operator inforamtion, included the PLMN, long name and short name of
|
* the operator to attach to.
|
* @param persistSelection whether the selection will persist until reboot. If true, only allows
|
* attaching to the selected PLMN until reboot; otherwise, attach to the chosen PLMN and resume
|
* normal network selection next time.
|
* @return {@code true} on success; {@code true} on any failure.
|
*/
|
boolean setNetworkSelectionModeManual(
|
int subId, in OperatorInfo operatorInfo, boolean persisSelection);
|
|
/**
|
* Set the preferred network type.
|
* Used for device configuration by some CDMA operators.
|
*
|
* @param subId the id of the subscription to update.
|
* @param networkType the preferred network type, defined in RILConstants.java.
|
* @return true on success; false on any failure.
|
*/
|
boolean setPreferredNetworkType(int subId, int networkType);
|
|
/**
|
* User enable/disable Mobile Data.
|
*
|
* @param enable true to turn on, else false
|
*/
|
void setUserDataEnabled(int subId, boolean enable);
|
|
/**
|
* Get the user enabled state of Mobile Data.
|
*
|
* TODO: remove and use isUserDataEnabled.
|
* This can't be removed now because some vendor codes
|
* calls through ITelephony directly while they should
|
* use TelephonyManager.
|
*
|
* @return true on enabled
|
*/
|
@UnsupportedAppUsage
|
boolean getDataEnabled(int subId);
|
|
/**
|
* Get the user enabled state of Mobile Data.
|
*
|
* @return true on enabled
|
*/
|
boolean isUserDataEnabled(int subId);
|
|
/**
|
* Get the overall enabled state of Mobile Data.
|
*
|
* @return true on enabled
|
*/
|
boolean isDataEnabled(int subId);
|
|
/**
|
* Checks if manual network selection is allowed.
|
*
|
* @return {@code true} if manual network selection is allowed, otherwise return {@code false}.
|
*/
|
boolean isManualNetworkSelectionAllowed(int subId);
|
|
/**
|
* Get P-CSCF address from PCO after data connection is established or modified.
|
* @param apnType the apnType, "ims" for IMS APN, "emergency" for EMERGENCY APN
|
* @param callingPackage The package making the call.
|
*/
|
String[] getPcscfAddress(String apnType, String callingPackage);
|
|
/**
|
* Set IMS registration state
|
*/
|
void setImsRegistrationState(boolean registered);
|
|
/**
|
* Return MDN string for CDMA phone.
|
* @param subId user preferred subId.
|
*/
|
String getCdmaMdn(int subId);
|
|
/**
|
* Return MIN string for CDMA phone.
|
* @param subId user preferred subId.
|
*/
|
String getCdmaMin(int subId);
|
|
/**
|
* Request that the next incoming call from a number matching {@code range} be intercepted.
|
* @param range The range of phone numbers the caller expects a phone call from.
|
* @param timeoutMillis The amount of time to wait for such a call, or
|
* {@link #MAX_NUMBER_VERIFICATION_TIMEOUT_MILLIS}, whichever is lesser.
|
* @param callback the callback aidl
|
* @param callingPackage the calling package name.
|
*/
|
void requestNumberVerification(in PhoneNumberRange range, long timeoutMillis,
|
in INumberVerificationCallback callback, String callingPackage);
|
|
/**
|
* Has the calling application been granted special privileges by the carrier.
|
*
|
* If any of the packages in the calling UID has carrier privileges, the
|
* call will return true. This access is granted by the owner of the UICC
|
* card and does not depend on the registered carrier.
|
*
|
* TODO: Add a link to documentation.
|
*
|
* @param subId The subscription to use.
|
* @return carrier privilege status defined in TelephonyManager.
|
*/
|
int getCarrierPrivilegeStatus(int subId);
|
|
/**
|
* Similar to above, but check for the given uid.
|
*/
|
int getCarrierPrivilegeStatusForUid(int subId, int uid);
|
|
/**
|
* Similar to above, but check for the package whose name is pkgName.
|
*/
|
int checkCarrierPrivilegesForPackage(int subId, String pkgName);
|
|
/**
|
* Similar to above, but check across all phones.
|
*/
|
int checkCarrierPrivilegesForPackageAnyPhone(String pkgName);
|
|
/**
|
* Returns list of the package names of the carrier apps that should handle the input intent
|
* and have carrier privileges for the given phoneId.
|
*
|
* @param intent Intent that will be sent.
|
* @param phoneId The phoneId on which the carrier app has carrier privileges.
|
* @return list of carrier app package names that can handle the intent on phoneId.
|
* Returns null if there is an error and an empty list if there
|
* are no matching packages.
|
*/
|
List<String> getCarrierPackageNamesForIntentAndPhone(in Intent intent, int phoneId);
|
|
/**
|
* Set the line 1 phone number string and its alphatag for the current ICCID
|
* for display purpose only, for example, displayed in Phone Status. It won't
|
* change the actual MSISDN/MDN. To unset alphatag or number, pass in a null
|
* value.
|
*
|
* @param subId the subscriber that the alphatag and dialing number belongs to.
|
* @param alphaTag alpha-tagging of the dailing nubmer
|
* @param number The dialing number
|
* @return true if the operation was executed correctly.
|
*/
|
boolean setLine1NumberForDisplayForSubscriber(int subId, String alphaTag, String number);
|
|
/**
|
* Returns the displayed dialing number string if it was set previously via
|
* {@link #setLine1NumberForDisplay}. Otherwise returns null.
|
*
|
* @param subId whose dialing number for line 1 is returned.
|
* @param callingPackage The package making the call.
|
* @return the displayed dialing number if set, or null if not set.
|
*/
|
String getLine1NumberForDisplay(int subId, String callingPackage);
|
|
/**
|
* Returns the displayed alphatag of the dialing number if it was set
|
* previously via {@link #setLine1NumberForDisplay}. Otherwise returns null.
|
*
|
* @param subId whose alphatag associated with line 1 is returned.
|
* @param callingPackage The package making the call.
|
* @return the displayed alphatag of the dialing number if set, or null if
|
* not set.
|
*/
|
String getLine1AlphaTagForDisplay(int subId, String callingPackage);
|
|
/**
|
* Return the set of subscriber IDs that should be considered "merged together" for data usage
|
* purposes. This is commonly {@code null} to indicate no merging is required. Any returned
|
* subscribers are sorted in a deterministic order.
|
* <p>
|
* The returned set of subscriber IDs will include the subscriber ID corresponding to this
|
* TelephonyManager's subId.
|
*
|
* @hide
|
*/
|
String[] getMergedSubscriberIds(int subId, String callingPackage);
|
|
/**
|
* Override the operator branding for the current ICCID.
|
*
|
* Once set, whenever the SIM is present in the device, the service
|
* provider name (SPN) and the operator name will both be replaced by the
|
* brand value input. To unset the value, the same function should be
|
* called with a null brand value.
|
*
|
* <p>Requires Permission:
|
* {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
|
* or has to be carrier app - see #hasCarrierPrivileges.
|
*
|
* @param subId The subscription to use.
|
* @param brand The brand name to display/set.
|
* @return true if the operation was executed correctly.
|
*/
|
boolean setOperatorBrandOverride(int subId, String brand);
|
|
/**
|
* Override the roaming indicator for the current ICCID.
|
*
|
* Using this call, the carrier app (see #hasCarrierPrivileges) can override
|
* the platform's notion of a network operator being considered roaming or not.
|
* The change only affects the ICCID that was active when this call was made.
|
*
|
* If null is passed as any of the input, the corresponding value is deleted.
|
*
|
* <p>Requires that the caller have carrier privilege. See #hasCarrierPrivileges.
|
*
|
* @param subId for which the roaming overrides apply.
|
* @param gsmRoamingList - List of MCCMNCs to be considered roaming for 3GPP RATs.
|
* @param gsmNonRoamingList - List of MCCMNCs to be considered not roaming for 3GPP RATs.
|
* @param cdmaRoamingList - List of SIDs to be considered roaming for 3GPP2 RATs.
|
* @param cdmaNonRoamingList - List of SIDs to be considered not roaming for 3GPP2 RATs.
|
* @return true if the operation was executed correctly.
|
*/
|
boolean setRoamingOverride(int subId, in List<String> gsmRoamingList,
|
in List<String> gsmNonRoamingList, in List<String> cdmaRoamingList,
|
in List<String> cdmaNonRoamingList);
|
|
/**
|
* Returns the result and response from RIL for oem request
|
*
|
* @param oemReq the data is sent to ril.
|
* @param oemResp the respose data from RIL.
|
* @return negative value request was not handled or get error
|
* 0 request was handled succesfully, but no response data
|
* positive value success, data length of response
|
*/
|
int invokeOemRilRequestRaw(in byte[] oemReq, out byte[] oemResp);
|
|
/**
|
* Check if any mobile Radios need to be shutdown.
|
*
|
* @return true is any mobile radio needs to be shutdown
|
*/
|
boolean needMobileRadioShutdown();
|
|
/**
|
* Shutdown Mobile Radios
|
*/
|
void shutdownMobileRadios();
|
|
/**
|
* Set phone radio type and access technology.
|
*
|
* @param rafs an RadioAccessFamily array to indicate all phone's
|
* new radio access family. The length of RadioAccessFamily
|
* must equ]]al to phone count.
|
*/
|
void setRadioCapability(in RadioAccessFamily[] rafs);
|
|
/**
|
* Get phone radio type and access technology.
|
*
|
* @param phoneId which phone you want to get
|
* @param callingPackage the name of the package making the call
|
* @return phone radio type and access technology
|
*/
|
int getRadioAccessFamily(in int phoneId, String callingPackage);
|
|
/**
|
* Enables or disables video calling.
|
*
|
* @param enable Whether to enable video calling.
|
*/
|
void enableVideoCalling(boolean enable);
|
|
/**
|
* Whether video calling has been enabled by the user.
|
*
|
* @param callingPackage The package making the call.
|
* @return {@code true} if the user has enabled video calling, {@code false} otherwise.
|
*/
|
boolean isVideoCallingEnabled(String callingPackage);
|
|
/**
|
* Whether the DTMF tone length can be changed.
|
*
|
* @param subId The subscription to use.
|
* @param callingPackage The package making the call.
|
* @return {@code true} if the DTMF tone length can be changed.
|
*/
|
boolean canChangeDtmfToneLength(int subId, String callingPackage);
|
|
/**
|
* Whether the device is a world phone.
|
*
|
* @param callingPackage The package making the call.
|
* @return {@code true} if the devices is a world phone.
|
*/
|
boolean isWorldPhone(int subId, String callingPackage);
|
|
/**
|
* Whether the phone supports TTY mode.
|
*
|
* @return {@code true} if the device supports TTY mode.
|
*/
|
boolean isTtyModeSupported();
|
|
boolean isRttSupported(int subscriptionId);
|
|
/**
|
* Whether the phone supports hearing aid compatibility.
|
*
|
* @return {@code true} if the device supports hearing aid compatibility.
|
*/
|
boolean isHearingAidCompatibilitySupported();
|
|
/**
|
* Get IMS Registration Status on a particular subid.
|
*
|
* @param subId user preferred subId.
|
*
|
* @return {@code true} if the IMS status is registered.
|
*/
|
boolean isImsRegistered(int subId);
|
|
/**
|
* Returns the Status of Wi-Fi Calling for the subscription id specified.
|
*/
|
boolean isWifiCallingAvailable(int subId);
|
|
/**
|
* Returns the Status of VT (video telephony) for the subscription ID specified.
|
*/
|
boolean isVideoTelephonyAvailable(int subId);
|
|
/**
|
* Returns the MMTEL IMS registration technology for the subsciption ID specified.
|
*/
|
int getImsRegTechnologyForMmTel(int subId);
|
|
/**
|
* Returns the unique device ID of phone, for example, the IMEI for
|
* GSM and the MEID for CDMA phones. Return null if device ID is not available.
|
*
|
* @param callingPackage The package making the call.
|
* <p>Requires Permission:
|
* {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
|
*/
|
String getDeviceId(String callingPackage);
|
|
/**
|
* Returns the IMEI for the given slot.
|
*
|
* @param slotIndex - device slot.
|
* @param callingPackage The package making the call.
|
* <p>Requires Permission:
|
* {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
|
*/
|
String getImeiForSlot(int slotIndex, String callingPackage);
|
|
/**
|
* Returns the Type Allocation Code from the IMEI for the given slot.
|
*
|
* @param slotIndex - Which slot to retrieve the Type Allocation Code from.
|
*/
|
String getTypeAllocationCodeForSlot(int slotIndex);
|
|
/**
|
* Returns the MEID for the given slot.
|
*
|
* @param slotIndex - device slot.
|
* @param callingPackage The package making the call.
|
* <p>Requires Permission:
|
* {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
|
*/
|
String getMeidForSlot(int slotIndex, String callingPackage);
|
|
/**
|
* Returns the Manufacturer Code from the MEID for the given slot.
|
*
|
* @param slotIndex - Which slot to retrieve the Manufacturer Code from.
|
*/
|
String getManufacturerCodeForSlot(int slotIndex);
|
|
/**
|
* Returns the device software version.
|
*
|
* @param slotIndex - device slot.
|
* @param callingPackage The package making the call.
|
* <p>Requires Permission:
|
* {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
|
*/
|
String getDeviceSoftwareVersionForSlot(int slotIndex, String callingPackage);
|
|
/**
|
* Returns the subscription ID associated with the specified PhoneAccount.
|
*/
|
int getSubIdForPhoneAccount(in PhoneAccount phoneAccount);
|
|
/**
|
* Returns the PhoneAccountHandle associated with a subscription ID.
|
*/
|
PhoneAccountHandle getPhoneAccountHandleForSubscriptionId(int subscriptionId);
|
|
void factoryReset(int subId);
|
|
/**
|
* Returns users's current locale based on the SIM.
|
*
|
* The returned string will be a well formed BCP-47 language tag, or {@code null}
|
* if no locale could be derived.
|
*/
|
String getSimLocaleForSubscriber(int subId);
|
|
/**
|
* Requests the modem activity info asynchronously.
|
* The implementor is expected to reply with the
|
* {@link android.telephony.ModemActivityInfo} object placed into the Bundle with the key
|
* {@link android.telephony.TelephonyManager#MODEM_ACTIVITY_RESULT_KEY}.
|
* The result code is ignored.
|
*/
|
oneway void requestModemActivityInfo(in ResultReceiver result);
|
|
/**
|
* Get the service state on specified subscription
|
* @param subId Subscription id
|
* @param callingPackage The package making the call
|
* @return Service state on specified subscription.
|
*/
|
ServiceState getServiceStateForSubscriber(int subId, String callingPackage);
|
|
/**
|
* Returns the URI for the per-account voicemail ringtone set in Phone settings.
|
*
|
* @param accountHandle The handle for the {@link PhoneAccount} for which to retrieve the
|
* voicemail ringtone.
|
* @return The URI for the ringtone to play when receiving a voicemail from a specific
|
* PhoneAccount.
|
*/
|
Uri getVoicemailRingtoneUri(in PhoneAccountHandle accountHandle);
|
|
/**
|
* Sets the per-account voicemail ringtone.
|
*
|
* <p>Requires that the calling app is the default dialer, or has carrier privileges, or
|
* has permission {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}.
|
*
|
* @param phoneAccountHandle The handle for the {@link PhoneAccount} for which to set the
|
* voicemail ringtone.
|
* @param uri The URI for the ringtone to play when receiving a voicemail from a specific
|
* PhoneAccount.
|
*/
|
void setVoicemailRingtoneUri(String callingPackage,
|
in PhoneAccountHandle phoneAccountHandle, in Uri uri);
|
|
/**
|
* Returns whether vibration is set for voicemail notification in Phone settings.
|
*
|
* @param accountHandle The handle for the {@link PhoneAccount} for which to retrieve the
|
* voicemail vibration setting.
|
* @return {@code true} if the vibration is set for this PhoneAccount, {@code false} otherwise.
|
*/
|
boolean isVoicemailVibrationEnabled(in PhoneAccountHandle accountHandle);
|
|
/**
|
* Sets the per-account preference whether vibration is enabled for voicemail notifications.
|
*
|
* <p>Requires that the calling app is the default dialer, or has carrier privileges, or
|
* has permission {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}.
|
*
|
* @param phoneAccountHandle The handle for the {@link PhoneAccount} for which to set the
|
* voicemail vibration setting.
|
* @param enabled Whether to enable or disable vibration for voicemail notifications from a
|
* specific PhoneAccount.
|
*/
|
void setVoicemailVibrationEnabled(String callingPackage,
|
in PhoneAccountHandle phoneAccountHandle, boolean enabled);
|
|
/**
|
* Returns a list of packages that have carrier privileges for the specific phone.
|
*/
|
List<String> getPackagesWithCarrierPrivileges(int phoneId);
|
|
/**
|
* Returns a list of packages that have carrier privileges.
|
*/
|
List<String> getPackagesWithCarrierPrivilegesForAllPhones();
|
|
/**
|
* Return the application ID for the app type.
|
*
|
* @param subId the subscription ID that this request applies to.
|
* @param appType the uicc app type,
|
* @return Application ID for specificied app type or null if no uicc or error.
|
*/
|
String getAidForAppType(int subId, int appType);
|
|
/**
|
* Return the Electronic Serial Number.
|
*
|
* Requires that the calling app has READ_PRIVILEGED_PHONE_STATE permission
|
*
|
* @param subId the subscription ID that this request applies to.
|
* @return ESN or null if error.
|
* @hide
|
*/
|
String getEsn(int subId);
|
|
/**
|
* Return the Preferred Roaming List Version
|
*
|
* Requires that the calling app has READ_PRIVILEGED_PHONE_STATE permission
|
* @param subId the subscription ID that this request applies to.
|
* @return PRLVersion or null if error.
|
* @hide
|
*/
|
String getCdmaPrlVersion(int subId);
|
|
/**
|
* Get snapshot of Telephony histograms
|
* @return List of Telephony histograms
|
* Requires Permission:
|
* {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
|
* Or the calling app has carrier privileges.
|
*/
|
List<TelephonyHistogram> getTelephonyHistograms();
|
|
/**
|
* Set the allowed carrier list and the excluded carrier list, indicating the priority between
|
* the two lists.
|
*
|
* <p>Requires system privileges. In the future we may add this to carrier APIs.
|
*
|
* @return {@link #SET_CARRIER_RESTRICTION_SUCCESS} in case of success.
|
* {@link #SET_CARRIER_RESTRICTION_NOT_SUPPORTED} if the modem does not support the
|
* configuration. {@link #SET_CARRIER_RESTRICTION_ERROR} in all other error cases.
|
*/
|
int setAllowedCarriers(in CarrierRestrictionRules carrierRestrictionRules);
|
|
/**
|
* Get the allowed carrier list and the excluded carrier list indicating the priority between
|
* the two lists.
|
*
|
* <p>Requires system privileges. In the future we may add this to carrier APIs.
|
*
|
* @return {@link CarrierRestrictionRules}; empty lists mean all carriers are allowed. It
|
* returns null in case of error.
|
*/
|
CarrierRestrictionRules getAllowedCarriers();
|
|
/**
|
* Returns carrier id of the given subscription.
|
* <p>To recognize carrier as a first class identity, assign each carrier with a canonical
|
* integer a.k.a carrier id.
|
*
|
* @param subId The subscription id
|
* @return Carrier id of given subscription id. return {@link #UNKNOWN_CARRIER_ID} if
|
* subscription is unavailable or carrier cannot be identified.
|
* @throws IllegalStateException if telephony service is unavailable.
|
* @hide
|
*/
|
int getSubscriptionCarrierId(int subId);
|
|
/**
|
* Returns carrier name of the given subscription.
|
* <p>Carrier name is a user-facing name of carrier id {@link #getSimCarrierId(int)},
|
* usually the brand name of the subsidiary (e.g. T-Mobile). Each carrier could configure
|
* multiple {@link #getSimOperatorName() SPN} but should have a single carrier name.
|
* Carrier name is not canonical identity, use {@link #getSimCarrierId(int)} instead.
|
* <p>Returned carrier name is unlocalized.
|
*
|
* @return Carrier name of given subscription id. return {@code null} if subscription is
|
* unavailable or carrier cannot be identified.
|
* @throws IllegalStateException if telephony service is unavailable.
|
* @hide
|
*/
|
String getSubscriptionCarrierName(int subId);
|
|
/**
|
* Returns fine-grained carrier id of the current subscription.
|
*
|
* <p>The specific carrier id can be used to further differentiate a carrier by different
|
* networks, by prepaid v.s.postpaid or even by 4G v.s.3G plan. Each carrier has a unique
|
* carrier id {@link #getSimCarrierId()} but can have multiple precise carrier id. e.g,
|
* {@link #getSimCarrierId()} will always return Tracfone (id 2022) for a Tracfone SIM, while
|
* {@link #getSimPreciseCarrierId()} can return Tracfone AT&T or Tracfone T-Mobile based on the
|
* current underlying network.
|
*
|
* <p>For carriers without any fine-grained carrier ids, return {@link #getSimCarrierId()}
|
*
|
* @return Returns fine-grained carrier id of the current subscription.
|
* Return {@link #UNKNOWN_CARRIER_ID} if the subscription is unavailable or the carrier cannot
|
* be identified.
|
* @hide
|
*/
|
int getSubscriptionSpecificCarrierId(int subId);
|
|
/**
|
* Similar like {@link #getSimCarrierIdName()}, returns user-facing name of the
|
* specific carrier id {@link #getSimSpecificCarrierId()}
|
*
|
* <p>The returned name is unlocalized.
|
*
|
* @return user-facing name of the subscription specific carrier id. Return {@code null} if the
|
* subscription is unavailable or the carrier cannot be identified.
|
* @hide
|
*/
|
String getSubscriptionSpecificCarrierName(int subId);
|
|
/**
|
* Returns carrier id based on MCCMNC only. This will return a MNO carrier id used for fallback
|
* check when exact carrier id {@link #getSimCarrierId()} configurations are not found
|
*
|
* @param isSubscriptionMccMnc. If {@true} it means this is a query for subscription mccmnc
|
* {@false} otherwise.
|
*
|
* @return carrier id from passing mccmnc.
|
* @hide
|
*/
|
int getCarrierIdFromMccMnc(int slotIndex, String mccmnc, boolean isSubscriptionMccMnc);
|
|
/**
|
* Action set from carrier signalling broadcast receivers to enable/disable metered apns
|
* Permissions android.Manifest.permission.MODIFY_PHONE_STATE is required
|
* @param subId the subscription ID that this action applies to.
|
* @param enabled control enable or disable metered apns.
|
* @hide
|
*/
|
void carrierActionSetMeteredApnsEnabled(int subId, boolean visible);
|
|
/**
|
* Action set from carrier signalling broadcast receivers to enable/disable radio
|
* Permissions android.Manifest.permission.MODIFY_PHONE_STATE is required
|
* @param subId the subscription ID that this action applies to.
|
* @param enabled control enable or disable radio.
|
* @hide
|
*/
|
void carrierActionSetRadioEnabled(int subId, boolean enabled);
|
|
/**
|
* Action set from carrier signalling broadcast receivers to start/stop reporting default
|
* network conditions.
|
* Permissions android.Manifest.permission.MODIFY_PHONE_STATE is required
|
* @param subId the subscription ID that this action applies to.
|
* @param report control start/stop reporting default network events.
|
* @hide
|
*/
|
void carrierActionReportDefaultNetworkStatus(int subId, boolean report);
|
|
/**
|
* Action set from carrier signalling broadcast receivers to reset all carrier actions.
|
* Permissions android.Manifest.permission.MODIFY_PHONE_STATE is required
|
* @param subId the subscription ID that this action applies to.
|
* @hide
|
*/
|
void carrierActionResetAll(int subId);
|
|
/**
|
* Get aggregated video call data usage since boot.
|
* Permissions android.Manifest.permission.READ_NETWORK_USAGE_HISTORY is required.
|
*
|
* @param perUidStats True if requesting data usage per uid, otherwise overall usage.
|
* @return Snapshot of video call data usage
|
* @hide
|
*/
|
NetworkStats getVtDataUsage(int subId, boolean perUidStats);
|
|
/**
|
* Policy control of data connection. Usually used when data limit is passed.
|
* @param enabled True if enabling the data, otherwise disabling.
|
* @param subId Subscription index
|
* @hide
|
*/
|
void setPolicyDataEnabled(boolean enabled, int subId);
|
|
/**
|
* Get Client request stats which will contain statistical information
|
* on each request made by client.
|
* @param callingPackage package making the call.
|
* @param subId Subscription index
|
* @hide
|
*/
|
List<ClientRequestStats> getClientRequestStats(String callingPackage, int subid);
|
|
/**
|
* Set SIM card power state.
|
* @param slotIndex SIM slot id
|
* @param state State of SIM (power down, power up, pass through)
|
* @hide
|
* */
|
void setSimPowerStateForSlot(int slotIndex, int state);
|
|
/**
|
* Returns a list of Forbidden PLMNs from the specified SIM App
|
* Returns null if the query fails.
|
*
|
* <p>Requires that the calling app has READ_PRIVILEGED_PHONE_STATE or READ_PHONE_STATE
|
*
|
* @param subId subscription ID used for authentication
|
* @param appType the icc application type, like {@link #APPTYPE_USIM}
|
*/
|
String[] getForbiddenPlmns(int subId, int appType, String callingPackage);
|
|
/**
|
* Check if phone is in emergency callback mode
|
* @return true if phone is in emergency callback mode
|
* @param subId the subscription ID that this action applies to.
|
* @hide
|
*/
|
boolean getEmergencyCallbackMode(int subId);
|
|
/**
|
* Get the most recently available signal strength information.
|
*
|
* Get the most recent SignalStrength information reported by the modem. Due
|
* to power saving this information may not always be current.
|
* @param subId Subscription index
|
* @return the most recent cached signal strength info from the modem
|
* @hide
|
*/
|
SignalStrength getSignalStrength(int subId);
|
|
/**
|
* Get the card ID of the default eUICC card. If there is no eUICC, returns
|
* {@link #INVALID_CARD_ID}.
|
*
|
* @param subId subscription ID used for authentication
|
* @param callingPackage package making the call
|
* @return card ID of the default eUICC card.
|
*/
|
int getCardIdForDefaultEuicc(int subId, String callingPackage);
|
|
/**
|
* Gets information about currently inserted UICCs and eUICCs.
|
* <p>
|
* Requires that the calling app has carrier privileges (see {@link #hasCarrierPrivileges}).
|
* <p>
|
* If the caller has carrier priviliges on any active subscription, then they have permission to
|
* get simple information like the card ID ({@link UiccCardInfo#getCardId()}), whether the card
|
* is an eUICC ({@link UiccCardInfo#isEuicc()}), and the slot index where the card is inserted
|
* ({@link UiccCardInfo#getSlotIndex()}).
|
* <p>
|
* To get private information such as the EID ({@link UiccCardInfo#getEid()}) or ICCID
|
* ({@link UiccCardInfo#getIccId()}), the caller must have carrier priviliges on that specific
|
* UICC or eUICC card.
|
* <p>
|
* See {@link UiccCardInfo} for more details on the kind of information available.
|
*
|
* @param callingPackage package making the call, used to evaluate carrier privileges
|
* @return a list of UiccCardInfo objects, representing information on the currently inserted
|
* UICCs and eUICCs. Each UiccCardInfo in the list will have private information filtered out if
|
* the caller does not have adequate permissions for that card.
|
*/
|
List<UiccCardInfo> getUiccCardsInfo(String callingPackage);
|
|
/**
|
* Get slot info for all the UICC slots.
|
* @return UiccSlotInfo array.
|
* @hide
|
*/
|
UiccSlotInfo[] getUiccSlotsInfo();
|
|
/**
|
* Map logicalSlot to physicalSlot, and activate the physicalSlot if it is inactive.
|
* @param physicalSlots Index i in the array representing physical slot for phone i. The array
|
* size should be same as getPhoneCount().
|
* @return boolean Return true if the switch succeeds, false if the switch fails.
|
*/
|
boolean switchSlots(in int[] physicalSlots);
|
|
/**
|
* Sets radio indication update mode. This can be used to control the behavior of indication
|
* update from modem to Android frameworks. For example, by default several indication updates
|
* are turned off when screen is off, but in some special cases (e.g. carkit is connected but
|
* screen is off) we want to turn on those indications even when the screen is off.
|
*/
|
void setRadioIndicationUpdateMode(int subId, int filters, int mode);
|
|
/**
|
* Returns whether mobile data roaming is enabled on the subscription with id {@code subId}.
|
*
|
* @param subId the subscription id
|
* @return {@code true} if the data roaming is enabled on this subscription.
|
*/
|
boolean isDataRoamingEnabled(int subId);
|
|
/**
|
* Enables/Disables the data roaming on the subscription with id {@code subId}.
|
*
|
* @param subId the subscription id
|
* @param isEnabled {@code true} to enable mobile data roaming, otherwise disable it.
|
*/
|
void setDataRoamingEnabled(int subId, boolean isEnabled);
|
|
/**
|
* Gets the roaming mode for the CDMA phone with the subscription id {@code subId}.
|
*
|
* @param the subscription id.
|
* @return the roaming mode for CDMA phone.
|
*/
|
int getCdmaRoamingMode(int subId);
|
|
/**
|
* Sets the roaming mode on the CDMA phone with the subscription {@code subId} to the given
|
* roaming mode {@code mode}.
|
*
|
* @param subId the subscription id.
|
* @param mode the roaming mode should be set.
|
* @return {@code true} if successed.
|
*/
|
boolean setCdmaRoamingMode(int subId, int mode);
|
|
/**
|
* Sets the subscription mode for CDMA phone with the subscription {@code subId} to the given
|
* subscription mode {@code mode}.
|
*
|
* @param subId the subscription id.
|
* @param mode the subscription mode should be set.
|
* @return {@code true} if successed.
|
*/
|
boolean setCdmaSubscriptionMode(int subId, int mode);
|
|
/**
|
* A test API to override carrier information including mccmnc, imsi, iccid, gid1, gid2,
|
* plmn and spn. This would be handy for, eg, forcing a particular carrier id, carrier's config
|
* (also any country or carrier overlays) to be loaded when using a test SIM with a call box.
|
*/
|
void setCarrierTestOverride(int subId, String mccmnc, String imsi, String iccid, String gid1,
|
String gid2, String plmn, String spn, String carrierPrivilegeRules, String apn);
|
|
/**
|
* A test API to return installed carrier id list version.
|
*/
|
int getCarrierIdListVersion(int subId);
|
|
/**
|
* A test API to reload the UICC profile.
|
* @hide
|
*/
|
void refreshUiccProfile(int subId);
|
|
/**
|
* How many modems can have simultaneous data connections.
|
* @hide
|
*/
|
int getNumberOfModemsWithSimultaneousDataConnections(int subId, String callingPackage);
|
|
/**
|
* Return the network selection mode on the subscription with id {@code subId}.
|
*/
|
int getNetworkSelectionMode(int subId);
|
|
/**
|
* Return true if the device is in emergency sms mode, false otherwise.
|
*/
|
boolean isInEmergencySmsMode();
|
|
/**
|
* Get a list of SMS apps on a user.
|
*/
|
String[] getSmsApps(int userId);
|
|
/**
|
* Get the default SMS app on a given user.
|
*/
|
String getDefaultSmsApp(int userId);
|
|
/**
|
* Set the default SMS app to a given package on a given user.
|
*/
|
void setDefaultSmsApp(int userId, String packageName);
|
|
/**
|
* Return the modem radio power state for slot index.
|
*
|
*/
|
int getRadioPowerState(int slotIndex, String callingPackage);
|
|
// IMS specific AIDL commands, see ImsMmTelManager.java
|
|
/**
|
* Adds an IMS registration status callback for the subscription id specified.
|
*/
|
void registerImsRegistrationCallback(int subId, IImsRegistrationCallback c);
|
/**
|
* Removes an existing IMS registration status callback for the subscription specified.
|
*/
|
void unregisterImsRegistrationCallback(int subId, IImsRegistrationCallback c);
|
|
/**
|
* Adds an IMS MmTel capabilities callback for the subscription specified.
|
*/
|
void registerMmTelCapabilityCallback(int subId, IImsCapabilityCallback c);
|
|
/**
|
* Removes an existing IMS MmTel capabilities callback for the subscription specified.
|
*/
|
void unregisterMmTelCapabilityCallback(int subId, IImsCapabilityCallback c);
|
|
/**
|
* return true if the IMS MmTel capability for the given registration tech is capable.
|
*/
|
boolean isCapable(int subId, int capability, int regTech);
|
|
/**
|
* return true if the IMS MmTel capability for the given registration tech is available.
|
*/
|
boolean isAvailable(int subId, int capability, int regTech);
|
|
/**
|
* Returns true if the user's setting for 4G LTE is enabled, for the subscription specified.
|
*/
|
boolean isAdvancedCallingSettingEnabled(int subId);
|
|
/**
|
* Modify the user's setting for whether or not 4G LTE is enabled.
|
*/
|
void setAdvancedCallingSettingEnabled(int subId, boolean isEnabled);
|
|
/**
|
* return true if the user's setting for VT is enabled for the subscription.
|
*/
|
boolean isVtSettingEnabled(int subId);
|
|
/**
|
* Modify the user's setting for whether or not VT is available for the subscrption specified.
|
*/
|
void setVtSettingEnabled(int subId, boolean isEnabled);
|
|
/**
|
* return true if the user's setting for whether or not Voice over WiFi is currently enabled.
|
*/
|
boolean isVoWiFiSettingEnabled(int subId);
|
|
/**
|
* sets the user's setting for Voice over WiFi enabled state.
|
*/
|
void setVoWiFiSettingEnabled(int subId, boolean isEnabled);
|
|
/**
|
* return true if the user's setting for Voice over WiFi while roaming is enabled.
|
*/
|
boolean isVoWiFiRoamingSettingEnabled(int subId);
|
|
/**
|
* Sets the user's preference for whether or not Voice over WiFi is enabled for the current
|
* subscription while roaming.
|
*/
|
void setVoWiFiRoamingSettingEnabled(int subId, boolean isEnabled);
|
|
/**
|
* Set the Voice over WiFi enabled state, but do not persist the setting.
|
*/
|
void setVoWiFiNonPersistent(int subId, boolean isCapable, int mode);
|
|
/**
|
* return the Voice over WiFi mode preference set by the user for the subscription specified.
|
*/
|
int getVoWiFiModeSetting(int subId);
|
|
/**
|
* sets the user's preference for the Voice over WiFi mode for the subscription specified.
|
*/
|
void setVoWiFiModeSetting(int subId, int mode);
|
|
/**
|
* return the Voice over WiFi mode preference set by the user for the subscription specified
|
* while roaming.
|
*/
|
int getVoWiFiRoamingModeSetting(int subId);
|
|
/**
|
* sets the user's preference for the Voice over WiFi mode for the subscription specified
|
* while roaming.
|
*/
|
void setVoWiFiRoamingModeSetting(int subId, int mode);
|
|
/**
|
* Modify the user's setting for whether or not RTT is enabled for the subscrption specified.
|
*/
|
void setRttCapabilitySetting(int subId, boolean isEnabled);
|
|
/**
|
* return true if TTY over VoLTE is enabled for the subscription specified.
|
*/
|
boolean isTtyOverVolteEnabled(int subId);
|
|
/**
|
* Return the emergency number list from all the active subscriptions.
|
*/
|
Map getEmergencyNumberList(String callingPackage);
|
|
/**
|
* Identify if the number is emergency number, based on all the active subscriptions.
|
*/
|
boolean isEmergencyNumber(String number, boolean exactMatch);
|
|
/**
|
* Return a list of certs in hex string from loaded carrier privileges access rules.
|
*/
|
List<String> getCertsFromCarrierPrivilegeAccessRules(int subId);
|
|
/**
|
* Register an IMS provisioning change callback with Telephony.
|
*/
|
void registerImsProvisioningChangedCallback(int subId, IImsConfigCallback callback);
|
|
/**
|
* unregister an existing IMS provisioning change callback.
|
*/
|
void unregisterImsProvisioningChangedCallback(int subId, IImsConfigCallback callback);
|
|
/**
|
* Set the provisioning status for the IMS MmTel capability using the specified subscription.
|
*/
|
void setImsProvisioningStatusForCapability(int subId, int capability, int tech,
|
boolean isProvisioned);
|
|
/**
|
* Get the provisioning status for the IMS MmTel capability specified.
|
*/
|
boolean getImsProvisioningStatusForCapability(int subId, int capability, int tech);
|
|
/** Is the capability and tech flagged as provisioned in the cache */
|
boolean isMmTelCapabilityProvisionedInCache(int subId, int capability, int tech);
|
|
/** Set the provisioning for the capability and tech in the cache */
|
void cacheMmTelCapabilityProvisioning(int subId, int capability, int tech,
|
boolean isProvisioned);
|
|
/**
|
* Return an integer containing the provisioning value for the specified provisioning key.
|
*/
|
int getImsProvisioningInt(int subId, int key);
|
|
/**
|
* return a String containing the provisioning value for the provisioning key specified.
|
*/
|
String getImsProvisioningString(int subId, int key);
|
|
/**
|
* Set the integer provisioning value for the provisioning key specified.
|
*/
|
int setImsProvisioningInt(int subId, int key, int value);
|
|
/**
|
* Set the String provisioning value for the provisioning key specified.
|
*/
|
int setImsProvisioningString(int subId, int key, String value);
|
|
/**
|
* Update Emergency Number List for Test Mode.
|
*/
|
void updateEmergencyNumberListTestMode(int action, in EmergencyNumber num);
|
|
/**
|
* Get the full emergency number list for Test Mode.
|
*/
|
List<String> getEmergencyNumberListTestMode();
|
|
/**
|
* Enable or disable a logical modem stack associated with the slotIndex.
|
*/
|
boolean enableModemForSlot(int slotIndex, boolean enable);
|
|
/**
|
* Indicate if the enablement of multi SIM functionality is restricted.
|
* @hide
|
*/
|
void setMultiSimCarrierRestriction(boolean isMultiSimCarrierRestricted);
|
|
/**
|
* Returns if the usage of multiple SIM cards at the same time is supported.
|
*
|
* @param callingPackage The package making the call.
|
* @return {@link #MULTISIM_ALLOWED} if the device supports multiple SIMs.
|
* {@link #MULTISIM_NOT_SUPPORTED_BY_HARDWARE} if the device does not support multiple SIMs.
|
* {@link #MULTISIM_NOT_SUPPORTED_BY_CARRIER} in the device supports multiple SIMs, but the
|
* functionality is restricted by the carrier.
|
*/
|
int isMultiSimSupported(String callingPackage);
|
|
/**
|
* Switch configs to enable multi-sim or switch back to single-sim
|
* @hide
|
*/
|
void switchMultiSimConfig(int numOfSims);
|
|
/**
|
* Get if altering modems configurations will trigger reboot.
|
* @hide
|
*/
|
boolean doesSwitchMultiSimConfigTriggerReboot(int subId, String callingPackage);
|
|
/**
|
* Get the mapping from logical slots to physical slots.
|
*/
|
int[] getSlotsMapping();
|
|
/**
|
* Get the IRadio HAL Version encoded as 100 * MAJOR_VERSION + MINOR_VERSION or -1 if unknown
|
*/
|
int getRadioHalVersion();
|
|
boolean isModemEnabledForSlot(int slotIndex, String callingPackage);
|
|
boolean isDataEnabledForApn(int apnType, int subId, String callingPackage);
|
|
boolean isApnMetered(int apnType, int subId);
|
|
/**
|
* Enqueue a pending sms Consumer, which will answer with the user specified selection for an
|
* outgoing SmsManager operation.
|
*/
|
oneway void enqueueSmsPickResult(String callingPackage, IIntegerConsumer subIdResult);
|
|
/**
|
* Returns the MMS user agent.
|
*/
|
String getMmsUserAgent(int subId);
|
|
/**
|
* Returns the MMS user agent profile URL.
|
*/
|
String getMmsUAProfUrl(int subId);
|
|
/**
|
* Set allowing mobile data during voice call.
|
*/
|
boolean setDataAllowedDuringVoiceCall(int subId, boolean allow);
|
|
/**
|
* Check whether data is allowed during voice call. Note this is for dual sim device that
|
* data might be disabled on non-default data subscription but explicitly turned on by settings.
|
*/
|
boolean isDataAllowedInVoiceCall(int subId);
|
}
|
