Hibiscus unterstützt primär Kartenleser, zu denen ein sog. „PC/SC-Treiber“ vorliegt. Der parallel hierzu existierende Standard „CTAPI“ wird von Hibiscus zwar noch unterstützt, gilt aber inzwischen als veraltet. Zusätzlich existieren für einige Betriebssysteme sogenannte PC/SC-CTAPI-Wrapper, welche die Befehle von und zum Kartenleser umwandeln können. Der Wrapper schaltet sich hierbei zwischen die Kommunikation von Treiber und Hibiscus. In Richtung Hibiscus „spricht“ der Wrapper nach CTAPI-Standard, gegenüber dem Treiber jedoch nach PC/SC-Standard. Auf diese Weise können indirekt unter Umständen auch einige Kartenleser verwendet werden, zu denen keine CTAPI-Treiber existieren, jedoch PC/SC-Treiber. Dieser Wrapper sollte jedoch nur verwendet werden, wenn die direkte Ansteuerung per PC/SC durch Hibiscus nicht funktioniert.

Es existieren also drei Möglichkeiten:

1. PC/SC (bevorzugter Weg)
2. CTAPI (veralteter Weg insofern keine PC/SC-Treiber für den Kartenleser vorhanden sind)
3. pcsc-wrapper (u.U. insbesondere unter OS X zu empfehlen). Der Wrapper liegt in verschiedenen Versionen (0.1-0.4) vor, die teilweise über das Internet verstreut sind. Eine Zusammenfassung aller dieser Versionen steht unter https://github.com/sixtyfive/pcsc-ctapi-wrapper zur Verfügung. Die dort aktuelle Revision entspricht Version 0.4 und wurde zumindest mit dem SCR335 erfolgreich getestet.

Versuche zunächst die automatische Einrichtung des Kartenlesers, indem du auf die Schaltfläche „Kartenleser suchen…“ klickst. Wenn der Kartenleser hierbei nicht gefunden wird, ziehe den Kartenleser ab, starte Hibiscus neu und schließe den Kartenleser dann wieder ab. Wenn auch das nicht hilft, lege die Kartenleser-Konfiguration manuell an.. Klicke hierzu auf die Schaltfläche „Kartenleser manuell anlegen“. Wähle anschließend im Auswahlfeld „Kartenleser“ die Option „PC/SC-Kartenleser (Kobil, ReinerSCT und andere)“. Stelle als HBCI-Version „FinTS 3.0“ ein. Alle anderen Einstellungen können i.d.R. unverändert bleiben.

Hinweis für Linux/BSD-User Bei der Verwendung von PC/SC ist es in einigen Distributionen erforderlich, mittels einer Konfigurationsdatei explizit anzugeben, wo sich die Systembibliothek „libpcsclite.so.1“ befindet. Oft ist das nicht notwendig. Für User von BSD und einigen Distributionen wie Debian, Mageia oder Linux Mint) ist es jedoch ggf. erforderlich. Lege hierzu eine Text-Datei mit dem Namen „de.willuhn.jameica.services.SysPropertyService.properties“ im Ordner „/home/<username>/.jameica/cfg“ mit folgenden Inhalt an:

sun.security.smartcardio.library=/usr/lib/libpcsclite.so.1

Prüfe, ob die Datei „/usr/lib/libpcsclite.so.1“ tatsächlich existiert und passe den Pfad ggf. an. Weitere mögliche Orte, an denen die Datei ggf. liegt:

• /usr/lib/libpcsclite.so.1
• /usr/lib32/libpcsclite.so.1
• /usr/lib64/libpcsclite.so.1
• /lib/x86_64-linux-gnu/libpcsclite.so.1

Hinweis zu Fedora Linux: Hier muss das Paket „pcsc-lite-devel“ installiert werden, damit die Datei vorhanden ist.

Beachte ausserdem, dass die „Bittigkeit“ der Bibliothek zur installierten Java-Version passt. Falls du ein 32Bit-Java installiert hast (kannst du mit dem Befehl „java -version“ in einem Terminal-Fenster harausfinden), muss auch eine 32Bit-Version der Datei „libpcsclite.so.1“ angegeben werden. Gleiches gilt für die 64Bit-Version von Java. Andernfalls kann es beim Zugriff auf den Kartenleser zu einem Absturz der Java-VM (und somit von Jameica) kommen.

Prüfe beim nächsten Start von Jameica anhand der Ausgaben in der Log-Datei /home/<username>/.jameica/jameica.log, ob das o.g. System-Property korrekt gesetzt wurde. Folge Meldung sollte in der Log-Datei erscheinen:

[<Datum>][INFO][de.willuhn.jameica.services.SysPropertyService.init] setting sys property: sun.security.smartcardio.library: /usr/lib/libpcsclite.so.1

Weiterhin muss z.B. bei OpenSUSE der pcscd laufen. Test mit

systemctl status pcscd.service

Im Folgenden eine Liste bekannter CTAPI-Treiber, die erfolgreich mit Hibiscus verwendet wurden.

Hinweis für Linux: Das Device des Kartenlesers (bei USB z.Bsp. /dev/ttyUSB0) wird ggf. mit Schreibrechten für die Benutzergruppe „uucp“ angelegt. Falls es zu Fehlern beim Zugriff auf den Kartenleser kommt, kann das auch an fehlenden Schreibrechten auf diesem Device liegen. Der Benutzer muss in dem Fall zu Benutzergruppe „uucp“ hinzugefügt werden.

Dieser Hersteller liefert Kartenleser, die oft in Notebooks von Fujitsu oder Dell integriert sind.

Im Folgenden eine Liste von Installations-Anleitungen von anderen Usern für den pcsc-wrapper: