# VERIDIAN HARDWARE TIER REPORT
## 5 Greenhouses + 3 Drying Containers - Complete Hardware Configuration

**Date:** January 6, 2026
**Version:** 1.0
**Deployment:** Initial Testing Environment

---

## EXECUTIVE SUMMARY

Comprehensive hardware recommendations for Veridian Cultivation Platform deployment across:

- **5 Greenhouses** (4 sensors each = 20 air sensors, optional soil sensors)
- **3 Drying Shipping Containers** (2 sensors each = 6 air sensors)
- **Total Environmental Zones:** 26 monitored areas
- **Edge Computing:** Raspberry Pi with HomeAssistant
- **Power Control:** Smart plugs for intervention methods
- **Soil Monitoring:** Optional capacitive sensors for precise root zone monitoring

**Quick Tier Comparison:**

| Tier | Total Cost | Best For | Key Features |
|------|------------|----------|--------------|
| **Baseline** | **$2,177** | Initial testing | SensorPush HT1, Kasa EP10, Pi 4 |
| **Premium** | **$8,134** | Production | HT.w sensors, CO2, cameras, Pi 5 |
| **Enterprise** | **$29,865** | Commercial scale | PAR sensors, PTZ cameras, Pi cluster |

---

## DEPLOYMENT ARCHITECTURE

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                          VERIDIAN CLOUD BACKEND                             │
│                    (VPS - api.veridian.runfoo.run)                          │
└────────────────────────────┬────────────────────────────────────────────────┘
                             │ HTTPS/WebSocket
                             ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                      EDGE DEVICE (On-Site)                                  │
│                   Raspberry Pi 4/5 + HomeAssistant                          │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐   │
│  │ Veridian     │  │              │  │              │  │ HomeAssistant │   │
│  │ Edge Agent   │  │   SQLite     │  │  MQTT Broker │  │   (HASS.io)  │   │
│  │  (Bun Runtime)│  │   Buffer     │  │  (Optional)  │  │              │   │
│  └──────────────┘  └──────────────┘  └──────────────┘  └──────────────┘   │
└───────────┬───────────────────────┬───────────────────────────┬─────────────┘
            │                       │                           │
    ┌───────▼───────┐       ┌───────▼───────┐         ┌───────▼───────┐
    │ SensorPush    │       │ Kasa/Tapo     │         │ GPIO/ADC      │
    │ WiFi Gateway  │       │ Smart Plugs   │         │ Soil Sensors  │
    └───────┬───────┘       └───────┬───────┘         └───────────────┘
            │                       │
            │ WiFi Network          │ Power Control
            │ (Local)               │
    ┌───────▼───────────────────────▼───────────────────────────────────┐
    │                    SENSORS & ACTUATORS                             │
    │                                                                      │
    │  GREENHOUSE 1-5          CONTAINER 1-3                              │
    │  ┌────┐ ┌────┐          ┌────┐ ┌────┐                              │
    │  │ A1 │ │ A2 │          │ A1 │ │ A2 │  Air Sensors (Temp/RH)      │
    │  └────┘ └────┘          └────┘ └────┘                              │
    │  ┌────┐ ┌────┐                                                    │
    │  │ S1 │ │ S2 │  Soil Sensors (Optional)                          │
    │  └────┘ └────┘                                                    │
    └──────────────────────────────────────────────────────────────────────┘
```

---

## TIER 1: BASELINE CONFIGURATION ✓
**"Just Works" - Minimum Viable Production Setup**

### Overview
Budget-friendly setup using proven consumer-grade hardware with real 2026 pricing. Ideal for initial deployment testing and budget-conscious operations.

---

### EDGE DEVICE

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **Raspberry Pi 4** | Model B, 4GB RAM | 1 | $60 | Reliable, well-supported |
| **Power Supply** | USB-C 5V 3A official | 1 | $12 | |
| **Case** | Passive cooling aluminum | 1 | $15 | Heatsink case |
| **MicroSD Card** | 32GB A2 Class 10 | 1 | $12 | High endurance |
| **Ethernet Cable** | Cat5e 50ft | 1 | $15 | Wired preferred |
| **UPS** | APC Back-UPS 425VA | 1 | $60 | Battery backup |
| **Edge Device Subtotal** | | | **$174** | |

**Alternative:** Raspberry Pi 5 8GB (+$35) if budget allows

---

### ENVIRONMENTAL SENSORS (Air)

**SensorPush HT1 (Bluetooth/WiFi)**

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **SensorPush HT1** | Temp/RH/VPD/Dew Point | 26 | $54.95/ea | $1,428.70 total |
| **SensorPush G1 Gateway** | WiFi bridge for sensors | 2 | $100/ea | Up to 50 sensors each |
| **Gateway Power** | USB 5V 2A adapters | 2 | $10/ea | |
| **Sensor Mounting** | 3M command strips + velcro | 26 | $2/ea | $52 total |
| **Sensors Subtotal** | | | **$1,600.70** | |

**SensorPush HT1 Specifications:**
- Temperature: -40°F to 185°F (-40°C to 85°C)
- Humidity: 0% to 100% RH
- Accuracy: ±0.36°F / ±2% RH
- Battery: CR2477 coin cell (12+ months)
- Data rate: Every 1 minute (configurable)
- Connectivity: Bluetooth LE to G1 Gateway
- VPD calculated: Yes (in Veridian backend)

**Placement Strategy:**
- Greenhouses: 4 sensors each (N, S, E, W walls at canopy height)
- Containers: 2 sensors each (front and back, middle height)

---

### SOIL MOISTURE SENSORS (Optional Add-on)

**Option A: Zigbee Sensors (Recommended for ease)**

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **Tuya TS0601** | Soil moisture + temp + light | 10 | $18/ea | $180 total |
| **Zigbee Coordinator** | Sonoff Zigbee 3.0 USB Dongle | 1 | $18 | |
| **Zigbee2MQTT** | Open-source integration | 1 | $0 | Software |
| **Soil Sensor Subtotal (Zigbee)** | | | **$198** | |

**Tuya TS0601 Specifications:**
- Soil moisture: 0-100% (capacitive)
- Temperature: -20°C to 60°C
- Light intensity: 0-100,000 lux
- Battery: AAA x2 (6-12 months)
- Protocol: Zigbee 3.0
- Integration: ZHA or Zigbee2MQTT
- HomeAssistant: Native support
- Waterproof: IP66 (probe only)

**Placement:**
- 2 sensors per greenhouse (10 total for 5 greenhouses)
- Install at root zone depth (4-6 inches)
- Position near plants, not in walkways

**Option B: Capacitive Sensors with ADC (DIY)**

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **Capacitive Soil Sensor** | 3.3V corrosion-resistant | 10 | $8/ea | $80 total |
| **ADC (MCP3008)** | 8-channel 10-bit | 2 | $5/ea | $10 total |
| **Grove Base HAT** | For Raspberry Pi | 1 | $15 | Simplifies wiring |
| **Waterproof Enclosure** | IP65 for sensors | 10 | $12/ea | $120 total |
| **Cabling & Connectors** | Jumper wires, etc. | 1 | $30 | |
| **Soil Sensor Subtotal (DIY)** | | | **$255** | |

**Capacitive Sensor Specifications:**
- Operating voltage: 3.3V (Raspberry Pi safe)
- Output: Analog (requires ADC)
- Corrosion-resistant: No exposed metal
- Lifespan: 3-5 years (vs 1-2 years for resistive)
- Accuracy: ±5% moisture
- Response time: <2 seconds

**Integration:**
- Read via MCP3008 ADC (SPI interface)
- Python/Bun script for data collection
- Publish to MQTT for HomeAssistant
- More work but fully customizable

---

### POWER CONTROL (Smart Plugs)

**TP-Link Kasa EP10**

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **Kasa EP10 Smart Plug** | 15A max load | 10 | $7.50/ea | $75 total (4-pack) |
| **Controlled Loads** | | | | |
| - Greenhouse Fans | Exhaust/intervention fans | 5 | Included | |
| - Greenhouse Heaters | Space heaters/furnaces | 5 | Included | |
| - Container Dehumidifiers | Portable units | 3 | Included | |
| - Spares | For expansion | 2 | Included | |
| **Power Control Subtotal** | | | **$75** | |

**Kasa EP10 Specifications:**
- Max Load: 15A / 1800W
- Connectivity: WiFi (2.4GHz only)
- Protocol: TP-Link Smart Home (supported by HA)
- Response Time: <1 second local
- Features: Schedule, timer, away mode
- **Note:** No energy monitoring (upgrade to EP25 for +$3.75/unit)

**Actual Pricing Breakdown:**
- 4-pack EP10: $29.99 → $7.50 each
- Need 10 plugs → 3 x 4-packs = $89.97

---

### NETWORK INFRASTRUCTURE

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **WiFi Access Point** | Ubiquiti UniAP AC Lite | 1 | $90 | Covers greenhouses |
| **Network Switch** | TP-Link 5-port Gigabit | 1 | $25 | Wired backhaul |
| **Ethernet Cables** | Cat5e outdoor 100ft | 3 | $40 | Buriable/direct burial |
| **Network Subtotal** | | | **$155** | |

---

### TIER 1 TOTAL COST

| Category | Cost |
|----------|------|
| Edge Device | $174 |
| Environmental Sensors (Air) | $1,600.70 |
| Soil Sensors (Optional - Zigbee) | $198 |
| Soil Sensors (Optional - DIY) | $255 |
| Power Control | $90 |
| Network Infrastructure | $155 |
| **TIER 1 SUBTOTAL (Air Only)** | **$2,019.70** |
| **TIER 1 WITH ZIGBEE SOIL** | **$2,217.70** |
| **TIER 1 WITH DIY SOIL** | **$2,274.70** |

**Rounded for Budgeting:** **$2,200 - $2,300**

---

### TIER 1 SPECIFICATION SHEET

**Software Stack:**
```
Edge Device (Raspberry Pi 4 4GB):
├── Home Assistant (via Home Assistant OS)
│   ├── Kasa Integration
│   ├── SensorPush Integration
│   ├── ZHA or Zigbee2MQTT (if soil sensors)
│   └── Veridian Edge Agent (Docker)
├── Veridian Edge Agent (Bun runtime)
│   ├── SensorPush Cloud API polling
│   ├── SQLite buffer (offline resilience)
│   └── WebSocket client to cloud backend
└── System Services:
    ├── Systemd watchdog (auto-restart)
    └── Log rotation
