| This is an exclusive goody to supporters of the project, who have a valid Support Key installed.
Without a key 5 demo minutes are available after server start.
Rocweb is a WEB Browser based Rocrail client for all platforms including mobile devices.
The jQuery Mobile Toolkit 1.4.5 is used as base for Rocweb.
- Rocweb supersedes all other Mobile Rocrail Clients.
- Rocweb needs zero install; Just connect to the Rocrail server and go.
- Operating System independent
- Zero installation
- Multiple SVG theme support
- Train management
- Consist/Multihead management
- Fast clock support
- On the fly guest loco creation
- Many actions for running automatically
- Zoomable layout
- System actions
- Binary state control
- Optional speed buttons for shunting
- Many options to modify Rocweb as needed
- Control and slave codes to reduce control for guests
- Loco list categories
- Save the options on the Rocrail server in case the browser will delete all data on close
|Safari||8||OS X Yosemite, iOS 8, iOS 91)|
|Chrome||43||OS X, Windows, Linux, Android|
|Firefox||38||OS X, Windows, Linux, Android|
|Opera||29||OS X, Windows, Linux, Android|
|Edge||10||Windows 10 64bit|
A complete list of supported browsers is found on the jQuery Mobile Site.
- An up to date Rocrail installation.
- A valid Support Key installed on the Rocrail server.
- WLAN (WiFi) in case of mobile devices. The quality of the signal should be at least 50%.
In the Rocrail properties dialog there is a RocWeb Tab on which the needed port and directories can be set. This must be done for every individual Workspace.
The SVG Theme paths are identically interpreted as by Rocview.
|Install directory.||Rocrail RocWeb properties.|
In the install directory of Rocrail a directory named web should exist; If not the the Rocrail install must be updated.
If Rocrail was installed in the Applications directory the web is found here:
The web directory is found here:
- This is only an example IP address which should be replaced with the IP address of the Rocrail Server computer.
- Do not use to same port number as used for the HTTP Service Port.
The “Help/Info” dialogue of Rocview will show you the IP address.
Needs Rocrail revision 11.200+
With the optional parameter z a ZLevel can be preselected.
Example of selecting ZLevel 1:
RocwebXS is a lightweight HTML client with only the throttle as main page. It is for devices with a small display.
Speed buttons can be activated with the optional parameter speedbuttons.
The Bin State Control can be activated with the optional parameter binstate.
The language can be selected with the optional parameter lang.
The header icons are short cuts for commonly used Rocrail functions as listed below:
Source for translations: rocweb-icons-en.html.zip
The following buttons are hidden in case the display width ⇐ 640:
- Stop all locs
Both actions can also be accessed via the menu and automatic popup.
See: Init field
See: Start of day
See: Emergency break
Shutdown the Rocrail Server if its not in console mode and Rocweb is not in slave mode.
This action needs a confirmation.
Start all locos in auto mode.
This action needs a confirmation.
Stop all locs in auto mode.
Reset all except for block reservations.
This is for tracing issues with Rocweb. Normally this option should be disabled to avoid using too much system resources.
Enable a click on a sensor symbol to simulate a sensor event.
To list up schedule which contains a block but its not at the first entry.
This option is used in the Block popup.
Switch directly to module view in case the loaded plan is modular.
Show the occupancy in tracks, signals and sensors related to a block.
Disable to increase performance.
Show routes over tracks, sensors and signals.
Disable to increase performance.
See: Show routes on switches
Disable to increase performance.
Send new speed commands wenn moving the speed slider.
The delta is 3 to avoid too much commands.
In the mode the slider will not be updated by loco events.
Replaces the slider with two buttons for controlling the loco speed.
|Register||Set = 1||Reset = 0|| Primary
Buttons for Vmin, Vmid, Vcru and Vmax.
Show block the ID in front of the Loco ID in occupied normal blocks.
Show Train ID in block.
Show Loco Images in block symbols.
Add an extra panel with an Analog Clock.
Shows the second hand in the fast clock.
This option needs extra CPU resources depending on the amount of traffic.
The loco selection popup can be ordered by these three categories:
The loco selection popup can be sorted by these two attributes:
- Decoder Address
A user defined background color in RGB format.
The check button must be clicked to take over the new values.
In case of “Speed buttons” or “Use all speed steps” this value is used to increase and decrease the loco speed.
See: Control code
See: Slave code
Save the Rocweb options on the Rocrail Server.
If the used browser deletes all data after closing it the options will be requested from the server at Rocweb start .
The Rocweb options are saved in the rocrail.ini in the node http→webclient→rocweb:
<http port="0" refresh="0"> <webclient port="8088" refresh="0" me="true" imgpath="/Users/rob/Projects/Rocrail/unxbin/virt/images" webpath="web" svgpath1="svg/themes/SpDrS60" svgpath2="svg/themes/Accessories" svgpath3="svg/themes/Roads" svgpath4="." svgpath5="."> <rocweb binstate="true" allspeedsteps="false" category="engine" color="blue" debug="false" lang="nl" locoSelected="E03" locoSelected0="NS2418" locoSelected1="E03" locoSelected2="" locoSelected3="" moduleview="true" monitor="true" scale="1" secondhand="true" showblockid="true" showlocoimage="true" showocc="true" showroutes="true" showtrainid="true" simsensors="true" slavecode="33" sliderdelta="5" speedbuttons="false"/> </webclient> </http>
To add a loco on the fly a guest loco can be added.
At least the address must be set before add.
See for more information: Rocview Guest Loco
If the Trace option is activated this popup shows the last trace lines in reverse chronological order without time stamp:
This popup will be updated, when visible or not, if new lines come in.
Lines are starting with the trace level in brackets.
The Clear messages button removes all trace lines.
With the level selector another level can be activated.
Select a background color.
The user defined color can be set in the Options Popup.
A reload of the page is needed and will be automatically requested.
Select the wanted language to use with Rocweb:
- Russian (русский язык)
Missing your language, or if you wish a change of translations? Report it in the Rocweb Forum.
|Speed slider|| Optional Speed Buttons instead of slider. |
| Optional Binary State Control field. |
| Optional speed preset buttons.
The lines under the loco image are:
- Loco ID, train ID(length,weight) and [mode].
- Loco description.
- Slave locos of the consist. If the selected loco is self a slave, the master will be listed as first. A click on the master ID will select the master loco in the throttle.
|Loco image||Opens the block popup if the selected loco is in a block|
|F5||Add a car to the train|
|F6||Leave a car from the train|
|F7||Load a car of the train|
|F8||Empty a car of the train|
|F9||Add a consist loco|
|F10||Delete a consist loco|
|F11||Show the complete consist including the master loco|
|F13||Manual mode ON/OFF (Zimo MX10)|
|F14||Shunting ON/OFF (Zimo MX10)|
Go to the next track.
Go to the previous track.
Go to the selected track from the list.
|Half automatic||Set the loco in manual mode|
|Soft reset||Reset the loco from manual mode|
Select another loco from the list to set in this block.
If no loco is in this block one can be selected after clicking on the dummy loco image:
With a long click the loco will be removed from this block.
Use a long click on the loco image.
Select a schedule or tour from this drop down list to use with “Start train”.
Default only schedules and tours are listed which starts in this block. In the options menu this can be changed.
Select a destination block from this drop down list to use with “Start train”.
If a schedule is also selected the block destination will be ignored.
Assign a train selected from the list.
To release a train if the first item, “Train”, of the list is selected.
Start the train in this block in automatic mode with the optional selected schedule or tour.
Stops the train in this block running in automatic mode.
Start the train in this block in half automatic mode with the optional selected schedule or tour.
Reset the loco in this block without removing it from the block.
See: Block enter side
Open or close this block.
The loco selection is used in the throttle and block popup by clicking on the loco image.
The categorie type can be changed in the Options.
A loco consist can be managed using the following long clicks in the throttle:
|F9||Add a consist loco||Opens al loco selection list without the already existing members.|
|F10||Delete a consist loco||Opens al loco selection list with all existing members.|
|F11||Show the complete consist including the master loco.|
A click/touch on the level title will open the fast clock popup:
The Set, Freeze and Resume commands can be used.
See for more information: Clock Service Commands.
Note: On small devices the title is probably hidden; Landscape could help out.
If a text field has set the option “Fast clock” this popup can also be activated by a click/touch on that text field.
|The clock is not available in module view.|
An extra level is generated for the analog clock:
A click/touch on the clock will open the Fast Clock popup.
The used SVG is based on the 3Quarks SVG Railway Station Clock. (http://www.3quarks.com/images/svg/german-clock.svg) 3)
To show feedback if an object was really touched the background will get a red color until an event came in for this object from the Rocrail server.
|Touch red background.||Normal background color after the event came in.|
Rocweb can show the module layout in one level:
This example shows 6 modules.
See for more information about this layout: Plan-F.
BlockID : LocoID _ TrainID BlockEnterSide
On small devices, like smart-phones, the best way to get the full screen for Rocweb is to add it to the home screen.
- On iOS with Safari
- On Android with Chrome
Some browsers offer to create a shortcut on the Desktop for a Web-App like Chrome:
Check the plan if it is XML well formed with a tool like "XmlSpy".
Or use the W3C service: http://validator.w3.org/#validate_by_upload
- rocweb-flyer-de.pdf (Holger)
This video explains the operation of a layout by Rocweb (in German). It includes the following chapters:
- Installation and setup
- Starting Rocweb in a web browser [03:40]
- Operating Rocweb part 1 (basic configuration, options, system) [07:52]
- Operating Rocweb part 2 (layers, zoom, track power, automatic mode) [11:46]
- Operating Rocweb part 3 (loco functions) [13:36]
- Operating Rocweb part 4 (switches, signals, block functions and a concluding demo) [18:40]