User Tools

Site Tools


rocrailini-service-nl

Services

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

MIB

Management Information Base

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.
:!: A valid support key is necessary; Without key only 5 demo minutes.
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

Speyer(D):

breedtegraad 49.32083
lengtegraad 8.43111


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

De Rocrail Server ID, standaard "Rocrail".
mdnsid.jpg

WiThrottle


Ondersteuning voor het WiThrottle‑protocol.
Bekende Apps en apparaten:


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.

rocrailini-service-nl.txt · Last modified: 2025/12/21 22:07 by ericvb