README.md

bme280_example

Welcome to the bme280_example AtomVM application.

This example application will drive a BME280 temperature, pressure, and humidity sensor attached to an ESP32 device using the 2-wire I2C interface and print readings to the console.

For this application, you will need:

• An ESP32 device, flashed with the AtomVM image (including the VM and core libraries), and capable of connecting via UART to your development machine;
• A BME280 device, typically marketed as an integrated development board;
• The esptool.py tool (for flashing);
• The git version control tool;
• Erlang/OTP 21 or higher, along with rebar3;
• A serial monitor program of your choice (e.g, minicom)

While the IDF SDK and required toolchains are not required, they may make life a little easier.

Getting Started

Connection

Use of the BME280 will typically require connecting some kind of development board, which includes the BH1750 integrated circuit, along with additional passive components, to you ESP32 device.

Connect the VCC and GND pins to a power source and ground (e.g., on your ESP32).

Connect the SDA and SCL pins on two selected GPIO pins on your ESP32 device (e.g., pin 21 and 22).

+-----------+                         +-------------+
|       VCC +-------------------------+ +3.3v       |
|       GND +-------------------------+ GND         |
|       SDA +-------------------------+ GPIO 21     |
|       SCL +-------------------------+ GPIO 22     |
+-----------+                         +-------------+
   BME280                                  ESP32

Note. The example program assumes the SDA pin is connected to the ESP32 GPIO pin 21 and the SCL pin is connected to the ESP32 GPIO pin 22. If you need to use different pins, make sure to change the example program to reflect your requirements.

Build Instructions

To build and flash this application to your ESP32 device, issue the esp32_flash target to the rebar3 command, and optionally specify the device port and baud rate, if they do not match the defaults.

Note. For information about the esp32_flash target, see the atomvm_rebar3_plugin instructions.

shell$ rebar3 esp32_flash -p /dev/ttyUSB0 -b 115200
===> Fetching atomvm_rebar3_plugin
===> Fetching packbeam (from {git,"https://github.com/atomvm/atomvm_packbeam.git",
                    {branch,"master"}})
===> Analyzing applications...
===> Compiling atomvm_rebar3_plugin
===> Compiling packbeam
===> Verifying dependencies...
===> App atomvm_lib is a checkout dependency and cannot be locked.
===> Analyzing applications...
===> Compiling atomvm_lib
===> Analyzing applications...
===> Compiling bme280_example
===> AVM file written to : atomvm_lib.avm
===> AVM file written to : bme280_example.avm
===> esptool.py --chip esp32 --port /dev/ttyUSB0 --baud 115200 --before default_reset --after hard_reset write_flash -u --flash_mode dio --flash_freq 40m --flash_size detect 0x210000 .../atomvm_lib/examples/bme280_example/_build/default/lib/bme280_example.avm

esptool.py v2.1
Connecting........_____.
Chip is ESP32D0WDQ6 (revision (unknown 0xa))
Uploading stub...
Running stub...
Stub running...
Configuring flash size...
Auto-detected Flash size: 4MB
Wrote 16384 bytes at 0x00210000 in 1.4 seconds (91.4 kbit/s)...
Hash of data verified.

Leaving...
Hard resetting...

Connect to the device using the USB port (e.g., via minicom), and you should see something like:

Found AVM partition: size: 1048576, address: 0x210000
Booting file mapped at: 0x3f430000, size: 1048576
Found AVM partition: size: 1048576, address: 0x110000
Starting: bme280_example.beam...
---
Temperature: 2.47500000000000000000e+01C, Pressure: 1.01286000000000001364e+03hPa, Humidity: 3.33222656250000000000e+01%RH
Temperature: 2.47300000000000004263e+01C, Pressure: 1.01283000000000004093e+03hPa, Humidity: 3.34482421875000000000e+01%RH
Temperature: 2.47199999999999988631e+01C, Pressure: 1.01282000000000005002e+03hPa, Humidity: 3.34482421875000000000e+01%RH
...