From 73305d12b925654fa156e97382549d3288d17516 Mon Sep 17 00:00:00 2001 From: pyr0ball Date: Mon, 1 Jun 2026 11:36:09 -0700 Subject: [PATCH] feat: add irrigation control, camera water assessment, and sensor integration layer (HA, MQTT, LoRa, RF, B-hyve) --- README.md | 31 +++++++++++++++++++++++++------ 1 file changed, 25 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 5c8f2ac..b81e02f 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ # Waxwing -**Local-first gardening assistant. Grow schedules, plant tracking, tree and graft registry — no cloud required.** +**Local-first gardening assistant. Grow schedules, plant tracking, tree and graft registry, camera health assessment, and smart irrigation control — no cloud required.** [![Status](https://img.shields.io/badge/status-backlog-lightgrey)](https://git.opensourcesolarpunk.com/Circuit-Forge/waxwing) [![License](https://img.shields.io/badge/license-BSL%201.1-blue)](LICENSE) @@ -52,6 +52,10 @@ Add plants and trees to your registry (species, variety, planting date, location - **Light mapping**: track sun exposure per bed across seasons; input sunrise/sunset angles for your coordinates or log direct observations; Waxwing recommends plant placements based on actual light hours rather than generic "full sun / part shade" labels - **Graft tracker**: union success rate, scion-rootstock compatibility notes, photo log - **Diagnosis**: photo upload or symptom description; visual model suggests deficiencies, pests, or disease +- **Water needs assessment**: point your camera at a plant and the visual model evaluates water stress indicators (leaf curl, turgor, color shift, soil surface); output is a recommendation, not a command +- **Smart irrigation control**: integrates with Home Assistant and Orbit B-hyve (IoT irrigation controllers) to trigger watering runs; each plant or zone runs in one of two modes: + - *Suggest mode* (default): Waxwing sends a notification with the assessment and recommended run time; you approve before anything opens + - *Automate mode* (opt-in per plant): watering triggers automatically within parameters you set (maximum daily volume, soil moisture floor, blackout windows); alerts you when readings fall outside your configured bounds - **Harvest log**: yield by variety and season; searchable history - **Offline-first**: all data stays local; no account required for core features @@ -59,7 +63,7 @@ Add plants and trees to your registry (species, variety, planting date, location **Privacy:** Your grow data stays on your device. No account required for core use. Cloud sync (Paid tier) is opt-in and encrypted in transit. -**Safety:** Diagnosis suggestions are starting points, not prescriptions. Pesticide and treatment recommendations always link to label instructions and require user confirmation before logging. +**Safety:** Diagnosis and water stress assessments are starting points, not instructions. Automated watering (automate mode) requires per-plant opt-in and explicit parameter bounds; no valve opens without either user approval or your pre-configured limits being met. Pesticide and treatment recommendations always link to label instructions and require user confirmation before logging. **Accessibility:** Plant names displayed in both common and Latin. Care reminders support multiple notification modes. High-contrast and large-text modes follow system preferences. @@ -67,9 +71,9 @@ Add plants and trees to your registry (species, variety, planting date, location | Tier | What you get | |------|-------------| -| **Free** | Full plant registry, grow calendar, harvest log, local LLM diagnosis | -| **Paid** | Cloud sync across devices, photo backup, community variety library | -| **Premium** | Fine-tuned visual model for your specific varieties, multi-site support | +| **Free** | Full plant registry, grow calendar, harvest log, local LLM diagnosis, water stress assessment, sensor integration (local network) | +| **Paid** | Cloud sync across devices, photo backup, community variety library, irrigation controller integration (Home Assistant, Orbit B-hyve) | +| **Premium** | Fine-tuned visual model for your specific varieties and conditions, multi-site support, sensor fleet management | ## Product code @@ -88,11 +92,26 @@ Early issues shape what gets built first. Star the repo to follow progress. ## Tech notes - Built on the shared [circuitforge-core](https://git.opensourcesolarpunk.com/Circuit-Forge/circuitforge-core) scaffold -- Visual model: local vision LLM for leaf and fruit diagnosis +- Visual model: local vision LLM for leaf/fruit diagnosis and water stress assessment - Calendar integration: iCal export for reminders - Data format: SQLite local store, JSON export for portability - Graft registry: tracks rootstock, scion, union date, take confirmation, and annual vigor notes +**Sensor integration layer:** + +Waxwing ingests readings from a wide range of garden sensor hardware. Any sensor that can publish data over the local network is a candidate: + +| Transport | Example hardware | What it provides | +|-----------|-----------------|-----------------| +| Home Assistant entity | HA soil moisture, temperature, humidity sensors | Direct pull via HA REST or WebSocket API | +| MQTT broker | DIY Arduino/ESP32 builds, Zigbee soil sensors | Subscribe to topic per bed or per plant | +| LoRa / LoRaWAN | Custom field sensors, The Things Network nodes | Long-range soil and microclimate readings from far corners of a property | +| RF (433 MHz / 915 MHz) | Budget wireless soil probes, weather stations | Received via RTL-SDR or dedicated gateway | +| Orbit B-hyve API | Smart irrigation controllers | Trigger watering runs; read zone history | +| HTTP polling | Any sensor with a local REST endpoint | Generic fallback for anything with a web interface | + +Sensor readings fuse with visual model output and grow calendar data to produce the water needs assessment. Camera vision and sensors are complementary: sensors give ground-truth soil state, camera gives above-ground plant response. + ## License [Business Source License 1.1](LICENSE) — free for personal non-commercial self-hosting. Converts to MIT after four years. Commercial use requires a [paid license](https://circuitforge.tech/pricing).