```

**Power Requirements:**
- Edge Device: 15W max
- Total: ~200W including sensors (WiFi)
- UPS Runtime: 30-45 minutes during outage

**Data Flow:**
1. SensorPush HT1 → Bluetooth → G1 Gateway (WiFi)
2. G1 Gateway → SensorPush Cloud API
3. Veridian Edge Agent → Polls API every 60s
4. Edge Agent → SQLite buffer + Cloud backend
5. Cloud backend → WebSocket → Frontend dashboard
6. Alert condition → Cloud → Edge Agent → HomeAssistant → Kasa plug

**HomeAssistant Integration:**
```yaml
# configuration.yaml
sensorpush:
  email: !secret sensorpush_email
  password: !secret sensorpush_password

# For Zigbee soil sensors (ZHA)
zha:
  enable_quirks: true

# For Kasa plugs
tplink:
  discovery: true

automation:
  - alias: "Emergency Ventilation"
    trigger:
      - platform: numeric_state
        entity_id: sensor.greenhouse_1_temperature
        above: 85
    action:
      - service: switch.turn_on
        entity_id: switch.greenhouse_1_fan
```

**Maintenance:**
- Sensor batteries: Replace annually ($2/CR2477)
- Gateway cleaning: Every 6 months
- Edge device updates: Monthly (OTA)
- Network equipment: Annual inspection
- Soil sensor batteries: Every 6-12 months

**Limitations:**
- No CO2 monitoring
- No camera surveillance
- No physical alerts (LED/buzzer)
- Consumer-grade hardware (2-3 year lifespan)
- Limited local processing power

---

## TIER 2: PREMIUM CONFIGURATION ★
**"Production Ready" - Enhanced Reliability & Monitoring**

### Overview
Professional-grade hardware with redundant systems, enhanced monitoring capabilities, and production-grade reliability. Real 2026 pricing applied.

---

### EDGE DEVICE

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **Raspberry Pi 5** | 8GB RAM | 1 | $95 | 2-3x faster than Pi 4 |
| **NVMe Hat** | Pimoroni NVMe Base | 1 | $25 | Fast storage adapter |
| **NVMe SSD** | 500GB M.2 NVMe | 1 | $55 | High endurance |
| **Power Supply** | 27W USB-C PD + PSU | 1 | $20 | Reliable power |
| **Case** | Active cooling case with fan | 1 | $35 | Optimized airflow |
| **UPS** | CyberPower 1350VA | 1 | $150 | 2+ hour runtime |
| **Edge Device Subtotal** | | | **$380** | |

---

### ENVIRONMENTAL SENSORS (Air)

**SensorPush HT.w (Pro Edition)**

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **SensorPush HT.w** | Industrial temp/RH | 26 | $110/ea | $2,860 total |
| **SensorPush G1 Gateway** | WiFi bridge (redundant) | 3 | $100/ea | One per zone + spare |
| **CO2 Sensors** | SenseAir S8 (Modbus) | 8 | $200/ea | $1,600 total |
| **Sensor Enclosures** | IP65 outdoor rated | 26 | $15/ea | $390 total |
| **Mounting Hardware** | Stainless steel brackets | 26 | $8/ea | $208 total |
| **RS485 Adapter** | USB to Modbus | 1 | $25 | For CO2 sensors |
| **Sensors Subtotal** | | | **$5,283** | |

**SensorPush HT.w Specifications:**
- Temperature: -40°F to 185°F (-40°C to 85°C)
- Humidity: 0% to 100% RH
- Accuracy: ±0.18°F / ±1% RH (2x better than HT1)
- Battery: CR2477 (18+ months)
- Data rate: Every 30 seconds

**SenseAir S8 CO2 Specifications:**
- Range: 0-2000 ppm (standard)
- Accuracy: ±30 ppm ±3%
- Output: Modbus RTU (RS485)
- Power: 10-30V DC
- Calibration: Auto-calibration (ABC)

---

### SOIL MOISTURE SENSORS (Enhanced)

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **Zigbee Soil Sensors** | Tuya TS0601 with probes | 15 | $18/ea | $270 (3 per GH) |
| **Professional Soil Sensor** | Soil Scout (LoRa) | 5 | $150/ea | $750 (1 per GH) |
| **LoRa Gateway** | RAK Wireless Indoor Gateway | 1 | $180 | For Soil Scout |
| **Soil Sensor Subtotal** | | | **$1,200** | |

**Soil Scout Specifications:**
- Soil moisture: 0-100% (capacitive)
- Soil temperature: -20°C to 60°C
- Battery: 5-10 years (non-replaceable)
- Depth: Buried sensor (IP68)
- Connectivity: LoRaWAN (up to 15km range)
- Integration: MQTT via LoRa gateway
- Warranty: 2 years

**Advantage:** Professional-grade, no batteries to replace, buried sensors don't interfere with operations

---

### POWER CONTROL

**TP-Link Kasa EP25 + Heavy Duty Relays**

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **Kasa EP25 Smart Plug** | 15A, energy monitoring | 10 | $11.25/ea | $112.50 total (4-pack) |
| **Mechanical Relays** | DIN mount 30A @ 240V | 5 | $45/ea | $225 (high-load) |
| **Relay Enclosures** | NEMA 1 project box | 5 | $25/ea | $125 total |
| **Control Module** | Arduino Nano + relay shield | 1 | $40 | USB to Pi |
| **Wiring & Connectors** | 14 AWG, terminals | 1 | $150 | |
| **Power Control Subtotal** | | | **$652.50** | |

**Actual Kasa EP25 Pricing:**
- 4-pack EP25: $44.99 → $11.25 each
- Need 10 plugs → 3 x 4-packs = $134.97

---

### CAMERA SURVEILLANCE

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **IP Cameras** | Amcrest IP4M-1050E (4MP) | 8 | $60/ea | $480 total |
| **NVR** | Amcrest NV4108 (8-channel) | 1 | $150 | PoE enabled |
| **PoE Switch** | Netgear 8-port PoE+ | 1 | $120 | 130W budget |
| **Outdoor Housing** | IP66 weatherproof | 8 | $20/ea | $160 total |
| **Camera Cabling** | Cat6 outdoor 100ft | 4 | $50 | $200 total |
| **Storage** | 4TB HDD for NVR | 1 | $90 | 30+ days retention |
| **Surveillance Subtotal** | | | **$1,200** | |

**Camera Placement:**
- 1 per greenhouse entrance (5 total)
- 1 per container (3 total)

---

### NETWORK INFRASTRUCTURE

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **WiFi Access Point** | Ubiquiti UniAP 6 LR | 2 | $150/ea | $300 (redundant) |
| **Network Switch** | Netgear 16-port Gigabit PoE | 1 | $200 | For cameras + APs |
| **Ethernet Cables** | Cat6 outdoor burial | 5 | $50 | $250 total |
| **4G LTE Backup** | Peplink BR1 Mini | 1 | $350 | Failover internet |
| **Network Subtotal** | | | **$1,100** | |

---

### ALERT SYSTEMS & E-INK DISPLAYS

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **E-Ink Room Displays** | Waveshare 7.5" | 8 | $45/ea | $360 total |
| **ESP32 Controllers** | LILYGO T5 V2.1 | 8 | $25/ea | $200 total |
| **Industrial Strobe** | Amseco AB-2 strobe | 1 | $45 | Visual alerts |
| **Piezo Buzzer** | 100dB @ 12V | 1 | $20 | Audio alerts |
| **Alerts & Displays Subtotal** | | | **$625** | |

---

### TIER 2 TOTAL COST

| Category | Cost |
|----------|------|
| Edge Device | $380 |
| Environmental Sensors (Air) | $5,283 |
| Soil Sensors (Enhanced) | $1,200 |
| Power Control | $652.50 |
| Camera Surveillance | $1,200 |
| Network Infrastructure | $1,100 |
| Alerts & Displays | $625 |
| **TIER 2 TOTAL** | **$10,440.50** |

**Rounded for Budgeting:** **$10,500**

---

### TIER 2 SPECIFICATION SHEET

**Software Stack:**
```
Edge Device (Raspberry Pi 5 8GB):
├── Home Assistant (Supervised)
│   ├── Kasa/Tapo Integration
│   ├── SensorPush Integration
│   ├── Modbus Integration (CO2)
│   ├── ZHA/Zigbee2MQTT (soil sensors)
│   ├── MQTT (Mosquitto)
│   ├── Camera Integration (Amcrest)
│   └── InfluxDB + Grafana (historical data)
├── Veridian Edge Agent (Docker)
│   ├── SensorPush Cloud API
│   ├── SQLite buffer on NVMe
│   └── WebSocket client
├── go2rtc (Camera streaming)
│   ├── RTSP ingest from NVR
│   └── WebRTC playback
└── LoRa Gateway (ChirpStack)
    ├── Soil Scout integration
    └── MQTT bridge
