25
ZF Friedrichshafen AG Version 007 Dokumentation Cherry eHealth Produkte Lokale Installation ZF Friedrichshafen AG Electronic Systems August 2013

eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

  • Upload
    donhi

  • View
    215

  • Download
    0

Embed Size (px)

Citation preview

Page 1: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

ZF Friedrichshafen AG Version 007

Dokumentation

Cherry eHealth Produkte

Lokale Installation

ZF Friedrichshafen AG

Electronic Systems

August 2013

Page 2: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

2/25

ZF Friedrichshafen AG Electronic Systems Cherrystraße D-91275 Auerbach/Opf. Homepage: www.cherry.de Downloads: support.cherry.de © Copyright 2013, ZF Electronic Systems, Auerbach, Deutschland Alle Rechte vorbehalten. Text, Bilder und Grafiken sowie deren Anordnung in diesem Dokument der ZF Friedrichshafen AG unterliegen dem Schutz des Urheberrechts und anderer Schutzgesetze. Der Inhalt dieses Dokuments darf nicht zu kommerziellen Zwecken kopiert, verbreitet, verändert oder Dritten zugänglich gemacht werden. ZF Friedrichshafen AG übernimmt keine Haftung für Fehler oder Folgeschäden, die durch Ausstattung, Leistung und Gebrauch dieser Dokumentation entstehen. CHERRY ist eine Marke der ZF Friedrichshafen AG. Alle anderen in diesem Dokument genannten Produkte oder Dienstleistungen sind Marken, Dienstleistungsmarken, eingetragene Marken oder eingetragene Dienstleistungsmarken der entsprechenden Eigentümer.

Page 3: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

3/25

Inhaltsverzeichnis

1 ABKÜRZUNGSVERZEICHNIS ........................................................................................................................... 4

2 AUSGANGSLAGE ............................................................................................................................................ 5

3 INSTALLATION ............................................................................................................................................... 6

3.1 WINDOWS ........................................................................................................................................................ 6 3.1.1 Gerätetreiber ......................................................................................................................................... 8

3.2 LINUX .............................................................................................................................................................. 8 3.2.1 eHealth-BCS Terminal ST-1503 bzw. Tastatur G87-1504 ...................................................................... 8 3.2.2 MKT+ Tastatur G80-1502 ...................................................................................................................... 8 3.2.3 MKT+ Terminal ST-2052 ........................................................................................................................ 8

3.3 MAC OS X ....................................................................................................................................................... 9 3.3.1 eHealth-BCS Terminal ST-1503 bzw. Tastatur G87-1504 ...................................................................... 9 3.3.2 MKT+ Tastatur G80-1502 ...................................................................................................................... 9 3.3.3 MKT+ Terminal ST-2052 ........................................................................................................................ 9

4 KONFIGURATION & FUNKTIONSTEST ............................................................................................................10

4.1 EHEALTH-BCS TERMINAL ST-1503 BZW. TASTATUR G87-1504 .............................................................................. 10 4.1.1 Windows .............................................................................................................................................. 10 4.1.2 Linux .................................................................................................................................................... 12 4.1.3 MAC OS X ............................................................................................................................................. 12

4.2 MKT+ TASTATUR G80-1502 ............................................................................................................................ 13 4.3 MKT+ TERMINAL ST-2052 ............................................................................................................................... 15

5 FEHLERBEHEBUNG ........................................................................................................................................17

5.1 DISPLAY DES KARTENTERMINALS BLEIBT DUNKEL ..................................................................................................... 17 5.2 SETUP BRICHT WÄHREND DER INSTALLATION AB ..................................................................................................... 17 5.3 TESTPROGRAMM MELDET „....DLL NICHT GEFUNDEN“ ............................................................................................. 17 5.4 CT-API KONFIGURATION ZEIGT GERÄT ALS „OFFLINE“ ............................................................................................ 18 5.5 KARTE WIRD NICHT GELESEN ............................................................................................................................... 18 5.6 FEHLERCODES ST-1503, G87-1504, ST-2052 .................................................................................................... 19

5.6.1 Antwort: Ungültiges Argument (-1)..................................................................................................... 19 5.6.2 Antwort: Übertragungsfehler (-10) ..................................................................................................... 19 5.6.3 Antwort: Übertragungsfehler (-128) ................................................................................................... 20 5.6.4 Antwort: Karte nicht aktiviert .............................................................................................................. 20

