Using the HH Timing Integration
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 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
The DMI will send data to a single HH Data Management instance or the API, and then rely on the syncing framework to distribute this data to all other users on the account as normal.
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 from hh-dev.com/Latest/DMI
There are two modes for the DMI:
- API: in this mode, HH Timing sends the timing data to the HH Data Management API
- Local: in this mode, HH Timing connects directly to an HH Data Management client running on the same computer.
In general, local mode is the recommended option for the DMI. It is more robust against network dropouts. The only downside is that the DMI must be run on the same computer as HH Data Management.
- Access to live timing data
- Access to the internet
- Access to the live timing data
- HH DM installed and the current and cars subscribed.
Setting up the DMI
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 to Documents\HH Timing\Plugins
Once in this folder, the plugin should look like this in the Plugins folder:
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:
- API Settings
- Telemetry Settings: these settings are only needed for users sending live vehicle telemetry to HH Data Management
- Telemetry Server Host: the host of the computer where the telemetry reader is running (this value should be localhost if the telemetry reader is running on the same computer as HH Timing/DMI)
- Telemetry Server Port: by default the supplied telemetry readers are set to use port 2018
After entering the settings, HH Timing will need to be restarted for the changes to take effect.
Using the 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.
This will open the DMI
Setting the connection mode
The first thing to set in the DMI is the window is to select the correct connection mode
The status of the connection (either to the API or the local HH Data Management instance, depending on the connection mode) is shown by the indicator light
Loading configuration data
Click the "Refresh from Server" button, this will fetch the latest data from HH Data Management.
After a few seconds, the championship, event and session comboboxes will be populated along with the car, driver and track mapping tables:
Setting up the mapping
It is necessary to set the correct mapping so that the DMI sends the timing data to the correct event, session, car etc. in HH Data Management.
- 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 Data Management 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 HH Data Management. This is not editable from DMI. The data on the right side of each table is filled in by the user. Note that the numbers of the cars in the timing feed do not necessarily need to match what the cars are called in HH Data Management, this is true for each of the mapping fields.
Send timing information
The checkbox "Send Timing Information" can be used to start/stop the sending of the 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" needs 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.
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.
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.
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.
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:
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.
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 Data Management 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
Alkamel protocol reconnection process
If the computer using the DMI lost the connection to the timing feed, you can do the following steps to get the connection back.
- Disconnect DMI : Untick Sending Timing Information check box in DMI
- Make sure Read History is set to true in your championship configuration
- Connect timing and clear the scoreboard.
- Make sure your session time is back to live and all the data from the beginning of the session are populated.
- Reconnect DMI :Tick Send Timing Information check box