```

**Enhanced Features:**
- CO2 monitoring (8 zones)
- Camera surveillance (30-day retention)
- E-Ink displays (8 zones)
- LTE internet failover
- Physical alerts (strobe + buzzer)
- Professional soil sensors (Soil Scout)
- Modbus integration
- InfluxDB + Grafana analytics

---

## TIER 3: TOP-OF-THE-LINE ★★★
**"Enterprise Grade" - Maximum Reliability & Scalability**

### Overview
Commercial-grade hardware with full redundancy, industrial sensors, advanced analytics, and enterprise-level support.

---

### EDGE COMPUTING CLUSTER

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **Primary Edge Node** | Raspberry Pi 5 8GB + NVMe | 1 | $160 | Full active setup |
| **Secondary Edge Node** | Raspberry Pi 5 8GB + NVMe | 1 | $160 | Hot standby |
| **Quorum Server** | Raspberry Pi 4 4GB | 1 | $120 | Kubernetes + HA |
| **NVMe Storage** | 1TB Samsung 970 EVO | 3 | $90/ea | $270 total |
| **UPS Systems** | CyberPower 1500VA x3 | 3 | $180/ea | $540 total |
| **Edge Cluster Subtotal** | | | **$1,410** | |

---

### ENVIRONMENTAL SENSORS

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **SensorPush HT.w** | Industrial temp/RH | 26 | $110/ea | $2,860 |
| **CO2 Sensors** | SenseAir S8 Pro | 8 | $350/ea | $2,800 |
| **PAR Sensors** | Apogee SQ-500 (optional) | 5 | $600/ea | $3,000 |
| **SensorPush Gateways** | G1 x4 (redundant) | 4 | $100/ea | $400 |
| **RS485 Modbus Network** | Industrial grade | 1 | $400 | |
| **Sensor Enclosures** | NEMA 4X (IP66) | 26 | $25/ea | $650 |
| **Mounting Systems** | Stainless steel | 26 | $15/ea | $390 |
| **Sensors Subtotal** | | | **$8,500** | |

---

### SOIL SENSORS (Enterprise)

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **Soil Scout Pro** | LoRaWAN, multi-depth | 10 | $250/ea | $2,500 (2 per GH) |
| **Additional LoRa Sensors** | Soil temp + EC + pH | 5 | $180/ea | $900 (1 per GH) |
| **LoRa Gateway** | RAK Wireless Outdoor | 1 | $350 | High-gain antenna |
| **ChirpStack Server** | Open-source | 1 | $0 | Software |
| **Soil Sensor Subtotal** | | | **$3,750** | |

**Multi-Parameter Sensors:**
- Soil moisture (3 depths: 6", 12", 18")
- Soil temperature
- Electrical conductivity (EC)
- pH (select models)
- Battery: 10 years

---

### POWER CONTROL SYSTEM

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **PLC** | Click PLC (AutomationDirect) | 1 | $400 | Programmable logic |
| **I/O Modules** | 16-in / 16-out relay | 1 | $300 | DIN mount |
| **Kasa EP25 Smart Plugs** | 15A energy monitoring | 10 | $11.25/ea | $112.50 |
| **Mechanical Contactors** | Siemens 40A @ 240V | 8 | $65/ea | $520 |
| **Control Enclosures** | NEMA 12 wall mount | 2 | $150/ea | $300 |
| **Manual Override Panels** | Emergency stop switches | 2 | $200/ea | $400 |
| **Wiring & Terminal Blocks** | 12 AWG, din rail | 1 | $400 | |
| **Power Control Subtotal** | | | **$2,432.50** | |

---

### CAMERA SURVEILLANCE

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **PTZ Cameras** | Axis P5635-E (4K) | 8 | $800/ea | $6,400 |
| **NVR** | Axis Camera Station Pro | 1 | $600 | 32-channel |
| **PoE+ Switch** | Cisco Catalyst 9200 | 1 | $800 | 16-port |
| **Storage Array** | NAS 4-bay (Synology) | 1 | $600 | RAID 5 |
| **Hard Drives** | 8TB WD Red Pro x4 | 4 | $250/ea | $1,000 |
| **Camera Cabling** | Cat6a outdoor shielded | 6 | $60 | $360 |
| **Surveillance Subtotal** | | | **$9,760** | |

---

### NETWORK & INFRASTRUCTURE

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **WiFi Access Points** | Ubiquiti UniAP 6 Pro | 3 | $250/ea | $750 |
| **Core Switch** | Ubiquiti UniFi Switch 16 | 1 | $350 | PoE+ |
| **Aggregation Switch** | Netgear 24-port | 1 | $300 | |
| **4G LTE Gateway** | Cradlepoint IBR900 | 1 | $800 | Dual modem |
| **Cellular Data Plans** | 20GB/month x2 | 2 | $50/mo | $100/mo |
| **Ethernet Cables** | Cat6a shielded | 8 | $60 | $480 |
| **Network Subtotal** | | | **$3,480** + $100/mo | |

---

### ALERTS, DISPLAYS & POWER

| Component | Specification | Qty | Price | Notes |
|-----------|--------------|-----|-------|-------|
| **Industrial Strobes** | Federal Signal | 4 | $120/ea | $480 |
| **Horn Strobes** | System Sensor | 4 | $90/ea | $360 |
| **PA System** | 30W amp + speakers | 1 | $400 | |
| **E-Ink Displays (Large)** | Waveshare 7.5" V2 | 8 | $50/ea | $400 |
| **E-Ink Tags (Small)** | LILYGO T5 2.13" | 30 | $25/ea | $750 |
| **ESP32 Controllers** | Custom PCB + ESP32 | 38 | $20/ea | $760 |
| **Solar Panels** | 6W panel + battery | 38 | $25/ea | $950 |
| **MQTT Gateways** | ESP32 bridge | 2 | $30/ea | $60 |
| **Online UPS** | APC Smart-UPS 2200VA | 1 | $1,800 | |
| **Generator Hookup** | Transfer switch | 1 | $600 | |
| **Alerts, Displays & Power Subtotal** | | | **$7,220** | |

---

### TIER 3 TOTAL COST

| Category | Cost |
|----------|------|
| Edge Computing Cluster | $1,410 |
| Environmental Sensors (Air) | $8,500 |
| Soil Sensors (Enterprise) | $3,750 |
| Power Control System | $2,432.50 |
| Camera Surveillance | $9,760 |
| Network Infrastructure | $3,480 |
| Alerts, Displays & Power | $7,220 |
| **TIER 3 TOTAL** | **$36,552.50** + $100/mo cellular |

**Rounded for Budgeting:** **$36,600 + $100/mo**

---

## COMPARISON MATRIX

### Quick Comparison Table

```
┌──────────────────────────────────────────────────────────────────────────────┐
│                         TIER COMPARISON AT A GLANCE                          │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FEATURE                    TIER 1        TIER 2        TIER 3              │
│  ─────────────────────────  ─────────────  ─────────────  ────────────────  │
│  TOTAL COST                 $2,200        $10,500       $36,600             │
│                                                                              │
│  EDGE DEVICE               Pi 4 (4GB)    Pi 5 (8GB)    Pi 5 Cluster (3)     │
│  STORAGE                   32GB SD       500GB NVMe     1TB NVMe x3 (RAID)  │
│  UPS RUNTIME               30 min        2 hours        4-6 hours           │
│                                                                              │
│  AIR SENSORS               HT1 (26)      HT.w (26)      HT.w (26)           │
│  AIR SENSOR ACCURACY       ±0.36°F       ±0.18°F        ±0.18°F             │
│  CO2 MONITORING            ❌ No          ✅ Yes (8)      ✅ Yes (8)          │
│  PAR/LIGHT                 ❌ No          ❌ No           ✅ Yes (5)          │
│                                                                              │
│  SOIL SENSORS              Optional      Zigbee +       Soil Scout Pro      │
│                            (DIY/Zigbee)  Soil Scout     (multi-depth)       │
│  SOIL SENSOR TYPES         Capacitive    Capacitive +   Moisture +          │
│                                          LoRa           EC + pH             │
│                                                                              │
│  POWER CONTROL             EP10 (10)     EP25 + 30A     PLC + EP25 + 40A    │
│  ENERGY MONITORING         ❌ No          ✅ Yes          ✅ Yes              │
│                                                                              │
│  CAMERAS                   ❌ No          4MP (8)        4K PTZ (8)          │
│  CAMERA RETENTION          N/A           30 days        90+ days            │
│                                                                              │
│  NETWORK REDUNDANCY        Single AP     Dual AP + 4G   Triple AP + Dual 4G │
│  PHYSICAL ALERTS           ❌ No          Strobe + buzzer Horn strobe + PA   │
│                                                                              │
│  E-INK DISPLAYS            ❌ No          8 rooms        38 displays         │
│                                                                              │
│  HIGH AVAILABILITY         ❌ No          ❌ No           ✅ Kubernetes        │
│  UPTIME TARGET             95%           99%            99.99%              │
│                                                                              │
│  INSTALLATION TIME         1 weekend     1 week         2-3 weeks           │
│  MAINTENANCE               DIY           DIY + vendor   Professional + SLA  │
│  LIFESPAN                  2-3 years     5 years        7-10 years          │
│                                                                              │
│  BEST FOR                  Testing,      Production,    Enterprise,         │
│                            budget        small comm.    large-scale         │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘
```

---

## DETAILED COST BREAKDOWN

### Tier 1 - Baseline ($2,200)

```
┌─────────────────────────────────────────────────────────────┐
│ TIER 1: BASELINE LINE ITEM COSTS                            │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│ EDGE DEVICE ($174)                                          │
│ ├─ Raspberry Pi 4 (4GB)                         $60.00     │
│ ├─ Official power supply                        $12.00     │
│ ├─ Passive cooling case                         $15.00     │
│ ├─ 32GB MicroSD card                            $12.00     │
│ ├─ Ethernet cable (50ft)                        $15.00     │
│ └─ APC Back-UPS 425VA                          $60.00     │
│                                                             │
│ AIR SENSORS ($1,600.70)                                    │
│ ├─ SensorPush HT1 x26                         $1,428.70   │
│ ├─ SensorPush G1 Gateway x2                     $200.00    │
│ ├─ USB power adapters x2                         $20.00    │
│ └─ Mounting hardware (velcro, strips)            $52.00    │
│                                                             │
│ SOIL SENSORS (OPTIONAL)                                   │
│ ├─ Zigbee Option ($198)                                  │
│ │  ├─ Tuya TS0601 x10                         $180.00    │
│ │  └─ Sonoff Zigbee Dongle                      $18.00    │
│ ├─ DIY Option ($255)                                       │
│ │  ├─ Capacitive sensors x10                   $80.00    │
│ │  ├─ MCP3008 ADC x2                            $10.00    │
│ │  ├─ Grove Base HAT                           $15.00    │
│ │  ├─ IP65 enclosures x10                     $120.00    │
│ │  └─ Cabling & connectors                     $30.00    │
│                                                             │
│ POWER CONTROL ($90)                                        │
│ └─ Kasa EP10 4-pack x3                       $89.97     │
│                                                             │
│ NETWORK ($155)                                             │
│ ├─ Ubiquiti UniAP AC Lite                     $90.00     │
│ ├─ TP-Link 5-port switch                      $25.00     │
│ └─ Cat5e outdoor cables x3                    $120.00    │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│ TOTAL: $2,019.70 (AIR ONLY)                                │
│        $2,217.70 (WITH ZIGBEE SOIL)                         │
│        $2,274.70 (WITH DIY SOIL)                            │
└─────────────────────────────────────────────────────────────┘
```

### Tier 2 - Premium ($10,500)

```
┌─────────────────────────────────────────────────────────────┐
│ TIER 2: PREMIUM LINE ITEM COSTS                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│ EDGE DEVICE ($380)                                          │
│ ├─ Raspberry Pi 5 (8GB)                         $95.00     │
│ ├─ Pimoroni NVMe Base                          $25.00     │
│ ├─ 500GB NVMe SSD                              $55.00     │
│ ├─ 27W USB-C PD supply                         $20.00     │
│ ├─ Active cooling case                          $35.00     │
│ └─ CyberPower 1350VA UPS                       $150.00    │
│                                                             │
│ AIR SENSORS ($5,283)                                        │
│ ├─ SensorPush HT.w x26                      $2,860.00    │
│ ├─ SensorPush G1 Gateway x3                    $300.00    │
│ ├─ SenseAir S8 CO2 x8                        $1,600.00    │
│ ├─ IP65 enclosures x26                         $390.00    │
│ ├─ Stainless mounts x26                        $208.00    │
│ └─ USB-RS485 adapter                           $25.00     │
│                                                             │
│ SOIL SENSORS ($1,200)                                       │
│ ├─ Tuya TS0601 x15                             $270.00    │
│ ├─ Soil Scout (LoRa) x5                       $750.00     │
│ └─ RAK Wireless LoRa Gateway                   $180.00    │
│                                                             │
│ POWER CONTROL ($652.50)                                     │
│ ├─ Kasa EP25 4-pack x3                      $134.97     │
│ ├─ 30A DIN relays x5                          $225.00    │
│ ├─ NEMA 1 enclosures x5                        $125.00    │
│ ├─ Arduino Nano + relay                        $40.00     │
│ └─ Wiring & connectors                        $150.00     │
│                                                             │
│ CAMERAS ($1,200)                                            │
│ ├─ Amcrest 4MP cameras x8                    $480.00     │
│ ├─ Amcrest NV4108 NVR                         $150.00    │
│ ├─ Netgear PoE+ switch                        $120.00    │
│ ├─ Outdoor housing x8                         $160.00    │
│ ├─ Cat6 cabling (4x100ft)                     $200.00    │
│ └─ 4TB HDD                                    $90.00     │
│                                                             │
│ NETWORK ($1,100)                                            │
│ ├─ Ubiquiti UniAP 6 LR x2                    $300.00    │
│ ├─ Netgear 16-port PoE                        $200.00    │
│ ├─ Cat6 outdoor burial x5                     $250.00    │
│ └─ Peplink BR1 Mini 4G                        $350.00    │
│                                                             │
│ ALERTS & DISPLAYS ($625)                                    │
│ ├─ Waveshare 7.5" e-ink x8                    $360.00    │
│ ├─ LILYGO T5 ESP32 x8                         $200.00    │
│ ├─ Industrial strobe                           $45.00     │
│ └─ Piezo buzzer                                $20.00     │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│ TOTAL: $10,440.50                                           │
└─────────────────────────────────────────────────────────────┘
```

### Tier 3 - Enterprise ($36,600)

```
┌─────────────────────────────────────────────────────────────┐
│ TIER 3: ENTERPRISE LINE ITEM COSTS                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│ EDGE CLUSTER ($1,410)                                       │
│ ├─ Raspberry Pi 5 8GB x2                    $190.00     │
│ ├─ Raspberry Pi 4 4GB                          $120.00    │
│ ├─ 1TB NVMe SSD x3                             $270.00    │
│ ├─ CyberPower 1500VA x3                       $540.00    │
│ ├─ Cases, cooling, mounting                   $180.00    │
│ └─ K3s Kubernetes setup                      $110.00     │
│                                                             │
│ AIR SENSORS ($8,500)                                         │
│ ├─ SensorPush HT.w x26                      $2,860.00    │
│ ├─ SenseAir S8 Pro CO2 x8                   $2,800.00    │
│ ├─ Apogee SQ-500 PAR x5                      $3,000.00   │
│ ├─ G1 Gateways x4                             $400.00    │
│ ├─ Industrial RS485 network                  $400.00     │
│ ├─ NEMA 4X enclosures x26                     $650.00    │
│ └─ Stainless mounts x26                       $390.00    │
│                                                             │
│ SOIL SENSORS ($3,750)                                        │
│ ├─ Soil Scout Pro x10                         $2,500.00  │
│ ├─ Multi-param sensors x5                      $900.00    │
│ ├─ RAK Outdoor LoRa Gateway                   $350.00    │
│ └─ Installation & mounting                     $0.00     │
│                                                             │
│ POWER CONTROL ($2,432.50)                                   │
│ ├─ Click PLC                                   $400.00    │
│ ├─ I/O modules (16-in/16-out)                 $300.00    │
│ ├─ Kasa EP25 4-pack x3                       $134.97     │
│ ├─ Siemens 40A contactors x8                  $520.00    │
│ ├─ NEMA 12 enclosures x2                      $300.00    │
│ ├─ Override panels x2                          $400.00    │
│ └─ Industrial wiring                          $378.53    │
│                                                             │
│ CAMERAS ($9,760)                                            │
│ ├─ Axis P5635-E 4K PTZ x8                  $6,400.00    │
│ ├─ Axis Camera Station Pro                    $600.00    │
│ ├─ Cisco Catalyst PoE+ switch                 $800.00    │
│ ├─ Synology 4-bay NAS                         $600.00    │
│ ├─ 8TB WD Red Pro x4                         $1,000.00    │
│ └─ Cat6a shielded cabling x6                   $360.00    │
│                                                             │
│ NETWORK ($3,480 + $100/mo)                                 │
│ ├─ Ubiquiti UniAP 6 Pro x3                    $750.00    │
│ ├─ Ubiquiti UniFi Switch 16                   $350.00    │
│ ├─ Netgear 24-port aggregation                 $300.00    │
│ ├─ Cradlepoint IBR900 dual LTE                $800.00    │
│ ├─ Cellular data (2x20GB)            $100.00/mo           │
│ └─ Cat6a shielded burial x8                    $480.00    │
│                                                             │
│ ALERTS, DISPLAYS & POWER ($7,220)                             │
│ ├─ Federal Signal strobes x4                  $480.00    │
│ ├─ System Sensor horn strobes x4              $360.00    │
│ ├─ PA system with speakers                    $400.00    │
│ ├─ Waveshare 7.5" e-ink x8                    $400.00    │
│ ├─ LILYGO T5 2.13" x30                        $750.00    │
│ ├─ Custom ESP32 PCB x38                       $760.00    │
│ ├─ Solar panels x38                            $950.00    │
│ ├─ MQTT gateways x2                            $60.00     │
│ ├─ APC Smart-UPS 2200VA                     $1,800.00    │
│ ├─ Generator transfer switch                  $600.00    │
│ └─ Installation supplies                      $660.00    │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│ ONE-TIME TOTAL: $36,552.50                                 │
│ MONTHLY: $100 (cellular)                                   │
└─────────────────────────────────────────────────────────────┘
```

---

## SENSOR PLACEMENT GUIDE

### Greenhouse Air Sensor Positioning (4 sensors)

```
┌────────────────────────────────────────────────────────────┐
│                     GREENHOUSE (TOP VIEW)                  │
├────────────────────────────────────────────────────────────┤
│                                                            │
│   NORTH WALL                                              │
│    ┌─────────────────────────────────────────────┐       │
│    │                                             │       │
│    │   [A1]                                  [A2] │       │
│    │    │                                      │    │       │
│    │    │          PLANTS / CANOPY             │    │       │
│    │    │                                      │    │       │
│    │   [A3]                                  [A4] │       │
│    │                                             │       │
│    └─────────────────────────────────────────────┘       │
│                  SOUTH WALL                               │
│                                                            │
│   [A1] North wall sensor                                  │
│   [A2] South wall sensor                                  │
│   [A3] East wall sensor                                   │
│   [A4] West wall sensor                                   │
│                                                            │
│   Height: Canopy level (3-5 feet above ground)           │
│   Spacing: 3 feet from corners                            │
│   Avoid: Direct sunlight, vents, fans                     │
│                                                            │
└────────────────────────────────────────────────────────────┘
```

### Greenhouse Soil Sensor Placement (Optional)

**Tier 1 (Zigbee/DIY):**
- 2 sensors per greenhouse
- Install in representative plant locations
- Depth: 4-6 inches (root zone)
- Position: Near active root mass

**Tier 2 (Soil Scout):**
- 1 sensor per greenhouse
- Center of growing area
- Depth: 12-18 inches buried
- LoRa transmission through soil

**Tier 3 (Multi-depth):**
- 2 sensors per greenhouse
- Each sensor measures at 3 depths (6", 12", 18")
- Provides complete soil profile

### Container Air Sensor Placement (2 sensors)

```
┌──────────────────────────────────────────┐
│         SHIPPING CONTAINER               │
│                                          │
│   [DOOR]                         [BACK]  │
│      │                              │    │
│      ▼                              ▼    │
│   [A1]                          [A2]     │
│  Front                          Back     │
│                                          │
│   Height: Eye level (4-6 feet)           │
│   Position: 6 feet from ends             │
│   Mounting: Wall bracket or stand        │
│                                          │
│   Optional: CO2 sensor near [A1]         │
│                                          │
└──────────────────────────────────────────┘
```

---

## HOMEASSISTANT INTEGRATION

### Configuration Files

**`configuration.yaml`**
```yaml
# SensorPush Integration
sensorpush:
  email: !secret sensorpush_email
  password: !secret sensorpush_password

