b-parasite is an open source Bluetooth Low Energy (BLE) soil moisture and ambient temperature/humidity/light sensor.
- Soil moisture sensor. I wrote about how capacitive soil moisture sensors works on this Twitter thread, based on this great post on wemakethings.net
- Air temperature and humidity sensor using a Sensirion's SHTC3
- Light sensor using an ALS-PT19 phototransistor
- Powered by a common CR2032 coin cell, with a battery life of possibly over a year - see "Battery Life" below
- Open hardware and open source design
- code/b-parasite/ - firmware code based on the nRF5 SDK
- kicad/ - KiCad schematic, layout and fabrication files for the printed circuit board (PCB)
- data/ - data for testing and sensor calibration
- bridge/ - an ESPHome-based BLE-MQTT bridge
- case/ - a 3D printable case
b-parasite works by periodically measuring the soil moisture, air temperature/humidity and broadcasting those values via Bluetooth Low Energy (BLE) advertisement packets. After doing so, the board goes into a sleep mode until it's time for another measurement. The sleep interval is configurable - I often use 10 minutes between readings, which is a good compromise between fresh data and saving battery.
At this point, b-parasite's job is done. We have many possibilities of how to capture its BLE advertisement packet and what to do with the data. A common pattern is having a BLE-MQTT bridge that listens for these BLE broadcasts, decodes them and ships the sensor values through MQTT messages. The MQTT broker is then responsible for relaying the sensor data to interested parties. This is the topology shown in the diagram above.
A popular choice for a BLE-MQTT bridge is the ESPHome project, which runs on our beloved ESP32 boards. b-parasite is officially supported and documentation for using it can be found in the b-parasite ESPHome docs. An example of using this platform is also available in this repo, under bridge/ (check out README.md there for more info).
ESPHome is a battle-tested project with a vibrant community, and is currently the most mature b-parasite bridge. ESP32 are also cheap, so you can sprinkle a few of them around the house to cover a wide range, and even share the same ESP32 with other sensors.
b-parasite is supported by the ble_monitor Home Assistant custom component - please refer to the docs. This custom component gets Home Assistant to automatically discover nearby b-parasites based on their advertisement data.
Another possibility is running parasite-scanner. It is a purpose-built bridge for b-parasites, and runs on Linux and macOS.
This is the quickest way to collect and visualize data from b-parasites, and I personally use it a lot for testing and debugging.
Sensor data is transmitted via BLE advertisement broadcasts. Here you can find a byte-by-byte description of the data as it is encoded inside the advertisement packet.
tl;dr: By taking readings 10 minutes apart, the battery should last for over a couple of years.
The main parameters involved in estimating the battery life are:
- Current consumption (both in operation and during sleep)
- Duty cycle (how much time it spends in operation vs. sleeping)
- Battery capacity - this is roughly 200 mAh for CR2032 cells
Details and power comsumption measurements in the #48. This spreadsheet can be used to estimate battery life for different parameters.
A 3D printable case model can be found in case/.
The hardware and associated design files are released under the Creative Commons CC BY-SA 4.0 license. The code is released under the MIT license.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent