A Python 3 module to interface with MS5837-30BA and MS5837-02BA waterproof pressure and temperature sensors. Tested on Raspberry Pi 3 with Raspbian. Forked from https://github.com/bluerobotics/ms5837-python and updated with Python3 support an installation setup script.
Download and install smbus2 library. Steps to install smbus are provided at: https://pypi.org/project/smbus2/
pip3 install smbus2
MS5837 is pure Python 3 code and requires no compilation. Installation is easy:
python3 setup.py install
import ms5837
ms5837 provides a generic MS5837 class for use with different models
MS5837(model=ms5837.MODEL_30BA, bus=1)
These model-specific classes inherit from MS5837 and don't have any unique members
MS5837_30BA(bus=1)
MS5837_02BA(bus=1)
An MS5837 object can be constructed by specifiying the model and the bus
sensor = ms5837.MS5837() # Use defaults (MS5837-30BA device on I2C bus 1)
sensor = ms5837.MS5837(ms5837.MODEL_02BA, 0) # Specify MS5837-02BA device on I2C bus 0
Or by creating a model-specific object
sensor = MS5837_30BA() # Use default I2C bus (1)
sensor = MS5837_30BA(0) # Specify I2C bus 0
Initialize the sensor. This needs to be called before using any other methods.
sensor.init()
Returns true if the sensor was successfully initialized, false otherwise.
Read the sensor and update the pressure and temperature. The sensor will be read with the supplied oversampling setting. Greater oversampling increases resolution, but takes longer and increases current consumption.
sensor.read(ms5837.OSR_256)
Valid arguments are:
ms5837.OSR_256
ms5837.OSR_512
ms5837.OSR_1024
ms5837.OSR_2048
ms5837.OSR_4096
ms5837.OSR_8192
Returns True if read was successful, False otherwise.
Sets the density in (kg/m^3) of the fluid for depth measurements. The default fluid density is ms5837.DENISTY_FRESHWATER.
sensor.setFluidDensity(1000) # Set fluid density to 1000 kg/m^3
sensor.setFluidDensity(ms5837.DENSITY_SALTWATER) # Use predefined saltwater density
Some convenient constants are:
ms5837.DENSITY_FRESHWATER = 997
ms5837.DENSITY_SALTWATER = 1029
Get the most recent pressure measurement.
sensor.pressure() # Get pressure in default units (millibar)
sensor.pressure(ms5837.UNITS_atm) # Get pressure in atmospheres
sensor.pressure(ms5837.UNITS_kPa) # Get pressure in kilopascal
Some convenient constants are:
ms5837.UNITS_Pa = 100.0
ms5837.UNITS_hPa = 1.0
ms5837.UNITS_kPa = 0.1
ms5837.UNITS_mbar = 1.0
ms5837.UNITS_bar = 0.001
ms5837.UNITS_atm = 0.000986923
ms5837.UNITS_Torr = 0.750062
ms5837.UNITS_psi = 0.014503773773022
Returns the most recent pressure in millibar * conversion. Call read() to update.
Get the most recent temperature measurement.
sensor.temperature() # Get temperature in default units (Centigrade)
sensor.temperature(ms5837.UNITS_Farenheit) # Get temperature in Farenheit
Valid arguments are:
ms5837.UNITS_Centigrade
ms5837.UNITS_Farenheit
ms5837.UNITS_Kelvin
Returns the most recent temperature in the requested units, or temperature in degrees Centigrade if invalid units specified. Call read() to update.
Get the most recent depth measurement in meters.
sensor.depth()
Returns the most recent depth in meters using the fluid density (kg/m^3) configured by setFluidDensity(). Call read() to update.
Get the most recent altitude measurement relative to Mean Sea Level pressure in meters.
sensor.altitude()
Returns the most recent altitude in meters relative to MSL pressure using the density of air at MSL. Call read() to update.