# Kasa/Tapo Smart Plugs
tplink:
  discovery: true

# Zigbee (if using Zigbee soil sensors)
zha:
  enable_quirks: true
  radio_type: ezsp
  device_config:
    *.battery_voltage:
      polling_intensity: 1

# MQTT (for soil sensors, e-ink displays)
mqtt:
  broker: localhost
  port: 1883
  discovery: true

# Veridian Edge Agent (REST API)
rest:
  - resource: http://localhost:3030/health
    scan_interval: 30
    sensor:
      - name: "Veridian Edge Status"
        value_template: "{{ value_json.status }}"
      - name: "Veridian Edge Sensor Count"
        value_template: "{{ value_json.sensor_count }}"

# Modbus (for CO2 sensors - Tier 2/3)
modbus:
  - name: "CO2 Sensors"
    type: tcp
    host: !secret modbus_host
    port: 502
    sensors:
      - name: "Greenhouse 1 CO2"
        slave: 1
        address: 0
        input_type: input
        count: 1
        data_type: uint16
        scale: 1
        unit_of_measurement: "ppm"
```

### Example Automations

**1. Emergency Ventilation (Temperature)**
```yaml
automation:
  - alias: "GH1 - Emergency Ventilation"
    description: "Turn on fan if temperature exceeds 85°F"
    trigger:
      - platform: numeric_state
        entity_id: sensor.greenhouse_1_temperature
        above: 85
        for:
          minutes: 1
    condition:
      - condition: state
        entity_id: input_boolean.automation_mode
        state: "on"
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.greenhouse_1_fan
      - service: notify.mobile_app
        data:
          title: "🚨 GH1 High Temp Alert"
          message: "Temperature exceeded 85°F. Fan activated."
      - service: input_boolean.turn_on
        target:
          entity_id: input_boolean.gh1_emergency_mode
    mode: single
```

**2. Soil Moisture Alert (Zigbee Sensor)**
```yaml
automation:
  - alias: "GH1 - Low Soil Moisture"
    description: "Alert when soil moisture drops below 30%"
    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 {{ states('sensor.greenhouse_1_soil_moisture') }}%. Watering needed."
      - service: input_select.select_option
        target:
          entity_id: input_select.gh1_irrigation_status
        data:
          option: "Water Needed"
    mode: single
```

**3. Container Dehumidifier Control**
```yaml
automation:
  - alias: "Container 1 - Dehumidifier"
    description: "Turn on dehumidifier if humidity exceeds 65%"
    trigger:
      - platform: numeric_state
        entity_id: sensor.container_1_humidity
        above: 65
        for:
          minutes: 5
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.container_1_dehumidifier
      - service: notify.mobile_app
        data:
          title: "💨 Container 1 High Humidity"
          message: "Humidity at {{ states('sensor.container_1_humidity') }}%. Dehumidifier activated."
    mode: single
```

**4. CO2 Alert (Tier 2/3)**
```yaml
automation:
  - alias: "GH1 - High CO2 Alert"
    description: "Alert if CO2 exceeds 1500 ppm"
    trigger:
      - platform: numeric_state
        entity_id: sensor.greenhouse_1_co2
        above: 1500
        for:
          minutes: 5
    action:
      - service: notify.mobile_app
        data:
          title: "⚠️ GH1 High CO2"
          message: "CO2 level: {{ states('sensor.greenhouse_1_co2') }} ppm"
      - service: switch.turn_on
        target:
          entity_id: switch.greenhouse_1_ventilation_fan
    mode: single
```

**5. Soil Sensor Battery Alert**
```yaml
automation:
  - alias: "Soil Sensor - Low Battery Alert"
    description: "Alert when soil sensor battery is low"
    trigger:
      - platform: numeric_state
        entity_id: sensor.greenhouse_1_soil_sensor_battery
        below: 20
    action:
      - service: notify.mobile_app
        data:
          title: "🔋 Low Battery: GH1 Soil Sensor"
          message: "Soil sensor battery at {{ states('sensor.greenhouse_1_soil_sensor_battery') }}%. Replace soon."
      - service: persistent_notification.create
        data:
          title: "Soil Sensor Maintenance"
          message: "Greenhouse 1 soil sensor battery needs replacement."
          notification_id: "soil_sensor_battery_gh1"
    mode: single
```

### Lovelace Dashboard Example

**`ui-lovelace.yaml`**
```yaml
title: Veridian Grow Operations
views:
  - title: Greenhouse Overview
    path: greenhouses
    icon: mdi:leaf
    badges:
      - entity: sensor.veridian_edge_status
      - entity: sensor.greenhouse_1_temperature
      - entity: sensor.greenhouse_1_humidity
      - entity: sensor.greenhouse_1_vpd
    cards:
      - type: vertical-stack
        cards:
          - type: glance
            title: Greenhouse 1
            columns: 4
            entities:
              - entity: sensor.greenhouse_1_temperature
                name: Temperature
                icon: mdi:thermometer
              - entity: sensor.greenhouse_1_humidity
                name: Humidity
                icon: mdi:water-percent
              - entity: sensor.greenhouse_1_vpd
                name: VPD
                icon: mdi:thermometer-lines
              - entity: sensor.greenhouse_1_soil_moisture
                name: Soil Moisture
                icon: mdi:water
          - type: horizontal-stack
            cards:
              - type: entity-button
                entity: switch.greenhouse_1_fan
                name: Fan
                icon: mdi:fan
                tap_action:
                  action: toggle
              - type: entity-button
                entity: switch.greenhouse_1_heater
                name: Heater
                icon: mdi:radiator
                tap_action:
                  action: toggle
          - type: history-graph
            title: 24 Hour History
            hours_to_show: 24
            entities:
              - entity: sensor.greenhouse_1_temperature
              - entity: sensor.greenhouse_1_humidity
              - entity: sensor.greenhouse_1_soil_moisture

  - title: Containers
    path: containers
    icon: mdi:package-variant
    cards:
      - type: glance
        title: Drying Container 1
        entities:
          - entity: sensor.container_1_temperature
          - entity: sensor.container_1_humidity
          - entity: sensor.container_1_vpd
      - type: entities
        title: Controls
        entities:
          - entity: switch.container_1_dehumidifier
          - entity: switch.container_1_fan
```

---

## INSTALLATION CHECKLIST

### Pre-Installation

- [ ] Site survey completed
- [ ] WiFi coverage tested (min -60 dBm in all locations)
- [ ] Power outlets identified and labeled
- [ ] Equipment list finalized
- [ ] Budget approved
- [ ] Tier selected (1/2/3)
- [ ] Soil sensor locations marked (if applicable)

### Equipment Procurement

**Edge Device:**
- [ ] Raspberry Pi ordered
- [ ] Power supply ordered
- [ ] Case ordered
- [ ] Storage (SD card/NVMe) ordered
- [ ] UPS ordered

**Sensors:**
- [ ] SensorPush HT1/HT.w ordered (26 units)
- [ ] SensorPush G1 Gateway(s) ordered (2-4 units)
- [ ] Soil sensors ordered (if using)
- [ ] CO2 sensors ordered (Tier 2/3)
- [ ] Sensor enclosures ordered (Tier 2/3)
- [ ] Mounting hardware ordered

**Power Control:**
- [ ] Kasa smart plugs ordered (10 units)
- [ ] Relays/contactors ordered (Tier 2/3)
- [ ] Control enclosures ordered (Tier 2/3)
- [ ] PLC ordered (Tier 3)

**Network:**
- [ ] WiFi access point(s) ordered
- [ ] Network switch(es) ordered
- [ ] Ethernet cables ordered
- [ ] PoE switch ordered (Tier 2/3 for cameras)

**Optional (Tier 2/3):**
- [ ] Cameras ordered
- [ ] NVR ordered
- [ ] Storage drives ordered
- [ ] E-ink displays ordered
- [ ] ESP32 controllers ordered
- [ ] Alert equipment ordered (strobes, buzzers)
- [ ] 4G LTE gateway ordered
- [ ] LoRa gateway ordered (for soil sensors)

### Physical Installation

**Step 1: Edge Device Setup (Day 1)**
- [ ] Mount Raspberry Pi in central location
- [ ] Connect to wired network (preferred)
- [ ] Install UPS
- [ ] Install Home Assistant OS
- [ ] Configure network settings
- [ ] Test internet connectivity
- [ ] Update firmware

**Step 2: Sensor Installation (Day 2-3)**
- [ ] Install SensorPush G1 Gateway(s)
  - [ ] Central location for max coverage
  - [ ] Connect to power
  - [ ] Connect to WiFi network
  - [ ] Verify gateway status (LED solid)
- [ ] Pair all SensorPush HT1/HT.w sensors
  - [ ] Open SensorPush mobile app
  - [ ] Add each sensor via Bluetooth
  - [ ] Verify each sensor appears in app
  - [ ] Label sensors (GH1-N, GH1-S, etc.)
- [ ] Mount sensors in locations per placement guide
  - [ ] Greenhouse 1: 4 sensors (N, S, E, W)
  - [ ] Greenhouse 2: 4 sensors
  - [ ] Greenhouse 3: 4 sensors
  - [ ] Greenhouse 4: 4 sensors
  - [ ] Greenhouse 5: 4 sensors
  - [ ] Container 1: 2 sensors (front, back)
  - [ ] Container 2: 2 sensors
  - [ ] Container 3: 2 sensors
- [ ] Test sensor data flow
  - [ ] Check mobile app for readings
  - [ ] Verify all sensors reporting (<5 min interval)
  - [ ] Check battery levels
- [ ] Install soil sensors (if using)
  - [ ] Zigbee: Pair via ZHA/Zigbee2MQTT
  - [ ] DIY: Wire to ADC + Raspberry Pi
  - [ ] LoRa: Configure gateway + sensors
  - [ ] Bury sensors at appropriate depth
  - [ ] Test readings

**Step 3: Power Control Setup (Day 4)**
- [ ] Install Kasa smart plugs
  - [ ] Connect to equipment (fans, heaters, dehumidifiers)
  - [ ] Plug in to wall power
  - [ ] Add to Kasa app
  - [ ] Test on/off via app
  - [ ] Label plugs in app (GH1-Fan, etc.)
- [ ] Add to Home Assistant
  - [ ] Discover via TPLink integration
  - [ ] Rename entities
  - [ ] Test on/off via HA
- [ ] Install mechanical relays (Tier 2/3)
  - [ ] Mount in enclosures
  - [ ] Wire to equipment
  - [ ] Connect to control module (Arduino/PLC)
  - [ ] Test operation

**Step 4: Network Setup (Day 5)**
- [ ] Install WiFi access point(s)
  - [ ] Mount in elevated location
  - [ ] Connect to network switch
  - [ ] Configure SSID and password
  - [ ] Test coverage in all greenhouses/containers
- [ ] Install network switch
  - [ ] Mount in central location
  - [ ] Connect to edge device
  - [ ] Connect to router
- [ ] Run ethernet cables
  - [ ] Bury outdoor cables (if needed)
  - [ ] Test connections
  - [ ] Verify bandwidth (speedtest)

**Step 5: Optional Equipment (Day 6-10)**
- [ ] Install cameras (Tier 2/3)
  - [ ] Mount cameras at locations
  - [ ] Run Cat6 cabling
  - [ ] Connect to NVR
  - [ ] Configure RTSP streams
  - [ ] Add to go2rtc
  - [ ] Test feeds
- [ ] Install CO2 sensors (Tier 2/3)
  - [ ] Mount sensors
  - [ ] Wire to RS485 bus
  - [ ] Connect to USB-RS485 adapter
  - [ ] Configure Modbus in HA
  - [ ] Test readings
- [ ] Install E-ink displays (Tier 2/3)
  - [ ] Mount displays
  - [ ] Connect ESP32 controllers
  - [ ] Flash firmware
  - [ ] Configure MQTT topics
  - [ ] Test updates
- [ ] Install alert systems (Tier 2/3)
  - [ ] Mount strobes/buzzers
  - [ ] Wire to GPIO/relay
  - [ ] Configure automations
  - [ ] Test alerts

### Software Configuration

**Step 6: Veridian Edge Agent Setup**
- [ ] Clone repository: `git clone https://git.runfoo.run/malty/veridian-edge.git`
- [ ] Install Bun runtime
- [ ] Run installer: `sudo ./scripts/install.sh`
- [ ] Edit config: `/opt/veridian-edge/config.json`
  ```json
  {
    "facilityId": "your-facility-uuid",
    "server": {
      "url": "https://api.veridian.runfoo.run",
      "apiKey": "your-api-key",
      "heartbeatIntervalSec": 60
    },
    "sensorpush": {
      "email": "sensors@facility.com",
      "password": "your-password"
    },
    "sensorMappings": [
      {
        "sensorId": "123456.7890",
        "roomId": "greenhouse-1-north",
        "name": "Greenhouse 1 North Wall"
      }
      // ... 26 total mappings
    ]
  }
  ```
