G2-Games / mma8x5x-rs

Platform-agnostic Rust driver for the MMA8x5x accelerometers. Compatible with MMA8451, MMA8452, MMA8453, MMA8652 and MMA8653.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Rust MMA8x5x Tri-Axis Accelerometers Driver

crates.io Docs Build Status Coverage Status

This is a platform agnostic Rust driver for the MMA8451Q, MMA8452Q, MMA8453Q, MMA8652FC and MMA8653FC tri-axis accelerators using the embedded-hal traits.

This driver allows you to:

  • Change mode to active/standby. See: into_active().
  • Read raw unscaled measurement. See: read_unscaled().
  • Read measurement. See: read().
  • Read data status. See: data_status().
  • Read system operating mode. See: system_mode().
  • Set G scale. See: set_scale().
  • Set data rate. See set_data_rate().
  • Set wake power mode. See set_wake_power_mode().
  • Set sleep power mode. See set_sleep_power_mode().
  • Set read mode. See: set_read_mode().
  • Set offset correction. See: set_offset_correction().
  • Read the device ID. See: device_id().
  • Reset device. See: reset().
  • Enable/disable self-test mode. See: enable_self_test().
  • Auto-sleep/wake:
    • Enable/disable auto-sleep/wake. See: enable_auto_sleep().
    • Set auto-sleep data rate. See: set_auto_sleep_data_rate().
    • Set auto-sleep count. See: set_auto_sleep_count().
  • Portrait/Landscape detection:
    • Enable/disable portrait/landscape detection. See: enable_portrait_landscape_detection().
    • Set debounce counter mode. See: set_debounce_counter_mode().
    • Set debounce counter. See: set_debounce_counter().
    • Read portrait/landscape status. See: portrait_landscape_status().
  • Interrupts:
    • Enable/disable interrupts. See: set_enabled_interrupts().
    • Set interrupt pin routes. See: set_interrupt_pin_routes().
    • Set interrupt pin polarity. See: set_interrupt_pin_polarity().
    • Set interrupt pin configuration. See: set_interrupt_pin_configuration().
    • Set interrupts that wake the device from sleep. See: set_wake_interrupts().
    • Read interrupt status. See: interrupt_status().

The devices

The devices are intelligent, low-power, three-axis, capacitive micromachined accelerometers with 10/12/14 bits of resolution. The accelerometers are packed with embedded functions with flexible user-programmable options, configurable to interrupt pins. Embedded interrupt functions enable overall power savings, by relieving the host processor from continuously polling data. There is access to either low-pass or high-pass filtered data, which minimizes the data analysis required for jolt detection and faster transitions. The device can be configured to generate inertial wake-up interrupt signals from any combination of the configurable embedded functions, enabling the devices to monitor inertial events while remaining in a low-power mode during periods of inactivity.

Feature comparison

Feature MMA8451 MMA8452 MMA8453 MMA8652 MMA8653
Resolution 14-bit 12-bit 10-bit 12-bit 10-bit
Sensitivity in 2g mode (counts/g) 4096 1024 256 1024 256
32-level FIFO Yes - - Yes -
Low power mode Yes Yes Yes Yes Yes
Auto-WAKE Yes Yes Yes Yes Yes
Auto-SLEEP Yes Yes Yes Yes Yes
High-pass filter Yes Yes Yes Yes -
Low-pass filter Yes Yes Yes Yes Yes
Transient detection with high-pass filter Yes Yes Yes Yes -
Fixed orientation detection Yes Yes Yes - Yes
Programmable orientation detection Yes - - Yes -
Data-ready interrupt Yes Yes Yes Yes Yes
Single-tap interrupt Yes Yes Yes Yes -
Double-tap interrupt Yes Yes Yes Yes -
Directional-tap interrupt Yes Yes Yes Yes -
Freefall interrupt Yes Yes Yes Yes Yes
Motion interrupt with direction Yes Yes Yes Yes -
Selectable address pin Yes Yes Yes - -

(Unavailable features are marked with "-" as this is more easily readable than Yes/No)

Documentation:

Usage

To use this driver, import this crate and an embedded_hal implementation, then instantiate the appropriate device.

Most of the settings can only be changed while the device is in standby mode. Then the mode can be changed to active and acceleration measurements read.

Please find additional examples using hardware in this repository: driver-examples

use linux_embedded_hal::I2cdev;
use mma8x5x::Mma8x5x;

fn main() {
    let dev = I2cdev::new("/dev/i2c-1").unwrap();
    let sensor = Mma8x5x::new_mma8653(dev);
    let mut sensor = sensor.into_active().ok().unwrap();
    loop {
        let accel = sensor.read().unwrap();
        println!("Acceleration: {:?}", accel);
    }
}

Support

For questions, issues, feature requests, and other changes, please file an issue in the github project.

License

Licensed under either of:

at your option.

Contributing

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

About

Platform-agnostic Rust driver for the MMA8x5x accelerometers. Compatible with MMA8451, MMA8452, MMA8453, MMA8652 and MMA8653.

License:Apache License 2.0


Languages

Language:Rust 100.0%