Instrukcja SWDR4
System Wspomagania Dyżurnego Ruchu 4 (SWDR4) is a browser-based application linked to the Train Driver 2 simulator, based on the SWDR system previously used by PKP Polskie Linie Kolejowe (currently replaced by EDR – Electronic Traffic Register). SWDR4 enables train traffic to be managed based on timetables created for specific trains, containing the train route along with planned arrival and departure times. It is also used for communication between dispatchers, as well as between dispatchers and drivers, and for registering delays of trains with an active timetable. SWDR4 is available as a web application accessible from a browser on both computers and mobile devices. To start using SWDR4, you must first run at least one scenery in dispatcher mode in the simulator. Then, log in to the website rj.td2.info.pl using the login and password used to launch the simulator. SWDR4 allows you to control train traffic on all available servers: PL1 (main server), PL2 (secondary server for training and sessions), DE (German server), CZ (Czech server), and ENG (test server).
SWDR4 operation
Login window
The SWDR4 login window allows you to choose between two main modes of operation: dispatcher mode and editor mode. First one is used to control train traffic. Logging in into this mode without at least one scenery running will result in automatic kick from the system. The second mode is intended for authors of sceneries in order to enter scenery data into the system (after passing the scenery verification process using the Gitlab platform).

Dispatcher mode
After successfully logging in a list of sceneries launched by the user will be shown. If you have launched a scenery and it is not visible, wait a moment and refresh the page, making sure that the scenery is also visible on the right side of the list of all users and that you have selected proper server on which the scenery is running, and its state is not "NIEWPISANA DO SWDR4" (not registered into the system). In this case, you have a scenery with a wrong hash. This may happen due to an update to the scenery or its withdrawal.

Chat tab
After logging into the system with at least one scenery running, the user is taken to the "Chat" tab. Here, there is a chat window for dispatchers, a notification window, information about recent violations and tables with active dispatchers and trains in the simulator.
Dispatcher's chat
The chat window and the text input field below it are used for real-time communication between logged-in users. By default, all messages sent are public, meaning that they are visible to all dispatchers. In addition, you may encounter messages highlighted in color in the chat:
- Red - system messages and messages published by SWDR4 administrators,
- Green - communication with train drivers (messages sent with the /swdr command from the simulator),
- Blue - private messages (visible only to the sender and reciever, system messages e.g. approaching end of duty).

To send a private message to another dispatcher or train driver, click on their username from the list below the chat window or select them directly by clicking on their avatar before sending the message. You can also manually enter the name or number of the train by typing it in the input field with the sign (@) at the beginning.
Notifications
The notification window displays system information regarding changes in the hourly status of dispatchers, the removal of timetables and information about derailments.

Railway traffic safety
Between the chat and notification windows and the tables with active users, there is a section called Railway Traffic Safety. Here you can find out who, when, and where recently passed a red signal or derailed on a given server.

Online dispatchers
The Online Dispatchers contains a list of all active users acting as a dispatchers on a given server, along with their status, language and expearience level.

After logging into the system, the player is required to set the statuses of the sceneries which they are running using the buttons located in the "Status" column next to their nickname on the scenery list. Not setting the appropriate status will result in the player being kicked out of the system after a certain amount of time and will prevent them from creating and reciving new timetables.
Statuses available to dispatchers in the SWDR4 system:
- Availavble - dispatcher is available until the time specified in the status, or without limit; until then, they are required to accept trains and handle traffic at their sceneries,
- Be right back - dispatcher temporarily unavailable at the computer; prevents the creation of timetables
- Finishing soon - dispatcher is finishing their duty; status set automatically when the scheduled duty time has passed,
- No space - dispatcher is available, but the scenery cannot accept more trains due to excessive traffic,
- Unavailable - dispatcher has not yet set its status, but has logged in the SWDR4 system.
Trains online
The trains online contains a list of active train drivers on the selected server, along with information about the train number, speed, user level, their language, and location in a given region. Trains that are offline for some reason (e.g. due to loss of internet connection) are marked with a red cross - the user is then likely to have no contact with other traffic participants.