- [ ] Enable/disable alerts
- [ ] Test: `curl http://localhost:3030/health`
- [ ] Check logs: `journalctl -u veridian-edge -f`

**Step 7: Home Assistant Setup**
- [ ] Install HACS (Home Assistant Community Store)
- [ ] Install SensorPush custom integration
- [ ] Configure SensorPush integration
  - [ ] Enter email/password
  - [ ] Verify sensors appear
- [ ] Discover Kasa smart plugs
  - [ ] Should auto-discover on same network
  - [ ] Rename entities
- [ ] Configure Zigbee (if using soil sensors)
  - [ ] Add ZHA integration
  - [ ] Pair Zigbee coordinator (USB dongle)
  - [ ] Pair each soil sensor
  - [ ] Verify entities
- [ ] Configure Modbus (if using CO2 sensors)
  - [ ] Add Modbus integration
  - [ ] Enter TCP/IP settings
  - [ ] Configure sensors
  - [ ] Test readings
- [ ] Create automations (see examples)
- [ ] Build dashboards (Lovelace)

**Step 8: Integration Testing**
- [ ] Configure Edge Agent → Home Assistant communication
- [ ] Test Veridian Cloud → Edge Agent sync
- [ ] Verify alert flow:
  1. Trigger alert condition (high temp, low moisture, etc.)
  2. Verify alert appears in Veridian
  3. Verify Edge Agent receives alert
  4. Verify HomeAssistant automation triggers
  5. Verify Kasa plug toggles
- [ ] Test offline resilience
  - [ ] Disconnect internet
  - [ ] Verify data buffers to SQLite
  - [ ] Reconnect internet
  - [ ] Verify buffered data syncs to cloud
- [ ] Test failover scenarios (Tier 2/3)
  - [ ] Power cycle edge device
  - [ ] Verify auto-restart
  - [ ] Test 4G failover (if equipped)

### Testing & Commissioning (Day 11-14)

- [ ] Sensor accuracy test
  - [ ] Compare to reference thermometer/hygrometer
  - [ ] Allow 30 min stabilization
  - [ ] Document any deviations
- [ ] Alert threshold testing
  - [ ] Manually trigger alerts (heat sensor with hair dryer, etc.)
  - [ ] Verify automations trigger correctly
  - [ ] Verify notifications sent
  - [ ] Verify equipment activates
- [ ] Power control testing
  - [ ] Test each smart plug manually
  - [ ] Verify equipment operates correctly
  - [ ] Measure current draw (verify within ratings)
- [ ] Camera testing (Tier 2/3)
  - [ ] Verify RTSP streams
  - [ ] Test go2rtc WebRTC playback
  - [ ] Check recording on NVR
  - [ ] Test motion detection
- [ ] Network testing
  - [ ] Speedtest at each location
  - [ ] Test failover (if equipped)
  - [ ] Verify coverage (WiFi signal strength)
- [ ] Edge device failover testing (Tier 3)
  - [ ] Power down primary node
  - [ ] Verify secondary takes over
  - [ ] Verify no data loss
- [ ] Battery life monitoring
  - [ ] Log initial battery levels for all sensors
  - [ ] Set up battery alerts (automation)
- [ ] Performance testing
  - [ ] Monitor CPU usage
  - [ ] Monitor memory usage
  - [ ] Monitor network bandwidth
  - [ ] Check storage capacity
- [ ] User training
  - [ ] Train staff on dashboard navigation
  - [ ] Train staff on alert response procedures
  - [ ] Provide documentation

### Documentation

- [ ] Create network diagram (IP addresses, etc.)
- [ ] Document sensor IDs and mappings
- [ ] Document automation logic
- [ ] Create maintenance schedule
- [ ] Document emergency procedures
- [ ] Create runbook for common issues
- [ ] Label all equipment
  - [ ] QR codes for equipment info
  - [ ] Color-coded cables
  - [ ] Sensor labels (GH1-N, etc.)
- [ ] Backup configurations
  - [ ] Home Assistant snapshot
  - [ ] Veridian Edge Agent config
  - [ ] Network device configs

---

## MAINTENANCE SCHEDULE

### Daily Tasks (5 minutes)

- [ ] Check edge device status (green light on dashboard)
- [ ] Review alerts (clear false alarms)
- [ ] Verify sensor data freshness (last reading <5 min)
- [ ] Check camera feeds (Tier 2/3) - verify online

### Weekly Tasks (30 minutes)

- [ ] Review sensor battery levels (replace <20%)
- [ ] Check UPS status (replace battery if needed)
- [ ] Review network connectivity logs
- [ ] Test one smart plug (rotate through all plugs monthly)
- [ ] Clean camera lenses (Tier 2/3)
- [ ] Check storage capacity (NVR, database)

### Monthly Tasks (2 hours)

- [ ] Update Home Assistant (check release notes first)
- [ ] Update Veridian Edge Agent
- [ ] Review log files for errors
- [ ] Backup configuration (download HA snapshot)
- [ ] Test automations (simulate alert conditions)
- [ ] Check SD card/NVMe health (run diagnostic)
- [ ] Review camera storage (Tier 2/3)
- [ ] Test UPS battery (runtime test)
- [ ] Clean SensorPush gateways (compressed air)

### Quarterly Tasks (4 hours)

- [ ] Deep clean all equipment
- [ ] Verify sensor accuracy (compare to reference)
- [ ] Update firmware (all devices)
- [ ] Review and update automations (adjust thresholds)
- [ ] Network equipment inspection (cables, connectors)
- [ ] Test all emergency systems (strobes, buzzers)
- [ ] Review and update documentation
- [ ] Equipment lifecycle assessment

### Annually (8 hours)

- [ ] Replace all sensor batteries (preventive)
- [ ] Professional equipment inspection
- [ ] Review and update disaster recovery plan
- [ ] Budget planning for upgrades/replacements
- [ ] Complete system audit
- [ ] Staff refresher training

### As Needed

- [ ] Replace failed sensors
- [ ] Replace failed smart plugs
- [ ] Troubleshoot network issues
- [ ] Re-pair sensors to gateway
- [ ] Update sensor mappings (if layout changes)
- [ ] Replace UPS batteries (every 3-5 years)
- [ ] Recalibrate CO2 sensors (every 5 years, Tier 2/3)

---

## TROUBLESHOOTING GUIDE

### Sensor Issues

**Symptom: Sensor not reporting data**

**Diagnosis:**
1. Check SensorPush mobile app → is sensor visible?
2. Check battery level (replace if <20%)
3. Move sensor closer to gateway (test range)
4. Re-pair sensor to gateway (remove → add)
5. Check gateway status (power, network)

**Solution:**
```
# Check sensor status in SensorPush app
# Battery level shown next to each sensor

# Re-pair sensor:
1. Open SensorPush app
2. Tap "+" → Add Sensor
3. Follow on-screen prompts

# Check gateway:
# Solid LED = connected
# Blinking LED = connecting/disconnected
```

**Symptom: Inaccurate readings**

**Diagnosis:**
1. Compare to reference thermometer/hygrometer
2. Allow 30 minutes for sensor to stabilize
3. Check for direct sunlight or heat sources
4. Verify sensor placement (avoid vents, fans)

**Solution:**
- Recalibrate by contacting SensorPush support
- Relocate sensor if environmental factors affecting accuracy

### Soil Sensor Issues

**Symptom: Zigbee soil sensor not reporting**

**Diagnosis:**
1. Check ZHA status in Home Assistant
2. Verify sensor is powered (battery)
3. Check signal strength (ZHA device info)
4. Re-pair sensor to Zigbee coordinator

**Solution:**
```
# In Home Assistant:
# Settings → Devices & Services → ZHA
# Check device status

# Re-pair sensor:
1. Remove device from ZHA
2. Put sensor in pairing mode (usually press button)
3. Add device via ZHA
```

**Symptom: DIY capacitive sensor not reading**

**Diagnosis:**
1. Check wiring to ADC
2. Test ADC with known voltage
3. Check Python/Bun script for errors
4. Verify ADC is detected by Raspberry Pi

**Solution:**
```bash
# Test MCP3008 ADC:
# Install spi-tools
sudo apt install spi-tools

# Test SPI communication
spi-test -D /dev/spidev0.0

# Check ADC output (should be 0-1023)
# If not detected, check wiring
```

### Network Issues

**Symptom: Edge device can't reach internet**

**Diagnosis:**
1. Check cable connections (ethernet preferred)
2. Verify WiFi signal strength (min -60 dBm)
3. Check router status (restart if needed)
4. Test failover (Tier 2/3: 4G LTE should take over)
5. Verify DNS resolution (can ping 8.8.8.8?)

**Solution:**
```bash
# Test network connectivity
ping -c 4 8.8.8.8
ping -c 4 api.veridian.runfoo.run

# Check WiFi signal
iwconfig  # Look for "Link Quality"

# Test 4G failover (if equipped)
# Unplug ethernet, wait 30 seconds
# Verify 4G connection active
```

**Symptom: Can't discover Kasa smart plugs**

**Diagnosis:**
1. Verify plug is powered (LED status)
2. Check that edge device is on 2.4GHz WiFi (NOT 5GHz)
3. Use static IP (plug may have changed IP)
4. Restart plug (unplug for 10 seconds)
5. Re-configure plug (reset → set up again)

**Solution:**
```bash
# Discover Kasa plugs via Python
from python_kasa import Discover, SmartPlug

devices = Discover.discover()
for ip, device in devices.items():
    print(f"Found {device.alias} at {ip}")

# Or use Kasa app on phone to verify on same network
```

### Home Assistant Issues

**Symptom: Automations not triggering**

**Diagnosis:**
1. Check automation state (Developer Tools → Automations)
2. Verify trigger condition (is sensor reporting?)
3. Check automation mode (should be "single" or "restart")
4. Review automation trace (Developer Tools → Traces)
5. Test action manually (Developer Tools → Services)

**Solution:**
```yaml
# In Developer Tools → YAML mode, reload automations:
automation: reload

# Check automation trace for why it didn't trigger
# Shows condition evaluations, etc.
```

**Symptom: ZHA not discovering Zigbee devices**

**Diagnosis:**
1. Verify Zigbee coordinator is connected (USB dongle)
2. Check ZHA logs (Settings → System → Logs)
3. Restart Zigbee coordinator (unplug/replug USB)
4. Remove ZHA integration and re-add

