Repository navigation
IFSSIM v0.1.0 — first release
First public release of IFSSIM — a UE5.7-native Formula Student Driverless simulator with a ROS 2 bridge and a Mission Control web stack.
Highlights
- Sensors: GPU-rendered Hesai ATX-S01 LiDAR (10 Hz, ~1.74M points/s), BMI088 IMU (400 Hz), GPS, GSS, Bosch LWS steering sensor.
- Vehicle: IFS-08 chassis, Chaos physics, EMRAX 228 MV motor with NX-tech LUT torque envelope, regen gated by cell-input current limit.
- Wire layer: TCP RPC + TCP LiDAR stream (#482) on a single port 41451 — no per-OS proxy quirks, no Docker Desktop toggle required. UDP fallback retained as an env-var escape hatch.
- ROS 2 bridge (Humble): all sensor topics, Foxglove WebSocket on 8765.
- Mission Control: FastAPI backend (8000) + React frontend (3000) for FS-DV lifecycle, scoring, replay.
- Tracks: 10 built-in (acceleration, skidpad, trackdrive variants), CSV-validated, random-track generator included.
- Referee: FS-Rules 2026 D 9.1.1 single-run scoring across all four DV disciplines.
Platform support
| Platform | Status |
|---|---|
| macOS 14+ (Apple Silicon) | ✅ shipping |
| Windows 10/11 (x64) | ✅ shipping |
| Linux | not in scope for v0.1.0 |
Download
- Mac:
IFSSIM-v0.1.0-Mac.zip(~986 MB) — extract and openIFSSIM-Mac-Shipping.app. - Windows:
IFSSIM-v0.1.0-Windows-x64.zip(~312 MB) — extract and runIFSSIM.exe.
First-launch setup
- Install Docker Desktop, clone the repo,
docker compose up -d. - Extract the archive for your platform.
- Launch the executable.
- First launch:
- Windows: Windows Firewall prompts for TCP 41451 — allow.
- macOS: Gatekeeper will warn about an unidentified developer on first run. Right-click → Open, then confirm. The build is ad-hoc signed with the sandbox-server entitlement for binding to TCP/41451; no notarisation in v0.1.0.
QUICKSTART: docs/QUICKSTART.md.
Known issue (deferred to v0.1.1)
- #483 — cone-floor clipping. Spline-spawned cones sit a few cm below the visible asphalt on every track. Visual + LiDAR-perf impact (bottom rings get occluded). Autonomy logic is unaffected. Diagnosis + fix recipe in
docs/cone_floor_clipping_fix.md.
Full changelog
See CHANGELOG.md for the complete feature list, post-scaffold accumulator entries, and the Windows-port series (#477–#482) that brought first-class Windows support.
🤖 Built from commit b2e0272 on dev.