Nayax - Pulse. User Manual Nayax - Pulse. Product Versie: 7.6 Version van deze handleiding: Inepro B.V. Alle rechten voorbehouden

Transcriptie

1 Nayax - Pulse User Manual Nayax - Pulse Product Versie: 7.6 Version van deze handleiding: Inepro B.V. Alle rechten voorbehouden

2

3 Nayax - Pulse Documentbeheer Versie Auteur Datum 1.0 Denis Fogel Rafael Dazal Alon Shteken Rafael Dazal Rafael Dazal Rafael Dazal Idan Blech Beschrijving Eerste Uitgave Toevoeging meervoudige prijs-pulsmodus en Amit 3.0 verschllen + formatting Functionaliteit optellen - Veranderingen op FW ter verbetering van pulsbetrouwbaarheid in HW Tijd puls actief: Nieuwe opmerkingen - Tijd puls inactief: Opmerking zelfpuls - Apparaat mist pulsen - Puls voor aflezen DEX - 2 parameters per puls - Transactie time-out voor meervoudige prijs-pulsmodus - Nieuw koopproces voor combo-machines - Puls feedback Doel Het doel van het document is het beschrijven van Nayax apparaatconfiguratie voor en verschillende gedragsmodi in pulsmodus.

4 Nayax - Pulse Alle rechten voorbehouden. Niets van deze uitgave mag verveelvoudigd, opgeslagen in een geautomatiseerd gegevensbestand, of openbaargemaakt, in enige vorm of op enige wijze, hetzij elektronisch, mechanisch, door fotokopieën, opnamen of op enige andere manier, zonder schriftelijke toestemming van de uitgever. Produkten waarnaar verwezen wordt in dit document kunnen handelsmerken zijn van hun eigenaars. De uitgever en autheur maken geen aanspraak op deze handelsmerken. Hoewel de grootst mogelijke zorg is besteed aan de samenstelling van dit document kan de uitgever geen aansprakelijkheid aanvaarden voor de schade die het gevolg is van fouten, nalatigheid of verandering in details van deze uitgave of de programma's en broncodes die er eventueel worden bijgeleverd, en voor de gevolgen van het afgaan op verkeerde informatie. Versie geproduceerd: May 2016 in Nieuw-Vennep, Nederland Uitgever Inepro B.V. Hoofdredacteur K. de Graaf Technische samenstelling Denis Fogel Rafael Dazal Alon Shteken Idan Blech Koos de Graaf Cover Ontwerp H. Wagenaar K. de Graaf Team Coördinator R. Groen Productie Inepro B.V.

5 Inhoudsopgave 2 Functunaliteit... van pulsparameters 2 1 Instellen... verbodswaarden: 3 2 Mogelijke koopproces voor combo-machines 3 3 Nieuw Meervoudige prijs-pulsmodus Optelmodus Nieuw pulsalgoritme Puls voor aflezen DEX Hoe werkt puls Fysieke installatie op de machine en HW rev (Amit 3.0) 21 2 HW rev. 24 HW puls-interface a 24 1 HW rev HW rev (Amit 3.0) 25 3 HW rev. 28 HW Inhibit-interface en deur open (indien relevant voor puls) a 28 1 HW rev HW rev (Amit 3.0) 29 3 HW rev. 32 Troubleshooting Apparaat... leest onjuiste pulsinvoer na elke pulsaankoop Apparaat... leest random valse pulsen Apparaat... mist pulsen Pulsfeedback... Version XXXXX - SOURCE NIET PRINTEN - XXXX

6

7 Functunaliteit I Deel

8 Functunaliteit Instellen van pulsparameters De volgende parameters kunnen worden ingesteld voor het configureren van de pulsfunctionaliteit van Nayax. Functie Omschrijving Credit per Pulse 1 0: Voor vrije uitgifte (vend)). Overige waarden: Het in rekening gebracht bedrag per gegeven puls. Credit per Pulse 2 Inhibit Event Timeout (sec) Number of Pulses per Vend 1 Standaard waarde 0 0 Tijd in seconden waarna de server een waarschuwing krijgt dat de unit is geblokkeerd door de VMC Number of Pulses per Vend 2 0: Puls uitgeschakeld Overige waarden: Aantal pulsen dat aan VMC wordt gestuurd na goedkeuring uitgifte. Post Delay in sec Aantal seconden wachten na pulstransactie voordat een andere pulstransactie wordt toegestaan. <LEEG> Pulse Active time in 10ms Tijd waarmee de unit de pulslijn kortsluit naar de aarde (zie diagram 18 in 'Hoe werkt puls?'). In 'Nieuw pulsalgoritme' 14, wordt deze parameter ook gebruikt voor het instellen van pulsfilters 14.? De unit kan pulsen detecteren (op dezelfde pulsdraad) die afkomstig zijn van andere betaalapparaten, bijv. muntmechanismen. Is deze parameter > 0, dan stuurt de unit een Pulse Cash Report naar de server elke keer wanneer de teller hetzelfde aantal pulsen telt als waarop de parameter is ingesteld. Pulse IN 1 Counter 0 0 0: Geen Pulse Cash Reports Overige waarden: Aantal pulsen waarna een Pulse Cash Report wordt gestuurd. De gerapporteerde prijs = Pulse IN1 Counter * Credit per Pulse 1. Pulse IN 2 Counter 0 Om te voorkomen dat apparaten hun eigen pulsen lezen als invoer, moet de configuratie van de Pulse inactive time worden gecontroleerd. Pulse inactive time in 10ms Pulse Inhibit Bepaalt hoe lang een puls inactief moet zijn, voordat de volgende puls kan worden verzonden (zie diagram 18 in volgende paragraaf). Het bepaalt ook hoe lang moet worden gewacht, voordat een puls kan worden gelezen nadat pulsen zijn verzonden. Dit is om te voorkomen dan een apparaat de eigen puls als invoer leest. VMC gebruikt deze lijn om aan te geven dat momenteel geen tegoed kan worden ontvangen. Zodra het blokkeersignaal wordt gedetecteerd, kan de unit geen kaarten accepteren, wordt er geen tegoed afgenomen en worden er geen pulsen afgegeven door de unit.? 00 00: Inhibit Diabled (Nayax ignores inhibit) Er wordt niet gelet op het blokkeersignaal. Overige waarden: Deze lijn wordt gebruikt voor het blokkeersignaal. 2 - Nayax - Pulse

9 Mogelijke verbodswaarden: Mogelijke verbodswaarden: 0 of 2 - verbodsfunctie uitgeschakeld (Nayax negeert verbod) 3de unit komt in de verbodsstatus (accepteert geen creditcards) indien de VMC een HOOG voltage geeft aan de verbodslijn. 1de unit komt in de verbodsstatus (accepteert geen creditcards) indien de VMC een LAAG voltage geeft aan de verbodslijn. 5 activeer extern MDB-tegoed (puls op pulse IN1 start gratis MDB-transactie) 9 schakel externe Surevend Sensor in voor MDB Nieuw koopproces voor combo-machines Vanaf FW en voor HW revisie Amit 3.0 is er een nieuw koopproces ingevoerd. Er is een nieuw mechanisme ontwikkeld waarmee de gebruiker het gewenste product kan selecteren op dezelfde manier als in MDB-machines: 1. Kaart door de kaartlezer halen 2. Vragen om het gewenste product te selecteren 3. Product selecteren door op een knop te drukken De keuzeknoppen zijn verbonden met de invoer voor "Door open" (verbonden met de aarde op het juiste moment geeft een puls op puls 1) op de MDB-connector (J6-pin6) en met de invoer voor MCR_DT2/PROXY_RXD (verbinding met de aarde op het juiste moment geeft een puls op puls 2) op de pulsconnector (J8-pin8). Beide typen invoer worden intern opgehaald. Version

10

11 Meervoudige prijs-pulsmodus II Deel

12 Meervoudige prijs-pulsmodus Meervoudige prijs-pulsmodus Vanaf FW en alleen voor HW revisies 2.5 en Amit 3.0 is er een nieuwe functionaliteit toegevoegd aan pulsapparaten: selectie meervoudige prijs. In deze modus kan de gebruiker uit een lijst prijzen selecteren die hij wil betalen. Voor elke prijs stuurt het Nayax-apparaat een ander aantal pulsen naar de VMC. Er zijn twee verschillende modi voor meervoudige prijs: lineaire prijstoeslag en prijslijst. Deze worden kort toegelicht. Voor de modus meervoudige prijs zijn de volgende parameters van belang: Increment Source Om de prijs in het apparaat te veranderen, moet er een knop worden ingedrukt. Deze parameter bepaalt via welke knop de prijsverandering wordt doorgevoerd. Mogelijke waarden: Door Open gebruikt de lijn voor open deur als besturingsknop (sluit kort tussen lijnen voor open deur een aarde om aan te geven dat er op de knop is gedrukt) Annuleringsknop voor externe lezer Als de Transaction Timeout niet 0 is, dan is deze waarde een time-out (in seconden) tot de prijs weer is teruggezet op de oorspronkelijke waarde (index 0 of Min. pulses per vend x Credit per Pulse). Min. Pulses per Vend Alleen van toepassing bij lineaire prijstoeslag: het minimale aantal pulsen per uitgegeven waarde. Number of increments Alleen van toepassing bij lineaire prijstoeslag: hoeveel opslagen zijn toegestaan op het aantal pulsen per uitgifte. Deze waarde mag niet hoger zijn Nayax - Pulse

