Bosch Sensortec Community

    cancel
    Showing results for 
    Search instead for 
    Did you mean: 
    SOLVED

    BMExxx driver documentation

    BMExxx driver documentation

    erickringot
    New Poster

    Development in C language under Raspian on Raspberry Pi3. BME680.

    BME series are provided with their drivers on the site GitHub. It's really useful. But no documentation comes with them. Not clear how to use the functions. Is there somewhere a documentation on, for instance, https://github.com/BoschSensortec/BME680_driver? and even on BSEC ? After having read the values of temperature, humidity, pressure, AQ resistance, is it required to compensate (unless for the pressure depending on the altitude)? or are these compensations automatic?

    At the address, https://github.com/twartzek/bme680-raspberry/blob/master/bme680_main.c, I find the very useful instruction:

    i2cSetAddress(BME680_I2C_ADDR_SECONDARY);

    essential for the i2c connexion  to the sensor (unless I got the error 2).

    1 REPLY 1

    handytech
    Community Moderator
    Community Moderator

    @erickringot wrote:

    BME series are provided with their drivers on the site GitHub. It's really useful. But no documentation comes with them. Not clear how to use the functions. Is there somewhere a documentation on, for instance, https://github.com/BoschSensortec/BME680_driver? and even on BSEC ?


    There is limited example code available for the BME680 but the README file in our official sensor API you linked should already provide pointers on how to integrate this sensor API in your project, including how to initialize the sensor API structure, how to configure and trigger a measurement as well as how to trigger a data readout.


    @erickringot wrote:

    and even on BSEC ?


    There is also additional example code available in our BSEC release package 🙂 In the "examples" folder of this package, you will find for instance that bsec_integration.c makes extensive use of the sensor API when any communication with the BME680 is required.


    @erickringot wrote:

    After having read the values of temperature, humidity, pressure, AQ resistance, is it required to compensate (unless for the pressure depending on the altitude)? or are these compensations automatic?


    By using the sensor API alone, you will be able to readout raw temperature (in °C), relative humidity (in %RH), barometric pressure (in Pa) and gas resistance (in Ohms) directly from the sensor. When using the BSEC library, you will be able to benefit from additionnal data processing and new ouputs such as sensor heat-compensated temperature and relative humidity, heat compensation from external factors (e.g. from PCB self-heating), our IAQ indexes, etc.


    @erickringot wrote:

    At the address, https://github.com/twartzek/bme680-raspberry/blob/master/bme680_main.c, I find the very useful instruction:

    i2cSetAddress(BME680_I2C_ADDR_SECONDARY);

    essential for the i2c connexion  to the sensor (unless I got the error 2).


    It is indeed very important that you code/sensor API implementation matches your hardware setup! Once the I²C address is selected in hardware by connected the SDO pin of BME680 to VDDIO or GND, the respective address should be indicated to the sensor API structure, in particular via dev_id.

    Icon--AD-black-48x48Icon--address-consumer-data-black-48x48Icon--appointment-black-48x48Icon--back-left-black-48x48Icon--calendar-black-48x48Icon--center-alignedIcon--Checkbox-checkIcon--clock-black-48x48Icon--close-black-48x48Icon--compare-black-48x48Icon--confirmation-black-48x48Icon--dealer-details-black-48x48Icon--delete-black-48x48Icon--delivery-black-48x48Icon--down-black-48x48Icon--download-black-48x48Ic-OverlayAlertIcon--externallink-black-48x48Icon-Filledforward-right_adjustedIcon--grid-view-black-48x48IC_gd_Check-Circle170821_Icons_Community170823_Bosch_Icons170823_Bosch_Icons170821_Icons_CommunityIC-logout170821_Icons_Community170825_Bosch_Icons170821_Icons_CommunityIC-shopping-cart2170821_Icons_CommunityIC-upIC_UserIcon--imageIcon--info-i-black-48x48Icon--left-alignedIcon--Less-minimize-black-48x48Icon-FilledIcon--List-Check-grennIcon--List-Check-blackIcon--List-Cross-blackIcon--list-view-mobile-black-48x48Icon--list-view-black-48x48Icon--More-Maximize-black-48x48Icon--my-product-black-48x48Icon--newsletter-black-48x48Icon--payment-black-48x48Icon--print-black-48x48Icon--promotion-black-48x48Icon--registration-black-48x48Icon--Reset-black-48x48Icon--right-alignedshare-circle1Icon--share-black-48x48Icon--shopping-bag-black-48x48Icon-shopping-cartIcon--start-play-black-48x48Icon--store-locator-black-48x48Ic-OverlayAlertIcon--summary-black-48x48tumblrIcon-FilledvineIc-OverlayAlertwhishlist