ca-grow-ops-manager/QUICK-REFERENCE.md
fullsizemalt dc403c29f5
Some checks are pending
Test / backend-test (push) Waiting to run
Test / frontend-test (push) Waiting to run
fix: PDF export visibility and Light/Dark mode theming for Environment Report
2026-01-06 03:15:45 -08:00

355 lines
11 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# VERIDIAN HARDWARE TIER REPORT - QUICK REFERENCE
**Deployment:** 5 Greenhouses + 3 Drying Containers
**Date:** January 6, 2026
**Report:** [VERIDIAN-HARDWARE-TIERS-REPORT.md](./VERIDIAN-HARDWARE-TIERS-REPORT.md)
---
## 🎯 TL;DR (Too Long; Didn't Read)
### Three Hardware Tiers for 5 GH + 3 Containers
| Tier | Total Cost | What You Get | Best For |
|------|------------|--------------|----------|
| **Baseline** | **$2,200** | SensorPush HT1, Kasa EP10, Pi 4, Zigbee soil sensors (optional) | Initial testing, budget-conscious |
| **Premium** | **$10,500** | HT.w sensors, CO2, cameras, Pi 5, Soil Scout | Production, small commercial |
| **Enterprise** | **$36,600** | PAR sensors, PTZ cameras, Pi cluster, PLC | Commercial scale, maximum uptime |
**Real 2026 Pricing Applied** - Actual prices are LOWER than estimated!
---
## 📦 What's Included
### Common to All Tiers:
- **26 Air Sensors** (20 greenhouses + 6 containers)
- **10 Smart Plugs** (power control for fans, heaters, dehumidifiers)
- **Raspberry Pi Edge Device** (runs HomeAssistant + Veridian Edge Agent)
- **Network Infrastructure** (WiFi, ethernet, switches)
- **SQLite Offline Buffer** (data survives internet outages)
### Tier-Specific Additions:
**Baseline ($2,200):**
- SensorPush HT1 sensors (±0.36°F accuracy)
- Raspberry Pi 4 (4GB RAM)
- Kasa EP10 smart plugs (no energy monitoring)
- Optional: Zigbee soil sensors ($198) or DIY capacitive ($255)
- 30-min UPS battery backup
**Premium ($10,500):**
- SensorPush HT.w sensors (±0.18°F accuracy - 2x better!)
- Raspberry Pi 5 (8GB RAM) + NVMe SSD
- Kasa EP25 smart plugs (with energy monitoring)
- CO2 monitoring (8 zones)
- 4MP cameras (8 cameras, 30-day retention)
- Soil Scout LoRa sensors (professional-grade)
- E-ink displays (8 zones)
- 2-hour UPS + 4G LTE failover
**Enterprise ($36,600):**
- Everything in Premium, plus:
- PAR light sensors (Apogee SQ-500)
- 4K PTZ cameras (90-day retention)
- Pi 5 cluster (3 nodes, high availability)
- PLC control (industrial automation)
- Multi-depth soil sensors (moisture + EC + pH)
- Voice annunciation system
- 4-6 hour UPS + generator hook-up
- Dual 4G LTE internet redundancy
---
## 🔧 Key Hardware Specifications
### Environmental Sensors
**Air Sensors:**
- **SensorPush HT1** (Baseline): $54.95 each
- Temperature: -40°F to 185°F (±0.36°F)
- Humidity: 0-100% RH (±2%)
- Battery: 12 months
- Data: Every 1 minute
- **SensorPush HT.w** (Premium/Enterprise): $110 each
- Temperature: -40°F to 185°F (±0.18°F) - **2x more accurate!**
- Humidity: 0-100% RH (±1%)
- Battery: 18 months
- Data: Every 30 seconds
**Soil Sensors (Optional):**
| Option | Price | Accuracy | Battery | Integration |
|--------|-------|----------|---------|-------------|
| **Zigbee (Tuya TS0601)** | $18 each | ±5% | 6-12 mo (AAA) | ZHA / Zigbee2MQTT |
| **DIY Capacitive** | $8 each | ±5% | N/A (wired) | ADC + Python/Bun |
| **Soil Scout (LoRa)** | $150-250 each | ±3% | 5-10 years | MQTT via LoRa gateway |
| **Soil Scout Pro** | $250 each | ±2% | 10 years | Multi-depth (6", 12", 18") |
**CO2 Sensors (Premium/Enterprise):**
- **SenseAir S8** (Premium): $200 each
- Range: 0-2000 ppm
- Accuracy: ±30 ppm ±3%
- Output: Modbus RTU
- **SenseAir S8 Pro** (Enterprise): $350 each
- Range: 0-10,000 ppm
- Accuracy: ±20 ppm ±2%
- Pressure compensation: Yes
**PAR Sensors (Enterprise only):**
- **Apogee SQ-500**: $600 each
- Spectral range: 389-683 nm (plant-focused)
- Output: 0-2.5V
- Weatherproof: IP68
### Smart Plugs
| Model | Max Load | Energy Monitor | Price | Best For |
|-------|----------|----------------|-------|----------|
| **Kasa EP10** | 15A / 1800W | No | $7.50 each | Small loads, basic control |
| **Kasa EP25** | 15A / 1800W | Yes | $11.25 each | Medium loads, energy tracking |
**Note:** Actual prices from 4-packs! EP10 4-pack = $29.99, EP25 4-pack = $44.99
### Edge Device
| Model | RAM | Performance | Storage | Price |
|-------|-----|-------------|---------|-------|
| **Raspberry Pi 4** | 4GB | 1x baseline | 32GB SD | $60 |
| **Raspberry Pi 5** | 8GB | 2-3x faster | 500GB NVMe | $95 |
**Recommendation:** Pi 5 if budget allows (2-3x faster, true Gigabit Ethernet, NVMe support)
---
## 🏗️ Deployment Architecture
```
Veridian Cloud Backend (VPS)
↓ HTTPS/WebSocket
Edge Device (Raspberry Pi)
├── Home Assistant
├── Veridian Edge Agent (Bun)
├── SQLite Buffer (offline cache)
└── MQTT Broker (optional)
┌────┴────┬─────────┬────────────┐
│ │ │ │
SensorPush Kasa Zigbee Cameras/Other
Gateway Plugs (soil) (Tier 2/3)
│ │ │ │
└────┬────┴─────────┴────────────┘
26 Sensors + 10 Plugs
```
---
## 📍 Sensor Placement
### Greenhouses (5 total)
- **4 air sensors each** (N, S, E, W walls at canopy height)
- **2 soil sensors each** (optional - Tier 1: Zigbee/DIY, Tier 2+: Soil Scout)
### Containers (3 total)
- **2 air sensors each** (front and back, eye level)
- **No soil sensors** (drying environment)
**Total Air Sensors:** 26 (5 GH × 4 + 3 Containers × 2)
**Total Soil Sensors (optional):** 10 (5 GH × 2)
---
## ⚙️ Software Stack
### Edge Device (Raspberry Pi):
- **Home Assistant** (home automation platform)
- **Veridian Edge Agent** (Bun runtime, polls SensorPush API)
- **SQLite** (offline data buffering)
- **MQTT Broker** (optional - for soil sensors, e-ink displays)
- **go2rtc** (Tier 2/3 - camera streaming)
### Integrations:
- **SensorPush** (air sensors) - Native HA integration
- **TP-Link Kasa** (smart plugs) - Native HA integration
- **ZHA** or **Zigbee2MQTT** (soil sensors)
- **Modbus** (CO2 sensors - Tier 2/3)
- **Veridian Cloud** (backend API, WebSocket)
---
## 🔌 Example Automations
### Emergency Ventilation (High Temp)
```yaml
# If temperature > 85°F for 1 minute → Turn on fan
trigger:
- platform: numeric_state
entity_id: sensor.greenhouse_1_temperature
above: 85
for:
minutes: 1
action:
- service: switch.turn_on
entity_id: switch.greenhouse_1_fan
```
### Low Soil Moisture Alert
```yaml
# If soil moisture < 30% → Send notification
trigger:
- platform: numeric_state
entity_id: sensor.greenhouse_1_soil_moisture
below: 30
for:
minutes: 30
action:
- service: notify.mobile_app
data:
title: "💧 GH1 Low Soil Moisture"
message: "Soil moisture at 25%. Watering needed."
```
### Container Dehumidifier
```yaml
# If humidity > 65% → Turn on dehumidifier
trigger:
- platform: numeric_state
entity_id: sensor.container_1_humidity
above: 65
action:
- service: switch.turn_on
entity_id: switch.container_1_dehumidifier
```
---
## 📅 Installation Timeline
### Tier 1 (Baseline)
- **Procurement:** 1 week (Amazon, fast shipping)
- **Installation:** 1 weekend (DIY)
- **Configuration:** 1-2 days
- **Testing:** 1 week
- **Total:** 3-4 weeks to full deployment
### Tier 2 (Premium)
- **Procurement:** 2 weeks (some specialty items)
- **Installation:** 1 week
- **Configuration:** 3-5 days
- **Testing:** 1 week
- **Total:** 5-6 weeks to full deployment
### Tier 3 (Enterprise)
- **Procurement:** 3-4 weeks (industrial equipment)
- **Installation:** 2-3 weeks (professional)
- **Configuration:** 1-2 weeks
- **Testing:** 2 weeks
- **Total:** 10-12 weeks to full deployment
---
## 💰 Cost Comparison Over 5 Years
| Tier | Initial Cost | Maintenance | Total 5-Year | ROI Timeline |
|------|--------------|-------------|--------------|--------------|
| **Baseline** | $2,200 | $324 | $2,524 | 6-12 months |
| **Premium** | $10,500 | $760 | $11,260 | 4-6 months |
| **Enterprise** | $36,600 | $8,560 | $45,160 | 6-9 months |
**ROI Calculation:**
- Energy savings from smart HVAC control: 20-30%
- Reduced crop loss from environmental alerts: 10-20%
- Increased yields from optimized environment: 10-20%
- Labor savings from automation: 5-10 hours/week
---
## 🚀 Recommendations
### For Initial Testing → **Start with Tier 1 ($2,200)**
**Why:**
- Low risk investment
- Quick deployment (1 weekend)
- Proven consumer hardware
- Validates system before scaling
- Upgrade path to higher tiers
**Deployment Strategy:**
1. Pilot 1 greenhouse + 1 container (Week 1-2)
2. Test for 2-4 weeks (Week 3-6)
3. Expand to all zones (Week 7-8)
4. Total: 2 months to full deployment
### For Production → **Tier 2 ($10,500)**
**Why:**
- Production-grade reliability
- Camera surveillance (security + monitoring)
- CO2 monitoring (yield optimization)
- Professional soil sensors (Soil Scout)
- Good balance of cost vs capability
**ROI:** 200-300% over 5 years
### For Commercial Scale → **Tier 3 ($36,600)**
**Why:**
- Maximum uptime (99.99%)
- High availability (automatic failover)
- PAR light monitoring (professional cultivation)
- Enterprise support and SLAs
- 7-10 year lifespan
**ROI:** 400-600% over 5 years, 1000%+ over 10 years
---
## 📚 Additional Resources
### Documentation
- **Full Report:** [VERIDIAN-HARDWARE-TIERS-REPORT.md](./VERIDIAN-HARDWARE-TIERS-REPORT.md)
- **Veridian Docs:** https://docs.veridian.runfoo.run
- **Home Assistant Docs:** https://www.home-assistant.io/docs
### Hardware Vendors
- **SensorPush:** https://sensorpush.com
- **Raspberry Pi:** https://www.raspberrypi.com
- **Kasa Smart Plugs:** https://www.kasasmart.com
- **Soil Scout:** https://soilscout.com
- **RAK Wireless (LoRa):** https://store.rakwireless.com
### Community Support
- **Home Assistant Community:** https://community.home-assistant.io
- **Veridian Edge Repo:** https://git.runfoo.run/malty/veridian-edge
- **GitHub Issues:** https://github.com/your-org/veridian/issues
---
## 🏷️ Tags (for Web Search / SEO)
`#Veridian #CultivationPlatform #GreenhouseAutomation #IoT #HomeAssistant #SensorPush #SoilMoistureSensors #SmartFarming #CannabisCultivation #EnvironmentalMonitoring #RaspberryPi #EdgeComputing #Zigbee #LoRaWAN #WirelessSensors #ClimateControl #AgricultureTechnology #AgTech #PrecisionAgriculture #GrowAutomation #HVACControl #CO2Monitoring #PARSensors #VPDMonitoring #SmartPlugs #Kasa #TPLink #DIYGreenhouse #ContainerFarming #DryingContainers #HomeAutomation #SmartHome #IndustrialIoT #IIoT #AgriculturalSensors #CapacitiveSoilSensors #Modbus #MQTT #ZHA #Zigbee2MQTT #SoilScout #SenseAir #ApogeeInstruments #PTZCameras #Surveillance #RemoteMonitoring #OfflineResilience #DataBuffering #CloudSync #HardwareTier #BillOfMaterials #BOM #DeploymentGuide #InstallationGuide #MaintenanceSchedule #Troubleshooting #ROI #CostAnalysis #2026Pricing`
---
## 📞 Contact & Support
**Veridian Platform:**
- **Documentation:** https://docs.veridian.runfoo.run
- **GitHub:** https://github.com/your-org/veridian
- **GitLab:** https://git.runfoo.run/malty/veridian-edge
- **Support:** support@veridian.runfoo.run
**Report Issues:**
- **GitHub Issues:** https://github.com/your-org/veridian/issues
- **Email:** support@veridian.runfoo.run
---
**Quick Reference Created:** January 6, 2026
**Full Report:** [VERIDIAN-HARDWARE-TIERS-REPORT.md](./VERIDIAN-HARDWARE-TIERS-REPORT.md)
**Version:** 1.0