Enum RotationStatus 

pub enum RotationStatus {
    Inactive,
    Start,
    Active,
    Stop,
}

Where a thumbwheelEvent sits in the life cycle of one roll (thumbwheelEvent byte 4).

This is what separates a deliberate tap from the tap the wheel’s touch sensor flags for the finger that rolled it: every report from Start through Stop belongs to a roll, so a tap bit inside that span is an artifact of the same contact. Only RotationStatus::Inactive means the wheel is at rest and a tap is the user’s own.

RotationStatus::Stop is why this field is read rather than inferred from the report’s own rotation. Observed on an MX Master 4 (Bolt) with examples/thumbwheel_trace, one nudge of the wheel:

rot=  -1  byte4=0x02  byte5=0x02  touch=true   → Active
rot=   0  byte4=0x03  byte5=0x00  touch=false  → Stop

The release reports no rotation at all, so rotation alone cannot tell it from a tap on a settled wheel — and on a wheel that does support single_tap that release is exactly where the artifact lands.

Variants

Inactive

No rotation — the wheel is at rest.

Start

The first rotation report of a roll.

Active

A subsequent rotation report.

Stop

The roll ended: released, no touch.

Implementations

impl RotationStatus

pub fn is_rolling(self) -> bool

Whether this report belongs to a roll — including its Stop, which carries no rotation of its own but is still the roll’s own contact.

Trait Implementations

impl Clone for RotationStatus

fn clone(&self) -> RotationStatus

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for RotationStatus

impl Debug for RotationStatus

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for RotationStatus

impl PartialEq for RotationStatus

fn eq(&self, other: &RotationStatus) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RotationStatus