5.7 FEHLERCODES G80-1502 ................................................................................................................................. 20 5.7.1 Antwort: Ungültiges Argument (-1)..................................................................................................... 20 5.7.2 Antwort: Fehler Karten-Terminal (-8) .................................................................................................. 20 5.7.3 Antwort: Übertragungsfehler (-10) ..................................................................................................... 20 5.7.4 Antwort: Übertragungsfehler (-128) ................................................................................................... 21 5.7.5 Antwort: Karte nicht aktiviert .............................................................................................................. 21

6 SUPPORTINFORMATIONEN ERSTELLEN ........................................................................................................22

7 LINKS ZU PROGRAMMEN, DATEIEN UND VERZEICHNISSEN ..........................................................................24

Page 4: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

4/25

1 Abkürzungsverzeichnis

AIS Arztinformationssystem

BCS Basic Command Set; beschreibt Basiskommandos zur Ansteuerung von Kartenterminals

CCID Chip/SmartCard Interface Device

CD Compact Disc

CT-API Card Terminal - Application Programming Interface

DLL Dynamic Link Library; eine dynamische Programmbibliothek (ein Programm, das zur benötigten Laufzeit ausgeführt wird)

eGK elektronische Gesundheitskarte

eHealth elektronisches Gesundheitswesen

HID Human Interface Device (lt. USB Spezifikation www.usb.org)

IT Informationstechnik

KIS Krankenhausinformationssystem

KVK Krankenversichertenkarte

MKT+ Multifunktionales Kartenterminal; Nachfolger der KVK-Lesegeräte. Der + Zusatz zeigt an, dass KVK und zusätzlich eGK gelesen werden können.

PVS Praxisverwaltungssystem

Page 5: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

5/25

2 Ausgangslage

Im Gesundheitswesen werden zum Bearbeiten der dt. Krankenversichertenkarte (KVK) und der elektronischen Gesundheitskarte (eGK) entsprechende, zugelassene Lesegeräte eingesetzt. Im lokalen Betrieb erhält die auf dem Rechner installierte Anwendersoftware Zugriff auf die angeschlossenen Cherry eHealth Produkte. Der Zugriff auf KVK und eGK wird durch die Anwendersoftware gesteuert. Darunter ist jegliche Art von Programmen zu verstehen, welche die Daten der Karte einlesen und weiterverarbeiten. Dies können z.B. Arztinformationssysteme (AIS) oder Krankenhausinformationssysteme (KIS) sein. Dieses Dokument beschreibt die lokale Installation bzw. Einbindung folgender Cherry eHealth Produkte:

eHealth-BCS Tastatur G87-1504

eHealth-BCS Terminal ST-1503

MKT+ Terminal ST-2052

MKT+ Tastatur G80-1502

Page 6: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

6/25

3 Installation

3.1 Windows

• Installieren Sie die „eGK-KVK Software“.

Sie ist erhältlich unter http://support.cherry.de/ >> Downloads.

Optional verwenden Sie die dem Produkt beiliegende CD.

Unterstützt wird das Auslesen der dt. Krankenversichertenkarte (KVK) und der elektronischen Gesundheitskarte (eGK) für folgende Produkte:

eHealth-BCS Tastatur G87-1504

eHealth-BCS Terminal ST-1503

MKT+ Terminal ST-2052

MKT+ Tastatur G80-1502

Bitte beachten: Ab eGK-KVK Software V3.3 wird die G80-1502 nicht mehr unterstützt. Verwenden Sie für dieses Produkt weiterhin die Version 3.2.

Die Installation und Deinstallation der Cherry eGK/KVK Software kann im Hintergrund (‚silent‘) erfolgen. In der heruntergeladenen Datei ist ein entsprechende Anleitung (‚MSI_Silent_Readme_DE.pdf‘) enthalten.

Hinweise:

• An der Windows Firewall werden für die Programme „ctcymconfig.exe“ und „readegk32.exe“ Ausnahmeregeln erstellt.

• Zum Ausführen des CT-API Konfigurators, der in der „Cherry eGK/KVK Software“ enthalten ist, werden aus Windows Sicherheitsgründen administrative Benutzerrechte benötigt.

Installationsstart: (Doppel-)Klick auf Datei „Cherry-eGK-KVK_Software.msi“:

Page 7: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

7/25

