{"id":13804151,"url":"https://github.com/rbaron/b-parasite","last_synced_at":"2025-12-24T04:24:55.274Z","repository":{"id":37416770,"uuid":"337864647","full_name":"rbaron/b-parasite","owner":"rbaron","description":"🌱💧 An open source DIY soil moisture sensor","archived":false,"fork":false,"pushed_at":"2024-11-08T17:59:11.000Z","size":29572,"stargazers_count":1945,"open_issues_count":35,"forks_count":151,"subscribers_count":43,"default_branch":"main","last_synced_at":"2024-11-08T18:42:18.802Z","etag":null,"topics":["ble","bluetooth-low-energy","iot","nrf52","sensor","soil-moisture","soil-moisture-sensor"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rbaron.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-10T21:56:33.000Z","updated_at":"2024-11-08T17:59:17.000Z","dependencies_parsed_at":"2023-02-18T22:46:03.683Z","dependency_job_id":"08d8386b-a9f7-4fb2-a475-57379f7b19cd","html_url":"https://github.com/rbaron/b-parasite","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rbaron%2Fb-parasite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rbaron%2Fb-parasite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rbaron%2Fb-parasite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rbaron%2Fb-parasite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rbaron","download_url":"https://codeload.github.com/rbaron/b-parasite/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225247844,"owners_count":17444122,"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":["ble","bluetooth-low-energy","iot","nrf52","sensor","soil-moisture","soil-moisture-sensor"],"created_at":"2024-08-04T01:00:42.781Z","updated_at":"2025-12-24T04:24:55.229Z","avatar_url":"https://github.com/rbaron.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"[![b-parasite firmware build](https://github.com/rbaron/b-parasite/actions/workflows/b-parasite.yml/badge.svg?branch=main)](https://github.com/rbaron/b-parasite/actions/workflows/b-parasite.yml)\n\n# b-parasite\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"img/resized/b-parasite-2.0.0.jpg\" width=\"512px\" border=\"0\" alt=\"PCB front and back photo\" /\u003e\n\u003c/p\u003e\n\nb-parasite is an open source soil moisture and ambient temperature/humidity/light sensor.\n\n# Features\n* Capacitive Soil moisture sensor - see [this blog post](https://rbaron.net/blog/2021/04/05/How-capacitive-soil-moisture-sensors-work.html), [this Twitter thread](https://twitter.com/rbaron_/status/1367182806368071685), and [this post](https://wemakethings.net/2012/09/26/capacitance_measurement/) for nice resources on how they work\n* Air temperature and humidity sensor using a [Sensirion's SHTC3](https://www.sensirion.com/en/environmental-sensors/humidity-sensors/digital-humidity-sensor-shtc3-our-new-standard-for-consumer-electronics/)\n* Light sensor using an [ALS-PT19](https://en.everlight.com/wp-content/plugins/ItemRelationship/product_files/pdf/ALS-PT19-315C-L177-TR8_V8.pdf) phototransistor\n* Powered by a common CR2032 coin cell, potentially for over two years\n* Support for [nRF52840](https://www.nordicsemi.com/products/nrf52840) and [nRF52833](https://www.nordicsemi.com/products/nrf52833) modules\n* Open hardware and open source design\n\n# Software\nThis repository also hosts a few different firmware samples for b-parasite.\n\n|Sample|Description|Extra Documentation|\n|---|---|---|\n|[samples/ble](./code/nrf-connect/samples/ble)|This is the most battle-tested and useful firmware. It periodically reads all sensors and broadcast them via Bluetooth Low Energy (BLE). It works with [Home Assistant](https://www.home-assistant.io/) + [BTHome](https://bthome.io/) out of the box. |[Docs](./code/nrf-connect/samples/ble/README.md)|\n|[samples/zigbee](./code/nrf-connect/samples/zigbee)| An experimental/educational/exploratory basic Zigbee sample built on [nRF Connect + ZBOSS](https://developer.nordicsemi.com/nRF_Connect_SDK/doc/latest/nrf/ug_zigbee.html). It integrates with [Home Assistant](https://www.home-assistant.io/) via [ZHA](https://www.home-assistant.io/integrations/zha) or [Zigbee2MQTT](https://www.zigbee2mqtt.io/). |[Docs](./code/nrf-connect/samples/zigbee/README.md)|\n|[samples/blinky](./code/nrf-connect/samples/blinky)| The classic \"Hello, world\" |-|\n|[samples/soil_read_loop](./code/nrf-connect/samples/soil_read_loop)| Reads the soil moisture sensor on a loop. Useful for experimenting and calibrating the sensor. |-|\n|[samples/input](./code/nrf-connect/samples/input)| Handles button presses. Useful for power profiling GPIO interrupts and testing debouncing for push switches on [boards that have them](https://github.com/rbaron/b-parasite/wiki/Hardware-Versions). |-|\n\n# Documentation\nInformation about how to order, assemble, build the samples, protect the sensor and flash the firmware is on [the Wiki](https://github.com/rbaron/b-parasite/wiki).\n\n# Repository Organization\n* [code/nrf-connect/](./code/nrf-connect/) - Common library and samples, built with Nordic's [nRF Connect SDK](https://www.nordicsemi.com/Products/Development-software/nrf-connect-sdk).\n* [kicad/](./kicad/) - KiCad schematic, layout and fabrication files for the printed circuit board (PCB)\n* [data/](data/) - data for testing and sensor calibration\n* [bridge/](bridge/) - an [ESPHome](https://github.com/esphome/esphome)-based BLE-MQTT bridge\n* [case/](case/) - a 3D printable case\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"img/resized/img2.jpg\" border=\"0\" alt=\"b-parasite stuck into a small plant vase\" /\u003e\n\u003c/p\u003e\n\n# Case\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"img/case/screenshot.png\" alt=\"Render of the original 3D printable case\" /\u003e\n\u003c/p\u003e\n\nWe have three different 3D-printable cases:\n1. Original snap-on case - [case/Top.stl](./case/Top.stl), [case/Bottom.stl](./case/Bottom.stl)\n2. High airflow - [case/b_parasite_case_high_airflow.stl](./case/b_parasite_case_high_airflow.stl)\n3. Mushroom-style - available on [Printables](https://www.printables.com/model/456571-mushroomcap-for-b-parasite-soil-moisture-sensor)\n4. b-parasite Hat - available on [Printables](https://www.printables.com/model/901220-waterproof-case-for-b-parasite-soil-moisture-air-s)\n\n# Accessories\n\nDesigns and hardware to help you, when building your own:\n1. Desk holder for b-parasites [Printables](https://www.printables.com/de/model/566974-b-parasite-holder)\n\n# License\nThe hardware and associated design files are released under the [Creative Commons CC BY-SA 4.0 license](https://creativecommons.org/licenses/by-sa/4.0/).\nThe code is released under the [MIT license](https://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frbaron%2Fb-parasite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frbaron%2Fb-parasite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frbaron%2Fb-parasite/lists"}