Dokumentation Cherry ehealth Produkte ZF Friedrichshafen AG August 2011 CID-CSC (TS) Version 004
ZF Friedrichshafen AG Electronic Systems Cherrystrasse 91275 Auerbach/Opf. Deutschland Germany Homepage: Downloads: www.cherry.de support.cherry.de Copyright 2011, ZF Friedrichshafen AG 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. Seite 2/14
Inhaltsverzeichnis 1. Ausgangslage... 4 2. Grundsätzliches... 4 3. ehealth-bcs Terminal ST-1503 bzw. Tastatur G87-1504... 5 3.1. ST-1503 / G87-1504 am USB-Port... 5 3.1.1. Installation - Windows... 5 3.1.2. Installation - Linux... 5 3.1.3. Installationsverifikation... 6 4. MKT+ Tastatur G80-1502... 7 4.1. G80-1502 am seriellen Port... 7 4.1.1. Installation - Windows... 7 4.1.2. Installationsverifikation... 7 5. MKT+ Terminal ST-2052... 9 5.1. ST-2052 am USB-Port... 9 5.1.1. Installation - Windows... 9 5.1.2. Installation - Linux... 9 5.1.3. Installationsverifikation... 9 6. Fehlerbehebung... 11 6.1. Karte wird nicht gelesen... 11 6.2. Cherry Support... 11 7. Links zu Programmen, Dateien und Verzeichnissen... 14 Seite 3/14
1. 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. Als Anwendersoftware 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), usw. sein. Das vorliegende Dokument beschreibt die lokale Einbindung der Cherry ehealth Produkte und die Installationsverifikation. 2. Grundsätzliches Die Cherry egk/kvk Software unterstützt 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 Alle Informationen basieren auf der Cherry egk/kvk Software ab Version 3.0.x. Hinweise: - An der Windows Firewall werden für die Programme ctcymconfig.exe und readegk32.exe Ausnahmeregeln erstellt. - Bitte beachten Sie die Hinweise im Kapitel 7 Links zu Programmen, Dateien und Verzeichnissen auf Seite 14. Seite 4/14
3. ehealth-bcs Terminal ST-1503 bzw. Tastatur G87-1504 3.1. ST-1503 / G87-1504 am USB-Port Das Cherry "ehealth-bcs Terminal ST-1503" und die "ehealth-bcs Tastatur G87-1504" werden vom Betriebssystem lokal als HID Gerät erkannt. Als ehealth BCS-Geräte werden sie über die Cherry CT-API Dateien ctcym.dll (32 Bit) bzw. ctcym64.dll (64 Bit) angesprochen. 3.1.1. Installation - Windows Laden Sie die egk/kvk Software herunter (http://support.cherry.de/) oder verwenden Sie die dem Produkt beiliegenden CD. Installieren Sie die Software und schließen Sie das Produkt an einer USB Schnittstelle an. Ist nur ein Lesegerät angeschlossen, muss keine Konfiguration vorgenommen werden. Die Zuweisung von Ports ist nur beim Betrieb von mehreren Produkten an einem Rechner notwendig. Diese Portzuordnung kann mit dem Programm CT-API Konfiguration erfolgen (Start > Alle Programme > Cherry egk KVK Software > CT-API Konfiguration) Die Verwaltung der Geräte hinsichtlich der zugewiesenen Port-Nummern obliegt der Anwendersoftware. 3.1.2. Installation - Linux Laden Sie das LINUX CT-API Paket herunter (http://support.cherry.de/). Zur Installation beachten sie bitte die readme Dateien in der heruntergeladenen Software. Ist nur ein Lesegerät angeschlossen, muss keine Konfiguration vorgenommen werden. Die Zuweisung von Ports ist nur beim Betrieb von mehreren Produkten an einem Rechner notwendig. Die Verwaltung der Geräte hinsichtlich der zugewiesenen Port-Nummern obliegt der Anwendersoftware. Seite 5/14
3.1.3. Installationsverifikation Starten Sie das Testprogramm egk/kvk" (s. Bild). (START > Alle Programme > Cherry egk KVK Software > Testprogramm egk/kvk). Markieren Sie darin unter Gerät auswählen den Eintrag ST-1503 / G87-1504. Die Port-Nummer muss identisch sein zu der in der lokalen CT-API Konfiguration. 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. Seite 6/14
4. MKT+ Tastatur G80-1502 Zur Verarbeitung der elektronischen Gesundheitskarte (egk) ist der Chipkartenleser der MKT+ Tastatur G80-1502 über die serielle Schnittstelle (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) befinden und mind. den Indexstand /09 aufweisen. Dies entspricht der Firmware Version 1.19. 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/ > Software- & Treiberdownload ). 4.1. G80-1502 am seriellen Port Das Chipkartenterminal der MKT+ Tastatur G80-1502 wird über die CT-API Datei "ct_api.dll" angesprochen. 4.1.1. Installation - Windows Laden Sie die egk/kvk Software herunter (http://support.cherry.de/) oder verwenden Sie die dem Produkt beiliegenden CD. Installieren Sie die Software und schließen Sie das Produkt an einer seriellen (COM) Schnittstelle an. Es ist eine Portzuordnung vorzunehmen! 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 Verwaltung der Geräte hinsichtlich der zugewiesenen Port-Nummern obliegt der Anwendersoftware. 4.1.2. 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 G80-1502. Seite 7/14
Die Port-Nummer muss identisch sein zu der in der lokalen CT-API Konfiguration. Klicken Sie auf Einstellungen testen. Stecken Sie eine Karte in das Chipkartenterminal und klicken Sie auf Karte lesen. Seite 8/14
5. MKT+ Terminal ST-2052 Das Cherry "MKT+ Terminal ST-2052" arbeitet nach dem sog. PC/SC Standard, d.h. 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. 5.1. ST-2052 am USB-Port Als MKT+ Terminal wird das Gerät über die Cherry CT-API Datei ctpcsc32kv.dll angesprochen. 5.1.1. Installation - Windows Laden Sie die egk/kvk Software herunter (http://support.cherry.de/) oder verwenden Sie die dem Produkt beiliegenden CD. Installieren Sie die Software und schließen Sie das Produkt an einer USB Schnittstelle an. 5.1.2. Installation - Linux Laden Sie für den Client die Software CCID Treiber mit CT-API herunter (http://support.cherry.de/). Zur Installation beachten sie bitte die readme Dateien in der heruntergeladenen Software. Es ist zwingend erforderlich dem ersten ST-2052 am Client die Portnummer 1 zuzuweisen. Die Verwaltung der Geräte hinsichtlich der zugewiesenen Port-Nummern obliegt der Anwendersoftware. 5.1.3. 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. Seite 9/14
Klicken Sie auf Einstellungen testen. Stecken Sie eine Karte in das Chipkartenterminal und klicken Sie auf Karte lesen. Seite 10/14
6. Fehlerbehebung 6.1. Karte wird nicht gelesen Lösungsvorschläge: Überprüfen Sie, ob Sie mit Administrator-Rechten angemeldet sind. Überprüfen Sie an jedem System 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 der Software. Entfernen Sie die Einträge in der CT-API Konfiguration. Lesen Sie die Geräte durch Aktualisieren neu ein und ordnen Sie die entsprechenden Ports erneut zu. Suchen Sie nach der für das Gerät verwendeten CT-API Datei. Sie sollte jeweils nur ein einziges Mal vorliegen. Im Fall, dass auf dem System mehrere Dateien gleichen Namens 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 Austausch der älteren Version gegen die neuere Datei Abhilfe bringt. 6.2. Cherry Support Für die Unterstützung durch Cherry werden folgende Angaben benötigt: Kundendaten Cherry Kunden-Nr.:. Firma:. Vorname, Nachname:. Straße, Hausnummer:. PLZ, Ort:. E-Mail:. Telefon:. Fax:. Ich bin: Endkunde Händler / Wiederverkäufer Distributor Seite 11/14
Durch folgendes Vorgehen können Sie die Aufzeichnung der Kommunikation mit dem jeweiligen Cherry Produkt aktivieren. Aufzeichnung der Kommunikation aktivieren: 1. Starten Sie das Programm Supportunterstützung (s. Bild): Start > Alle Programme > Cherry egk KVK Software > Supportunterstützung 2. Aktivieren Sie unter Aufzeichnungen > "in Datei schreiben" und geben Sie dazu einen entsprechenden Zielpfad an (z.b. auf dem Desktop). Beenden Sie mit Speichern. 3. Versuchen Sie die Karte auszulesen und den Fehler zu generieren. 4. Die Datei ctcym.log wird im angegebenen Zielpfad angelegt. 5. Klicken Sie unter Supportinformationen auf Erstellen. Dadurch wird eine Datei ctcymsupport.zip erzeugt (diese beinhaltet u.a. auch die o.g. ctcym.log ). 6. Bitte legen Sie die Datei ctcymsupport.zip diesem ausgefüllten Fragebogen bei. Produktdaten Modell-Nr. (M/N):. (z.b. G1504) Artikel-Nr. (P/N):. (z.b. G87-1504LAZDE-10 /02) Serien-Nr. (S/N):. (z.b. G 001234 1A20) Das Produkt wird betrieben an: USB LAN - die IP Adresse des Terminals wird automatisch vergeben (DHCP) wurde fest eingestellt (manuell) PS/2 seriellem Port es wird folgender Anschluss verwendet: COM 1 COM 2 COM 3 COM 4 Seite 12/14
Fehlerbeschreibung Detaillierte Fehlerbeschreibung (was passiert wann):... Es erscheint folgende Meldung auf dem Bildschirm des Rechners (evtl. Bildschirm-Ausdruck beifügen):.. auf dem Display des Gerätes (bei Produkten mit Display):.. Lokaler Rechner : Betriebssystem:. 32 Bit 64 Bit Service Pack:. Cherry Software:. Version:. (START > Alle Programme > Cherry... > Setup : die blaue Überschrift des Setup-Fensters zeigt Edition & Version) Eingesetzte Ärzte-/KIS-SW: Hersteller, Name, Version:. Es liegt eine Freigabe des Herstellers für das eingesetzte Cherry Produkt vor Wann tritt der Fehler auf? bei Erst-Inbetriebnahme nach kurzem Betrieb (< 1 Woche) Sonstiges:. nach längerem Betrieb (> 1 Woche) Wie oft tritt der Fehler auf? immer häufig (> 1x täglich) selten (< 1x täglich) Sonstiges:. Bitte senden Sie diesen Fragebogen und die erzeugte(n) Datei(en) per e-mail an support@cherry.de Seite 13/14
7. Links zu Programmen, Dateien und Verzeichnissen egk/kvk Software: http://support.cherry.de/ (im Download-Bereich Ihres ehealth Produkts) Testprogramm egk/kvk: START > Alle Programme > Cherry egk KVK Software > Testprogramm egk/kvk CT-API Konfiguration: Start > Alle Programme > Cherry egk KVK Software > CT-API Konfiguration (nicht vorhanden bei Installation des SmartTerminal ST-2052) Programmpfad: C:\Programme\Cherry\eGK_KVK_Software\Konfigurator\ctcymconfig.exe Die Portzuordnung werden gespeichert in: %Common AppData%\Cherry\ctapi\ctcym.xml (C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\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\syswow64 Windows 64 Bit: c:\windows\system32 Übersicht der Software-Architektur: - im heruntergeladenen Installationspaket der egk/kvk Software - auf der dem Produkt beiliegenden CD-ROM im Verzeichnis \info Weitere Informationen zu ehealth Produkten: http://www.cherry.de/deutsch/produkte/ehealth.htm Auflistung der für Cherry ehealth Produkte freigegebenen Anwendersoftware: http://www.cherry.de/deutsch/produkte/ehealth_softwarezuordnung.htm Aktuelle Version dieses Dokuments: - im heruntergeladenen Installationspaket der egk/kvk Software - auf der dem Produkt beiliegenden CD-ROM im Verzeichnis \manual Seite 14/14