Formula Student Driverless Simulation

Documentation

For installation and more information about the ROS and python interface, check the documentation

More information

Some more information about the project can be found here.

Run the simulator

• Download the latest released version according to your OS

• For Windows :

  .\initialize.cmd
  

  • You can then move and rename the folder however you want. Make sure you don't only move the .exe file
  • Start FDSD.exe

• For Linux :

  chmod +x initialize.sh && chmod +x FSDS.sh
  ./initialize.sh
  

  • You can then move the folder and rename it however you want but don't modify the subfolders nor the files
  • Run the simulator :

  ./FSDS.sh
  

• For MacOS :

  chmod +x initialize.sh
  ./initialise.sh
  

  • You can then move the FDSD.app wherever you want
  • Start FDSD.app

Windows Installation

Prerequisites

• Unreal Engine 4.27

• Microsoft Visual Studio 2019

• Make sure that you installed the .NET desktop development and Desktop development with C++ workloads in VS 2019

  git clone https://github.com/EPFL-RT-Driverless/FSDS.git
  

• Make sure to have git-lfs installed and run git lfs install and git lfs pull in the FSDS folder

• Open the Developer Command Prompt for VS 2019

• Navigate to the FSDS/AirSim folder

  build.cmd
  

• Open UE4Editor 4.27 and open UE4Project/FSOnline.uproject

• It might show an error like 'This project was made with a different version of the Unreal Engine'. In that case select more options and skip conversion.

• When asked to rebuild the 'Blocks' and 'AirSim' modules, choose 'Yes'. This is the step where the plugin part of AirSim is compiled.

• Enjoy the simulator!

Mac Installation

• Unreal Engine 4.27

  git clone https://github.com/EPFL-RT-Driverless/FSDS.git
  cd FSDS
  

• Make sure to have git-lfs installed and run git lfs install and git lfs pull in the FSDS folder

  cd AirSim
  ./setup.sh && ./build.sh
  

• Open UE4Editor 4.27 and open UE4Project/FSOnline.uproject

• It might show an error like 'This project was made with a different version of the Unreal Engine'. In that case select more options and skip conversion.

• When asked to rebuild the 'Blocks' and 'AirSim' modules, choose 'Yes'. This is the step where the plugin part of AirSim is compiled.

• Enjoy the simulator!

Ubuntu Installation

• Unfortunatly, the forked repository doesn't build on Linux. If you want to build the executable for Linux, you need to package it with the cross-compilation method. You won't be able to run the UE4Editor on Linux.
• Complete all the steps of the Windows Installation section.
• Install the cross-compilation toolchain for Windows. You can find the instructions here. Be sure to download the toolchain for the version 4.27 of Unreal Engine.
• Some libs need to be installed and compiled for linux fortunately, we did it for you. Just run the following commands:

  cd FSDS/scripts
  cp librpc.a UE4Project/Plugins/AirSim/Source/AirLib/deps/rpclib/lib
  

• Right click on FSDS/UE4Project/FSOnline.uproject and select Generate Visual Studio project files
• Open UE4Editor 4.27 and open FSDS/UE4Project/FSOnline.uproject
• You can now build the project for Linux. To do so, go to File > Package Project > Build Configuration > Development and then File > Package Project > Linux > Linux.
• Enjoy the simulator!

Credits

This project is forked from Formula Student Driverless Simulator. Based on AirSim.