Reader

class Reader

closeSessions

fun closeSessions(): Unit

Close all the sessions opened on this reader. All the channels opened by all these sessions will be closed.

getName

fun getName(): String

Return the name of this reader.

• If this reader is a SIM reader, then its name must be "SIM[Slot]".
• If the reader is a SD or micro SD reader, then its name must be "SD[Slot]"
• If the reader is a embedded SE reader, then its name must be "eSE[Slot]"

Slot is a decimal number without leading zeros. The Numbering must start with 1 (e.g. SIM1, SIM2, ... or SD1, SD2, ... or eSE1, eSE2, ...). The slot number “1” for a reader is optional (SIM and SIM1 are both valid for the first SIM-reader, but if there are two readers then the second reader must be named SIM2). This applies also for other SD or SE readers.

Return
String	the reader name, as a String. This value cannot be null.

getSEService

fun getSEService(): SEService

Return the Secure Element service this reader is bound to.

Return
SEService	the SEService object. This value cannot be null.

isSecureElementPresent

fun isSecureElementPresent(): Boolean

Check if a Secure Element is present in this reader.

Return
Boolean	true if the SE is present, false otherwise.

Exceptions
java.lang.IllegalStateException	if the service is not connected

openSession

fun openSession(): Session

Connects to a Secure Element in this reader.
This method prepares (initialises) the Secure Element for communication before the Session object is returned (e.g. powers the Secure Element by ICC ON if its not already on). There might be multiple sessions opened at the same time on the same reader. The system ensures the interleaving of APDUs between the respective sessions.

Return
Session	a Session object to be used to create Channels. This value cannot be null.

Exceptions
java.io.IOException	if something went wrong with the communicating to the Secure Element or the reader.