13 Pulse Increment Deze parameter bepaalt de modus van de meervoudige prijs. Indien 0 of leeg, dan is de modus voor meervoudige prijs helemaal uitgeschakeld. Indien ingesteld op een enkele waarde, dan werkt de meervoudige prijs in de modus voor lineaire prijstoeslag. Met elke druk op de knop wordt er een aantal pulsen aan de hoeveelheid van deze parameter toegevoegd. Indien ingesteld op een aantal waarden gescheiden door komma's (bijv. 8,20,40,80), dan is de modus prijslijst geselecteerd. Met elke druk op de knop selecteert het apparaat de volgende "pulse per vend" in de lijst. In het voorbeeld: bij $0,25 Credit per Pulse kan de gebruiker 8, 20, 40 of 80 pulsen per uitgifte selecteren, wat overeenkomt met $2, $5, $10 of $20. In elke modus ligt de grens voor puls per uitgifte op 255. De prijslijst biedt plaats aan 6 verschillende prijzen. Lineaire prijstoeslag is beperkt tot maximaal 255 pulsen per uitgifte. Version

14

15 Optelmodus III Deel

16 Optelmodus Optelmodus Vanaf FW en voor HW revisies 2.5 en Amit 3.0 is er een nieuwe functionaliteit toegevoegd aan pulsapparaten: Functionaliteit optellen. Telmachines zijn bestemd voor langdurige bewerkingen, zoals door wasmachines en wasdrogers. De gebruiker haalde een kaart door de lezer, er wordt een configureerbaar maximumbedrag van de kaart afgehaald en er gaat een signaal naar de verkoopautomaat. Het apparaat behoudt dit signaal tot de gebruiker de transactie annuleert door op de stopknop te drukken of wanneer het maximumbedrag is opgebruikt. De LCD geeft het bijgewerkte bedrag weer dat periodiek in rekening wordt gebracht. Tijdsdiagram voor optellen actief/inactief Telmachines krijgen een puls van een externe bron en lopen of stoppen dienovereenkomstig. In de tijd met actieve puls loopt de machine. In de tijd met inactieve puls stopt de machine Nayax - Pulse

17 Telparameters Deze functionaliteit wordt aangestuurd door 4 parameters: delta time, Credit per Delta Time, Maximum Charge en Minimum charge. Count-up Minimum Charge - het minimumbedrag dat bij de klant in rekening wordt gebracht onafhankelijk van de feitelijke omvang van het gebruik. Count-up Maximum Charge het maximumbedrag dat bij de klant in rekening wordt gebracht (dit stelt ook een grens aan de maximale tijd die wordt ingesteld per puls). Count up delta time afrekenen vindt plaats in deltatijden. Een apparaat kan bijvoorbeeld worden ingesteld op $0,25 per 6 seconden. Count-up Credit per Delta Time de waarden in centen per deltatijd. Voor een goede werking van de telfunctionaliteit moeten de volgende regels worden toegepast: Het maximumbedrag is hoger dan het minimumbedrag. Het maximumbedrag is niet 0. De deltatijd is niet 0. Het tegoed per deltatijd is niet 0. Het koopproces Om het proces te starten haal de gebruiker de kaart door de lezer. De gebruiker is dan gemachtigd tot gebruik dat optelt tot het maximumbedrag. Na succesvolle autorisatie wordt de machine in werking gesteld. Zodra de machine in werking is, kan de gebruiker de machine op ieder willekeurig moment stopzetten of wachten tot het aantal deltatijden * tegoed per deltatijd >= maximumbedrag. Binnen elke verstreken tijdseenheid (deltatijd) wordt het totaalbedrag verhoogd met een vooraf door de operator van de machine bepaald bedrag (het tegoed per deltatijd). Aan het einde van de bewerking wordt bij de klant het totaalbedrag in rekening gebracht dat overeenkomt met de vermenigvuldiging van het aantal deltatijden en het tegoed per deltatijd. Er geldt echter altijd een minimum- en een maximumbedrag. Het bedrag dat in rekening wordt gebracht, ligt daar tussenin. Version

