Quickstart Tutorial

This walkthrough guides you through a minimalist SUMO-based co-simulation to confirm Real-Sim is wired correctly.

1. Prep the Environment

• Complete the steps in doc/getting-started.md.

• Ensure SUMO is installed and on PATH.

• Copy tests\coordMerge\config_SUMO.yaml into a working folder.

2. Launch TrafficLayer

TrafficLayer.exe -f coordMerge\config_SUMO.yaml

Verify the console prints the “Succesful Environment Check” summary (from env.check.py).

3. Start SUMO

sumo-gui -c tests\coordMerge\coordMerge.sumocfg --remote-port 1337 --step-length 0.1 --start

SUMO should connect to the Real-Sim port configured in the YAML.

4. Observe Data Flow

• Watch TrafficLayer.exe logs to ensure vehicle updates stream in.

• Optionally, start the Simulink template model CarMaker\RealSimGeneric.mdl to subscribe to the same vehicles.

At this point you have a working single-client setup. Continue to tutorials/examples.md for variations (multiple vehicles, dSPACE, etc.).