App EVIS ID für Google Android NFC- Smartphone

Transkript

1 App EVIS ID für Google Android NFC- Smartphone Version 1.1 Beschreibung Mai 2015

2 EVIS AG, CH-8604 Volketswil Änderungen vorbehalten Bei der Erarbeitung dieser Dokumentation wurde mit grösster Sorgfalt vorgegangen. Trotzdem können Fehler nicht vollständig ausgeschlossen werden. Die Firma EVIS AG kann für fehlerhafte Angaben und deren Folgen weder die Verantwortung noch irgendeine Haftung übernehmen. Sollte in dieser Dokumentation auf andere Dokumentationen, Vorschriften oder Richtlinien Bezug genommen oder aus ihnen zitiert worden sein, kann die Firma EVIS AG keine Gewähr für Richtigkeit, Vollständigkeit oder Aktualität übernehmen. Alle Rechte vorbehalten. Kein Teil dieser Dokumentation darf in irgendeiner Form (Druck, Fotokopie oder einem anderen Verfahren) ohne schriftliche Genehmigung der EVIS AG reproduziert an Dritte weitergegeben oder unter Verwendung elektronischer Systeme verarbeitet, vervielfältigt oder verbreitet werden. Für Verbesserungsvorschläge und Hinweise auf Fehler ist der Herausgeber (EVIS AG) dankbar. EVIS AG, 8604 Volketswil jg, /13

3 Versionsübersicht Version Erstellt, Wer Gilt ab FW Änderung gegenüber letzter Version 1.0 Nov 2014, jg 20031A F Mai 2015, jg 20031A F01 Erste Version mit allgemeinen Leserinformationen, letzte Aktionen und letzte Fehler Hinzugefügt: Zurück- und Teilen-Button Korrekturen: Anzeige Aktionen, Smartphone ID Erweitert: Infos zu Smartphone Inhaltsverzeichnis 1 Allgemein Voraussetzungen Smartphone Leser Installation APP auf Smartphone bringen APP installieren Handhabung Smartphone und NFC NFC einschalten Ideale Position des Smartphone Touch to Beam Bedienung Hauptansicht Menu Leserdaten Praxis EVIS AG, 8604 Volketswil jg, /13

4 1 Allgemein Software Bezeichnung: App EVIS ID Software Nummer: 5035 Die App EVIS ID wird in diesem Dokument kurz als App und das Smartphone Betriebssystem wird als OS bezeichnet. Mit der App können am EVIS Leser allgemeine Leser-Informationen ausgelesen werden. Als Kommunikations-Schnittstelle zwischen Smartphone und Leser wird die bestehende NFC-Schnittstelle zwischen Leser und Datenträger benutzt. Das Smartphone kann somit einfach, wie ein Datenträger, an den Leser gehalten werden. Die Leserdaten werden direkt an das Smartphone übertragen. Alle Installations-Abläufe und Screenshots wurden mit dem Smartphone Samsung Galaxy S3 OS Version 4.3 gemacht. Je nach Smartphone und OS können die Darstellungen und Abläufe abweichend sein. So sind z.b. Einstellungen an einem anderen Ort zu finden. 2 Voraussetzungen In diesem Kapitel sind die Voraussetzungen für den EVIS Leser und das Smartphone definiert. 2.1 Smartphone Die App funktioniert nur auf bestimmten Smartphones mit Betriebssystem Android von Google. Grundvoraussetzung ist eine NFC Schnittstelle. Die NFC Kommunikation hängt von mehreren Faktoren ab wie dem im Smartphone verbauten NFC Chip, der Antenne, den verwendeten Protokolle, etc. Ob das Smartphone für den Einsatz geeignet ist muss schlussendlich getestet werden. Im schlimmsten Fall kann es sein, dass nach einem Update des OS die NFC Kommunikation mit dem Leser nicht mehr funktioniert. Voraussetzungen Smartphone OS: Google Android OS Version: ab 4.1 Ice Cream Sandwich (API16) Lokale Verbindung: Near Field Communication (NFC) Liste der getesteten Smartphone Hersteller Typ OS Version Samsung Nexus S Samsung Galaxy S / 4.3 Samsung Note Samsung Galaxy S4 4.3 Samsung Galaxy S HTC One X Hinweis: Über Rückmeldungen zu Smartphones, welche nicht auf dieser Liste stehen, sind wir Ihnen sehr dankbar. In der Ansicht Info können Sie einfach die Infos zu Ihrem Smartphone an EVIS mailen. 2.2 Leser Voraussetzungen sind ein EVIS Leser der 3. Generation mit einem LEGIC-Chip advant der SM4000 Serie. Unterstützt werden EVIS Leser mit der Firmware Verkauf, 3rdParty und ZeitZutritt. Voraussetzungen EVIS Leser Firmware Version: ab FW Verkauf 20031A01, FW 3rdParty und FW ZeitZutritt 20050F01 kann je nach Version der App unterschiedlich sein, siehe Versionsübersicht LEGIC Schnittstelle: LEGIC-Chip advant SM4000-Serie LEGIC OS: ab Version EVIS AG, 8604 Volketswil jg, /13

