Services

Inhoud → Rocrail Server → Eigenschappen

• Algemeen | Trace/Logging | Services | Automatisch | Centrale | R2Rnet | Router | RocWeb | Finder | Commandotoewijzing

Gebruik deze service als een snellere klok gewenst is en/of alle clients gesynchroniseerd moeten worden.

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.

Dit is de starttijd voor de klokservice.
De computertijd wordt gebruikt als de waarden zijn ingesteld op 24:60.

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.

Stopt de snelklok in geval van uitschakelen.

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.

De netwerkpoort waar cliënten mee kunnen verbinden. Officieel toegewezen door https://www.iana.org is dit 8051.

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

Voorkomt dat overige clients de Rocrail server kunnen besturen. Alleen de eerste die verbonden is kan Rocrail besturen.

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.

Het uitsluiten van niet-relevante WIO’s kan worden gedaan via een CSV-lijst met ID’s.
Ook reeksen zijn toegestaan, bijvoorbeeld: 45-55.

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

Zie ook de applicatie Rocweb

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.

Het pad waar de HTML-, CSS- en JavaScript-bestanden kunnen worden gevonden.\
Zie voor meer details Rocweb Configuratie.

In nieuwere Rocrail-versies moet het Rocweb-pad zijn:

/Applications/Rocrail.app/Contents/rocdata/web

Het afbeeldingspad voor locomotiefafbeeldingen is standaard zoals hier gedefinieerd: (Relatief ten opzichte van de actieve Workspace.)

• Algemeen afbeeldingspad

Een HTTP‑service om de serveractiviteit te bekijken en opdrachten te verwerken vanuit de RocMini Watch App.
Zie voor details dit hoofdstuk.

Standaard 8008.

Indien geactiveerd zal de RocMini Watch App alleen objecten verzenden die een Korte ID hebben ingesteld.

Optionele service voor SRCP Cliënten zoals J-Man of spdrs60.
De objectadressen van deze clients moeten worden gedefinieerd in het Rocrail spoorplan.

• http://www.der-moba.de/index.php/Digitalprojekt#SRCP-Clients
• SRCP scripting

Optioneel serieel apparaat ter ondersteuning van SRCP.
Lijninstellingen staan vast:

• 115200 bps
• 8N1

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]

 <SnmpService port="161" trapport="162" traphost="192.168.100.77"/>

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

• GetRequest
• GetNextRequest
• SetRequest
• BulkRequest
• Trap

• Rocrail PEN 37707

Management Information Base

• rocrail.mib.zip

• http://www.ireasoning.com/downloadmibbrowserfree.php

• Cold boot
• Link up: new client connection
• Link down: client disconnected
• User:
  • Shutdown
  • Exception

De locatie van de @Box.

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.

De DNS naam of TCPIP adres van de MQTT Broker.

De netwerkpoortnummer van de MQTT Broker.

Topic groeperen
Gebruik de Item Namen in de Broadcast Topic.

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)

Er is ook een UDP‑multicast‑ontdekkingsservice beschikbaar voor andere apparaten die dezelfde broker willen gebruiken.

Het apparaat moet een bericht verzenden met de volgende inhoud:

Het zal het volgende antwoord ontvangen:

Beide regels eindigen met een regeleinde: \n

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"/>

Locatie‑informatie voor het berekenen van zonsopgang en zonsondergang.

Speyer(D):

• https://latitudelongitude.org

Zie ook: mDNS Informatie

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.

De Rocrail Server ID, standaard "Rocrail".

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

• WiThrottle^TM Copyright 2009-2024 Brett Hoffman (iOS App)
• Fremo wiFred
• Engine Driver (Android App)
• ESU Mobile Control Pro

Schakel de WiThrottle‑ondersteuning in Rocrail in. (Hiervoor is een herstart van de server nodig.)

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.)

Activeert de WiThrottle‑heartbeat indien ingesteld op een waarde groter dan 0.