1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
|
/*
* 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);
}
}
}
|
