Table of Contents
Services

Inhoud → Rocrail Server → Eigenschappen
- Algemeen | Trace/Logging | Services | Automatisch | Centrale | R2Rnet | Router | RocWeb | Finder | Commandotoewijzing
Clock Service
Gebruik deze service als een snellere klok gewenst is en/of alle clients gesynchroniseerd moeten worden.
Verdeler
De tijdsverdeler wordt gebruikt om de kloksnelheid in te stellen: 1…100. (Voorbeeld: een verdeler van 10 laat de modeltijd 10 keer sneller lopen dan de echte tijd.) Het volgende veld is de Client-updatefrequentie in modelminuten: 1…60. Standaard is dit elke modelminuut.
Uur/Minuut
Dit is de starttijd voor de klokservice.
De computertijd wordt gebruikt als de waarden zijn ingesteld op 24:60.
Semi-realtime
Met deze optie zijn alle snelklokfuncties beschikbaar als de verdeler op 1 staat. (Anders worden klokcommando’s geweigerd.)
Opmerking: De klok zal niet langer synchroon lopen met de hardware-computerklok.
Stop klok bij uitschakelen baanspanning
Stopt de snelklok in geval van uitschakelen.
Client Service
Op deze poort moeten de Rocgui cliënten ingesteld worden om verbinding met de server/rocrail te krijgen zodat de grafische interface/rocgui de gewenste zaken kan weergeven.
Client poort
De netwerkpoort waar cliënten mee kunnen verbinden.
Officieel toegewezen door https://www.iana.org is dit 8051.
Controlecode
De cliënt moet deze controlecode geven om schrijftoegang te krijgen.
- Dit overstemt de "Alleen de eerste kan bedienen" optie.
- Laat leeg voor normaal gebruik.
- Ondersteunde mobiele clients:
- Rocweb
- andRoc
- padRoc
Alleen de eerste kan bedienen
Voorkomt dat overige clients de Rocrail server kunnen besturen. Alleen de eerste die verbonden is kan Rocrail besturen.
WIO Watchdog
Activeert monitoring van WIO-bereikbaarheid. De timeout wordt gedefinieerd in eenheden van 10 ms.
Standaardwaarde: 700 x 10 ms = 7 seconden.
WIO’s sturen elke 4 seconden een alive-bericht.
Uitsluiten
Het uitsluiten van niet-relevante WIO’s kan worden gedaan via een CSV-lijst met ID’s.
Ook reeksen zijn toegestaan, bijvoorbeeld: 45-55.
Client-autorisatiecode
Als de autorisatiecode is ingesteld en een verbonden client deze code niet kan opgeven, worden de volgende geselecteerde functies geweigerd:
- Systeem (inclusief automatische en stroomcommando’s)
- Server afsluiten
- Wissels
- Seinen
- Uitgangen
- Rijwegen
- Locomotieven
Rocweb
Zie ook de applicatie Rocweb
Poort
Als de waarde groter is dan nul, wordt de WebClient Service geactiveerd.
Het advies is om poort 8080 of 8088 te gebruiken.
Dit poortnummer mag niet gelijk zijn aan de HTTP Service Poort.
Pad
Het pad waar de HTML-, CSS- en JavaScript-bestanden kunnen worden gevonden.\
Zie voor meer details Rocweb Configuratie.
macOS
In nieuwere Rocrail-versies moet het Rocweb-pad zijn:
/Applications/Rocrail.app/Contents/rocdata/web
Afbeeldingspad
Het afbeeldingspad voor locomotiefafbeeldingen is standaard zoals hier gedefinieerd: (Relatief ten opzichte van de actieve Workspace.)
Servermonitor
Een HTTP‑service om de serveractiviteit te bekijken en opdrachten te verwerken vanuit de RocMini Watch App.
Zie voor details dit hoofdstuk.
Port
Standaard 8008.
RocMini Korte IDs
Indien geactiveerd zal de RocMini Watch App alleen objecten verzenden die een Korte ID hebben ingesteld.
SRCP
Optionele service voor SRCP Cliënten zoals J-Man of spdrs60.
De objectadressen van deze clients moeten worden gedefinieerd in het Rocrail spoorplan.
Toestel
Optioneel serieel apparaat ter ondersteuning van SRCP.
Lijninstellingen staan vast:
- 115200 bps
- 8N1
SNMP
Activeert de SNMP v1/2c Agent in de Rocrail server.
Standaard wordt poort 161 gebruikt voor de SNMP service. Dit vereist extra gebruikersrechten:
OSNMP 0658 SNMP bind OSocket 0513 bind() failed [13] [Permission denied]
Configuratie
<SnmpService port="161" trapport="162" traphost="192.168.100.77"/>
GetRequest voorbeeld
Direct ObjectID:
$ snmpget -v 2c -c public localhost 1.3.6.1.2.1.1.1.0 iso.3.6.1.2.1.1.1.0 = STRING: "Rocrail 2.0.2508 Sunrise"
Symbolic OjectID:
$ snmpget -v2c -c public localhost SNMPv2-MIB::sysDescr.0 SNMPv2-MIB::sysDescr.0 = STRING: Rocrail 2.0.2508 Sunrise $ snmpget -v2c -c public localhost SNMPv2-MIB::sysUpTime.0 SNMPv2-MIB::sysUpTime.0 = Timeticks: (3443) 0:00:34.43
Ondersteunde commando's
- GetRequest
- GetNextRequest
- SetRequest
- BulkRequest
- Trap
IANA
- Rocrail PEN 37707
MIB
Free MIB Browser
Traps
- Cold boot
- Link up: new client connection
- Link down: client disconnected
- User:
- Shutdown
- Exception
@Box
De locatie van de @Box.
MQTT Service
Cliënten kunnen de MQTT Broker gebruiken om te communiceren met de Rocrail Server.
| MQTT Topic | Description |
|---|---|
rocrail/service/info | All server broadcasts are published with this topic name. |
rocrail/service/client | Clients can publish commands with this topic. |
rocrail/service/field | Clients can publish hardware events with this topic. |
rocrail/service/command | Command station commands for User Libraries. |
De inhoud van de MQTT berichten zijn in RCP Format.
De Rocrail Server gebruikt het MQTT V3.1 Protocol.
Hostnaam
De DNS naam of TCPIP adres van de MQTT Broker.
Poort
De netwerkpoortnummer van de MQTT Broker.
Groep
Topic groeperen
Gebruik de Item Namen in de Broadcast Topic.
Clients
Alleen Quality of Service 1 wordt ondersteund.
Clients werken ook met QoS 0, maar QoS 1 wordt sterk aangeraden.
De enige bekende Client voor deze service is het commandolijnprogramma van Mosquitto:
mosquitto_pub -p 60123 -t rocrail/service/client -m "<sys cmd=\"stop\"/>" -q 1
Broker reactie:
1467710159: New connection from 127.0.0.1. 1467710159: New client connected from 127.0.0.1 as mosq_pub_2323_rob-Virt. 1467710159: Sending CONNACK to mosq_pub_2323_rob-Virt (0) 1467710159: Received PUBLISH from mosq_pub_2323_rob-Virt (d0, q1, r0, m1, 'rocrail/service/client', ... (17 bytes)) 1467710159: Sending PUBACK to mosq_pub_2323_rob-Virt (Mid: 1) 1467710159: Sending PUBLISH to RocrailService (d0, q1, r0, m1, 'rocrail/service/client', ... (17 bytes)) 1467710159: Received DISCONNECT from mosq_pub_2323_rob-Virt 1467710159: Received PUBACK from RocrailService (Mid: 1) 1467710159: Received PUBLISH from RocrailService (d0, q1, r0, m3, 'rocrail/service/info', ... (51 bytes)) 1467710159: Sending PUBACK to RocrailService (Mid: 3) 1467710159: Received PUBLISH from RocrailService (d0, q1, r0, m4, 'rocrail/service/info', ... (175 bytes)) 1467710159: Sending PUBACK to RocrailService (Mid: 4) 1467710160: Received PUBLISH from RocrailService (d0, q1, r0, m5, 'rocrail/service/info', ... (60 bytes)) 1467710160: Sending PUBACK to RocrailService (Mid: 5)
Multicast‑ontdekkingsservice
Er is ook een UDP‑multicast‑ontdekkingsservice beschikbaar voor andere apparaten die dezelfde broker willen gebruiken.
| Host | 224.0.0.1 |
| Port | 8051 |
Het apparaat moet een bericht verzenden met de volgende inhoud:
| BROKER-GET |
Het zal het volgende antwoord ontvangen:
| BROKER-HOST:<hostname> BROKER-PORT:<port#> |
Beide regels eindigen met een regeleinde: \n
Last Will
Als de verbinding met de Rocrail MQTT‑Broker verloren gaat, kan de Last Will worden waargenomen in het topic 'rocrail/service/info':
<exception text="abend"/>
Geografische locatie
Locatie‑informatie voor het berekenen van zonsopgang en zonsondergang.
Voorbeeld
mDNS
Zie ook: mDNS Informatie
Activeer
Activeer mDNS voor Rocrail als service.
Dit kan gebruikt worden om de Rocrail‑server op te zoeken in een client zoals Rocview.
Opmerking: Schakel deze optie uit als multicast geblokkeerd is of niet gewenst.
ID
WiThrottle
![]()
Ondersteuning voor het WiThrottle‑protocol.
Bekende Apps en apparaten:
- WiThrottleTM Copyright 2009-2024 Brett Hoffman (iOS App)
- Engine Driver (Android App)
Activeer
Schakel de WiThrottle‑ondersteuning in Rocrail in. (Hiervoor is een herstart van de server nodig.)
Poort
Eerste veld: WiThrottle‑TCP‑poort. Standaard is 12090.
Tweede veld: Optionele HTTP‑poort voor iconen en afbeeldingen. (De Rocrail‑HTTP‑servicepoort kan hiervoor gebruikt worden.)
Heartbeat
Activeert de WiThrottle‑heartbeat indien ingesteld op een waarde groter dan 0.




