User Defined Parameters

What are User Defined Parameters?

If you have information on parameters (switches, scalars, and/or tables) that we do not have defined currently in VCM Editor, you can now add them yourself and edit them right in VCM Editor immediately. All you need to do is:

1.	Define the parameters using TunerPro.

2.	Save the TunerPro definition.

3.	Import the TunerPro definition into the User Defined Parameters feature in VCM Editor.

If you would like parameters added to VCM Editor permanently, you can still email support requesting they be added.

NOTE: Not all controllers supported by VCM Suite support User Defined Parameters, please start a support ticket for more information.

How do I get to use the User Defined Parameters feature?

The User Defined Parameters feature can be purchased by logging into the "My Devices" section of your customer page and purchasing the one-time feature unlock for $169.99. After you purchase, you will be provided with a new application key. Once you receive the application key, simply enter it into VCM Suite and User-Defined Parameters will be available for you to use.

How do I define my own parameters for VCM Editor?

If you have the necessary information on a parameter that you would like to define yourself, you can define and import your own parameters by doing the following:

1.	Define the Parameter(s) using TunerPro.

2.	Save your .XDF file with the parameters you wish to import.

3.	Open your .HPT file in VCM Editor.

4.	Go to Edit > User Defined Parameters.

5.	Open the XDF File and your parameters will be imported into VCM Editor for editing.

Please see the example TunerPro .XDF file posted below for an example of each parameter type:

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.

How do I define a Parameter?

If you have the proper information to be able to define a parameter, please see the following 3 examples for defining a switch, scalar, and table in TunerPro.

Defining a Switch

To define a switch, insert a new Switch/Flag into your TunerPro definition and fill out the following fields with the appropriate information:

￭

Name

￭	Description (optional)

￭

Address

￭	Src Data Size

￭	Bit Number

NOTE: Visibility Level and Categories will be ignored.

Defining a Scalar

To define a scalar, insert a new Scalar into your TunerPro definition and fill out the following fields with the appropriate information:

￭

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.

Defining a Table

To define a table, insert a new Table into your TunerPro definition and enter the appropriate information for the table, it's row axis, and it's 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? (below).

￭	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)

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

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.

What if my definition requires a base offset?

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.

To add a base offset to your entire definition:

1.	Open your XDF in TunerPro.

2.	Go to XDF > View/Edit XDF Header Info.

3.	Set your bin size*.

4.	Set your base offset.

5.

Click OK.

*	When defining a TunerPro base offset to be used in VCM Editor, the bin size doesn't need to be the actual size of the binary. It just needs to be a larger value than the base offset value. The bin size will be ignored when imported into VCM Editor

NOTE: For TunerPro V5.00.8944 or older, if you must define a base offset of 0x80000000 or higher 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.

EXAMPLE: For an offset of 0x80000000, enter 2147483648 into the baseoffset field.

4.	If the offset is negative, add a "-" before the offset.

EXAMPLE: -2147483648.

5.	Save your XDF.