{"id":18285532,"url":"https://github.com/ludiazv/node-red-contrib-bme280","last_synced_at":"2025-04-05T07:32:25.272Z","repository":{"id":93984963,"uuid":"118910403","full_name":"ludiazv/node-red-contrib-bme280","owner":"ludiazv","description":"Node RED BME280/BMP280 sensor node","archived":false,"fork":false,"pushed_at":"2022-11-23T10:04:57.000Z","size":22,"stargazers_count":2,"open_issues_count":5,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-18T05:51:30.444Z","etag":null,"topics":["barometer","bme280","humidity","node-red","orangepi","raspberry-pi","sensor","temperature"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ludiazv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-01-25T12:31:19.000Z","updated_at":"2022-11-22T13:00:07.000Z","dependencies_parsed_at":"2023-05-22T19:30:27.002Z","dependency_job_id":null,"html_url":"https://github.com/ludiazv/node-red-contrib-bme280","commit_stats":{"total_commits":22,"total_committers":6,"mean_commits":"3.6666666666666665","dds":0.5454545454545454,"last_synced_commit":"b1992b9f2229438bbcc338d9d3a07291503b82c6"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ludiazv%2Fnode-red-contrib-bme280","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ludiazv%2Fnode-red-contrib-bme280/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ludiazv%2Fnode-red-contrib-bme280/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ludiazv%2Fnode-red-contrib-bme280/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ludiazv","download_url":"https://codeload.github.com/ludiazv/node-red-contrib-bme280/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247305879,"owners_count":20917201,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["barometer","bme280","humidity","node-red","orangepi","raspberry-pi","sensor","temperature"],"created_at":"2024-11-05T13:17:00.291Z","updated_at":"2025-04-05T07:32:20.255Z","avatar_url":"https://github.com/ludiazv.png","language":"JavaScript","readme":"# node-red-contrib-bme280\n\nA node-red custom node wrapper for the nodejs [bme280-sensor](https://github.com/skylarstein/bme280-sensor). by @skylarstein . This library uses the outstanding package [i2c-bus](https://github.com/fivdi/i2c-bus) that enable the communication with I2C devices in most common Linux SBCs. Raspberry Pi, C.H.I.P., BeagleBone, Orange Pi,  or Intel Edison are supported by this package.\n\nThe package provide a single custom node __Bme280__ that can be used directly in your flow.\n\n\n## Installation\n\nUnder your node-red (typically ``$HOME/.node-red``) working directory.\n\n``\nnpm install node-red-contrib-bme280\n``\n\nNode palette can be used as well to install the node.\n\nAfter restarting node-red the \"Bme280\" node should be available in \"input\" category.\n\n## Prerequisites\n\nWire your sensor the I2C/TWI of the SBCs. Only four wires are needed. two for power (VCC 3.3V \u0026 GND) and two for actual I2C transmission (SLC \u0026 SDA).\n\nI2C interface need to be enabled in in your linux distribution.\n\n\u003e__Caveat__:\n\u003e Check your permissions to the /dev/i2c-xx devices. The user running node-red need access to writing and reading.\n\u003e Refer to [i2c-bus](https://github.com/fivdi/i2c-bus) to find how to grant access to your user to the /dev/i2c-xx device files\n\n## Usage\n\n### Configuration \u0026 deployment\nAfter installation place your Bme280 node in any of your flow and configure the following parameters:\n\n1. __Name:__ Select the name of your sensor for easy identification.\n2. __Bus ID:__ Select the I2C bus to which the sensor is connected. Depending on your wiring and SBC can be different.\n3. __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 \u003cbusnum\u003e``\n4. __Topic:__ Topic field set on the output message. If this field is empty, topic will not be included in the output msg. By configuring the node this way input msg topic will be reused.\n4. __Extra:__ Check box to indicate the node to compute extra information each time a read is requested.\n5. __Sea Preasure:__ If extra information provided this parameter is used for correction. The value is in hPa.\n\nAfter configuration and deployment the node will init the sensor and will identify if BME280 or BMP280 variant is detected.  \n\n### Reading Sensor Data\nAs 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 input __msg is reused__ so any property on the input msg (with the exception of payload and topic if set) will be redirected without modification to the output.\n\nThe __output__ will have the following format:\n\n```\nmsg = {\n  _msgid: \u003cnode-red msg_id\u003e,\n  topic: \u003cdefined topic\u003e,\n  payload: {\n    model: \"BME280\"  or  \"BMP280\",\n    temperature_C: \u003cfloat in celsius\u003e,\n    humidity: \u003cfloat in %\u003e, // Only present if model == \"BME280\"\n    pressure_hPa: \u003cfloat in hPa\u003e\n  }\n}\n\n// the node node is configured to send extra information payload will contain also\n\npayload: {\n     ....\n     heatIndex: \u003cfloat in celsius\u003e, // Only present if model == \"BME280\"\n     dewPoint_C= \u003cfloat in celsius\u003e, // Only present if model == \"BME280\"\n     altitude_M= \u003cfloat in Meters\u003e,\n     temperature_F=\u003cfloat in fahrenheit\u003e\n     pressure_Hg=\u003cfloat in mm of mercury\u003e\n}\n\n```\n__Note__: BMP280 version __WILL NOT__ report humidity information the sensor do not provide this information. humidity, heatIndex \u0026 dewPoint_C will not be __present__ in the payload.\n\n\n## Notes\n\nThis node has been tested on Raspberry Pi 3, Raspberry Pi Zero \u0026 Orange Pi Zero. Running recent versions of node-red.\n\nBPM280 \u0026 BME280 has been tested using different breakout from cheap providers. Original Adafruit's sensor is not required.\n\n\n## Change log\n\n\n* 1.1.0 Stable version\n    - Added max init retries to avoid continous use of I2C bus\n    - Added message bypass in case of error.\n    - Added parameter for sea level presasure to calculate properly altitude.\n\n* 1.0.0 Stable version\n    - Sensor init is done also in input trigger for better stability.\n\n* 0.0.5\n    - Fix #2 for nodejs \u003e=13 compatibility\n\n* 0.0.4\n    - Improve node status messages.\n\n* 0.0.3\n    - Custom Icon\n    - Topic configurable to help MQTT integration\n    - Input msg will be reused to enable better HTTP node integration.\n    - Documentation improvements\n    - Added some examples.\n\n* 0.0.2 Solved npm repository name.\n* 0.0.1 First version\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fludiazv%2Fnode-red-contrib-bme280","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fludiazv%2Fnode-red-contrib-bme280","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fludiazv%2Fnode-red-contrib-bme280/lists"}