[driver] Add BMP581 pressure sensor driver and example

Author: joelsa

README.md

@@ -858,97 +858,98 @@ your specific needs.
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-bmi088">BMI088</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-bmp085">BMP085</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-bmp581">BMP581</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-bno055">BNO055</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-cat24aa">CAT24AA</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-cycle_counter">CYCLE-COUNTER</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-drv832x_spi">DRV832X</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ds1302">DS1302</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-ds1631">DS1631</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-ds1631">DS1631</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ds18b20">DS18B20</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-dw3110">DW3110</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ea_dog">EA-DOG</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-encoder_input">Encoder Input</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-encoder_input-bitbang">Encoder Input BitBang</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-encoder_output-bitbang">Encoder Output BitBang</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-encoder_output-bitbang">Encoder Output BitBang</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ft245">FT245</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ft6x06">FT6x06</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-gpio_sampler">Gpio Sampler</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-hclax">HCLAx</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-hd44780">HD44780</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-hmc58x">HMC58x</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-hmc58x">HMC58x</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-hmc6343">HMC6343</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-hx711">HX711</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-i2c-eeprom">I2C-EEPROM</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ili9341">ILI9341</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-is31fl3733">IS31FL3733</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-itg3200">ITG3200</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-itg3200">ITG3200</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ixm42xxx">IXM42XXX</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-l3gd20">L3GD20</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-lan8720a">LAN8720A</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-lawicel">LAWICEL</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-lis302dl">LIS302DL</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-lis3dsh">LIS3DSH</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-lis3dsh">LIS3DSH</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-lis3mdl">LIS3MDL</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-lm75">LM75</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-lp503x">LP503x</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-lsm303a">LSM303A</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-lsm6ds33">LSM6DS33</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-lsm6dso">LSM6DSO</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-lsm6dso">LSM6DSO</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ltc2984">LTC2984</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-max31855">MAX31855</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-max31865">MAX31865</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-max6966">MAX6966</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-max7219">MAX7219</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-mcp23x17">MCP23x17</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-mcp23x17">MCP23x17</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-mcp2515">MCP2515</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-mcp3008">MCP3008</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-mcp7941x">MCP7941x</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-mcp990x">MCP990X</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-mmc5603">MMC5603</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-ms5611">MS5611</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-ms5611">MS5611</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ms5837">MS5837</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-nokia5110">NOKIA5110</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-nrf24">NRF24</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-parallel_tft_display">TFT-DISPLAY</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-pat9125el">PAT9125EL</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-pca8574">PCA8574</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-pca8574">PCA8574</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-pca9535">PCA9535</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-pca9548a">PCA9548A</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-pca9685">PCA9685</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-qmc5883l">QMC5883L</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-sh1106">SH1106</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-siemens_s65">SIEMENS-S65</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-siemens_s65">SIEMENS-S65</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-siemens_s75">SIEMENS-S75</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-sk6812">SK6812</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-sk9822">SK9822</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ssd1306">SSD1306</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-st7586s">ST7586S</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-st7789">ST7789</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-st7789">ST7789</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-stts22h">STTS22H</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-stusb4500">STUSB4500</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-sx1276">SX1276</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-sx128x">SX128X</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-tcs3414">TCS3414</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-tcs3472">TCS3472</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-tcs3472">TCS3472</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-tlc594x">TLC594x</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-tmp102">TMP102</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-tmp12x">TMP12x</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-tmp175">TMP175</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-touch2046">TOUCH2046</a></td>
-<td align="center"><a href="https://modm.io/reference/module/modm-driver-vl53l0">VL53L0</a></td>
 </tr><tr>
+<td align="center"><a href="https://modm.io/reference/module/modm-driver-vl53l0">VL53L0</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-vl6180">VL6180</a></td>
 <td align="center"><a href="https://modm.io/reference/module/modm-driver-ws2812">WS2812</a></td>
 </tr>

examples/nucleo_h723zg/bmp581/main.cpp

@@ -0,0 +1,186 @@
+/*
+ * Copyright (c) 2026, Joel Schulz-Andres
+ *
+ * This file is part of the modm project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+// ----------------------------------------------------------------------------
+
+#include <atomic>
+#include <modm/board.hpp>
+#include <modm/driver/pressure/bmp581.hpp>
+
+using namespace Board;
+
+// I2C2 Bus Configuration
+using I2c = I2cMaster2;
+using Scl = GpioB10;
+using Sda = GpioB11;
+
+// Interrupt Pin
+using BaroInt = GpioA4;
+
+// BMP581 Driver Setup
+using Transport = modm::Bmp581I2cTransport<I2c>;
+using Baro = modm::Bmp581<Transport>;
+
+// BMP581 I2C address (0x46 with SDO to GND, 0x47 with SDO to VDDIO)
+constexpr uint8_t BaroAddress = 0x47;
+Baro baro{BaroAddress};
+std::atomic<bool> dataReady{false};
+
+bool
+initializeBaro()
+{
+	// Initialize the sensor
+	if (!baro.initialize())
+	{
+		MODM_LOG_ERROR << "BMP581 initialization failed!\n";
+		return false;
+	}
+
+	// Configure oversampling: 4x for both pressure and temperature
+	if (!baro.setOversampling(Baro::Osr::X4, Baro::Osr::X4, true))
+	{
+		MODM_LOG_ERROR << "Failed to set oversampling!\n";
+		return false;
+	}
+
+	// Configure output data rate: 50 Hz
+	if (!baro.setOdr(Baro::Odr::Hz50))
+	{
+		MODM_LOG_ERROR << "Failed to set ODR!\n";
+		return false;
+	}
+
+	// Configure IIR filter: coefficient 3 for both
+	if (!baro.setIirFilter(Baro::IirFilter::Coef3, Baro::IirFilter::Coef3))
+	{
+		MODM_LOG_ERROR << "Failed to set IIR filter!\n";
+		return false;
+	}
+
+	// Configure interrupt: active high, push-pull, pulsed mode
+	const auto intConfig = Baro::IntConfig::Enable | Baro::IntConfig::Polarity;  // Active high
+	if (!baro.setIntConfig(intConfig))
+	{
+		MODM_LOG_ERROR << "Failed to set interrupt config!\n";
+		return false;
+	}
+
+	// Enable data ready interrupt
+	if (!baro.setIntSource(Baro::IntSource::DataReadyEnable))
+	{
+		MODM_LOG_ERROR << "Failed to set interrupt source!\n";
+		return false;
+	}
+
+	/*
+	 * FIFO usage example:
+	 *
+	 * baro.setFifoSelect(Baro::FifoFrameSelect::PressureAndTemperature,
+	 *                    Baro::FifoDecimation::None);
+	 * baro.setFifoThreshold(8);
+	 * baro.setIntSource(Baro::IntSource::FifoThresholdEnable);
+	 * baro.setFifoEnabled(true);
+	 *
+	 * // On interrupt/main loop:
+	 * // const auto count = baro.getFifoCount();
+	 * // read up to `count` entries with readFifoFrames(...)
+	 */
+
+	// Set power mode to normal (continuous measurement)
+	if (!baro.setPowerMode(Baro::PowerMode::Normal))
+	{
+		MODM_LOG_ERROR << "Failed to set power mode!\n";
+		return false;
+	}
+
+	return true;
+}
+
+int
+main()
+{
+	Board::initialize();
+	Leds::setOutput();
+
+	// Initialize I2C2
+	I2c::connect<Scl::Scl, Sda::Sda>(I2c::PullUps::Internal);
+	I2c::initialize<Board::SystemClock, 400_kHz>();
+
+	MODM_LOG_INFO << "BMP581 Barometric Pressure Sensor Example\n";
+	MODM_LOG_INFO << "=========================================\n\n";
+	// Configure interrupt pin
+	BaroInt::setInput(BaroInt::InputType::PullDown);
+
+	// Initialize sensor with retries
+	while (!initializeBaro())
+	{
+		LedRed::toggle();
+		MODM_LOG_ERROR << "Retrying initialization...\n";
+		modm::delay(250ms);
+	}
+
+	MODM_LOG_INFO << "BMP581 initialized successfully!\n\n";
+
+	// Read chip ID for verification
+	if (const auto chipId = baro.readChipId(); chipId)
+	{
+		MODM_LOG_INFO.printf("Chip ID: 0x%02X (expected 0x50)\n\n", *chipId);
+	}
+
+	MODM_LOG_INFO << "Starting continuous measurement (DRDY EXTI)...\n\n";
+
+	Exti::connect<BaroInt>(Exti::Trigger::RisingEdge, [](auto) {
+		dataReady = true;
+		LedYellow::toggle();
+	});
+
+	modm::bmp581::Data data;
+	uint32_t sampleCount = 0;
+	uint32_t readErrorCount = 0;
+	while (true)
+	{
+		if (!dataReady) { continue; }
+		dataReady = false;
+
+		if (baro.readData(data))
+		{
+			const float temperature = data.getTemperature();
+			const float pressure = data.getPressure();
+			const float pressureHpa = data.getPressureHpa();
+
+			// Calculate approximate altitude (simplified barometric formula)
+			// Using standard sea level pressure of 1013.25 hPa
+			constexpr float seaLevelPressure = 1013.25f;
+			const float altitude =
+				44330.0f * (1.0f - powf(pressureHpa / seaLevelPressure, 0.1903f));
+
+			sampleCount++;
+
+			// Print every 25th sample (~2 Hz at 50Hz sampling)
+			if (sampleCount % 25 == 0)
+			{
+				MODM_LOG_INFO.printf("Sample #%lu\n", sampleCount);
+				MODM_LOG_INFO.printf("  Temperature: %7.3f C\n", temperature);
+				MODM_LOG_INFO.printf("  Pressure:    %9.2f Pa (%7.2f hPa)\n", pressure,
+									 pressureHpa);
+				MODM_LOG_INFO.printf("  Altitude:    %7.1f m (approx)\n\n", altitude);
+			}
+
+			LedGreen::toggle();
+			readErrorCount = 0;
+		} else
+		{
+			readErrorCount++;
+			if (readErrorCount % 50 == 0) { MODM_LOG_ERROR << "Failed to read sensor data!\n"; }
+			LedRed::set();
+		}
+	}
+
+	return 0;
+}

examples/nucleo_h723zg/bmp581/project.xml

@@ -0,0 +1,12 @@
+<library>
+  <extends>modm:nucleo-h723zg</extends>
+  <options>
+   <option name="modm:build:build.path">../../../build/nucleo_h723zg/bmp581</option>
+  </options>
+  <modules>
+    <module>modm:build:scons</module>
+    <module>modm:platform:exti</module>
+    <module>modm:platform:i2c:2</module>
+    <module>modm:driver:bmp581</module>
+  </modules>
+</library>