This part describes the usage of low level CardReaderProvider for USB IdentosCardReader in your application.
Generated API docs are available at https://gematik.github.io/ref-CardReaderProvider-USB-Identos-Android.
Licensed under the Apache License, Version 2.0.
The USB Identos CardReader provider uses the Software Development Kit (SDK) developed by IDENTOS. This framework is provided by IDENTOS for use exclusively with the APPIDKEY ID100 Card Reader, and is governed by the terms of use granted by license to users of the ID100 product.
The Identos USB CardReaderProvider needs a descriptor behind YOUR.PROVIDER\src\main\resources\META-INF\services with filename de.gematik.ti.cardreader.provider.spi.ICardReaderControllerProvider and the content of the package and class which implements the service provider interface de.gematik.ti.cardreader.provider.usb.identos.control.IdentosCardReaderProvider.
The integrated Identos id100 library for Android supports the usage of integrating smart card functionality using Identos CardReader.
The IdentosCardReaderProvider class needs implementation of the interface 'ICardReaderControllerProvider' to handle listener and provide methods to inform connected listeners about card reader changes.
The IdentosCardReaderController class extends the abstract class 'AbstractCardReaderController' to handle necessary permissions and checking if the application context is set. Returns a list with currently connected Identos cardReaders and informs about reader connection and disconnection.
The IdentosUsbReceiver class extends the BroadCastReceiver class that receives and handles broadcast intents sent by {@link android.content.Context#sendBroadcast(Intent)}. The actions of the intents that are being handled are changes in the state of the usb device (attach / detach).
The Identos Smart Card Reader implements the Interface ICardReader. Works as adapter to the Identos id100 library for Android.
A Smart Card with which a connection has been established. IdentosCard extends the abstract class Card. Works as adapter to the Identos id100 library for Android.
EventListener for card events. Works as adapter to the Identos id100 library for Android.
A logical channel connection to a Smart Card. It is used to exchange APDUs with a Smart Card using USB Identos CardReader. A IdentosCardChannel object can be obtained by calling the method IdentosCard.getBasicChannel() or IdentosCard.openLogicalChannel().
To use CardReaderProvider for Identos USB CardReader in a project, you need just to include following dependency:
Gradle dependency settings to use CardReaderProvider for Identos USB CardReader library.
dependencies {
implementation group: 'de.gematik.ti', name: 'cardreader.provider.usb.identos', version: '1.1.9'
}
Maven dependency settings to use CardReaderProvider for Identos USB library.
<dependencies>
<dependency>
<groupId>de.gematik.ti</groupId>
<artifactId>cardreader.provider.usb.identos</artifactId>
<version>1.1.9</version>
</dependency>
</dependencies>