5 3 Installation Die App wird von EVIS als APK-Datei (Android package) ausgeliefert. Dateiname bei der Version 1.1: EVIS_ID_V1_1.apk Die Installation besteht aus zwei Teilen: APK-Datei auf Smartphone bringen APK-Datei installieren 3.1 APP auf Smartphone bringen Als erstes muss die APK auf das Smartphone gebracht werden. Die APK kann direkt auf das Smartphone heruntergeladen werden, in dem man mit dem Smartphone auf die EVIS-Homepage geht und sich die APK direkt auf das Smartphone runter lädt. Oder man lädt sich die APK zuerst auf den PC. Danach kann man sich die APK als Anhang auf das Smartphone mailen. Oder man kopiert sich die APK vom PC auf das Smartphone z.b. via USB-Kabel. APK direkt von EVIS-Homepage herunterladen Die APK wird direkt mit dem Smartphone von der EVIS Homepage heruntergeladen. Die heruntergeladene APK kann danach direkt installiert werden. Mit antippen der APK Datei wird die Installation gestartet. APK per auf Smartphone versenden Die im angehängte APK kann direkt installiert werden. Mit antippen der APK-Datei im Anhang wird die Installation gestartet. APK auf Smartphone kopieren Im Smartphone mit einem Datei-Explorer auf die vom PC kopierte APK navigieren. Danach kann die APK installiert werden. Mit antippen der APK Datei wird die Installation gestartet. Direkt von EVIS-Homepage Per Anhang Mit Datei-Explorer EVIS AG, 8604 Volketswil jg, /13

6 3.2 APP installieren Nach dem Antippen der APK-Datei wird der Android Paket-Installer gestartet, welcher die App installiert. Da die App nicht vom Google Play Store kommt, wird die Installation als unbekannte Quelle blockiert. In den Einstellungen muss die Installation von unbekannten Quellen zugelassen sein bzw. während der Installation temporär zugelassen werden. Für die Installation der App müssen unbekannte Quellen zugelassen werden. Die App benötigt den Zugriff auf die NFC-Steuerung und Standby-Modus. EVIS AG, 8604 Volketswil jg, /13

7 4 Handhabung Smartphone und NFC In diesem Kapitel wird der Umgang mit der NFC-Datenschnittstelle beschrieben. 4.1 NFC einschalten Damit die App mit dem EVIS Leser kommunizieren kann, muss die NFC Funktion im Smartphone eingeschaltet sein. Wenn die Funktion Android Beam vorhanden ist (je nach OS), so muss auch diese Funktion eingeschaltet sein. Hinweis: Die Ansicht Info zeigt den Status von NFC und Android Beam. Der NFC-Stromverbrauch ist gering. Die Funktion kann generell immer eingeschaltet bleiben. NFC einschalten Android Beam einschalten 4.2 Ideale Position des Smartphone Das Smartphone ist wie ein Datenträger. Wie der Datenträger wird auch das Smartphone direkt auf den EVIS Leser gehalten. Je nach Smartphone (Grösse und Position der Antenne im Smartphone) unterscheidet sich die ideale Position des Smartphones auf dem Leser. Bei kleineren Smartphones kann es auch sein, dass das Smartphone erst vom Leser erkannt wird, wenn es sich unmittelbar auf dem Leser befindet. Achtung: Schutzhüllen können dazu führen, dass die NFC Funktion beeinträchtigt ist. Ideale Position des Smartphone finden Voraussetzung: Die NFC-Funktion / Beam ist im Smartphone eingeschaltet. Smartphone einschalten und entsperren. Smartphone mit der Rückseite an den Leser halten. Sobald der Leser das Smartphone erkennt vibriert das Smartphone. Das Smartphone in unterschiedlichen Positionen auf den Leser halten und wieder wegnehmen um somit die ideale Position zu finden. Beispielsweise könnte eine ideale Position sein, wenn die Oberkante des Smartphone mit der Oberkante des Lesers bündig ist. Bei kleineren Smartphones ist es vielleicht auch sinnvoll das Smartphone quer auf den Leser zu halten um möglichst nahe am Leser zu sein (oberhalb Kartenhalterung). EVIS AG, 8604 Volketswil jg, /13

