Using the HH Timing Integration

Introduction to DMI

A plugin called Data Management Integration (DMI) is available for HH Timing to allow timing and scoring data to be sent automatically to HH Data Management (HH DM) during live sessions. The following functions become automatic when DMI is used:

  • A new run sheet will be created for each outing
  • Each lap will be created within the run sheet for each completed lap
  • The lap (and sector times if relevant) times will be entered automatically
  • The start and end time of each run will be added to each run sheet
  • The driver name for each run will be selected

Note that you can manually make new run sheets prior to a session starting if needed. Generally, this is because a user wants to fill in some details ahead of a session. Once the session start and timing data reach HH DM live, the timing data will automatically be added to the correct run sheet.

Latest version of the DMI

The latest version of the DMI can be downloaded using the website.

Requirements

DMI works by taking the timing data within HH Timing, forwarding the data to the DM Server online, the DM Server then pushes that data to the DM Clients (computers using HH DM). This means that the computer running DMI must simultaneously have:

  • Access to live timing data
  • Access to the internet

If you cannot access the timing data and internet with the same computer, you can use the DMI in local mode. In that case, that computer running DMI must have :

  • Access to the live timing data
  • HH DM installed and the current and cars subscribed.

Setting up DMI

1

Ensure you have the latest version of DMI and the appropriate version of HH Timing. When DMI is downloaded it will be zipped, do not unzip. Copy the zipped folder to the following directory on the computer that will be responsible for forwarding the timing data:

Documents\HH Timing\Plugins

Once in this folder, the plugin should look like this in the Plugins folder:

2

Open HH Timing, go to the File tab, then Plugins. Click on the Data Management Plugin in the table which will expose the options shown below:



Comments
API Authentication Mode OAuth / APIKey Choose the authentication mode for the API
API Key API Key
 API Key required if APIKey mode selected. For OAuth leave blank
API URL https://hhdm-api.hh-dev.com/
TelemetryServerHost IP For users sending live vehicle telemetry to HH Data Management
TelemetryServerPort Port Number For users sending live vehicle telemetry to HH Data Management
3
After entering the settings, HH Timing will need to be restarted for the changes to take effect.

Using DMI

With DMI installed, a DMI tab will now be available in the main ribbon bar of HH Timing as shown below. To open DMI click the "New DMI Manager" button.

With the new DMI Manager open the configuration can now be set. If the indicator light to the right of the Championship field is green and the test says connected (as shown below), this means DMI has a connection with the HH DM Server

  • Click the "Refresh from Server" button, this will fetch the latest data from the HH DM Server. 

  • After a few seconds, the Championship, Event Session defaults from HH DM will appear. 

  • Select the relevant Championship, Event and Session you want to send the timing data to.
  • Fill in the right side of each table, this is a mapping between the data on the HH Timing side and the data on the HH DM side. 

All the data in the mapping tables must match exactly with what is shown within HH Timing. The data on the left side of each table comes directly from the HH DM Server, this is not editable from DMI. The data on the right side of each table is filled in by the user. Note that in the example below the numbers of the cars in the timing feed do not necessarily need to match what the cars are called in HH DM, this is true for each of the mapping fields.

Connection Mode

There are two connection mode for the DMI. API or Local.

When using the API connection mode, the DMI will send data directly to the server. Connected HHDM users will then receives the timing information from the server. With a stable internet connection, this is preferred option.

When using the local connection mode, HHDM needs to be running on the same machine. The timing is sent directly from HH Timing to HHDM without the need of an internet connection. HHDM will then sync to the server that will then push the information onto other HHDM users.

Send Timing Information

The checkbox "Send Timing Information" can be used to decide when to send timing data to HH Data Management.

Send Weather Information

The checkbox "Send Weather Information" can be used to decide when to send weather data to HH Data Management. This is only valid in a championship where the weather is available in the feed.

Pit in-Pit Out Times

The checkbox "Use timing feed for the pit in/out times" need to be : 

  • Unselected in case of live timing feed: pit in/out time will take the computer time of day as a reference.
  • Selected if you want to use old replay: pit in/out time will take the Start Session time from HH Data Management as reference.

Stint offset

The stint offset column in the car table can be used to offset the stint number of HH Timing and HH Data Management.

Using the automatic mode, the total stint offset is the sum of the car table and the session name table.

DMI Mode

Starting with version 8.8.8.67, there is an option to choose the DMI mode. The two options are "Manual" and "Automatic". The "Automatic" mode was created to be able to link automatically the timing session to the right HH Data Management session without any manual input from the user during an event.

Manual

In manual mode, the user will have to manually select the correct session in the DMI to make sure the data is being sent to the right session in HH Data Management. This mode represents the same behaviour of the DMI prior to 8.8.8.67 version.

Automatic

In automatic mode, there is a new mapping table on the DMI to match the current HH Timing session name and a HH Data Management session:

Prior to the event, the user fills up the table with the expected HH Timing session name against the HH Data Management session name. When a new session starts on HH Timing, the DMI will automatically try to match the session and update the selected session.

In case that no matching session is being found an error message will be shown to the user:

Saving layout

When you save your layout in HH Timing the mapping defined in DMI is saved with it. This means you do not have to retype the mapping each time you start HH Timing or open a project.

Troubleshooting

Check the following of having any issues:

  • You have the correct Championship, Event and Session context selected in the DMI Manager
  • HH Timing is receiving timing data
  • HH DM has a connection to the server (showing green dot with "Connected" in the bottom left corner)
  • DMI is connected to the HH DM Server (showing green dot in DMI Manager with "Connected" to the right of the Championship field)
  • The mapping in the DMI Manager is correct and all values match exactly what is shown in HH Timing
  • The checkbox "Send Timing Information" is in the correct state

Still need help? Contact Us Contact Us