Android Studio Project

Find the project files and README at /14ss-railway/code/gui/android.

Android App

Download the app from app-release.apk (Stash) or railway.apk (direkt link).

App Features

Global controls are connect/disconnect to/from the server specified in the settings, sending messages, shutting down the controller and opening the app's settings screen.

The first screen shown by the app on initial start is the settings screen.

Settings screen

settings.png

Edit the app's settings:

  • Host and port of the PC running the railway controller.
  • (De-) activate automatic polling of status information.
  • Period of automatic polling.

 

 

Exit the settings by clicking the app icon in the upper left or by pressing 'back' on your device.

 

Status Screen

main.png

Displays general status information and controls and the list of trains.

General controls are setting pause, debug or lights on/off and activating the cleanup function.

 

Short click a train to edit it's parameters.

Long click a train to force start or stop it.

Swipe left to get to the log/error screen

Edit train

Editing trains is divided into three parts.

To apply the changes of the current screen, click the save icon in the upper right to send the command to the controller.

Schedule

schedule.png

Edit the train's schedule by adding, removing or changing entries. Each entry can be picked from a popup list.

 

 

 

 

Swipe left to get to the speeds section.

Speeds

speeds.png

Edit the train's speeds for SLOW, CAUTION and NORMAL by selecting or entering the desired value.

 

 

 

 

Swipe left to get to the waiting times section.

Waiting times

times.png

Edit the train's minimum waiting times and the maximum random offset for each station and platform.

 

 

 

 

Leave the train edit screen by clicking the app icon in the upper left or by pressing 'back' on your device.

Start/stop a train

forceWaitStart.png

When a train is travelling, forcing it to stop causes the train to wait in the next station until 'Force start' is clicked.

When a train is already waiting in a station but it's waiting time is counting down, force stop causes it to stay in this station until it's force started.

When a train is forced waiting in a station, force start causes it to leave the station as soon as possible (other trains may block it from leaving).

Log/error screen

log.png

Shows log and error messages received from the controller.

If this view isn't visible, the amount of unread errors is displayed in the tab title and a notification is shown on new errors.

 

 

 

 

Tags: