0.5.0 MC5611

Author: RobTillaart

libraries/MS5611/CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## [0.5.0] - 2025-09-26
+- fix #44, getAltitude()
+- sync MS5611_SPI
+- add **getAltitudeFeet(float airPressure)**
+- moved code to .cpp
+- update keywords.txt
+- minor edits
+
+----
+
 ## [0.4.2] - 2025-08-31
 - fix #42, add reference to STM32 version of library
 - add **float getAltitude(float airPressure = 1013.25)**

libraries/MS5611/MS5611.cpp

@@ -2,8 +2,8 @@
 //    FILE: MS5611.cpp
 //  AUTHOR: Rob Tillaart
 //          Erni - testing/fixes
-// VERSION: 0.4.2
-// PURPOSE: Arduino library for MS5611 temperature and pressure sensor
+// VERSION: 0.5.0
+// PURPOSE: Arduino library for MS5611 (I2C) temperature and pressure sensor
 //     URL: https://github.com/RobTillaart/MS5611
 
 
@@ -64,7 +64,7 @@ bool MS5611::reset(uint8_t mathMode)
   uint32_t start = micros();
 
   //  while loop prevents blocking RTOS
-  while (micros() - start < 2800)
+  while (micros() - start < 3000)  //  increased as first ROM values were missed.
   {
     yield();
     delayMicroseconds(10);
@@ -163,6 +163,12 @@ void MS5611::setOversampling(osr_t samplingRate)
 }
 
 
+osr_t MS5611::getOversampling() const
+{
+  return (osr_t) _samplingRate;
+}
+
+
 float MS5611::getTemperature() const
 {
   if (_temperatureOffset == 0) return _temperature * 0.01;
@@ -185,18 +191,79 @@ float MS5611::getPressurePascal() const
   return _pressure + _pressureOffset * 100.0;
 }
 
+void MS5611::setPressureOffset(float offset)
+{
+  _pressureOffset = offset;
+}
+
+
+float MS5611::getPressureOffset()
+{
+  return _pressureOffset;
+}
+
+
+void MS5611::setTemperatureOffset(float offset)
+{
+  _temperatureOffset = offset;
+}
+
+
+float MS5611::getTemperatureOffset()
+{
+  return _temperatureOffset;
+}
+
 
 //  (from MS5837)
 //  https://www.mide.com/air-pressure-at-altitude-calculator
 //  https://community.bosch-sensortec.com/t5/Question-and-answers/How-to-calculate-the-altitude-from-the-pressure-sensor-data/qaq-p/5702 (stale link).
 //  https://en.wikipedia.org/wiki/Pressure_altitude
 float MS5611::getAltitude(float airPressure)
 {
-  float ratio = _pressure / airPressure;
+  //  _pressure is in Pascal (#44) and airPressure in mBar.
+  float ratio = _pressure * 0.01 / airPressure;
   return 44307.694 * (1 - pow(ratio, 0.190284));
 }
 
 
+float MS5611::getAltitudeFeet(float airPressure)
+{
+  float ratio = _pressure * 0.01 / airPressure;
+  return 145366.45 * (1 - pow(ratio, 0.190284));
+}
+
+
+int MS5611::getLastResult() const
+{
+  return _result;
+}
+
+
+uint32_t MS5611::lastRead() const
+{
+  return _lastRead;
+}
+
+
+uint32_t MS5611::getDeviceID() const
+{
+  return _deviceID;
+}
+
+
+void MS5611::setCompensation(bool flag)
+{
+  _compensation = flag;
+}
+
+
+bool MS5611::getCompensation()
+{
+  return _compensation;
+}
+
+
 //       EXPERIMENTAL
 uint16_t MS5611::getManufacturer()
 {
@@ -215,6 +282,7 @@ uint16_t MS5611::getProm(uint8_t index)
   return readProm(index);
 }
 
+//       DEVELOP
 uint16_t MS5611::getCRC()
 {
   return readProm(7) & 0x0F;
@@ -227,16 +295,16 @@ uint16_t MS5611::getCRC()
 //
 void MS5611::convert(const uint8_t addr, uint8_t bits)
 {
-  //  values from page 3 datasheet - MAX column (rounded up)
-  uint16_t del[5] = {600, 1200, 2300, 4600, 9100};
-
   uint8_t index = bits;
   if (index < 8) index = 8;
   else if (index > 12) index = 12;
   index -= 8;
   uint8_t offset = index * 2;
   command(addr + offset);
 
+  //  values from page 3 datasheet - MAX column (rounded up)
+  uint16_t del[5] = {600, 1200, 2300, 4600, 9100};
+
   uint16_t waitTime = del[index];
   uint32_t start = micros();
   //  while loop prevents blocking RTOS
@@ -317,12 +385,12 @@ void MS5611::initConstants(uint8_t mathMode)
   C[5] = 256;             //  Tref     = C[5] * 2^8     |    * 2^8
   C[6] = 1.1920928955E-7; //  TEMPSENS = C[6] / 2^23    |    / 2^23
 
-  if (mathMode == 1)  //  Appnote version for pressure.
+  if (mathMode == 1)      //  Appnote version for pressure.
   {
-    C[1] = 65536L;          //  SENSt1
-    C[2] = 131072L;         //  OFFt1
-    C[3] = 7.8125E-3;       //  TCS
-    C[4] = 1.5625e-2;       //  TCO
+    C[1] = 65536L;        //  SENSt1
+    C[2] = 131072L;       //  OFFt1
+    C[3] = 7.8125E-3;     //  TCS
+    C[4] = 1.5625e-2;     //  TCO
   }
 }
 
@@ -334,7 +402,7 @@ void MS5611::initConstants(uint8_t mathMode)
 MS5607::MS5607(uint8_t deviceAddress, TwoWire *wire)
       : MS5611(deviceAddress, wire)
 {
-};
+}
 
 
 bool MS5607::begin()
@@ -343,7 +411,8 @@ bool MS5607::begin()
   if (! isConnected()) return false;
 
   return reset(1);  //  MS5607 has mathMode 1, see datasheet + initConstants.
-};
+}
+
 
 //  -- END OF FILE --
 

libraries/MS5611/MS5611.h

@@ -3,8 +3,8 @@
 //    FILE: MS5611.h
 //  AUTHOR: Rob Tillaart
 //          Erni - testing/fixes
-// VERSION: 0.4.2
-// PURPOSE: Arduino library for MS5611 temperature and pressure sensor
+// VERSION: 0.5.0
+// PURPOSE: Arduino library for MS5611 (I2C) temperature and pressure sensor
 //     URL: https://github.com/RobTillaart/MS5611
 
 
@@ -31,24 +31,25 @@
 //  CS to GND  ==>  0x77
 
 
-#define MS5611_LIB_VERSION                    (F("0.4.2"))
+#define MS5611_LIB_VERSION                    (F("0.5.0"))
 
 #ifndef MS5611_DEFAULT_ADDRESS
 #define MS5611_DEFAULT_ADDRESS                0x77
 #endif
 
+
 #define MS5611_READ_OK                        0
 #define MS5611_ERROR_2                        2         //  low level I2C error
 #define MS5611_NOT_READ                       -999
 
 
 enum osr_t
 {
-    OSR_ULTRA_HIGH = 12,        // 10 millis
-    OSR_HIGH       = 11,        //  5 millis
-    OSR_STANDARD   = 10,        //  3 millis
-    OSR_LOW        = 9,         //  2 millis
-    OSR_ULTRA_LOW  = 8          //  1 millis    Default = backwards compatible
+  OSR_ULTRA_HIGH = 12,        // 10 millis
+  OSR_HIGH       = 11,        //  5 millis
+  OSR_STANDARD   = 10,        //  3 millis
+  OSR_LOW        = 9,         //  2 millis
+  OSR_ULTRA_LOW  = 8          //  1 millis    Default = backwards compatible
 };
 
 
@@ -76,40 +77,40 @@ class MS5611
   void     setOversampling(osr_t samplingRate);
 
   //  oversampling rate is in osr_t
-  osr_t    getOversampling() const { return (osr_t) _samplingRate; };
+  osr_t    getOversampling() const;
 
-  //  temperature is in ²C
+  //  temperature is in degrees C
   float    getTemperature() const;
-
   //  pressure is in mBar
   float    getPressure() const;
-  //  pressure is in Pascal (SI-unit) - 0.4.1
+  //  pressure is in Pascal (SI-unit)
   float    getPressurePascal() const;
 
-  //  OFFSET - 0.3.6
+  //  OFFSET
   //  pressure offset is in mBar.
-  void     setPressureOffset(float offset = 0)    { _pressureOffset = offset; };
-  float    getPressureOffset()    { return _pressureOffset; };
+  void     setPressureOffset(float offset = 0);
+  float    getPressureOffset();
   //  temperature offset in degrees C.
-  void     setTemperatureOffset(float offset = 0) { _temperatureOffset = offset; };
-  float    getTemperatureOffset() { return _temperatureOffset; };
+  void     setTemperatureOffset(float offset = 0);
+  float    getTemperatureOffset();
 
   //  ALTITUDE (from MS5837)
+  //  air pressure in mBar, returns meters
   float    getAltitude(float airPressure = 1013.25);
-
+  //  idem, returns feet.
+  float    getAltitudeFeet(float airPressure = 1013.25);
 
   //  to check for failure
-  int      getLastResult() const   { return _result; };
+  int      getLastResult() const;
 
   //  last time in millis() when the sensor has been read.
-  uint32_t lastRead() const        { return _lastRead; };
+  uint32_t lastRead() const;
 
   //  _deviceID is a SHIFT XOR merge of 7 PROM registers, reasonable unique
-  uint32_t getDeviceID() const     { return _deviceID; };
-
-  void     setCompensation(bool flag = true) { _compensation = flag; };
-  bool     getCompensation() { return _compensation; };
+  uint32_t getDeviceID() const;
 
+  void     setCompensation(bool flag = true);
+  bool     getCompensation();
 
   //       EXPERIMENTAL
   uint16_t getManufacturer();
@@ -118,8 +119,10 @@ class MS5611
   //       DEVELOP
   uint16_t getProm(uint8_t index);
   uint16_t getCRC();
+
+  //  develop functions.
   /*
-  void     setAddress(uint8_t address) { _address = address; };  // RANGE CHECK + isConnected() !
+  void     setAddress(uint8_t address) { _address = address; };  // RANGE CHECK
   uint8_t  detectAddress() { todo };  // works with only one on the bus?
   */