ABOUT, HISTORY BARON 58 COMMUNITY TERMS YOUTUBE

Custom Input/Output 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 overrides 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.
  • In the last case you need to have the data conversion file in this aircraft folder, that you can download on the conversion page, if it has been added to our database. Otherwise, you can start making new conversion file or continue editing an existing one using SimVim online Converter in collaboration with other users.


SimVim Parameter Converter

This tool should be used to "convert" those SimVim parameters that do not work by default to your custom aircraft data.

NOTE: When looking for custom commands and datarefs for your plane, never consider the command/dataref as "custom" if it is from the standard X-Plane commands and datarefs lists! All standard commands/datarefs that can be used as cockpit controls are already included in our SimVim database and associated with SimVim parameters.

Don't try to enter a standard command/dataref for any control in the "converter", it's useless! Use only custom data for this plane. Always check first if the assigned control works by default, without conversion.

You have to know what you're doing when assigning conversion options! Find specific info on your aircraft model (provided by the developer) to know which custom datarefs/commands and values to use. Only edit the parameters that don't work as-is in your custom aircraft. Test all assigned switches, buttons and outputs first.


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 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 with one value, or custom dataref with two values if it works as toggle button, depending on what option is provided by your custom plane developer. Of course, using the command is preferred.

  • option 1: One command (execute once or toggle action)
  • option 2: One dataref and one value (sets specific dataref value once)
  • option 3: One dataref and two values ( toggle action, sets either value in cycle)

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
  • option 2: enter custom dataref, add increment value ( +/- step dataref value), and optional min/max value limits

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 the real switch synchronization you need to know what dataref is used for virtual switch position animation:

  • option 1: select two custom commands - one command for Up(ON) position, another one for Dn(OFF) position
  • option 2: enter custom dataref, enter values for OFF,ON position, divided by comma
  • option 3: enter custom "toggle" command, add related dataref (for position control/synchronization )

T-Switch (3-position toggle switch)

3-position toggle switch (Up/Off/Dn ) parameter can be converted in 4 ways - aircraft model may have 3 commands, a custom writable dataref with 3 values, it can often be two "switch Up" and "switch Dn" step commands, and even one "toggle" command that changes the switch position cyclically.

For the last two options you need to know what dataref is used for the switch position animation, 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
  • option 2: enter custom dataref, then enter 3 values for each position, divided by comma
  • option 3: enter 2 custom "UP and DN" commands, add related dataref (for position control/synchronization), enter the dataref value for switch "center" position (for example - "0" for -1,0,1 dataref values, or "1" for 0,1,2 dataref va;ues.)
  • option 4: enter ONE custom "toggle" command, add related dataref (for position control/synchronization), enter the dataref comma-separated values for [Up, Center, Down] positions.

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
  • option 2: enter custom dataref, add all values, divided by comma, for each of the N positions.
  • option 3: enter 2 custom "UP (+) and DN (-)" commands, and enter related dataref (for position control)"


Custom OUTPUT data conversion

In most cases all you need to convert a SimVim output parameter is enter suitable custom dataref. Optionally you can enter the dataref value or value range for LED "ON" state:

Note: If you don't enter a value or range for the LED, default range 0,7 - 1 will be used (i.e. your LED will be ON when dataref value is v>0,7)







© Copyright 2012-2018 - SimVim