This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
rocrailini-service-en [2019/04/21 10:37] rjversluis [MQTT Service] |
rocrailini-service-en [2020/04/12 14:59] (current) rjversluis [WIO Watchdog] |
||
---|---|---|---|
Line 2: | Line 2: | ||
[[:english#rocrail|{{ :server.png}}]][[:english|{{ :rocrail-logo-35.png}}]] | [[:english#rocrail|{{ :server.png}}]][[:english|{{ :rocrail-logo-35.png}}]] | ||
[[english | Content ]] -> [[english#rocrail|Rocrail Server]] -> [[rocrailini-en | Configuration]] | [[english | Content ]] -> [[english#rocrail|Rocrail Server]] -> [[rocrailini-en | Configuration]] | ||
- | * [[rocrailini-gen-en|General]] | [[rocrailini-trace-en|Trace]] | **Service** | [[rocrailini-automode-en|Automatic]] | [[rocrailini-controller-en|Controller]] | [[:networking-en|R2Rnet]] | [[:rocrailini-analyser-en|Analyzer]] | [[:rocrailini-rocweb-en|RocWeb]] | [[:finder:finder-en|Finder]] | [[:rocrailini-cmdmapping-en|Command Mapping]] | + | * [[rocrailini-gen-en|General]] | [[rocrailini-trace-en|Trace]] | **Service** | [[rocrailini-automode-en|Automatic]] | [[rocrailini-controller-en|Controller]] | [[:networking-en|R2Rnet]] | [[:rocrailini-router-en|Router]] | [[:rocrailini-rocweb-en|RocWeb]] | [[:finder:finder-en|Finder]] | [[:rocrailini-cmdmapping-en|Command Mapping]] |
* [[clockservice-en|Clock Service]] | * [[clockservice-en|Clock Service]] | ||
// \\ // \\ | // \\ // \\ | ||
- | ==== Rocrail Service tab. ==== | + | ===== Rocrail Service tab. ===== |
{{rocrailini-service-en.png}}\\ | {{rocrailini-service-en.png}}\\ | ||
Line 22: | Line 22: | ||
Use this service if a faster clock is wanted and/or all clients must be synchronized. | Use this service if a faster clock is wanted and/or all clients must be synchronized. | ||
====Divider==== | ====Divider==== | ||
- | The time divider is used to setup the clock speed: 1...100\\ | + | The time divider is used to setup the clock speed: 1...100. (Example: A divider of 10 will run the model time 10 times faster than real time.)\\ |
- | The next field is the update frequency in model minutes: 1...60\\ | + | The next field is the Client update frequency in model minutes: 1...60. Default is every model minute.\\ |
====Hour/Minute==== | ====Hour/Minute==== | ||
This is the start time for the clock service.\\ | This is the start time for the clock service.\\ | ||
Line 41: | Line 41: | ||
The official assigned port by IANA is **[[iana-rcs|8051]]**. \\ | The official assigned port by IANA is **[[iana-rcs|8051]]**. \\ | ||
- | ==== Max. number of clients ==== | ||
- | Default 10 clients are allowed to connect concurrently to the Rocrail server. | ||
==== Only first can control ==== | ==== Only first can control ==== | ||
Prevent secondary clients controlling the Rocrail server; only the first one connected has control.\\ | Prevent secondary clients controlling the Rocrail server; only the first one connected has control.\\ | ||
- | A better solution is the use of Control or Slave Code.\\ | + | A better solution is the use of Control or Slave Code. |
+ | \\ | ||
+ | ====WIO Watchdog==== | ||
+ | Enables monitoring of WIO reachability. The timeout ist defined in units of 10 ms.\\ | ||
+ | Default: 700 x 10 ms = 7 seconds.\\ | ||
+ | WIOs are sending every 4 seconds an alive message.\\ | ||
==== Control code ==== | ==== Control code ==== | ||
The client must provide this control code to get write access if set.\\ | The client must provide this control code to get write access if set.\\ | ||
Line 55: | Line 57: | ||
* Rocweb | * Rocweb | ||
* andRoc | * andRoc | ||
- | * iRoc | ||
* padRoc | * padRoc | ||
Line 155: | Line 156: | ||
^ MQTT Topic ^ Description ^ | ^ MQTT Topic ^ Description ^ | ||
| ''rocrail/service/info'' | All server broadcasts are published with this topic name. | | | ''rocrail/service/info'' | All server broadcasts are published with this topic name. | | ||
- | | ''rocrail/service/client'' | Clients can publish commands with this topic. | | + | | ''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/field'' | Clients can publish hardware events with this topic. | | ||
| ''rocrail/service/command'' | Command station commands for __**[[:digint:user-en|User Libraries]]**__. | | | ''rocrail/service/command'' | Command station commands for __**[[:digint:user-en|User Libraries]]**__. | | ||
Line 161: | Line 162: | ||
The payload of the MQTT messages are in __**[[:rocrail-server-scripting-en|RCP Format]]**__.\\ | The payload of the MQTT messages are in __**[[:rocrail-server-scripting-en|RCP Format]]**__.\\ | ||
The Rocrail Server uses the __**[[http://public.dhe.ibm.com/software/dw/webservices/ws-mqtt/mqtt-v3r1.html|MQTT V3.1 Protocol]]**__.\\ | The Rocrail Server uses the __**[[http://public.dhe.ibm.com/software/dw/webservices/ws-mqtt/mqtt-v3r1.html|MQTT V3.1 Protocol]]**__.\\ | ||
- | |||
====Hostname==== | ====Hostname==== | ||
The DNS name or TCPIP address of the MQTT Broker.\\ | The DNS name or TCPIP address of the MQTT Broker.\\ | ||
Line 212: | Line 212: | ||
Both lines ends with a linefeed: ''\n''\\ | Both lines ends with a linefeed: ''\n''\\ | ||
+ | \\ | ||
+ | ====Last Will==== | ||
+ | If the Rocrail MQTT-Broker connection get lost, the //Last Will// can be observed in topic ''rocrail/service/info'': | ||
+ | <code xml> | ||
+ | <exception text="abend"/> | ||
+ | </code> | ||