{"id":23772967,"url":"https://github.com/choaib-elmadi/fluid-level-sensor","last_synced_at":"2026-03-04T07:02:31.171Z","repository":{"id":270516438,"uuid":"910609068","full_name":"Choaib-ELMADI/fluid-level-sensor","owner":"Choaib-ELMADI","description":"Arduino-based water level monitoring system featuring real-time OLED display, voltage-to-level conversion, and interactive graphing capabilities.","archived":false,"fork":false,"pushed_at":"2025-01-01T18:43:04.000Z","size":1915,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-20T12:51:55.373Z","etag":null,"topics":["actuator","arduino","build","cpp","cprogramming","embedded","monitoring","oled","pid","project","projects","sensor","voltage"],"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/Choaib-ELMADI.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-31T19:55:16.000Z","updated_at":"2025-04-17T21:50:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"1d2f592b-6fc6-45b5-bc43-7c53dbacf4bd","html_url":"https://github.com/Choaib-ELMADI/fluid-level-sensor","commit_stats":null,"previous_names":["choaib-elmadi/fluid-level-sensor"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Choaib-ELMADI/fluid-level-sensor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Choaib-ELMADI%2Ffluid-level-sensor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Choaib-ELMADI%2Ffluid-level-sensor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Choaib-ELMADI%2Ffluid-level-sensor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Choaib-ELMADI%2Ffluid-level-sensor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Choaib-ELMADI","download_url":"https://codeload.github.com/Choaib-ELMADI/fluid-level-sensor/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Choaib-ELMADI%2Ffluid-level-sensor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30075425,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T05:31:57.858Z","status":"ssl_error","status_checked_at":"2026-03-04T05:31:38.462Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["actuator","arduino","build","cpp","cprogramming","embedded","monitoring","oled","pid","project","projects","sensor","voltage"],"created_at":"2025-01-01T05:21:34.175Z","updated_at":"2026-03-04T07:02:31.145Z","avatar_url":"https://github.com/Choaib-ELMADI.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Choaib ELMADI - Sensors](https://img.shields.io/badge/Choaib_ELMADI-Sensors-8800dd)](https://elmadichoaib.vercel.app)\n\n# Water Level Monitoring System\n\nThis project demonstrates a water level monitoring system using an ultrasonic sensor and an Arduino. The system measures the water level in a container based on input voltage and displays the height on an OLED screen. Future enhancements include integrating a PID controller for automated water level regulation.\n\n\u003cdiv align=\"center\"\u003e\n\n![Proteus Circuit](./Images/proteus-circuit.png)\n\n\u003c/div\u003e\n\n## Project Structure\n\n```\n.\n├── 3D Models/\n├── Circuit Diagram/\n│ ├── circuit-diagram.png\n│ └── proteus-simulation.pdsprj\n├── Images/\n├── Programs/\n│ ├── Main/\n│ │ └── Main.ino\n│ └── Tests/\n└── README.md\n```\n\n## System Overview\n\nThe water container setup includes:\n\n- **Ultrasonic Sensor**: Positioned at the top of the container, measuring distance using ultrasonic waves.\n- **Water Container**: Marked with height indicators in millimeters.\n- **Input/Output**:\n  - A pipe at the top for filling water.\n  - An opening at the bottom for draining water.\n\n## Hardware Components\n\n- Arduino\n- Ultrasonic water level sensor (output: 0V to 10V)\n- Voltage divider (to scale voltage for Arduino input)\n- OLED display\n- Power supply\n- 3D-printed enclosure\n\n\u003cdiv align=\"center\"\u003e\n\n![Circuit Diagram](./Images/circuit-diagram.png)\n![Project Steps](./Images/steps.png)\n\n\u003c/div\u003e\n\n## How It Works\n\n1. The ultrasonic sensor measures the distance to the water surface and outputs a voltage.\n\n2. The voltage is scaled using a voltage divider to match the Arduino’s input range.\n\n3. The Arduino calculates the water height using the formula derived from measurements.\n\n4. The height and original sensor voltage are displayed on the OLED screen.\n\n## Future Goals\n\n- **PID Controller**: Automate water level regulation by controlling a pump for filling or a valve for draining.\n- **Enhanced Display**: Show additional information such as target level and error margin.\n- **Remote Monitoring**: Add IoT capabilities for remote water level tracking.\n\n## Contributing\n\nContributions are welcome! If you have ideas for improvements or additional features, feel free to open an issue or submit a pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchoaib-elmadi%2Ffluid-level-sensor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchoaib-elmadi%2Ffluid-level-sensor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchoaib-elmadi%2Ffluid-level-sensor/lists"}