Micropython library for automated plant watering and environmental monitoring

Transform your plant care with intelligent automation! GrowMax provides everything you need to build a sophisticated plant monitoring and watering system using affordable microcontrollers.

• 🎯 Plug & Play: Get started in minutes with pre-configured settings
• 🔧 Highly Configurable: 20+ configuration options for any setup
• 📊 Multi-Sensor Support: Soil moisture, pH, CO2, water level monitoring
• 💧 Smart Watering: Automated pumping with safety features
• 📱 Remote Monitoring: WiFi connectivity with cloud data collection
• 🖥️ Visual Feedback: OLED display support with motion activation
• ⚡ Power Efficient: Designed for 24/7 operation
• 🛡️ Safety First: Built-in water level checks and pump protection

Purchase GrowMax boards and complete kits at opensensor.io

Choose your microcontroller:

• Raspberry Pi Pico: Download Firmware
• Raspberry Pi Pico W: Download Firmware
• ESP32S3 (BananaPi): See ESP32S3 Setup Guide

1. Install Thonny IDE
2. Connect your device and launch Thonny
3. Go to Tools → Manage Packages
4. Search for growmax and install the latest version

Create main.py on your device:

from growmax.routine import main

main()

1. Copy /lib/growmax/config.py to your device root as config.py
2. Customize settings for your setup (see Configuration Guide)
3. Run main.py in Thonny to test

Connect 5V USB power - your system is now autonomous! 🎉

• 8-channel soil moisture monitoring with individual thresholds
• Automated pump control with configurable duration
• Water level safety checks prevent dry pumping
• High-power pump support via I2C relay boards

• CO2 monitoring with Adafruit SCD4X sensors
• pH measurement using Atlas Scientific probes
• Temperature and humidity tracking
• Real-time data logging to OpenSensor.io cloud

• OLED display support (SSD1327, SH1107)
• Motion-activated display for power efficiency
• Real-time status updates showing all sensor readings
• Visual pump and sensor status indicators

• WiFi connectivity for remote monitoring
• Cloud data collection with opensensor.io integration
• Remote pump control (experimental feature)
• Device management through web dashboard

Here are the most commonly used settings:

# Soil moisture threshold (0-28, lower = wetter)
SOIL_WET_THRESHOLD = 10

# Enable water level safety check
WATER_SENSOR_LOW_ENABLED = True
WATER_SENSOR_LOW = 22  # GPIO pin

# Pump settings
PUMP_WHEN_DRY = False  # Safety: only pump when water detected
PUMP_CYCLE_DURATION = 30  # seconds

# WiFi for remote monitoring
WIFI_ENABLED = True
WIFI_SSID = "YourNetwork"
WIFI_PASSWORD = "YourPassword"

See the complete configuration guide for all 20+ options.

Perfect for beginners - monitor and water one plant automatically.

Full 8-channel setup with individual moisture thresholds per plant.

Advanced setup with CO2, pH, temperature monitoring and cloud logging.

Using relay boards to control large pumps and irrigation systems.

View detailed examples →

Important Safety Information:

• Pico Power Limit: 300mA max current (shared 5V rail)
• Onboard Pumps: Use 5V pumps drawing <200mA each
• Higher Power Applications: Require I2C relay boards (not direct connection)
• Water Sensors: Designed for Optomax liquid sensors with 4V→3.3V conversion
• Always Enable Water Level Checks: Prevents pump damage from dry running

• 📖 Documentation: Check our comprehensive guides
• 🐛 Issues: Report bugs on GitHub Issues
• 💬 Community: Join discussions on opensensor.io
• 📧 Support: Contact us through opensensor.io

We welcome contributions! Whether it's:

• 🐛 Bug reports and fixes
• 📖 Documentation improvements
• ✨ New features and sensors
• 💡 Example projects and use cases

MIT License - see LICENSE file for details.

Made with ❤️ by OpenSensor.io

Automate your garden, monitor your plants, grow smarter! 🌱