Shifter

Normally, you'll just use pushButton() for shifters. Here are special shifter functions which have some added features.

pushPull()

Description

A function that sets up 4 buttons as a pair of push/pull shifters. Can also of course be used with two shifter paddles and 2 pushbuttons, or 4 shifter paddles (as the SW1 wheel uses it).

• 2 modes:

  • 0: Complex -> The 4 buttons only controls 2 button numbers. For instance, right shifter has button numbers 4 on pull, 5 on push. The left shifter will then have 5 on pull, 4 on push. This allows you to gear up/down with either hand on the wheel.

  • 1: Individual -> The 4 buttons are split up and uses 4 button numbers.

The button numbers will start with whatever is set up in the slot for the right side pull button in the matrix, and count 3 more from there. So for the other 3 buttons used you dont need to set up a button number in the matrix (can be set to 0, or anything else, it wont be read).

In addition, it has a handbrake feature. Pressing left and right pull buttons together for 1 second will engage "handbrake", which is 100% brake force from the controllers brake axis. Works great with sims that allow you to map a secondary brake axis (iRacing). The controller doesn't need clutch paddles for this to work. To release the handbrake, simply hold the left and right push buttons for 1 second.

• If handbrake is active or not is shown in property [DahlDesign.DDChandbrakeActive]

• The mode uses the button field. void pushPull(int rightPullRow, int rightPullCol, int rightPushRow, int rightPushCol, int leftPullRow, int leftPullCol, int leftPushRow, int leftPushCol, int fieldPlacement);

Example

void pushPull(int rightPullRow, int rightPullCol, int rightPushRow, int rightPushCol, int leftPullRow, int leftPullCol, int leftPushRow, int leftPushCol, int fieldPlacement)

The buttons we're planning to use:

• Right shifter pull: Row 2 Column 1

• Right shifter push: Row 3 Column 3

• Left shifter pull: Row 3 Column 5

• Left shifter push: Row 1 Coumn 2

Resulting in -> pushPull(2, 1, 3, 3, 3, 5, 1, 2, 4);

As you can see, the fieldPlacement is set to 4. This function uses the button field, so you'll find the mode of your push/pull complex in the property [DahlDesign.DDCB4].

Requirements

• modButton() if you want to change modes freely. modButton() not needed to change modes across presets.

• 4 button numbers

upshift()

Description

A simple, momentary pushbutton. It differs from pushButton() in that is has an adjustable cooldown. You can use this to prevent double upshift caused by holding/releasing the shifter paddle too slowly.

Example

void upshift(int row, int col, int cooldown)

For a switch on row 3 column 5 -> upshift(3,5,250);

I this case, the button takes a 250 ms pause after being pushed.

Requirements

• 1 button number

downshiftAndReverse()

Description

This function allows you to set up a button to pair with your downshift paddle. They will share button number, and the purpose is to use this button to set the car in reverse. It will pulse 10 button presses in 1 second.

2 modes:

• 0: Reverse button mode: A regular pushbutton (your paddle) and a 10 x pulse button (your reverse button) will share button number

• 1: Individual mode: Both buttons are regular pushbuttons with each their own button number.

Hold modButton() and press the reverse button to swap modes.

Example

void downshiftAndReverse(int drow, int dcol, int rrow, int rcol, int fieldPlacement)

Example:

• Paddle shifter on row 3 column 1

• Reverse button on row 1 column 2

• Use field bit 1 to push the switch mode to SimHub property [DahlDesign.DDCB1]

downshiftAndReverse(3,1,1,2,1);

Requirements

• 2 button number