Automatic Sprinkler

The project is intended to let your plant to survive while you are on holiday and you do not have any intention to buy built-in mechanism that prevent you to expand and adjust the system to your needs.

If you find this project it means that you are going to build it :)

Getting started

Folder Structure

The Repository is structure so that:

Folder	Content description
/3d_files	It contans all the stl files that you need to print for the project.
/Board	It contains the reference schematics of the PCB
/Board/Production/	It contains the different files for fabrication or editing
/SourceCode	It contains all the developend source code
/SourceCode/src/ + sprinkler.py	It is the code needed for the Raspberry Pi Pico W to control the PCB board. The src folder has to be uploaded on the microcontroller while the sprinkerl.py can be executed locally for tests or uploaded on the target as well.
/SourceCode/Scripts/	It contains some tests that can be executed to test the wiring.

Bill of Material for the PCB and water buffer.

Item #	Description	Quantity	Cost ~€/piece	Reference
1	Raspberry Pi Pico w	1	5,08	Link
2	Multiplexer analogico CD74HC4067	2	1,30	Link
3	Relay 3V with Optocoupler	7	3,60	Link
4	Buck converter	1	2,20	Link
5	JST-XH 2,54mm 3pin	7	n/a	Link
6	JST-XH 2,54mm 2pin	7	n/a	Link
7	Diode IN4001	7	n/a	Link
8	Mini water pumps 3V/5V	7	2,20	Link
9	Pin header connector female	Some	10	Link
10	DC connector DC-0055.5x2.1mm	1	0,10	Link
11	Power supply 5V 2A	1	7,00	Link
12	Power switch 5V	1	n/a	Link
13	(optional) Led green	2	n/a	Link
14	(optional) Box case	1	n/a	3d_file
15	(optional) Box case cover	1	n/a	3d_file
16	Water frame buffer	1	n/a	3d_file
17	Water frame buffer top	1	n/a	3d_file
18	Pump holders	2	n/a	3d_file
19	Holder top	2	n/a	3d_file
20	Relay support	2	n/a	3d_file
21	(optional) PCB to be printed	1	n/a	PCB
22	Empty tank sensor	1	n/a	Link

Software

The file must be named main.py in order to be executed directly at the start-up of the shield.

How to start to test the softwarre

• Copy the /src folder that you find the SourceCode folder to your Raspberry Pico W

• Copy / execute the file sprinkler.py . If you want that it will be executed automatically at the startup you have to copy the file sprinkler.py to Raspberry Pico and rename it as main.py

What to do to start

1. Copy the source files in Raspberry Pi Pico W (/src + sprinkler.py)

2. Rename my_secret.py.template to my_secret.py

3. Edit my_secret.py adding:

   • Your network information (SSID, password)

   • Create a telegram bot:

     • On Telegram, search @ BotFather, send him a “/start” message

     • Send another “/newbot” message, then follow the instructions to setup a name and a username

     • Your bot is now ready, be sure to save a backup of your API token, and correct, this API token is your bot_token

   • Add the API token in the file

   • Save the file

4. You can now run the code

5. On Telegram, search your bot (by the username you just created), press the “Start” button or send a “/start” message

Changelog

V2.2.2

• Add broadcasted messages

v2.2.1

• Add tank full control before each pump activation

v2.2.0

• Removed direct pump activation via telegram causing issues

• Add new attribute to set back the flags for daily watering (daily_watering_done) via _watering_day

• Add new cycle to reset flags for daily watering

• Add new telegram messages for a better control on the variables in the running system

v2.1.1

• Add support for external LEDs for RUN and WiFi

v2.1.0

• Renamed main file for auto execution

• Add status led when running

• Set watering period to 1 day, dev 50s commented out

• Fix missing return False in is_evening

• Add flow diagrams

v2.0.0

• First release implementing telegram controlled automatic sprinkler

• User authentication

• 7 autonomous pumps

• 7 autonomous sensors

• Automatic watering cycle

• Manual watering cycle

• Pump activation time with persistency parameters controlled remotelly

• Pump activation and deactivation with persistency and remote contol

• Emergency system stop via remote message

v1.0.1

v1.0.0

Licence

Please check the dedicated file in main branch.