SkillAgentSearch skills...

FIXS

Flexible Interface for X-in-the-loop Simulation (FIXS) is part of the Real-Sim project funded by Department of Energy (DOE)-Transportation Technology Office (TTO)-Energy Efficient Mobility Systems (EEMS) program. It is part of the core tools of EEMS.

GenerateConvertImprove

Install / Use

/learn @ORNL-Real-Sim/FIXS
About this skill

Quality Score

0/100

Supported Platforms

Universal

README

Flexible Interface for XIL Simulation (FIXS)

FIXS Contacts

Primary Maintainer: University of Georgia\

Oak Ridge National Lab PIs Max Chen
chenm@ornl.gov
Anye Zhou
zhoua@ornl.gov

About

This interface is part of the Real-Sim project funded by Department of Energy (DOE)-Vehicle Technology Office (VTO)-Energy Efficient Mobility Systems (EEMS) program. It is part of the core tools of EEMS.

Real-Sim develops a multi-resolution X-in-the-loop (XIL) simulation framework to support inclusive testing and evaluation of emerging technologies such as connected and automated vehicles. The Real-Sim framework connects different simulation components and integrates various traffic and vehicle simulation tools, virtual environments, and XIL systems through a Flexible Interface for XIL Simulation (FIXS). Connections among different tools are transparent to users and handled by the interface behind the scenes. Co-simulation of various vehicle and traffic simulation tools with different XIL systems can be easily achieved and become a transparent "plug-and-play" process to users.

Real-Sim Project Lead: Oak Ridge National Lab
Real-Sim Project Team: University of Georgia, University of Texas-Dallas

Links to current project presentation
https://www1.eere.energy.gov/vehiclesandfuels/downloads/2024_AMR/EEMS101_Chen_2024_o.pdf
https://www1.eere.energy.gov/vehiclesandfuels/downloads/2023_AMR/eems101_Shao_2023_o_v2%20-%20Yunli%20Shao.pdf_ADW373C.tmp.pdf

Links to older project presentation
https://www1.eere.energy.gov/vehiclesandfuels/downloads/2022_AMR/eems101_deter_2022_o_5.1_651pm_LS.pdf https://www1.eere.energy.gov/vehiclesandfuels/downloads/2022_AMR/eems067_deter_2022_o_5.12_1157am_TM.pdf https://www.energy.gov/sites/default/files/2021-06/eems101_deter_2021_o_5-19_645pm_LR_ML.pdf

Publication list is upcoming...

Other links

This README contains general information of the interface. For specific documentation of different simulators, check the following links:

Current software versions used in FIXS development CM13.1.3, Carla 0.9.15, VISSIM 2022, SUMO 1.21, dSPACE/Matlab 2024a

Table of Contents

Preface

Before testing the Real-Sim interface, please

  • read through this README
  • review the configuration reference for a full description of every YAML option
  • check comments in config.yaml for quick reminders on common fields
  • check annotations in the Simulink template which specifies how to properly use each block
  • RealSimPack.m and RealSimDepack.m files are currently open-source. check the comments before modifying.

General Setups

The interface runs the connections to different software, simulators by itself to provide plug-in-and-play experience for the users. A config.yaml file is critical to setup the interface parameters and configure different scenarios.

By default the executable looks for the SUMO runtime under CommonLib/libsumo/bin relative to the repository. When running from TrafficLayer/x64/<Config> or build, keep that folder with the executable or set SumoSetup.RuntimeLibraryPath in the configuration file.

NOTE: below is still experimental features and only applies to SUMO for now. There are different mode of synchronization and opeartion of the Real-Sim interface. The SimulationMode parameter is an integer with each bit as the followings:

  • bit 2, bit 1, bit 0:

    • binary 000, integer 0: Application/Xil will connect and sync with Simulator (SUMO/VISSIM) at the beginning of the simulation

    • binary 001, integer 1: Application/Xil will connect with the Simulator and in wait mode until the ego vehicle enters the network then sync.

      This is suitable for simulation environment where users want to run the SUMO simulation at fast pace without running a Simulink model until the ego vehicle enters.

    <!-- - **binary 010, integer 2**: Application/Xil will connect with the Simulator and running steps but NOT sync with the Simulator until the ego vehicle enters the network This is suitable for XIL environment where users want to run the VISSIM/SUMO simulation at fast pace before the ego vehicle enters the network, but the Simulink model needs to also starts at beginning. Before ego vehicle enters, Simulink and VISSIM/SUMO are both running without any message sharing. After ego vehicle enters, the ego vehicle in Simulink will then sync with the same one in VISSIM/SUMO. -->

    • binary 100, integer 4: Application/Xil will connect with the Simulator and in wait mode until the specified initial simulation seconds (parameter SimulationModeParamter) then sync

      This is suitable for simulation environment where users want to run the SUMO simulation at fast pace without running a Simulink model until the a specific seconds later. You could add ramp up and ramp down in the Simulink model and manipulate the SimulationModeParamter settings so that Simulink and SUMO sychronized only after the ego vehicle in Simulink reaches initial speed.

