User Tools

Site Tools


rocctrl:rocctrl-en

RocControl

English Version Deutsche Version Version Française ContentMobile ClientsRocControl


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

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.


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

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:


Split View

Starting with RocControl version 24.12.04 the split view is available for controlling locos and plan simultaneous.

Settings → View → Split view Loco Widgets Throttle

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.

1)
Silicon M1…M4
rocctrl/rocctrl-en.txt · Last modified: 2024/12/04 08:53 by rjversluis