Skip to content

balena-io-examples/balena-plant-saver

Repository files navigation

Balena Plant Saver

This is a Raspberry Pi balenaCloud starter project to help you water your precious plants. See temperature, humidity, and soil moisture levels. Set watering thresholds and timings to automate the watering of your plants.

Access your plant's dashboard from anywhere in the world using balenaCloud. Add new plant monitors quickly and easily using the same application code on different devices. Use your imagination (and some extra parts) and turn balenaPlant into a balenaGarden. :)

For a more detailed walkthrough, check out our official project guide on the balena blog.

Hardware you'll need

This project uses the Pimoroni Automation HAT to make things a bit more user-friendly. Here's the list of materials:

  • Raspberry Pi ZeroWH/3B/4 (that's what we've tested so far)
  • A 32GB+ SD card
  • Pimoroni Automation HAT (a discontinued Automation pHAT should work as well)
  • DHT22 temperature and humidity sensor
  • Capacitive soil moisture sensor
  • Float switch
  • 5V peristaltic pump (with water tube-- some vendors don't include the tubing-- remember the tubing!!!)

Software you'll need

Here's the software that you'll need to get going:

  • a free balenaCloud account (first ten devices are fully featured and free)
  • balenaEtcher to burn OS images to SD cards
  • (optional) balenaCLI if you want to hack on this project, push code locally, etc.

Set up the hardware

This wiring diagram covers a build that uses the Pimoroni Automation HAT. Wiring will differ if using other hardware.

Solder on DHT22 sensor

Connect the power and ground to the 3.3V pins. Connect the data pin to the SCLK pin, which is GPIO pin 11 (you'll see this referenced in the plant watering code).

Add capacitive moisture sensor

As seen on this balenaForum post, it's helpful to paint or coat the exposed electronic components of this sensor with outdoor paint or nail polish. Power the soil moisture sensor using the 5V terminals on the Automation pHAT, and insert the data wire into the ADC 1 terminal (since the sensor is giving us an analog signal to convert).

Add the water pump

Power the peristaltic pump using the 5V terminal on the Automation pHAT. Connect the pump's ground wire to the NO (Normally Open) terminal.

Add the float switch

Power the float switch using the 5V terminal and connect the other wire into the INPUT 1 terminal.

Close the loop

Close the circuit for the water pump by using a wire to connect the COM terminal to GND.

Set everything up

After preparing the Automation pHAT (soldering terminals on, etc.), connect it to the Raspberry Pi via GPIO pins.

At this point, you can set your plant watering test up. Add the moisture sensor to the plant's soil (or lack thereof in the case of this bamboo). Add the pumping end of the water pump into your water source and the dousing end into the plant's soil. NOTE: It's not clear on some pumps as to which port does what-- once you test, mark or tape a line to help tell which is which.

Build or 3D print additional accessories

The original project creators built 3D-printed parts to hold various parts or to enclose the electronics for the project. Check out this forum thread to learn more.

Add and deploy the application

Deploy with balena

Once you're logged into your balenaCloud account (remember: first ten devices are free and fully-featured), click the button below to automagically deploy the project to your account.

Deploy with balena

Name your application, select your device type, and click Create and deploy. You'll be taken to your dashboard and our builders will start creating your application in the background.

Add a device

Once that step is complete, add a new device by clicking Add device and selecting your device type. If you plan on using Wi-Fi, add your credentials here. Otherwise, proceed with an Ethernet cable connected to your internet setup. Complete the modal and your OS will download.

Flash the OS onto your SD card

Insert the SD card into your computer, boot up Etcher and flash the downloaded balenaOS to your card. Insert the card into your device and wait for it to power on and show up on your dashboard within your app. Once the device downloads all the software, the application should be ready to use.

Automated watering

By default, balenaPlant checks the water level of the plant approximately every 15 minutes. This is a reasonable time for a few reasons:

  • running the pump infrequently prevents the motor from burning out
  • watering with long intervals between each session allows soil or growing material to absorb water for a more accurate reading

You can change the pump delay time by changing the Device variable (located on the left-side menu in balenaCloud). Set pump_delay to a higher number for a longer wait time (more pump cycle counts) and a lower one for a shorter wait between watering. If properly set, you'll never overwater because even if the elapsed delay goes by, the pump won't start if the moisure level meets your requirements.

Other device variables to change include:

Device variable Definition Default value
target_soil_moisture Sets target moisture percentage 60
target_soil_threshold Sets threshold of moisture past target 15
pump_delay Adds time between how often pump code runs 15

NOTE: When you change a device variable,it will reset the device.

Experiment and explore

Once you test a few things here and there, try other kinds of plants, adjust the soil moisture targets, and take one chore off your to-do list.

Build a fleet of balenaPlant devices

Why automate the watering of one plant when you could grow and nurture many more? What if you upgrade the pump? What if you add LED grow lights?? The possibilities are endless.

Additional resources

Check out our official project guide on the balena blog.

Check out this livestream build (uses the balenaCLI method) or visit our Forums for more information.