#gruemenu.grue

Short guide

updated for version 1.1.3.

Here is a short guide how to use this software.

After you have installed into the game folder as per installation intructions (see last menu) means that the program is ready to use.

 

 

DRIVER's SIDE

The plugin sould start working soon after the user enters a session in game automatically and the data will be available for transmission.

 

Before starting the game, the driver must initiate the program that will transmit telemetry to the other PC inserting the remote PC's IP

 and click the "broadcast data" button.

For local use leave the default "127.0.0.1" IP and at any case open the port at router's and O/S firewall that will use to transmit the data.

When communication with receiver is established both "Data transmission" and "Server status" boxes will turn green and that means everything works okay.

 

MANAGER's SIDE

Manager's application is far more complex of course cause it has a variety of options for the best possible data display.

Data link

The first step is to complete the data link with the data source, the driver's pc, which is as simple as clicking at "Start data reception" button.

Same as driver's program the data receiver must have configured the port to accept incoming data through firewalls

If the program is used in spectator mode the relative box must be checked before initiating data reception.

When everything works correctly the "Data reception" box will turn green and the driver's name will be displayed or "Spectator" if in spectator's mode.

The "belts"

Soon after link is completed with remote pc, the sets of tools that are called "belts" on the top of the window are now enabled and the user can explore the options that has for the most suitable data display.

The “basic belt”, the “advanced belt” and the strategy belt are actually a toolbox carrying seperate modules which display the received data with various kinds of format.

 

The "basic belt"

The idea behind the basic belt is to display all the basic telemetry as received from the vehicle, without any further processing and without any graphical aids.

prorf2manager02.png

For example below is an image showing the car data module:

prorf2manager03.png

Most of the times the basic belt wont be used at all from the user unless there is need to check data that are not included in the advanced belt.

 

The "advanced belt"

This belt consists of the advanced modules of the basic belt (marked with “+”) and two new modules, GPS and Full timing.

A simple look at the “Car data +” module will leave no doubt about the “spirit” of advanced belt.

prorf2manager05.png

The "strategy belt"

This belt is brand new to the current release of the program. Mainly created for managers but also spectators can get useful info when in a race session.

Every single module of this set of tools processes scoring/timing data displaying them in a way that the user can easily understand hat has happened in the race so far.

"Race synopsis" for example is giving a general review of the race indicating the drivers' positions, pit stops and tyre compound, personal best lap, lost or won places and weather info.

"Session timing" is a classical history book of each driver's times per lap and per stint. Also displays tire compounds data so the manager can study the stints for his driver and his rivals and give the info back to the driver possibly helped to decide the best strategy for the race.

"myPitwall" is a tool that that tries to fill the needs of a manager that wants to calculate, foresee and take the best decision for his driver's race. Processes info such as per lap,average,ideal and laps to go for fuel consumption and tires wear clearly save calculations time and helps the manager decide the best race strategy. There is also a per stints time gap for drivers in front and behind of the driver of interest with tires/stint indication giving a good image of the race pace and gaps for the near rivals.

    

 

How to use the modules

Using the modules is as simple as using desktop applications.

Simple left click on them will result in opening the module in a window, free to move at any position,change size, minimize or close.

On the other hand a right click will result the display of a modules panel where the modules are attached and can only move in that area.

Some modules have special characteristics like the . . .

GPS module

prorf2manager06.png

 

One settings panel will appear at the bottom end of the main program window.

prorf2manager07.png

The telemetry data from the vehicle do not carry any track layout information, so the module can not design the track if not provided those data.

Such data are included in each track’s .aiw file and the GPS module can read them.

Getting the .aiw file out of the .mas location file is a task for the user that can be achieved with 2 ways:

  1. Use the mas utility provided by the game, extract the track .aiw file and move it to bms_temp folder in rfactor2 root directory.

  2. Use the QuickBMS third party software (included in the manager’s package) which can easily be handled through the .mas extractor which can be called clicking on the relative button at the right end of the GPS settings panel.

 

prorf2manager08.png

 

As soon as the user selects the file and press the Extract button it will be moved to the appropriate folder and the track list will be updated. ready for use.