18 Optelmodus Het totaalbedrag wordt aan het begin van de deltatijd bijgewerkt, dus als de gebruiker aangeeft dat de machine moet stoppen nadat er een deltatijd is begonnen, dan wordt de gehele deltatijd in rekening gebracht, ook als deze nog niet verstreken is. Voorbeeld: Getelde deltatijden = 10 Geteld tegoed per delta-tijd = 12 Tijd Geteld maximum = 130 Voor de eerste 40 seconden is het totaalbedrag 50, vervolgens wordt het bedrag elke 10 seconden bijgewerkt tot 60, 72, 84, 96, 108 en 120. Op dat moment zijn er in totaal 120 seconden verstreken. Dan is groter dan 130 en stopt de machine de bewerking en wordt er 120 in rekening gebracht. Stroomuitval Mocht tijdens een bewerking om wat voor reden de stroom uitvallen, dan wordt het totaalbedrag opgeslagen en stopt de machine. Zodra de stroom weer is ingeschakeld, wordt het totaalbedrag bij de klant in rekening gebracht Nayax - Pulse

19 Nieuw pulsalgoritme IV Deel

20 Nieuw pulsalgoritme Nieuw pulsalgoritme Klanten gaven aan het pulsalgoritme dat was geïmplementeerd tot FW-versie niet precies was en dat er pulsen werden overgeslagen. Om die klacht te verhelpen is er een nieuw algoritme voor ontvangst geïmplementeerd in 0.5.6, voor HWalleen. Dit nieuwe algoritme garandeert een nauwkeurigheid van 100% voor pulsen tot een korte duur van 10 ms (hoewel er getest is met pulsen van 13 ms). Nieuw pulsalgoritmefilter Een belangrijke verandering in het algoritme is de configureerbare filter. Het oudere algoritme had een vaste filter met als gevolg dat bij snelle pulsen soms pulsen werden overgeslagen. Op het nieuwe algoritme wordt de filter gezien als 10% van de tijd met actieve puls 2 : Tijd met actieve puls 2 is in de server ingesteld in 10*ms. Dat betekent dat als de filter is ingesteld op 8, de puls gedurende 80 ms actief blijft en dat elke puls korter dan 8 ms wordt uitgefilterd Nayax - Pulse

21 Puls voor aflezen DEX V Deel

22 Puls voor aflezen DEX Puls voor aflezen DEX Er was gevraagd om voor elke poging om DEX (Data EXchange protocol) af te lezen een puls te sturen. Deze puls zou het betreffende apparaat moeten waarschuwen voor de komende DEX-aflezing. Om deze waarschuwingspuls in te schakelen, moeten de volgende parameters naar het apparaat worden verzonden: De puls die wordt verzonden wordt actief gedurende de in tijd met actieve puls vertraging voordat de DEX-aflezing wordt aangestuurd door tijd met actieve puls in 10ms gespecificeerde tijd en een in 10ms. Nayax - Pulse

23 Hoe werkt puls VI Deel

24 Hoe werkt puls Hoe werkt puls Rusttoestand VMC kreeg tegoed Om tegoed aan VMC beschikbaar te stellen, sluit de unit de puls lijn kort naar de aarde. VMC detecteert dat de pulslijn naar de aarde is gegaan en staat aankoop toe. De unit gaat terug in de rusttoestand als de hefboom wordt geopend. Tijdsdiagram voor puls actief/inactief 18 - Nayax - Pulse

25 Fysieke installatie op de machine VII Deel

26 Fysieke installatie op de machine Fysieke installatie op de machine De fysieke verbinding hangt af van de hardwareversie van de Nayax VI-versie. HW rev. 2.2 en 2.5 In deze HW-revisie moet er een pulskabeladapter worden verbonden met de standaard MDB-kabel van Nayax: *links pulskabeladapter, rechts Nayax MDB-kabel 1. Puls: bruine draad (pulslabel) 2. Inhibit: groene draad (SW1-label) 3. GND: logische aarding voor puls en Inhibit. 4. Stroomtoevoer: +24 V AC/DC 5. Stroomtoevoer: -24 V AC/DC De stroomvoorziening ligt tussen 9 en 42 V AC/DC. Aarding NIET kortsluiten met stroomtoevoer (+24 V AC/DC of -24 V AC/DC), wanneer de unit wordt gevoed met AC Nayax - Pulse

