Table of Contents
RocControl
Content → Mobile Clients → RocControl
This is an exclusive goodie for supporters of the project, who have a valid Support Key installed. Without a key 5 demo minutes are available after connection. |
Introduction
RocControl is an iOS/iPadOS 16.6+ application written from scratch in the Swift language.
Its main target is iPad and Mac1), but can also be used with some restrictions on an iPhone.
App install
Gallery
mDNS
RocControl uses mDNS/Bonjour for looking up a Rocrail Server and will automatically connect.
Make sure the Rocrail Server has mDNS activated and the LAN/WLAN does support UDP Multicast.
SVG Symbols
Rocrail provides a default build-in theme for RocControl if none is set in the SVG list.
User defined SVGs must be of type Dynamic and the path must contain "dynthemes".
Images and Icons
The server will try to lookup requested images and icons in the Image and Icon path, as specified on the Rocrail server General settings.
Header symbols
Icon | Description | iPhone remark | Long press |
---|---|---|---|
A | Model time and plan title | Time only | |
B | Emergency break | ||
C | Track power | Popover system commands. | |
D | Automatic | ||
E | Throttle | Not available; Use the Drive tab. | |
F | Level switcher | ||
G | Zoom | Zoom to fit. | |
H | Menu |
Connect
If none or multiple Rocrail server was found, or option "Auto connect" is disabled, the following dialog will appear:
On top all found Rocrail servers are listet and can be connected by tapping on it.
Optionally an IP address or DNS name can be entered.
The Demo Server is only available for testing events.
Menu
Information
Settings
System
Monitoring
The Rocrail server will send important tracing to RocControl which are listed on the System Tab.
Sensor monitor
The sensor monitor will be available on a new tab.
Events are ignored in case the server is in automatic mode.
Keep screen on
Disable sleep/standby mode of the iPad.
Server ping
Activate the server ping in case of a weak WiFi connection.
Auto connect
Connect automatically if a Rocrail server is found by mDNS. (Bonjour)
A connect dialog will be shown if this option is disabled.
Power off for EBreak
Header: (B)
Sends a power off command instead of an emergency break.
Control / Slave
See:
Clear cache
Erase all loco and text images in the cache.
Cache location:
file:///private/var/mobile/Containers/Data/Application/<HASHKEY>/Documents/rocData
View
Simulate sensors
Enable simulating sensors by tapping on those symbols.
Disable scroll
Disable scrolling the on the Plan tab.
This could be of help in case of manual control with a small zoom factor to prevent sliding.
Small tabs
Show dots on the bottom instead of text tabs. (Saves space in the height.)
Level selection
Header: (F)
Show a selection list of levels instead of iterating the levels.
Module view
Show the module arrangement instead of separate levels.
Plan color
Background color of the plan tab.
Throttle
Throttle ID
The ID which is shown on the locomotive grid in Rocview.
Speed buttons
Show buttons instead of a slider for manipulating speed in the throttle.
Category
The grouping order for the loco selection list can be one of the following:
- Engine (default)
- Era
- Roadname
- ID
Step increment
Number of steps to change incase of speed buttons or slider.
SVG Theme
See: SVG Theme Properties
Add a note
See: Server Notes
Switch Control
See: Switch control
Guest locomotive
See: Guest Loco
Throttle
Shift
Activates the train functions.
If shift is active a tap on the loco image will popup the train dialog.
Long press
Button | Action |
---|---|
Image | Consist management. |
RE | Loco setup. |
Direction | Swap logical. |
Block
Long press
Button | Action |
---|---|
Image | Throttle. |
Assign | Release assigned train. |
Start | Start locomotive in virtual mode. |
Set loco
- Click on the wanted block.
- Click on the empty loco image.
- Select a loco from the popup.
- Ready.
Reset loco
- Click on the wanted block.
- Click on button "Reset occupancy".
- Ready.
Tabs
Plan
Tap
Symbol | Action |
---|---|
Block | Block dialog. |
Signal | Flip command. |
Switch | Flip command. |
Output | Flip command. |
Turntable | Track selection dialog. |
FiddleYard | Track selection dialog. |
Sensor | Flip command if simulation is activated. |
Text | Popup in case of input or flip command in case of toggle button. |
Long press
Symbol | Action |
---|---|
Block | Throttle in case block is occupied. |
Signal | If aspect names are set: Signal dialog. |
Switch | Servo setup or actions in case of accessory. |
Drive
System
Routes
Not available on iPhone.
See: Route control
Decoders
Sensors
Not available on iPhone.
See: Sensor monitor
Clock
Not available on iPhone.
See: Fast clock
Widgets
See: Loco widgets
Part | Description | Tap | Long tap |
---|---|---|---|
A | Start/stop | Start or stop automate or running speed. | |
B | Loco image | Opens the "Set destination" dialog | |
C | Speed+ | Increase the speed. | |
D | Direction | Flip running direction. | Swap placing. |
E | Block state | ||
F | Current block | ||
G | Current speed | ||
H | Speed- | Decrease the speed. | Swap block enter side. |
Timetables
Not available on iPhone.
See: Location timetables
Tracking
Not available on iPhone.
See: Tracking monitor
Turntable / FiddleYard
Split View
Starting with RocControl version 24.12.04 the split view is available for controlling locos and plan simultaneous.
Tap the icon in the left upper corner to hide/show the loco control.
Privacy policy
Rocrail, grounded in 2011 by Robert Jan Versluis, ensures that the RocControl App does not collect personal data of any kind.