**Solution:**
```
# In Home Assistant:
# Settings → Devices & Services → ZHA → Configure
# Check "Zigbee Chip Type" and "Network"

# Remove and re-add ZHA:
1. Remove ZHA integration
2. Restart Home Assistant
3. Add ZHA integration
4. Re-pair all devices
```

### Veridian Edge Agent Issues

**Symptom: Edge agent not starting**

**Diagnosis:**
1. Check logs: `journalctl -u veridian-edge -n 50`
2. Verify config.json syntax (use JSON validator)
3. Check credentials (SensorPush, Veridian API key)
4. Restart service: `sudo systemctl restart veridian-edge`
5. Reinstall if needed

**Solution:**
```bash
# View logs
journalctl -u veridian-edge -f

# Check config syntax
cat /opt/veridian-edge/config.json | jq .

# Restart service
sudo systemctl restart veridian-edge

# Check status
sudo systemctl status veridian-edge

# Reinstall if needed
cd /opt/veridian-edge
sudo ./scripts/install.sh
```

**Symptom: Data not syncing to cloud**

**Diagnosis:**
1. Check internet connectivity (ping api.veridian.runfoo.run)
2. Verify API key validity (regenerate if needed)
3. Check backend status (is server up?)
4. Review SQLite buffer (is data being stored locally?)
5. Test API endpoint

**Solution:**
```bash
# Test connectivity
ping api.veridian.runfoo.run

# Test API endpoint
curl https://api.veridian.runfoo.run/health

# Check SQLite buffer
sqlite3 /opt/veridian-edge/buffer.db "SELECT COUNT(*) FROM readings;"

# Check if backend is down (contact support)
```

### Camera Issues (Tier 2/3)

**Symptom: Camera offline**

**Diagnosis:**
1. Check PoE injector/switch status
2. Verify ethernet cable (test with cable tester)
3. Check camera IP address (DHCP reservation recommended)
4. Restart camera (power cycle)
5. Reset to factory defaults (reconfigure)

**Solution:**
```
# Check camera IP:
# Log into NVR → Camera settings → Network

# Restart camera:
# Unplug PoE ethernet, wait 10 seconds, reconnect

# Reset camera:
# Hold reset button for 10 seconds
# Reconfigure via web interface
```

**Symptom: Poor video quality**

**Diagnosis:**
1. Clean camera lens
2. Check bandwidth (min 2 Mbps per camera)
3. Adjust bitrate (NVR settings)
4. Verify firmware version (update if needed)
5. Check night vision IR LEDs

**Solution:**
```
# Clean lens with microfiber cloth (no harsh chemicals)

# Test bandwidth:
# Speedtest from camera location

# Adjust bitrate:
# NVR settings → Camera → Video → Bitrate
# Increase to 4-8 Mbps for 4MP cameras
```

---

## RECOMMENDATIONS

### For Initial Testing (Start Here)

**Recommendation:** **Tier 1 (Baseline)** - **$2,200**

**Why:**
- Low risk investment
- Real 2026 pricing applied (lower than estimated)
- Proven consumer hardware
- Quick deployment (1 weekend)
- Validates system architecture
- Identifies pain points before scaling

**Deployment Strategy:**
1. **Phase 1 (Week 1-2):** Deploy to 1 greenhouse + 1 container (pilot)
   - Tests: 4 air sensors + 2 soil sensors + 2 smart plugs
   - Cost: ~$250 for pilot equipment
2. **Phase 2 (Week 3-4):** Test for 2-4 weeks
   - Refine automations and thresholds
   - Identify any issues
3. **Phase 3 (Week 5-6):** Expand to remaining zones
   - Complete deployment of all 5 greenhouses + 3 containers
   - Total deployment: 1-1.5 months

**Upgrade Path:**
- **Tier 1 → Tier 2:** Add ~$8,300
  - Upgrade edge device (Pi 4 → Pi 5)
  - Replace sensors (HT1 → HT.w)
  - Add CO2 monitoring
  - Add camera system
  - Add E-ink displays
  - Upgrade UPS
- **Tier 1 → Tier 3:** Add ~$34,400
  - Full replacement recommended
  - Re-use some components (smart plugs, sensors)

**ROI Timeline:**
- Break-even: Energy savings + reduced crop loss (6-12 months)
- Increased yields: Better environmental control (10-20% increase possible)

### For Production Environment

**Recommendation:** **Tier 2 (Premium)** - **$10,500**

**Why:**
- Production-grade reliability
- CO2 monitoring included (8 zones)
- Camera surveillance for security (8 cameras)
- E-Ink displays for staff awareness
- Professional soil sensors (Soil Scout)
- Good balance of cost and capability
- 99% uptime target achievable

**Deployment Strategy:**
- Deploy all zones simultaneously (2 weeks)
- Professional consultation recommended for camera placement
- Optional: Hire integrator for initial setup

**ROI Timeline:**
- Break-even: 4-6 months (energy savings + crop quality + security)
- 5-year ROI: 200-300%

### For Enterprise / Commercial Scale

**Recommendation:** **Tier 3 (Enterprise)** - **$36,600**

**Why:**
- Maximum uptime (99.99%)
- High availability (automatic failover)
- PAR light monitoring (professional cultivators)
- PTZ cameras with analytics
- Voice annunciation (staff safety)
- Long-term ROI (7-10 year lifespan)
- Enterprise support and SLAs available

**Deployment Strategy:**
- 2-3 week installation
- Professional installation required
- Training included
- Optional: Managed services contract

**ROI Timeline:**
- Break-even: 6-9 months
- 5-year ROI: 400-600%
- 10-year ROI: 1000%+

---

## QUICK REFERENCE GUIDE

### Sensor Specifications at a Glance

```
┌────────────────────────────────────────────────────────────────┐
│                  SENSOR SPECIFICATIONS                          │
├────────────────────────────────────────────────────────────────┤
│                                                                 │
│ SENSORPUSH HT1 (Baseline)                                      │
│ ├─ Temperature: -40°F to 185°F (±0.36°F)                      │
│ ├─ Humidity: 0-100% RH (±2%)                                  │
│ ├─ Battery: CR2477 (12 months)                                │
│ ├─ Connectivity: Bluetooth LE → G1 Gateway (WiFi)             │
│ ├─ Data Rate: Every 1 minute                                  │
│ ├─ VPD Calculated: Yes (in Veridian backend)                  │
│ └─ Price: $54.95 each                                         │
│                                                                 │
│ SENSORPUSH HT.w (Premium/Enterprise)                           │
│ ├─ Temperature: -40°F to 185°F (±0.18°F)                      │
│ ├─ Humidity: 0-100% RH (±1%)                                  │
│ ├─ Battery: CR2477 (18 months)                                │
│ ├─ Connectivity: Bluetooth LE → G1 Gateway (WiFi)             │
│ ├─ Data Rate: Every 30 seconds                                │
│ └─ Price: $110.00 each                                        │
│                                                                 │
│ TUYA TS0601 SOIL SENSOR (Zigbee)                              │
│ ├─ Soil Moisture: 0-100% (capacitive)                         │
│ ├─ Temperature: -20°C to 60°C                                 │
│ ├─ Light: 0-100,000 lux                                      │
│ ├─ Battery: AAA x2 (6-12 months)                             │
│ ├─ Connectivity: Zigbee 3.0                                   │
│ ├─ Integration: ZHA / Zigbee2MQTT                             │
│ └─ Price: $18.00 each                                         │
│                                                                 │
│ SOIL SCOUT (LoRa - Premium/Enterprise)                         │
│ ├─ Soil Moisture: 0-100% (capacitive, buried)                │
│ ├─ Soil Temperature: -20°C to 60°C                            │
│ ├─ Battery: 5-10 years (non-replaceable)                     │
│ ├─ Connectivity: LoRaWAN (up to 15km range)                  │
│ ├─ Integration: MQTT via LoRa gateway                        │
│ ├─ Waterproof: IP68 (fully buried)                            │
│ ├─ Warranty: 2 years                                          │
│ └─ Price: $150-250 each                                       │
│                                                                 │
│ SENSEAIR S8 CO2 (Premium)                                     │
│ ├─ CO2 Range: 0-2000 ppm                                      │
│ ├─ Accuracy: ±30 ppm ±3%                                     │
│ ├─ Output: Modbus RTU (RS485)                                 │
│ ├─ Power: 10-30V DC                                           │
│ ├─ Calibration: Auto (ABC)                                    │
│ └─ Price: $200 each                                           │
│                                                                 │
│ SENSEAIR S8 PRO CO2 (Enterprise)                              │
│ ├─ CO2 Range: 0-10,000 ppm                                    │
│ ├─ Accuracy: ±20 ppm ±2%                                     │
│ ├─ Pressure Compensation: Yes                                 │
│ ├─ Output: Modbus, 4-20mA, 0-10V                             │
│ ├─ Display: LCD (local readout)                              │
│ ├─ Warranty: 5 years                                          │
│ └─ Price: $350 each                                           │
│                                                                 │
│ APOGEE SQ-500 PAR SENSOR (Enterprise)                         │
│ ├─ Spectral Range: 389-683 nm (plant-focused)                │
│ ├─ Output: 0-2.5V                                             │
│ ├─ Accuracy: ±5%                                              │
│ ├─ Weatherproof: IP68                                         │
│ ├─ Cable: 5m shielded                                         │
│ └─ Price: $600 each                                           │
│                                                                 │
└────────────────────────────────────────────────────────────────┘
```

### Smart Plug Comparison

```
┌────────────────────────────────────────────────────────────────┐
│                 SMART PLUG COMPARISON                          │
├────────────────────────────────────────────────────────────────┤
│                                                                 │
│ KASA EP10 (Baseline)                                           │
│ ├─ Max Load: 15A / 1800W                                      │
│ ├─ Energy Monitoring: No                                       │
│ ├─ WiFi: 2.4GHz only                                          │
│ ├─ Response Time: <1s local                                   │
│ ├─ HomeAssistant: Native support                              │
│ └─ Price: $7.50 each (4-pack for $29.99)                      │
│                                                                 │
│ KASA EP25 (Premium/Enterprise)                                 │
│ ├─ Max Load: 15A / 1800W                                      │
│ ├─ Energy Monitoring: Yes (kW/h tracking)                     │
│ ├─ WiFi: 2.4GHz only                                          │
│ ├─ Response Time: <1s local                                   │
│ ├─ HomeAssistant: Native support                              │
│ ├─ Apple HomeKit: Yes                                         │
│ └─ Price: $11.25 each (4-pack for $44.99)                     │
│                                                                 │
│ USAGE RECOMMENDATIONS:                                         │
│ ├─ Small Loads (<1000W): EP10 or EP25                          │
│ ├─ Medium Loads (1000-1500W): EP25 (energy monitoring)        │
│ ├─ Large Loads (>1500W): Mechanical contactors (Tier 2/3)     │
│ └─ Critical Equipment: Always use EP25 (energy alerts)        │
│                                                                 │
└────────────────────────────────────────────────────────────────┘
```

