diff --git a/firmware/controllers/actuators/idle_state.txt b/firmware/controllers/actuators/idle_state.txt
new file mode 100644
index 0000000000..947f06ac7e
--- /dev/null
+++ b/firmware/controllers/actuators/idle_state.txt
@@ -0,0 +1,11 @@
+
+struct_no_prefix idle_state_s
+custom idle_state_e 4 bits, S32, @OFFSET@, [0:2], "not important"
+    idle_state_e idleState
+custom percent_t 4 bits, F32, @OFFSET@, [0:2], "not important"
+    percent_t currentIdlePosition;that's current position with CLT and IAT corrections
+    percent_t baseIdlePosition;current position without adjustments (iacByTpsTaper, afterCrankingIACtaperDuration)
+    int throttlePedalUpState;true in IDLE throttle pedal state, false if driver is touching the pedal\ntodo: better name for this field?
+    percent_t etbIdleAddition;ETB position adjustment related to idle RPM control
+! end of idle_state_s structure definition
+end_struct