Einrichtungsanleitung

Schnittstelle zum Rinkmaster

Rinkmaster Interface ist ein Windows-Dienstprogramm, welches den Datenaustausch zwischen dem Rinkmaster und dem Brocker ermöglicht. Das Dienstprogramm muss auf der gleichen Arbeitsstation wie der Rinkmaster aktiv sein. 
Das Dienstprogramm erfüllt folgende Aufgaben:
  • Synchronisation der Rinkmasterdateien mit dem Scoreboardsystem. Dazu muss in der Konfiguration angegeben werden, wo die Dateien gespeichert sind/werden
  • Starten und Stoppen der Anzeige 
  • Übernahme der Resultate in den Rinkmaster

Im Rinkmaster kann ab der Version 1.15.x das Tafel-Protokoll "Scoreboard-Suite 2023" aktiviert werden. damit können beim Start eines Spieles weitere Daten zum Spiel an den Brocker gesendet werden. Es sind:

  • Bezeichnung des Spiels und die Nummer der Runde
  • Anzahl Ends
  • Extraend Ja/Nein
  • Teammitglieder 
  • Spielstand der Teams (Anzahl Punkte, Ends und Steine)
 
Das Dienstprogramm enthält eine Konfigurationsdatei, welche vor dem Start angepasst werden muss.
{
"polldirectory": "C:\\......",
"deviceid": "RM-1",
"tenant": "ccdemo",
"upload_rinkmaster_url": "https://scoreboardsuite.ch.....",
"brocker_url": "wss://sc-brocker.ch:7072/ws",
"localdatapath":"C:\\Data",
"trybeforeshutdown":5,
"instructions":[
{"rink":1, "sendToLed":false, "sendToBrocker":true, "pointsComeFrom":1},
{"rink":2, "sendToLed":false, "sendToBrocker":false,"pointsComeFrom":2},
{"rink":3, "sendToLed":false, "sendToBrocker":false, "pointsComeFrom":2}
],
"rinkMaster":{"portname": "COM5", "baudRate":9600, "dataBits":8, "stopBits":1},
"led":{"portname": "COM6", "baudRate":9600, "dataBits":8, "stopBits":1}
}
 
Erklärungen:
polldirectory: Verzeichnis, welches vom Interface überwacht werden soll. Wird eine Datei neu geschrieben, so wird sie zum Cockpit hochgeladen
deviceid: Geräte-ID wie sie in der Geräteverwaltung angegeben wurde
tenant: Mandant
upload_rinkmaster_url: Webadresse vom Cockpit 
brocker_url: Webadresse vom Brocker
device_url: Webadresse vom Cockpit für den Download der Gerätedefinitionen
localdatapath: Verzeichname, wohin das Rinkmaster-Interface Daten ablegen kann.
trybeforeshutdown: Wird nur für Led-Tafeln benötigt
instructions: Pro Rink muss ein Eintrag definiert werden. Das Interface unterstützt auch einen Parallelbetrieb mit LED Anzeigen. Pro Rink muss angegeben werden, ob die Daten zum Brocker und/oder zum LED übermittelt werden sollen. Werden beide System eingesetzt, muss zusätzlich angegeben werden, von welchem System die Punkte übernommen werden sollen.
  • rink: Rinkmummer, wie sie im Rinkmaster und im Cockpit angegeben wurde
  • sendToLed: Falls ein Ledtableau parallel eingesetzt werden soll, muss hier true angegeben werden. ansonsten false.
  • sendToBrocker: Falls der Rink (im Parallelbetrieb) in der mittels Komponenten der Scoreboard-Suite bedient werden soll, muss hier true ansonsten false angegeben werden.
  • pointsComeFrom: Eine 2 muss angegeben werden, wenn die Punkte vom Ledtableau, 1 wenn sie von der Suite abgegriffen werden sollen.

rinkMaster:Hier werden die Parameter für die serielle Schnittstelle vom Rinkmaster angegeben werden.

  • portname: Gemäss Definition im virtuellen Port oder dem physischen Port zum LED-Tafeln 
  • dataBits: Gemäss Einstellungen im Rinkmaster/Led
  • stopBits: Gemäss Einstellungen im Rinkmaster/Led
  • led: Hier werden die Parameter für die serielle Schnittstelle vom Ledtableau angegeben werden. Soll kein Parallelbetrieb definiert werden, muss der “led” weggelassen werden.

COM Interface

Für die Kommunikation zwischen dem Rinkmaster und dem Dienstprogramm Rinkmaster Interface muss ein virtueller Port Treiber eingesetzt werden. Dieser erzeugt logische Ports, welche vom Rinkmaster und vom Dienstprogramm angesteuert werden. Der Treiber muss folgende Anforderungen erfüllen:

  • Er muss dem Betriebssystem (Windows) logische Com-Ports zur Verfügung stellen.
  • Er muss logische Com-Ports „pairen“ können. Der Rinkmaster steuert einen Port an. Die Daten müssen zu einem zweiten Port geleitet werden, welcher wiederum von ScoreboardCom angesprochen wird.

Die folgenden Grafiken verdeutlichen diese benötigte Funktion:

Funktionsprinzip Virtuelle Ports

Mit folgenden Treibern konnten erfolgreich Tests durchgeführt werden:

Das Rinkmaster Interface sollte als Windows-Dienst ausgeführt werden. Das Installationspaket enthält die Konfiguration und die Werkzeuge, um den Dienst auszuschalten. Der Dienst basiert auf WinSw (siehe https://github.com/winsw/winsw).

Im Paket befinden sich einige Batchprogramme:

  • installasservice.bat installiert das Interface als Dienst
  • startService.bat startet den Dienst.
  • stopService.bat stoppt den Dienst

Der Dienst kann auch im Windows Dienstprogramm “Dienste” gestartet und gestoppt werden.