/** * BMX280 - BME280 & BMP280 Driver for Esspressif ESP-32. * Copyright (C) 2020 * H. Utku Maden */ #ifndef _BMX280_H_ #define _BMX280_H_ #include #include #include "driver/i2c.h" #include "sdkconfig.h" /** * Anonymous structure to driver settings. */ typedef struct bmx280_t bmx280_t; #include "bmx280_bits.h" /** * Create an instance of the BMX280 driver. * @param port The I2C port to use. * @return A non-null pointer to the driver structure on success. */ bmx280_t* bmx280_create(i2c_port_t port); /** * Destroy your the instance. * @param bmx280 The instance to destroy. */ void bmx280_close(bmx280_t* bmx280); /** * Probe for the sensor and read calibration data. * @param bmx280 Driver structure. */ esp_err_t bmx280_init(bmx280_t* bmx280); /** * Configure the sensor with the given parameters. * @param bmx280 Driver structure. * @param configuration The configuration to use. */ esp_err_t bmx280_configure(bmx280_t* bmx280, bmx280_config_t *cfg); esp_err_t bmx280_setMode(bmx280_t* bmx280, bmx280_mode_t mode); bool bmx280_isSampling(bmx280_t* bmx280); /** * Read sensor values as fixed point numbers. * @param bmx280 Driver structure. * @param temperature The temperature in C (0.01 degree C increments) * @param pressure The pressure in Pa (1/256 Pa increments) * @param humidity The humidity in %RH (1/1024 %RH increments) (UINT32_MAX when invlaid.) */ esp_err_t bmx280_readout(bmx280_t *bmx280, int32_t *temperature, uint32_t *pressure, uint32_t *humidity); static inline void bmx280_readout2float(bmx280_t *bmx280, int32_t* tin, uint32_t *pin, uint32_t *hin, float *tout, float *pout, float *hout) { *tout = (float)*tin * 0.1f; *pout = (float)*pin * (1.0f/256.0f); *hout = (*hin == UINT32_MAX) ? -1.0f : (float)*hin * (1.0f/1024.0f); } static inline esp_err_t bmx280_readoutFloat(bmx280_t *bmx280, float* temperature, float* pressure, float* humidity) { int32_t t; uint32_t p, h; esp_err_t err = bmx280_readout(bmx280, &t, &p, &h); if (err == ESP_OK) { bmx280_readout2float(bmx280, &t, &p, &h, temperature, pressure, humidity); } return err; } #endif