An other way to have a track layour is to let the car draw it. When the car is out of pits the user must check on Record path box and the track will start being designed. When the lap is completed uncheck the same box and Save recorded track for future use.

I strongly suggest using the original track .aiw file to draw the track, however if thats not possible recording the path will also do the job.

The rest of the modules are pretty easy to use and understand.

 

The "Car data+" module

When selecting this module you get a visualised indication of the car's main values and condition.

One of those values is brakes temps which is displayed graphically using a coloured bar, blue for cold and red for hot brakes.

To determine which value is cold and which is hot for different cars there is an option to load the car's physics using the QuickBMS tool again and have a correct display of the brakes temperatures.

Step 1 click on the button below the belt

Step 2 appears the brakes temps window, the user can either set the values manually if already knows them or select to read from file.

Step 3 the .mas extractor window opens where the user must select the .hdv (car physics) radio button so that the program can filter this type of files only from the .mas file.

If the .mas contains a car physics file the user selects "Extract selected files" and the values are transfered into brakes temps window in the appropriate boxes where the user can save.

The "Car data+" module will know adjust the brakes temps bar to those min/max values.

 

The "Full timing" module

This module is possibly the one that gives the most compact info for the race flow. Full timing per sector and with max speed indication, racer's info, positions changes visual indication, tires compounds name, laps, pits status indicating in-stop-out of pit lane times and more.

Colours are used to help the user read the race status better.

The driver that sends telemetry data is marked with yellow but there are other options for the user to help follow specific drivers in race.

Left click will mark a driver's line red which means the driver's timing is available at "Timing+" module instead of the "yellow" driver. Uncheck the "red" driver left clicking the "yellow" driver

Right clicking one of the drivers will result the drivers marked grey simply for better tracking, nothing else changes.

In spectator's mode there is no "yellow" driver because no driver is sending telemetry data but other options are available.

All the coloured drivers are also marked at "GPS" module.

Clicking at any column label will show a list with all the available data of the module and the user can select which of them will be displayed or not.

 

Saving & restoring modules positions

As soon as the user is comfortable to the modules and decides to use them often there is an annoying routine to select and put every module to a comfortable place.

In the “strategy belt” there is a box called “modules schema” which allowes the user to save and load the positions of the modules windows.

For example the manager needs to save the modules that he has now put in place while in a test session.

As soon as everything is working okay and modules are in comfortable position goes to “strategy belt”, puts a suitable name at the box and Save.

prorf2manager09.png

The next time that the user will need to use the same modules positioning, when the link establishes, goes to “strategy belt” selects the schema he wants and loads it.

The schema modules will open and position themselves automatically in no time !!

 

The charts belt

The charts belt was brought with the 1.1.2 version and is an other tool for the manager to monitor the vehicle's telemetry.

The Data channels moduled

The simplest module in the belt, a window that displays all the data received from the driver's vehicle in raw numbers !! 

The user can select to monitor all data or by categories, vehicle,engine,input, wheel data etc

There is no other functionality for now.

The charts module

One of the most important additions so far to the list of available tools for the user.

All the received telemetry can now be displayed in time charts which allows better monitoring and conclusions extract.

The charts window may look a bit complex but is actually simple to use and offers many option about the graph the user want to make.

First of all the user must create a new chart or select from a predefined list.

New chart

After the user opts for new chart he needs to input the name.

The given name will show in the nearby box title and now the chart lines must be defined to show specific data.

The user selects new line, the data channel to display, the axis and the color of the line. With the apply button the line is now displayed at the newly created chart.

To add a new line in the selected chart the user does the same but for the other axe so data wont be messed in one axe.

Predifined chart

There is a set of ready to use charts. Just select from the list and the charts will be created with specific lines/colours/axes for instant use.

Chart options

There are some options available for all charts.

The user can select to show the data per lap which means when lap ends the line will start from the start of the window again. This is useful for lap to lap comparisons. Everytime the chart will show the previous lap and the current one.

If not in per lap mode the user must select how many laps the chart will display.This is useful when you need to monitor how data change in many laps.

The minorgrid option draws a secondary grid for better values check while the color change per lap option will change the colour of the line each lap so the user can make lap comparisons easier especially in per lap mode.