Protocol inzake de regels van toezicht en controle op de kansspelen in de kansspelinrichtingen klasse II door middel van een passend informaticasysteem.
- Gecoördineerde tekst Versie :
II_V10
van 1ste november 2013
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
INHOUD blz. 1
INHOUD VAN DIT DOCUMENT ............................................................................................................ 4
2
DEFINITIES EN AFKORTINGEN........................................................................................................... 5
3
TECHNISCHE VEREISTEN GESTELD AAN DE KABLERING EN PASSIEVE COMPONENTEN VAN HET LAN................................................................................................................................................ 6
4
TECHNISCHE VEREISTEN GESTELD AAN DE ACTIEVE COMPONENTEN VAN HET LAN............ 7
5
TECHNISCHE VEREISTEN GESTELD AAN DE CLIENTS EN SERVERS .......................................... 8
6
VEREISTEN GESTELD AAN HET LOKAAL VOOR HET DATA-RACK............................................. 10
7
TECHNISCHE VEREISTEN GESTELD AAN DE DATAVERBINDING MET DE KANSSPELCOMMISSIE ..................................................................................................................... 11
8
BIJKOMENDE VEREISTEN GESTELD AAN HET VIDEO SURVEILLANCE SYSTEEM................... 12
9
VEREISTEN INZAKE ACCOUNTING - FINANCIËLE INFORMATIE (F1 EN F2) ............................... 13
10
VEREISTEN INZAKE REGISTRATIE (F5) .......................................................................................... 14
11
VEREISTEN INZAKE TECHNISCHE CONTROLE (F6) ...................................................................... 15
12
VEREISTEN INZAKE DOCUMENTATIE I.V.M. HET INFORMATICASYSTEEM EN HET VIDEOSURVEILLANCE SYSTEEM ............................................................................................................... 17
13
GEBRUIK VAN NIEUWE TECHNOLOGIEËN ..................................................................................... 18
14
DIVERSE VEREISTEN......................................................................................................................... 19
15
STANDAARDEN INZAKE NAAMGEVING VOOR DE TE VERZENDEN BESTANDEN..................... 22
16
GOEDKEURING .................................................................................................................................. 23
17
BIJLAGE 1 : XML BESCHRIJVING .................................................................................................... 24
18
BIJLAGE 2 : STANDAARD COMMUNICATIE PROTOCOL............................................................... 28
19
BIJLAGE 3 : ASCII TABEL ................................................................................................................. 39
20
BIJLAGE 4 : KONINKLIJK BESLUIT VAN 23 MEI 2003 .................................................................... 42
-3-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
1
Kansspelcommissie 1ste november 2013
INHOUD VAN DIT DOCUMENT
Art. 38, 5° van de wet van 7 mei 1999 bepaalt dat het toezicht op en de controle van de kansspelen in de kansspelinrichtingen klasse II dient te gebeuren bij middel van een passend informaticasysteem. Dit document beschrijft de technische vereisten waaraan supra vermeld systeem dient te voldoen. Dit protocol is de uitvoering van art. 11 van het koninklijk besluit d.d. 23/05/2003 betreffende de regels van toezicht en controle op de kansspelen in de kansspelinrichtingen klasse II door middel van een passend informaticasysteem (B.S. 04/06/2003).
-4-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
2
Kansspelcommissie 1ste november 2013
DEFINITIES EN AFKORTINGEN
Afkorting
Definitie
LAN
Local Area Network ; lokaal netwerk Iedere elektronische eenheid, dus zowel administratieve pc's als automatische spellen
Cliënt On-line
UTP DHCP WINS DNS FTP DVD EPROM Xls-file XML
RJ45 Propagation Delay TCP/IP IPV4 IPV6 SWITCH SSL SSH HTTP DMZ IP-verbinding ISP IP-adres
Wordt beschouwd als deel uitmakende van een on-line systeem, alles wat zich tussen de machine en de Datatransfert naar de Kansspelcommissie (met inbegrip van de CPU-Switch toepassing) bevindt Unshielded Twisted Pair Dynamic Host Configuration Protocol Windows Internet Naming Service Domain Name System File Transfert Protocol Digital Versatile Disk Erasable Programmable Read Only Memory Bestandsformaat van Microsoft Excel. Extensible Markup Language Is een standaard van het World Wide Web Consortium voor de syntaxis van formele markup-talen waarmee men gestructureerde gegevens kan weergeven in de vorm van platte tekst Registerred Jack 45 De tijd dat een signaal nodig heeft om van punt A naar punt B te gaan over een gegeven transmissie- kanaal. Transmission Control Protocol / Internet Protocol. Internet Protocol-adres in 4 posities. Internet Protocol-adres in 6 posities. Een electronisch apparaat dat het berichtenverkeer regelt tussen de verschillende LAN-segmenten. Secure sockets layer Secure shell Hypertext transfert protocol. Demilitarized Zone verbinding op basis van het Internet Protocol Internet Service Provider Internet Protocol adres.
-5-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
3
Kansspelcommissie 1ste november 2013
TECHNISCHE VEREISTEN GESTELD AAN DE KABLERING EN PASSIEVE COMPONENTEN VAN HET LAN
Er dient gebruik te worden gemaakt van UTP-kabel, minimaal CAT5, 100 ohm, 8-draads en RJ45 connectoren. Alle acht de draden dienen te worden aangesloten. De bekabeling dient op een correcte wijze te worden uitgevoerd. Bij de realisatie van het centraal punt van dit sternetwerk dient gebruik te worden gemaakt van een 19” data-rack en rack-mounted patchpanelen. Dit rack zal enkel dienen voor de huisvesting van componenten van het LAN. Een moderne PC kan gebruikt worden als server na instemming van de kansspelcommissie. Alle eindpunten dienen eenduidig te worden geïdentificeerd, waarbij dezelfde identificatie zal worden hernomen op de centrale patch-panelen. Het LAN dient minimaal compatibel te zijn met volgende LAN-standaarden: 10BASE-T, 100BASE-T, 100BASE-TX, 100BASE-T4. Een degelijke documentatie dient ter plaatse aanwezig te zijn. Ze dient nauwgezet te worden bijgewerkt bij elke aanpassing en omvat minimaal volgende inlichtingen: - identificatie van de installateur; - grondplan van de inrichting met aanduiding van de eindpunten, inclusief de eenduidige identificatie; - een schematische voorstelling van het datarack met plaatsing van de passieve- en actieve componenten van het LAN; - een gedetailleerde lijst van alle geplaatste UTP-kabels met opgave van installatiedatum, identificatiecode en lengte in aantal meter; - een testrapport van alle horizontale bekabeling. Voor elk eindpunt dient een afzonderlijk verslag te worden toegevoegd welke minimaal volgende gegevens bevat : - datum en uur van de test; - gebruikte testapparatuur; - bedradingschema; - testresultaten zoals Propagation delay, weerstand, dempingsfactor, ... ; - opgave van de compatibele netwerkstandaarden voor dit eindpunt. Deze documentatie dient tevens in elektronische vorm beschikbaar te zijn.
-6-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
4
Kansspelcommissie 1ste november 2013
TECHNISCHE VEREISTEN GESTELD COMPONENTEN VAN HET LAN
AAN
DE
ACTIEVE
Er mag naar keuze gebruik worden gemaakt van hub’s of switches compatibel met voormelde netwerkstandaarden. De koppeling van de dataverbinding naar de Kansspelcommissie dient op een correcte wijze te worden uitgevoerd. Algemeen wordt gesteld dat er geen gebruik mag worden gemaakt van “wireless verbindingen”. Enkel in uitzonderlijke gevallen, en na voorafgaande toestemming van de Kansspelcommissie kan hiervan worden afgeweken
-7-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
5
Kansspelcommissie 1ste november 2013
TECHNISCHE VEREISTEN GESTELD AAN DE CLIENTS EN SERVERS
Alle clients en servers dienen te zijn uitgerust met een netwerkkaart met RJ45 aansluiting. Alle clients en servers dienen het TCP/IP protocol IPV4 en/of IPV6 te ondersteunen en dienen te beschikken over een vast IP-adres en rechtstreeks adresseerbaar te zijn via TCP/IP. Geen enkele andere koppelingswijze is toegestaan. Het besturingssysteem moet een versie van Windows, Unix of Linux zijn. Een up-to-date documentatie zal worden bijgehouden aangaande de toegekende ipadressen en bijhorende mac-adressen, met opgave van de éénduidige identificatie van het eindpunt waaraan de client of server verbonden is. Dynamische IP-adressen met bijhorende dynamische DNS zijn niet toegelaten. Deze documentatie dient tevens in elektronische vorm beschikbaar te zijn. Indien gebruik gemaakt wordt van DHCP-, WINS- DNS-servers dient een volledige documentatie inzake deze servers eveneens aanwezig te zijn. Deze documentatie dient tevens in elektronische vorm beschikbaar te zijn. Indien om een of andere reden het luik dat toegang verleent tot het cpu-gedeelte van de speelautomaat wordt geopend moet de dienst Metrologie worden verwittigd (zie punt 11/4) (de speelautomaat mag in exploitatie blijven). Supra vermeld luik dient te worden voorzien van een mechanisch en electrisch beveiligde sensor welke elke beweging van dit luik registreert in de databank van het online systeem op dergelijke wijze dat alle interupts worden geregistreerd en nadien geen gegevens meer kunnen worden verwijderd of gewijzigd. De energievoorziening van de sensors alsmede de interface die instaat voor de verzending van deze interupts naar het online systeem en de verbinding van de interface met het online-systeem zelf moet ten allen tijde gewaarborgd zijn. Indien toch een onderbreking van de verbinding optreed dient het online-systeem begin en einde van deze toestand te registreren. Indien om één of andere reden een automaat definitief wordt verwijderd uit het aanbod (verouderd, onherstelbaar defect, verkoop, ) dient de Kansspelcommissie hiervan voorafgaand op de hoogte te worden gesteld. Tevens dienen alle identificatiegegevens van de desbetreffende automaat alsmede de stand van de mechanische en/of elektronische tellers aan de kansspelcommissie te worden medegedeeld. De betrokken automaat dient ter beschikking te blijven in de nabijheid van de betrokken kansspelinrichting gedurende minimaal 14 kalenderdagen. Indien zij het nodig acht kan de Kansspelcommissie tijdens deze periode overgaan tot controle van de overgemaakte gegevens. Polling Inzake polling (vaststellen of een spelautomaat online/offline is) geldt volgende regeling : - Onafhankelijk van het normale dataverkeer tussen moederbord spelautomaat – interface – online systeem dient een polling routine te worden voorzien teneinde vast te stellen of de verbinding online systeem interface werkt ; - Het initiatief hiervoor kan uitgaan van de interface of de server. In beide gevallen dient de server erop toe te zien dat de polling van elke spelautomaat toekomt ; - Elke automaat moet minimaal 1x per 5 minuten een positieve polling geven. De polling frequentie bedraagt elke automaat minimum 1x per minuut ;
-8-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
- Indien gedurende een periode van 5 minuten (te rekenen vanaf de eerste negatieve polling) geen positieve polling volgt dient de spelautomaat als offline te worden beschouwd en dient een entry in het F6-bestand te worden gemaakt (zie structuur F6bestand - punt 11/5) ; - Bij de eerstvolgende polling dient eveneens een entry te worden gemaakt in het F6bestand ; - Het te gebruiken commando voor de polling is het in real time opvragen van de tellers van de automaat ; - Het resultaat van de positieve polling wordt in de DB ingebracht (inclusief de waarde van de tellers, historiek van de laatste 50 pollings dient te worden bewaard). Ingeval van “ram reset” na een interventie dienen de laatst geregistreerde tellerwaarden voor de reset en de tellerwaarden na reset aan de kansspelcommissie te worden gemeld. Inzake synchronisatie van de RTC’s dient de server van het on-linesysteem zich om het uur te synchroniseren met een externe time-server, nadien worden alle clients hiermede gesynchroniserd. Dagelijks moet een historiek van deze evenementen (onderbreking van de verbinding, opening van het cpu compartiment) toegevoegd worden aan het F6 bestand (zie punt 11/5) Communicatieprotocol Een standaard communicatieprotocol is voorzien welke de gegevensuitwisseling tussen de interface en het moederbord van de automatische spelautomaat uniformiseert (Zie Bijlage 2).
-9-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
6
Kansspelcommissie 1ste november 2013
VEREISTEN GESTELD AAN HET LOKAAL VOOR HET DATARACK
Het data-rack dient zodanig te zijn opgesteld dat voor- en achterzijde makkelijk toegankelijk zijn voor onderhoud. In voorkomend geval dient een adequate koeling te worden voorzien om de elektronische apparatuur in optimale omstandigheden te laten functioneren. Deze documentatie dient tevens in elektronische vorm beschikbaar te zijn.
-10-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
7
Kansspelcommissie 1ste november 2013
TECHNISCHE VEREISTEN GESTELD AAN DATAVERBINDING MET DE KANSSPELCOMMISSIE
DE
De vergunninghouder zorgt voor een adequate IP-verbinding met de DMZ van de Federale Overheidsdienst Justitie, bij voorkeur via het eigen netwerk van de gekozen ISP. Gebruik van een vast IP-adres en een gegarandeerde minimum bandbreedte is wenselijk. De vergunninghouder dient tevens in te staan voor de aankoop, installatie en programmmatie van de benodigde actieve componenten van het LAN. De vergunninghouder is verantwoordelijk voor de koppeling van de dataverbinding aan zijn informaticasysteem. De bestanden moeten naar het domein depot.gamingcommission.be verstuurd dmv het protocol HTTPS (via WebServices of WebForms). De userId en het paswoord zullen door de cel ICT van de KSC worden aangeleverd. Opmerking : in afwachting van het plaatsen van de webservices moeten de bestanden verstuurd worden in FTP (of FTPS voor deze die het wensen) en dit eveneens naar de server depot.gamingcommission.be. In geval van FTPS, zal de userId en het paswoord door de cel ICT van de KSC worden aangeleverd, deze zullen dezelfde blijven na de overgang naar HTTPS. In de toekomst zal een digitale handtekening geïmplementeerd kunnen worden. Bijkomende verbinding met de kansspelcommissie in het kader van online-toezicht : -/ Teneinde online-toezicht vanuit de Kansspelcommissie mogelijk te maken dient elke vergunninhouder een “site-to-site VPN” te voorzien. -/ Deze verbinding zal worden geïntegreerd in de internetfirewall van de Kansspelcommissie, de benodigde informatie zal ten gepaste tijde worden doorgegeven. -/ Via deze verbinding dient consultatie mogelijk te zijn van alle hard- en software die het voorwerp uitmaken van de certificeringsprocedure. Tevens dient het mogelijk te zijn bestanden te kopiëren voor verder onderzoek.
-11-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
8
BIJKOMENDE VEREISTEN SURVEILLANCE SYSTEEM
Kansspelcommissie 1ste november 2013
GESTELD
AAN
HET
VIDEO
Minstens op volgende locaties moeten camera’s worden voorzien : - plaats waar de registratie en/of controle van de speler gebeurt, op een dergelijke manier dat de aanmaak van het register en de ondervraging van het centraal bestand van de uitgesloten personen kan gevolgd worden; - kassa’s; - de speelautomaten Op eenvoudig verzoek dienen de opgevraagde opnames te worden overgemaakt aan de Kansspelcommissie. Indien eigen bestandsformaten worden gebruikt dient de viewer te worden meegeleverd. Deze viewer moet werken onder alle beschikbare versies van het windows besturingssysteem. De videobeelden dienen een minimale framerate te hebben van 12 beelden/seconde. De resolutie moet minimaal 4CIF(704x480) bedragen. De kwaliteit en keuze van de camera’s moet rekening houden met de speciale lichtomstandigheden welke aanwezig zijn in de kansspelinrichting. Voor de nieuwe bewakingssystemen is het nodig om kleurencamera’s te gebruiken. De verantwoordelijke voor de uitbating van de kansspelinrichting (vergunninghouder D) dient vanaf zijn werkplek “in real time” de videobeelden te kunnen bekijken, dit minstens indien de vergunninghouder niet aanwezig is om deze taak op zich te nemen en de videoregistratieapparatuur voor de vergunninghouder D derhalve niet toegankelijk is.
-12-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
9
VEREISTEN INZAKE INFORMATIE (F1 EN F2)
Kansspelcommissie 1ste november 2013
ACCOUNTING
-
FINANCIËLE
De financiële informatie dient in XML-formaat, dagelijks te worden overgemaakt aan de kansspelcommissie. Alle bedragen worden vermeld in eurocents. Deze bestanden dienen automatisch te worden aangemaakt en dienen rechtstreeks vanuit de server van de spelinrichting te worden overgemaakt aan de kansspelcommissie. Financiële informatie : (*) = basisgegevens dwz. gegevens die in real time uit de automaat moeten worden opgevraagd, zie ook punt 14/ A – certifiëring. -/ Aantal betrokken automatische machines Voor elke monopostmachine : Voor elke multipostmachine, identificatie van de masters + : -/ Identificatie nummer van het spel (serienummer) (*) -/ Interne volgnummer van het spel -/ Nummer van modelgoedkeuring (Metrologie) (*) -/ Nummer van het belastingsvignet -/ Totaal inzetten van de dag -/ Totaal winsten van de dag -/ Resultaat van de dag -/ Aantal gespeelde partijen (globaal teller) (*) -/ Teller Total Bet bij de opening (*) -/ Teller Total Bet bij de sluiting (*) -/ Teller Total Win bij de opening (*) -/ Teller Total Win bij de sluiting (*) -/ TimeStamp bij de opening -/ TimeStamp bij de sluiting Opmerking : -/ Het veld "masterType" moet de volgende codering respecteren: M1 : single master, cpu in de master en de satellieten M2 : single master, cpu enkel in de satellieten M3 : single master, cpu enkel in de master M4 : multi master, cpu in de master en de satellieten M5 : multi master, cpu enkel in de satellieten M6 : multi master, cpu enkel in de master De structuur van het XML-bestand is in bijlage 1 beschreven : Beschrijving "II_F1" file. B/ Globale resultaten : Totaalrecord afkomstig van de kas speciaal bestemd voor de automatische spellen : -/ Totaal inzetten voor alle machines -/ Totaal winsten voor alle machines -/ Globaal resultaat voor alle machines -/ TimeStamp bij de opening -/ TimeStamp bij de sluiting De structuur van het XML-bestand is in bijlage 1 beschreven : Beschrijving "II_F2" file.
-13-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
10
Kansspelcommissie 1ste november 2013
VEREISTEN INZAKE REGISTRATIE (F5)
Een bestand in XML-formaat dient dagelijks aan de kansspelcommissie te worden overgemaakt, één record per bezoeker: - naam; - voornaam; - geboortedatum; - geboorteplaats; - beroep; - straatnaam en huisnummer; - postcode; - gemeente; - land (2chr in overeenstemming met ISO 3166-1-alpha-2 code) ; De structuur van het XML-bestand is in bijlage 1 beschreven : Beschrijving "II_F5" file. Indien in de inrichting enkel een elektronisch register wordt bijgehouden dient het programma een fiche af te drukken welke hoger vermelde gegevens bevat aangevuld met de datum, een sequentieel volgnummer en de tijdsaanduiding van de registratie. De bezoeker ondertekent deze fiche alvorens de speelzaal te betreden. Deze fiches dienen ter plaatse te worden bewaard onder dezelfde voorwaarden als het traditioneel papieren register. Dit bestand dient automatisch te worden aangemaakt en dient rechtstreeks vanuit de spelinrichting te worden overgemaakt aan de kansspelcommissie. Opmerking : de handtekening kan elektronisch uitgevoerd worden via de eId kaart. Er dient een integratie te zijn tussen de spelersregistratie software en de functionaliteit “ondervraging EPIS”. In de praktijk komt dit neer op het gebruik van de webservice. Manuele ondervraging via de website is vanaf 01/01/2010 niet meer toegelaten. Indien EPIS niet bereikbaar is dient de normale time-out te worden afgewacht. De bewuste speler moet worden ingeschreven in het tijdelijk register en vanaf dat ogenblik gaat een sperperiode van 15’ in waarbinnen EPIS niet meer dient te worden ondervraagd, de spelers die tijdens deze periode toekomen worden toegevoegd aan het tijdelijk register. Na afloop van de sperperiode worden alle ingeschreven spelers uit het tijdelijk register automatisch opgevraagd in EPIS. De huidige “noodprocedure” blijft van kracht. Bij een nieuwe time-out gaat opnieuw een 15’ periode in. Het registratieprogramma mag geen manuele keuzemogelijkheid meer bieden om al of niet EPIS te ondervragen. Bij langdurige uitval van EPIS wordt de inhoud van het Bisregister doorgestuurd in de F5-file.
-14-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
11
Kansspelcommissie 1ste november 2013
VEREISTEN INZAKE TECHNISCHE CONTROLE (F6)
Deze informaties moeten dagelijks aan de kansspelcommissie toegestuurd worden. De structuur van het XML-bestand is in bijlage 1 beschreven : Beschrijving "II_F6" file. Dit bestand bevat de volgende elementen : (*) = basisgegevens dwz. gegevens die in real time uit de automaat moeten worden opgevraagd, zie ook punt 14/ A – certifiëring. Administratieve informatie : -/ Serienummer van de machine (*) -/ Naam van de machine -/ Interne volgnummer -/ Nummer van modelgoedkeuring (Metrologie) (*) -/ Datum van de laatste ijking De structuur van het XML-bestand is in bijlage 1 beschreven : XML-element "info". Informatie omtrent de integriteit van de spelsoftware : Dagelijks wordt een programma gestart op alle kansspelautomaten dat de EPROM handtekening(en) verifieert. -/ Aantal betrokken software elementen Voor elke software element -/ Identificatie van het betrokken software element (*) -/ Identificatie van de softwareversie (*) -/ Software handtekening (*) -/ Sleutels die worden gebruikt voor de software handtekening (*) De structuur van het XML-bestand is in bijlage 1 beschreven : XML-element "epromItem". Informatie inzake openen en sluiten van het cpu-toegangsluik : -/ Aantal CPU evenementen Voor elke CPU evenement -/ TimeStamp van evenement (met correcte nauwkeurigheid ; minstens de minuut) -/ Type van evenement (Open / Close) -/ Volgnummer van het evenement -/ Nr van vergunningshouder "E" verantwoordelijk voor het evenement -/ Naam van de technicus die verantwoordelijk is voor het evenement -/ Reden van het evenement (indien type = Close : "Einde van de tussenkomst" vermelden) -/ Aantal dagen geleden sinds de laatste opening -/ Total Bet tijdens de evenement (*) -/ Total Win tijdens de evenement (*) In geval van onderbreking van de communicatie tussen de cpu-switch en de controlemodule, dit event dient te worden beschouwd als een opening van het CPU-luik De structuur van het XML-bestand is in bijlage 1 beschreven : XML-element "cpuItem". Informatie inzake onderbreking van de verbinding met het online systeem : -/ Aantal OnLine onderbrekingen Voor elke onderbreking: -/ TimeStamp van de onderbreking -/ TimeStamp van de in dienst terugstelling van de OnLine verbinding
-15-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
-/ Total Bet tijdens de onderbreking (*) -/ Total Win tijdens de onderbreking (*) -/ Total Bet tijdens de in dienst terugstelling van de OnLine verbinding (*) -/ Total Win tijdens de in dienst terugstelling van de OnLine verbinding (*) De structuur van het XML-bestand is in bijlage 1 beschreven : XML-element "onlineItem".
-16-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
12
VEREISTEN INZAKE INFORMATICASYSTEEM SYSTEEM
Kansspelcommissie 1ste november 2013
DOCUMENTATIE I.V.M. HET EN HET VIDEO-SURVEILLANCE
Volgende documentatie dient voorafgaandelijk aan de kansspelcommissie bezorgd te worden : a) betreffende het informaticasysteem : - naam en adres van de leverancier en/of fabrikant; - identificatie en serienummers; - beschrijving van de hardware en software; - gebruikte compiler; - technisch- en functioneel dossier van de applicatie. b) betreffende het video-surveillance systeem : - naam en adres van de leverancier en/of fabrikant; - identificatie- en serienummers; - lokalisatie en plan van de controlepost; - technisch plan van het systeem en zijn werking; - technische documentatie van de gebruikte camera's.
-17-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
13
GEBRUIK VAN NIEUWE TECHNOLOGIEËN
Nihil (tot nu toe)
-18-
Kansspelcommissie 1ste november 2013
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
14
Kansspelcommissie 1ste november 2013
DIVERSE VEREISTEN
A/ Certificering : Teneinde enige zekerheid te hebben inzake de correcte toepassing van onderhavig protocol en de betrouwbaarheid van de ontvangen gegevens maximaal te garanderen wordt een verplichte certifiëringsprocedure ingevoerd. Alle "B" vergunninghouders dienen hun online-systeem te laten nakijken door een onafhankelijk organisme erkend door de kansspelcommissie (cfr. Art. 52, wet 1999). Dit organisme toetst het GEHEEL VAN HET ONLINE-SYSTEEM (kablering, passieve en actieve componenten van het netwerk, gebruikte communicatie protocols software, clients en servers) aan het geheel van het op dat ogenblik geldend protocol, de diverse KB’s ter zake, de informatieve nota’s KSC ter zake, de nota’s metrologie terzake en de kansspelwet van 1999 alsmede alle wijzigingen aan deze wet. Ook de spelautomaatinterface maakt deel uit van de certificering. De dataverbinding met de speelautomaten in de inrichtingen klasse II dient eveneens te worden geëvalueerd qua betrouwbaarheid en beschikbaarheid. Supra vermeld organisme onderzoekt tevens in welke mate de door het online-systeem AUTOMATISCH gegenereerde XML bestanden betrouwbaar zijn en stelt tevens vast in welke mate en op welke wijze deze gegevens eventueel kunnen beïnvloed worden. Een tijdelijke bewaring van deze gegevens is enkel toegestaan indien ze ook versleuteld worden bewaard via een speciale toepassing die de geheimhouding garandeert of wanneer de bewaring pas wordt uitgevoerd na de verzending. De basisgegevens (*) van de automaten moeten in real-time worden verzameld. Er mag dus geen beroep worden gedaan op een bestand aanwezig in het online systeem, dit om elke afwijking uit te sluiten. De wijze van verzending naar de kansspelcommissie dient eveneens te worden onderzocht. Op basis van het ontvangen dossier (opgemaakt door supra vermeld organisme) aanvaardt de kansspelcommissie al dan niet de certifiëring. Inzake uiterste datum indienen certificeringrapporten zie punt 16 – goedkeuring. De certificeringorganismen dienen hun verslag op te stellen in één van de Belgische landstalen en volgens een model dat kan worden opgelegd door de KSC. Alle kosten verbonden aan deze certificering komen niet ten laste van de kansspelcommissie. De vergunninghouder "B" dient opnieuw zijn systeem te laten certifiëren indien sedertdien veranderingen (andere dan upgrades of bug correcties) werden doorgevoerd in het online systeem. Tijdens een upgrade of een bug correctie, moet de leverancier van de "on-line" software de volgende informatie aan de Kansspelcommissie verzenden : -/ gedetailleerde beschrijving van de aan het systeem aangebrachte wijzigingen; -/ een voorbeeld van elk XML bestand waaruit blijkt dat deze bestanden correct gegenereerd worden. Deze informatie moeten per e-mail aan
[email protected] verzonden worden (met
[email protected] in CC) en met de vermelding "Upgrade Online_Nr_E_Vergunning" in het object veld. Indien nodig zal een hercertificering van het systeem door de Kansspelcommissie gevraagd worden. Het aantal upgrades toegestaan zonder certificering moet echter zeer beperkt blijven.
-19-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
B/ Integriteit van de gegevens : De certificeerder installeert op de ‘hosting server’ een on-line service die de integriteit van het systeem garandeert. Deze service moet : -/ Veilig werken (onmogelijk aan te passen zonder dat het zichtbaar is); -/ In verbinding komen met de server met een hardware handtekening -/ Ad random berekenen van de handtekening van de kritische bestanden en ze vergelijken met de gecertificeerde handtekening; -/ Genereren van het bestand "signature" die de resultaten van de vergelijking, alsook de “timestamp” na iedere vergelijking registreert en deze on-line transfereren naar de Kansspelcommissie. -/ Het bestand "signature" moet zodanig worden versleuteld dat de authenticiteit van de toepassing garandeert. Alleen de Kansspelcommissie mag deze versleuteling kunnen ontcijferen. C/ Cashless : De inworp mag via een cashless systeem gebeuren. In dit geval moet het cashless systeem aan de volgende eisen voldoen : -/ De "Player cards" mogen enkel door de kassa en de gecertificeerde betaalterminals van de inrichting geladen worden. Het aldus geladen bedrag moet met een cryptische wijze op de kaart EN op de cashless server "geschreven" worden. Na inbreng van de kaart zal, indien het bedrag die op de kaart "geschreven" is en het bedrag die op de cashless server geregistreerd is niet overeenstemmen dient er een fout melding op een beschermde wijze in het online systeem geregistreerd te worden en moet de kaart geblokkeerd worden. Indien alternatieve systemen eenzelfde garantieniveau bieden (onmogelijkheid om het bedrag op de kaart te wijzigen zonder dat dit gemakkelijk traceerbaar is) kunnen zij ook voorgesteld worden. De alternatieve systemen moeten, minstens, aan de volgende eisen voldoen : -/ De "Player cards" moeten een unieke elektronische identificatie dragen ; -/ De toegelaten betaalterminals (ook diegene van de kassa) moeten een unieke elektronische identificatie dragen ; -/ De cashless applicatie moet : -/ zorgen dat de "cashless inworp" enkel vanaf een toegelaten betaalterminal kan gebeuren en enkel indien de betrokken player card geïdentificeerd is; -/ de gegevens op een beveiligde (gecrypteerde) wijze op de server registreren ; -/ naast de registratie van het "cashless bedrag" een controle code voorzien zijn om de registratie te beschermen (hash berekend vanaf de kaart ID ; de timestamp ; het cashless bedrag ; een password die enkel door de programmeur van het cashless systeem gekend is ; ...) -/ gecertificeerd zijn door de "on-line certificator". -/ Een "log file" met de IP adressen van ieder verbinding tot de cashless server moet op een beschermde wijze op de cashless server geregistreerd worden (De gegevens moeten 6 maanden bewaard worden). -/ Voor iedere kaart dient een beschermde file met alle transacties (cash in, cash out, datum) op de cashless server geregistreerd te worden." -/ De machines uitgerust met een cashless systeem moeten conform zijn met deze eisen tegen 01/01/2013.
-20-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
D/ RAM-reset : Teneinde de continuïteit van de tellerwaarden te verzekeren wordt volgende regeling van kracht ingeval van RAM-reset: De informatie betreffende de opening en sluiting van het CPU compartiment (cpuItem, zie punt 11) moet gegenereerd worden juist voor en juist na de RAM-reset, teneinde doorgestuurd te worden via het F6 bestand.
-21-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
15
STANDAARDEN INZAKE VERZENDEN BESTANDEN
Kansspelcommissie 1ste november 2013
NAAMGEVING
VOOR
Alle bestandsnamen hebben de volgende structuur : II_licenceId_Fx_date*_time*.xml (* : bij voorkeur deze van aanmaak van het bestand) Voorbeeld : II_012345_F5_20130517_221743.xml
-22-
DE
TE
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
16
Kansspelcommissie 1ste november 2013
GOEDKEURING
Dit protocol werd opgemaakt door de Kansspelcommissie en goedgekeurd ter zitting van 2 oktober 2013. De constructeurs moeten de noodzakelijke wijzigingen aanbrengen aan hun online systeem voor de 1ste juli 2014. De nieuwe versie wordt onderworpen aan de certificering. Het certificeringrapport moet ten laatste op 1ste januari 2015 geleverd worden aan de Kansspelcommissie. De Kansspelcommissie zal nauwgezet toezien op de strikte toepassing van dit protocol. Het niet respecteren van supra vermelde datums kan aanleiding geven tot sancties.
De Voorzitter. E. Marique.
-23-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
17
Kansspelcommissie 1ste november 2013
BIJLAGE 1 : XML BESCHRIJVING
De volgende tabellen geven een overzicht van de te versturen gegevens in XML. Voor de verzending moeten de bestanden gevalideerd worden op basis van de definitiebestanden XSD en van het valideringsprogramma beschikbaar op het volgende adres : www.gamingcommission.be ; Sectie
.
Beschrijving bestand "II_F1" (Punt 9) : /f1/ Field
Cardinality
Data type
Description
protocolVersion
1
string
Versie van het protocol (attribuut van f1)
generalInfo/licenseId
1
int
Nummer van de vergunning B
generalInfo/fileDate
1
date
Datum van bestand
generalInfo/licenseType
1
licenseTypeType
Type van vergunning : B
generalInfo/email
1
emailType
Email van On-Line verantwoordelijke
monoPlayer
1
monoPlayerType
Gegevens voor de monopostmachines
multiPlayer
1
multiPlayerType
Gegevens voor de multipostmachines
monoPlayerType : /f1/monoPlayer/ Field nbOfItems station
Cardinality 1
Data type
0→n
int
Description Aantal betrokken posten
stationType
Gegevens voor de posten van de monopostmachines
multiPlayeTyper : /f1/multiPlayer/ Field nbOfItems multi
Cardinality 1 0→n
Data type
Description Aantal betrokken machines Gegevens voor de elementen van de multipostmachines
int multiType
multiType : /f1/multiPlayer/multi/ Field masters/nbOfItems masters/master
Cardinality 1 1→n
stations/nbOfItems stations/station
1 1→n
Data type int masterType
Description Aantal masters Gegevens voor de masters van deze machine
int stationType
Aantal posten Gegevens voor de posten van deze machine
masterType : /f1/multiPlayer/multi/masters/master/ Field id
Cardinality 1
masterType
Data type
1
string
Description Identificatie Nr van de master
masterTypeType
Type van master : M1,M2,M3,M4,M5,M6
stationType : /f1/multiPlayer/multi/stations/station/ ; /f1/monoplayer/station/ Field id
Cardinality 1
Data type string
Description Identificatie Nr van het spel (serienummer) (*)
internalId approvalId
1 1
string string
Interne volgnummer van het spel Nr van modelgoedkeuring (Metrologie) (*)
extraInfo/taxNumber extraInfo/realBet
1 1
string int
Nr van het belastingsvignet Total inzetten van de dag (in eurocents)
extraInfo/realWin extraInfo/gameResult
1 1
int int
Total winsten van de dag (in eurocents) Resultaat van de dag (in eurocents)
extraInfo/nbOfGamesPlayed
1
int
Aantal gespeelde partijen (globaal teller) (*)
-24-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
extraInfo/realBetBegin
1
int
Teller Total Bet bij de opening (in eurocents) (*)
extraInfo/realBetEnd extraInfo/realWinBegin
1 1
int int
Teller Total Bet bij de sluiting (in eurocents) (*) Teller Total Win bij de opening (in eurocents) (*)
extraInfo/realWinEnd extraInfo/ opening/start
1 1
int dateTime
Teller Total Win bij de sluiting (in eurocents) (*) TimeStamp bij de opening
extraInfo/ opening/end 1 dateTime TimeStamp bij de sluiting (* = basisgegevens dwz. gegevens die in real time uit de automaat moeten worden opgevraagd, zie ook punt 14/ A – certificering)
Beschrijving bestand "II_F2" (Punt 9) : /f2/ Field
Cardinality
Data type
Description
protocolVersion
1
string
Versie van het protocol (attribuut van f2)
generalInfo/licenseId
1
int
Nummer van de vergunning B
generalInfo/fileDate
1
date
Datum van bestand
generalInfo/licenseType
1
licenseTypeType
Type van vergunning : B
generalInfo/email
1
emailType
Email van On-Line verantwoordelijke
gamesInfo/totalRealBet
1
int
Totaal inzetten voor alle machines (in eurocents)
gamesInfo/totalRealWin
1
int
Totaal winsten voor alle machines (in eurocents)
gamesInfo/totalGamesResult
1
int
Globaal resultaat voor alle machines (in eurocents)
gamesInfo/opening/start
1
dateTime
TimeStamp bij de opening
gamesInfo/opening/end
1
dateTime
TimeStamp bij de sluiting
Beschrijving bestand "II_F5" (Punt 10) : /f5/ Field
Cardinality
Data type
Description
protocolVersion
1
string
Versie van het protocol (attribuut van f5)
generalInfo/licenseId
1
int
Nummer van de vergunning B
generalInfo/fileDate
1
date
Datum van bestand
generalInfo/licenseType
1
licenseTypeType
Type van vergunning : B
generalInfo/email
1
emailType
Email van On-Line verantwoordelijke
guests/nbOfItems
1
int
Aantal bezoekers
guestType
Gegevens van de bezoekers
guests/guest
0→n
guestType : /f5/guests/guest/ lastName firstName
Field
Cardinality 1 1
Data type string string
Naam Voornamen
birthDay birthPlace
1 1
date string
Geboortedatum Geboorteplaats
profession houseNbr
1 1
string string
Beroep Nummer
houseBox street
1 1
string string
Bus Straat
zipCode city
1 1
string string
Postcode Gemeente
country
1
string
Land (2chr conformément norme ISO 3166-1-alpha-2 code)
-25-
Description
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
Beschrijving bestand "II_F6" (Punt 11) : /f6/ Field protocolVersion
Cardinality 1
Data type string
Description Versie van het protocol (attribuut van f6)
generalInfo/licenseId generalInfo/fileDate
1 1
int date
Nummer van de vergunning B Datum van bestand
generalInfo/licenseType generalInfo/email
1 1
licenseTypeType emailType
Type van vergunning : B Email van On-Line verantwoordelijke
int gameType
Aantal betrokken machines Technische gegevens per spel
games/nbOfItems games/game
1 1→n
gameType : /f6/games/game/ Field info eprom/nbOfItems
Cardinality 1 1
Data type infoType int
Description Administratieve informatie Aantal betrokken software elementen
eprom/epromItem cpu/nbOfItems
1→n 1
epromItemType int
Informatie omtrent de software elementen Aantal CPU evenementen
cpu/cpuItem online/nbOfItems
0→n 1
cpuItemType int
Informatie inzake het cpu-toegangsluik Aantal OnLine onderbrekingen
online/onlineItem
0→n
onlineItemType
Informatie inzake onderbreking met het online systeem
infoType : /f6/games/game/info/ Field
Cardinality 1
id gameName internalId approvalNumber lastCheckDate
Data type string
Description Serienummer van de machine (*)
1 1
string string
Naam van de machine Interne volgnummer (gegeven door de zaal)
1 0→1
string date
Nummer van modelgoedkeuring (Metrologie) (*) Datum van de laatste ijking
epromItemType : /f6/games/game/eprom/epromItem/ Field
Cardinality 1
id
Data type string
Description Identificatie van het betrokken software element (*)
gameSoftwareVersion checkResult
1 1
string string
Identificatie van de softwareversie (*) Software handtekening (*)
checkKeys
1
string
Sleutels gebruikt voor de software handtekening (*)
cpuItemType : /f6/games/game/cpu/cpuItem/ Field openDateTime
Cardinality 1
Data type dateTime
Description TimeStamp van evenement
eventType formId licenseId name
1 1 1 1
cpuEventType string int string
Type van evenement (Open / Close) Volgnummer van het evenement Nr vergunning "E" verantwoordelijk voor het evenement Naam technicus verantwoordelijk voor het evenement
reason nbOfDaysSinceLastEvent
1 1
string int
Reden van het evenement Aantal dagen geleden sinds de laatste opening
totalBet totalWin
1 1
int int
Total Bet tijdens de evenement (in eurocents) (*) Total Win tijdens de evenement (in eurocents) (*)
onlineItemType : /f6/games/game/online/onlineItem/ Field evenTiming/start
Cardinality 1
Data type dateTime
Description TimeStamp van de onderbreking
-26-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
evenTiming/end
1
dateTime
TimeStamp van de in dienst terugstelling
totalBetBegin totalWinBegin
1 1
int int
Total Bet tijdens de onderbreking (in eurocents) (*) Total Win tijdens de onderbreking (in eurocents) (*)
totalBetEnd totalWinEnd
1 1
int int
Total Bet tijdens de in dienst terugstelling (in eurocents) (*) Total Win tijdens de in dienst terugstelling (in eurocents) (*)
(* = basisgegevens dwz. gegevens die in real time uit de automaat moeten worden opgevraagd, zie ook punt 14/ A – certificering)
-27-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
18
Kansspelcommissie 1ste november 2013
BIJLAGE 2 : STANDAARD COMMUNICATIE PROTOCOL
Bijkomend wordt een standaard communicatieprotocol voorzien welke de gegevensuitwisseling tussen de interface en het moederbord van de automatische spelautomaat uniformiseert. A. Voorwerp: Dit protocol bestaat uit 3 groepen van commando’s : 1. De verplichte openbare commando’s welke moet worden ondersteund door elke machine van Klasse II. Deze commando’s zijn genummerd van 0 tot 127 of in hexadecimale taal van 00 tot 7F. 2. De optionele openbare commando’s (tekst in het blauw in bijlage) dienen om de communicatie te verbeteren en/of om onvolmaaktheden te verbeteren van de verplichte commando’s. De fabrikant die deze commando’s wenst te ondersteunen verbindt zich er toe dit deel van het protocol te respecteren. De fabrikanten die deze commando’s wensen te gebruiken moeten zich voorafgaandelijk van vergewissen dat de machines deze correct kunnen ondersteunen. 3. De facultatieve private commando’s : Het gebruik van deze commando's is eigen aan het spel. Het gaat over de commando’s 176 tot 255 of B0 tot FF hexadeciaal. Het systeem on-line moet nagaan of de commando’s van groep 2 en/of groep 3 ondersteund zijn. Op deze wijze is er een overeenkomst met de reeds geïnstalleerde spelen verzekerd. Bijvoorbeeld : Om na te zien of een commando van groep 2 wordt ondersteund : 1. nagaan of de communicatie tussen het spel en het systeem on-line door een correct antwoord op een verplicht commando van groep 1. 2. Verzenden van een commando groep 2 : als het antwoord NULL is of wanneer er geen antwoord is, dan is dit commando niet ondersteund Dit document beschrijft een gegevens communicatie protocol tussen kansspelautomaten en een netwerk interface in een “master-slave” configuratie waarbij het netwerk het initiatief neemt om de informatie te verkrijgen en waarbij de kansspelautomaat de gevraagde informatie verstrekt. Alle functies zijn identiek voor alle kansspelautomaten hetgeen betekent dat dit protocol door alle automaten dient te worden gerespecteerd en dat de netwerk interface geen van deze gereserveerde functies voor andere toepassingen mag gebruiken. De dienst metrologie of een ander erkend keuringsorganisme zal de werking van dit protocol verifiëren. B. Terminologie: In dit document worden de volgende termen gebruikt die als volgt worden omschreven: Automaat: Elke soort kansspelautomaat die autonoom of als onderdeel van een zogenaamde “multispeler” automaat functioneert. Interface: de netwerk interface dewelke gegevens opvraagt van de automaat. Master: deze term wordt gebruikt als synoniem voor de interface Slave: deze term wordt gebruikt als synoniem voor de automaat C. Fysische verbinding tussen de interface en de automaat: De fysische verbinding gebeurt middels een RS-232 verbindingskabel volgens V24 standaard en de communicatiepoort wordt als volgt ingesteld: -/ Baud Rate: 9600 bps
-28-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
-/ -/ -/ -/
Kansspelcommissie 1ste november 2013
Data Bits: 8 Parity: None Stop Bit: 1 Ondersteuning voor RTS/CTS hardware handshaking is optioneel.
D. Regels voor de omzetting van de gegevens: In dit document vertegenwoordigt een cijfer met het prefix ‘0x’ een hexadecimaal getal. Een getal zonder prefix is een decimaal getal, een afdrukbaar ASCII teken wordt weergegeven tussen enkele haakjes (‘) en een tekst wordt weergegeven tussen dubbele haakjes (“). Een conversietabel van decimaal en hexadecimaal naar de respectievelijke ASCII waarde wordt bijgevoegd in bijlage 3. (ASCII staat voor American Standard Code for Information Interchange) D.1. Omzetting van tekst en/of tekens: Elk teken is gecodeerd volgens de ASCII tabel Voorbeeld: om de tekst test 1 te versturen worden er 6 bytes verstuurd met de volgende waardes: “test 1” - ‘t’ ‘e’ ‘s’ ‘t’ ‘ ‘ ‘1’ - 0x74 0x65 0x73 0x74 0x20 0x31 D.2. omzetting van cijfers: Alle cijfers worden uitgedrukt in hun hexadecimale waarde en verzonden middels codering van elke hexadecimale waarde in hun respectievelijke 2 ASCII bytes waarbij hoofdletters worden gebruikt voor de waardes A tot F Voorbeeld: Om 0x07 te verzenden worden de 2 bytes 0x30 0x37 verzonden. Om de tellerwaarde te verzenden wordt deze eerst omgezet in haar hexadecimale waarde 45 836 472 = 0x02BB68B8: Vervolgens worden de volgende 8 bytes verzonden: 0x30 0x32 0x42 0x42 0x36 0x38 0x42 0x38 D.3. Gebruikte terminologie: In de beschrijving van de commando tekst en het antwoord wordt de volgende terminologie gebruikt: STX: Hexadecimale waarde 2 = 0x02 CD: commando byte verzonden per 2 bytes omgezet overeenkomstig D.2. DATA: Algemene term voor tekst en numerieke gegevens omgezet overeenkomstig D.1. and D.2. CS: 1 byte checksum omgezet in 2 bytes overeenkomstig D.2. CS is de minst belangrijke byte van de som van alle data bytes vanaf (maar met uitzondering van) de start byte STX tot (eveneens met uitzondering van) de checksum zelf en de laatste EOT . EOT: Hexadecimale waarde 4 = 0x04 Bovendien zijn de volgende termen in gebruik voor de Cashless commando’s (0x91 tot 0x98) : • interface status (IntStat) = één byte, richting master → slave : IntStat: bit 0 (0x01) = 1/0: interface connection to server Y/N 1 (0x02) = 1/0: player card present Y/N 2 (0x04) = 1/0: cashless in (interface → game) supported Y/N 3 (0x08) = 1/0: cashless out (game → interface) supported Y/N 4 (0x10) = 1/0: lock game Y/N 5 (0x20) = 0, not used
-29-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
6 (0x40) = 0, not used 7 (0x80) = 0, not used • game status (GamStat) = één byte, richting slave → master : GamStat: bit 0 (0x01) = 1/0: stable game status and counters Y/N 1 (0x02) = 1/0: credit in enabled Y/N 2 (0x04) = 1: payout activated, 0 @ answer to cd 93 3 (0x08) = 1/0: cashless in (interface → game) supported Y/N 4 (0x10) = 1/0: cashless out (game → interface) supported Y/N 5 (0x20) = 1: note change out activated, 0 @ answer to cd 93 6 (0x40) = 1: hand pay activated, 0 @ answer to cd 93 7 (0x80) = 0, not used • game events (GamEvent) = één byte, richting slave → master : GamEvent: bit 0 (0x01) = 1/0: stable game status and counters Y/N 1 (0x02) = 1/0: credit in enabled Y/N 2 (0x04) = 1: payout activated, 0 @ answer to cd 93 or hopper pay start 3 (0x08) = 1: coin(s) in detected, 0 @ answer to cd 2, 3 or 97 4 (0x10) = 1: coin(s) out detected , 0 @ answer to cd 2, 4, or 97 5 (0x20) = 1: change out activated, 0 @ answer to cd 93 6 (0x40) = 1: hand pay requested, 0 @ answer to cd 93 7 (0x80) = 1: new door / switch event(s), 0 @ answer to cd 12 • return code (RetCode) = 16 bit (2 bytes), richting slave → master : RetCode: bit 0 (0x0001) = 1/0: service request Y/N 1 (0x0002) = 1/0: service mode Y/N 2 (0x0004) = 1: power on, 0 @ answer to cd 97 3 (0x0008) = 1/0: locked game Y/N 4 (0x0010) = 1/0: CPU door open Y/N 5 (0x0020) = 1/0: other door than CPU door open Y/N 6 (0x0040) = 1: coin in error, 0 @ answer to cd 97 7 (0x0080) = 1: pay out error, 0 @ answer to cd 97 8 (0x0100) = 1: note in error, 0 @ answer to cd 97 9 (0x0200) = 1/0: hopper full Y/N 10 (0x0400) = 1/0: coin box full Y/N 11 (0x0800) = 1: parameter(s) changed, 0 @ answer to cd 97 12 (0x1000) = 1: RAM reset, 0 @ answer to cd 97 13 (0x2000) = 0, not used 14 (0x4000) = 0, not used 15 (0x8000) = 0, not used • transaction number (TrnNb) = informatie is één byte, blijft constant voor de gehele procedure Cashless en moet verschillend zijn voor elke nieuwe procedure (Cashless transactie) • security check (SecChk): CRC16 van 16 bits, gebruik makend van het algoritme CCITT, met de sleutel 0x1021 afgeleid van de polynoom x^16+x^12+x^5+1 met een oorspronkelijke waarde van de CRC16 = 0. De CRC16 is met behulp van een initiële veiligheidsleutel van 32 bits (long) berekend, gecodeerd in 8 bytes met gebruik van de ASCII conversie beschreven in D.2. en met alle gegevens omgezet in ASCII (zie D.2). Voorbeeld : bijvoeging van 450 € van credit aan het spel = 45000 €c = 0x0000AFC8 met : -/ de transactie nummer = 18 (0x12) -/ een initiële veiligheidsleutel (geheim) = 0xA103BCA4
-30-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
de SecCheck, berekend op “A103BCA4120000AFC8“ geeft 0xC0BE de te verzenden reeks is dan “120000AFC8C0BE”. • transaction status (TrnStat) = één byte, richting slave → master : TrnStat = 0x00: credit transfer accepted and waiting for validation 0x01: credit in or regular payout transfer executed with success 0x02: credit transfer canceled 0x11: change out transfer executed with success 0x21: hand pay procedure with success 0x81: transfer refused (no reason specified) 0x82: credit transfer refused due to reached credit limit 0x83: transfer refused cause security check (SecChk) error 0x84: transfer refused due to transaction number (TrnNb) error D.4.Datum en uur aanduiding. Datums in het formaat jjjj/mm/dd; Tijdsaanduiding in het formaat uu:mm:ss (24-uur stelsel) E. Communicatiemodel Alle communicatie wordt geïnitialiseerd door een commando verzonden door de master naar de slave en dewelke bestaat uit een reeks van 4 bytes samengesteld uit de start byte STX, the commando identificatie CD en de stop byte EOT. Telkens de slave een commando ontvangt, zal deze een antwoord sturen samengesteld uit de start byte (STX), het ontvangen commando, de data, de checksum CS en de stop byte (EOT). Indien de slave niet antwoord na 100ms zal de master het commando nogmaals sturen. Indien er nog steeds geen antwoord volgt na 100ms zal de master het commando nogmaals sturen na 1 seconde, vervolgens na 10 seconden en vervolgens na 100 seconden indien de slave nog steeds niet heeft geantwoord. Na 5 pogingen krijgt de slave de status “offline”. De master kan zijn pogingen herhalen tot de slave antwoordt, waarna de “offline” status wordt opgeheven. Als een commando niet wordt herkend door de slave, zal deze een blanco antwoord terugsturen in het formaat: STX “00” CS EOT F. Beschrijving van de commando’s Alle niet gedefinieerde in de onderstaande tabel worden gereserveerd voor later gebruik doch hoeven niet te worden toegewezen
-31-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Cmd
Description
0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08
Null Get game identification (identification jeu) Get general counters (compteurs généraux) Get ‘Credit in’ counter (compteur “Cash in”) Get ‘Credit out’ counter (compteur “Cash out”) Get ‘Hand pay’ counter (compteur “comptant”) Get ‘Total bet’ counter (compteur “total In”) Get ‘Total win’ counter (compteur “total Out”) Get number of played games (nombre de parties jouées) Get number of interrupts (nombre d’interruptions) Get ‘CPU-Door open’ (nombre d'ouverture de la "zône" CPU) Get ‘Change in’ counter (compteur “change in”) Get ‘Change out’ counter (compteur “change out”) Get game software version Get checksum (signature software) Réserve Ouverture du compartiment CPU Fermeture du compartiment CPU Verkrijgen van de evenementen deur/schakelaars Synchronisation des "RTC" Bijvoegen van spelkrediet : Crédit in Validatie Credit In Uitbetaling van het spel Validatie van de betaling Annulatie van de transactie Verkrijgen van de informatie « game event » Verkrijgen van de boekhoudkundige informatie Verkrijgen van de info betreffende het protocol
0x09 0x0A 0x0B 0x0C 0x0D 0x0E 0x0F 0x10 0x11 0x12 0x19 0x91 0x92 0x93 0x94 0x95 0x96 0x97 0x98
Kansspelcommissie 1ste november 2013
Nbre bytes TxD RxD 4 6 4 31 4 70 4 14 4 14 4 14 4 14 4 14 4 14
Groupe Cmd 1 1 1 1 1 1 1 1 1
4 4
14 14
1 1
4 4
14 14
1 1
4 4
16 17 25 25 20 0 22 46 30 46 22 8 70 16
1 1
4 4 4 24 20 20 20 20 20 4 6 4
1 1 2 1 2 2 2 2 2 2 2 2
G. Gedetailleerde beschrijving van het door de slave teruggestuurde gegevenspakket: In de hierna volgende beschrijving staat ‘TxPrototype’ voor de functie commando dat door de master wordt verzonden naar de slave, staat TxCMD voor de effectief verzonden reeks en staat ‘RxPrototype’ voor het model antwoord verzonden door de slave naar de master. Er wordt telkens een representatief voorbeeld gegeven en ‘Hex’ toont de teruggezonden reeks in hexadecimale waardes. G.0. 0x00: Blanco TxPrototype: STX “00” EOT TxCmd: STX 0x30 0x30 EOT RxPrototype: STX “00” “CS” EOT Voorbeeld: 0x02 0x30 0x30 0x36 0x30 0x04
-32-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
G.1. 0x01: Verkrijg de spel identificatie Stuurt de door metrologie toegekende toelatingscode in het formaat B-xx-xxxxxx/xx gevolgd door het ‘;’ scheidingsteken en het serienummer van de automaat omgezet in 10 tekens opgevuld met ‘0’ aan de linker zijde. Indien dit serienummer om technische redenen niet kan worden verstuurd zal als serienummer een blanco reeks worden verzonden “0000000000” TxPrototype: STX “01” EOT TxCmd: STX 0x30 0x31 EOT RxPrototype: STX “01” “B-xx-xxxxxx/xx;ssssssssss” “CS” EOT Voorbeeld: STX “01” “B-03-007004/01;V1234567R0” “1B” EOT Hex: 0x02 0x30 0x31 0x42 0x2D 0x30 0x33 0x2D 0x30 0x30 0x37 0x30 0x30 0x34 0x2F 0x30 0x31 0x3B 0x56 0x31 0x32 0x33 0x34 0x35 0x36 0x37 0x52 0x30 0x31 0x42 0x04 G.2. 0x02: Verkrijg de algemene tellerstanden Alle tellerstanden zijn 32 bit hexadecimale getallen omgezet naar 8 bytes zoals beschreven in D.2. De tellers worden in de volgende sequentie verstuurd: credit in, credit out, Hand pay, Total bets, Total wins, Number of played games, Number of game interrupts, Number of door open events. De eerste 5 tellers, dewelke een waarde in geld vertegenwoordigen worden weergegeven in Euro cent. TxPrototype: STX “02” EOT TxCmd: STX 0x30 0x32 EOT RxPrototype: STX “02” “credit in” “credit out” “handpay” “total bets” “total wins” “games” “interrupts“ “CPU-door” “CS” EOT Voorbeeld: STX “02” “0000002F” “0000001A” “00001234” “00005678” “12343210” “00000012” “00009876” “98765432” “0D” EOT Hex: 0x02 0x30 0x32 0x30 0x30 0x30 0x30 0x30 0x30 0x32 0x46 0x30 0x30 0x30 0x30 0x30 0x30 0x31 0x41 0x30 0x30 0x30 0x30 0x31 0x32 0x33 0x34 0x30 0x30 0x30 0x30 0x35 0x36 0x37 0x38 0x31 0x32 0x33 0x34 0x33 0x32 0x31 0x30 0x30 0x30 0x30 0x30 0x30 0x30 0x31 0x32 0x30 0x30 0x30 0x30 0x39 0x38 0x37 0x36 0x39 0x38 0x37 0x36 0x35 0x34 0x33 0x32 0x30 0x44 0x04 G.3. 0x03: Verkrijg ‘credit in’ tellerstand De ‘credit in’ tellerstand is een 32 bit hexadecimaal getal omgezet in 8 bytes zoals beschreven in D.2. Deze teller geeft de geldwaarde weer die in het toestel werd ingeworpen (ongeacht de wijze waarop) en wordt uitgedrukt in Euro cent. TxPrototype: STX “03” EOT TxCmd: STX 0x30 0x33 0x36 0x33 EOT RxPrototype: STX “03” “credit in” “CS” EOT Voorbeeld: STX “03” “0000002F” “FB” EOT Hex: 0x02 0x30 0x33 0x30 0x30 0x30 0x30 0x30 0x30 0x32 0x46 0x46 0x42 0x04 G.4. 0x04: Verkrijg ‘credit out’ tellerstand De ‘credit out’ tellerstand is een 32 bit hexadecimaal getal omgezet in 8 bytes zoals beschreven in D.2. Deze teller geeft detotale geldwaarde weer van de winsten die door het uitstortingmechanisme werden uitbetaald (ongeacht de wijze waarop) en wordt uitgedrukt in Euro cent. TxPrototype: STX “04” EOT TxCmd: STX 0x30 0x34 0x36 0x34 EOT RxPrototype: STX “04” “credit out” “CS” EOT Voorbeeld: STX “04” “0000001A” “F6” EOT -33-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Hex:
Kansspelcommissie 1ste november 2013
0x02 0x30 0x34 0x30 0x30 0x30 0x30 0x30 0x30 0x31 0x41 0x46 0x36 0x04
G.5. 0x05: Verkrijg ‘Hand pay’ tellerstand De ‘Hand pay’ tellerstand is een 32 bit hexadecimaal getal omgezet in 8 bytes zoals beschreven in D.2. Deze teller geeft de geldwaarde weer van de winsten die van het toestel werd verwijderd middels gebruik van een sleutel. Deze teller wordt soms ook ‘Drop’ of ‘Keyout’ genoemd en wordt uitgedrukt in Euro cent. TxPrototype: STX “05” EOT TxCmd: STX 0x30 0x35 EOT RxPrototype: STX “05” “handpay” “CS” EOT Voorbeeld: STX “05” “00000010” “E6” EOT Hex: 0x02 0x30 0x35 0x30 0x30 0x30 0x30 0x30 0x30 0x31 0x30 0x45 0x36 0x04 G.6. 0x06: Verkrijg ‘Total bet’ tellerstand De ‘Total bet’ tellerstand is een 32 bit hexadecimaal getal omgezet in 8 bytes zoals beschreven in D.2. Deze teller geeft de geldwaarde weer van het totaal van de inzetten die hebben plaatsgevonden en wordt uitgedrukt in Euro cent. TxPrototype: STX “06” EOT TxCmd: STX 0x30 0x36 EOT RxPrototype: STX “06” “total bet” “CS” EOT Voorbeeld: STX “06” “00000010” “E7” EOT Hex: 0x02 0x30 0x36 0x30 0x30 0x30 0x30 0x30 0x30 0x31 0x30 G.7. 0x07: Verkrijg ‘Total win’ tellerstand De ‘Total win’ tellerstand is een 32 bit hexadecimaal getal omgezet in 8 bytes zoals beschreven in D.2. Deze teller geeft de geldwaarde weer van het totaal van de winsten die werden uitgekeerd en wordt uitgedrukt in Euro cent. TxPrototype: STX “07” EOT TxCmd: STX 0x30 0x37 EOT RxPrototype: STX “07” “total win” “CS” EOT Voorbeeld: STX “07” “00000010” “E8” EOT Hex: 0x02 0x30 0x37 0x30 0x30 0x30 0x30 0x30 0x30 0x31 0x30 0x45 0x38 0x04 G.8. 0x08: Verkrijg “games played” tellerstand De ‘games played’ tellerstand is een 32 bit hexadecimaal getal omgezet in 8 bytes zoals beschreven in D.2. Deze teller telt op telkens een nieuw spel wordt gestart. TxPrototype: STX “08” EOT TxCmd: STX 0x30 0x38 EOT RxPrototype: STX “08” “games” “CS” EOT Voorbeeld: STX “08” “00000010” “E9” EOT Hex: 0x02 0x30 0x38 0x30 0x30 0x30 0x30 0x30 0x30 0x31 0x30 0x45 0x39 0x04 G.9. 0x09: Verkrijg “line off” tellerstand De ‘Line off’ tellerstand is een 32 bit hexadecimaal getal omgezet in 8 bytes zoals beschreven in D.2. Deze teller telt op telkens de automaat wordt uitgeschakeld. TxPrototype: STX “09” EOT TxCmd: STX 0x30 0x39 EOT RxPrototype: STX “09” “interrupts” “CS” EOT Voorbeeld: STX “09” “00000010” “EA” EOT Hex: 0x02 0x30 0x39 0x30 0x30 0x30 0x30 0x30 0x30 0x31 0x30 0x45 0x41 0x04
-34-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
G.10. 0x0A: Verkrijg ‘CPU Deur open’ tellerstand De ‘CPU Deur open’ tellerstand is een 32 bit hexadecimaal getal omgezet in 8 bytes zoals beschreven in D.2. Deze teller telt op telkens de deur welke toegang geeft tot het cpu¬-compartiment wordt geopend. TxPrototype: STX “0A” EOT TxCmd: STX 0x30 0x41 EOT RxPrototype: STX “0A” “CPU-Door” “CS” EOT Voorbeeld: STX “0A” “00000010” “F2” EOT Hex: 0x02 0x30 0x41 0x30 0x30 0x30 0x30 0x30 0x30 0x31 0x30 0x46 0x42 0x04 G.11. 0x0B: Verkrijg ‘Wissel in’ tellerstand De ‘Wissel in’ tellerstand is een 32 bit hexadecimaal getal omgezet in 8 bytes zoals beschreven in D.2. Deze teller geeft de geldwaarde weer van de totale inworp in het wisselmechanisme indien de automaat hiervan is voorzien. TxPrototype: STX “0B” EOT TxCmd: STX 0x30 0x42 EOT RxPrototype: STX “0B” “changein” “CS” EOT Voorbeeld: STX “0B” “00000032” “F7” EOT Hex: 0x02 0x30 0x42 0x30 0x30 0x30 0x30 0x30 0x30 0x33 0x32 0x46 0x37 0x04 G.12. 0x0C: Verkrijg ‘Wissel out’ tellerstand De ‘Wissel out’ tellerstand is een 32 bit hexadecimaal getal omgezet in 8 bytes zoals beschreven in D.2. Deze teller geeft de geldwaarde weer van het totaal uitgekeerde (gewisselde) bedrag door het wisselmechanisme indien de automaat hiervan is voorzien. TxPrototype: STX “0C” EOT TxCmd: STX 0x30 0x43 EOT RxPrototype: STX “0C” “changeout” “CS” EOT Voorbeeld: STX “0C” “00000032” “F8” EOT Hex: 0x02 0x30 0x43 0x30 0x30 0x30 0x30 0x30 0x30 0x33 0x32 0x46 0x38 0x04 G.13. 0x0D: Verkrijg spel software versie De software versie is een tekst met 10 tekens, desgevallend opgevuld met blancos ‘0’ aan de linkerzijde. Het onderstaande voorbeeld vertegenwoordigt een software versie “V1.00.01”. TxPrototype: STX “0D” EOT TxCmd: STX 0x30 0x44 EOT RxPrototype: STX “0D” “vvvvvvvvvv” “CS” EOT Voorbeeld: STX “0D” “00V1.00.01” “78” EOT Hex: 0x02 0x30 0x44 0x30 0x30 0x56 0x31 0x2E 0x30 0x30 0x2E 0x30 0x31 0x37 0x38 0x04 G.14. 0x0E: Verkrijg de software verificatie checksum Middels dit commando stuurt de slave de gebruikte sleutel alsmede het verkregen resultaat (checksum) terug naar de master. De sleutel bestaat uit 3 bytes en wordt als 6 ASCII tekens verstuurd gebruik makende van de omzettingsformule zoals beschreven in D.2. De checksum is een getal bestaande uit 2 bytes omgezet zoals beschreven in D.2. Beide reeksen worden gescheiden door een puntkomma (‘;’) De drie bytes van de sleutel worden berekend op basis van het weeknummer en het jaartal van het lopend jaar. Het eerste cijfer van het weeknummer vormt de eerste byte, het tweede cijfer van het weeknummer vormt de tweede byte, de twee laatste cijfers van het jaartal -35-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
van het lopend jaar vormen de derde byte. De waarde van het weeknummer wordt berekend volgens de ISO 8601 standaard. Deze bepaalt dat week 1 deze is waarin de eerste donderdag van het lopend jaar valt. Voorbeeld voor de datum 20/02/2006 geeft dit week = 08 van 2006, sleutel1=0, sleutel2=8 en sleutel3=(0)6. TxPrototype: STX “0E” EOT TxCmd: STX 0x30 0x45 EOT RxPrototype: STX “0E” “key;checksum” “CS” EOT Voorbeeld: STX “0E” “2AB792;F378” “EF” EOT Hex : 0x02 0x30 0x45 0x32 0x41 0x42 0x37 0x39 0x32 0x3B 0x46 0x33 0x37 0x38 0x45 0x46 0x04 G.15. 0x0F: Voorbehouden voor later gebruik. G.16. 0x10: Opening CPU-compartiment. Dit commando laat toe de opening van het cpu-compartiment te registreren met datum en tijdsaanduiding. Indien het nummer Van het luik niet eenduidig is gedefinieerd zal standaard het cijfer “1” worden gebruikt. Hierna een voorbeeld voor opening van deur nummer 2 op 10/04/2006 om 10u43 TxPrototype: STX “10” EOT TxCmd: STX 0x31 0x30 EOT RxPrototype: STX “10” “door” “date” “time”“CS” EOT Voorbeeld: STX “10” “2” “2006/04/18” ”10:43:21” “25” EOT Hex: 0x02 0x31 0x30 0x32 0x32 0x30 0x30 0x36 0x2F 0x30 0x34 0x2F 0x31 0x38 0x31 0x30 0x3A 0x34 0x33 0x3A 0x32 0x31 0x32 0x35 0x04 G.17. 0x11: Sluiting CPU-compartiment. Dit commando laat toe de sluiting van het cpu-compartiment te registreren met datum en tijdsaanduiding. Indien het nummer Van het luik niet eenduidig is gedefinieerd zal standaard het cijfer “1” worden gebruikt. Hierna een voorbeeld voor opening van deur nummer 2 op 10/04/2006 om 10u43 TxPrototype: STX “11” EOT TxCmd: STX 0x31 0x31 EOT RxPrototype: STX “11” “door” “date” “time”“CS” EOT Voorbeeld: STX “11” “2” “2006/04/18” ”10:43:21” “26” EOT Hex: 0x02 0x31 0x31 0x32 0x32 0x30 0x30 0x36 0x2F 0x30 0x34 0x2F 0x31 0x38 0x31 0x30 0x3A 0x34 0x33 0x3A 0x32 0x31 0x32 0x36 0x04 G.18. 0x12: Verkrijgen van evenementen deuren/schakelaars Dit commando laat toe om een algemene manier om evenementen te verkrijgen zoals het openen van de deur of het activeren van de controleschakelaars. Deze functie vervangt de functies 0x10 en 0x11. TxPrototype: STX “12” EOT RxPrototype: STX “12” “action” “date” time” “seqnb” “CS” EOT: waarbij “action” = “00”: alles overgedragen, niet de nieuwe evenement(en) ”01”: niet gebruikt “02”: deur CPU open “03”: deur CPU toe ”04 - - FF”: momenteel niet gebruikt “date” “time” = “AAMMJJ” “HHMM”
-36-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
“seqnb” = Nummer van de sequentie van 1 Byte, verhoog voor elk nieuw evenement, kopij van het laatste nummer indien de “action” = “00”. De waarde 1, 255 en 0 zijn voorbehouden. G.19. 0x19: Tijdsynchronisatie Dit commando laat toe de speelautomaten te synchroniseren mat de onlineserver. Voorbeeld voor synchronisatie op 18/04/2006 om 10:43:21: TxPrototype: STX “19” “date” “time” “CS” EOT Voorbeeld: STX “19” “2006/04/18” “10:43:21” “FC” EOT Hex: 0x02 0x31 0x39 0x32 0x30 0x30 0x36 0x2F 0x30 0x34 0x2F 0x31 0x38 0x31 0x30 0x3A 0x34 0x33 0x3A 0x32 0x31 0x46 0x43 0x04 G.20. 0x91: Krediet In : Toekennen van krediet aan het spel Dit commando laat toe om bijkomend krediet aan het spel toe te kennen, het maximum bedrag dat mag worden overgezet is 500 €. TxPrototype: STX “91” “TrnNb” “Amount2Add” “SecChk” “CS” EOT RxPrototype: STX “91” “TrnNb” “TrnStat” “Amount2BAdded” “SecChk” “CS” EOT waarbij Amount2Add = toe te voegen bedrag Amount2BAdded = bedrag toegevoegd na validatie door het commando 0xB2 G.21. 0x92: Validatie van Krediet In Dit commando laat toe om de overdracht van het spelkredieten te valideren TxPrototype: STX “92” “TrnNb” “Amount2Add” “SecChk” “CS” EOT RxPrototype: STX “92” “TrnNb” “TrnStat” “Amount2Add” “AmountAdded” “CreditBefore” “CreditAfter” “SecChk” “CS” EOT waarbij Amount2Add = initieel bedrag gevraagd voor toevoeging Amount2Added = toegevoegd bedrag CreditBefore = spelkrediet voor de transactie CreditAfter = spelkrediet na de transactie G.22. 0x93: Uitbetaling van het spel Dit commando laat toe om het beschikbaar spelkkrediet te betalen, om het bedrag van een overschrijving te krijgen of het te transfereren bedrag na manuele betaling (Handpay / Drop). Het spel zal deze actie beantwoorden met het commando 0x96 (spelevenement) gedurende 4 seconden. Als het commando 0x93 wordt gestuurd tijdens deze periode zal de procedure worden gestart en het type van betaling zal worden gecodeerd in de variable TranStat van de commando’s 0x93 et 0x94 (zie D.3.). TxPrototype: STX “93” “TrnNb” “Amount2Pay” “SecChk” “CS” EOT RxPrototype: STX “93” “TrnNb” “TrnStat” “Amount2Pay” “Amount2BPaid” “SecChk” “CS” EOT waarbij Amount2Pay = Voor betaling gevraagd bedrag, 99.000.000 = alles betalen Amount2BPaid = Bedrag teruggetrokken na validatie door het commando 0xB4 G.23. 0x94: Validatie van de uitbetaling Dit commando valideert de vooraf gevraagd uitbetaling 0x93. TxPrototype: STX “94” “TrnNb” “Amount2Pay” “SecChk” “CS” EOT RxPrototype: STX “94” “TrnNb” “TrnStat” “Amount2Pay” “CreditBefore” “CreditAfter” “SecChk” “CS” EOT waarbij Amount2Pay = initieel te betalen gevraagd bedrag AmountPaid = betaald bedrag CreditBefore = spelkrediet voor de transactie
-37-
“AmountPaid”
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
CreditAfter = spelkrediet na de transactie G.24. 0x95: Annulatie van de financiele transactie Dit commando annuleert het commando 0x91 (Credit In) of 0x93 (Payout) voorafgaand aan het commando 0x95. TxPrototype: STX “95” “TrnNb” “InitalAmount” “SecChk” “CS” EOT RxPrototype: STX “95” “TrnNb” “TrnStat” “InitalAmount” “SecChk” “CS” EOT waarbij InitialAmount = initieel opgegeven bedrag (toe te voegen / terug te trekken) G.25. 0x96: Verkrijgen van de informatie « game event » Dit commando laat toe om de toestand van de mogelijke gebeurtenissen die het spel bewaken te verkrijgen. Het spel zal deze gebeurtenis gedurende 4 seconden signaleren. Wat de Payout betreft (betaling van de beschikbare spelkredieten, het verkrijgen via een overschrijving of het ontvangen door middel van een manuele uitbetaling = Handpay / Drop) het spel zal een betaling via de Hopper beginnen nadat deze termijn verstreken is. Indien het commando 0x93 (payout) werd ontvangen gedurende deze 4 seconden, dan zal de procedure « Cashless » worden geïnitialiseerd. TxPrototype: STX “96” EOT RxPrototype: STX “96” “GamEvent” “CS” EOT G.26. 0x97: Verkrijgen van de boekhoudkundige gegevens van het spel Dit commando laat het verkrijgen van de boekhoudkundige gegevens van het spel. TxPrototype: STX “97” “IntStat” EOT RxPrototype: STX “97” “GamStat” “GamEvent” “RetCode” “credit in” “credit out” “bets” “wins” “handpay” “games” “current credits” “CS” EOT G.27. 0x98: Verkrijgen van de informatie van het ondersteund protocol Dit commando laat toe de versie te kennen van het ondersteund protocol on-line. TxPrototype: STX “98” EOT RxPrototype: STX “98” “BPvp.vs.dd” “CS” EOT Exemple: STX “98” “BP09.12.00” “CS” EOT waarbij vp = versie van het protocole on-line classe II (versie 9 = versie 2013) vs = ondersteunde versie (12 in het voorbeeld) dd = indicatie van tests, een versie waarvan dd verschillend is van 0 is (nog) niet goedgekeurd door de constructeurs
-38-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
19
Kansspelcommissie 1ste november 2013
BIJLAGE 3 : ASCII TABEL
Decimal
Octal
Hex
Binary
Value
Description
000
000
000
00000000
NUL
(Null char.)
001
001
001
00000001
SOH
(Start of Header)
002
002
002
00000010
STX
(Start of Text)
003
003
003
00000011
ETX
(End of Text)
004
004
004
00000100
EOT
(End of Transmission)
005
005
005
00000101
ENQ
(Enquiry)
006
006
006
00000110
ACK
(Acknowledgment)
007
007
007
00000111
BEL
(Bell)
008
010
008
00001000
BS
(Backspace)
009
011
009
00001001
HT
(Horizontal Tab)
010
012
00A
00001010
LF
(Line Feed)
011
013
00B
00001011
VT
(Vertical Tab)
012
014
00C
00001100
FF
(Form Feed)
013
015
00D
00001101
CR
(Carriage Return)
014
016
00E
00001110
SO
(Shift Out)
015
017
00F
00001111
SI
(Shift In)
016
020
010
00010000
DLE
(Data Link Escape)
017
021
011
00010001
DC1
(XON = Device Control 1)
018
022
012
00010010
DC2
(Device Control 2)
019
023
013
00010011
DC3
(XOFF = Device Control 3)
020
024
014
00010100
DC4
(Device Control 4)
021
025
015
00010101
NAK
(Negative Acknowledgement)
022
026
016
00010110
SYN
(Synchronous Idle)
023
027
017
00010111
ETB
(End of Trans.
024
030
018
00011000
CAN
(Cancel)
025
031
019
00011001
EM
(End of Medium)
026
032
01A
00011010
SUB
(Substitute)
027
033
01B
00011011
ESC
(Escape)
028
034
01C
00011100
FS
(File Separator)
029
035
01D
00011101
GS
(Group Separator)
030
036
01E
00011110
RS
(Record Separator)
031
037
01F
00011111
US
(Unit Separator)
032
040
020
00100000
SP
(Space)
033
041
021
00100001
!
(exclamation mark)
034
042
022
00100010
"
(double quote)
035
043
023
00100011
#
(number sign)
036
044
024
00100100
$
(dollar sign)
037
045
025
00100101
%
(percent)
038
046
026
00100110
&
(ampersand)
039
047
027
00100111
-39-
(single quote)
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
040
050
028
00101000
(
(left/opening parenthesis)
041
051
029
00101001
)
(right/closing parenthesis)
042
052
02A
00101010
*
(asterisk)
043
053
02B
00101011
+
(plus)
044
054
02C
00101100
,
(comma)
045
055
02D
00101101
-
(minus or dash)
046
056
02E
00101110
.
(dot)
047
057
02F
00101111
/
(forward slash)
048
060
030
00110000
0
(character 0)
049
061
031
00110001
1
(character 1)
050
062
032
00110010
2
(character 2)
051
063
033
00110011
3
(character 3)
052
064
034
00110100
4
(character 4)
053
065
035
00110101
5
(character 5)
054
066
036
00110110
6
(character 6)
055
067
037
00110111
7
(character 7)
056
070
038
00111000
8
(character 8)
057
071
039
00111001
9
(character 9)
058
072
03A
00111010
:
(colon)
059
073
03B
00111011
;
(semi-colon)
060
074
03C
00111100
<
(less than)
061
075
03D
00111101
=
(equal sign)
062
076
03E
00111110
>
(greater than)
063
077
03F
00111111
?
(question mark)
064
100
040
01000000
@
(AT symbol)
065
101
041
01000001
A
(character A)
066
102
042
01000010
B
(character B)
067
103
043
01000011
C
(character C)
068
104
044
01000100
D
(character D)
069
105
045
01000101
E
(character E)
070
106
046
01000110
F
(character F)
071
107
047
01000111
G
(character G)
072
110
048
01001000
H
(character H)
073
111
049
01001001
I
(character I)
074
112
04A
01001010
J
(character J)
075
113
04B
01001011
K
(character K)
076
114
04C
01001100
L
(character L)
077
115
04D
01001101
M
(character M)
078
116
04E
01001110
N
(character N)
079
117
04F
01001111
O
(character O)
080
120
050
01010000
P
(character P)
081
121
051
01010001
Q
(character Q)
082
122
052
01010010
R
(character R)
083
123
053
01010011
S
(character S)
084
124
054
01010100
T
(character T)
-40-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
085
125
055
01010101
U
(character U)
086
126
056
01010110
V
(character V)
087
127
057
01010111
W
(character W)
088
130
058
01011000
X
(character X)
089
131
059
01011001
Y
(character Y)
090
132
05A
01011010
Z
(character Z)
091
133
05B
01011011
[
(left/opening bracket)
092
134
05C
01011100
\
(back slash)
093
135
05D
01011101
]
(right/closing bracket)
094
136
05E
01011110
^
(caret/cirumflex)
095
137
05F
01011111
_
(underscore)
096
140
060
01100000
`
097
141
061
01100001
a
(character a)
098
142
062
01100010
b
(character b)
099
143
063
01100011
c
(character c)
100
144
064
01100100
d
(character d)
101
145
065
01100101
e
(character e)
102
146
066
01100110
f
(character f)
103
147
067
01100111
g
(character g)
104
150
068
01101000
h
(character h)
105
151
069
01101001
i
(character i)
106
152
06A
01101010
j
(character j)
107
153
06B
01101011
k
(character k)
108
154
06C
01101100
l
(character l)
109
155
06D
01101101
m
(character m)
110
156
06E
01101110
n
(character n)
111
157
06F
01101111
o
(character o)
112
160
070
01110000
p
(character p)
113
161
071
01110001
q
(character q)
114
162
072
01110010
r
(character r)
115
163
073
01110011
s
(character s)
116
164
074
01110100
t
(character t)
117
165
075
01110101
u
(character u)
118
166
076
01110110
v
(character v)
119
167
077
01110111
w
(character w)
120
170
078
01111000
x
(character x)
121
171
079
01111001
y
(character y)
122
172
07A
01111010
z
(character z)
123
173
07B
01111011
{
(left/opening brace)
124
174
07C
01111100
|
(vertical bar)
125
175
07D
01111101
}
(right/closing brace)
126
176
07E
01111110
~
(tilde)
127
177
07F
01111111
DEL
(delete)
-41-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
20
Kansspelcommissie 1ste november 2013
BIJLAGE 4 : KONINKLIJK BESLUIT VAN 23 MEI 2003
23 MEI 2003. - Koninklijk besluit betreffende de regels van toezicht op en de controle van de kansspelen in de kansspelinrichtingen klasse II, inzonderheid door middel van een passend informaticasysteem
ALBERT II, Koning der Belgen, Aan allen die nu zijn en hierna wezen zullen, Onze Groet. Gelet op de wet van 7 mei 1999 op de kansspelen, de kansspelinrichtingen en de bescherming van de spelers, inzonderheid op artikel 38, 5; Gelet op het advies van de Kansspelcommissie, gegeven op 6 november 2002; Gelet op het advies van de Inspecteur van Financiën, gegeven op 13 januari 2003; Gelet op de akkoordbevinding van Onze Minister van Begroting, gegeven op 11 februari 2003; Gelet op het verzoek om spoedbehandeling, gemotiveerd door de omstandigheid dat de volgende federale verkiezingen op 18 mei 2003 worden gehouden, daarbij rekening houdende met de voorafgaande ontbinding van de federale kamers, en de in acht name van een periode van afhandeling van lopende zaken. Gelet op advies 35.215/2 van de Raad van State, gegeven op 7 april 2003, met toepassing van artikel 84, eerste lid, 2°, van de gecoördineerde wetten op de Raad van State; Gelet op de Richtlijn 98/34/EG van 22 juni 1998 van het Europees Parlement en van de Raad betreffende een informatieprocedure op het gebied van normen en technische voorschriften, gewijzigd door de Richtlijn 98/48/EG van 20 juli 1998; Op de voordracht van Onze Minister van Binnenlandse Zaken, van Onze Minister van Justitie, van Onze Minister van Financiën, van Onze Minister van Overheidsbedrijven en Participaties, van Onze Minister van Economie en van Onze Minister van Volksgezondheid, Hebben Wij besloten en besluiten Wij : Artikel 1. In dit koninklijk besluit dienen volgende afkortingen als volgt te worden gelezen : LAN : lokaal netwerk; Cliënt : iedere elektronische eenheid, dus zowel administratieve computers als automatische spellen; UPS : Uninterruptable Power Supply Art. 2. § 1. Alle kansspelinrichtingen klasse II voorzien een LAN. Deze wordt verbonden met het LAN van de Kansspelcommissie. § 2. Alle kansspelinrichtingen klasse II beschikken over een videobewakingssysteem. Art. 3. Alle kosten voor de aankoop van het materiaal, het verkrijgen van de softwarelicenties, en de verschuldigde huurgelden zijn ten laste van de kansspelinrichtingen klasse II.
-42-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
Art. 4. Als hardwareconfiguratie wordt één centrale server voorzien die via het LAN verbonden is met alle cliënten. Een databasesoftware wordt voorzien, van die aard dat de kwaliteit, de integriteit, robuustheid en de multiple acces voldoende gegarandeerd zijn. Art. 5. Een aangepast videotoezicht systeem wordt voorzien. Personeel en spelers moeten op een gepaste manier geïnformeerd worden over het bestaan en de werking van dit systeem. De opnames worden bewaard in een aparte ruimte enkel toegankelijk voor aangewezen personeelsleden, leden van de kansspelcommissie en haar secretariaat, alsmede personen extern aan de Kansspelcommissie die zij nominatief aanwijst. De opnames, uitgevoerd op een medium naar keuze, moeten vier weken bewaard blijven en moeten op éénvoudig verzoek van de Kansspelcommissie haar ter beschikking worden gesteld. Wanneer onregelmatigheden op het spel worden vastgesteld en gefilmd, of wanneer een belangrijke ontregeling van het videotoezicht systeem wordt geconstateerd, wordt de Kansspelcommissie onmiddellijk op de hoogte gebracht. Zij beslist over de verder te volgen procedure en het verdere gebruik van de opnames. Geen enkele opname mag worden gewist of vernietigd voor deze beslissing. De opnames die te maken hebben met het spel, registratie en kassa, gebeuren vanaf de opening van de speelzaal tot het voltrekken van alle verrichtingen en tot het sluiten van de speelzaal. De overige opnames gebeuren op een permanente basis, zonder onderbreking. Art. 6. De kansspelcommissie verkrijgt een garantie, aan de hand van een broncode en een objectcode, dat het door haar goedgekeurde softwareproduct ook effectief draait. Hiertoe kan zij te allen tijde een hercompilatie vragen teneinde na te gaan of wel degelijk de officiële broncode werd gecompileerd. Art. 7. Een aangepaste UPS, met een autonomie van twee uren, wordt voorzien voor de centrale server. Wanneer de verbinding van een automatisch spel met het LAN uitvalt of eender welke hapering, mechanisch of technisch, optreedt en dit voor een periode langer dan 24 uur, wordt het spel stilgelegd met in acht name van de werkingsregels omtrent het stopzetten en hernemen van automatische spellen. Wanneer de centrale server langer dan 24 uur uitvalt, worden alle spellen stopgezet. Een procedure van back-up en recovery wordt aan de Kansspelcommissie voorgelegd, evenals het bewijs van viermaandelijkse testuitvoeringen. Art. 8. Wijzigingen, van welke aard ook, aan het informaticasysteem dienen voorafgaandelijk goedgekeurd te worden door de Kansspelcommissie. Art. 9. De toegang tot de centrale server, werkstations en programma 's moet geregeld worden volgens een systeem van paswoorden, dat voor invoering voorgelegd wordt aan de Kansspelcommissie. Het informaticasysteem en het videotoezicht systeem worden in afzonderlijke lokalen ondergebracht. De toegang is slechts toegelaten na een procedure van toegangscontrole, dat voor de invoering wordt voorgelegd aan de Kansspelcommissie. Art. 10. Het informaticasysteem is beveiligd tegen zowel elektromagnetische en elektrostatische inmenging als tegen radiogolven.
-43-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
Kansspelcommissie 1ste november 2013
***** gewijzigd door ..... ***** Art. 11. § 1. De kansspelcommissie stelt een protocol op dat de volgende elementen bevat : 1. Inhoud van dit document; 2. Definities en afkortingen; 3. Technische vereisten gesteld aan de kablering en de passieve componenten van het LAN; 4. Technische vereisten gesteld aan de actieve componenten van het LAN; 5. Technische vereisten gesteld aan de cliënten en servers; 6. Technische vereisten gesteld aan het lokaal voor het data-rack; 7. Technische vereisten gesteld aan de dataverbinding met de Kansspelcommissie; 8. Bijkomende vereisten gesteld aan het videotoezicht systeem; 9. Vereisten inzake accounting- en financiële informatie; 10. Vereisten inzake de registratie; 11. Vereisten inzake de technische controle; 12. Vereisten inzake de documentatie in verband met het informaticasysteem en het videotoezicht systeem; 13. Gebruik van nieuwe technologieën; 14. Algemene, niet specifiek topic gebonden vereisten; 15. Standaarden inzake naamgeving voor de te verzenden bestanden; 16. Goedkeuring.” § 2. Dit protocol wordt aan alle vergunninghouders klasse II bezorgd uiterlijk één week na de goedkeuring door de kansspelcommissie. Elke wijziging aan het protocol wordt aan alle vergunninghouders klasse II bezorgd uiterlijk één week na de goedkeuring door de kansspelcommissie. Art. 12. In afwijking van artikel 2, § 1, van dit koninklijk besluit kunnen de kansspelinrichtingen klasse II tot twee jaar na de inwerkingtreding van dit koninklijk besluit al hun cliënten in de kansspelinrichting klasse II, op een wijze voorafgaandelijk goedgekeurd door de Kansspelcommissie, verbinden met de centrale server. Deze dient op zijn beurt minstens eenmaal per week te worden verbonden met het LAN van de Kansspelcommissie. Art. 13. Dit besluit treedt inwerking drie maanden na de publicatie in het Belgisch Staatsblad , met uitzondering van artikel 11 dat in werking treedt op de dag van de publicatie in het Belgisch Staatsblad . Art. 14. Onze Minister bevoegd voor Binnenlandse Zaken, Onze Minister bevoegd voor Justitie, Onze Minister bevoegd voor Financiën, Onze Minister bevoegd voor Overheidsbedrijven en Participaties, Onze Minister bevoegd voor Economie, en Onze Minister bevoegd voor Volksgezondheid zijn, ieder wat hem betreft, belast met de uitvoering van dit besluit. Gegeven te Brussel, 23 mei 2003. ALBERT Van Koningswege : De Minister van Binnenlandse Zaken, A. DUQUESNE De Minister van Financiën, D. REYNDERS
-44-
Informaticaprotocol Kansspelautomaten (klasse II) Versie II_V10
De Minister van Justitie, M. VERWILGHEN De Minister van Overheidsbedrijven en Participaties, R. DAEMS De Minister van Economie, Ch. PICQUE De Minister van Volksgezondheid, J. TAVERNIER
-45-
Kansspelcommissie 1ste november 2013