8 Hinweis: Wenn das Smartphone vom Leser entfernt werden soll, muss es für mindestens 3 Sekunden komplett aus dem Feld entfernt werden (Abstand Leser zu Smartphone >10cm). Nur so wird es danach wieder neu erkannt. 4.3 Touch to Beam Diese Funktion dient dazu zu vermeiden, dass unbemerkt Daten vom Smartphone gesendet werden. Die generelle Datenübertragung zwischen Smartphone und Leser funktioniert wie folgt: Das Smartphone sendet eine Nachricht an den Leser und der Leser sendet daraufhin eine Antwort an das Smartphone. Das Senden einer Nachricht vom Smartphone muss aus Sicherheitsgründen aktiv ausgelöst werden. Diesen Vorgang nennt man Touch to Beam. Ablauf Touch to Beam Voraussetzung: App ist bereit zum Senden einer Nachricht und NFC / Beam Funktion ist im Smartphone eingeschaltet. Das Smartphone auf den Leser halten Das Smartphone löst die Anfrage nach Touch to Beam aus. Das hell dargestellte Bild zoomt zurück (sobald der Leser das Smartphone erkannt und selektiert hat). Mit dem Berühren des Bildschirms, Touch to Beam, wird das Senden jetzt ausgelöst Der Leser empfängt die Nachricht und gibt Antwort Die App reagiert auf Antwort und zeigt dies auf dem Display an Smartphone vom Leser wegnehmen App ist bereit zum Senden Verbindung zum Leser steht App empfängt Antwort vom Leser =>Senden jetzt aktiv auslösen und reagiert entsprechend EVIS AG, 8604 Volketswil jg, /13

9 5 Bedienung Die App startet mit der Hauptansicht. Die Hauptansicht hat zwei Zustände: Die App ist nicht mit dem Leser synchronisiert oder die App ist mit dem Leser synchronisiert. Wenn die App synchronisiert ist können die Leserdaten angezeigt werden. Die Leserdaten werden mittels Taste "Leserinfo" in einer eigenen Ansicht angezeigt. In der Hauptansicht sind zudem die Menu-Funktionen aufrufbar. 5.1 Hauptansicht Die App ist nach dem Starten bereit zur Synchronisation. Als Synchronisation wird der erste Datenaustausch zwischen Smartphone und Leser bezeichnet. Nach diesem Datenaustausch ist das Smartphone mit dem Leser synchronisiert und es können die allgemeinen Leserdaten angezeigt werden. App synchronisieren Voraussetzung: App ist gestartet und NFC/Beam Funktionen sind im Smartphone eingeschaltet Smartphone auf Leser halten und Datenübertragung auslösen (Touch to Beam) Warten bis Antwort vom Leser empfangen wurde Smartphone von Leser wegnehmen App starten App ist nicht synchronisiert App ist synchronisiert EVIS AG, 8604 Volketswil jg, /13

10 5.2 Menu Je nach Smartphone können die Menu-Funktionen direkt in der Action Bar der Ansicht bzw. über den Auswahl-Button oder den Geräte Auswahl-Button erreicht werden. Menu in der Hauptansicht Reset Versetzt die App wieder in den nicht synchronisierten Zustand. Die App ist wieder bereit für den Datenaustausch mit dem Leser. Einstellungen Öffnet die Ansicht Einstellungen. Hier können App Einstellungen vorgenommen werden wie die Lautstärke, direktes Anzeigen der Leserdaten nach der Synchronisation. Info Öffnet die Ansicht Info. Zeigt die ID des Smartphone, Informationen zum Smartphone und Status von NFC / Android Beam an. Es werden zudem allgemeine Informationen über die App und deren Version angezeigt. Logbuch Öffnet die Ansicht Logbuch (sofern vorhanden). Zeigt ein kleines Logbuch, welches die ausgeführten Aktionen auflistet. Das Logbuch wird bei jedem Starten der App neu erstellt (wird nicht abgespeichert). Menu in den Ansichten Zurück-Button Der Zurück-Button in der Action Bar einer Ansicht führt wieder zurück in die Hauptansicht. Teilen-Button Mit dem Teilen-Button in der Action Bar einer Ansicht kann der Inhalt der Ansicht und eventuell dazugehörige Dateien weitergeleitet werden. Zum Beispiel können so die Daten per versendet werden. EVIS AG, 8604 Volketswil jg, /13

