User Defined Parameters is an optional feature of VCM Editor that can be purchased on the HP Tuners website.
If you have information on parameters (switches, scalars, and/or tables) that are supported by the vehicle being tuned, but have not yet been defined in VCM Editor, this feature makes it possible to add them yourself and edit them in VCM Editor immediately.
When using this feature, parameters must be defined in TunerPro, which can be downloaded at:
http://www.tunerpro.net/downloadApp.htm
Purchasing the User Defined Parameters Feature
1. |
Log into your account on www.hptuners.com. |
2. |
On the My Account page, select My Devices. |

3. |
The My Devices page lists all of your registered interface devices. Select the Purchase link for the desired device. |

4. |
Click Add to cart and proceed to checkout. |

5. |
Once checkout is completed, connect the device to a USB port on your computer. |
7. |
In the menu bar, select Help > Resync Interface. This will apply the feature license to VCM Editor. |
The User-Defined Parameters should now be available for you to use.
Configuration Overview
Once you have purchased the User Defined Parameters feature, new parameters can be defined by doing the following:
1. |
Use TunerPro to define the parameters to be added. |
b. |
Configure the XDF header info (see below). |
c. |
Define each parameter you wish to add (see below). |
d. |
In the menu bar, select XDF > Save XDF. |
2. |
In VCM Editor, open the .HPT file to which you want to add parameters. |
3. |
In the menu bar, select Edit > User Defined Parameters. |

4. |
Click . |
5. |
Select the TunerPro (.XDF) file that contains the parameters you wish to import. |
6. |
Click Open. Your parameters will be imported into VCM Editor. |

If you would like parameters added to VCM Editor permanently, email HP Tuners support to request that they be added.
NOTE: Not all controllers supported by VCM Suite support User Defined Parameters, please start a support ticket for more information
What are the "Allowed Addresses" in the User Defined Parameters window?
The allowed addresses are address ranges that you are allowed to define parameters in. If you try to define a parameter outside these ranges, they will not import and you will not be allowed to edit them.
XDF Header Configuration
Before you define parameters in TunerPro, you will need to set up the XDF header. Typically, only two header parameters need to be configured:
■ |
Some controllers require a base offset for all parameters. For example, if you define the parameter at address: 0x1ABCDE, however the location of the parameter is actually at 0x801ABCDE. This would require an offset of +0x80000000. Although it's possible to enter this for each individual parameter defined, the XDF header allows you to specify it for all parameters in the current XDF file. |
■ |
A number must be entered for the bin size. It does not have to be the actual size of the bin (VCM Editor will ignore this value). It merely has to be a larger number than the highest parameter address that will be entered (the address you will actually enter + the base offset). |
Editing the XDF Header

2. |
In TunerPro's menu bar, select XDF > View/Edit XDF Header Info. |
4. |
Enter your Base Offset (if needed). |
Manually Adjusting the Base Offset
If you need to define a base offset of 0x80000000 or higher in TunerPro V5.00.8944 or older, you must edit the base offset manually in a text editor (For example: Notepad or Notepad++).
To manually adjust the offset in a text editor:
1. |
Open your .XDF file in the text editor. |
2. |
Find the <baseoffset> field in the XDFHEADER (always near/at the top) |
3. |
Enter your new offset value in DECIMAL, not hexadecimal. |
NOTE: For example, to specify an offset of 0x80000000, enter 2147483648 in the baseoffset field.
4. |
If the offset is negative, add a "-" before the offset. |
NOTE: For example, -2147483648.
Defining Parameters
The User Defined Parameters feature allows three types of parameters tp be added to VCM Editor:
■ |
Scalar: a numerical value. For example, a temperature or a speed. |
■ |
Flag/Switch: a simple True/False value. |
Once you have installed TunerPro and configured the XDF header info, follow these steps to define a new parameter:
1. |
In TunerPro's menu bar, select XDF > Create New XDF Parameter. |

2. |
Select the type of parameter to add (Scalar, Flag/Switch or Table): |
3. |
Click OK. A form with configuration information for the new parameter appears. |
4. |
Fill out the fields in the form as needed for the new parameter. See the appropriate configuration section below for more information. |
Switch Configuration
To configure a new switch in TunerPro, fill out the following fields:
NOTE: Visibility Level and Categories will be ignored by VCM Editor.

Scalar Configuration
To configure a new scalar in TunerPro, fill out the following fields:
■ |
Signed, Floating Point, LSB flags |
NOTE: Visibility Level and Categories will be ignored by VCM Editor.


Table Configuration
To configure a new table in TunerPro, it is necessary to enter general information about the table and information about the table's row axis and column axis.
Table Information (General Tab)

■ |
Signed, Floating Point, LSB flags |
NOTE: Visibility Level and Categories will be ignored.
Row Axis Information (Rows Tab)

■ |
Signed, Floating Point, LSB flags |
■ |
Row Conversion Equation (click Edit) |

Column Axis Information (Columns tab)

■ |
Signed, Floating Point, LSB flags |
■ |
Column Conversion Equation (click Edit) |

Table Conversion Equation (Conversion tab)

What Units Do I Enter for tables?
In the instances where there is no drop down selection for units (main table cells), you will need to enter a valid unit into the Cell Units text box.
To find valid units for import:
2. |
Go to Tools > Quantities & Units. |

3. |
Copy the Symbol OR Name into the Cell Units box in TunerPro. |

For all other parameter types (Scalars, Axis') that have an available Stock Units drop-down, please select your unit from the drop-down.
Comments
0 comments
Please sign in to leave a comment.