EMOG Specification

Extended Motorsport Open Gauge

JSON structure specification for automotive software and hardware communication

Version: 0.1

Status: Public

---

General Rules

Default EMOG Announce/Beacon port is 9997.

Read Announce/Negotiation Documentation

View Code Snippets

All fields follow this format:

- : OR unsupported NULL or unknown/unset False

Type Definitions

• float32
• int32
• uint32
• bool
• string
• enum
• float32[4]
• object

Field State Rules

If a field is not supported by the data source:

• Numeric types → NULL
• Boolean types → False
• String types → NULL
• Enum types → NULL
• Object types → NULL

No other fallback values are permitted.

---

meta

• timestamp_ms: uint32 OR unsupported NULL or unknown/unset False
• source: string OR unsupported NULL or unknown/unset False
• source_version: string OR unsupported NULL or unknown/unset False
• session_id: string OR unsupported NULL or unknown/unset False
• seq: uint32 OR unsupported NULL or unknown/unset False
• sample_hz: float32 OR unsupported NULL or unknown/unset False
• spec_version: string OR unsupported NULL or unknown/unset False

---

identity

• game: string OR unsupported NULL or unknown/unset False
• vehicle_id: string OR unsupported NULL or unknown/unset False
• vehicle_name: string OR unsupported NULL or unknown/unset False
• vehicle_class: string OR unsupported NULL or unknown/unset False
• track_id: string OR unsupported NULL or unknown/unset False
• track_name: string OR unsupported NULL or unknown/unset False
• player_name: string OR unsupported NULL or unknown/unset False

---

vehicle

• speed_mps: float32 OR unsupported NULL or unknown/unset False
• speed_kph: float32 OR unsupported NULL or unknown/unset False
• speed_mph: float32 OR unsupported NULL or unknown/unset False
• rpm: float32 OR unsupported NULL or unknown/unset False
• rpm_max: float32 OR unsupported NULL or unknown/unset False
• gear: int32 OR unsupported NULL or unknown/unset False
• gear_display: string OR unsupported NULL or unknown/unset False
• engine_on: bool OR unsupported NULL or unknown/unset False
• ignition_on: bool OR unsupported NULL or unknown/unset False

---

input

• throttle: float32 OR unsupported NULL or unknown/unset False
• brake: float32 OR unsupported NULL or unknown/unset False
• clutch: float32 OR unsupported NULL or unknown/unset False
• steering: float32 OR unsupported NULL or unknown/unset False
• steering_angle_deg: float32 OR unsupported NULL or unknown/unset False
• handbrake: float32 OR unsupported NULL or unknown/unset False

---

controls_state

• abs_active: bool OR unsupported NULL or unknown/unset False
• tc_active: bool OR unsupported NULL or unknown/unset False
• esc_active: bool OR unsupported NULL or unknown/unset False
• pit_limiter: bool OR unsupported NULL or unknown/unset False
• drs_active: bool OR unsupported NULL or unknown/unset False
• engine_map: int32 OR unsupported NULL or unknown/unset False
• tc_level: int32 OR unsupported NULL or unknown/unset False
• abs_level: int32 OR unsupported NULL or unknown/unset False

---

engine

• load_pct: float32 OR unsupported NULL or unknown/unset False
• throttle_pct: float32 OR unsupported NULL or unknown/unset False
• coolant_temp_c: float32 OR unsupported NULL or unknown/unset False
• oil_temp_c: float32 OR unsupported NULL or unknown/unset False
• oil_pressure_kpa: float32 OR unsupported NULL or unknown/unset False
• fuel_level_pct: float32 OR unsupported NULL or unknown/unset False
• fuel_rate_lph: float32 OR unsupported NULL or unknown/unset False
• fuel_pressure_kpa: float32 OR unsupported NULL or unknown/unset False
• map_kpa: float32 OR unsupported NULL or unknown/unset False
• boost_kpa: float32 OR unsupported NULL or unknown/unset False
• boost_target_kpa: float32 OR unsupported NULL or unknown/unset False
• iat_c: float32 OR unsupported NULL or unknown/unset False
• afr: float32 OR unsupported NULL or unknown/unset False
• lambda: float32 OR unsupported NULL or unknown/unset False
• timing_advance_deg: float32 OR unsupported NULL or unknown/unset False
• knock_level: float32 OR unsupported NULL or unknown/unset False
• battery_voltage: float32 OR unsupported NULL or unknown/unset False

