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:
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.
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.
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.
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.
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:
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:
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.)
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:
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)