<!-- - **binary 101, integer 5**: Application/Xil will connect with the Simulator and running steps but NOT sync with the Simulator until the specified initial simulation seconds (parameter **SimulationModeParamter**) then sync This is suitable for XIL environment where users want to run the VISSIM/SUMO simulation at fast pace before a specific second, but the Simulink model needs to also starts at beginning. Before the specific second, Simulink and VISSIM/SUMO are both running without any message sharing. After the specific second, the ego vehicle in Simulink will then sync with the same one in VISSIM/SUMO. -->

SimulationModeParamter is a double variable that currently only used for mode binary 100, integer 4 and binary 101, integer 5

Build

Real-Sim FIXS uses a modular build system with automated tool detection. For detailed build instructions, see doc/BUILD.md.

Quick Start

Prerequisites:

  • Visual Studio 2022 (Community, Professional, or Enterprise)
  • CMake (version 3.10 or higher)
  • Optional: MATLAB 2024a, CarMaker 13.1.3/11.1.2, dSPACE ConfigurationDesk 2024-A

Full Release Build:

dispatch.bat

This single command automatically:

  • Detects installed tools (Visual Studio, MATLAB, dSPACE, CarMaker)
  • Reads versions from dependencies.yaml
  • Builds all components (TrafficLayer, VISSIM DLLs, CarMaker executables, dSPACE libraries, MEX files)
  • Packages everything into the build/ directory

Development Builds:

For faster iteration during development, build individual components:

# Core components only
scripts\dispatch\2_core_components.bat

# VISSIM components only
scripts\dispatch\3_vissim_components.bat

# CarMaker components only (auto-generates BuildConfig files)
powershell -ExecutionPolicy Bypass -File scripts\dispatch\4a_carmaker_components.ps1

For complete build system documentation including Debug/Release configurations, troubleshooting, and architecture details, see doc/BUILD.md.

Compatibility to Previous Versions

Here are potential compatibility issues with different versions

RealSimDepack Output

Instead of multiple outputs, now RealSimDepack will output one single bus signal,

VISSIM and SUMO comparison

To be filled...

Troubleshooting

  • If in any case an issue occurs when using the interface, first try to restart VISSIM and MATLAB and try again.

  • If issue persists, turn on the EnableVerboseLog in the config.yaml, enable log of the RealSimSocket s-function, repeat the simulation that causes the issue. Then locate the following logs and error reports and check them (some of the logs will be overwritten when a new simulation starts):

    • TrafficLayer.err in the directory of TrafficLayer.exe
    • Copy/Screenshot the outputs displaying from the cmd window running the TrafficLayer.exe
    • DriverModelError.txt and DriverModelLog.txt in the directory of the VISSIM network file
    • Copy/Screenshot outputs from the 'Diagnostic Viewer' of the Simulink.

Appendix

Vehicle Message Field Specifications

This is a full list of vehicle message field

std::string id; // VISSIM id is integer and will be converted to string, e.g., (int) 8 ==> (string) "8"
std::string type; // VISSIM type is integer and will be converted to string, e.g., (int) 100 ==> (string) "100"
std::string vehicleClass; // vehicle class, such as car, truck in VISSIM; private, passenger, truck in SUMO
float speed; // m/s
float acceleration; // m/s^2
float positionX; // m, position based on the coordinates defined in VISSIM/SUMO
float positionY; // m
float positionZ; // m
float heading; // heading in degree, north is 0 degree, then increasing clockwise. i.e., east is 90 degree.
uint32_t color;  // combined bits in order of r,g,b,a, each is 8-bit, i.e., leftmost 8-bit is r
std::string linkId; // VISSIM linkId is integer and will be converted to string, e.g., (int) 10001 ==> (string) "10001"
int32_t laneId; // lane id convention is consistent to VISSIM, with rightmost lane to be 1
float distanceTravel; // m, cumulative driving distanc

ORNL-Real-Sim

View profile

View on GitHub
GitHub Stars18
CategoryDevelopment
Updated5d ago
Forks5
ORNL-Real-Sim/FIXS

Languages

C++

Security Score

75/100

Audited on Mar 24, 2026

No findings