Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Clarify documentation for TelMan#iccOpenLogicalChannel.

Browse Source 
TelephonyManager#iccOpenLogicalChannel documentation should be improved
to clarify the function and its inputs. Relevant standards are also
explicitly referenced.

Bug: 129555815
Test: Only documentation is changed. Tests not affected.
Change-Id: I0664572c83cde480a9ac5f39d8664723b9ac81c9
This commit is contained in:
Cody Kesting
2019-03-29 13:06:41 -07:00
parent dc4cb81c83
commit 2680416a67
1 changed files with 36 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
telephony/java/android/telephony/TelephonyManager.java
View File

@@ -5177,6 +5177,18 @@ public class TelephonyManager {
* Use this method when no subscriptions are available on the SIM and the operation must be
* performed using the physical slot index.
*
* This operation wraps two APDU instructions:
* <ul>
* <li>MANAGE CHANNEL to open a logical channel</li>
* <li>SELECT the given {@code AID} using the given {@code p2}</li>
* </ul>
*
* Per Open Mobile API Specification v3.2 section 6.2.7.h, only p2 values of 0x00, 0x04, 0x08,
* and 0x0C are guaranteed to be supported.
*
* If the SELECT command's status word is not '9000', '62xx', or '63xx', the status word will be
* considered an error and the channel shall not be opened.
*
* Input parameters equivalent to TS 27.007 AT+CCHO command.
*
* <p>Requires Permission:
@@ -5208,6 +5220,18 @@ public class TelephonyManager {
/**
* Opens a logical channel to the ICC card.
*
* This operation wraps two APDU instructions:
* <ul>
* <li>MANAGE CHANNEL to open a logical channel</li>
* <li>SELECT the given {@code AID} using the given {@code p2}</li>
* </ul>
*
* Per Open Mobile API Specification v3.2 section 6.2.7.h, only p2 values of 0x00, 0x04, 0x08,
* and 0x0C are guaranteed to be supported.
*
* If the SELECT command's status word is not '9000', '62xx', or '63xx', the status word will be
* considered an error and the channel shall not be opened.
*
* Input parameters equivalent to TS 27.007 AT+CCHO command.
*
* <p>Requires Permission:
@@ -5225,6 +5249,18 @@ public class TelephonyManager {
/**
* Opens a logical channel to the ICC card.
*
* This operation wraps two APDU instructions:
* <ul>
* <li>MANAGE CHANNEL to open a logical channel</li>
* <li>SELECT the given {@code AID} using the given {@code p2}</li>
* </ul>
*
* Per Open Mobile API Specification v3.2 section 6.2.7.h, only p2 values of 0x00, 0x04, 0x08,
* and 0x0C are guaranteed to be supported.
*
* If the SELECT command's status word is not '9000', '62xx', or '63xx', the status word will be
* considered an error and the channel shall not be opened.
*
* Input parameters equivalent to TS 27.007 AT+CCHO command.
*
* <p>Requires Permission: