Live Values

Live Values

Live Values control the real-time behavior of dynamic CAN messages while the simulator is running. These values directly modify payloads such as GPS position, vehicle speed, fuel level, and engine load.

They act as live inputs that update message data continuously without rebuilding the active profile.

---

✅ What Live Values Control

Live Values affect the following systems:

• ✅ GPS Position (Latitude & Longitude)
• ✅ Heading / Course Over Ground (COG)
• ✅ Speed Over Ground (SOG)
• ✅ Fuel Level
• ✅ Engine Load
• ✅ Engine Coolant Temperature

These values dynamically update:

• CAN payloads
• Transmit data on each cycle
• Any profile messages that depend on motion or engine state

---

✅ Available Live Value Controls

Control	Range	Used For
Latitude	-90 to +90	GNSS Position
Longitude	-180 to +180	GNSS Position
Heading / COG	0–359°	Direction
Speed Over Ground	0–50 m/s	Motion
Fuel Level	0–100%	Engine
Engine Load	0–250%	Engine Stress
Coolant Temp	-40–200°C	Engine Thermal

---

✅ Editing Live Values

When Simulator Is Stopped:

• All values are fully editable
• Changes update profile state immediately

When Simulator Is Running:

• Latitude & Longitude become read-only
• Position updates automatically from virtual motion
• Other fields remain editable

This ensures motion stays physically consistent.

---

✅ Live Motion System

When the simulator is running:

1. A timestamp-based motion engine computes new GPS positions
2. Position shifts are applied every 200 ms (5 Hz)
3. Live GNSS values update automatically

Motion is based on:

• Current heading (COG)
• Current speed (SOG)
• Elapsed runtime

---

✅ Saving Live Values

When you click Save Profile:

• All Live Values are written to the JSON file
• They are restored exactly when reloaded later

Stored under:

"live_values": {
"LAT_DEG": 51.12345,
"LON_DEG": -102.12345,
"COG_DEG": 90.0,
"SOG_MS": 7.5,
...
}

---

✅ Loading Live Values

When a profile is loaded:

1. Live values are restored automatically
2. UI spin boxes update instantly
3. Motion state resets cleanly
4. Message timing resumes safely

---

✅ Safety Protections

• You cannot load profiles while running
• You cannot edit motion while simulator is moving
• The simulator blocks conflicting edits automatically

---

✅ Best Practice Workflow

1. Set Live Values first
2. Select Built-in Profile
3. Add Raw Messages (if needed)
4. Start the simulator
5. Save when tuned

---