Awesome
Ribbit Network Frog Sensor
Ribbit Network is a large network of open-source, low-cost, Greenhouse Gas (CO2 and hopefully other gasses in the future) Detection Sensors. These sensor units will be sold by the Ribbit Network and will upload their data to the cloud, creating the world's most complete Greenhouse Gas dataset.
This repository contains the design files, software, documentation, and assembly instructions for the Frog Sensor.
Frog Sensors
Our “Frogs” are tiny sensors that you can build and deploy at your own home! It’s a small, open-source device that measures the amount of CO2 in the air using a tiny laser. It's easy to set up and will constantly record valuable scientific data on our climate.
Frogs are one of the species that are most affected by climate change! Just like our sensors, they ribbit to one another to create a powerful network of data about the environment.
Build a Frog!
We encourage you to jump in and build your own Frog Sensor! It's recommended to build a V4 Frog and the instructions from this repo are rendered into a nice webpage at the link below:
There have been four major versions of the Frog Sensor to date. We currently recommend building version 4 of the Frog and this repo contains the files and instructions relevant to V4.
- Frog Sensor Version 4 - This version of the sensor is based on an esp32 microcontroller.
- Frog Sensor Version 3 - This version is based on a Raspberry Pi CM4 and includes a fully 3D printed enclosure.
- Frog Sensor Version 2 - This version is based on a Beaglebone black and includes a fully 3D printed enclosure.
- Frog Sensor Version 1 - This version was based on the Raspberry Pi and included an off-the-shelf enclosure
See each folder linked above for the relevant design files, CAD, and assembly instructions!
Need Help?
If you are not sure where to start or just want to chat join our developer discord here.. You can also start a discussion right here in Github.
View the Data!
The first prototype sensors are up and running! Here is some real data from our sensor network! (Note this dashboard is still experimental and may be down occasionally).
See more about the cloud database here.
Questions?
Check out the Frequently Asked Questions section. If you don't see your question, let us know either in a Github Discussion or via Discord.
Ribbit Frog V4
This is the hardware repository that contains all the design files for the physical assembly of the Frog Sensor.
Bill of Materials (Parts List)
The hardware Bill of Materials is located here.
Mechanical CAD Files
The mechanical design files are hosted on Onshape. Onshape is available to use for free with public assemblies and you can create a copy of the assembly for any edits you would like to make.
Electronics Block Diagram
The diagram above can be edited with drawio or with the awesome Draw.io Visual Studio Code Plugin
Get Involved
Are you interested in getting more involved or leading an effort in the Ribbit Network project? We are recruiting for additional members to join the Core Team. See the Open Roles and descriptions here..
Contributing
See the Issues section of this project for the work that I've currently scoped out to be done. Reach out to me if you are interested in helping out! The projects section helps detail the major efforts going on right now.
We have a contributing guide that details the process for making a contribution.
If you are not sure where to start or just want to chat join our developer discord here.. You can also start a discussion right here in Github.
Background Information
See the Wiki for background research. This project is inspired by some awesome research by incredible scientists in academia.
<img src="images/frog_sensor_canyon.jpeg" width="600">Ribbit Network
Ribbit Network is a non-profit (501c3) creating the world's largest Greenhouse Gas Emissions dataset that will empower anyone to join in the work on climate and provide informed data for climate action. We're an all volunteer team building everything we do in the open-source community.
If you would like to consider sponsoring Ribbit Network you can do via this link. The money is used to pay for software fees, purchase R&D hardware and generally support the mission of Ribbit Network.
Ribbit Network Code of Conduct
By participating in this project, you agree to follow the <a href="https://ribbitnetwork.notion.site/Ribbit-Network-Code-of-Conduct-and-anti-harassment-policy-cc998ef83e7d4ae7abc95508ee6f2b0d">Ribbit Network Code of Conduct and Anti-Harassement Policy</a>. Violations can be reported anonymously by filling out this <a href="https://docs.google.com/forms/d/e/1FAIpQLSemQSAER8az1lNGoWkL1udsv6O8oPc1WQ3dvQ0b9fJSSMeetQ/viewform">form</a>.
Contributors ✨
Thanks goes to these wonderful people (emoji key):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tbody> <tr> <td align="center"><a href="https://www.linkedin.com/in/ericaudiffred/"><img src="https://avatars.githubusercontent.com/u/88562047?v=4?s=100" width="100px;" alt="Eric Audiffred"/><br /><sub><b>Eric Audiffred</b></sub></a><br /><a href="#design-eaudiffred" title="Design">🎨</a> <a href="#ideas-eaudiffred" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=eaudiffred" title="Tests">⚠️</a></td> <td align="center"><a href="https://github.com/djgood"><img src="https://avatars.githubusercontent.com/u/25231050?v=4?s=100" width="100px;" alt="Desmond Good"/><br /><sub><b>Desmond Good</b></sub></a><br /><a href="#ideas-djgood" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=djgood" title="Code">💻</a> <a href="#projectManagement-djgood" title="Project Management">📆</a></td> <td align="center"><a href="http://laurencewatson.com"><img src="https://avatars.githubusercontent.com/u/1125376?v=4?s=100" width="100px;" alt="Laurence Watson"/><br /><sub><b>Laurence Watson</b></sub></a><br /><a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=Rabscuttler" title="Tests">⚠️</a> <a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=Rabscuttler" title="Documentation">📖</a> <a href="#ideas-Rabscuttler" title="Ideas, Planning, & Feedback">🤔</a> <a href="#projectManagement-Rabscuttler" title="Project Management">📆</a></td> <td align="center"><a href="https://spestana.github.io/"><img src="https://avatars.githubusercontent.com/u/650301?v=4?s=100" width="100px;" alt="Steven Pestana"/><br /><sub><b>Steven Pestana</b></sub></a><br /><a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=spestana" title="Documentation">📖</a> <a href="#ideas-spestana" title="Ideas, Planning, & Feedback">🤔</a> <a href="#data-spestana" title="Data">🔣</a> <a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=spestana" title="Tests">⚠️</a> <a href="#financial-spestana" title="Financial">💵</a></td> <td align="center"><a href="https://github.com/sanfk2"><img src="https://avatars.githubusercontent.com/u/40070155?v=4?s=100" width="100px;" alt="sanfk2"/><br /><sub><b>sanfk2</b></sub></a><br /><a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=sanfk2" title="Code">💻</a></td> <td align="center"><a href="https://github.com/eren-rudy"><img src="https://avatars.githubusercontent.com/u/25554568?v=4?s=100" width="100px;" alt="Eren Rudy"/><br /><sub><b>Eren Rudy</b></sub></a><br /><a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=eren-rudy" title="Tests">⚠️</a> <a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=eren-rudy" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/daveb377"><img src="https://avatars.githubusercontent.com/u/9794268?v=4?s=100" width="100px;" alt="David Bengtson"/><br /><sub><b>David Bengtson</b></sub></a><br /><a href="#ideas-daveb377" title="Ideas, Planning, & Feedback">🤔</a> <a href="#projectManagement-daveb377" title="Project Management">📆</a></td> </tr> <tr> <td align="center"><a href="https://www.linkedin.com/in/lancebantoto/"><img src="https://avatars.githubusercontent.com/u/7238692?v=4?s=100" width="100px;" alt="Lance Bantoto"/><br /><sub><b>Lance Bantoto</b></sub></a><br /><a href="#ideas-lwbantoto" title="Ideas, Planning, & Feedback">🤔</a> <a href="#projectManagement-lwbantoto" title="Project Management">📆</a></td> <td align="center"><a href="https://github.com/kevinjmiller2"><img src="https://avatars.githubusercontent.com/u/69079270?v=4?s=100" width="100px;" alt="Kevin Miller"/><br /><sub><b>Kevin Miller</b></sub></a><br /><a href="#ideas-kevinjmiller2" title="Ideas, Planning, & Feedback">🤔</a> <a href="#content-kevinjmiller2" title="Content">🖋</a></td> <td align="center"><a href="https://balena.io"><img src="https://avatars.githubusercontent.com/u/173156?v=4?s=100" width="100px;" alt="Marc Pous"/><br /><sub><b>Marc Pous</b></sub></a><br /><a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=mpous" title="Tests">⚠️</a></td> <td align="center"><a href="https://abesto.net"><img src="https://avatars.githubusercontent.com/u/59982?v=4?s=100" width="100px;" alt="Zoltán Nagy"/><br /><sub><b>Zoltán Nagy</b></sub></a><br /><a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=abesto" title="Code">💻</a></td> <td align="center"><a href="https://github.com/eliasfallon"><img src="https://avatars.githubusercontent.com/u/19410965?v=4?s=100" width="100px;" alt="eliasfallon"/><br /><sub><b>eliasfallon</b></sub></a><br /><a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=eliasfallon" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/rhampt"><img src="https://avatars.githubusercontent.com/u/6423385?v=4?s=100" width="100px;" alt="Ryan"/><br /><sub><b>Ryan</b></sub></a><br /><a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=rhampt" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/akhilgupta1093"><img src="https://avatars.githubusercontent.com/u/40708117?v=4?s=100" width="100px;" alt="akhilgupta1093"/><br /><sub><b>akhilgupta1093</b></sub></a><br /><a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=akhilgupta1093" title="Code">💻</a></td> </tr> <tr> <td align="center"><a href="https://github.com/pascaljoly"><img src="https://avatars.githubusercontent.com/u/17581648?v=4?s=100" width="100px;" alt="outdoorclone"/><br /><sub><b>outdoorclone</b></sub></a><br /><a href="https://github.com/Ribbit-Network/ribbit-network-frog-hardware/commits?author=pascaljoly" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/muditprotect3d"><img src="https://avatars.githubusercontent.com/u/106998016?v=4?s=100" width="100px;" alt="Mudit Agrawal"/><br /><sub><b>Mudit Agrawal</b></sub></a><br /><a href="#design-muditprotect3d" title="Design">🎨</a></td> </tr> </tbody> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->This project follows the all-contributors specification. Contributions of any kind welcome!