de.gematik.ti.cardreader.provider.usb.identos.entities

Class IdentosCard

java.lang.Object

de.gematik.ti.cardreader.provider.usb.identos.entities.IdentosCard

All Implemented Interfaces:

de.gematik.ti.cardreader.provider.api.card.ICard

public class IdentosCard
extends java.lang.Object
implements de.gematik.ti.cardreader.provider.api.card.ICard

include::{userguide}/UIDECRP_Structure.adoc[tag=IdentosCard]

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String	PROTO_T_1

Constructor Summary

Constructors

Constructor and Description
IdentosCard(com.identos.android.id100.library.ccid.UsbReader reader, de.gematik.ti.cardreader.provider.api.card.Atr atr)

Method Summary

Modifier and Type	Method and Description
void	beginExclusive() Requests exclusive access to this card.
void	disconnect(boolean reset) Disconnects the connection with this card.
void	endExclusive() Releases the exclusive access previously established using beginExclusive.
de.gematik.ti.cardreader.provider.api.card.Atr	getATR() Returns the ATR of this card
de.gematik.ti.cardreader.provider.api.card.ICardChannel	getBasicChannel() Returns the CardChannel for the basic logical channel.
de.gematik.ti.cardreader.provider.api.card.CardProtocol	getProtocol() Returns the protocol in use for this card, for example "T=0" or "T=1".
de.gematik.ti.cardreader.provider.api.card.ICardChannel	openBasicChannel()
de.gematik.ti.cardreader.provider.api.card.ICardChannel	openLogicalChannel() Opens a new logical channel to the card and returns it.
byte[]	transmitControlCommand(int i, byte[] bytes) Control commands not supported on Identos USB CardReader

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PROTO_T_1

protected static final java.lang.String PROTO_T_1

See Also:

Constant Field Values

Constructor Detail

IdentosCard

public IdentosCard(com.identos.android.id100.library.ccid.UsbReader reader,
                   de.gematik.ti.cardreader.provider.api.card.Atr atr)

Method Detail

getATR

public de.gematik.ti.cardreader.provider.api.card.Atr getATR()

Returns the ATR of this card

Specified by:

getATR in interface de.gematik.ti.cardreader.provider.api.card.ICard

Returns:

the ATR of this card.

getProtocol

public de.gematik.ti.cardreader.provider.api.card.CardProtocol getProtocol()

Returns the protocol in use for this card, for example "T=0" or "T=1".

Specified by:

getProtocol in interface de.gematik.ti.cardreader.provider.api.card.ICard

Returns:

the protocol in use for this card, for example "T=0" or "T=1".

openBasicChannel

public de.gematik.ti.cardreader.provider.api.card.ICardChannel openBasicChannel()
                                                                         throws de.gematik.ti.cardreader.provider.api.card.CardException

Specified by:

openBasicChannel in interface de.gematik.ti.cardreader.provider.api.card.ICard

Throws:

de.gematik.ti.cardreader.provider.api.card.CardException

getBasicChannel

public de.gematik.ti.cardreader.provider.api.card.ICardChannel getBasicChannel()

Returns the CardChannel for the basic logical channel. The basic logical channel has a channel number of 0.

Returns:

CardChannel for the basic logical channel. The basic logical channel has a channel number of 0.

openLogicalChannel

public de.gematik.ti.cardreader.provider.api.card.ICardChannel openLogicalChannel()
                                                                           throws de.gematik.ti.cardreader.provider.api.card.CardException

Opens a new logical channel to the card and returns it.

Specified by:

openLogicalChannel in interface de.gematik.ti.cardreader.provider.api.card.ICard

Returns:

a new logical channel to the card

Throws:

de.gematik.ti.cardreader.provider.api.card.CardException

beginExclusive

public void beginExclusive()
                    throws de.gematik.ti.cardreader.provider.api.card.CardException

Requests exclusive access to this card.

Once a thread has invoked beginExclusive, only this thread is allowed to communicate with this card until it calls endExclusive. Other threads attempting communication will receive a CardException.

Applications have to ensure that exclusive access is correctly released. This can be achieved by executing the beginExclusive() and endExclusive calls in a try ... finally block.

Throws:

de.gematik.ti.cardreader.provider.api.card.CardException

endExclusive

public void endExclusive()
                  throws de.gematik.ti.cardreader.provider.api.card.CardException

Releases the exclusive access previously established using beginExclusive.

Throws:

de.gematik.ti.cardreader.provider.api.card.CardException

transmitControlCommand

public byte[] transmitControlCommand(int i,
                                     byte[] bytes)
                              throws de.gematik.ti.cardreader.provider.api.card.CardException

Control commands not supported on Identos USB CardReader

Parameters:

i -

bytes -

Returns:

Throws:

de.gematik.ti.cardreader.provider.api.card.CardException

disconnect

public void disconnect(boolean reset)
                throws de.gematik.ti.cardreader.provider.api.card.CardException

Disconnects the connection with this card.

Specified by:

disconnect in interface de.gematik.ti.cardreader.provider.api.card.ICard

Parameters:

reset -

Throws:

de.gematik.ti.cardreader.provider.api.card.CardException