{"id":27921548,"url":"https://github.com/shellyda/flowcycle-pump","last_synced_at":"2026-04-28T08:01:44.560Z","repository":{"id":290967778,"uuid":"976119674","full_name":"Shellyda/flowcycle-pump","owner":"Shellyda","description":"Automated 30-Minute Cyclic Pump Controller Using Arduino UNO.","archived":false,"fork":false,"pushed_at":"2025-08-03T19:48:43.000Z","size":75929,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-03T21:06:26.304Z","etag":null,"topics":["arduino","arduino-uno","cientific","cientific-computation","circuit","circuits","dc-motor-control","eletronic","hardware","lcd-display","lcd16x2","leds","protoboard","pump","pump-controller","timer","waterpump"],"latest_commit_sha":null,"homepage":"https://www.tinkercad.com/things/bgQsxN3eTv7-flowcycle-pump","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Shellyda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2025-05-01T14:30:11.000Z","updated_at":"2025-08-03T19:49:41.000Z","dependencies_parsed_at":"2025-08-03T21:13:55.579Z","dependency_job_id":null,"html_url":"https://github.com/Shellyda/flowcycle-pump","commit_stats":null,"previous_names":["shellyda/flowcycle-pump"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Shellyda/flowcycle-pump","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shellyda%2Fflowcycle-pump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shellyda%2Fflowcycle-pump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shellyda%2Fflowcycle-pump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shellyda%2Fflowcycle-pump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Shellyda","download_url":"https://codeload.github.com/Shellyda/flowcycle-pump/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shellyda%2Fflowcycle-pump/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32371672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"online","status_checked_at":"2026-04-28T02:00:07.250Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["arduino","arduino-uno","cientific","cientific-computation","circuit","circuits","dc-motor-control","eletronic","hardware","lcd-display","lcd16x2","leds","protoboard","pump","pump-controller","timer","waterpump"],"created_at":"2025-05-06T21:51:15.540Z","updated_at":"2026-04-28T08:01:44.553Z","avatar_url":"https://github.com/Shellyda.png","language":"C++","readme":"# FlowCycle Pump\n\n**Automated 30-Minute Cyclic Pump Controller Using Arduino UNO**\n\n![FlowCycle Pump Prototype](images/start-view.png)\n\n## Project Overview\n\nThe **FlowCycle Pump** is an Arduino-based controller designed to automate precise cyclic timing intervals for laboratory pump operations. It was developed as part of a scientific study at the Center for Health Sciences (CCS) at the Federal University of Pernambuco (UFPE), Brazil.\n\n### Technical vision\nThis project implements a 30-minute cyclic timer that switches a pump on and off at predefined intervals, providing visual feedback on an LCD and LEDs. The cycle only starts — or restarts — when the user presses the button, allowing flexible pausing during and between runs.\n\n### Scientific Context\n\n| Item | Detail |\n| ---- | ------ |\n| **Research title (pt-br)**  | **“Avaliação da capacidade oncoprotetora do CR35 em um modelo experimental in vivo de câncer de pulmão associado ao tabagismo”** |\n| **Research title (en)**     | **“Oncoprotective capacity of CR35 in an _in‑vivo_ cigarette‑smoke‑associated lung‑cancer model”** |\n| **Scientific goal**         | Evaluate whether the thiazolidine‑2,4‑dione derivative **CR35** can prevent lung‑tumor formation in mice exposed to cigarette smoke and urethane, and investigate whether this protection involves modulation of the inflammasome pathway. |\n| **Circuit need**            | Automation the repetitive manual dosing procedures required by researchers, improving experimental consistency and freeing researchers from manual intervention.|\n\n## Interactive Circuit Diagram\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/FlowCycle_Pump_Demo.gif\" alt=\"FlowCycle Pump - Operation Demo GIF\" width=\"700\"\u003e\n\u003c/p\u003e\n\nExplore and simulate the circuit directly on Tinkercad: \n- [Tinkercad FlowCycle Pump Project](https://www.tinkercad.com/things/bgQsxN3eTv7-flowcycle-pump)\n\n## Table of Contents\n\n- [Project Overview](#project-overview)\n  - [Technical Vision](#technical-vision)\n  - [Scientific Context](#scientific-context)\n- [Interactive Circuit Diagram](#interactive-circuit-diagram)\n- [Features](#features)\n- [Repository Structure](#repository-structure)\n- [Getting Started](#getting-started)\n  - [Hardware Assembly](#hardware-assembly)\n  - [Uploading the Firmware](#uploading-the-firmware)\n  - [Operating Instructions](#operating-instructions)\n- [Bill of Materials](#bill-of-materials)\n- [Project Roadmap](#project-roadmap)\n- [References and Inspiration](#references-and-inspiration)\n- [License](#license)\n\n## Features\n\n- **Automated Timing:** Precise pump cycling intervals (default: 2 seconds ON / 30 seconds OFF for 30 minutes).\n- **Flexible Pausing:** Pause cycle during and between runs, which also will inform at what time did you pause it.\n- **One-button Operation:** Simple user interface for starting and restarting cycles.\n- **LCD Feedback:** Real-time status updates and countdown timers (MM:SS format).\n- **LED Indicators:** Visual status indication (Green LED: Pump ON, Red LED: Pump OFF, Yellow LED: End of 30 minutes cycle and Pause state).\n- **Isolated Power Supply:** Dedicated 6×AA battery pack for the pump ensures reliable operation without interference.\n\n## Repository Structure\n\n```\nflowcycle-pump/\n├── README.md\n├── src/\n│   └── FlowCyclePump.ino\n│   └── display-liquid-crystal-for-4-pins/main.ino\n├── images/\n│   └── Circuit prototype layout images \n├── docs/\n│   └── Schematic_View.pdf\n└── Component_List.csv\n```\n\n## Getting Started\n\n### Hardware Assembly\n\nFollow the detailed schematic and layout provided in:\n\n- **Schematic PDF:** [docs/Schematic_View.pdf](https://github.com/Shellyda/flowcycle-pump/blob/f4197e52466bc491275a64fc59c0bba13ee9d35c/docs)\n- **Breadboard Layout:** [images/circuit-off.png](https://github.com/Shellyda/flowcycle-pump/blob/f4197e52466bc491275a64fc59c0bba13ee9d35c/images/circuit-off.png)\n\n### Uploading the Firmware\n\n1. Clone this repository:\n\n```bash\ngit clone https://github.com/Shellyda/flowcycle-pump.git\n```\n\n2. Open [FlowCyclePump.ino](https://github.com/Shellyda/flowcycle-pump/blob/f4197e52466bc491275a64fc59c0bba13ee9d35c/src) or [display-liquid-crystal-for-4-pins/main.ino](https://github.com/Shellyda/flowcycle-pump/blob/main/src/display-liquid-crystal-for-4-pins/main.ino) from the `src` folder in Arduino IDE.\n3. Upload the sketch to your Arduino UNO.\n\n### Operating Instructions\n\n- Press the push-button once to initiate the automatic cycle (default: 2 seconds ON / 30 seconds OFF for 30 minutes).\n- After the cycle ends (30 minutes), the system waits 1 minute and then prompts the user to restart by pressing the button again.\n\n## Bill of Materials\n\nSee the included file [Component_List.csv](https://github.com/Shellyda/flowcycle-pump/blob/f4197e52466bc491275a64fc59c0bba13ee9d35c/Component_List.csv) for detailed part specifications and sourcing.\n\n| Qty | Component                            | Description                 |\n|-----|--------------------------------------|-----------------------------|\n| 1   | Arduino UNO R3                       | Microcontroller board       |\n| 1   | nMOS Transistor (MOSFET)             | Low-side pump control       |\n| 1   | DC Motor                             | Simulate pump in circuit    |\n| 1   | LCD 16×2 (Parallel)                  | Display status messages     |\n| 3   | LED indicators (green/red/yellow)    | State visualization         |\n| 1   | Momentary push-button                | User interaction            |\n| 1   | 4 batteries, AA, no 1.5V Battery     | Independent pump power      |\n| 4   | 220 Ω Resistor                       | General assembly part       |\n| 1   | 250 kΩ Potentiometer                 | General assembly part       |\n| 1   | 10 kΩ Resistor                       | General assembly part       |\n\n## Project Roadmap\n### Phase 01 - First prototype of everything on the breadboard and 3D printed box model\n\u003cp float=\"left\"\u003e\n  \u003cimg src=\"images/physical-prototype/prototype-phase01.png\" width=\"45%\" /\u003e\n  \u003cimg src=\"images/physical-prototype/prototype-box-printed-for-phase02.png\" width=\"45%\" /\u003e\n\u003c/p\u003e\n\n### Phase 02 - More tests with the circuit and starting system boarding process\n\u003cp float=\"left\"\u003e\n  \u003cimg src=\"images/physical-prototype/prototype-protoboard-phase01.png\" width=\"45%\" /\u003e\n  \u003cimg src=\"images/physical-prototype/prototype-box-phase02.JPG\" width=\"45%\" /\u003e\n\u003c/p\u003e\n\n### Phase 03 - Final embedded system\n\u003cp float=\"left\"\u003e\n  \u003cimg src=\"images/physical-prototype/prototype-final-phase-embedded.png\" width=\"45%\" /\u003e\n  \u003cimg src=\"images/physical-prototype/prototype-final-phase.png\" width=\"45%\" /\u003e\n\u003c/p\u003e\n\n**Prototype completed on 07/31/2025 🥳**\n\n**Planned and Done:**\n- Physical assembly and validation of the prototype.\n- Extensive testing within experimental protocols.\n- Evaluation and reporting of system reliability and accuracy.\n\n## References and Inspiration\n\n- [Arduino-Based Timer for Aquaponics Pump](https://www.instructables.com/Arduino-Based-Timer-for-Aquaponics-Pump/)\n- [Pomodoro-Style Study Clock - Science Buddies](https://www.sciencebuddies.org/science-fair-projects/project-ideas/Elec_p099/electricity-electronics/pomodoro-study-clock?ytid=xf4Bnm8edAg\u0026ytsrc=description)\n- Video demonstrations:\n    - [Video 1](https://youtu.be/_ioq39_vOBU?si=2O4Xa6TVV56mM3De)\n    - [Video 2](https://youtu.be/To3DKP99-1U?si=MDcQplFYucp0QRMs)\n    - [Video 3](https://youtu.be/XrJ_zLWFGFw?si=tFG6foOzemvXDcbl)\n\n## License\n\nThis project is licensed under the MIT License. See `LICENSE` for more information.\n\n---\n\n\u003e FlowCycle Pump is open-source hardware developed to enhance scientific research. You are welcome to fork this repository, open issues, pullrequests and contribute!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshellyda%2Fflowcycle-pump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshellyda%2Fflowcycle-pump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshellyda%2Fflowcycle-pump/lists"}