Similar to the dispatcher list, clicking on the user name (driver) opens a pop-up menu allowing, among other things, sending a message (to which the driver can reply with the command /swdr).
Timetable tab
The timetable tab shows sceneries with active trains and their timetables. Depending on the scenery, there may be oione, two or even several stations that need to be updated on an ongoing basis as trains are being dispatched. Correctly updating the data in this tab is crucial for informing other dispatchers about the situation with trains passing through sceneries.
After logging into the system, this tab will usually be empty due to the lack of active timetables. It may also happen that staffed station has been left by a previous dispatcher with existing positions still in place. Over time (and depending on the traffic situation on the server), the tab will begin to fill with information about trains passing through stations.
Timetable preview
This tab displays timetables for stations and signal boxes on sceneries launched by the user. Unlike previous versions of SWDR, there is no longer a single timetable for several stations one one scenery - all stations and signal boxes are listed separately in the timetables.
When at least one timetable is set, it will be displayed in the table of signal boxes which it runs through. The timetable table contains basic information about the train:
- K / NK - (Kursuje / Nie Kursuje) Running / Not Running - shows whether the driver with a given number is online or offline (for example, due to a lack of internet connection),
- PRZYJAZD - (Arrival) - shows scheduled and actual arrival time of the train and its expected delay / advancements in minutes,
- UWAGI - (Notes) - additional notes about the cargo being transported - "TWR" (high - risk dangerous goods) / "TN" (dangerous goods) / "PN" (special shipments),
- RODZ - Train category - when you hover over it with the cursor, full name will be shown,
- NUMER - train number,
- MASZYNISTA - nickname of the train's driver
- TRASA - (Route) - shows from which scenery and route the train will arrive, which route it will enter your scenery, and to which scenery and route it should be sent,
- POSTÓJ - (Stop) - scheduled stop of the train at a given station (ph - mandatory stop for passanger trains, pt - technical stop that can be skipped, pm - shunting such as locomotive run - around or cab change for multiple units); no stop means that the train is not scheduled to stop,
- ODJAZD - (Departure) - scheduled and actual train departure time and its expected delay / advancements in minutes,
- RELAJCA - (Total train route) - total train route i.e. its starting and ending points.
Dispatched trains from the station are marked with a green background color in the table.
Stopped trains at the station are marked with an orange color in the scheduled departure column.
Trains that have completed their journey are marked with a red background in the table - system automatically deletes them after several seconds.

Each of the tables can be collapsed at any time using the button to the left of the signal box name. The button with the eye icon on the right allows you to hide and show cleared trains. The number of all and hidden timetables is shown next to the station name.
Timetable generation
The dispatcher in Train Driver 2 is responsible not only for managing existing timetables, but also for creating them for drivers who do not yet have them. This is done using the buttons at the top of the tab, which allow you to generate timetables in two modes - automatic and manual.
Automatic mode
Automatic mode allows you to quickly list several timetable proposals for selected driver. To scelect this mode, use the "New timetable (auto)" button, which opens a new generator window. Here, select the train for which you want to create a timetable and complete the data based on the provided analysis and inspection of the train:
- Train number,
- Train type - it determines train type for later selection of the proper category (passanger, freight, light loco or other),
- Train category - if you have trouble selecting a category, ask the driver to clarify it or refer to the gelper located next to the buttons for creating timetables,
- Rolling stock type - type of vehicle driven by the driver,
- Starting point - starting point from which the timetable will be created,
- Starting route - route on the scenery towards which the new timetable will be created,
- Maximum number of sceneries - maximum number of sceneries through which the schedule will run,
- Departure in [min] - minimum departure time from the starting point (if for example the train has to be moved from the sidings to the platforms, take into account the estimated time for shunting!),
- Train timetable speed - maximum speed of the train, which should not exceed the operating speeds available for the vehicles; reference in the form of table with speeds,
- Lenght of the train - value automatically updates based on the selected train,
- TWR (high - risk dangerous goods) / Dangerous goods (TN) / Special shipments (PN) - selected in case of a consist carrying additional information related to safety and / or the transport of specyfic goods (forum thread explaining TWR and TN)

After clicking "Generuj rozkład jazdy" button and correctly filling in ther data (otherwise, information about errors that need to be corrected will appear), 10 ready timetable proposals will appear. Try to choose a proposal that does not include long stops (unless the driver wants them). You can also manually edit the ready timetables from the list provided and add additional sceneries or change their order.

Manual mode
Manual mode is a slightly more advanced form of generating a timetable. To select this mode, use "Nory rozkład (ręcznie) button. Select the information at the top of the window in the same way as in automatic mode, except for the maximum number of sceneries and starting point.
After filling in the train information, you need to plan the route for the train. Use the "Dodaj trasę" button at the bottom of the window to select the starting scenery and departure route, and then use the same button to ad further elements to the route. A previwe of the finished timetable will be displayed below the route if it has been arranged correctly and does not contain any errors (such as the wrong number of tracks on routes, or length of the train not being accepted at a given station). Keep in mind the length of stops and travel times between sceneries.