### Raspberry Pi Comparison

```
┌────────────────────────────────────────────────────────────────┐
│              RASPBERRY PI COMPARISON                           │
├────────────────────────────────────────────────────────────────┤
│                                                                 │
│ RASPBERRY PI 4 MODEL B (Baseline)                              │
│ ├─ CPU: Broadcom BCM2711 (4x A72 @ 1.5GHz)                   │
│ ├─ RAM: 4GB                                                    │
│ ├─ Performance: 1x baseline                                    │
│ ├─ I/O: 2x USB 3.0, 2x USB 2.0                               │
│ ├─ Storage: MicroSD (USB bottleneck)                          │
│ ├─ Ethernet: Gigabit (USB bottleneck)                         │
│ ├─ Power: 5V 3A (15W)                                         │
│ └─ Price: $60 (4GB)                                            │
│                                                                 │
│ RASPBERRY PI 5 (Premium/Enterprise)                            │
│ ├─ CPU: Broadcom BCM2712 (4x A76 @ 2.4GHz)                   │
│ ├─ RAM: 8GB                                                    │
│ ├─ Performance: 2-3x faster than Pi 4                         │
│ ├─ I/O: 2x USB 3.0, 2x USB 2.0                               │
│ ├─ Storage: MicroSD + NVMe (via hat, PCIe)                    │
│ ├─ Ethernet: Gigabit (true PCIe, no bottleneck)              │
│ ├─ Power: 27W USB-C PD                                        │
│ └─ Price: $95 (8GB)                                            │
│                                                                 │
│ RECOMMENDATION:                                               │
│ ├─ Edge Device Only (Baseline): Pi 4 4GB                      │
│ ├─ With Cameras/Databases (Premium): Pi 5 8GB                 │
│ ├─ High Availability (Enterprise): Pi 5 cluster (3 nodes)     │
│ └─ Future-Proof: Always choose Pi 5 if budget allows         │
│                                                                 │
└────────────────────────────────────────────────────────────────┘
```

---

## APPENDICES

### Appendix A: IP Rating Reference

| Rating | Protection | Suitable For |
|--------|------------|--------------|
| **IP20** | Dust >1mm, no water | Indoor, dry locations (SensorPush sensors) |
| **IP65** | Dust-tight, water jets | Outdoor gateways/APs |
| **IP66** | Dust-tight, powerful water jets | Outdoor cameras (heavy rain) |
| **IP67** | Dust-tight, immersed 1m | Temporary submersion |
| **IP68** | Dust-tight, immersed 3m+ | Prolonged submersion (Soil Scout buried) |

**Recommended:**
- Greenhouse air sensors (indoor): IP20 (SensorPush HT1/HT.w)
- Outdoor gateways/APs: IP65 or IP66
- Camera housings: IP66 or IP67
- Control enclosures: NEMA 4X (equivalent to IP66)
- Buried soil sensors: IP68 (Soil Scout)

### Appendix B: Network Bandwidth Requirements

| Application | Bandwidth | Latency | Reliability | Priority |
|-------------|-----------|---------|-------------|----------|
| **SensorPush (Cloud API)** | 1 Mbps | <100ms | 95%+ | High |
| **Veridian Edge Agent** | 2 Mbps | <50ms | 99%+ | Critical |
| **HomeAssistant** | 1 Mbps | <50ms | 99%+ | High |
| **Smart Plug Control** | <0.5 Mbps | <200ms | 95%+ | Medium |
| **Camera (4MP, 1 stream)** | 2-4 Mbps | <50ms | 99%+ | High |
| **Camera (4K, PTZ)** | 8-12 Mbps | <50ms | 99.9%+ | High |
| **E-Ink Display Updates** | <0.1 Mbps | <500ms | 95%+ | Low |
| **Zigbee Coordinator** | <0.1 Mbps | <100ms | 95%+ | Medium |
| **LoRa Gateway** | <0.5 Mbps | <500ms | 95%+ | Medium |
| **TOTAL (Tier 1)** | 5 Mbps | N/A | 99% | |
| **TOTAL (Tier 2)** | 20 Mbps | N/A | 99.9% | |
| **TOTAL (Tier 3)** | 100 Mbps | N/A | 99.99% | |

### Appendix C: Maintenance Cost Estimates (5 Years)

**Tier 1 - Baseline:**
- Sensor batteries: $2 x 26 x 5 years = $260
- UPS battery replacement: $40 (years 3)
- SD card replacement: $12 x 2 = $24 (years 2, 4)
- **Total 5-year maintenance: ~$324**

**Tier 2 - Premium:**
- Sensor batteries: $2 x 26 x 5 years = $260
- UPS battery replacement: $80 (years 3, 5) = $160
- CO2 sensor calibration: $50 x 5 years = $250
- Camera HDD replacement: $90 (year 4) = $90
- **Total 5-year maintenance: ~$760**

**Tier 3 - Enterprise:**
- Sensor batteries: $2 x 26 x 5 years = $260
- UPS battery replacement: $400 x 2 = $800 (years 3, 6)
- CO2 sensor calibration: $100 x 5 years = $500
- NAS HDD replacement: $250 x 4 = $1,000 (years 4-6)
- Cellular data: $100/mo x 12 x 5 = $6,000
- **Total 5-year maintenance: ~$8,560**

### Appendix D: Vendor Contact Information

**Veridian Platform:**
- GitHub: https://github.com/your-org/veridian
- GitLab: https://git.runfoo.run/malty/veridian-edge
- Documentation: https://docs.veridian.runfoo.run
- Support: support@veridian.runfoo.run

**Hardware Vendors:**
- **SensorPush:** https://sensorpush.com
- **Raspberry Pi:** https://www.raspberrypi.com
- **TP-Link Kasa:** https://www.kasasmart.com
- **Ubiquiti:** https://www.ui.com
- **Amcrest:** https://amcrest.com
- **Axis Communications:** https://www.axis.com
- **Soil Scout:** https://soilscout.com
- **RAK Wireless:** https://store.rakwireless.com
- **SenseAir:** https://www.senseair.com
- **Apogee Instruments:** https://www.apogeeinstruments.com

**HomeAssistant:**
- Website: https://www.home-assistant.io
- Community: https://community.home-assistant.io
- Documentation: https://www.home-assistant.io/docs/
- HACS: https://hacs.xyz

**Software:**
- **Bun Runtime:** https://bun.sh
- **Docker:** https://www.docker.com
- **go2rtc:** https://github.com/AlexxIT/go2rtc
- **Zigbee2MQTT:** https://www.zigbee2mqtt.io
- **ChirpStack:** https://www.chirpstack.io

### Appendix E: Glossary

**ADC** - Analog-to-Digital Converter. Required for reading capacitive soil sensors with Raspberry Pi.

**Automations** - HomeAssistant rules that trigger actions based on conditions (e.g., turn on fan if temperature > 85°F).

**CO2** - Carbon Dioxide. Measured in ppm (parts per million). Critical for plant growth optimization.

**Dew Point** - Temperature at which air becomes saturated and water vapor condenses.

**EC** - Electrical Conductivity. Measure of nutrient concentration in soil/water.

**E-Ink** - Electronic ink display technology. Low power, high readability in sunlight.

**GPIO** - General Purpose Input/Output. Raspberry Pi pins for connecting sensors/actuators.

**HA** - HomeAssistant.

**HVAC** - Heating, Ventilation, and Air Conditioning.

**IP Rating** - Ingress Protection. Two-digit code indicating environmental protection (e.g., IP65).

**LoRaWAN** - Long Range Wide Area Network. Low-power, long-range wireless protocol (up to 15km).

**Modbus** - Industrial communication protocol. Used for CO2 sensors, PLCs.

**MQTT** - Message Queuing Telemetry Transport. Lightweight publish/subscribe protocol for IoT.

**NVR** - Network Video Recorder. Records IP camera feeds.

**ONVIF** - Open Network Video Interface Forum. Standard for IP camera communication.

**PAR** - Photosynthetically Active Radiation. Light spectrum used by plants (400-700nm).

**PoE** - Power over Ethernet. Delivers power and data over same cable.

**RS485** - Serial communication standard. Used for Modbus networks.

**RTSP** - Real Time Streaming Protocol. For IP camera video streams.

**Soil Moisture** - Water content in soil. Measured as percentage (0-100%).

**UPS** - Uninterruptible Power Supply. Battery backup for power outages.

**VPD** - Vapor Pressure Deficit. Measure of drying power of air. Critical for transpiration.

**WebRTC** - Web Real-Time Communication. Low-latency video streaming (<500ms).

**ZHA** - Zigbee Home Automation. Native HomeAssistant Zigbee integration.

**Zigbee** - Low-power, wireless mesh protocol for IoT devices.

**Zigbee2MQTT** - Alternative Zigbee integration using MQTT.

---

## CHANGELOG

**v1.0 (January 6, 2026)**
- Initial report creation
- Three-tier architecture defined
- Hardware specifications for 5 greenhouses + 3 containers
- Real 2026 pricing applied (significantly lower than estimates)
- Soil sensor options added (Zigbee, DIY capacitive, LoRa)
- HomeAssistant integration examples
- Installation checklist and troubleshooting guide
- Maintenance schedules and 5-year cost projections

**Pricing Updates (v1.0):**
- SensorPush HT1: $54.95 (actual) vs $70 (estimated) = -$15.05 each
- Raspberry Pi 5 8GB: $95 (actual) vs $80 (estimated) = +$15
- Kasa EP25: $11.25 each (actual 4-pack price) vs $30 (estimated) = -$18.75 each
- Overall Tier 1 cost: $2,200 (actual) vs $2,596 (estimated) = -$396 savings

---

**END OF REPORT**

---

*This report was generated by Claude Code for the Veridian Cultivation Platform using real-time pricing data as of January 6, 2026. For questions or clarifications, please refer to the project documentation at https://docs.veridian.runfoo.run or contact the project team.*

**Report Generated:** January 6, 2026
**Version:** 1.0
**Author:** Claude Code (Sonnet 4.5)
**Project:** Veridian Cultivation Platform
**Deployment:** 5 Greenhouses + 3 Drying Containers

