Initial commit

GyverBME280.h

@@ -0,0 +1,112 @@
+/*
+    Лёгкая библиотека для работы с BME280 по I2C для Arduino
+    Документация: 
+    GitHub: https://github.com/GyverLibs/GyverBME280
+    
+    Egor 'Nich1con' Zaharov for AlexGyver, alex@alexgyver.ru
+    https://alexgyver.ru/
+    MIT License
+
+    Версии:
+    v1.3 - исправлена ошибка при отриц. температуре
+    v1.4 - разбил на h и cpp
+    v1.5 - добавлена поддержка BMP280s
+*/
+
+#ifndef GyverBME280_h
+#define GyverBME280_h
+
+#include <Arduino.h>
+#include <Wire.h>
+
+#define NORMAL_MODE	0x03
+#define FORCED_MODE	0x02
+
+#define STANDBY_500US  0x00
+#define STANDBY_10MS   0x06
+#define STANDBY_20MS   0x07
+#define STANDBY_6250US 0x01
+#define STANDBY_125MS  0x02
+#define STANDBY_250MS  0x03
+#define STANDBY_500MS  0x04
+#define STANDBY_1000MS 0x05
+
+#define MODULE_DISABLE		  0x00
+#define OVERSAMPLING_1        0x01
+#define OVERSAMPLING_2        0x02
+#define OVERSAMPLING_4        0x03
+#define OVERSAMPLING_8        0x04
+#define OVERSAMPLING_16       0x05
+
+#define FILTER_DISABLE  0x00
+#define FILTER_COEF_2   0x01
+#define FILTER_COEF_4   0x02
+#define FILTER_COEF_8   0x03
+#define FILTER_COEF_16  0x04
+
+
+// ================================= CLASS ===================================
+
+class GyverBME280 {
+
+public:
+    GyverBME280(TwoWire &wire);								// Create an object of class BME280
+    bool begin();							// Initialize sensor with standart 0x76 address	
+    bool begin(uint8_t address);				// Initialize sensor with not standart 0x76 address	
+    bool isMeasuring(void);						// Returns 'true' while the measurement is in progress					
+    float readPressure(void);					// Read and calculate atmospheric pressure [float , Pa]
+    float readHumidity(void);					// Read and calculate air humidity [float , %]
+    void oneMeasurement(void);					// Make one measurement and go back to sleep [FORCED_MODE only]
+    void setMode(uint8_t mode);
+    float readTemperature(void);				// Read and calculate air temperature [float , *C]
+    void setFilter(uint8_t mode);				// Adjust the filter ratio other than the standard one [before begin()]
+    void setStandbyTime(uint8_t mode);			// Adjust the sleep time between measurements [NORMAL_MODE only][before begin()]
+    void setHumOversampling(uint8_t mode);		// Set oversampling or disable humidity module [before begin()]
+    void setTempOversampling(uint8_t mode);		// Set oversampling or disable temperature module [before begin()]
+    void setPressOversampling(uint8_t mode);	// Set oversampling or disable pressure module [before begin()]
+
+private:
+
+    //============================== DEFAULT SETTINGS ========================================|
+    TwoWire *_wire = nullptr;
+    int _i2c_address = 0x76;					// BME280 address on I2C bus                  |
+    uint8_t _operating_mode = NORMAL_MODE;		// Sensor operation mode                      |
+    uint8_t _standby_time = STANDBY_250MS;		// Time between measurements in NORMAL_MODE	  |
+    uint8_t _filter_coef = FILTER_COEF_16; 		// Filter ratio IIR                           |
+    uint8_t _temp_oversampl = OVERSAMPLING_4;	// Temperature module oversampling parameter  |
+    uint8_t _hum_oversampl = OVERSAMPLING_1;	// Humidity module oversampling parameter     |
+    uint8_t _press_oversampl = OVERSAMPLING_2;	// Pressure module oversampling parameter     |
+    //========================================================================================|
+    
+    bool reset(void);                                   	// BME280 software reset 
+    int32_t readTempInt();                              	// Temperature reading in integers for the function of reading
+    void readCalibrationData(void);                     	// Read all cells containing calibration values
+    uint8_t readRegister(uint8_t address);					// Read one 8-bit BME280 register
+    uint32_t readRegister24(uint8_t address);        		// Read and combine three BME280 registers
+    bool writeRegister(uint8_t address , uint8_t data);		// Write one 8-bit BME280 register
+
+    struct {												// Structure to store all calibration values
+        uint16_t _T1;
+        int16_t _T2;
+        int16_t _T3;
+        uint16_t _P1;
+        int16_t _P2;
+        int16_t _P3;
+        int16_t _P4;
+        int16_t _P5;
+        int16_t _P6;
+        int16_t _P7;
+        int16_t _P8;
+        int16_t _P9;
+        uint8_t _H1;
+        int16_t _H2;
+        uint8_t _H3;
+        int16_t _H4;
+        int16_t _H5;
+        int8_t _H6;
+    } CalibrationData;
+};
+
+float pressureToMmHg(float pressure);		// Convert [Pa] to [mm Hg]  
+float pressureToAltitude(float pressure);	// Convert pressure to altitude
+#endif