27 HW rev. 3.0 (Amit 3.0) HW rev. 3.0 (Amit 3.0) De Amit 3.0 is voorzien van een speciale kabel voor de puls. 1. Puls (label: pulse1/fuji rxd) 2. Inhibit (label: ex pulse inhibit) 3. GND: logische aarding voor puls en Inhibit. 4. Stroomtoevoer: +24 V AC/DC 5. Stroomtoevoer: -24 V AC/DC Version

28

29 HW puls-interface VIII Deel

30 HW puls-interface HW puls-interface Er is geen standaard als interface voor pulsen. Deze paragraaf exporteert de Nayax HW-pulsuitvoerinterface om de klant te helpen om de pulsinvoer correct te dimensioneren. HW rev. 2.2a Deze HW-revisie heeft alleen de mogelijkheid om een puls naar de VMC te sturen. HW rev. 2.5 In deze revisie is de HW voorzien van de mogelijkheid toegevoegd om op de pulslijn andere pulsapparaten te controleren Nayax - Pulse

31 HW rev. 3.0 (Amit 3.0) HW rev. 3.0 (Amit 3.0) Vergelijkbaar met 2.5. Version

32

33 HW Inhibit-interface en deur open (indien relevant voor puls) IX Deel

34 HW Inhibit-interface en deur open (indien relevant voor puls) HW Inhibit-interface en deur open (indien relevant voor puls) Deze paragraaf exporteert de Nayax HW-inhibituitvoerinterface om de klant te helpen om de inhibitinvoer correct te dimensioneren. HW rev. 2.2a HW rev Nayax - Pulse

35 HW rev. 3.0 (Amit 3.0) HW rev. 3.0 (Amit 3.0) Version

36

37 Troubleshooting X Deel

38 Troubleshooting Symptom(en): Het apparaat leest valse pulsinvoer na enkele pulsaankopen (uitgaande pulsen) Prognose: Apparaat leest onjuiste pulsinvoer na elke pulsaankoop Scope: Alle apparaten Oplossing: A - Zoals toegelicht in paragraaf Pulse IN1 Counter 2, leest het apparaat invoerpulsen op dezelfde lijn die ook wordt gebruikt voor pulsuitvoer. Bij het verzenden van pulsen wordt de pulslijn niet gelezen, om te voorkomen dat zelf verzonden pulsen worden gezien als invoer. Na afloop van het verzenden van pulsen wordt de pulslijn ook niet gelezen gedurende de tijd die overeenkomt met de tijd met inactieve puls 2. Afhankelijk van de elektrische capaciteit van de pulslijn kan het na verzending van een puls even duren voor het voltage stabiel is op inactieve waarde. 1) De tijd met inactieve puls 2 opnieuw configureren om te kunnen voldoen aan de VMC-tijden. Symptom(en): Apparaat leest random valse pulsen Prognose: De pulsfilter 14 niet geconfigureerd om te kunnen voldoen aan de eisen van VMC Scope: Alle apparaten, vaak in het nieuwe pulsalgoritme 14 Oplossing: A - Pas het pulsfilter aan, aan de eisen van de VMC. Symptom(en): Apparaat mist pulsen Prognose: Nieuw pulsalgoritme 14 is niet geïmplementeerd in de HW/FW-combinatie Scope: Alle apparaten Oplossing: A - Implementeer het pulsalgoritme in de HW/FW-combinatie. Prognose: De pulsfilter is ingesteld op een hoge waarde Scope: Alle apparaten Oplossing: A - De pulsfilter 14 is ingesteld op een (te) hoge waarde waardoor het apparaat feitelijke pulsen uitfiltert. Stel de pulsfilter in op een lagere waarde Nayax - Pulse

39 Pulsfeedback Symptom(en): "PULSE1 feedback- generated by the Amit on Output1/2" wordt niet afgedrukt op Gtrace Prognose: De Amit-software herkent de zelf gegenereerde pulsen en keurt daarom goed dat de feitelijke pulsuitvoer verloopt via puls 1/2 Scope: Alle apparaten Oplossing: A - Controleer de Amit-software. Prognose: De pulsen worden niet worden gegenereerd vanwege een probleem met de stroomkring (als de lijn niet is opgehaald) Scope: Alle apparaten Oplossing: B - Controleer de stroomkring. Prognose: De pulsen worden niet worden gegenereerd vanwege een ander probleem Scope: Alle apparaten Oplossing: C - Controleer de volledige installatie Version

40