node-red-contrib-bme280 0.0.2

Node for BME280/BMP280 sensors for SBC GPIOS.

npm install node-red-contrib-bme280

A node-red custom node wrapper for the nodejs bme280-sensors. by @skylarstein . This library uses the outstanding package i2c-bus that enable the comunication with I2C devices in most commmon Linux SBCs. Raspberry Pi, C.H.I.P., BeagleBone, Orange Pi, or Intel Edison are supported by this package.

The package provide a single custom node Bme280 that can be used


Under your node-red working directory.

npm install node-red-contrib-bme280

Node palette can be used as well to install the node.

After restarting node-red the "Bme280" node should be available in "input" category.


Wire your sensor the I2C/TWI of the SBCs. Only four wires are needed. two for power (VCC 3.3V & GND) and two for actual I2C transmission (SLC & SDA).

Caveat: Check your permissions to the /dev/i2c-xx devices. The user running node-red need access to writting and reading. Refer to i2c-bus to find how to grant access to your user to the /dev/i2c-xx device files


Configuration & deployment

After installation place your Bme280 node in any of your flow and configure the following parameters:

  1. Name: Select the name of your sensor for easy indentifiation.
  2. Bus ID: Select the I2C bus to which the sensor is connected. Depending on your wiring and SBC can be different.
  3. I2C address: I2C address (7-bit) hexdecimal address(0x##). BMP/BME280 sensor have fixed 0x77 or 0x76. You can check your sensor id by using i2c-tools typing i2cdetect -y <busnum>
  4. Extra: Check box to indicate the node to compute extra information each time a read is requested.

After configuration and deployment the node will init the sensor and will identify if BME280 or BMP280 variant is detected.

Reading Sensor Data

As in other node-red nodes the actual measurement of sensor data require that an input msg arrive to the node. The input called Trigger will start the reading of sensor data will send the data in the node's output.

The output will have the follwing format:

msg = {
  _id: <node-red msg_id>,
  topic: "bme280",
  payload: {
    model: "BME280"  or  "BMP280",
    temperature_C: <float in celsius>,
    humidity: <float in %>,
    pressure_hPa: <float in hPa>

// the node node is configured to send extra information payload will contain also

payload: {
     heatIndex: <float in celsius>,
     pl.dewPoint_C= <float in celsius>,
     pl.altitude_M= <float in Meters>,
     pl.temperature_F=<float in fahrenheit>
     pl.pressure_Hg=<float in mm of mercury>

Note: BMP280 version WILL NOT report humidity information the senso do not provide this information. humidity will be allways be read as 0.


This node has been tested on Raspberry Pi 3, raspberry Pi Zero & Orange Pi Zero. Running recent versions of node-red.

BPM280 & BME280 has been tested using different breakout from cheap providers. Original Adafruit's sensor is not required.

Change log.

  • 0.0.1v First version

Node Info

Version: 0.0.2
Updated 3 weeks, 3 days ago
License: MIT


6 in the last day
31 in the last week
151 in the last month


  • Bme280


  • node-red
  • rpi
  • raspberry
  • Beaglebone
  • orangepi
  • BBB
  • Edison
  • sensor
  • sensors
  • temperature
  • humidity
  • barometer


  • ldiaz