User Tools

Site Tools


rocctrl:rocctrl-de

RocControl

Übersetzung kommt noch ...


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

The RocControl app is available free of charge in the App Store:
rocctrl-appstore-en.jpeg




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

As from Rocrail 2.1.5180 a default build-in theme is provided to RocControl if none is found in the Rocweb SVG list.

RocControl needs Dynamic SVG Themes which must be listed in the RocWeb settings:

:!: The path MUST contain "dynthemes" otherwise it will not be used.


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.


Header: (H)


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

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

Add a note

Switch Control

Guest locomotive

See: Guest Loco


Throttle

Throttle. Long press on image for the consist dialog. Long press on RE for the loco setup dialog.

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

  1. Click on the wanted block.
  2. Click on the empty loco image.
  3. Select a loco from the popup.
  4. Ready.

Reset loco

  1. Click on the wanted block.
  2. Click on button "Reset occupancy".
  3. 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

Not available on iPhone.


Sensors

Not available on iPhone.
See: Sensor monitor


Clock

Not available on iPhone.
See: Fast clock


Widgets

Not available on iPhone.
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

Track selection dialog for turntables, traverser and fiddleyard:



Privacy policy

Rocrail, grounded in 2011 by Robert Jan Versluis, ensures that the RocControl App does not collect personal data of any kind.

1)
Silicon M1…M3
rocctrl/rocctrl-de.txt · Last modified: 2025/02/12 11:21 by hermannk