Soldered BMM350 Geomagnetic Sensor MicroPython Library


Soldered BMM350 Geomagnetic Sensor breakout (opens in a new tab)

Breakout board for the Bosch BMM350 geomagnetic sensor, measuring magnetic field on all three axes with a resolution down to 20 nT, output data rates up to 400 Hz and a data-ready interrupt. It supports normal and forced power modes for balancing measurement speed against power consumption. The board communicates over I2C only and is part of the Qwiic ecosystem (opens in a new tab).

Quick start

from bmm350 import BMM350, BMM350_OK
import time

sensor = BMM350()  # Or BMM350(address=BMM350_I2C_ADSEL_SET_HIGH) if ADSEL is pulled high

while True:
    if sensor.get_sensor_data() == BMM350_OK:
        print(sensor.data.mag_x, sensor.data.mag_y, sensor.data.mag_z, sensor.data.temperature)
    time.sleep(1)

Have a look at the scripts in Examples/ for basic readings, the sensor's physical interrupt pin, and the built-in self-test.

How to install

Use mim (opens in a new tab).

After installing the mpremote package (opens in a new tab), install the library on your board using the following command:

  mpremote mip install github:SolderedElectronics/Soldered-BMM350-MicroPython-Library

Or, if you're running a Windows OS:

  python -m mpremote mip install github:SolderedElectronics/Soldered-BMM350-MicroPython-Library

Repository Contents

bmm350.py - MicroPython driver class, I2C only
package.json - mip install manifest
/Examples - examples for basic readings, the physical interrupt pin, and the self-test

Examples

Example	What it does
`bmm350-basicReadings.py`	Reads magnetometer and temperature data in a loop in normal power mode, the mode most applications want
`bmm350-dataReadyInterrupt.py`	Uses the sensor's physical interrupt pin to know when a new reading is ready, instead of polling the interrupt status register
`bmm350-selfTest.py`	Runs the sensor's built-in self-test and reports pass/fail per axis

Hardware design

You can find hardware design for this board in Soldered BMM350 Geomagnetic Sensor breakout hardware repository.

Documentation

Access library documentation here (opens in a new tab).

About Soldered

At Soldered, we design and manufacture a wide selection of electronic products to help you turn your ideas into acts and bring you one step closer to your final project. Our products are intented for makers and crafted in-house by our experienced team in Osijek, Croatia. We believe that sharing is a crucial element for improvement and innovation, and we work hard to stay connected with all our makers regardless of their skill or experience level. Therefore, all our products are open-source. Finally, we always have your back. If you face any problem concerning either your shopping experience or your electronics project, our team will help you deal with it, offering efficient customer service and cost-free technical support anytime. Some of those might be useful for you:

Original source

This library is a register-level port of the BMM350_SensorAPI (opens in a new tab) by Bosch Sensortec, cross-checked against the Soldered Arduino (opens in a new tab) and ESP-IDF (opens in a new tab) BMM350 libraries. Thank you, Bosch Sensortec.

Open-source license

Soldered invests vast amounts of time into hardware & software for these products, which are all open-source. Please support future development by buying one of our products.

Check license details in the LICENSE file. Long story short, use these open-source files for any purpose you want to, as long as you apply the same open-source licence to it and disclose the original source. No warranty - all designs in this repository are distributed in the hope that they will be useful, but without any warranty. They are provided "AS IS", therefore without warranty of any kind, either expressed or implied. The entire quality and performance of what you do with the contents of this repository are your responsibility. In no event, Soldered (TAVU) will be liable for your damages, losses, including any general, special, incidental or consequential damage arising out of the use or inability to use the contents of this repository.

Have fun!

And thank you from your fellow makers at Soldered Electronics.