{
  "id": "solderedelectronics/Soldered-BME690-MicroPython-Library",
  "name": "Soldered-BME690-MicroPython-Library",
  "prettyName": "Soldered-BME690-MicroPython-Library",
  "description": "A MicroPython Module for the BME690 Breakout board",
  "version": "",
  "author": "solderedelectronics",
  "license": "GPL-3.0",
  "tags": [
    "bosch-sensor",
    "bosch-sensortec",
    "solderedelectronics"
  ],
  "status": "VALID",
  "official": false,
  "source": "https://github.com/solderedelectronics/Soldered-BME690-MicroPython-Library",
  "updatedAt": "2026-09-16T07:46:33.954Z",
  "page": "https://checkmim.com/packages/solderedelectronics+Soldered-BME690-MicroPython-Library",
  "createdAt": "2026-09-16T07:46:26.010Z",
  "submittedBy": "SolderedElectronics",
  "install": {
    "mpremote": "mpremote mip install github:solderedelectronics/Soldered-BME690-MicroPython-Library",
    "mip": "import mip; mip.install(\"github:solderedelectronics/Soldered-BME690-MicroPython-Library\")"
  },
  "readme": "# Soldered BME690 MicroPython Library\n\n| ![BME690 breakout board](https://upload.wikimedia.org/wikipedia/commons/8/8f/Example_image.svg) |\n| :--------------------------------------------------------------------------------------------: |\n|                          [BME690 breakout board](https://www.solde.red/333411)                     |\n\nBreakout board for the Bosch BME690 sensor, which measures temperature, relative humidity, barometric pressure and gas resistance (VOC). The board communicates over I2C only and is part of the [Qwiic ecosystem](https://soldered.com/collections/qwiic-ecosystem).\n\n### Quick start\n\n```python\nfrom bme690 import BME690, BME69X_FORCED_MODE\nimport time\n\nsensor = BME690()               # Or BME690(address=BME69X_I2C_ADDR_HIGH)\nsensor.set_tph()                # Default over-sampling\nsensor.set_heater_prof(300, 100)  # 300 degrees C for 100 ms\n\nwhile True:\n    sensor.set_op_mode(BME69X_FORCED_MODE)\n    time.sleep_us(sensor.get_meas_dur())\n    if sensor.fetch_data():\n        data, _ = sensor.get_data()\n        print(data.temperature)\n    time.sleep(1)\n```\n\nHave a look at the scripts in `Examples/` for forced, parallel and sequential mode, for the built-in self test and for the BME AI-Studio raw data logger.\n\nThe driver uses the floating point compensation of the Bosch API. Ports of MicroPython which use single precision floats, the ESP32 among them, are therefore slightly less precise than the Arduino library, well below the accuracy of the sensor itself.\n\n### How to install\n\nUse [mim](https://checkmim.com/packages).\n\nor\n\nAfter [**installing the mpremote package**](https://docs.micropython.org/en/latest/reference/mpremote.html), install the library on your board using the following command:\n\n```sh\n  mpremote mip install github:SolderedElectronics/Soldered-BME690-MicroPython-Library\n```\nOr, if you're running a Windows OS:\n\n```sh\n  python -m mpremote mip install github:SolderedElectronics/Soldered-BME690-MicroPython-Library\n```\n\n### Repository Contents\n\n- **bme690.py** - MicroPython driver class, I2C only\n- **package.json** - mip install manifest\n- **/Examples** - examples for forced, parallel and sequential mode, the built-in self test and the BME AI-Studio raw data logger\n\n### Examples\n\n| Example | What it does |\n| :------ | :----------- |\n| `bme690-forcedMode.py` | One measurement at a time, the usual way to read the sensor |\n| `bme690-sequentialMode.py` | The sensor steps through a heater profile on its own, sleeping in between |\n| `bme690-parallelMode.py` | The gas sensor sweeps a heater profile while TPH is measured continuously |\n| `bme690-selfTest.py` | Runs the built-in self test and prints the unique ID |\n| `bme690-aiStudioLogger.py` | Records a `.bmerawdata` file on an SD card for BME AI-Studio. Needs an ESP32 with WiFi for the NTP synced real time clock, an SD card module on the SPI pins and the `sdcard` driver of micropython-lib, which `mip` installs along with this library |\n\n### Hardware design\n\nYou can find hardware design for this board in _BME690 breakout board_ hardware repository.\n\n### Documentation\n\nAccess library documentation [here](https://docs.soldered.com/).\n\n### About Soldered\n\n![Soldered Logo](https://raw.githubusercontent.com/SolderedElectronics/Soldered-Generic-Arduino-Library/dev/extras/Soldered-logo-color.png)\n\nAt Soldered, we design and manufacture a wide selection of electronic products to help you turn your ideas into acts and bring you one step closer to your final project. Our products are intented for makers and crafted in-house by our experienced team in Osijek, Croatia. We believe that sharing is a crucial element for improvement and innovation, and we work hard to stay connected with all our makers regardless of their skill or experience level. Therefore, all our products are open-source. Finally, we always have your back. If you face any problem concerning either your shopping experience or your electronics project, our team will help you deal with it, offering efficient customer service and cost-free technical support anytime. Some of those might be useful for you:\n\n- [Web Store](https://www.soldered.com/shop)\n- [Tutorials & Projects](https://soldered.com/learn)\n- [Documentation](https://docs.soldered.com)\n\n### Original source\n\nThis library is a port of the [Soldered BME690 Arduino library](https://github.com/SolderedElectronics/Soldered-BME690-Arduino-Library), which wraps the [BME69x Sensor API](https://github.com/boschsensortec/BME69x_SensorAPI) by Bosch Sensortec. Thank you, Bosch Sensortec.\n\n### Open-source license\n\nSoldered invests vast amounts of time into hardware & software for these products, which are all open-source. Please support future development by buying one of our products.\n\nCheck license details in the LICENSE file. Long story short, use these open-source files for any purpose you want to, as long as you apply the same open-source licence to it and disclose the original source. No warranty - all designs in this repository are distributed in the hope that they will be useful, but without any warranty. They are provided \"AS IS\", therefore without warranty of any kind, either expressed or implied. The entire quality and performance of what you do with the contents of this repository are your responsibility. In no event, Soldered (TAVU) will be liable for your damages, losses, including any general, special, incidental or consequential damage arising out of the use or inability to use the contents of this repository.\n\n## Have fun!\n\nAnd thank you from your fellow makers at Soldered Electronics.\n"
}