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§
- Haptic
Chunk View - Zero-heap borrowed view over verified
mode 0x0106haptic sample records. - Haptic
Contact Spec - Full
Schema 207haptic contact & authorization specification. - Haptic
Document View - Decoded passive Q07 haptic view. Does NOT authorize hardware actuation.
- Haptic
Record - Canonical 64-byte Q07
mode 0x0106haptic sample record.
Enums§
- Force
Action Convention - Explicit action-reaction sign convention between contacting body and haptic device.
- Haptic
Role - Explicit role of a haptic entry recorded in
Schema 207key 1 (role).
Constants§
- HAPTIC_
RECORD_ STRIDE - Frozen wire stride in bytes for
mode 0x0106haptic 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 0x0106haptic QAC v1 container.