After correctly generating data, press the "Wybierz rozkład" button which will send it to the driver in the simulator. After a moment, it should also appear on the list of dispatcher timetables through which the route is set.
Managing timetables
All timetable editing options are available by left - clicking on a given timetable under the selected signalbox:
- Szczegóły rozkładu - additional information about the timetable
- Wprowadzanie godzin - module for updating train arrival, departure, and stop times
- Aktualizuj rozkład - modeule for updating timetable parameters (train number / category) or deleting them in special cases
- Skopiuj numer pociągu - optional feature for quickly copying the nuber to clipboard
- Wiadomość do następnej scenerii - optional feature that copies train number to the clipboard and opens a windows with a private message to the next dispatcher on the train's route e.g., to inform them about the train's departure


Route blocks tab
The dispatcher is also responsible for handling line blocks on their sceneries, which ensure traffic safety and prevents two trains from being sent to the same track. In the SWDR4 system, this is achieved using a replica of Eap-94 system, but individual routes and scenarious may have different types of route blocks.
Every scenery has its own set of route blocks for external routes, one for each route track. For double - trakc routes, the blocks for "tracks in the opposite direction to the main track ("left") are listed on left, while those for "tracks in the main direction ("right") are listed on the right. Remember that rail traffic in Poland is right - hand traffic, and driving on the "left" track is subject to special conditions after prior agreement with the traffic controller of the next scenery to which you are sending the train. In the case of single - track routes, there is no distinction between right and left tracks.

Route blocks can be operated using SWDR4, however it is recommended to operate them from SCS, SPK, or SPE panels in sceneries that have such control systems, especially for routes with automatic route blocks (SBL).
Basic operation of route blocks using Eap-94 replice in the SWDR4 system
In order to send a train to the next scenery, follow these steps:
- 1. From the list of timetables, check the destination scenery and the route you want to send the train on (columns "TRASA / PRZEZ" and "DO SCENERII"):

- 2. We redirect to the appropriate route and track on our scenery, and then select the destination scenery and route from the list:<br

- 3. If it is a single - track route - we ask the dispatcher for permission to connect to the block for a given train by sending him a private message with the following content: Is the route for train <train number> free?
Only after recieving a reply that the route is free do we press "Połącz" and use the red "Wbl" button. In the case of double - track route - for scheduled train, we can immediately use the "Połącz" and "Wbl" buttions.

