# iRacing

## Connection Method

**Shared Memory** — DR Sim Manager reads telemetry directly from iRacing's shared memory interface at **360 Hz**. No setup or configuration is needed.

## Setup Steps

1. Install and launch **iRacing** as usual.
2. In DR Sim Manager, select **iRacing** from the Source list.
3. Click **Start Motion**.
4. Join a session and enter the track — telemetry begins automatically when your car is on track.

That's it. No plugins, no configuration files, no ports to set up.

## Available Telemetry

iRacing provides one of the most comprehensive and high-quality telemetry feeds of any sim:

- **Orientation**: Pitch, Roll, Yaw
- **Acceleration**: Full 3-axis at 360 Hz (lateral, longitudinal, vertical) — uses iRacing's high-frequency sub-sampled data for ultra-smooth motion
- **Velocity**: Full 3-axis local velocity at 360 Hz
- **Angular Velocity**: Pitch rate, Roll rate, Yaw rate at 360 Hz
- **Speed**: Vehicle speed
- **RPM**: Engine RPM
- **Gear**: Current gear
- **Suspension**: 4-wheel shock deflection and velocity (FL, FR, RL, RR)
- **Vehicle Name**: Detected automatically from the session

### Telemetry Quality: ★★★★★

iRacing's telemetry is the gold standard for sim racing motion platforms. The 360 Hz high-frequency data provides six sub-samples per physics frame, resulting in extremely smooth and responsive motion with minimal filtering needed.

## Recommended Starting Settings

Because iRacing's telemetry is so clean and high-frequency, you can typically run with less filtering:

- **Primary Cue Gain**: Start at 70–100%
- **Smoothing**: Low values work well (the 360 Hz data is already very smooth)
- **Washout**: Medium — adjust to taste based on your platform's travel

## Known Quirks

- **Telemetry only active on track**: Data is only sent while your car is on the track (the `IsOnTrack` flag must be true). You will not receive motion data in menus, replay mode, or while spectating.
- **High-frequency data**: iRacing sends acceleration, velocity, and angular velocity at 360 Hz (6 sub-samples per 60 Hz physics frame). DR Sim Manager automatically indexes into the correct sub-sample for the smoothest possible motion.
- **RPM threshold**: Engine RPM below 400 is reported as 0 to avoid noise when the engine is off.
- **Gear numbering**: Reverse is reported as gear 0 in iRacing; DR Sim Manager adjusts this by adding 1 (so Reverse = 0, Neutral = 1, First = 2, etc.).

## Troubleshooting

### No telemetry data appearing

- Make sure iRacing is running and you are **on track** in a session (practice, race, etc.). Sitting in menus or watching replays does not produce telemetry.
- Verify that no other application is exclusively locking iRacing's shared memory. Close other motion/telemetry apps and try again.
- Restart iRacing and DR Sim Manager.

### Motion feels jittery

- iRacing's high-frequency data is normally very smooth. Jitter usually indicates your motion platform's output is configured at a very high gain. Try reducing the Primary Cue gain.

### Vehicle name shows "Unknown"

- This can happen briefly when first connecting. It resolves once iRacing reports driver information. If it persists, rejoin the session.

### DR Sim Manager shows "connected" but no motion

- Confirm you are driving (not spectating). The telemetry feed pauses when you are not actively controlling the car.