ABOUT

Fork of DFRobot/DFRobot_BME680 with exposed raw ADC data from the sensor.

DFRobot_BME680

• 中文版

BME680 is an integrated environmental sensor developed specifically for mobile applications and wearables where size and low power consumption are key requirements. Expanding Bosch Sensortec’s existing family of environmental sensors, the BME680 integrates for the first time individual high linearity and high accuracy sensors for gas, pressure, humidity and temperature.

Product Link（https://www.dfrobot.com/product-1697.html）

SKU: SEN0248

Table of Contents

• Summary
• Installation
• Methods
• Compatibility
• History
• Credits

Summary

Provides an Arduino library for reading and interpreting Bosch BME680 data over I2C over SPI.Reads temperature, humidity, gas, IAQ(details in examples\readme), pressure and calculates altitude.

Installation

To use this library download the zip file, uncompress it to a folder named DFRobot_BME680. Download the zip file first to use this library and uncompress it to a folder named DFRobot_BME680.

Methods

  /**
   * @fn begin
   * @brief begin BME680 device
   * @return result
   * @retval  non-zero : falid
   * @retval  0        : succussful
   */
  int16_t begin(void);
  /**
   * @fn update
   * @brief update all data to MCU ram
   */
  void    update(void);
  /**
   * @fn iaqUpdate
   * @brief update all data to MCU ram with IAQ (only for esp8266 now)
   *
   * @return result:
   * @retval 0 :complete
   * @retval 1 :busy
   */
  int8_t  iaqUpdate(void);
  /**
   * @fn startConvert
   * @brief start convert to get a accurate values
   */
  void  startConvert(void);
  /**
   * @fn readTemperature
   * @brief read the temperature value (unit C)
   *
   * @return temperature valu, this value has two decimal points
   */
  float readTemperature(void);
  /**
   * @fn readTemperatureRAW
   * @brief read the raw ADC temperature value
   *
   * @return raw adc temperature value, uint32
   */
  uint32_t readTemperatureRAW(void);
  /**
   * @fn readPressure
   * @brief read the pressure value (unit pa)
   *
   * @return pressure value, this value has two decimal points
   */
  float readPressure(void);
  /**
   * @fn readPressureRAW
   * @brief read the raw ADC pressure value
   *
   * @return raw adc pressure value, uint32
   */
  uint32_t readPressureRAW(void);
  /**
   * @fn readHumidity
   * @brief read the humidity value (unit %rh)
   * @return humidity value, this value has two decimal points
   */
  float readHumidity(void);
  /**
   * @fn readHumidityRAW
   * @brief read the raw ADC humidity value
   * @return raw adc humidity value, uint16
   */
  uint16_t readHumidityRAW(void);
  /**
   * @fn readAltitude
   * @brief read the altitude (unit meter)
   * @return altitude value, this value has two decimal points
   */
  float readAltitude(void);
  /**
   * @fn readCalibratedAltitude
   * @brief read the Calibrated altitude (unit meter)
   *
   * @param seaLevel  normalised atmospheric pressure
   *
   * @return calibrated altitude value , this value has two decimal points
   */
  float readCalibratedAltitude(float seaLevel);
  /**
   * @fn readGasResistance
   * @brief read the gas resistance(unit ohm)
   * @return temperature value, this value has two decimal points
   */
  float readGasResistance(void);
  /**
   * @fn readGasResistanceRAW
   * @brief read the raw ADC gas resistance
   * @return raw adc gas resistance value, uint16
   */
  uint16_t readGasResistanceRAW(void);
  /**
   * @fn readGasRange
   * @brief read the gas range
   * @return gas range value, uint8
   */
  uint8_t readGasRange(void);
  /**
   * @fn readSeaLevel
   * @brief read normalised atmospheric pressure (unit pa)
   * @param altitude   accurate altitude for normalising
   * @return normalised atmospheric pressure
   */
  float readSeaLevel(float altitude);
  /**
   * @fn readIAQ
   * @brief read IAQ
   * @return The result of IAQ
   */
  float readIAQ(void);
  /**
   * @fn setParam
   * @brief set bme680 parament
   *
   * @param eParam        :which param you want to change
   *        dat           :object data, can't more than 5
   */  
  void    setParam(eBME680_param_t eParam, uint8_t dat);
  /**
   * @fn setGasHeater
   * @brief set bme680 gas heater
   * @param temp        :your object temp
   * @param t           :time spend in milliseconds
   */
   void    setGasHeater(uint16_t temp, uint16_t t);
  /**
   * @fn isIAQReady
   * @brief check IAQ ready
   * @return result:
   * @retval 0 :ready
   * @retval 1 :not ready
   */
  uint8_t isIAQReady(void);
  /**
   * @fn getCalibrationData
   * @brief read calibration data from sensor
   * @return return bme680_calib_data struct with calibration values
   */
  bme680_calib_data getCalibrationData(void);

Compatibility

MCU	Work Well	Work Wrong	Untested	Remarks
FireBeetle-ESP32	√
FireBeetle-ESP8266	√
FireBeetle-BLE4.1	√
Arduino uno	√
Arduino leonardo	√

History

• 2017/12/04 - Version 2.0.0 released.
• 2017/09/04 - Version 1.0.0 released.

Credits

Written by Frank(jiehan.guo@dfrobot.com), 2017. (Welcome to our website)