# Automobilista 2

## Connection Method

**Shared Memory** — Automobilista 2 writes telemetry data to a shared memory region. You need to enable the correct shared memory mode in the game's settings.

* **Shared Memory Name**: `$pcars2$`
* **Update Rate**: Up to 200 Hz

## Setup Steps

1. Launch **Automobilista 2**.
2. Go to **Options > System**.
3. Under **Shared Memory**, select **"Project CARS 2"**.
4. Apply the settings.
5. In DR Sim Manager, select **Automobilista 2** from the Source list and click **Start Motion**.

> **Important**: You must select "Project CARS 2" as the shared memory mode — not "Project CARS" or any other option. AMS2 uses the pCARS2 shared memory format.

## Available Telemetry

AMS2 provides one of the most feature-rich telemetry datasets:

* **Orientation**: Pitch, Roll, Yaw (Euler angles)
* **Acceleration**: Full 3-axis local acceleration
* **Velocity**: Full 3-axis local velocity
* **Angular Velocity**: Full 3-axis rotation rates
* **Speed**: Vehicle speed
* **RPM**: Engine RPM
* **Gear**: Current gear (including reverse and neutral)
* **Suspension**: 4-wheel suspension travel
* **Terrain Type**: Surface type under each wheel (road, grass, gravel, rumble strips, dirt, sand, cobbles, snow, etc.)
* **Throttle, Brake, Clutch**: Driver inputs (0.0–1.0)
* **ABS**: Anti-lock braking status
* **Vehicle Name**: Car name and class
* **Weather**: Rain density, wind, temperature

### Telemetry Quality: ★★★★★

AMS2's shared memory provides comprehensive, high-frequency data at 200 Hz. The terrain type data is especially useful for the Ground Cue, which can generate surface-appropriate vibrations.

## Recommended Starting Settings

* **Primary Cue Gain**: 70–100%
* **Smoothing**: Low to medium
* **Washout**: Medium
* **Ground Cue**: Enable this — AMS2's terrain data allows the Ground Cue to produce surface-specific effects (rumble strips, grass, gravel)

## Known Quirks

* **Must select "Project CARS 2" mode**: AMS2 supports multiple shared memory formats. Only the "Project CARS 2" option works with DR Sim Manager. If you see no data, check this setting first.
* **Same format as Project CARS 2**: AMS2 uses the same shared memory structure as Project CARS 2. The **Project CARS 2** source in DR Sim Manager also uses this format.
* **Sequence number validation**: The shared memory includes a sequence counter that indicates when data is being written. DR Sim Manager uses acceleration changes to detect new data frames.
* **Rich terrain data**: AMS2 reports over 50 different surface types, which DR Sim Manager maps to standardized categories (road, bumpy road, rumble strips, gravel, grass, sand, dirt, cobbles, snow/ice, concrete, metal).

## Troubleshooting

### No telemetry data

1. Go to **Options > System** in AMS2 and verify **Shared Memory** is set to **"Project CARS 2"**.
2. Make sure you are in a driving session on track (not in menus).
3. Restart both AMS2 and DR Sim Manager.

### Shared Memory setting keeps resetting

* Some AMS2 updates may reset the Shared Memory option. Check this setting after game updates.
* Make sure you click **Apply** after changing the setting.

### Motion works but Ground Cue is inactive

* Ensure the **Ground Cue** is enabled in your profile.
* AMS2's terrain data is only active while driving — it won't show surface effects in menus or replays.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.departedreality.com/dr-sim-manager/general/sources/automobilista-2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
