GamesOnTrack

Content → Command Stations → GamesOnTrack

Introduction

Rocrail uses the raw position data provided by GTcommand as TCP/IP stream.
GPS coordinates must be setup in the sensor objects.

GT-Position IP interface

Windows XP, Vista and 7

Setup

Setup GTcommand

Add the tcpsendpos command line option to the GTcommand.exe shortcut or cmd file.
Activate recording of data by starting GT-Command, choosing files/record position data and check recording.

"C:\Program Files\GamesOnTrack\GTcommand\GTcommand.exe" tcpsendpos:15010

Position data

Data is delivered in a comma-separated string. For every receiver there is an ID, distance and level:

<Time>, <Sender ID>, <valid measurement>, <x>, <y>, <z>, <Receiver ID>, <Distance>, <Level>

<Time>	Milliseconds after start
<Sender ID>	The specific transmitter ID, can be seen on the label
<valid measurement>	1 for valid measurement, 0 for invalid
<x>	The x-coordinate in mm
<y>	The y-coordinate in mm
<z>	The z-coordinate in mm (is normally negative in a right handed coordinate system)
<Receiver ID>	The specific receiver ID, can be seen on the label
<Distance>	The measured distance in mm
<Level>	The level of the measured ultrasound signal at the receiver. From 0-1000, with 0 being the lowest.

Example records

Time  SID   v  X    Y    Z   RID1           RID2           RID3
55924,11000,1,1190,871,-1435,20104,2059,918,20103,1727,966,20105,1498,999;
56074,11015,1,1055,712,-1430,20104,1937,912,20103,1756,922,20105,1312,865;
56224,11000,1,1189,873,-1434,20104,2056,917,20103,1726,960,20105,1503,987;
56374,11015,1,1052,716,-1430,20104,1930,910,20103,1756,925,20105,1320,860;

Interface

Interface ID

Unique interface name to be used in the GPS sensors.

Hostname

The name of the computer on which the GTcommand is running.
Most likely not "localhost" if Rocrail runs on Linux or Mac.

Port

Default 15010.

Section Mode

Section mode will be enabled in case the port number is set to 29910.
The GTCommand.exe must be started with command line option "-itrain".
If the section comment, set in GoT, is at least 3 characters long, it will be used as Rocrail Sensor ID instead of "Sn".

Sensors

Set the IID the same as for the interface.
Set sensor type to GPS.
Set sensor address to a unique virtual number within the GPS scope.
Setup the GPS coordinates and tolerances to meet the sensor section. (All in millimeters.)

Coordinates & Tolerances

The black dot represents the X,Y Coordinate.
The distance between the black dot and the borders are the tolerances.
The same is for the Z value.
The GT-Position tolerance is 10mm.

Links

Test

After receiving a start package the software has been setup on Win7 running in VirtualBox. OK, no problems.
All receivers and sender units has been activated.
The TCP/IP stream reports at start:

Connected to: GTcommand version 3.6.2

Position data will follow if the sender is displayed in the scenario.

See the manual on how to setup the receivers.

Innovative Model Railroad Control System

Table of Contents