Skip to main content

Module haptic

Module haptic 

Source
Expand description

Q07 Mode 0x0106: Haptic mechanical force, displacement, contact geometry, mechanoreceptor models, and separate actuation-command authority evaluation (Schema 207).

Strictly separates passive QAC storage from hardware actuation: read_haptic_qac validates structural and metadata contracts without acting as an actuation gate, while evaluate_actuator_command_at enforces role, digest, and exact i128 expiry [< expiry].

Structs§

HapticChunkView
Zero-heap borrowed view over verified mode 0x0106 haptic sample records.
HapticContactSpec
Full Schema 207 haptic contact & authorization specification.
HapticDocumentView
Decoded passive Q07 haptic view. Does NOT authorize hardware actuation.
HapticRecord
Canonical 64-byte Q07 mode 0x0106 haptic sample record.

Enums§

ForceActionConvention
Explicit action-reaction sign convention between contacting body and haptic device.
HapticRole
Explicit role of a haptic entry recorded in Schema 207 key 1 (role).

Constants§

HAPTIC_RECORD_STRIDE
Frozen wire stride in bytes for mode 0x0106 haptic mechanical samples.
HAPTIC_VALID_ALL
Bitmask covering all defined validity bits (0..=3).
HAPTIC_VALID_CARRIER_HZ
Bitmask for HapticRecord::validity_bits: vibrotactile carrier frequency (44..48).
HAPTIC_VALID_DISPLACEMENT
Bitmask for HapticRecord::validity_bits: surface displacement (32..44).
HAPTIC_VALID_FORCE
Bitmask for HapticRecord::validity_bits: force vector (16..28).
HAPTIC_VALID_INDENTATION
Bitmask for HapticRecord::validity_bits: normal indentation (28..32).

Functions§

contact_pressure_pa
Derives average normal contact pressure P = F_n / A (Pa), requiring strictly positive area.
evaluate_actuator_command_at
Separate explicit host command gate required before dispatching any actuator frame to hardware.
hooke_spring_force_n
Hooke spring oracle F = k * x + F0 (N) along contact normal or tangential DOF.
read_haptic_qac
Passive reader validating structure and Schema 207 semantics without gating actuation.
rotate_force_to_parent
Actively rotates a local haptic force vector into its parent frame via Hamilton quaternion q.
torque_about_origin_n_m
Computes torque vector tau = r x F (N*m) about contact frame origin.
write_haptic_qac
Writes a Q07 mode 0x0106 haptic QAC v1 container.