VBOX LapTimer SimHub Dashboard

A detailed replica of VBOX Motorsport's LapTimer device, sometimes referred to as a Racelogic, for SimHub. To the extent that is possible and reasonable, all display modes of the device are available, including customizable settings such as decimal places, speed unit, inverted screen, and more. The full list of features including how to use the dashboard are below.

Please be sure to read the documentation as there are quite a few settings that impact each display mode.

Overall

The display modes are arranged in the same order as the device based on the references listed. The display modes can be changed by pressing ↑ to cycle to the next mode and ↓ to cycle to the previous mode. The display modes are in the following order:

• Live Speed
• Max Speed
• Speed Bar
• Predictive Lap Timing
• Lap Timing
• Lateral g Bar
• Lateral g
• Longitudinal g Bar
• Longitudinal g
• Lap Count

Generally speaking, most of the official documentation around display mode settings is compatible with this replica, save for a few things that have no real applicability to this dashboard, which are described further below. See here for a list of settings/features that will not be implemented.

All of the settings are contained in the included settings.ini file. The settings for the real device have corresponding entries in the settings file. For example, the setting Speed Decimal Places in the Display Menu can be found in the settings.ini file as SpeedDecimalPlaces=0 ; 0, 1, 2 under the [Display] category. Read on below for a full overview of each display mode and associated settings.

WARNING Please do not change the order or line spacing of the settings.ini file. There are entries that do nothing. Even so, please do not remove those entries. I very messily implemented the settings and haven't had the time to refactor it. If you run into issues with how things are displaying, overwrite your settings.ini with the default one. Also note that not all setting in the file are fully implemented. The display mode overviews below cover all settings that are currently implemented.

General

Settings

Basic display modes is set by default with only Speed, Lap Timing, and Predictive Lap Timing screens visible. Advanced display modes can be set, which enables the Max Speed, Speed Bar, Lateral g Bar, Lateral g, Longitudinal g Bar, Longitudinal g, and Lap Count screens.

Modes=0 ; 0 = Basic, 1 = Advanced

The colour of the display can be inverted in the settings.

InvertScreenColour=0 ; 0 = disabled (Black screen, white text), 1 = enabled (White screen, black text)

The text can be set to outline in the settings.

UseOutlineFont=0 ; 0 = disabled, 1 = enabled

Live Speed

Displays the current speed in realtime in kilometres per hour (km/h), miles per hour (mph), or knots^{not implemented} (kts).

Settings

The number of decimal places displayed can be changed in the settings. Zero, one, or two decimal places can be displayed. E.g., 235, 167.2, 185.14

SpeedDecimalPlaces=0 ; 0, 1, 2

The unit of speed displayed can be changed in the settings. KMH, MPH, or KTS can be displayed. E.g., 104 km/h

SpeedUnits=0 ; 0 = KMH, 1 = MPH, 2 = KTS

Max Speed

Displays this session's highest top speed in kilometres per hour (km/h), miles per hour (mph), or knots^{not implemented} (kts). Only displays if Modes=1 (see here)

Settings

The number of decimal places displayed can be changed in the settings. Zero, one, or two decimal places can be displayed. E.g., 235, 167.2, 185.14

SpeedDecimalPlaces=0 ; 0, 1, 2

The unit of speed displayed can be changed in the settings. KMH, MPH, or KTS can be displayed. E.g., 104 km/h

SpeedUnits=0 ; 0 = KMH, 1 = MPH, 2 = KTS

The displayed maximum reached speed can be reset by pressing the middle button ▢.

Speed Bar

Displays the current speed in realtime in kilometres per hour (km/h), miles per hour (mph), or knots^{not implemented} (kts), and a graph representing a positive and negative difference from the selected center speed. Only displays if Modes=1 (see here)

Settings

The unit of speed displayed can be changed in the settings. KMH, MPH, or KTS can be displayed. E.g., 104 km/h

SpeedUnits=0 ; 0 = KMH, 1 = MPH, 2 = KTS

The center speed (center of the graph) can be changed in the settings. The unit of speed is determined by the setting above.

CenterSpeed=340 ; 0 - 999

The positive and negative difference from the center speed can be changed in the settings. The unit of speed is determined by the setting above. E.g., +/- 30 km/h

SpdDisplayRange=030 ; 0 - 999, 010 increments, e.g., 010, 020, 030

Lap Timing

Displays the current lap time and the current lap or statically displays the last lap time and current lap. Upon crossing the finish line, the last lap time will be displayed along with the last lap delta to the session best delta.

Settings

The number of decimal places displayed can be changed in the settings. Zero, one, or two decimal places can be displayed. Note that this screen will not display zero decimal places. If 0 is set, one decimal place will be used instead. E.g., 2'03.2 or 2'03.27

SpeedDecimalPlaces=0 ; 0, 1, 2

The length of time the last lap time and split time are displayed can be changed in the settings. E.g., 2s, 5s, 10s, 15s, 20s

SplitTimeDisplayPeriod=05.0 ; 02.0, 05.0, 10.0, 15.0, 20.0 - time in seconds

The currently displayed lap time can be rolling or static and can be changed in the settings.

RollingLapTime=1 ; 0 = disabled, 1 = enabled

Predictive Lap Timing

Displays the current delta to the session best and a graph representing that time visually. The two LEDs are enabled in this mode and represent delta velocity, the difference between the current speed and the speed at the same point in the session best lap.

Optionally, Delta-T Speed Mode can be enabled, which displays current delta to session best and current speed when the current speed is under a specified value.

Settings

On the first lap, the screen will display WAITING FOR START LINE and a distance in meters to the start/finish line.

After crossing the start/finish line for the first time, the screen will display CREATING REFERENCE LAP and the current lap time and two teal LEDs.

After crossing the start/finish line for the second time, the screen will display the Delta-T graph along with the current delta to session best. The last lap time and delta to session best will display briefly each time the start/finish line is crossed.

The range of time +/- displayed on the graph can be changed in the settings. E.g., 2, 5, 10, 30

DeltaTBarRange=5 ; 2, 5, 10, 30 - time in seconds

The range of speed +/- represented by the LEDs can be changed in the settings. E.g., 2 km/h, 5 km/h, 10 km/h

DeltaVLightRange=5 ; 2, 5, 10 - speed in km/h

Delta-T Speed Mode can be enabled in the settings.

DeltaTSpeedMode=0 ; 0 = disabled, 1 = enabled

The maximum reachable speed before Delta-T Speed Mode turns off can be changed in the settings. After the current speed is at least 5 km/h faster than the speed set in the settngs, Delta-T Speed Mode will disable and the Delta-T graph and current delta will be displayed.

DTSpeedModeSpeed=065 ; 0 - 999, only used when Delta-T Speed Mode is enabled

The delay after reaching the target speed can be changed in the settings.

DTSpeedModeTimeDelay=1.5. ; 0 - 5, .5s increments, e.g., 1.5, 2.0, 2.5, only used when Delta-T Speed Mode is enabled

Lateral g Bar

Displays the current lateral g and a graph representing that value visually over a range of +/- 3 g. The graph shows a user-specified target. Only displays if Modes=1 (see here)

Settings

The maximum g displayed on the graph can be adjusted +/- 3 g. Depending on the Invert Target setting, the graph will shift left or right. This value should be adjusted in .1 increments between 1.0 and 3.0.

MaxG=1.0. ; 1.0 - 3.0 - 0.1 increments, e.g., 1.1, 1.2, 1.3

The target displayed on the graph can be changed in the settings.

TargetG=0.5. ; 0.0 - 3.0 - 0.1 increments, e.g., 1.1, 1.2, 1.3

The Invert Target setting determines if the target is displayed on the positive or negative side of the graph.

InvertedTarget=0 ; 0 = Normal (+), 1 = Inverted (–)

Lateral g

Displays the current lateral g and the maximum reached lateral g. Only displays if Modes=1 (see here)

Longitudinal g Bar

Displays the current longitudinal g and a graph representing that value visually over a range of +/- 3 g. The graph shows a user-specified target. Only displays if Modes=1 (see here)

Settings

The maximum g displayed on the graph can be adjusted +/- 3 g. Depending on the Invert Target setting, the graph will shift left or right. This value should be adjusted in .1 increments between 1.0 and 3.0.

MaxG=1.0. ; 1.0 - 3.0 - 0.1 increments, e.g., 1.1, 1.2, 1.3

The target displayed on the graph can be changed in the settings.

TargetG=0.5. ; 0.0 - 3.0 - 0.1 increments, e.g., 1.1, 1.2, 1.3

The Invert Target setting determines if the target is displayed on the positive or negative side of the graph.

InvertedTarget=0 ; 0 = Normal (+), 1 = Inverted (–)

Longitudinal g

Displays the current longitudinal g and the maximum reached longitudinal g. Only displays if Modes=1 (see here)

Lap Count

Displays the total amount of laps for the session and the current lap. Only displays if Modes=1 (see here)

Exclusions

The following settings/features are not and will not be implemented (for mostly obvious reasons):

