Skip to content

modelica/fmi-ls-bus

Repository files navigation

FMI Layered Standard for Network Communication

Build Specification

This repository contains a current prototype draft of the FMI Layered Standard for Network Communication (FMI-LS-BUS) based on the Functional Mock-up Interface 3.0 standard for the exchange of simulation models. Note that this draft is being worked on actively, and thus are subject to change without notice.

This is currently not normative, nor is this document to be considered officially endorsed by the Modelica Association or other involved organisations prior to official adoption.

The FMI 3.0 Layered Standard for Network Communication is currently maintained on GitHub and is based on the FMI standard. The current state of development is published here and contains all bus types that are currently in development or are already final. Official releases are directly published via GitHub.

Roadmap

Different abstraction layers and types of buses are developed in different versions that build on each other. Corresponding milestones and a detailed roadmap have been defined for this purpose. The following graphic provides an overview of the planned sequence of supported bus systems:

roadmap of FMI-LS-BUS

A detailed roadmap showing completed, current and future work can be accessed here.

News

Looking forward to our joint presentation and demo "FMI, Layered Standards and ASAM Standards - Enabling Seamless SiL Simulation of Virtual ECUs" from the FMI Project at the coming ASAM International Conference, 2024 in Munich. You can meet us also at the Modelica Association booth there!

We will present three new layered standards for simulating virtual ECUs with FMI 3.0:

  • FMI-LS-XCP for measurement & calibration with XCP
  • FMI-LS-BUS for simulation of network communication with CAN, CAN FD CAN XL, FlexRay, Ethernet, LIN
  • FMI-LS-STRUCT for structured entities like lookup tables

A demo from tool vendors (Akkodis, Altair, AVL, Bosch, dSPACE, PMSF, SYNOPSYS) illustrates the interoperability of these layered standards.

AIC Announcemet Speakers FMI

Looking forward to meet you in Munich! More information on the conference: https://www.asam.net/conferences-events/detail/asam-international-conference-2024/

Repository Structure

  • docs -- Sources of the specification document
  • headers -- Header files of the C-API
  • schema -- XSD schema for this FMI Layered
  • tests -- Contains unit tests for the provided header files

Getting Started

To help you get started, we provide introductory chapters. The following resources are currently available:

Demos

Demo FMUs are available within the FMI-LS-BUS Implementers' Guide to illustrate how to use and implement the FMI-LS-BUS. More demos will be added iteratively in the near future. See also the overview pages for the demos, categorized by the different supported bus types of the FMI-LS-BUS.

FMI-LS-BUS Implementers' Guide

The FMI-LS-BUS Implementers' Guide is a free resource intended to give non-normative recommendations and guidance to implementers of the Functional Mock-up Interface Layered Standard for Network Communication (FMI-LS-BUS).

Tools

The following list shows importers and exporters that currently support the FMI-LS-BUS layered standard and that have been validated by a cross-check. It should be noted that tool implementations in some cases might be experimental, because the FMI-LS-BUS layered standard is currently not in a finale state. Feel free to contact the specified tool vendors if you are interested in using the FMI-LS-BUS layered standard. Additionally, any FMU importer that supports the necessary FMI 3.0 features, such as clocks and binary variables, has generic FMI-LS-BUS support and can be used.

Tool Type Features Remarks
Altair Twin Activate Importer Direct Communication Bus Simulation FMU
High-Cut Low-Cut: CAN Low-Cut: FlexRay
Fmi3-Terminals are not supported
dSPACE SystemDesk Exporter Low-Cut: CAN Low-Cut: FlexRay Available since RLS 2024-B
dSPACE VEOS Importer Integrated Bus Simulation
Low-Cut: CAN Low-Cut: FlexRay
Available since RLS 2024-B
Model.CONNECT™ Importer Direct Communication Bus Simulation FMU
High-Cut Low-Cut: CAN Low-Cut: FlexRay
-
Synopsys Silver Importer Integrated Bus Simulation
Low-Cut: CAN
-
Supported system compositions Supported bus types
Direct communication High-cut
Composition with dedicated bus simulation FMU Low-cut CAN
Importer with integrated bus simulation Low-cut FlexRay

Copyright and License

Code and documentation copyright (C) 2023-2024 The Modelica Association Project FMI. Code released under the 2-Clause BSD License. Docs released under Attribution-ShareAlike 4.0 International.

Other FMI Layered Standards

If you are interested in the FMI Layered Standard for Network Communication, the FMI-LS-XCP could also be relevant to you. The FMI-LS-XCP specifies an FMI extension for using the XCP protocol and A2L variable description within FMUs.