Aug. Juni Rocrail - Innovative Software zur Steuerung von Modelleisenbahnen Es gibt ein Forum, wo Anwender von Rocrail Fragen stellen können. Rocrail ist eine proprietäre Software zur Steuerung von digitalen Modelleisenbahnen. Die Züge können manuell, vollautomatisch oder in einem Mischbetrieb. Dokumentation: ave-canada.eu?id=german#hardware. Bestellinformation: ave-canada.eu?id=gca:gca-index-de RocNetNode.
Open Rocrail properties… from the File menu if the option is not available the own workspace has to be opened beforehand in order to establish the connection to the Rocrail server:.
The Controller tab is selected, then the virtual CS vcs-1 - virtual is highlighted and subsequently deleted by pressing Delete:.
The desired CS is chosen from the drop-down menu New and added by pressing Add. The new CS is highlighted and configured after pressing Properties.
The CS has to be configured following the instructions for this CS found on the wiki. The command station has to be started up according to its manual.
Then Rocview is started and the workspace has to be opened. Once Rocview and the server are running track power can be switched on and off using the or symbol of Rocview.
It should be verified the command station is responding to the command. Mostly this can be done by watching the track power indicator of the command station.
In order to control a locomotive via Rocrail the locomotive has to be created in a first step. From the Tables menu Locomotives is chosen causing the following window to open: Now the button New is pressed.
A locomotive with the name NEW has been created. Other options do not have to be considered at the moment.
They are explained on page Locomotives: All other fields are optional and do not need any change for the time being. General for an explanation.
The address is entered here. This entry is very important as Rocrail is able to control locos with a valid address only.
The ID of the command station controlling the locomotive. As generally only one command station is used this field usually remains blank.
Some command stations Selectrix, … allow for separated buses for locomotives and accessories, respectively. In case of such a separation the bus used for locomotives has to be entered.
Generally this field remains to the default value 0 zero. This field remains unchanged generally. The number of speed steps the decoder supports or is set up to.
Values of 14, 28 and are most commonly used. These settings are not required for basic operation and should not be altered at the moment. See Options for details.
See Acceleration for details. If Percent is activated default all velocities left column! The cruise speed Rocrail uses under certain conditions in auto mode.
If a value other than 0 zero is entered this speed will be used. The maximum velocity of the locomotive. These options are commonly used for locomotives featuring different maximum velocities for forwards and backwards driving, respectively.
As no further settings on the remaining tabs are necessary for basic operation, creating of the locomotive is completed by pressing Apply.
If the General tab is selected again the new loco is now listed with its correct name. If required, further locomotives can be created following the above steps.
To control a loco the respective row on the panel is highlighted by clicking on it. The functions can be controlled by the buttons F0 to F4.
If four or less functions are defined the FG buttons show no effect. Alternatively, a loco can be controlled via a throttle window.
A throttle is opened by clicking on the or symbol on the symbol bar or by double clicking the loco in the loco panel. The title bar of the throttle window shows the ID of the controlled loco.
In case another loco should be controlled, a single click on the image above F1 opens a new window Mobile selection.
The loco to be controlled is chosen from list, then the image is clicked again. A throttle window allows for direct access to the functions F0 to F Further functions, if any, are visible after pressing FG.
The track-plan of Rocrail is used for visualisation and graphical switching of, for example, switches and signals. Loco speed commands and automatic control of the layout can, however, take place even without a track-plan via the connection of blocks through routes.
The track-plan is not to scale and thus can and should be abstracted or symbolic. A new track plan was already added automatically when the workspace was created.
The plan has the title Level 0. The title can be changed as needed, for instance to Main Line or the name of a location.
In order to be able to edit the plan Edit Panel from the Track Plan menu has to be activated. The dialogue can be closed at any time if it is not needed and be reopened from the Track plan menu Add item….
It is used for adding items to the plan:. Using the above dialogue, at first, from the left column an appropriate object type track, switch, signal etc.
Then the desired item is clicked with the left mouse button and while the mouse button is kept pressed the item is dragged to the desired position and then dropped by releasing the mouse button.
If the newly placed item does not have the wanted orientation it can be rotated see below. As an alternative, adding items can also be done by means of the context menu: The right mouse button is clicked while the pointer is at the position where the new element should be placed.
The desired item is then chosen from the menu. Every item can be rotated once it was placed on the plan. A newly placed item is active by default.
Other elemenst have to be left clicked first in order to set them activate only one at a time. As an alternative, rotating items can also be performed by means of the context menu: This action has to be repeated until the item has the desired orientation.
Items can be moved by clicking them and holding the left mouse button. With the left mouse button still pressed the item can be moved to the desired position and placed there by releasing the button.
The experienced user may also move several objects at once or even an area of the track plan as described on page Select. The item is selected by clicking it with the right mouse button and choosing select from the menu.
In the dialogue copy is activated and the dialogue is closed by pressing OK. The copied item is placed right above the original one and thus has to be moved in order to see both the original and the copy.
Items are removed from the track-plan by clicking them with the right mouse button and choosing Delete from the menu. The elements described in this chapter are necessary for basic train operations.
With tracks, switches and signals trains can be operated manually already. In this tutorial a small layout in the style of the demo layout is designed as an example.
The small example should start with a curved track in top left corner: In the left column of the Add item dialogue see chapter 5.
Step 1 in figures below. Now 12 straight tracks should be added right from the curved track. The first track is placed as explained above Step 3.
As the last used element was a straight horizontal track, the remaining 11 tracks can be added by simply clicking with the left mouse button Step 4.
Thereafter three straight tracks are plotted below the curve Step 5. Each of those three tracks has to be rotated as shown above Step 6.
Below these tracks a curved track is added as described in step 2 Step 7. This track has to be rotated, too Step 8. With this knowledge base the track circle can be completed now by adding further straight and curved tracks Step 9.
As a small exercise each central vertical straight track should now be removed. Clicking on the element with the right button, then choosing Delete from the menu is the only action to be performed Step The gaps should be closed with direction tracks displaying the wanted driving direction of the trains.
The tracks have to be rotated accordingly. The plan of an oval-shaped track circle has been created and finished with the last step.
It will be the basis for the extensions following in the next paragraphs. After the oval shaped track was created in the last paragraph it is now extended with a parallel track and the required switches.
At first two tracks are deleted from the track plan and a parallel track is drawn as shown in the figure below Step The left gap is filled with a right switch which is selected from the Add item dialogue: At first, from the left column Switch has to be selected and in a second step the right switch see screenshot in chapter 5.
The following dialogue asks for the ID of the switch which in this example is to be Sw01 Step In the same way the right gap is filled with a Left Switch named Sw In addition two curves have to be added and rotated to the correct positions.
This will complete the extended demo plan for the moment Step Two switches have been added in the last paragraph. To be able to operate them, they have to be configured as a next step.
A right click on the left switch Sw01 opens the context menu from which Properties is chosen. The following dialogue opens:.
Since the ID is already set nothing has to be changed on this tab for the time being. Pressing Help opens the wiki page describing all options.
The Position tab is skipped and tab Interface is selected:. The name of the CS see chapter 2. With CS featuring more than one bus e. Selectrix the correct bus controlling accessories has to be specified here.
With some CS the protocol used has to be chosen from the drop-down list. These two fields contain the most important information necessary to control a switch.
The address of the decoder and the output port of the decoder the switch is connected to have to be entered in these fields.
In the example switch Sw01 will get the switch address 1 see figure above. In case the position of the switch does not match the position displayed in Rocview the box Invert can be checked.
In most cases no further action in required to set up a switch. Further information is available from the wiki by pressing Help.
The configuration of the first switch is thus completed and can be confirmed by pressing Apply. After selecting tab Index both switches are listed.
Switch Sw02 is highlighted as shown below, afterwards again the tab Interface is selected. After finishing the set-up of the second switch the changes are confirmed by pressing Apply and subsequently the dialogue is closed by pressing OK.
To test switches the CS has to be powered up and the track power has to be switched on. With a click on each switch symbol on the plan displayed in Rocview the position of the switches change.
The position of a switch on the track plan must match the position of the respective switch on the layout. If the positions do not match the Invert option of the respective switch has to be checked or unchecked see above chapter.
If the switches on the layout do not switch positions at all it should be checked whether the track power has been turned on and if the CS can be controlled trough Rocview.
If the switches can be controlled via the CS directly but not using Rocrail the address es and possibly Interface IDs and Protocols have to be checked again.
If the configuration of the switches was successful on the small layout trains can be driven and directed using the switches. To achieve a more realistic train operation signals are added in the next chapter.
Signals generally are very important in railroading, but for the operation with Rocrail they are not required. Therefore, is not mandatory to set them up and they can also be supplemented at a later time.
If no signals are desired, this part of the manual can be skipped continue chapter 7. In this chapter the example layout of Step 14 in the previous chapter is extended by three signals.
From the menu Track plan the option Edit panel has to be activated again, if applicable. Afterwards three tracks are deleted from the plan as depicted in the figure below Step Right clicking on the upper gap in the track circle opens the context menu from which Signal is chosen.
A dialogue opens asking for the Signal ID. The signal shall receive the ID S The gap below is now filled with a signal named S02 and the remaining gap is closed by adding signal S The signals should be rotated to fit the driving direction as shown below Step Like the switches, signals have to be configured prior to use.
In a first step the signal on the top right position is right clicked and Properties is chosen from the menu. No changes are necessary on the General tab for the time being.
In the example it is assumed that a simple two-aspects semaphore signal driven by magnetic coils is used. This type of signal is usually connected to the same type of decoder as used for switches.
Now tab Details is selected. The Signal type is set to Semaphore signal and Aspects is set to 2 as shown in the figure below.
All other options remain unchanged and the Interface tab is selected. Interface ID and Bus are configured in the same way as described for switches. The Protocol is chosen according to the decoder in use.
The address of the signal is set to 3 addresses 1 and 2 on the example layout are already used by the two switches. Addressing is carried out for output RED setting the decoder address to 1 and the Port to 3.
Alternatively, PADA can be used: In addition, the option Switch is activated assuming the signal is connected to a simple decoder used for switches.
Often - if the signal aspects are interchanged - option Invert has to be activated, too. Finally the changes are confirmed by pressing Apply and the Index tab is selected.
The index is showing all three signals available. The second signal could be configured in the same way as the first one. However, as an exercise, signal S02 should be configured using patterns.
On tab Details the signal is again configured as a two aspects semaphore signal. The pattern is set according to the figure above.
Next tab Interface is selected and the signal address 4 is entered as shown in the figure or, alternatively, in PADA notation. Finally use patterns has to be activated.
After pressing Apply tab Index is selected, signal S03 is highlighted and again tab Details selected. The third signal is to be a three aspects semaphore signal.
Therefore on tab Details only Semaphore Signal has to be selected. After selecting tab Interface the address is entered: The signal in this example will receive the addresses 5 and 6.
In the figure below they have been entered in PADA notation. Alternatively S03 could be configured using patterns as well.
These alternative settings are shown in the figures below. If all settings are correct Apply is pressed to confirm the changes and the dialogue is closed by pressing OK.
The symbolic representations of the signals on the track plan have changed due to the settings made before: Signals S01 and S02 are shown as two-aspects signals while S03 is showing three aspects Step The configuration of the signals is completed and thereby all elements for the manual mode are readily configured.
The sample layout therefore allows driving of two alternating trains leaving it to the user to control signals and switches and to stop the trains in time.
The elements missing for automatic operation are added successively in the next chapter. With the present sample plan manual operation is possible while some essential elements for Automatic Mode are still missing.
This chapter will explain how to add and configure the plan elements necessary in Automatic Mode. Blocks, in plain language, are controlled sections where trains can stop.
Blocks usually consist of sensor sections or sensor contacts informing the software about the occupancy state, tracks and signals.
Rocrail uses a special block symbol to mark a block. The symbol, in addition, can show different states of the respective block, e.
The block symbols, however, do not represent the physical length of a block. Where blocks should be placed on the layout first of all depends on where trains should stop.
On the sample layout this is apparent from the position of the signals already placed. The track plan is modified by removing three times four tracks as shown in the figure below Step The first block is placed by right clicking the topmost gap in the plan and selecting Block from the context menu.
A dialogue asking for the Block-ID will open. The ID should be 01 for the first block. The dialogue is closed by pressing OK. If applicable, the block symbol can be positioned to fit into the gap.
In the same manner the gap below of block 01 is filled with block 02 and block 03 in placed to fit into the remaining gap Step Blocks do not need any complex configuration at the moment.
All details are described on page Blocks and its sub-pages. Signals, however, can be associated with the blocks now: Block 01 is right clicked and Properties is selected from the context menu.
In the opening dialogue tab Signals is selected. Because the signal of block 01 is located at the - side of the block signal S01 is selected from the drop-down field Signal in section Minus - side signals.
The changes are saved by pressing apply. In the same way block 02 is configured: From tab Index block 02 is selected, subsequently on tab Signals signal S02 is selected from the drop-down menu under Minus - side signals.
The changes are saved by pressing apply and from tab Index block 03 is selected. Again on tab Signals signal S03 is associated with the block.
Finally the last changes are saved by again pressing apply and the dialogue is closed with OK. All blocks will be equipped with two sensors each.
These sensors have the functions enter and in , respectively. Two sensors per block represent the standard configuration of Rocrail: One sensor at the beginning of a block enter telling Rocrail the train has arrived the block and one sensor at the end of the block in telling Rocrail the train has completely moved into the block.
The train will be slowed down when it reaches enter if the train has to stop in the particular block. Reaching in the train will be decelerated to a halt if the train has to stop.
The in -sensor also triggers clearing of the previous block. All possible sensor events and their usage are described in detail on page Sensors and Blocks.
The track plan is modified by removing six tracks from the layout as shown in the figure below Step After right clicking on the gap left of block 01 Sensor is selected from the context menu.
In the prompt the ID of the sensor has to be entered. The remaining sensors are added in the same manner:. Generally sensors are configured by simply assigning addresses to them.
Dialogue Sensors , tab General will open. Nothing is changed on this tab for the time being. The options are described on page Sensors: Next tab Interface is selected.
The Interface ID is configured in the same way as for switches. After pressing Apply the next sensor is selected from the Index -tab and the address is again entered on tab Interface.
The sensors get the addresses 1, 2, 3, 4, 5 and 6 in the order of their appearance in the list. After the configuration of the last sensor Apply is pressed and the dialogue is closed by clicking OK.
Creating routes is very easy using the Analyser. It will find any possible route and create it automatically. This chapter describes how the analyser is used, the next chapter will briefly describe how routes can be created by hand.
In the server message window the creation of four routes will be confirmed. Four routes have been generated because only these four routes are possible if the plan is used in running direction clockwise as indicated by the direction tracks: The routes generated by the analyser can be viewed after selecting Routes… from the Tables -menu:.
The four routes described above are listed on the Index -tab. If, for instance, the first route - is highlighted and subsequently the Switches -tab is selected, the automatically added switch Sw02 is found in the list.
The analyser, in addition, added route IDs to each track. Route IDs are for showing locked routes using the route representation in automatic mode.
The route IDs can be viewed after right clicking on a track symbol and selecting Properties… from the menu. If the analyser was configured according to the tip in chapter 7.
At the moment there is no need to care about those automatically generated entries but they may help to understand the underlying concept.
This section describes how routes are created by hand. In most cases the analyser can be used to create routes but sometimes it is good to know how to do this manually.
This section can be skipped if not of interest continue 7. The Index tab is shown. The first route in the list autogen-- is highlighted instead, if a new route was to be created, the NEW button had to be clicked.
Now tab General is selected. For a newly created route first of all the ID had to entered. Here, the ID was created by the analyser which is indicated by the autogen- prefix.
Very important are the lines From block and To block , respectively. The question is where which block and block side does the route start and where does it end.
In this case the route starts from the minus side of block Thus, from the drop down list in line From block 01 block 01 has to be chosen.
Then the block side is selected: Either plus or minus. The route ends at block 03, minus side: All other options are of minor importance and can be skipped they have not been altered by the analyser, too.
As usual, the Help button opens the wiki page with descriptions of all options available. Tab Speed is also not important at the moment. The next thing to consider is which switches are involved in the route, if any.
In the example case switch Sw02 is located between blocks 01 and 03 seen in driving direction. It has to be set to the correct position if the route is used.
The switch commands are configured on tab Commands:. On this tab, after the first and only entry Sw02 was highlighted, it is shown what the analyser did: It selected Sw02,sw and activated Command Straight.
If this was to do by hand, the ID of the relevant switch had to be chosen from the list, then the appropriate command Straight or Thrown for simple switches had to be selected and last the Add button had to be pressed.
If there were more switches in the route, these steps had to be repeated for all these switches. All other options and tabs are of minor importance and the dialogue can be closed by clicking Cancel.
Of course, if a new route was created first the changes are saved by pressing Apply and, if no other routes should be created, the dialogue is afterwards closed by pressing OK.
After selecting Blocks… from the Tables -menu all three blocks of the sample layout are listed:. Block 01 is highlighted as shown above and subsequently the Routes -tab is selected:.
Three routes are listed: The table below summarises the correlation between running direction and routes. These two are selected from the two topmost drop-down fields below the word ID see figure above.
Finally an event has to be assigned to each sensor: The changes are confirmed by pressing Apply. To configure block 02 the Index -tab is selected, 02 is highlighted, then the Routes -tab is selected again.
Alternatively, the arrowhead button can be used again as described in the tip concerning the addressing of sensors. The two sensors in block 02 are added in the same way as shown for block After the changes were confirmed by pressing Apply block 03 is selected from the Index -tab and the sensors and events for block 03 are edited on the Routes -tab: Four routes are presented: Both specific routes are heading towards the - side of the block.
Following again table Running Direction and Routes this time route all enter - has to be used because a train will enter at the - side of the block.
That is, route all enter - has to be selected. After all settings are done Apply is pressed and the dialogue is closed by pressing OK. In automatic mode trains are autonomously controlled and conducted by Rocrail.
It is thereby assured that switches and signals are set correctly and occupied routes and blocks are locked for further trains.
Running in Block-to-Block mode is immediately possible on the sample layout: If there is no loco present in a block the loco is placed now by either:.
The sample loco from chapter 4. If the direction arrow in the block does not point to the direction shown in the figure above the loco ID on the loco panel has to be right clicked and Swap block enter side has to be selected from the menu.
In this mode the loco or train is given a destination block prior to starting it. The destination block can be either the next block or a distant block.
However, it has to be ensured the block can be accessed using one ore more routes. To see the loco running in automatic mode for the first time it is simply dragged to block 03 Step 23 which will cause it to start immediately Step A loco, alternatively, can be started from the context menu of a block: A right click is performed on the block symbol of block 01 and Set destination… is selected: A further dialogue will open from which the desired destination block is selected and confirmed by pressing OK: Running without destination a loco is driving to the next free block available, subsequently another free block is searched for.
The choice of destination blocks, in basic settings, depends on block occupations only an occupied block is not a valid destination. If multiple free blocks can be accessed the destination is set by random choice.
In the forum this mode is often referred to as "Aquarium Mode" because trains move somewhat unpredictable like fish in an aquarium.
To run a loco without destination either Start locomotive is selected from the context menu of the block see figure in the above section, if necessary or Start all locs is selected from the Automatic menu or a double click is performed on the block symbol.
Prior to that the steps mentioned in section 8. To stop automatic mode see 8. The automatic choice of destination blocks can be manipulated by means of further settings in Rocrail.
These settings are described in detail on page Block Types and Train Types. A schedule is a list containing all blocks which should be approached consecutively.
The routes defined in chapter 7. Thus, accurate running in block-to-block mode section 8. If a schedule is started the loco should reside in the first block of the schedule, if possible.
The following describes the very basic steps only. See the wiki page on Schedules and its sub pages for more details. From the Tables menu Schedules… is selected.
The dialogue Schedules will open: After pressing New a new schedule with the name NEW is displayed: Next, tab Destinations is selected and the desired name of the schedule is entered into the field ID: After changing the name the starting block of the schedule is selected from the drop-down field Block: Block 03 and again block 01 are added in the same way.
This will result in a schedule starting in block 01, running via block 03 and ending in block The changes are confirmed by pressing Apply and the dialogue is closed by pressing OK.
In the loco settings, tab Details it has to be checked that use schedule departure time is not activated. Then, the steps described in section 8.
The loco will start in block 01, will proceed across block 03 and stop in block A location or locality consists of several blocks representing a destination site, e.
On the sample layout blocks 01 and 02 may represent the two tracks of a station. The advantage of locations is trains can choose a destination block freely within the location, e.
From the Tables menu Locations is selected. The dialogue Location opens. By pressing New a location named NEW is created:. The name NEW in the name field is overwritten by an appropriate name.
In the example the location is named Station. The name is changed by pressing modify:. By selecting blocks from the drop-down field Blocks and pressing Add blocks are added to the location.
In this case blocks 01 and 02 are added as shown below. The order of blocks in the list is important because blocks are selected in the order of appearance by Rocrail.
With the settings in the figure below this results in block 01 having priority over block The train will always enter block 01 unless it is occupied.
Only in the latter case the train will enter block As usual changes are confirmed by pressing Apply and the dialogue is closed by pressing OK.
The schedule created in section 8. The first entry line 1 in the list of destinations is highlighted. From the drop-down field Locality the Station is selected and from the second drop-down field Block the blank field is selected.
These changes are executed by pressing modify. In exactly the same way the third entry is modified. Departure times can be specified to get realistic railway time tables.
Three alternatives are available: To use timed schedules in the loco settings, tab Details use schedule departure time must be activated.
Rocrail is a proprietary software package  for controlling a model train layout from one or more computers. Users can run trains directly from a computer , or have some run automatically with manual control for any others.
Rocrail can be used from a single computer connected directly to the layout, or via any other computer on a home network , or over the Internet.
Rocrail also has an HTTP interface, which will let the layout run from a web browser. PDA and smartphone apps are available. The server program runs on a computer connected to the layout by one of the standard computer interface setups, and supports many command stations.
The Rocrail client connects to the server over a network. The client can also be used by itself to plan layouts.
There is no need for the server or the layout to be running to edit plans. Plans can be uploaded to the server after creation.