• GNSS options (GPS)
• SD card saving/loading
• Logging mode
• Track database
• Gates
• One shot mode
• Display brightness
• LED brightness
• Orientation

References

• VBOX LapTimer User Guide
• VBOX LapTimer Manual
• VBOX LapTimer Data Sheet
• What are Delta-T & Delta-V and how can you use them to go faster? by VBOX Motorsport (YouTube)
• How to Configure Settings on a VBOX Pit Lane Timer by VBOX Motorsport (YouTube)
• VBOX LapTimer: Real-time driver feedback to improve your driving performance by VBOX Motorsport (YouTube)
• A VBOX LapTimer (Racelogic) on my sim rig | Demo and install | €1500 Giveaway | 4K by Laurence Dusoswa (YouTube)
• REAL RACE CAR TECH FOR YOUR SIM! - Racelogic VBox Sim Pack Review by Boosted Media (YouTube)

Development

Core

• Menu/Settings screens
• Live Speed
  • Display Mode splash screen
  • Decimal places
    • No decimal places setting
    • One decimal place setting
    • Two decimal places setting
  • Speed units
    • km/h units setting
    • MPH units setting
    • kn units setting
  • Inverted screen
  • Outline text
• Max Speed
  • Display Mode splash screen
  • Reset max speed button
  • Decimal places
    • No decimal places setting
    • One decimal place setting
    • Two decimal places setting
  • Speed units
    • km/h units setting
    • MPH units setting
    • kn units setting
  • Inverted screen
  • Outline text
• Speed Bar
  • Display Mode splash screen
  • Center Speed
    • 0-999 setting
  • Speed Display Range
    • 0-999 setting
  • Speed units
    • km/h units setting
    • MPH units setting
    • kn units setting
  • Inverted screen
  • Outline text
• Lap Count
  • Display Mode splash screen
  • Total Laps count
  • Current Laps count
  • Inverted screen
  • Outline text
• Predictive Lap Timing
  • Display Mode splash screen
  • Waiting for Start Line screen
  • Creating Reference Lap screen
  • Delta T Bar Range
    • 2s setting
    • 5s setting
    • 10s setting
    • 30s setting
  • Delta-V Light Range
    • 2 km/h setting
    • 5 km/h setting
    • 10 km/h setting
  • Delta-T Speed Mode
    • Speed setting
    • Time Delay setting
  • Final lap time and split from session best
  • Inverted screen
  • Outline text
• Lap Timing
  • Display Mode splash screen
  • Decimal places
    • One decimal place
    • Two decimal places
  • Current Lap
  • Final lap time and split from session best
  • Split Time Display Period
    • 02.0s setting
    • 05.0s setting
    • 10.0s setting
    • 15.0s setting
    • 20.0s setting
  • Split-to-Split Time setting
  • Rolling Lap Time setting
  • Static Lap Time setting
  • Inverted screen
  • Outline text
• Lateral g
  • Display Mode splash screen
  • Current lateral g (+/-)
  • Maximum reached lateral g
  • Inverted screen
  • Outline text
• Lateral g Bar
  • Display Mode splash screen
  • Current lateral g (+/-)
  • Lat g graph
    • +/- 3 g min/max labels
  • Target g setting (+/- 3 g)
  • Inverted target setting
  • Inverted screen
  • Outline text
• Longitudinal g
  • Display Mode splash screen
  • Current longitudinal g (+/-)
  • Maximum reached longitudinal g
  • Inverted screen
  • Outline text
• Longitudinul g Bar
  • Display Mode splash screen
  • Current longitudinal g (+/-)
  • Lng g graph
    • +/- 3 g min/max labels
  • Target g setting (+/- 3 g)
  • Inverted target setting
  • Inverted screen
  • Outline text
• Timer
  • Display Mode splash screen
  • Inverted screen
  • Outline text

Sim Support

• Assetto Corsa
• Assetto Corsa Competizione (preliminary)
• Automobilista 2 (preliminary)
• iRacing
• rFactor 2

Misc

• 2.4:1 ratio (120mm x 50mm) screens
• Template screen
• Device correct colours
• Outline text
• Documentation
• Screen optimization
• Code optimization
• Add Knots (kn) speed metric
• Update placeholder text (from 9s)
• Night mode

Credits

• Racelogic Ltd. (https://www.racelogic.co.uk/)
• VBOX Motorsport (https://vboxmotorsport.co.uk/)
• SimHub by SHWotever https://www.simhubdash.com/ | GitHub
• Members of the SimHub Discord
• JSON auto-formatted with https://j-brooke.github.io/FracturedJson/