With +/- buttons you can add more boards to your system or delete them from configuration. To select the board you want to configure press the button with the number.
Choose an Arduino type for each board number in your system.
If you build a small cockpit in most cases it will be enough to use only a single Arduino Mega board.
Uno (and similar)
If you will change connection type (LAN/USB) for the board that has beed configured before, all pins that are reserved for this type of connection will be cleared (pins #0,1 for USB, #10,50..53 or 10..13 for LAN)
With these buttons you can configure the "Key-Matrix" to extend the number of buttons and swithes for your panel. The "Matrix Input" list tab becomes active after matrix NxM has been configured.
If you will use an "Port" connection" type for Encoders you should assign the encoder input Port pins. Two pins assigned for encoder port will be used for all encoders (only for those connected to the port, not directly!).
Before configuring the 7-segment outputs or Serial LEDs output, you should select which 2 pins will be assigned as common "D" and "L" inputs for all 74HC595 registers used with this Arduino board .
This optional checkbox is only needed to reserve some pins if you plan to use I2C communication in the selected Arduino board to link with other devices (such as LCD displays with inbuilt I2C inteface, etc).
Is I2C I/O used?
Save current configuration into the data config file for ArdSimX plugin
Open existing config file (data.cfg) to edit it
Click on a pin on the board to assign input/output for it.
Use the options on the left to add more boards to your ArdSimX system, choose the appropriate board type, and configure a button-matrix for the current board, if you need it.
Programmed Outputs - Define datarefs to receive and use in your custom code (not linked with Arduino pins)
Programmed Inputs - Define datarefs to send to X-Plane from your code (not linked with Arduino pins)
Digital Pin #
Please first select 2 pins that will be assigned for 74HC595 registers ("LED Displays" buttonon the left).
This 2 output pins will be used as common D/L signals for all 7-segment displays and LEDs (serial digital outputs)
Please first select a pin that will be assigned as step direction pin!
This output pin will be used for all steppers connected to this board.
Click on a digital pin to assign it as steppers direction output
You can control up to 4 parameter with one switch. Select number>1 if this switch will control more than one parameter:
Next free pin will be used as second switch input.
Enter any other pin number if needed -
Button input (also can be used as one input position for multiposition switch)
Cycle between commands on each click (otherwise they are all executed simultaneously).
Select number of parameters to be controlled with one button:
"Press-and-hold" action (support for repeating or secondary functions)
Optional: Command executes in the moment when button is released
Is this encoder connected to encoder port?
Use Encoder to control X-Plane parameters or use it to switch between different modes of any other encoder
Is this encoder used as mode switch for another encoders?
Select number of switchable modes if this encoder will control more than one parameter:
Select parameter to control (dataref value or range) for each rotary switch position (click on the table row to edit):
This encoder is used for cyclic mode change (+/-) of another encoder
Select encoder (or encoders) to control
Connect analog sensor to this pin, as described on this page, enter desired number of sensitive steps for this sensor and select dataref to be controlled.
Input Sensitivity / Precision: - min 3, max 1000 "positions"
Sensor movement limits ( for full stroke leave default 0...100% ):
Min position: %
Max position: %
Connect rotary or linear multi-position switch to this analog pin, as described on
this page, select desired number of switchable positions below (up to 12) and select parameter to be controlled for each position.
Select parameter to control (dataref value or range) for each rotary switch position:
Encoder mode switch
Use this button (or toggle switch) to switch between different modes of encoders
Mode switch (set) type:
Cyclic mode change button (1,2,3,4...) - Descending (...4,3,2,1)
Set specific mode number on button click
Switch between two modes (switch or hold-release button)
Use this button as "counter" button for your needs (for display modes etc.)
* This feature is in development and not available yet *
Use this button to store dataref values into memory stack (.)
* This feature is in development and not available yet *
This pin will be used for any DIGITAL OUTPUT: as direct LED output, or as digital output to control various digital devices (relays, FETs, or as output signal to control inputs for digital ICs).
Select X-Plane parameter that will controll this digital output
Minimum one 595 register is used (8 outputs). To each one register in chain you can connect 8 LED indicators (or use them as digital outputs to control other digital devices).
Select parameter to control (dataref value or range) for each single indicator connected to chosen register:
Pins # is used as common for all 7-segment displays
Common cathode |
Reverse digits order
Select number of digits (registers with 7-seg indicators) and optional dot position
Dot is used as delimiter (not as decimal point)
Number with leading zeros -
000042 insted of 42
No zero before decimal dot -
.2 insted of 0.2
Display dashes for no data - - - - - - (as for DME KDI-572)
Pin # is used for all steppers as DIR signal Full circle steps number, default for X25, X27 and similar. Change only if you have stepper type with other number of full-circle steps:
Zero-position determination for this stepper:
physical limiter (only for gauge with limited angle of rotation)
zero-position sensor (both for full circle and limited rotation)
Full circle, linear cyclic rotation
Value from 0 to
Connect an analog (coil) gauge to this pin and configure it for chosen dataref value output.
For a non-linear gauge you can divide full scale to several linear segments, mapping data values to rotation angle (in % of full scale) for each value:
Connect a Servo gauge to this pin and configure it for chosen dataref value output. You can connect up to 10 Servos to One Arduino!
For a non-linear gauge you can divide full scale to several linear segments, mapping data values to the servo rotation angle (in MicroSeconds) for each value:
Mapping (minimum 2 ranges for simple linear scale, maximum 10 sectors)
Only use this when you need to exchange data with something other than the input/output devices supported by ArdSimX.
An example of such situation would be data output to an LCD, or sending data to the simulator on a pre-programmed event.
Matrix - x - Click the line with node number to configure
Enter Custom dataref string:
Enter dataref Name:
Enter DataRef Values for ON and OFF positions: Enter Dataref Value to be set (or incremented):
Decrement Enter DataRef Increment Value: Enter DataRef Values for minimum and maximum: Enter Dataref Value to be set: Enter Dataref Value Range for LED ON: (leave seconf field empty for fixed ON value) : Enter Dataref Value Range for LED ON: Enter:
1) enter 0 for integer, 2) enter -3... -1 if you want data sent every 1000 ... 10 units 3) enter 1 ... 4 for output every 0.1 ... 0.0001 unit's fraction
Unit number (if any) #
Select controlled encoders:
Select matrix rows and columns pins in the Arduino board picture (read description on the Matrix connection page)
First row pin - Last row pin -
First col pin - Last col pin -
Select 2 encoder Port pins - click on first of 2 pins to be assigned as Bus for all encoders connected to this bus.
Select 2 pins for Registers D and L inputs - click on first of 2 pins to be assigned as Registers D/L.
- The LED indication for encoder modes will be added to configurator soon.
March - Added Servo Configuration option (requires plugin and library v1.6 )
22 March - Corrected 7-Segment configuration options bug
2 April - corrected rotary switch ( Unit number was skipped )
4 May - Major update of the parameters list and some options.
6-7 May - Fixed a bug with Programmed I/O and output precision configuration.
17 May - Fixed the matrix info offset when loading a config to edit.
21 May - Fixed the info errors for Serial LEDs and Programmed I/O.
2 June - Toggle buttons and I2C pins are now loaded correctly when editing config. Mode Switch info (name) is now saved correctly.
10 June - Fixed inputs assignment when switching between "Toggle Button" and "Toggle Switch" types during configuration.
24 June - Added Trim indication into the LED-type outputs parameter list.
22 July - Fixed info offset for Programmed I/O.
Note: if your browser caches scripts and you don't see the above changes take effect, use "Ctrl + F5" in your browser (tested in Chrome) to reload everything the page includes.
ArdSimX uses a single config file, named "data.cfg", which includes I/O configuration and connection information for all your Arduino boards. After you've finished using the online configurator, press the "Save" button to download this file. To be used by the plugin, the "data.cfg" file must be placed in ArdSim's plugin folder (X-Plane/Resources/plugins/ArdSim).
Input/Output Pin Color legend
Here is the color scheme for Arduino pins in the ArdSimX Configurator for different types of input and output devices.
When making a configuration, click an assigned Arduino pin to change its parameters or clear it. Pins marked with the white dot cannot be clicked.
- Toggle Switch [ one input Pin ].
- Click Button [ one input Pin ].
- Mode Switch Button ( Encoder mode switch, Memory button, Counter button) [ one input Pin ]
- Encoder, Direct connection [ 2 input Pins ].
- Encoder, Port connection [ one output Pin ].
- Axis Input on analog input Pin.
- Rotary Switch on analog input Pin.
- LED with direct connection (or digital output) [ one output Pin ]
- Register "S" output for Serial LEDs (or digital outputs) [ one output Pin ]
- 7-Segment display output, the "S" signal [ one output Pin for one multi-digit display]
- Stepper motor output (without sensor) [ one output Pin ]
- Stepper motor output/input (with sensor) [ one output Pin, one input Pin ], sensor connects to the input pin with white dot.
- Analog Gauge output (coil ammeter) [ one output Pin ]. Only Arduino PWM pins can be used.
- Servo output (reserved, not included in the library yet) [ one output Pin ]
- Encoder Port [ two input Pins for all connected encoders]
- Registers "D" and "L" outputs [for all connected multi-digit 7-Segment displays and Serial LEDs ]
- Stepper motors DIR output [ one output Pin for every stepper connected]
- Matrix row pins
- Matrix column pins