11 6 Leserdaten Die Leserdaten bestehen aus allgemeinen Leserdaten, letzten Aktionen und letzten Fehlern. Die Ansicht ist entsprechend in drei Reiter unterteilt. Je nach Firmware werden nicht alle Daten unterstützt, siehe untenstehende Tabelle. Firmware ab Version Allgemeine Aktionen Fehler Leserdaten Verkauf 20031A01 Ja Ja Ja 3rdparty Ja Nein Nein (ohne Uhrzeit) ZeitZutritt 20050F01 Ja (ohne Uhrzeit) Nein Ja (ohne Uhrzeit) Hinweis Teilen: Die Ansicht kann als Textdatei (Leserdaten.txt) geteilt werden Hinweis Autorisierung: Normalerweise wird keine Autorisierung zum Anzeigen der Leserdaten benötigt. Sollte dies aber der Fall sein, so wird nur die Hardware- und Firmware-Nr angezeigt. Allgemeine Leserdaten Wert Hardware-Nr Firmware-Nr Geräte Disti Geräte Firma Gerät Datum Zeit Bemerkung Eindeutige Hardwarenummer des Lesers Die Firmware des Lesers z.b A01 Die Distributoren Nummer des Lesers Die Firmen Nummer des Lesers Die Leser Nummer Datum und Zeit des Lesers sofern vorhanden Bei Firmware Verkauf kann auch vom Automaten / INCA übernommen sein Aktionen Zeigt die letzten (max. 20) Aktionen an, sofern die Firmware dies unterstützt. Entspricht den Aktionen im Servicetool. Wert Datum Zeit Aktion Bedeutung Betrag Differenz Wahl ID Bemerkung Zeitpunkt in der der Fehler ausgelöst wurde sofern Uhrzeit im Leser vorhanden ist Die Aktionsnummer und die Beschreibung Startbetrag sofern Aktion mit Datenträger Abgezogener bzw. aufgeladener Betrag sofern Aktion mit Datenträger Wahlnummer des Automaten / Geldquelle sofern Aktion mit Datenträger Datenträgernummer sofern Aktion mit Datenträger Fehler Zeigt die letzten (max. 20) Fehler an, sofern die Firmware dies unterstützt. Entspricht den Fehlern im Servicetool. Wert Datum Zeit Fehler ID Bemerkung Zeitpunkt in der der Fehler ausgelöst wurde sofern Uhrzeit im Leser vorhanden ist Die Fehlernummer (Beschreibung siehe Doku Firmware Beschreibung Verkaufsautomaten und Ladestation) Datenträgernummer sofern Fehler mit Datenträger EVIS AG, 8604 Volketswil jg, /13

12 Die Ansicht Leserinformationen ist in drei Reiter unterteilt. Untenstehende Screenshot's zeigen eine Auslesung mit einem Verkaufsleser mit Uhrzeit, Aktionen und Fehler. Allgemeine Informationen Die letzten Aktionen Die letzten Fehler Hinweis: Bei dem Reiter Aktionen und Fehler können zum Teil horizontal/vertikal nicht alle Informationen auf einmal im Display angezeigt werden. Ist dies der Fall, so kann die Ansicht entsprechend verschoben werden (scrollen). Es kann auch sinnvoll sein das Smartphone quer zu stellen. Dadurch wechselt die Anzeige in das Querformat. Im Querformat können mehr Spalten angezeigt werden, während im Hochformat mehr Zeilen angezeigt werden. EVIS AG, 8604 Volketswil jg, /13

13 7 Praxis In diesem Kapitel werden Themen aus der Praxis beschrieben Probleme mit Datenübertragung zu Leser Fehler: Touch to Beam wird nicht ausgelöst, Datenübertragung bricht ab. Der Leser erkennt das Smartphone erst wieder nach einer gewissen Zeit (bis 3Sekunden). Darauf achten dass das Smartphone immer komplett aus dem Leser-Antennenfeld genommen wird (Abstand Leser zu Smartphone >10cm). Mindestens 3 Sekunden warten bis zum nächsten Hinhalten des Smartphone. Das Smartphone immer auf die ideale Leser-Position halten. Nach dem Auslösen der Datenübertragung (Touch to Beam) das Smartphone nicht mehr bewegen bis die Datenübertragung beendet ist. Smartphone mit den Händen auf der idealen Leser-Position fixieren. Datenübertragung zu Leser funktioniert nicht mehr Fehler: Wenn das Smartphone auf den Leser gehalten wird reagiert das Smartphone nicht. Es wird kein Touch to Beam ausgelöst, Smartphone vibriert nicht. In seltenen Fällen kann sich die NFC-Funktion im Smartphone "verklemmen". In diesem Fall muss die NFC- Funktion neu gestartet werden. Eventuell genügt bereits ein Ein-/Ausschalten der NFC-Funktion, falls nicht muss das Smartphone neu gestartet werden. NFC-Funktion ausschalten danach NFC-Funktion und Beam-Funktion wieder einschalten Smartphone neu starten (Powertaste drücken und halten bis Auswahl Neustart erscheint) EVIS AG, 8604 Volketswil jg, /13