Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 2680416a authored by Cody Kesting's avatar Cody Kesting
Browse files

Clarify documentation for TelMan#iccOpenLogicalChannel. 

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
parent dc4cb81c

telephony/java/android/telephony/TelephonyManager.java

+36 −0
Original line number Diff line number Diff line
@@ -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: