User Defined Parameters

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.

6.	Open VCM Editor.

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.

a.	Open TunerPro.

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

1.	Open TunerPro.

2.	In TunerPro's menu bar, select XDF > View/Edit XDF Header Info.

3.	Enter your Bin Size.

4.	Enter your Base Offset (if needed).

5.

Click OK.

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.

5.	Save your XDF.

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.

￭	Table: a table.

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.

5.

Click OK.

Switch Configuration

To configure a new switch in TunerPro, fill out the following fields:

￭

Name

￭	Description (optional)

￭

Address

￭	Src Data Size

￭	Bit Number

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:

￭

Name

￭	Description (optional)

￭

Address

￭

Size

￭	Signed, Floating Point, LSB flags

￭	Stock Units

￭	Low & High Ranges

￭	Conversion Equation

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)

￭

Name

￭	Description (optional)

￭

Address

￭

Size

￭	Signed, Floating Point, LSB flags

￭	Cell Units (optional). See What Units Do I Enter for tables?

￭	Low & High Ranges

NOTE: Visibility Level and Categories will be ignored.

Row Axis Information (Rows Tab)

￭	Number of Rows

￭	Stock Units

￭	Label Source*

￭

Address

￭

Data Size

￭	Address step

￭	Signed, Floating Point, LSB flags

￭	Row Conversion Equation (click Edit)

Column Axis Information (Columns tab)

￭	Number of Rows

￭	Stock Units

￭	Label Source*

￭

Address

￭

Data Size

￭	Address step

￭	Signed, Floating Point, LSB flags

￭	Column Conversion Equation (click Edit)

 

*	Only External(Manual), Internal, Pure, and Linked, Scale are supported axis types at this time. Linked, Normalized axis types are not supported.

Table Conversion Equation (Conversion tab)

￭	Global Table Equation

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:

1.	Open VCM Scanner.

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.