{"id":13949104,"url":"https://github.com/KnowFlow/KnowFlow_AWM","last_synced_at":"2025-07-20T11:30:52.101Z","repository":{"id":43764844,"uuid":"93705141","full_name":"KnowFlow/KnowFlow_AWM","owner":"KnowFlow","description":"KnowFlow Automatic Water Monitoring device is an open sourced tool enable everyone having access to first hand water quality data with low cost.","archived":false,"fork":false,"pushed_at":"2020-12-24T08:01:22.000Z","size":10818,"stargazers_count":89,"open_issues_count":8,"forks_count":41,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-06-22T16:40:47.415Z","etag":null,"topics":["citizen-science","iot-application","water-monitoring","water-quality"],"latest_commit_sha":null,"homepage":null,"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/KnowFlow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-06-08T03:50:23.000Z","updated_at":"2025-05-04T04:29:56.000Z","dependencies_parsed_at":"2022-09-17T00:10:26.757Z","dependency_job_id":null,"html_url":"https://github.com/KnowFlow/KnowFlow_AWM","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/KnowFlow/KnowFlow_AWM","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KnowFlow%2FKnowFlow_AWM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KnowFlow%2FKnowFlow_AWM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KnowFlow%2FKnowFlow_AWM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KnowFlow%2FKnowFlow_AWM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KnowFlow","download_url":"https://codeload.github.com/KnowFlow/KnowFlow_AWM/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KnowFlow%2FKnowFlow_AWM/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261952893,"owners_count":23235438,"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":["citizen-science","iot-application","water-monitoring","water-quality"],"created_at":"2024-08-08T05:01:38.408Z","updated_at":"2025-07-20T11:30:52.079Z","avatar_url":"https://github.com/KnowFlow.png","language":"C","funding_links":[],"categories":["Access and Monitoring of Resources","Natural Resources"],"sub_categories":["Water","Water Supply and Quality"],"readme":"\n\nThis branch is for ongoing development\n\n\n# KnowFlow - an open source river quality meter with Arduino\n\nKnowFlow is an open source water monitoring device and an education program.\n\n![](https://publiclab.org/system/images/photos/000/020/692/large/BOM.JPG)\n\n\n\nFor the device part, KnowFlow is designed for environmental activists, researchers, students... anyone\nwho wants to know the water quality using low cost and customized tools. It is based on arduino uno and \ncan currently monitor 5 parameters: Temperature, pH, ORP, Electrical conductivity and Dissolved Oxygen. \nThe data is stored on a micro SD card and can be read directly on phone by bluetooth (except for Dissolved Oxygen). \nAll the modules are easy to change or add. Most of the sensors used are from DFRobot and Atlas Scientific, \nthe main 2 sensor suppliers for Arduino users.\n\n![](https://publiclab.org/system/images/photos/000/020/719/large/Lauren_Field_Test.jpg)\n\nFor the education program, KnowFlow is an 8 week online course and a learning group hosted on \nGreenseed Project platform. During the course, we cover the fundamentals of water quality, indicators of water quality, \nArduino and monitoring systems and show you how to build your own monitoring system based on Arduino. In addition to \nthe 5 included in the KnowFlow kits, you can add other environmental sensors, such as carbon dioxide, ozone, \ndust, light, temperature, or humidity sensors, then add GPS and a communication module to connect data from a distance. \nStep by step demos in the course walk you through the learning process.\n\nThis page is a collective information for KnowFlow, it can also be found on github, [Youku](http://v.youku.com/v_show/id_XMTYzNTA1NzU1Mg==.html?spm=a2hzp.8253876.0.0\u0026f=27620513).\nWill release this series video tutorial on youtube later soon!\n\n\n\n## KnowFlow Hardware \n\nA complete list of components, measurements, drawings, and other specifications can be found [here](https://docs.google.com/spreadsheets/d/1rwVUIwqTOvZiKi_0vdBPrXMIw2YB-nsFnhaVy5seE-M).\nDFRobot also offers a [KnowFlow starter kit.](https://www.dfrobot.com/product-1649.html)\n\n#### Central Control Unit: \n* Arduino Uno (DFRobot Bluno in this case) and \n* Expansion Shield (DFRobot Expansion Shield V7.1 in this case)  \n* real time clock circuit board\n#### Water Sensors: \n* pH (pH probe and pH circuit board)\n* EC (EC probe and EC circuit board)\n* ORP (ORP probe and ORP circuit board)\n* Temperature (temperature probe and temperature circuit board)\n* Dissolved Oxygen (DO probe, BNC and circuit board)\n#### Data Storage:\n* Micro-SD module\n* Micro SD card\n#### Fit and finish:\n* Mounting plate\n* Water proof box(200mm_150mm_75mm)\n* Water proof bushing\n#### Other parts: \n* Wires\n* Bread board\n* Bolts and nuts\n* Screws\n* Battery\n* Double-sided adhesive\n* Write on tape\n* Basic hand tools\n* Spiral cable wrap \n\n## Installing KnowFlow Firmware\nKnowFlow is designed for beginners. You don’t need to have experience with Arduino or software development. \nKnowFlow is packaged wtth supporting software libraries to make it easier for you to enable different sensor features \nfor your application. Feel free to post your software questions on our wiki page on public lab or github.\n\n1. Download Arduino IDE\n1. Download Knowflow code from [github](https://github.com/KnowFlow/KnowFlow_AWM)\n1. Open \"WaterMonitor.ino\" from the downloaded file with Arduino IDE\n1. Connect your Arduino Uno board\n1. Select Tools\u003eBoard: Arduino Uno and Tools\u003ePorts: /dev/cu.usb...\n1. Click \"Verify\" then \"Upload\" the software to your board.\n\n## FAQ\n**Why can't I verify the code.**  \nThe IDE may be missing a library, most often OneWire. \nInstall the missing library library from Sketch-\u003einclude library-\u003emanage libraries. Search \"OneWire\" then install it.\n\n## FAQ\n1. Q:why I can't not verify the code.\nA:Some user may not verify the code.\nIt's maybe the IDE lack of some library, the most possiable is OneWire. \nPlease find library OneWire in Sketch-\u003einclude library-\u003emanage libraries, searth OneWire then install it.\nIt should be solve the problem.\n\n\n## How to build KnowFlow \nInstructions are available [here.](https://publiclab.org/notes/shanlter/06-08-2017/knowflow-automatic-water-meter)\n\n## How to contribute:\nSee this [tutorial.](https://help.github.com/articles/creating-a-pull-request/)\n1. Fork the repository!\n1. Create your feature branch: git checkout -b my-new-feature\n1. Commit your changes: git commit -am 'Add some feature'\n1. Push to the branch: git push origin my-new-feature\n1. Submit a pull request\n \n## About Branches\n**master** is the current stable release.\n\n**development** is the research version. It has experimental features that are not fully tested. For example, IOT\nintegrations, new sensors, etc.\n\n\n**test** is for the team to practice with github. We will delete when we figure out how to use github. (We are newbees\nto github, so please forgive any stupid errors. Suggestions are welcome!) :)\n\n\n## To DO List\n- [x] support DO Senser from DFRobot.\n- [ ] add youtube video tutorial.\n- [ ] Website setup. www.knowflow.org\n- [x] Modify the construction of the files system.\n- [ ] IOT feature.\n- [ ] Calibration function\n- [ ] Low power function\n\n## Contact\n\nEmail addresses for the KnowFlow team.\n\n* Rockets \u003cRockets.xia@dfrobot.com\u003e\n* He Shan  \u003cshanh0510@gmail.com\u003e\n* Lauren \u003cLauren.pan@hotmail.com\u003e\n* Jason \u003cjason.liang@dfrobot.com\u003e\n\n\n\n## Documents\n\n * [Tutorial][1]\n * [GreenSeed online courses][2]\n * [Application:非洲茶园水质调研][3]\n * [Application:Willow Creek Water Quality Monitoring][4]\n * [KnowFlow Special Design][6]\n\n## License\n\nAll KnowFlow related materials are released under the [Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)][5]\n\n## This project has benefited from the support from the following funders:\n\n* GreenSeed Foundation\n* Mushroom Cloud Maker Space\n\n  [1]: https://publiclab.org/notes/shanlter/06-08-2017/knowflow-automatic-water-meter\n  [2]: http://blog.sina.com.cn/s/blog_9f86b6d50102w9m1.html\n  [3]: http://www.dfrobot.com.cn/community/thread-26733-1-1.html\n  [4]: https://publiclab.org/notes/MadTinker/07-31-2017/willow-creek-water-quality-monitoring\n  [5]: https://creativecommons.org/licenses/by-nc-sa/4.0/\n  [6]:https://www.instructables.com/id/KnowFlow-Special-Design/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKnowFlow%2FKnowFlow_AWM","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FKnowFlow%2FKnowFlow_AWM","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKnowFlow%2FKnowFlow_AWM/lists"}