Labs / MicroPython module projects

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

Author: Li Zisheng · Source: FreakStudio open documentation · License: CC BY 4.0

Contents
Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

Project Description

1. Introduction

1.1 Project Background

Traditional plant maintenance relies on manual experience to judge soil moisture, which has the problems of untimely or excessive watering, and lacks an intuitive status feedback mechanism. This project is based on GraftPort-RP2040 development board, and integrates NE555-based analog capacitive soil moisture sensor module, 0.96-inch SSD1306-OLED module, passive buzzer module and other alarm modules to realize the automated process of "moisture collection - threshold judgment - intelligent reminder", solving the subjectivity and lag problems of traditional maintenance methods.It also integrates MicroPython lightweight task scheduling and exception handling mechanisms to ensure the stable and reliable operation of the system in embedded environments.

1.2 Overview of the Main Functions of the Project

This project is developed based on MicroPython, whose core function is to collect real-time soil moisture data via the analog capacitive soil moisture sensor module based on NE555; after filtering processing, the data will be compared with an adjustable threshold (manually set via a sliding rheostat). When the humidity is lower than the threshold, it will trigger the passive buzzer module for alarm and LED flashing reminder, and meanwhile display the current humidity, threshold and alarm status on the OLED screen. It supports on-board key interrupt to control task start/stop and sensor calibration, has built-in automatic garbage collection (GC) to avoid memory leaks, and is equipped with an exception capture mechanism for convenient problem locating.

1.3 Applicable Scenarios or Application Area

2. Main Functions

3. Hardware Requirements

3.1 Hardware Required

This project is based on the GraftPort-RP2040 development board as the main controller:

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

The other required modules include:

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

3.2 Hardware Connection

Lithium Battery Charge and Discharge Module: BAT interface connects to the lithium battery, and the OUT interface supplies power to the main control board via a PH2.0-2P connection cable.

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)
Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)
Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

3.3 Structural Assembly

First, use M3 plastic pillars to fix each module and the main control board to the bottom plate of the housing (M3 screw holes are pre-drilled on both the main control board and the housing):

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)
Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

Next, secure the periphery of the housing with M3 plastic pillars, then screw in M3 screws at the corresponding positions to complete the assembly:

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

3.4 Notes

When the main control board is not connected to an external watchdog module, the RUN DIP switch 2 must be turned on:

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

The lithium battery charge-discharge module supports power level display, and you can charge it via the Type-C interface below:

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

4. Software Environment

5. File Structure

soil_moisture_reminder
├─ .flake8
├─ LICENSE
├─ README.md
├─ tools
│  ├─ dependency_analyzer.py
│  ├─ mpy_compiler.py
│  ├─ mpy_uploader.py
│  └─ README.md
├─ firmware
│  ├─ board.py
│  ├─ boot.py
│  ├─ conf.py
│  ├─ main.py
│  ├─ tasks
│  │  ├─ maintenance.py
│  │  ├─ sensor_task.py
│  │  └─ __init__.py
│  ├─ libs
│  │  ├─ __init__.py
│  │  └─ scheduler
│  └─ drivers
│     ├─ __init__.py
│     ├─ ssd1306_driver
│     ├─ soil_moisture_driver
│     ├─ potentiometer_driver
│     ├─ piranha_led_driver
│     └─ passive_buzzer_driver
├─ examples
│  └─ README.md
└─ docs

6. Description of Key Documents

7. Core Ideas of Software Design,

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)
Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

8. Instructions for Use

8.1 Hardware Connection

Connect the main control board, each sensor module and the battery according to the connection method specified in the "hardware requirements";

8.2 Run the Project (Using PyCharm + MicroPython Plugin)

Open PyCharm and install the corresponding MicroPython plugin.

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

In the plugin, select Target Device as RP2040, and enable Auto-detect device path.

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

Set Project/firmware as the project root directory.

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

Modify runtime configuration:

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

Click the IDE green triangle button in the upper right corner to run, and you can start uploading the firmware and executing the project.

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

8.3 Modification of Running Configuration

You can configure conf.py and modify or add parameters as needed, for example:

# conf.py example configuration
I2C_INIT_MAX_ATTEMPTS = 3      # Maximum number of sensor initialization retries
I2C_INIT_RETRY_DELAY_S = 0.5   # Interval between retries (seconds)
ENABLE_DEBUG = True            # Whether to enable debug printing
AUTO_START = True              # Whether to run tasks automatically at startup

8.4 Functional Testing

The terminal output is as follows:

Smart Monitoring and Watering Reminder Device for Green Plant Health (Based on GraftPort-RP2040 Development Board)(Open Version)

8.5 Debugging and Troubleshooting

9. Sample Program

There are no other reference sample codes for this project, you can directly make modifications in the firmware folder.

10. Notes

11. Version Record

12. Contact the Developer

If you have any questions or need assistance, please contact the developer via the following channels:
📧 Email: 10696531183@qq.com
💻 GitHub: https://github.com/FreakStudioCN

13. Licensing Agreement

In this project, except for machine and other MicroPython official modules (MIT License), all driver and extension codes written by the author are released under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) Licensing Agreement.

You are free to:

Only the following conditions shall be complied with:

Copyright © FreakStudio. All rights reserved.

Appendix 1: Project Source Code Download

https://github.com/FreakStudioCN/GraftPort_MicroPython_Labs/tree/main/soil_moisture_reminder

Appendix II: Reference Materials for hardware Modules

GtaftSense - Analog Capacitive Soil Moisture Sensor Module Based on NE555

GtaftSense - Rheostat

GtaftSense 0.96-inch SSD1306 OLED Module

GtaftSense-Piranha LED Light Module

GtaftSense - Passive Buzzer Module

GraftPort - Raspberry Pi Pico Expansion Board (Open Edition Template Files)

Version Record

Document Version

Date of Revision

Modifier

Revised Content

V1.0.0

2025-11-04

Hou Junhan

Draft the initial version of the document.

V1.1.0

2026-01-04

Li Zisheng

Final version.