ABOUT, HISTORY BARON 58 Q & A TERMS of Use YOUTUBE

<<<      Custom data conversion

Generally, your cockpit controls will work with the configuration you created as-is, for all default X-Plane aircrafts, most freeware planes, and for the custom aircrafts already included in SimVimCockpit database by default. If some of the input controls assigned in the configurator do not work in your aircraft model (or work incorrectly) with the parameters you assigned to them, it can be because:

  • you have selected a wrong parameter (function) from the configurator table,
  • you have wrong wiring,
  • or, the loaded aircraft model doesn't allow the default command(s) or dataref assigned to this parameter, requiring its own custom commands/dataref to be used, and this custom aircraft is not included in SimVimCockpit database at the moment.

Input Conversion Tool (only ver. 0.9.35+)

The "Input Test and Conversion" tool allows you to test any of your assigned inputs interactively, and if some of them needs custom re-assignment, to convert them and test instantly.

  1. Select the "Input Conversion" item in SimVim plugin menu, the "Test Inputs" window will appear.
  2. Activate the first input function you want to test: press a button, throw a toggle switch, rotate an encoder or rotary switch connected and assigned in your system.
  3. Watch the corresponding reaction to this input in your virtual plane cockpit. The activated parameter ID/Name appears in the text field ("Last active input").
  4. If the ID/Name has not appeared in the text field, that means either you haven't connected the input correctly (check your wiring)
    or you haven't assigned this switch/encoder yet in the configurator.


    If your virtual plane reacts correctly to this input you can go to step #2 again and activate and test the next input function.

  5. If you see the control ID/Name appearing when you actuate it, but your plane doesn't react to this control, then you probably need to convert it.
  6. To open the reassignment options for this control click the "Convert" button.

! Before conversion you need to prepare the list of custom commands and datarefs needed for your cockpit that are provided by your plane model developer.


Input Data Conversion specifics

The set of options that will appear in the data conversion window depends on the input type the plugin reads from the configuration. The way how the particular parameter should be reassigned depends on custom commands or datarefs available specifically for this parameter in your plane model. Below you can see 2 or 3 options you can choose for any input control.

Momentary button

For one momentary button you can assign either one custom command or custom dataref value, depending on what option is provided by your custom plane developer. Of course, using the command is preferred.

Encoder

To convert a custom parameter assigned for encoder control you have only two options - your custom aircraft model is provided either with two commands (usually and preferred) for this function, or one custom writable dataref:

  • option 1: select two custom commands - one command for [+] step, another one - for [-] step, click "Save"
  • option 2: enter custom dataref, add increment value ( +/- step dataref value), and optional min/max value limits, click "Save"

Toggle Switch

A parameter assigned for toggle switch (On/Off) can be converted in 3 ways - your custom aircraft model may have two commands (preferable), or you can use custom writable dataref with two On/Off values. The third option, which is often the only one available in some custom planes, is just one toggle command that is OK for a virtual on-screen panel, but for real switch you need to synchronize the switch position by reading the related dataref:

  • option 1: select two custom commands - one command for Up(ON) position, another one for Dn(OFF) position, click "Save"
  • option 2: enter custom dataref, add value for ON position and value for Off position, click "Save"
  • option 3: enter custom "toggle" command, add related dataref (for position reference), click "Save"

T-Switch (3-position toggle switch)

3-position toggle switch (Up/Off/Dn ) parameter can be converted in 3 ways - aircraft model may have 3 commands, a custom writable dataref with 3 values, or it can often be just two "switch Up" and "switch Dn" step commands. For the last option you need to know what dataref is used to store the switch position, and the value related to the switch central position (which can be -1,0,1 or 0,1,2, etc.)

  • option 1: select 3 custom commands - one command for each of the 3 positions, click "Save"
  • option 2: enter custom dataref, add 3 values for each position, click "Save"
  • option 3: enter 2 custom "up and dn" commands, add related dataref (for position reference), enter the dataref value for switch "center" position, click "Save"

Rotary Switch

N-position Rotary switch parameter may also have one of the 3 options to be configured - aircraft model may have N commands, a custom writable dataref with N values, or two "switch Up" and "switch Dn" step commands. For the last option you need to know what dataref is used to store the switch position:

  • option 1: select N custom commands - one command for each of the N position, click "Save"
  • option 2: enter custom dataref, add avalue for each of the N positions, click "Save"
  • option 3: enter 2 custom "up and dn" commands, add related dataref (for position reference), click "Save"

Reference data file

To make entering custom commands easier, you can create a simple text file in your custom plane folder, name it "refs.txt" and add a list of 10-30 commands or datarefs to it.

This list cannot have more than 50 lines and must include only command or dataref string in one line, no other signs ( " , = , ) , no any numbers. When you finish with one list you can replace it with another 10-50 commands/datarefs.


© Copyright 2012-2018 - SimVim