search

KnowFlow / KnowFlow_AWM

KnowFlow Automatic Water Monitoring device is an open sourced tool enable everyone having access to first hand water quality data with low cost.
86 stars 40 forks source link
citizen-science iot-application water-monitoring water-quality

readme

This branch is for ongoing development

KnowFlow - an open source river quality meter with Arduino

KnowFlow is an open source water monitoring device and an education program.

For the device part, KnowFlow is designed for environmental activists, researchers, students... anyone who wants to know the water quality using low cost and customized tools. It is based on arduino uno and can currently monitor 5 parameters: Temperature, pH, ORP, Electrical conductivity and Dissolved Oxygen. The data is stored on a micro SD card and can be read directly on phone by bluetooth (except for Dissolved Oxygen). All the modules are easy to change or add. Most of the sensors used are from DFRobot and Atlas Scientific, the main 2 sensor suppliers for Arduino users.

For the education program, KnowFlow is an 8 week online course and a learning group hosted on Greenseed Project platform. During the course, we cover the fundamentals of water quality, indicators of water quality, Arduino and monitoring systems and show you how to build your own monitoring system based on Arduino. In addition to the 5 included in the KnowFlow kits, you can add other environmental sensors, such as carbon dioxide, ozone, dust, light, temperature, or humidity sensors, then add GPS and a communication module to connect data from a distance. Step by step demos in the course walk you through the learning process.

This page is a collective information for KnowFlow, it can also be found on github, Youku. Will release this series video tutorial on youtube later soon!

KnowFlow Hardware

A complete list of components, measurements, drawings, and other specifications can be found here. DFRobot also offers a KnowFlow starter kit.

Central Control Unit:

Installing KnowFlow Firmware

KnowFlow is designed for beginners. You don’t need to have experience with Arduino or software development. KnowFlow is packaged wtth supporting software libraries to make it easier for you to enable different sensor features for your application. Feel free to post your software questions on our wiki page on public lab or github.

  1. Download Arduino IDE
  2. Download Knowflow code from github
  3. Open "WaterMonitor.ino" from the downloaded file with Arduino IDE
  4. Connect your Arduino Uno board
  5. Select Tools>Board: Arduino Uno and Tools>Ports: /dev/cu.usb...
  6. Click "Verify" then "Upload" the software to your board.

FAQ

Why can't I verify the code.
The IDE may be missing a library, most often OneWire. Install the missing library library from Sketch->include library->manage libraries. Search "OneWire" then install it.

FAQ

  1. Q:why I can't not verify the code. A:Some user may not verify the code. It's maybe the IDE lack of some library, the most possiable is OneWire. Please find library OneWire in Sketch->include library->manage libraries, searth OneWire then install it. It should be solve the problem.

How to build KnowFlow

Instructions are available here.

How to contribute:

See this tutorial.

  1. Fork the repository!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request

About Branches

master is the current stable release.

development is the research version. It has experimental features that are not fully tested. For example, IOT integrations, new sensors, etc.

test is for the team to practice with github. We will delete when we figure out how to use github. (We are newbees to github, so please forgive any stupid errors. Suggestions are welcome!) :)

To DO List

Contact

Email addresses for the KnowFlow team.

Documents

License

All KnowFlow related materials are released under the Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)

This project has benefited from the support from the following funders: