Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/seblucas/i2c2mqtt
Get values from sensors in your i2c bus and send it to your MQTT broker
https://github.com/seblucas/i2c2mqtt
bh1750 bme280 i2c mqtt python si7021
Last synced: 2 months ago
JSON representation
Get values from sensors in your i2c bus and send it to your MQTT broker
- Host: GitHub
- URL: https://github.com/seblucas/i2c2mqtt
- Owner: seblucas
- License: gpl-3.0
- Created: 2018-01-03T10:41:15.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-02-20T22:47:03.000Z (almost 3 years ago)
- Last Synced: 2023-03-22T22:22:44.150Z (almost 2 years ago)
- Topics: bh1750, bme280, i2c, mqtt, python, si7021
- Language: Python
- Size: 21.5 KB
- Stars: 6
- Watchers: 3
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# i2c2mqtt
Get values from sensors in your i2c bus and send it to your MQTT broker
# Usage
## Prerequisite
You simply need Python3 (never tested with Python2.7) and the only dependencies are `smbus` (to access the i2c) and `paho-mqtt` (for MQTT broker interaction) so this line should be enough :
```bash
pip3 install paho-mqtt cffi smbus-cffi
```
You may have to also install `libffi-dev` and `python3-dev` because it may need to recompile some stuff. If you're using Debian the you can use `python-smbus`
## Using the script
Easy, first try a dry-run command :
```bash
./i2c2mqtt.py -d -d -n -v
```
For now the device can be :
* bh1750
* si7021
* bme280
PR welcomed to add more.
and then a real command to add to your crontab :
```bash
./netatmo2MQTT.py -d
```
## Help
```bash
seb@minus~/src/i2c2mqtt# ./i2c2mqtt.py --help
usage: i2c2mqtt.py [-h] [-d DEVICES] [-m HOST] [-n] [-t TOPIC] [-T TOPIC] [-v]
Read current temperature,illuminance and humidity from i2c sensors and send
them to a MQTT broker.
optional arguments:
-h, --help show this help message and exit
-d DEVICES, --device DEVICES
Specify the devices to probe in the I2C bus. Can be
called many times. (default: None)
-m HOST, --mqtt-host HOST
Specify the MQTT host to connect to. (default:
127.0.0.1)
-n, --dry-run No data will be sent to the MQTT broker. (default:
False)
-t TOPIC, --topic TOPIC
The MQTT topic on which to publish the message (if it
was a success). (default: sensor/i2c)
-T TOPIC, --topic-error TOPIC
The MQTT topic on which to publish the message (if it
wasn't a success). (default: error/sensor/i2c)
-v, --verbose Enable debug messages. (default: False)
```
## Docker
I added a sample Dockerfile, I personaly use it with a `docker-compose.yml` like this one :
```yml
version: '3'
services:
cron-i2c:
build: https://github.com/seblucas/i2c2mqtt.git
image: i2c-python3-cron:latest
restart: always
environment:
CRON_STRINGS: "1,16,31,46 * * * * i2c2mqtt.py -d bh1750 -d bme280 -m mosquitto -t sensor/i2c"
CRON_LOG_LEVEL: 8
devices:
- "/dev/i2c-1:/dev/i2c-1"
```
# Credits
* bme280.py comes from [this repository](https://bitbucket.org/MattHawkinsUK/rpispy-misc/raw/master/python/bme280.py)
* bh1750.py also comes from [this repository](https://bitbucket.org/MattHawkinsUK/rpispy-misc/raw/master/python/bh1750.py)
* si7021.py was mostly written by me.
# License
This program is licenced with GNU GENERAL PUBLIC LICENSE version 3 by Free Software Foundation, Inc.