Example Projects for BME690 and BMV080 Sensors on APP 3.1 Board

Disclaimer

• The instructions in this guide are targeted for Windows environment.

---

Version Compatibility Disclaimer

The examples in this repository have been tested with the following versions:

• BSEC Library: <bsec_v3-1-0-0>

• BMV080 SDK : <BMV080-SDK-v11.1.0>

• COINES SDK: COINES_SDK_v2.12

• Please use the specified versions for best results.

---

Prerequisites

1. Download mingw32

   • Download GCC from GCC Download (tdm64-gcc-10.3.0-2.exe)
   • During installation, ensure you check the option "Add to PATH" when prompted.
   • This will automatically set the required environment variables for you.
   • Complete the installation by following the on-screen instructions

2. Download and install the GNU Arm Embedded Toolchain

   • GNU ARM Download (gcc-arm-none-eabi-10.3-2021.10-win32.exe), install and add path to system environment.

3. COINES SDK Setup

   • Visit the COINES SDK GitHub repository and select latest tag available and Clone the repository using following command:

     git clone https://github.com/boschsensortec/COINES_SDK.git
     cd COINES_SDK
     git pull
     git checkout <Latest tag>
     

   • Configure the SDK location:
     • There are two options for integrating the COINES SDK with this project, depending on the preferred directory structure and usage scenario.

   1. In-tree Installation

   • The COINES_SDK folder is placed inside the main BMV_BME project directory.
   • Typical Structure:

     BMV_BME/
     ├── COINES_SDK/
     ├── src/
     └── ...
     

     In each example's Makefile, set: COINES_INSTALL_PATH = ../../../COINES_SDK Note:
     • The number of ../ in the path (e.g., ../../../COINES_SDK) depends on your folder structure and where you place the COINES_SDK relative to your example's Makefile. Adjust the path accordingly to correctly reference the SDK location.

   2. Out-of-tree Installation

   • The COINES_SDK folder is located outside the BMV_BME project directory, often shared among multiple projects.
   • Typical Structure:

     C:/SDKs/COINES_SDK/
     

In each example's Makefile, set: COINES_INSTALL_PATH = C:/SDKs/COINES_SDK (Use the absolute or relative path to your COINES SDK location.) Note:

• Always ensure the COINES_INSTALL_PATH variable in your Makefile points to the correct SDK location before building or running examples.

1. Download this repository
   1. Open the command terminal (using Git Bash or your preferred terminal) and follow the below commands to clone the repository:

      git clone <This repository>
      cd BMV_BME
      git pull
      git checkout <Latest tag>
      

   2. Obtain the latest versions of the BSEC library and the BMV080 library from the official Bosch Sensortec website.

   • These libraries are required for the project to run without errors, as the provided examples depend on them.

   • Follow the section Library Setup Instructions below for details on where and how to place these libraries in your project directory.

Library Setup Instructions

• The repository includes a src/lib folder with placeholder .txt files to clarify the expected structure and guide users on where to place the required libraries:

BMV_BME/
│
├── src/
│   └── lib/
│       ├── README_BSEC.txt      # Instructions for placing the BSEC library
│       └── README_BMV080.txt    # Instructions for placing the BMV080 SDK

• README_BSEC.txt:
  This file provides guidance on how to download and where to place the BSEC library files.

• README_BMV080.txt:
  This file explains how to download and where to place the BMV080 SDK files.

  • These .txt files serve as documentation within the repository, ensuring users understand the intended folder structure and placement of third-party libraries.

Running Examples

To execute an example code, navigate to the src/examples folder. Each example is in its own subfolder. Open the folder and follow the instructions in its README file to run an example.