| /* |
| * Copyright (C) 2006 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.uicc; |
| |
| import android.compat.annotation.UnsupportedAppUsage; |
| |
| import com.android.internal.telephony.util.TelephonyUtils; |
| |
| /** |
| * {@hide} |
| */ |
| public class |
| IccIoResult { |
| |
| private static final String UNKNOWN_ERROR = "unknown"; |
| |
| private String getErrorString() { |
| // Errors from 3gpp 11.11 9.4.1 |
| // Additional Errors from ETSI 102.221 |
| // |
| // All error codes below are copied directly from their respective specification |
| // without modification except in cases where necessary string formatting has been omitted. |
| switch(sw1) { |
| case 0x61: return sw2 + " more response bytes available"; |
| case 0x62: |
| switch(sw2) { |
| case 0x00: return "no information given," |
| + " state of non volatile memory unchanged"; |
| case 0x81: return "part of returned data may be corrupted"; |
| case 0x82: return "end of file/record reached before reading Le bytes"; |
| case 0x83: return "selected file invalidated"; |
| case 0x84: return "selected file in termination state"; |
| case 0xF1: return "more data available"; |
| case 0xF2: return "more data available and proactive command pending"; |
| case 0xF3: return "response data available"; |
| } |
| break; |
| case 0x63: |
| if (sw2 >> 4 == 0x0C) { |
| int retries = sw2 & 0x0F; |
| return "command successful but after using an internal update retry routine " |
| + retries + " times," |
| + " or verification failed, " + retries + " retries remaining"; |
| } |
| switch(sw2) { |
| case 0xF1: return "more data expected"; |
| case 0xF2: return "more data expected and proactive command pending"; |
| } |
| break; |
| case 0x64: |
| switch(sw2) { |
| case 0x00: return "no information given," |
| + " state of non-volatile memory unchanged"; |
| } |
| break; |
| case 0x65: |
| switch(sw2) { |
| case 0x00: return "no information given, state of non-volatile memory changed"; |
| case 0x81: return "memory problem"; |
| } |
| break; |
| case 0x67: |
| switch(sw2) { |
| case 0x00: return "incorrect parameter P3"; |
| default: return "the interpretation of this status word is command dependent"; |
| } |
| // break; |
| case 0x68: |
| switch(sw2) { |
| case 0x00: return "no information given"; |
| case 0x81: return "logical channel not supported"; |
| case 0x82: return "secure messaging not supported"; |
| } |
| break; |
| case 0x69: |
| switch(sw2) { |
| case 0x00: return "no information given"; |
| case 0x81: return "command incompatible with file structure"; |
| case 0x82: return "security status not satisfied"; |
| case 0x83: return "authentication/PIN method blocked"; |
| case 0x84: return "referenced data invalidated"; |
| case 0x85: return "conditions of use not satisfied"; |
| case 0x86: return "command not allowed (no EF selected)"; |
| case 0x89: return "command not allowed - secure channel -" |
| + " security not satisfied"; |
| } |
| break; |
| case 0x6A: |
| switch(sw2) { |
| case 0x80: return "incorrect parameters in the data field"; |
| case 0x81: return "function not supported"; |
| case 0x82: return "file not found"; |
| case 0x83: return "record not found"; |
| case 0x84: return "not enough memory space"; |
| case 0x86: return "incorrect parameters P1 to P2"; |
| case 0x87: return "lc inconsistent with P1 to P2"; |
| case 0x88: return "referenced data not found"; |
| } |
| break; |
| case 0x6B: return "incorrect parameter P1 or P2"; |
| case 0x6C: return "wrong length, retry with " + sw2; |
| case 0x6D: return "unknown instruction code given in the command"; |
| case 0x6E: return "wrong instruction class given in the command"; |
| case 0x6F: |
| switch(sw2) { |
| case 0x00: return "technical problem with no diagnostic given"; |
| default: return "the interpretation of this status word is command dependent"; |
| } |
| // break; |
| case 0x90: return null; // success |
| case 0x91: return null; // success |
| //Status Code 0x92 has contradictory meanings from 11.11 and 102.221 10.2.1.1 |
| case 0x92: |
| if (sw2 >> 4 == 0) { |
| return "command successful but after using an internal update retry routine"; |
| } |
| switch(sw2) { |
| case 0x40: return "memory problem"; |
| } |
| break; |
| case 0x93: |
| switch(sw2) { |
| case 0x00: return "SIM Application Toolkit is busy. Command cannot be executed" |
| + " at present, further normal commands are allowed"; |
| } |
| break; |
| case 0x94: |
| switch(sw2) { |
| case 0x00: return "no EF selected"; |
| case 0x02: return "out f range (invalid address)"; |
| case 0x04: return "file ID not found/pattern not found"; |
| case 0x08: return "file is inconsistent with the command"; |
| } |
| break; |
| case 0x98: |
| switch(sw2) { |
| case 0x02: return "no CHV initialized"; |
| case 0x04: return "access condition not fulfilled/" |
| + "unsuccessful CHV verification, at least one attempt left/" |
| + "unsuccessful UNBLOCK CHV verification, at least one attempt left/" |
| + "authentication failed"; |
| case 0x08: return "in contradiction with CHV status"; |
| case 0x10: return "in contradiction with invalidation status"; |
| case 0x40: return "unsuccessful CHV verification, no attempt left/" |
| + "unsuccessful UNBLOCK CHV verification, no attempt left/" |
| + "CHV blocked/" |
| + "UNBLOCK CHV blocked"; |
| case 0x50: return "increase cannot be performed, Max value reached"; |
| // The definition for these status codes can be found in TS 31.102 7.3.1 |
| case 0x62: return "authentication error, application specific"; |
| case 0x64: return "authentication error, security context not supported"; |
| case 0x65: return "key freshness failure"; |
| case 0x66: return "authentication error, no memory space available"; |
| case 0x67: return "authentication error, no memory space available in EF_MUK"; |
| } |
| break; |
| case 0x9E: return null; // success |
| case 0x9F: return null; // success |
| } |
| return UNKNOWN_ERROR; |
| } |
| |
| |
| @UnsupportedAppUsage |
| public int sw1; |
| @UnsupportedAppUsage |
| public int sw2; |
| |
| @UnsupportedAppUsage |
| public byte[] payload; |
| |
| @UnsupportedAppUsage |
| public IccIoResult(int sw1, int sw2, byte[] payload) { |
| this.sw1 = sw1; |
| this.sw2 = sw2; |
| this.payload = payload; |
| } |
| |
| @UnsupportedAppUsage |
| public IccIoResult(int sw1, int sw2, String hexString) { |
| this(sw1, sw2, IccUtils.hexStringToBytes(hexString)); |
| } |
| |
| @Override |
| public String toString() { |
| return "IccIoResult sw1:0x" |
| + Integer.toHexString(sw1) |
| + " sw2:0x" |
| + Integer.toHexString(sw2) |
| + " Payload: " |
| + (TelephonyUtils.IS_DEBUGGABLE ? IccUtils.bytesToHexString(payload) : "*******") |
| + ((!success()) ? " Error: " + getErrorString() : ""); |
| } |
| |
| /** |
| * true if this operation was successful |
| * See GSM 11.11 Section 9.4 |
| * (the fun stuff is absent in 51.011) |
| */ |
| @UnsupportedAppUsage |
| public boolean success() { |
| return sw1 == 0x90 || sw1 == 0x91 || sw1 == 0x9e || sw1 == 0x9f; |
| } |
| |
| /** |
| * Returns exception on error or null if success |
| */ |
| public IccException getException() { |
| if (success()) return null; |
| |
| switch (sw1) { |
| case 0x94: |
| if (sw2 == 0x08) { |
| return new IccFileTypeMismatch(); |
| } else { |
| return new IccFileNotFound(); |
| } |
| default: |
| return new IccException("sw1:" + sw1 + " sw2:" + sw2); |
| } |
| } |
| } |