Skip to content
/ ruta Public

Simple controller for irrigation system on raspberry pi

License

Notifications You must be signed in to change notification settings

akosel/ruta

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

97 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ruta

Simple irrigation controller software for running on a single-board computer with GPIO pins (such as a raspberry pi)

image

Requirements

  • Single-board computer with GPIO pins running Ubuntu 21.04. Technically, any distro with Linux kernel >= 5.11 should work, but I only tested against Ubuntu 21.04.
  • A 5V Relay Module with Optocoupler Isolation. You'll need enough channels to support all of your zones.
  • 2 female-to-female jumper wires for the ground and 5V connection to the relay
  • N female-to-female jumper wires for connecting the irrigation zone wires, where N is the the total number of zones you have.
  • A power supply that works with your irrigation system. Mine was 24V.
  • Python >= 3.8 (I believe this is the default version on Ubuntu 21.04, so you may not need to do anything here)

For the wiring side, I followed this hackster tutorial mostly. Please be cautious when working with electricity.

Install

./bootstrap.sh

This will prompt you for your root password to install certain dependencies. Additionally, it will prompt you to create an admin user you can use to login into the django admin console.

Note that the lgpio dependency has to be installed via apt as of now, which makes it hard to use a proper virtual environment such as poetry. I'm looking into alternatives to this library.

Running for development

make run

Starts a server on port 9000. The admin console is at <your_local_pi_ip_address>:9000/admin.

You can configure the webserver to run properly using something like systemd.

Scheduler configuration

TODO

Sprinkler run configuration

TODO

About

Simple controller for irrigation system on raspberry pi

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published