DCS-BIOS

a DCS data exporting tool
Explore the docs »

Ask a Question · Report Bug · Request Feature

DCS-BIOS is an Export.lua script for use with DCS: World, enabling external hardware and software to interact with the clickable cockpit of a DCS aircraft.

Getting started with DCS-BIOS is easy! Just follow these simple steps.

Start by finding your DCS Saved Games folder. On Windows, this is likely either:

• C:\Users\USERNAME\Saved Games\DCS
• C:\Users\USERNAME\Saved Games\DCS.openbeta

Within that folder, you find the folder called Scripts. Create one if it does not exist. The final path should look like:

• C:\Users\USERNAME\Saved Games\DCS\Scripts
• C:\Users\USERNAME\Saved Games\DCS.openbeta\Scripts

1. Go to the latest release
2. Download DCS-BIOS_x.y.z.zip
3. Extract the zip file
4. Within the extracted folder, copy the DCS-BIOS folder into the previously mentioned scripts folder.
5. If your Scripts folder does not have an Export.lua file, copy the Export.lua file over
6. If your scripts folder does have an Export.lua file, add the following line to the end dofile(lfs.writedir() .. [[Scripts\DCS-BIOS\BIOS.lua]])

Arduino Users should download the Source code (zip) on the Release page to get all needed files.

You don't need to be a programmer or electrical engineer to build your own panels. The DCS-BIOS User Guide includes step-by-step instructions on how to connect your panel to DCS using DCS-BIOS and the beginner-friendly Arduino microcontroller platform. You don't have to write any code yourself.

Both socat and DCSBIOSBridge can be used to connect to your device.

If you are working a lot with hardware, it may come in handy to log and replay dcs-bios data. There are two scripts in Programs/tools that allow you to do so.

python connect-logger.py will log all dcs-bios data to dcsbios_data.json. Ensure that you start the logger before loading a mission in order to capture the mission-start message properly.

python replay-log.py will ask for a serial port like connect-serial-port.cmd and replay the data to that com-port. When it reaches the end of the file, it will loop forever until you close it. The first message will not be repeated as this is usualy the mission-start message and should only be sent once.

dcsbios_data.json This file contains the logged data in hex format. If you are familiar with the format of dcs-bios messages, you may modify the file by hand if needed. The included sample file is a recording of the A-10C with a blinking Master Caution light.

The Developer Guide explains how to connect to and interpret the DCS-BIOS export data stream and how to send commands to DCS-BIOS in order to operate controls inside the cockpit.

There are also a variety of client libraries available, including (but not limited to):

Currently, DCS-BIOS supports the following aircraft modules:

• AC-130
• Civil Aircraft mod
• MIG-23UB Project
• Mirage F.1
• PAK-FA Project
• SU-30 FAMILY PROJECT
• Upuaut's Bell-47G
• Virtual Cockpits
• VSN-Mods

DCS-BIOS supports many community mods out-of-the-box.

In order to a Flaming-Cliffs-based mod which is not supported by DCS-BIOS, add the following to the bottom of DCS-BIOS/lib/AircraftList.lua:

add("PlaneName", false)

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You may also simply open an issue.

Please see Contributing.md for more information.

Distributed under the GPL 3.0 license. See LICENSE for more information.

The original DCS-BIOS was created by [FSF]Ian under the SimPL 2.0 license.

The copy of socat that comes with DCS-BIOS is licensed under GPL 2.0 (see Programs/socat/COPYING).

For questions, consider asking in our Discussions page, or reach out to us on Discord.

• Original DCS-BIOS
• Best-README-Template
• luacheck
• LuaUnit
• StyLua
• lua-language-server

• Arduino Library
• Arduino Examples
• Bort DCS-BIOS Reference Tool
• BIOSBuddy DCS-BIOS Reference Tool
• DCS-BIOS Bridge