#telemetry #racing #interface #sim #driving #generic #sims

simetry

Interface with telemetry of various racing and driving sims

8 releases

0.2.3 Feb 16, 2024
0.2.2 Nov 3, 2023
0.2.1 Sep 16, 2023
0.2.0 Jul 19, 2023
0.0.3 Jan 14, 2023

#69 in Simulation

MIT license

265KB
6K SLoC

simetry

Rust library for interfacing with telemetry of various racing and driving sims.

The library is under active development, and the generic interface for handling all sims is yet to be designed.

Currently supported sims:

  • iRacing
  • Assetto Corsa
  • Assetto Corsa Competizione
  • rFactor 2 (extra steps for enabling described below)
  • DiRT Rally 2.0
  • Euro Truck Simulator 2 (extra steps for enabling described below)
  • American Truck Simulator (extra steps for enabling described below)

Beyond that, an interface for a generic HTTP server exists, allowing you to easily emulate any sim to see the functionality of your software that way, instead of having to run the sim and replicating scenarios manually.

All implementations provide a Client which retries connections forever with Client::connect() and generates its own SimState.

Besides that, iRacing provides a DiskClient for reading recorded telemetry data, and commands for sending commands to iRacing.

Examples of capabilities are available in examples.

The most generic way of use is using simetry::connect to connect to whatever sim is currently running with a generic client, and querying that way.

That generic way currently only supports some basic capabilities, and if you need more than what's present there, you can use the interface of the individual sims.

Extra Configuration

rFactor 2

Requires adding the DLLs from https://github.com/TheIronWolfModding/rF2SharedMemoryMapPlugin.

Euro Truck Simulator 2 and American Truck Simulator

Requires adding the DLLs from https://github.com/RenCloud/scs-sdk-plugin.

Alternatively supporting also https://github.com/Funbit/ets2-telemetry-server via simetry::truck_simulator::json_client::Client.

Dependencies

~144MB
~2.5M SLoC