version: 0.1.0
source:
  kind: synthetic_demo
  file: seat-motion-virtual-matrix.yaml
  designed_on: 2026-07-23
scope: driver_and_front_passenger_position_motors
hardware_execution_allowed: false
synthetic: true
bit_numbering: lsb0
byte_order: intel_little_endian
limitations:
  - All frame IDs, signal layouts, timing and feedback behavior in this file are fictional.
  - Values are normalized positions, not physical millimeters or degrees.
  - No vehicle-state, occupant, anti-pinch, current-sensing or collision interlock is implemented.
  - These frames must never be sent to a vehicle, bench ECU or HIL network.
messages:
  - name: Driver_Seat_Motion_Command_550
    frame_id: 0x550
    role: synthetic_command
    minimum_payload_bytes: 8
    hardware_send_allowed: false
    signals: &motion_command_signals
      - {name: Longitudinal_Target_Pct, description: "Fore-aft absolute target", start_bit: 0, bit_length: 7}
      - {name: Cushion_Tilt_Target_Pct, description: "Cushion pitch absolute target", start_bit: 7, bit_length: 7}
      - {name: Backrest_Recline_Target_Pct, description: "Backrest recline absolute target", start_bit: 14, bit_length: 7}
      - {name: Legrest_Height_Target_Pct, description: "Leg-rest lift absolute target", start_bit: 21, bit_length: 7}
      - {name: Legrest_Extension_Target_Pct, description: "Leg-rest extension absolute target", start_bit: 28, bit_length: 7}
      - {name: Motion_Enable_Mask, description: "One enable bit per position axis", start_bit: 35, bit_length: 5}
      - {name: Command_Counter, description: "Synthetic per-plan command sequence", start_bit: 40, bit_length: 4}
      - {name: Command_Mode, description: "0=no request, 1=absolute position", start_bit: 44, bit_length: 2}
      - {name: Command_Checksum, description: "Synthetic additive checksum", start_bit: 48, bit_length: 8}
  - name: Passenger_Seat_Motion_Command_551
    frame_id: 0x551
    role: synthetic_command
    minimum_payload_bytes: 8
    hardware_send_allowed: false
    signals: *motion_command_signals
  - name: Driver_Seat_Motion_Status_558
    frame_id: 0x558
    role: synthetic_feedback
    minimum_payload_bytes: 8
    signals: &motion_status_signals
      - {name: Longitudinal_Actual_Pct, description: "Fore-aft measured position", start_bit: 0, bit_length: 7}
      - {name: Cushion_Tilt_Actual_Pct, description: "Cushion pitch measured position", start_bit: 7, bit_length: 7}
      - {name: Backrest_Recline_Actual_Pct, description: "Backrest recline measured position", start_bit: 14, bit_length: 7}
      - {name: Legrest_Height_Actual_Pct, description: "Leg-rest lift measured position", start_bit: 21, bit_length: 7}
      - {name: Legrest_Extension_Actual_Pct, description: "Leg-rest extension measured position", start_bit: 28, bit_length: 7}
      - {name: Moving_Mask, description: "One moving-state bit per position axis", start_bit: 35, bit_length: 5}
      - {name: Fault_Mask, description: "One synthetic motor-fault bit per position axis", start_bit: 40, bit_length: 5}
      - {name: Position_Valid_Mask, description: "One valid-feedback bit per position axis", start_bit: 45, bit_length: 5}
  - name: Passenger_Seat_Motion_Status_559
    frame_id: 0x559
    role: synthetic_feedback
    minimum_payload_bytes: 8
    signals: *motion_status_signals