- 4. For the rest of the process, follow the instruction for the Eap-94 route block. Details on how it works and how to use it can be found in wiki article (scroll down slightly to the section with graphical explanations of the block status).
- 5. In the case of a route with a semi - automatic route block (PBL): after the train leaves the scnery, the block connection will be automatically terminated (if the DKo button option has not been changed in the system settings). This is intentional - the block for the destination scenery will still be in place, while to for the scenery sending the train, it will reset to its initial state in order to increase throughput! For route with automatic route block (SBL), the connection will be terminated after the train occupies the second SBL block of the departure route to the next scenery.
When you accept the block from the station that is sending us a train and the previous dispatcher presses the "Wbl" button, the "Route blocks" tab in the navigation bar wiull start flashing and the block bell will ring. Once you have dealt with it, the flashing and sound will stop.
Edytor wpisów scenerii
Zakładka Scenerie
Główne okno edytora wpisów zawiera listę wpisanych przez użytkownika scenerii wraz z informacją, czy dana sceneria została zaakceptowana. Dla każdej scenerii wyszczególnione są zdefiniowane trasy oraz biała i czarna lista użytkowników, które można edytować wpisując nazwy dyżurnych.
Jeśli sceneria zawiera co najmniej jednego gracza na białej liście - tylko gracze z białej listy będą mogli uruchomić scenerię. Jeśli biała lista jest pusta - sceneria może być prowadzona przez wszystkich użytkowników - pod warunkiem, że nie otrzymali oni indywidualnej blokady poprzez wpisanie ich na czarną listę dyżurnych.
Główne okno edytora składa się z trzech sekcji
- Elementy składowe
- Trasy
- Ograniczenia prędkości
Budowę nowego wpisu należy rozpocząć od zdefiniowania wszystkich elementów składowych, takich jak:
- Szlaki zewnętrzne (tzw. "lasek" - łączące z innymi sceneriami),
- Stacje i posterunki odgałęźne
- Przystanki osobowe
- Szlaki wewnętrzne (łączące ze sobą stacje i przystanki)
- Prace manewrowe
Każda sceneria musi zawierać co najmniej jeden szlak zewnętrzny. Przebiega on od miejsca wjazdu na scenerię do pierwszego punktu widocznego w rozkładzie, np. do przystanku osobowego. Dla jazdy wewnątrz scenerii (np. z przystanku na główną stację) należy zdefiniować szlaki wewnętrzne. Jeśli na danej scenerii przewiduje się wykonywanie prac manewrowych w celu wyjazdu na dany szlak (np. stacje czołowe, węzłowe) - należy zdefiniować pracę manewrową i określić minimalny czas potrzebny na jej wykonanie. EZT, SZT i lokomotywy luzem mają przypisany skrócony czas manewrów ze względu na ograniczenie do zmiany kabiny. Dla szlaków wewnętrznych zaleca się stosować nazwy skrótowe opisujące jakie elementy łączy dany szlak wewnętrzny, np "TrMa" dla szlaku Truskawka - Malina.
Każdy z elementów składowych pozwala zdefiniować charakterystyczne dla danego typu właściwości, np. czas postoju na stacji, czas pracy manewrowej, długość szlaku, ilość torów szlaku itd. Prawidłowe wykonanie pomiarów długości szlaków ma wpływ na prawidłowe obliczenia czasów przejazdu pociągów. W przypadku stacji o dużej rozpiętości należy przyjąć zasadę, że szlaki kończą i zaczynają się w miejscu obsługi, np. w środku długości peronu czy na środku długości bocznicy towarowej.
Od niedawna jest dostępna opcja tworzenia posterunków odstępowych, które dla maszynisty nie są widoczne w rozkładzie jazdy, a powodują zwiększenie przepustowości na szlakach z samoczynną blokadą liniową (w skrócie SBL). Tworzy się je poprzez wybranie opcji "Posterunek odstępowy" z dostępnych elementów, a następnie nazwanie go jako SBL_XY, gdzie XY to nazwy semaforów SBL stanowiące nasz domniemany posterunek odstępowy. Należy jednak pamiętać o umiejętnym tworzeniu tych posterunków, ponieważ zbyt gęsta ich ilość może wpłynąć negatywnie na przepustowość szlaku i czasy przejazdu (SWDR daje minimalny czas 1 minutę na przejazd między 2 punktami na trasie). Przyjmuje się, że minimalna długość takiego odstępu wynosi tyle, ile może przejechać pociąg z maksymalną prędkością szlakową w czasie 1 minuty. Przykładowo, na szlaku z maksymalną prędkością 160 km/h minimalna długość odstępu, dająca realne czasy przejazdu na szlaku, to ok. 2666 metrów. Oczywiście wartości można, a nawet należy zwiększać, aby wychodziły one idealnie między parami semaforów SBL zwróconych do siebie plecami.
Po utworzeniu elementów składowych należy zdefiniować trasy przejazdu przez daną scenerię. Trasa to narzucona kolejność pokonywania elementów scenerii przez pociąg. Należy osobno zdefiniować trasy w kierunku A > B oraz B > A. W tym celu można skorzystać z przycisków "skopiuj trasę" oraz "odwróć trasę". Po dodaniu elementu do trasy, kolejność jego położenia można zmienić metodą przeciągnij & upuść.
Sekcja ograniczenia prędkości pozwala zdefiniować istniejące na scenerii ograniczenia. Ze względu na możliwość występowania ograniczeń podczas jazdy tylko w jednym kierunku, należy określić kierunek występowania ograniczenia. Przyjmuje się, że dla szlaków dwutorowych jazda odbywa się zawsze torem prawym, a dla szlaków jednotorowych - ograniczenie można wpisać w obu kierunkach.
Efekty pracy w edytorze można zapisać lokalnie (w pamięci przeglądarki) lub zgłosić jako gotowy wpis do SWDR4. Przed zapisem w SWDR4 wpis zostanie sprawdzony pod kątem występujących błędów. Jeśli wpis będzie wymagał poprawek, ich lista zostanie przedstawiona w podsumowaniu.
Zakładka Hashe

Razem z wydaniem wersji 2022.2.1 "Latarnia" do SWDR została dodana funkcja samodzielnego dodawania hashy scenerii i pulpitów do akceptacji w bazie wpisów. W tej zakładce po wykonaniu wpisu scenerii pojawia nam się tabela ze sceneriami posiadającymi wpis w SWDR. Wybieramy wtedy do takiej scenerii opcję "Aktualizuj hashe", a następnie w przeznaczonym do tego miejscu wklejamy hash naszej scenerii, a w części z pulpitami, wpisując odpowiednią etykietę (SCS, SPK, SPE, RASP lub SUP), dodajemy odpowiadające etykiecie hashe. Gdy wykonamy wszelkie te czynności, wysyłamy hashe do bazy do akceptacji. Wszelkie zmiany w hashach plików scenerii należy uwzględnić w tickecie scenerii na Gitlabie.
