Enum BrakeMode 

pub enum BrakeMode {
    Coast,
    Brake,
    Hold,
}

The brake mode determines how motors behave when stopped.

Each mode offers different trade-offs between stopping speed, position accuracy, and power consumption:

• Coast: Lowest power consumption, but least precise stopping
• Brake: Good balance between speed and precision
• Hold: Most precise, but highest power consumption

Examples

use ev3_drivebase::BrakeMode;

// For general movement where exact stopping position doesn't matter
let casual = BrakeMode::Coast;

// For controlled stopping without position holding
let controlled = BrakeMode::Brake;

// For precise positioning tasks
let precise = BrakeMode::Hold;

Variants

Coast

The motor will freely coast to a stop.

No active braking is applied. The motor will gradually slow down due to friction. This mode uses the least power but provides the least control over stopping position.

Brake

The motor will actively brake, resisting motion until it comes to a stop.

Slows the motor faster than Coast but does not hold the final position. After stopping, the motor can be moved freely by external forces.

Hold

The motor will actively hold its current position once stopped.

Provides the most precise stopping and maintains position against external forces. This mode consumes more power as it continuously applies holding torque.

Trait Implementations

impl AsRef<str> for BrakeMode

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for BrakeMode

fn clone(&self) -> BrakeMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BrakeMode

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

Formats the value using the given formatter.

impl From<&str> for BrakeMode

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<String> for BrakeMode

fn from(value: String) -> Self

Converts to this type from the input type.

impl Ord for BrakeMode

fn cmp(&self, other: &BrakeMode) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for BrakeMode

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for BrakeMode

fn partial_cmp(&self, other: &BrakeMode) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for BrakeMode

impl Eq for BrakeMode

impl StructuralPartialEq for BrakeMode