Installationsschritte: 1.Starten des eGK/KVK Setups 2. Akzeptieren des Lizenzvertrages

3. Verwendete Geräte auswählen 4. Zusammenfassung der Installation (Das von Ihnen eingesetzte Produkt kann (Ausgewählte Geräte werden ohne rotes X angezeigt) möglicherweise ein anderes sein als gezeigt).

5. Installationsprozess 6. Setup Ende

• Schließen Sie nun das jeweilige Produkt lt. Bedienungsanleitung an.

Page 8: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

8/25

3.1.1 Gerätetreiber

Die Ablage der Treiber erfolgt

bis eGK/KVK Software v3.2 unter %ProgramFiles%\Cherry\SmartDevice\

ab eGK/KVK Software v3.3 unter %CommonProgramFiles%\Cherry\Driver\

3.2 Linux

3.2.1 eHealth-BCS Terminal ST-1503 bzw. Tastatur G87-1504

• Installieren Sie die Software „LINUX CT-API“ bzw. „LINUX 64Bit CT-API“ (http://support.cherry.de/ >> Downloads).

• Zur Installation beachten sie bitte die readme Datei in der heruntergeladenen Software.

• Schließen Sie das Produkt an einer USB Schnittstelle des Rechners an.

• Das Gerät wird mit Port 1 angesprochen.

• Nur im Fall, dass mehr als 1 Gerät betrieben wird: Starten Sie das CT-API Konfigurationstool 'ctcymconfig'. Es befindet sich normalerweise unter /usr/sbin. Weisen Sie jedem Gerät eine fortlaufende Port-Nummer zu.

• Die Verwaltung der Geräte hinsichtlich der zugewiesenen Port-Nummern obliegt der Anwendersoftware.

3.2.2 MKT+ Tastatur G80-1502

Aktuell keine Linux Unterstützung durch Cherry Software.

3.2.3 MKT+ Terminal ST-2052

• Installieren Sie die Software „CCID Treiber mit CT-API“ (http://support.cherry.de/ >> Downloads). Bitte beachten Sie dabei die readme Datei im heruntergeladenen Paket.

• Das erste angeschlossene Terminal ST-2052 am Client arbeitet immer mit der Portnummer 1.

Page 9: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

9/25

• Die Verwaltung der Geräte hinsichtlich der zugewiesenen Port-Nummern obliegt der Anwendersoftware.

3.3 MAC OS X

3.3.1 eHealth-BCS Terminal ST-1503 bzw. Tastatur G87-1504

• Installieren Sie die Software „CT-Api für eHealth-BCS Terminal ST-1503 / eHealth-BCS Tastatur G87-1504“ (http://support.cherry.de/ >> Downloads). Bitte beachten Sie dabei die readme Datei im heruntergeladenen Paket.

3.3.2 MKT+ Tastatur G80-1502

Aktuell keine MAC OS X Unterstützung durch Cherry Software.

3.3.3 MKT+ Terminal ST-2052

• Installieren Sie die Software „CCID Treiber mit CT-API“ (http://support.cherry.de/ >> Downloads). Bitte beachten Sie dabei die readme Datei im heruntergeladenen Paket.

Page 10: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

10/25

4 Konfiguration & Funktionstest

4.1 eHealth-BCS Terminal ST-1503 bzw. Tastatur G87-1504

Das Cherry "eHealth-BCS Terminal ST-1503" und die "eHealth-BCS Tastatur G87-1504" werden vom Betriebssystem lokal als HID (Human Interface Device) -Gerät erkannt. Als eHealth BCS Gerät werden sie über die Cherry CT-API Dateien „ctcym.dll“ (32 Bit) bzw. „ctcym64.dll“ (64Bit) angesprochen. Die Auswahl 32- oder 64-Bit CT-API richtet sich NICHT nach der Bitstärke des verwendeten Betriebssystems, sondern nach der verwendeten Anwendersoftware (PVS, KIS). Die 64-Bit CT-API (ctcym64.dll) ist bei Verwendung von 64-Bit Applikationen einzusetzen.

4.1.1 Windows

Es ist keine Konfiguration nötig.

Das Gerät wird mit Port 1 angesprochen.

Die CT-API Konfiguration zeigt die am Client erkannten Geräte an.

Eine Portzuordnung ist bei nur einem Gerät nicht notwendig.

Für den Fall, dass mehr als 1 Gerät am selben Rechner betrieben wird:

o Wählen Sie START >> Programme >> Cherry eGK KVK Software >> CT-API Konfiguration. Weisen Sie jedem Gerät eine fortlaufende Port-Nummer zu.

Installationsverifikation

• Starten Sie das „Testprogramm eGK-KVK" (START >> Alle Programme >> Cherry eGK KVK Software >> Testprogramm eGK-KVK).

Page 11: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

11/25

• Markieren Sie darin unter „Gerät auswählen“ den Eintrag „ST-1503 / G87-1504“.

• Die Port-Nummer muss identisch sein zu evtl. in der „CT-API Konfiguration“ getroffenen Einstellungen. Ist nur ein Produkt angeschlossen lautet die Port-Nummer 1.

• Klicken Sie auf „Einstellungen testen“.

• Stecken Sie eine Karte in das Chipkartenterminal und klicken Sie auf „Karte lesen“.

Page 12: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

12/25

Ihr Cherry eHealth-Chipkartenterminal ist somit korrekt installiert und funktionsfähig.

Im nächsten Schritt muss das Terminal in Ihre Anwendersoftware eingebunden werden. Eine Liste freigegebener eHealth Programme finden Sie unter http://www.cherry.de/cid/eHealth_softwarezuordnung.htm? Eventuell existiert in der von Ihnen verwendeten Anwendung evtl. eine Auswahl unterstützter Chipkartenleser. Wählen Sie dort das entsprechende Cherry Produkt. Für Details zur Einbindung und im Fall, dass Ihre Anwendung dort nicht gelistet ist, kontaktieren Sie bitte den Hersteller Ihrer Anwendersoftware.

4.1.2 Linux

Es ist keine Konfiguration nötig.

Das Gerät wird mit Port 1 angesprochen.

Eine Portzuordnung ist bei nur einem Gerät am selben Rechner nicht notwendig.

Die CT-API Konfiguration zeigt die am Rechner erkannten Geräte an.

Für den Fall, dass mehr als 1 Gerät am selben Rechner betrieben wird:

o Starten Sie das CT-API Konfigurationstool 'ctcymconfig'. Es befindet sich normalerweise unter /usr/sbin.

o Weisen Sie jedem Gerät am Rechner eine fortlaufende Port-Nummer zu.

4.1.3 MAC OS X

Es ist keine Konfiguration nötig.

Das Gerät wird mit Port 1 angesprochen.

Eine Portzuordnung ist bei nur einem Gerät am selben Rechner nicht notwendig.

Page 13: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

13/25

4.2 MKT+ Tastatur G80-1502

Zur Verarbeitung der elektronischen Gesundheitskarte (eGK) ist der Chipkartenleser der MKT+ Tastatur

G80-1502 über die serielle Schnittstelle (RS232/COM) zu betreiben. Die Datenübertragung aus Chipkarten über PS/2 wird von der Cherry eGK/KVK Software nicht unterstützt! Bzgl. der Unterstützung des seriellen Ports sollte Ihnen eine Freigabe Ihres Software-Herstellers vorliegen. Die Tastatur muss sich im Mode M1 (= Werkseinstellung) und S1 befinden und mind. den Indexstand /09 aufweisen. Dies entspricht der Firmware Version 1.19. Die Mode-Umstellung wird in der Bedienungsanleitung beschrieben. Prüfen Sie die Zeile „Artikel-Nr.“ auf der Rückseite der Tastatur. Hinter der Artikel-Nr. ist der Indexstand angegeben ("/09"). Ist er kleiner als /09 kann ausschließlich die Krankenversichertenkarte (KVK), nicht aber die eGK gelesen werden. In diesem Fall ist ein Firmware-Update durchzuführen (siehe http://support.cherry.de/ >> Downloads Achtung: Mit Cherry eGK\KVK Software Version 3.3 wird die G80-1502 nicht mehr unterstützt. Das Chipkartenterminal der G80-1502 wird über die CT-API Datei „ct_api.dll“ (32 Bit) angesprochen

• Wählen Sie Start >> Alle Programme >> Cherry eGK KVK Software >> CT-API Konfiguration

Weisen Sie darin der G80-1502 die Port-Nummer des verwendeten seriellen (COM) Anschlusses zu, d.h. COM 1 = Port 1 bzw. COM 2 = Port 2. (Die COM Port Anschlussnummern sind über den Gerätemanager ersichtlich.)

• Die Verwaltung der Geräte hinsichtlich der zugewiesenen Port-Nummern obliegt der Anwendersoftware.

Installationsverifikation

• Starten Sie das „Testprogramm eGK-KVK" (START >> Alle Programme >> Cherry eGK KVK Software >> Testprogramm eGK-KVK).

Page 14: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

14/25

• Markieren Sie darin unter „Gerät auswählen“ den Eintrag „G80-1502“. Die Port-Nummer muss identisch sein zu der in der „CT-API Konfiguration“ (i.d.R. 1).

• Klicken Sie auf „Einstellungen testen“.

• Stecken Sie eine Karte in das Chipkartenterminal und klicken Sie auf „Karte lesen“.

Ihr Cherry eHealth-Chipkartenterminal ist somit korrekt installiert und funktionsfähig.

Page 15: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

15/25

Im nächsten Schritt muss das Terminal in Ihre Anwendersoftware eingebunden werden. Eine Liste freigegebener eHealth Programme finden Sie unter http://www.cherry.de/cid/eHealth_softwarezuordnung.htm? Eventuell existiert in der von Ihnen verwendeten Anwendung evtl. eine Auswahl unterstützter Chipkartenleser. Wählen Sie dort das entsprechende Cherry Produkt. Für Details zur Einbindung und im Fall, dass Ihre Anwendung dort nicht gelistet ist, kontaktieren Sie bitte den Hersteller Ihrer Anwendersoftware.

4.3 MKT+ Terminal ST-2052

Das Cherry "MKT+ Terminal ST-2052" arbeitet nach dem sog. PC/SC Standard. Chipkartenterminals nutzen i. d. R. Betriebssystem-eigene CCID Treiber oder speziell vom Hersteller gelieferte. Es wird nach Installation der Cherry „eGK/KVK Software“ vom Betriebssystem als PC/SC Chipkartenleser erkannt. Im eHealth Umfeld findet die Kommunikation über CT-API statt. Als MKT+ Terminal wird das Gerät über die Cherry CT-API Datei „ctpcsc32kv.dll“ (32 Bit) angesprochen.

• Die CT-API Konfiguration zeigt die erkannten Geräte an.

Das Terminal ST-2052 ist nicht konfigurierbar. Dem ersten Gerät wird im CT-API Konfigurator immer der Port 1 zugewiesen. Jedes weitere wird automatisch durchnummeriert.

Installationsverifikation

• Starten Sie das „Testprogramm eGK-KVK" (START >> Alle Programme >> Cherry eGK KVK Software >> Testprogramm eGK-KVK).

• Markieren Sie darin unter „Gerät auswählen“ den Eintrag „ST-2052“. Die Port-Nummer muss identisch sein zu der in der lokalen „CT-API Konfiguration“ (i.d.R. 1).

• Klicken Sie auf „Einstellungen testen“.

• Stecken Sie eine Karte in das Chipkartenterminal und klicken Sie auf „Karte lesen“.

Page 16: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

16/25

Ihr Cherry eHealth-Chipkartenterminal ist somit korrekt installiert und funktionsfähig.

Im nächsten Schritt muss das Terminal in Ihre Anwendersoftware eingebunden werden. Eine Liste freigegebener eHealth Programme finden Sie unter http://www.cherry.de/cid/eHealth_softwarezuordnung.htm? Eventuell existiert in der von Ihnen verwendeten Anwendung evtl. eine Auswahl unterstützter Chipkartenleser. Wählen Sie dort das entsprechende Cherry Produkt. Für Details zur Einbindung und im Fall, dass Ihre Anwendung dort nicht gelistet ist, kontaktieren Sie bitte den Hersteller Ihrer Anwendersoftware.

Page 17: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

17/25

5 Fehlerbehebung

5.1 Display des Kartenterminals bleibt dunkel

• Gerät mit USB-Anschlusskabel direkt am Rechner angeschlossen? o Terminal direkt am PC anstecken (ohne externen USB-Hub). o Rechner einschalten und hochfahren. o Terminal ST-1503: einschalten (Schalter an der Rückseite). o Funktion der USB-Buchse des Rechners prüfen: funktioniert daran andere Hardware?

• Gerät an anderem Rechner gegentesten.

• ST-1503: Unabhängig ob das Gerät über USB oder an LAN angeschlossen wurde bitte das Original-Netzteil verwenden.

• Display leuchtet nach dem Anstecken kurz auf und geht wieder aus: o Einstellungen im BIOS des Rechners prüfen.

Es gibt scheinbar Rechner, bei denen die max. Stromabgabe an den USB Ports im BIOS eingestellt werden kann. Dort ist der Strom auf 100 mA begrenzt, die G87-1504 benötigt aber mehr (Bezeichnung z.B. „USB Hi-Power / Low-Power)

5.2 Setup bricht während der Installation ab

• Überprüfen Sie, ob Sie mit Administrator-Rechten angemeldet sind.

Während der Installation muss der Installationsprozess mit einem Administrator Konto bestätigt werden (Windows Popup Fenster).

• Testen Sie die neueste Software. Evtl. ist eine neuere Version im Cherry Download-Bereich verfügbar (http://support.cherry.de >> Downloads)

• Sollte der Fehler weiterhin bestehen, kontaktieren Sie den Cherry Support unter [email protected]

5.3 Testprogramm meldet „....dll nicht gefunden“

• Bei Installation wurde das falsche Gerät gewählt. o Setup erneut aufrufen – Ändern – das richtige Produkt wählen.

Page 18: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

18/25

5.4 CT-API Konfiguration zeigt Gerät als „offline“

START Alle Programme Cherry eGK KVK Software CT-API Konfiguration. Das Gerät ist vorhanden, wird allerdings als Verbindungstyp „offline“ angezeigt.

Gerätenamen: ST-1503: Cherry Sicct Terminal G87-1504: Cherry Sicct Keyboard

Gerät aus CT-API Konfiguration entfernen und neu einlesen, Port zuordnen: Eintrag markieren >> Entfernen >> Aktualisieren >> Eintrag markieren >> Port eingeben >> Übernehmen >> OK. Nochmals mittels Testprogramm das Einlesen prüfen. Das Gerät wird nach „Aktualisieren“ nicht wieder angezeigt (leere Anzeige): Dies deutet darauf hin, dass es vom Rechner am USB-Port nicht erkannt wurde. • Gerät ab-/anstecken • Anderen USB-Anschluss verwenden • Direkt an USB betreiben (ohne externen USB-Hub).

5.5 Karte wird nicht gelesen

Lösungsvorschläge:

• Überprüfen Sie, ob Sie für Installation und zum Testen mit Administrator-Rechten angemeldet sind.

• Überprüfen Sie die installierte Software, wie folgt: Wählen Sie START >> Alle Programme >> Cherry eGK KVK Software >> Setup. In der blauen Überschrift des Setup-Fensters erkennen Sie die Edition und Version.

Testen Sie die neueste Software. Evtl. ist eine neuere Version im Cherry Download-Bereich verfügbar (http://support.cherry.de >> Downloads).

Page 19: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

19/25

• Karte mit „Testprogramm eGK-KVK“ einlesen. Klick auf „Karte lesen“ - Display reagiert mit „Bitte Karte einführen“ (ohne Karte) oder liest die Daten der Karte? Dann wurde i.d.R. die Software-Installation korrekt durchgeführt.

• Wird die Karte im richtigen Kartenleser gesteckt? Leser oberhalb des Displays verwenden (nicht: seitlich rechts, der ist für den HBA). Kontaktfeld der Karte zum Tastenfeld, nach vorne zeigend.

• Die für das jeweilige Gerät verwendete CT-API Datei sollte nur ein einziges Mal vorliegen. Prüfen Sie, ob die CT-API Datei mehrmals am Rechner vorhanden ist.

Im Fall, dass die Datei gleichen Namens mehrfach vorhanden sind, prüfen Sie bitte die Versionen (rechte Maustaste >> Eigenschaften). Sie sollten identisch sein. Falls nicht, könnte es sein, dass die Anwendersoftware eine eigene, aber ältere Kopie der Datei installiert hat. Bitte testen Sie, inwiefern der temporäre Austausch der älteren Version gegen die neuere Datei Abhilfe bringt.

• MKT+ Tastatur G80-1502: Konfiguration der seriellen Schnittstelle des Rechners (Baudrate):

Die Tastatur G80-1502 testet standardmäßig selbstständig verschiedene Übertragungsgeschwindigkeiten. Im Fehlerfall sollten Sie dennoch die voreingestellten Standardwerte des Rechners überprüfen, wie folgt:

Aufruf des Gerätemanagers: START >> Ausführen >> Eingabe „devmgmt.msc“ (ohne Anführungszeichen); Eingabe-Taste betätigen >> Kommunikationsanschluss (COM xx) >> Eigenschaften >> Anschlusseinstellungen:

Bit pro Sekunde: 9600 Datenbits: 8 Parität: keine Stoppbits: 1 Flusssteuerung: keine

5.6 Fehlercodes ST-1503, G87-1504, ST-2052

Nachfolgende Fehler werden von der jeweiligen CT-API Datei zu einer Applikation (z.B. eGK-KVK Testprogramm) gesendet.

5.6.1 Antwort: Ungültiges Argument (-1)

Mögliche Ursachen:

• Angegebener Port ist nicht definiert / nicht gefunden

• Karte defekt / falsche Karte

5.6.2 Antwort: Übertragungsfehler (-10)

Mögliche Ursachen:

Page 20: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

20/25

• Das Chipkartenterminal ist nicht erreichbar.

5.6.3 Antwort: Übertragungsfehler (-128)

Mögliche Ursachen:

• Das CTAPI Kommando ist fehlerhaft. Es wurde kein CT_Init durchgeführt und z.B. das CT-Data gesendet.

5.6.4 Antwort: Karte nicht aktiviert

Mögliche Ursachen:

• Wird die Karte im richtigen Kartenleser gesteckt?

• Karte defekt / falsche Karte / Karte falsch gesteckt

• Deutet auf Hardware-Fehler hin (Kontaktierungsproblem). Test: Karte gesteckt festhalten und nochmals das Einlesen prüfen.

5.7 Fehlercodes G80-1502

5.7.1 Antwort: Ungültiges Argument (-1)

Mögliche Ursachen:

• Angegebener COM-Port wird nicht gefunden / gibt es vom System nicht;

Bitte COM-Port Nummern des Betriebssystems verwenden, ersichtlich im Gerätemanager ->> Anschlüsse ->> Kommunikationsanschluss (COM??)

• Karte defekt / falsche Karte

• Tastatur enthält nicht Firmware 1.19

5.7.2 Antwort: Fehler Karten-Terminal (-8)

Mögliche Ursachen:

• Der eingestellte COM-Port wird von einer anderen Anwendung blockiert.

• Eine andere Anwendung hat sich gerade mit dem Chipkartenterminal verbunden.

Die Schnittstelle ist nicht korrekt ansprechbar. Bitte überprüfen Sie Ihren Rechner. Für 32-Bit Systeme könnten sie z.B. das Tool ‚Portmon‘ von Microsoft nutzen: http://technet.microsoft.com/de-de/sysinternals/bb896644

5.7.3 Antwort: Übertragungsfehler (-10)

Mögliche Ursachen:

• Das Chipkartenterminal ist auf dem eingestellten COM-Port nicht erreichbar.

• Der RS232 Tastatur-Anschluss ist auf dem eingestellten COM-Port nicht angeschlossen.

Page 21: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

21/25

• Der PS2 Tastatur-Anschluss ist nicht angeschlossen (Stromversorgung fehlt).

• Die Tastatur ist auf dem falschen Modus z.B. S2 (PCSC) eingestellt – Bitte den Modus S1 (MKT) und M1 (Standard) verwenden.

5.7.4 Antwort: Übertragungsfehler (-128)

Mögliche Ursachen:

• Das CTAPI Kommando ist fehlerhaft. Es wurde kein CT_Init durchgeführt und z.B. das CT-Data gesendet.

• Falsche Schnittstellen-Übertragungsgeschwindigkeit (Baudrate) eingestellt.

(Standard-Einstellungen des Rechners überprüfen: Bits pro Sec. = 9600; Datenbits = 8; Parität = keine; Stoppbits = 1; Flusssteuerung = keine;)

• Chipkartenterminal kann nicht in den MKT Mode umgeschaltet werden.

5.7.5 Antwort: Karte nicht aktiviert

Mögliche Ursachen:

• Wird die Karte im richtigen Kartenleser gesteckt?

• Karte defekt / falsche Karte / Karte falsch gesteckt

• Tastatur enthält nicht Firmware 1.19

Page 22: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

22/25

6 Supportinformationen erstellen

Treten während des Betriebs Fehler auf kann die Kommunikation mit dem Leser protokolliert werden. Wählen Sie

Start >> Programme >> Cherry eGK KVK Software >> Supportunterstützung

Aufzeichnungen >> in Datei schreiben aktivieren. Zielpfad angeben (z.B. auf dem Desktop) und „Speichern“. Beenden mit „OK“.

Bestätigen und Schließen Sie die Einstellungen mit dem Button „OK“.

Versuchen Sie nun die Karte auszulesen und den Fehler nachzustellen.

Die Datei „ctcym.log“ wird im angegebenen Zielpfad angelegt.

Nachdem der Fehler aufgetreten ist fahren Sie wie folgt fort:

Öffnen Sie erneut das Tool „Supportunterstützung“ und betätigen den Button „Erstellen“.

Page 23: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

23/25

Wählen Sie im darauf erscheinenden Dialog einen Ablageort für die verpackten Supportinformationen (Datei „ctcymsupport.zip“) und bestätigen dies mit dem Button „Speichern“.

Es werden die Cherry Konfigurationsfiles und das aufgezeichnete .log File in ein .zip Paket gespeichert. Senden Sie diese erstellte .zip Datei nach Rücksprache an den Cherry Support ([email protected]), damit eine Analyse des Fehlers durchgeführt werden kann. De-aktivieren Sie wieder im Tool „Supportunterstützung“ das Feld „in Datei schreiben“.

Page 24: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

24/25

7 Links zu Programmen, Dateien und Verzeichnissen

eGK-KVK Software: http://support.cherry.de/ >> Downloads (im Download-Bereich Ihres eHealth Produkts)

Testprogramm eGK-KVK: START >> Alle Programme >> Cherry eGK KVK Software >> Testprogramm eGK-KVK

Programmpfad: C:\Programme\Cherry\eGK_KVK_Software\Demos\ReadeGK\ConfReadeGK32.exe Die Einstellungen des Testprogrammes werden gespeichert in: %CommonAppData%\Cherry\readegk32.ini

(Win XP: C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\Cherry\readegk32.ini Win Vista, 7, 8: C:\ProgrammData\Cherry\readegk32.ini )

CT-API Konfiguration: Start >> Alle Programme >> Cherry eGK KVK Software >> CT-API Konfiguration

Programmpfad: C:\Programme\Cherry\eGK_KVK_Software\Konfigurator\ctcymconfig.exe Die Portzuordnung werden gespeichert in: %CommonAppData%\Cherry\ctapi\ctcym.xml (Win XP: C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\Cherry\CtApi\ctcym.xml Win Vista, 7, 8: C:\ProgrammData\Cherry\CtApi\ctcym.xml )

CT-API Cherry stellt mit der jeweiligen Software CT-API Dateien bereit, welche zur An- bzw. Einbindung

der Lesegeräte in die Anwendersoftware dienen. Die CT-API (Card Terminal - Application Programming Interface) ist eine standardisierte

Software-Anwendungsschnittstelle zum Zugriff auf Chipkartenterminals. Sie wurde ursprünglich im Rahmen der von Teletrust Dt. herausgegebenen MKT-Spezifikation (Multifunktionales Kartenterminal) definiert.

Standard-Installationsverzeichnis der CT-API Dateien: Windows 32 Bit: c:\windows\system32 Windows 64 Bit: c:\windows\system32 64 Bit CT-API

c:\windows\syswow64 32 Bit CT-API

Übersicht der Software-Architektur:

im heruntergeladenen Installationspaket der „eGK-KVK Software“

Page 25: eHealth lokale Installation - CHERRY · Cherry eHealth Produkte Lokale Installation 4/25 1 Abkürzungsverzeichnis AIS Arztinformationssystem BCS Basic Command Set; beschreibt Basiskommandos

Cherry eHealth Produkte Lokale Installation

25/25

auf der dem Produkt beiliegenden CD-ROM im Verzeichnis \manual

Weitere Informationen zu eHealth Produkten: http://www.cherry.de/cid/eHealth.htm

Auflistung der für Cherry eHealth Produkte freigegebenen Anwendersoftware: http://www.cherry.de/cid/eHealth_softwarezuordnung.htm

Aktuelle Version dieses Dokuments:

im heruntergeladenen Installationspaket der „eGK-KVK Software“

auf der dem Produkt beiliegenden CD-ROM im Verzeichnis \manual