https://github.com/reaper47/plant-sense

An Arduino project with an Android app to measure the soil moisture of your plants.
https://github.com/reaper47/plant-sense

Last synced: 1 day ago
JSON representation

An Arduino project with an Android app to measure the soil moisture of your plants.

• Host: GitHub
• URL: https://github.com/reaper47/plant-sense
• Owner: reaper47
• License: gpl-3.0
• Created: 2021-04-09T16:43:22.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-15T19:50:24.000Z (about 1 month ago)
• Last Synced: 2024-10-17T06:25:13.729Z (30 days ago)
• Language: C++
• Size: 227 MB
• Stars: 10
• Watchers: 1
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Plant Sense

[](https://f-droid.org/packages/com.macpoule.plantsense/)









An Arduino project with an Android app to measure the soil moisture of your plants. 

Why? To know whether the plant is thirsty.

## Features

- Measures your plant's soil moisture, and ambient temperature/humidity.

- Reports data to the *Plant Sense* app via Bluetooth.

- The sensor saves energy by going into deep sleep between measurements.

- A blue light on the device notifies the user when the latest measurements can be read. 

## Requirements

### Hardware



- 1x [Soil Temperature Humidity Sensor](https://www.diymore.cc/collections/new-product/products/esp32-wifi-bluetooth-cp2104-dht11-soil-temperature-humidity-sensor-18650-battery-base)

- 1x 18650 Lithium Battery

- 1x USB Micro B cable

### Software 

- [esptool](https://docs.espressif.com/projects/esptool/en/latest/esp32/)

## Installation

1. Download the latest [release](https://github.com/reaper47/plant-sense/releases/tag/v1.0.0) and `cd` into it.

1. Connect your soil moisture sensor to your computer and flash the firmware.
On Linux: `sudo esptool --chip esp32 --port "/dev/ttyUSB0" --baud 460800 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 40m --flash_size detect 0x1000 ./bootloader_dio_40m.bin 0x8000 ./partitions.bin 0xe000 ./boot_app0.bin 0x10000 ./firmware.bin`

1. Disconnect the device from the computer.

1. Slide the switch on the device to **off**, insert the 18650 lithium battery correctly, and slide the switch to **on**. 

1. Secure the device in soil.

1. Install the [Android app](https://f-droid.org/packages/com.macpoule.plantsense/).

## Usage

1. Every five minutes, a bright, blue light will light up on the device to signal that data is ready to be read by the app.

1. Tap the search icon in the lower right corner of the app to list the plants.

1. Tap one of the plants in the list to see the readings.

1. After 30s, the device will go back to deep sleep, and the blue light will dim.

## Future Improvements

### Name of the Plant

This firmware is intended to be used for one plant only because the name of the

Bluetooth Device is `Plant: Emerson`, and the service and characteristic UUIDs

are the same for everyone. 

To change them, the user needs to:

1. Clone the repository

1. Open `src/main.cpp`

1. Change the variables `SERVICE_UUID`, `CHARACTERISTIC_UUID`, and `PLANT_NAME`.

1. Build the project with PlatformIO

1. Flash the firmware

OR

Send an email to [me](mailto:[email protected]) with your desired name, and I will take care of it.

### Aural Signal

Add an aural signal, i.e. a beeper, to the device for it to beep when data is ready 

to be consulted in the app.

## License

[GNU General Public License v3.0](LICENSE)