# ism330is-rs

**Repository Path**: mirrors_STMicroelectronics/ism330is-rs

## Basic Information

- **Project Name**: ism330is-rs
- **Description**: ism330is platform independent driver based on Rust programming language
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-13
- **Last Updated**: 2026-02-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ism330is-rs
[![Crates.io][crates-badge]][crates-url]
[![BSD 3-Clause licensed][bsd-badge]][bsd-url]

[crates-badge]: https://img.shields.io/crates/v/ism330is-rs
[crates-url]: https://crates.io/crates/ism330is-rs
[bsd-badge]: https://img.shields.io/crates/l/ism330is-rs
[bsd-url]: https://opensource.org/licenses/BSD-3-Clause

Provides a platform-agnostic, no_std-compatible driver for the ST ISM330IS IMU, supporting both I2C and SPI communication interfaces.

## Sensor Overview

The ISM330IS is a 6-axis IMU (inertial measurement unit) system-in-package
featuring a 3-axis digital accelerometer and a 3-axis digital gyroscope,
boosting
performance at 0.59 mA in high-performance mode and enabling always-on lowpower
features for optimal motion results in industrial and IoT solutions.
The ISM330IS has a full-scale acceleration range of ±2/±4/±8/±16 g and an
angular rate range of ±125/±250/±500/±1000/±2000 dps.

The ISM330IS features programmable interrupts and an on-chip sensor hub, which
includes up to six sensors: the internal accelerometer & gyroscope and four
external sensors.

The ISM330IS embeds a new ST category of processing, ISPU (intelligent sensor
processing unit) to support real-time applications that rely on sensor data.
The ISPU is an ultralow-power, high-performance programmable core, which can execute
signal processing and AI algorithms in the edge. The main benefits of the ISPU
are C programming and an enhanced ecosystem with libraries and 3rd party tools/IDE.

Its optimized ultralow-power hardware circuitry for real-time execution of the
algorithms is a state-of-the-art
feature for any wireless sensor node from small equipment or accessories to
enterprise solutions for Industry 5.0
(for example, anomaly detection, asset tracking, factory automation, and so
forth).

The part number ISM330ISN, moreover, can execute the machine learning libraries
generated by ST's NanoEdge
AI Studio, a powerful tool that allows anyone to easily create machine learning
libraries with on-sensor learning.

The ISM330IS and ISM330ISN are available in a plastic, land grid array (LGA)
package.

For more info, please visit the device page at [https://www.st.com/en/mems-and-sensors/ism330is.html](https://www.st.com/en/mems-and-sensors/ism330is.html)

## Installation

Add the driver to your `Cargo.toml` dependencies:

```toml
[dependencies]
ism330is-rs = "2.0.0"
```

Or, add it directly from the terminal:

```sh
cargo add ism330is-rs
```

## Usage

By default, the create exposes the **asynchronous** API, and it could be included using:
```rust
use ism330is_rs::asynchronous as ism330is;
use ism330is::*;
use ism330is::prelude::*;
```

### Blocking API (optional feature)

To use the **blocking** API instead of the asynchronous one, disable default features and enable the `blocking` feature in your Cargo.toml
```toml
[dependencies]
ism330is-rs = { version = "2.0.0", default-features = false, features = ["blocking"] }
```
or from the terminal:
```sh
cargo add ism330is-rs --no-default-features --features blocking
```

Then import the blocking API:
```rust
use ism330is_rs::blocking as ism330is;
use ism330is::*;
use ism330is::prelude::*;
```

### Create an instance

Create an instance of the driver with the `new_<bus>` associated function, by passing an I2C (`embedded_hal::i2c::I2c`) instance and I2C address, or an SPI (`embedded_hal::spi::SpiDevice`) instance, along with a timing peripheral.

An example with I2C:

```rust
let mut sensor = Ism330is::new_i2c(i2c, I2CAddress::I2cAddL, delay);
```

### Check "Who Am I" Register

This step ensures correct communication with the sensor. It returns a unique ID to verify the sensor's identity.

```rust
let whoami = sensor.device_id_get().unwrap();
if whoami != ID {
    panic!("Invalid sensor ID");
}
```

### Configure

See details in specific examples; the following are common api calls:

```rust
// Restore default configuration
sensor.software_reset().unwrap();

// Disable I3C interface (if needed)
// sensor.i3c_disable_set(ISM330IS_I3C_DISABLE).unwrap();

// Enable Block Data Update (if needed)
sensor.block_data_update_set(true).unwrap();

// Set Output Data Rate for accelerometer and gyroscope
sensor.xl_data_rate_set(XlDataRate::_12_5hzHp).unwrap();
sensor.gy_data_rate_set(GyDataRate::_12_5hzHp).unwrap();

// Set full scale for accelerometer and gyroscope
sensor.xl_full_scale_set(XlFullScale::_2g).unwrap();
sensor.gy_full_scale_set(GyFullScale::_2000dps).unwrap();
```

## License

Distributed under the BSD-3 Clause license.

More Information: [http://www.st.com](http://st.com/MEMS).

**Copyright (C) 2025 STMicroelectronics**