---

drivetrain

• drivetrain_layout: enum OR unsupported NULL or unknown/unset False
• diff_lock_pct: float32 OR unsupported NULL or unknown/unset False
• clutch_slip_rpm: float32 OR unsupported NULL or unknown/unset False
• trans_temp_c: float32 OR unsupported NULL or unknown/unset False

---

dynamics

• g_long: float32 OR unsupported NULL or unknown/unset False
• g_lat: float32 OR unsupported NULL or unknown/unset False
• g_vert: float32 OR unsupported NULL or unknown/unset False
• yaw_rate_dps: float32 OR unsupported NULL or unknown/unset False
• pitch_rate_dps: float32 OR unsupported NULL or unknown/unset False
• roll_rate_dps: float32 OR unsupported NULL or unknown/unset False
• orientation_yaw_deg: float32 OR unsupported NULL or unknown/unset False
• orientation_pitch_deg: float32 OR unsupported NULL or unknown/unset False
• orientation_roll_deg: float32 OR unsupported NULL or unknown/unset False

---

position

• world_x_m: float32 OR unsupported NULL or unknown/unset False
• world_y_m: float32 OR unsupported NULL or unknown/unset False
• world_z_m: float32 OR unsupported NULL or unknown/unset False
• velocity_x_mps: float32 OR unsupported NULL or unknown/unset False
• velocity_y_mps: float32 OR unsupported NULL or unknown/unset False
• velocity_z_mps: float32 OR unsupported NULL or unknown/unset False
• gps_lat: float32 OR unsupported NULL or unknown/unset False
• gps_lon: float32 OR unsupported NULL or unknown/unset False
• gps_alt_m: float32 OR unsupported NULL or unknown/unset False
• heading_deg: float32 OR unsupported NULL or unknown/unset False

---

wheels

• wheel_speed_fl_kph: float32 OR unsupported NULL or unknown/unset False
• wheel_speed_fr_kph: float32 OR unsupported NULL or unknown/unset False
• wheel_speed_rl_kph: float32 OR unsupported NULL or unknown/unset False
• wheel_speed_rr_kph: float32 OR unsupported NULL or unknown/unset False
• brake_temp_fl_c: float32 OR unsupported NULL or unknown/unset False
• brake_temp_fr_c: float32 OR unsupported NULL or unknown/unset False
• brake_temp_rl_c: float32 OR unsupported NULL or unknown/unset False
• brake_temp_rr_c: float32 OR unsupported NULL or unknown/unset False
• tyre_temp_fl_c: float32 OR unsupported NULL or unknown/unset False
• tyre_temp_fr_c: float32 OR unsupported NULL or unknown/unset False
• tyre_temp_rl_c: float32 OR unsupported NULL or unknown/unset False
• tyre_temp_rr_c: float32 OR unsupported NULL or unknown/unset False
• tyre_pressure_fl_kpa: float32 OR unsupported NULL or unknown/unset False
• tyre_pressure_fr_kpa: float32 OR unsupported NULL or unknown/unset False
• tyre_pressure_rl_kpa: float32 OR unsupported NULL or unknown/unset False
• tyre_pressure_rr_kpa: float32 OR unsupported NULL or unknown/unset False
• tyre_wear_fl_pct: float32 OR unsupported NULL or unknown/unset False
• tyre_wear_fr_pct: float32 OR unsupported NULL or unknown/unset False
• tyre_wear_rl_pct: float32 OR unsupported NULL or unknown/unset False
• tyre_wear_rr_pct: float32 OR unsupported NULL or unknown/unset False
• slip_ratio_fl: float32 OR unsupported NULL or unknown/unset False
• slip_ratio_fr: float32 OR unsupported NULL or unknown/unset False
• slip_ratio_rl: float32 OR unsupported NULL or unknown/unset False
• slip_ratio_rr: float32 OR unsupported NULL or unknown/unset False
• slip_angle_fl_deg: float32 OR unsupported NULL or unknown/unset False
• slip_angle_fr_deg: float32 OR unsupported NULL or unknown/unset False
• slip_angle_rl_deg: float32 OR unsupported NULL or unknown/unset False
• slip_angle_rr_deg: float32 OR unsupported NULL or unknown/unset False
• ride_height_fl_m: float32 OR unsupported NULL or unknown/unset False
• ride_height_fr_m: float32 OR unsupported NULL or unknown/unset False
• ride_height_rl_m: float32 OR unsupported NULL or unknown/unset False
• ride_height_rr_m: float32 OR unsupported NULL or unknown/unset False

---

aero

• drs_available: bool OR unsupported NULL or unknown/unset False
• downforce_n: float32 OR unsupported NULL or unknown/unset False
• drag_n: float32 OR unsupported NULL or unknown/unset False

---

damage

• engine_damage_pct: float32 OR unsupported NULL or unknown/unset False
• aero_damage_pct: float32 OR unsupported NULL or unknown/unset False
• body_damage_pct: float32 OR unsupported NULL or unknown/unset False
• suspension_fl_pct: float32 OR unsupported NULL or unknown/unset False
• suspension_fr_pct: float32 OR unsupported NULL or unknown/unset False
• suspension_rl_pct: float32 OR unsupported NULL or unknown/unset False
• suspension_rr_pct: float32 OR unsupported NULL or unknown/unset False
• tyre_puncture_fl: bool OR unsupported NULL or unknown/unset False
• tyre_puncture_fr: bool OR unsupported NULL or unknown/unset False
• tyre_puncture_rl: bool OR unsupported NULL or unknown/unset False
• tyre_puncture_rr: bool OR unsupported NULL or unknown/unset False

---

session

• state: enum OR unsupported NULL or unknown/unset False
• mode: enum OR unsupported NULL or unknown/unset False
• on_track: bool OR unsupported NULL or unknown/unset False
• is_paused: bool OR unsupported NULL or unknown/unset False
• lap: int32 OR unsupported NULL or unknown/unset False
• lap_time_ms: uint32 OR unsupported NULL or unknown/unset False
• best_lap_time_ms: uint32 OR unsupported NULL or unknown/unset False
• last_lap_time_ms: uint32 OR unsupported NULL or unknown/unset False
• sector: int32 OR unsupported NULL or unknown/unset False
• sector_time_ms: uint32 OR unsupported NULL or unknown/unset False
• position: int32 OR unsupported NULL or unknown/unset False
• cars_total: int32 OR unsupported NULL or unknown/unset False
• track_temp_c: float32 OR unsupported NULL or unknown/unset False
• air_temp_c: float32 OR unsupported NULL or unknown/unset False
• rain_level: float32 OR unsupported NULL or unknown/unset False
• flag: enum OR unsupported NULL or unknown/unset False

---

hardware

• ffb_torque_nm: float32 OR unsupported NULL or unknown/unset False
• ffb_clip: bool OR unsupported NULL or unknown/unset False
• wheel_rotation_deg: float32 OR unsupported NULL or unknown/unset False
• base_temp_c: float32 OR unsupported NULL or unknown/unset False
• pedal_raw_throttle: int32 OR unsupported NULL or unknown/unset False
• pedal_raw_brake: int32 OR unsupported NULL or unknown/unset False
• pedal_raw_clutch: int32 OR unsupported NULL or unknown/unset False

---

End of Specification