Planner Contract and AI Tunables

This is the canonical planner-control contract for Verdify. It explains what triggers a plan, what values the AI planning agent may write, how those writes publish to the public site, and what live readback evidence says about the bounded tunable surface.

End-to-end path for planner-owned values:

AI planning agent -> MCP set_plan or set_tunable -> setpoint_plan -> v_active_plan -> ingestor dispatcher -> ESPHome number/switch -> firmware global/Setpoints -> cfg_* readback -> setpoint_snapshot and setpoint_changes confirmation.

The ESP32 still owns relay control. The AI planning agent owns bounded setpoint hypotheses, not direct actuator commands.

Related evidencePlanning Loop · Safety Architecture · Operations

This generated page owns triggers, accepted writes, publishing behavior, and per-parameter contract evidence. The planning page owns prompt flow, the safety page owns relay-boundary behavior, and Operations owns current live state.

Trigger Schedule

Every expected trigger is materialized in planner_trigger_ledger before planner delivery. Required full-plan triggers must close with set_plan; tactical checkpoints may close with set_tunable or acknowledge_trigger when no change is warranted.

MIDNIGHT00:15 America/Denver

Scheduled end-of-day evaluation and reset. The AI planning agent evaluates prior-day plans, extracts supported lessons, and starts the new local day with set_plan.

SUNRISEAstral sunrise

Required morning full plan for daylight, peak stress, decline, and evening handoff.

SOLAR_MAXAstral solar noon

Solar checkpoint for a small tactical correction or honest no-change acknowledgement.

TRANSITIONPeak stress and decline

Bounded tactical checkpoint for the two highest-signal day transitions.

SUNSETAstral sunset

Required evening full plan for overnight cold, humidity, dew point, and pre-dawn posture.

FORECAST_DEVIATIONSigma-gated observed miss; fired 18x in the last 14 days

Triggered only when actual outdoor conditions diverge materially from forecast after cooldown and threshold checks. The ledger fire count is read live from planner_trigger_ledger so this label reflects whether the trigger is actually firing, not just configured.

MANUALOperator initiated

Ad-hoc audited planner run with the same MCP bounds and audit metadata as scheduled triggers.

Payload And Runtime Contract

The planner receives one trigger-scoped payload through Hermes /v1/runs: standing directives, the event prompt, assembled greenhouse context, and audit metadata. The session id keeps the historical hermes:iris:main:trigger:<trigger_id> shape because it is a database/service key, not public planner branding.

Planner scheduleringestor/tasks.py::planning_heartbeat

Computes expected trigger times, records them before delivery, dispatches the AI planning agent, and resolves SLA state.

Prompt builderingestor/iris_planner.py

Builds the event prompt, appends live and static context, stamps audit metadata, and posts to Hermes.

Dynamic greenhouse packetscripts/gather-plan-context.sh

Live sensors, equipment, forecast, active plan, scorecards, plan-review backlog, lessons, alerts, tunable constraints, guardrail audits, and context completeness.

Public site packet/srv/verdify/state/planner-static-context.md

Generated from the same Markdown source tree Quartz renders for lab.verdify.ai, with a SHA-256 digest embedded into planner context.

Accepted Writes And Publishing

set_planRequired for full-plan triggers

Validates the plan envelope, bounded climate_intent, bounds, trigger ID, planner instance, and structured hypothesis; materializes to setpoint_plan and audits semantic intent in plan_journal.

set_tunableNarrow tactical correction

Validates one planner-pushable parameter against this registry and writes an audited one-shot setpoint row.

acknowledge_triggerNo-op closeout

Allowed for no-op transition, forecast-deviation, heartbeat, and validation-smoke events; rejected for normal required full-plan cycles.

plan_evaluateLearning-loop closure

Writes outcome, score, anchor score, optional lesson extraction, and validation time back to plan_journal.

Publishingpublish-site-content.sh

MCP writes trigger generated plan pages, archive, forecast, lessons, tunables, baseline, evidence snapshots, public sample data, static planner context, and a Quartz rebuild.

Current Audit Snapshot

206Schema tunables

Every name accepted by PlanTransition, SetpointChange, or setpoint_snapshot.

206Registry rows

Includes dispatcher-routed and readback-only firmware inputs.

39Materialized Tier 1 knobs

MCP derives these from bounded ClimateIntent for routine set_plan writes.

48Planner-policy knobs

The only tunables the planner may write. Operator, crop-band, readback, and retired rows are context only.

0Open alerts

Live safety state at generation time.

0Future active params

0 future active plan rows.

0Reserved active rows

Should remain zero for no-op/deprecated params.

0/030m trigger audit

Plan dispatcher writes carrying trigger IDs.

0.032 kPaMister VPD delta

11 measured mister cycles in the last 14 days.

Contract class counts: {'planner_policy': 48, 'crop_band': 60, 'controller_safety': 27, 'irrigation_site': 3, 'readback_context': 4, 'retired': 41}.

Embedding corpus counts: {"plan": 159, "lesson": 114, "playbook": 124, "site_doc": 4274, "observation": 636}.

Firmware override events in the last 7 days: {"summer_vent": 1, "fog_heat_assist": 6, "vent_mist_assist": 5, "occupancy_blocks_equipment": 4}.

Effectiveness labels below mean three different things:

  • Route confirmed means the planner/dispatcher write landed and firmware read it back.
  • Operational effect means firmware has a code path that consumes the value.
  • Greenhouse outcome means a later scorecard or structured rationale supports or falsifies the plan. This page reports the latest available evidence but does not pretend a single tunable has isolated causal proof unless the system measured that directly.

Current controller invariants:

  • DEHUM_VENT exits immediately if dehumidifying with vent/fans pushes VPD above vpd_high; cooling then uses VENTILATE with vent-mist assist, otherwise sealed mist recovery is allowed.
  • Non-safety heat is suppressed while vent/fan air exchange is physically active.
  • heat2 is never valid without heat1; any observed heat2-without-heat1 interval is a fault to investigate, not a planner tactic.
  • The dispatcher preserves a minimum 0.55 kPa house VPD deadband so mixed-zone crop targets do not create controller chatter.
  • During live, near-edge, or recently unrecovered VENTILATE VPD-high stress with healthy dew margin, the dispatcher clamps conservative moisture thresholds near the active vpd_high band: mister_engage_kpa <= vpd_high + 0.05, mister_all_kpa <= max(1.0, vpd_high + 0.25), fog_escalation_kpa <= 0.20 or 0.15 in hot/dry venting, shorter mist delays/gaps, and shorter min_fog_off_s.
  • Planner moisture tuning ladder: open the band-coupled mister surface first, use all_zone_vpd_excess_kpa for distributed mister escalation, shorten mister_pulse_gap_s before increasing mister_pulse_on_s, use fog as the heavy 7x escalation path, and remember mister_vpd_weight changes zone selection rather than total duty.

ClimateIntent AI Surface

Routine set_plan transitions must include a bounded climate_intent object with every field below explicitly set. These fields tune tactical posture around the dispatcher-owned targets; they do not own temp/VPD low, target, or high points.

FieldBoundsPlanner meaningFirmware impactMaterialized knobsPlanner guidance
forecast_temp_bias_f-4..4FForecast-backed hot-air pressure signal for the segment.Positive values make cooling more anticipatory without changing dispatcher-owned temp_low/temp_target/temp_high.cool_stage2_over_high_f, sw_cool_all_fans_at_high_enabledUse positive values when forecast or recent misses imply heat will outrun the band; use 0 when no hot miss is expected.
forecast_vpd_bias_kpa-0.4..0.4 kPaForecast-backed dry/wet pressure signal for the segment.Positive values make wet actions more available without changing dispatcher-owned vpd_low/vpd_target/vpd_high.sw_direct_wet_stress_override_enabled, mister_vpd_weight, min_fog_on_sUse positive values for dry forecast error or dry-air ventilation risk; use 0 or negative when dew/RH risk dominates.
solar_precool_gain_f0..4FSolar ramp pressure that justifies cooling lead before peak heat.Tightens stage-2 cooling and fan readiness before high solar load arrives.cool_stage2_over_high_f, sw_cool_all_fans_at_high_enabledRaise during steep solar ramps or known lag; lower after shade/clouds or evening recovery.
thermal_lead_time_min0..90 minHow early forecast preconditioning may begin.Planner audit context for lead timing; firmware safety and dispatcher timing still gate actuation.audit context onlySet to the intended lead window for the segment hypothesis; it documents forecast timing even when no direct Tier 1 knob changes.
economizer_temp_advantage_f1..15FOutdoor temperature advantage needed before vent cooling is attractive.Materializes to vent preference and cold-vent guard thresholds.vent_prefer_temp_delta_f, cold_vent_guard_delta_fLower when outside air can cool without cold shock; raise when cold-slug or oscillation risk is high.
economizer_dewpoint_advantage_f1..15FOutdoor dewpoint advantage needed before dry-air decisions are attractive.Materializes to dewpoint preference for vent/dehumidification choices.vent_prefer_dp_delta_fLower when outdoor air is safely drier and dehumidification is needed; raise when dry ventilation would worsen VPD stress.
moisture_engage_vpd_excess_kpa0..0.5 kPaHow far above dispatcher-owned vpd_high VPD may rise before mister assist is eligible.Materializes targeted mister and direct-wet thresholds relative to the active dispatcher VPD band.direct_wet_stress_vpd_margin_kpa, mister_engage_kpaKeep near 0.05 kPa when VPD compliance is the bottleneck; raise only to conserve water after recovery is proven.
all_zone_vpd_excess_kpa0.05..0.8 kPaHow far above dispatcher-owned vpd_high VPD may rise before all-zone mister rotation is eligible.Materializes the all-zone mister escalation threshold relative to the active dispatcher VPD band without forcing fog earlier.mister_all_kpaKeep near 0.20-0.30 kPa during hot/dry recovery; raise when water use is high without VPD improvement or wetting risk is active.
mist_duty_limit_pct0..100%Maximum climate-misting duty allowed during the segment.Materializes mister pulse duration, wet aggression, and resource budget gates.mister_pulse_on_s, mister_pulse_gap_s, mister_vpd_weight, sw_direct_wet_stress_override_enabledRaise during hot/dry recovery windows with safe dew margin; lower for disease risk, occupancy, or resource conservation.
fog_escalate_vpd_excess_kpa0.1..0.8 kPaHow far above dispatcher-owned vpd_high VPD may rise before fog assist is eligible.Materializes fog escalation relative to the active VPD band, independently from all-zone mist rotation.fog_escalation_kpaUse lower values when VPD is repeatedly above band during ventilation and fog is safe; use higher values when fog overshoot or disease risk is the constraint.
dew_margin_floor_f3..15FMinimum indoor air temperature minus dew point for wet climate actions.Materializes fog/direct-wet dew margin floors and blocks condensation-risk wetting.direct_wet_stress_min_dew_margin_f, fog_stress_min_dew_margin_fKeep conservative at night or near leaf-wetness risk; do not lower it just to chase VPD compliance.
wet_cutoff_hour17..24Latest local hour for climate wetting in this segment.Materializes fog and direct-wet latest-hour limits.fog_stress_window_latest_hour, sw_fog_stress_window_extend_enabledExtend only when dry recovery is worth evening wetting risk and dew margin remains healthy.
daily_mist_budget_gal0..300 galDaily climate-water budget for mister use.Materializes the firmware mister water budget.mister_water_budget_galBudget water according to forecast stress and recent usage; use 0 only when wet actions should be unavailable.
resource_sensitivity0..1Preference for conserving water/electricity after safety and band compliance.Lengthens off dwell and reduces wet/cooling aggression when compliance allows it.mister_pulse_gap_s, min_fog_off_s, min_fog_on_s, cool_stage2_over_high_f, sw_direct_wet_stress_override_enabledRaise only after safety and compliance are stable; lower when temp or VPD is outside band.
relay_churn_penalty0..1Preference for holding stable actions instead of changing modes frequently.Materializes hysteresis, dwell, and mist delay values.cool_exit_hysteresis_f, temp_hysteresis, vpd_hysteresis, vpd_watch_dwell_s, dwell_gate_ms, mister_engage_delay_s, mister_all_delay_sRaise when mode churn or relay wear is the observed failure; lower when response lag is missing compliance windows.

Dispatcher-Owned Climate Targets

The planner receives these target values as read-only prompt context. They are derived from crop profiles and dispatcher policy, and the target delta columns are signed actual - target metrics for graphing and mode diagnosis.

Controller priority is safety rails first, then temperature compliance, then VPD compliance, then resource use. When VPD is above the dispatcher-owned band and dew/occupancy rails are safe, resource minimization must not close wet/fog assist; ClimateIntent should make moisture assist available near the active VPD high edge until target deltas recover.

AxisLowTargetHighActualActual - target
Temp F67.473.3579.365.17-8.18
VPD kPa0.490.7651.041.0650.3

Latest sample: 2026-11-18T03:08:33.545388+00:00; mode IDLE.

ClimateIntent Materialization Contract

Routine set_plan calls emit bounded climate_intent transitions. MCP validates that semantic surface, materializes it into the low-level Tier 1 rows below, and stores the original intent in plan_journal.climate_intents.

ParameterActiveFuture rowsLast dispatch7d confirmedPlanner instruction
band_track_fraction-02026-11-17 00:19Z12/12Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
cold_vent_guard_delta_f-02026-11-17 00:19Z40/40Planner-policy tunable. Raise for cold-slug risk, lower when outdoor exchange is useful and temperature headroom is healthy.
cool_exit_hysteresis_f-02026-11-17 00:19Z56/56Planner-policy tunable. Lower values clear VENTILATE sooner; higher values hold cooling longer after hot stress. Keep dew/VPD effects in the hypothesis.
cool_stage2_exit_hysteresis_f-02026-11-17 00:19Z12/12Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
cool_stage2_over_high_f-02026-11-17 00:19Z66/67Planner-policy tunable. On hot or high-solar days, use 0.5-1.0 F so fan2 helps near the high edge; relax after recovery to reduce fan wear.
direct_wet_stress_min_dew_margin_f-02026-11-17 00:19Z33/33Planner-policy safety gate. Use 8 F or higher unless disease-risk evidence justifies a stricter margin; never lower to chase compliance blindly.
direct_wet_stress_vpd_margin_kpa-02026-11-17 00:19Z39/39Planner-policy tunable. Keep low, around 0.05-0.15 kPa, when late dry recovery needs direct wetting; raise it to reserve override for stronger dry stress.
dwell_gate_ms-02026-11-17 00:19Z53/53Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
enthalpy_close-02026-11-17 00:19Z12/12Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
enthalpy_open-02026-11-17 00:19Z12/12Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
fog_escalation_kpa-02026-11-17 04:13Z294/301Planner-policy tunable. During VPD-high or near-edge VENTILATE stress with healthy dew margin, use 0.15-0.20 in hot/dry venting, 0.25-0.30 for mild dry stress, and reserve 0.35-0.50 for VPD-low overshoot, dew risk, or resource limits.
heat_hysteresis-02026-11-17 00:19Z12/12Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
min_fog_off_s-02026-11-17 00:19Z267/270Planner-policy tunable. During VPD-high or near-edge VENTILATE stress with healthy dew margin, use shorter delays/gaps so ventilation can cool while misting protects VPD.
min_fog_on_s-02026-11-17 00:19Z75/76Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
mist_backoff_s-02026-11-17 00:19Z12/12Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
mist_max_closed_vent_s-02026-11-17 00:19Z12/12Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
mist_thermal_relief_s-02026-11-17 00:19Z12/12Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
mister_all_delay_s-02026-11-17 00:19Z257/258Planner-policy tunable. During VPD-high or near-edge VENTILATE stress with healthy dew margin, use shorter delays/gaps so ventilation can cool while misting protects VPD.
mister_all_kpa-02026-11-17 02:08Z297/299Planner-policy tunable. During VPD-high or near-edge VENTILATE stress with healthy dew margin, keep near max(1.0, vpd_high + 0.25) so all-zone mist assist can engage; high absolute values disable escalation.
mister_engage_delay_s-02026-11-18 01:38Z273/278Planner-policy tunable. During VPD-high or near-edge VENTILATE stress with healthy dew margin, use shorter delays/gaps so ventilation can cool while misting protects VPD.
mister_engage_kpa-02026-11-17 02:08Z282/288Planner-policy tunable. During VPD-high or near-edge VENTILATE stress with healthy dew margin, keep near active vpd_high + 0.05; values near 2.5 suppress wet assist and should be reserved for dew/occupancy/irrigation/water-cap constraints.
mister_pulse_gap_s-02026-11-17 00:19Z233/238Planner-policy tunable. During VPD-high or near-edge VENTILATE stress with healthy dew margin, use shorter delays/gaps so ventilation can cool while misting protects VPD.
mister_pulse_on_s-02026-11-17 00:19Z37/38Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
mister_vpd_weight-02026-11-17 00:19Z61/61Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
mister_water_budget_gal-02026-11-18 01:38Z27/27Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
night_vpd_bias_kpa-02026-11-17 00:19Z12/12Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
outdoor_staleness_max_s-02026-11-18 01:38Z23/23Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
sw_cool_all_fans_at_high_enabled-02026-11-14 18:03Z7/7Planner-policy switch. Enable only for forecast-backed heat stress windows where one-fan ventilation has been insufficient; disable after the window.
sw_direct_wet_stress_override_enabled-02026-11-16 13:54Z10/10Planner-policy switch. Enable only for VPD-high evening recovery when normal direct-wet drydown is blocking water and dew margin is safely above the configured floor.
sw_dwell_gate_enabled-02026-09-06 00:41Z-Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
sw_fog_closes_vent-02026-09-06 00:41Z-Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
sw_mister_closes_vent-02026-09-06 00:41Z-Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
sw_summer_vent_enabled-02026-09-06 00:41Z-Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
temp_hysteresis-02026-11-17 00:19Z55/55Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
vent_exchange_fraction-02026-11-17 00:19Z12/12Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
vent_prefer_dp_delta_f-02026-11-17 00:19Z33/33Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
vent_prefer_temp_delta_f-02026-11-17 00:19Z40/40Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
vpd_hysteresis-02026-11-17 00:19Z58/58Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.
vpd_watch_dwell_s-02026-11-17 00:19Z45/45Materialized Tier 1 field. Routine set_plan writes must use bounded climate_intent; MCP derives this low-level row.

Findings That Matter

  • mister_engage_kpa is effectful, but it is not the state-machine entry trigger. Firmware enters humidification from vpd_high plus vpd_watch_dwell_s; mister_engage_kpa gates physical S1 mister pulses once SEALED_MIST or explicit VENTILATE assist creates humidity demand. Zone stress can choose the pulse target or satisfy the S1 stress check, but it cannot create a standalone mister mode.
  • mister_all_kpa controls physical all-zone mister rotation. The header mist-stage delay also uses mister_all_delay_s; fog escalation uses fog_escalation_kpa independently.
  • The planner tunes moisture intensity, not the crop band. In VENTILATE, dry outside air can keep temperature in band while pushing VPD high, so moisture thresholds must stay coupled to the active vpd_high unless dew-risk evidence justifies suppression.
  • High mister_engage_kpa/mister_all_kpa values are not resource-neutral during VPD-high stress; they can close the wet-assist path. Save them for dew, occupancy, irrigation, or water-cap constraints.
  • Reserved/no-op values are intentionally not planner-pushable: bias_cool, bias_heat, d_cool_stage_2, d_heat_stage_2, mist_vent_close_lead_s, mist_vent_reopen_delay_s, mister_all_off_s, mister_all_on_s, mister_off_s, mister_on_s, summer_vent_min_runtime_s, sw_fsm_controller_enabled.
  • Readback-only values are now registry-covered but not planner-pushable: fallback_window_s, outdoor_temp_f, outdoor_dewpoint_f.

Clamp Activity (last 30 days)

When the AI planning agent pushes a setpoint outside the active band or a guardrail floor/ceiling, the dispatcher clamps it before it reaches the ESP32 and records the event in setpoint_clamps. A high clamp count means the planner is repeatedly asking for a value the band/guardrail layer will not honor; for moisture knobs that usually means aggressive VPD-hold misting is being capped. These rows are sourced from setpoint_clamps grouped by parameter; the dispatcher also feeds them to the planner each cycle through scripts/gather-plan-context.sh.

ParameterClamps 30dClamps 24hAvg requestedAvg appliedLatest reasonLast clamp
mister_pulse_gap_s1051046.77730vpd_high_moisture_guardrail2026-11-16 23:52Z (1d)
min_fog_off_s1046082.30859.928vpd_high_moisture_guardrail2026-11-16 23:52Z (1d)
mister_engage_kpa79201.0210.883vpd_high_moisture_guardrail2026-11-17 00:15Z (1d)
mister_all_kpa78801.2211.083vpd_high_moisture_guardrail2026-11-17 00:15Z (1d)
mister_all_delay_s5650100.21690vpd_high_moisture_guardrail2026-11-16 13:49Z (1d)
mister_engage_delay_s565050.10845vpd_high_moisture_guardrail2026-11-16 13:49Z (1d)
fog_escalation_kpa51600.4240.298vpd_high_moisture_guardrail2026-11-16 13:49Z (1d)

Parameter Index

This is the public contract table for every registered tunable. The row-level implementation dump is still generated for operations, but the public page keeps the reading path compact.

Activity and direct-wet gates

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
direct_wet_min_temp_fHouse temperature below which automated wetting was meant to be blocked; 0 turns the check off.scheduled_policyscheduledefault 0; 0 to 90-65 (19m)29/30 confirmed; firmware refs 10-MCP rejects planner writes; scheduled policy
direct_wet_stress_latest_hourLatest hour of the day at which the dry-stress override could allow direct wetting.retiredplannerdefault 22; 17 to 24-- (-)static route-MCP rejects planner writes; retired
direct_wet_stress_min_dew_margin_fMinimum gap between air temperature and dew point before misting or fog may run by day.planner_policyplannerdefault 8; 3 to 15-9 (1d)confirmed; firmware refs 18-materialized from climate_intent for routine set_plan
direct_wet_stress_vpd_margin_kpaHow far VPD must be above the band high edge before misting may assist ventilation.planner_policyplannerdefault 0.05; 0 to 0.5-0.25 (1d)confirmed; firmware refs 15-materialized from climate_intent for routine set_plan
sw_direct_wet_gate_enabledOlder master switch for the daytime direct-wetting windows.planner_policyplannerdefault 1; switch 0/1-1 (14m)readback only; firmware refs 20-set_tunable allowed; planner may write with a hypothesis

Band

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
band_temp_high_midHigh edge of the house temperature band at solar midnight.crop_bandbanddefault 70.71; 40 to 100-70.7 (37m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_temp_high_smHigh edge of the house temperature band at solar noon.crop_bandbanddefault 83.79; 40 to 100-85.8 (18m)confirmed; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_temp_high_srHigh edge of the house temperature band at sunrise.crop_bandbanddefault 72.5; 40 to 100-72.5 (18m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_temp_high_ssHigh edge of the house temperature band at sunset.crop_bandbanddefault 82; 40 to 100-84 (57m)confirmed; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_temp_low_midLow edge of the house temperature band at solar midnight.crop_bandbanddefault 60.71; 40 to 100-60.7 (10m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_temp_low_smLow edge of the house temperature band at solar noon.crop_bandbanddefault 73.79; 40 to 100-71.8 (40m)confirmed; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_temp_low_srLow edge of the house temperature band at sunrise.crop_bandbanddefault 62.5; 40 to 100-62.5 (23m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_temp_low_ssLow edge of the house temperature band at sunset.crop_bandbanddefault 72; 40 to 100-70 (57m)confirmed; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_high_midHigh edge of the house VPD band at solar midnight (above it the air is too dry).crop_bandbanddefault 1.168; 0.1 to 3-1.27 (56m)confirmed; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_high_smHigh edge of the house VPD band at solar noon (above it the air is too dry).crop_bandbanddefault 1.292; 0.1 to 3-1.39 (58m)confirmed; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_high_srHigh edge of the house VPD band at sunrise (above it the air is too dry).crop_bandbanddefault 1.185; 0.1 to 3-1.29 (54m)confirmed; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_high_ssHigh edge of the house VPD band at sunset (above it the air is too dry).crop_bandbanddefault 1.275; 0.1 to 3-1.37 (20m)confirmed; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_low_midLow edge of the house VPD band at solar midnight (below it the air is too humid).crop_bandbanddefault 0.738; 0.1 to 3-0.74 (58m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_low_smLow edge of the house VPD band at solar noon (below it the air is too humid).crop_bandbanddefault 0.862; 0.1 to 3-0.86 (36m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_low_srLow edge of the house VPD band at sunrise (below it the air is too humid).crop_bandbanddefault 0.755; 0.1 to 3-0.76 (56m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_low_ssLow edge of the house VPD band at sunset (below it the air is too humid).crop_bandbanddefault 0.845; 0.1 to 3-0.84 (52m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
manual_override_timeout_minHow long a press of a panel button (fan burst, fog burst, vent bypass) lasts, in minutes.crop_bandbanddefault 10; 1 to 120-10 (27m)readback only; firmware refs 7-MCP rejects planner writes; dispatcher/crop-band owned
wet_taper_before_sunset_minMinutes before sunset when routine misting was meant to stop so leaves dry before dark.retiredbanddefault 120; 0 to 480-120 (1d)readback only; firmware refs 9-MCP rejects planner writes; retired
zone_priority_centerMisting rank of the center zone (Vanda orchids); 1 is served first.crop_bandbanddefault 1; 1 to 4-1 (40m)readback only; firmware refs 9-MCP rejects planner writes; dispatcher/crop-band owned
zone_priority_eastMisting rank of the east zone (pepper); 1 is served first.retiredbanddefault 4; 1 to 4-4 (56m)readback only; firmware refs 9-MCP rejects planner writes; retired
zone_priority_southMisting rank of the south zone; 1 is served first.crop_bandbanddefault 2; 1 to 4-2 (48m)readback only; firmware refs 9-MCP rejects planner writes; dispatcher/crop-band owned
zone_priority_westMisting rank of the west zone (citrus); 1 is served first.crop_bandbanddefault 3; 1 to 4-3 (25m)readback only; firmware refs 9-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_width_above_centerHow far above its VPD target the center zone (orchids) may drift before it counts as stressed.crop_bandbanddefault 0.35; 0.02 to 1-0.35 (27m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_width_above_eastHow far above its VPD target the east zone (peppers) may drift before it counts as stressed.crop_bandbanddefault 0.23; 0.02 to 1-0.23 (22m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_width_above_southHow far above its VPD target the south zone may drift before it counts as stressed.crop_bandbanddefault 0.22; 0.02 to 1-0.22 (47m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_width_above_westHow far above its VPD target the west zone (citrus) may drift before it counts as stressed.crop_bandbanddefault 0.22; 0.02 to 1-0.22 (19m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_width_below_centerHow far below its VPD target the center zone (orchids) band reaches (its humid edge).crop_bandbanddefault 0.2; 0.02 to 1-0.2 (21m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_width_below_eastHow far below its VPD target the east zone (peppers) band reaches (its humid edge).crop_bandbanddefault 0.15; 0.02 to 1-0.15 (27m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_width_below_southHow far below its VPD target the south zone band reaches (its humid edge).crop_bandbanddefault 0.18; 0.02 to 1-0.18 (5m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_width_below_westHow far below its VPD target the west zone (citrus) band reaches (its humid edge).crop_bandbanddefault 0.16; 0.02 to 1-0.16 (13m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned

Controller gates

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
dwell_gate_msHow long, in milliseconds, the dwell gate holds a mode after it changes (300000 ms is 5 min).planner_policyplannerdefault 300000; 60000 to 1800000-210000 (1d)confirmed; firmware refs 13-materialized from climate_intent for routine set_plan
sw_arbiter_zone_enabledOld switch that turned zone ranking for misting on or off.retiredoperatordefault 0; switch 0/1-0 (54m)readback only; firmware refs 20-MCP rejects planner writes; retired
sw_dawn_rehydrate_enabledOld switch for a scheduled center watering at dawn.retiredfirmware internaldefault 0; switch 0/1-0 (1d)readback only; firmware refs 10-MCP rejects planner writes; retired
sw_dehum_vent_hold_enabledLets the controller vent humid night air while the electric heater holds the temperature.controller_safetyoperatordefault 0; switch 0/1-1 (1d)readback only; firmware refs 10-MCP rejects planner writes; controller safety context
sw_direct_wet_stress_override_enabledOlder switch that let misting run past drying windows during dry stress.planner_policyplannerdefault 0; switch 0/1-1 (1d)confirmed; firmware refs 21-materialized from climate_intent for routine set_plan
sw_dwell_gate_enabledHolds the controller in its current mode for a minimum time after each mode change.planner_policyplannerdefault 0; switch 0/1-1 (1d)readback only; firmware refs 28-materialized from climate_intent for routine set_plan
sw_fsm_controller_enabledOld switch between the legacy controller and the current band-first controller.retiredoperatordefault 1; switch 0/1-1 (1d)reserved; firmware refs 30-MCP rejects planner writes; reserved/no-op
sw_gl_grow_auto_modeLets the controller switch the grow lights automatically.scheduled_policyscheduledefault 1; switch 0/1-1 (5m)readback only; firmware refs 2-MCP rejects planner writes; scheduled policy
sw_gl_grow_out_of_serviceMarks the grow-light fixture as dead so its on-time is not counted as light.controller_safetyoperatordefault 0; switch 0/1-0 (25m)readback only; firmware refs 15-MCP rejects planner writes; controller safety context
sw_gl_grow_solar_phasingTies the light window for the grow lights to today’s sunrise and sunset instead of clock hours.scheduled_policyscheduledefault 0; switch 0/1-0 (37m)readback only; firmware refs 14-MCP rejects planner writes; scheduled policy
sw_gl_main_auto_modeLets the controller switch the main (overhead) lights automatically.scheduled_policyscheduledefault 1; switch 0/1-1 (15m)readback only; firmware refs 2-MCP rejects planner writes; scheduled policy
sw_gl_main_out_of_serviceMarks the main grow-light fixture as dead so its on-time is not counted as light.controller_safetyoperatordefault 0; switch 0/1-0 (50m)readback only; firmware refs 15-MCP rejects planner writes; controller safety context
sw_gl_main_solar_phasingTies the light window for the main (overhead) lights to today’s sunrise and sunset instead of clock hours.scheduled_policyscheduledefault 0; switch 0/1-0 (46m)readback only; firmware refs 15-MCP rejects planner writes; scheduled policy
sw_midday_drench_enabledOld switch for a scheduled center drench around midday.retiredfirmware internaldefault 0; switch 0/1-0 (1d)readback only; firmware refs 10-MCP rejects planner writes; retired
sw_night_dryout_enabledMaster switch for night dry-out: short vent pulses with drier outdoor air while heat1 holds warmth.controller_safetyoperatordefault 1; switch 0/1-1 (1d)readback only; firmware refs 15-MCP rejects planner writes; controller safety context
sw_night_econ_heat_suppress_enabledNever heat at night just to dry the air.controller_safetyoperatordefault 1; switch 0/1-1 (1d)readback only; firmware refs 22-MCP rejects planner writes; controller safety context
sw_night_humidity_source_presentOld flag that would switch off overnight micro-pulses once a night humidifier was installed.retiredfirmware internaldefault 0; switch 0/1-- (-)context only-MCP rejects planner writes; retired
sw_night_stress_wet_enabledFormer switch for emergency wetting at night; it has no effect now.retiredoperatordefault 1; switch 0/1-1 (1d)readback only; firmware refs 22-MCP rejects planner writes; retired
sw_occupancy_inhibitStops misting, fog and the fans while someone is in the greenhouse.controller_safetyoperatordefault 1; switch 0/1-1 (41m)readback only; firmware refs 13-MCP rejects planner writes; controller safety context
sw_onchip_band_enabledWhether the controller computes the climate band itself from the crop band anchors.readback_contextfirmware internaldefault 1; switch 0/1-1 (14m)readback only; firmware refs 34-MCP rejects planner writes; readback context only
sw_overnight_micropulse_enabledOld master switch for short overnight mister pulses.retiredfirmware internaldefault 1; switch 0/1-- (-)context only-MCP rejects planner writes; retired
sw_wet_taper_enabledFormer switch for stopping routine wetting before sunset; it has no effect now.retiredoperatordefault 1; switch 0/1-1 (1d)readback only; firmware refs 22-MCP rejects planner writes; retired

Economiser

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
econ_heat_margin_fHow far below the band’s high edge the electric heater may run to dry humid air.controller_safetyplannerdefault 5; 1 to 15-5 (1d)confirmed; firmware refs 7-MCP rejects planner writes; controller safety context
enthalpy_closeOutdoor-minus-indoor air energy (kJ per kg) at or above which outside air is not used for drying.planner_policyplannerdefault 1; -5 to 20-1 (1d)confirmed; firmware refs 13-materialized from climate_intent for routine set_plan
enthalpy_openOutdoor-minus-indoor air energy (kJ per kg) at or below which outside air may be used for drying.planner_policyplannerdefault -2; -5 to 0--2 (1d)confirmed; firmware refs 13-materialized from climate_intent for routine set_plan
site_pressure_hpaBarometric pressure at the greenhouse’s elevation, a site constant.controller_safetyoperatordefault 840; 700 to 1100-840 (13m)confirmed; firmware refs 7-MCP rejects planner writes; controller safety context
sw_economiser_enabledLets outdoor air conditions block venting for humidity control.controller_safetyoperatordefault 1; switch 0/1-1 (1d)readback only; firmware refs 11-MCP rejects planner writes; controller safety context

Firmware Internal

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
dawn_boost_offset_minOld offset from sunrise for the scheduled dawn watering.retiredfirmware internaldefault 0; 0 to 360-0 (1d)readback only; firmware refs 5-MCP rejects planner writes; retired
dawn_rehydrate_gap_sGap between pulses of the old scheduled dawn watering.retiredfirmware internaldefault 0; 0 to 600-0 (1d)readback only; firmware refs 10-MCP rejects planner writes; retired
dawn_rehydrate_on_sPulse length of the old scheduled dawn watering.retiredfirmware internaldefault 0; 0 to 600-0 (1d)readback only; firmware refs 10-MCP rejects planner writes; retired
dawn_rehydrate_start_minuteStart minute of the old scheduled dawn watering.retiredfirmware internaldefault 0; 0 to 59-- (-)context only-MCP rejects planner writes; retired
dawn_rehydrate_window_minLength of the old scheduled dawn watering window.retiredfirmware internaldefault 0; 0 to 120-0 (1d)readback only; firmware refs 5-MCP rejects planner writes; retired
feed_end_hourEnd hour of the old fertigation window.retiredfirmware internaldefault 0; 0 to 23-0 (58m)readback only; firmware refs 3-MCP rejects planner writes; retired
feed_start_hourStart hour of the old fertigation window.retiredfirmware internaldefault 0; 0 to 23-0 (4m)readback only; firmware refs 3-MCP rejects planner writes; retired
micropulse_max_on_sOld cap on the length of one overnight micro-pulse.retiredfirmware internaldefault 5; 1 to 10-- (-)context only-MCP rejects planner writes; retired
micropulse_min_dew_margin_fOld minimum gap between air temperature and dew point for an overnight micro-pulse.retiredfirmware internaldefault 6; 3 to 15-- (-)context only-MCP rejects planner writes; retired
micropulse_min_gap_sOld minimum gap between overnight micro-pulses.retiredfirmware internaldefault 600; 60 to 3600-- (-)context only-MCP rejects planner writes; retired
micropulse_vpd_ceilingOld overnight VPD above which a micro-pulse could fire.retiredfirmware internaldefault 1.25; 0.8 to 3-- (-)context only-MCP rejects planner writes; retired
midday_boost_offset_minOld offset from solar noon for the scheduled midday drench.retiredfirmware internaldefault 0; 0 to 240-0 (1d)readback only; firmware refs 5-MCP rejects planner writes; retired
midday_drench_gap_sGap between pulses of the old scheduled midday drench.retiredfirmware internaldefault 0; 0 to 600-0 (1d)readback only; firmware refs 10-MCP rejects planner writes; retired
midday_drench_hourHour of the old scheduled midday drench.retiredfirmware internaldefault 0; 0 to 23-- (-)context only-MCP rejects planner writes; retired
midday_drench_on_sPulse length of the old scheduled midday drench.retiredfirmware internaldefault 0; 0 to 600-0 (1d)readback only; firmware refs 10-MCP rejects planner writes; retired
midday_drench_start_minuteStart minute of the old scheduled midday drench.retiredfirmware internaldefault 0; 0 to 59-- (-)context only-MCP rejects planner writes; retired
midday_drench_window_minLength of the old scheduled midday drench window.retiredfirmware internaldefault 0; 0 to 120-0 (1d)readback only; firmware refs 5-MCP rejects planner writes; retired

Fog gates

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
fog_escalation_kpaHow far VPD must be above the band high edge before the controller steps up its humidifying.planner_policyplannerdefault 0.4; 0.1 to 0.5-0.1 (1d)294/301 confirmed; firmware refs 12516 (1d)materialized from climate_intent for routine set_plan
fog_min_temp_fFog is blocked when the house is colder than this.controller_safetyoperatordefault 55; 40 to 65-55 (1d)confirmed; firmware refs 6-MCP rejects planner writes; controller safety context
fog_rh_ceiling_pctFog is blocked when indoor humidity is above this.controller_safetyoperatordefault 90; 75 to 98-90 (1d)confirmed; firmware refs 6-MCP rejects planner writes; controller safety context
fog_time_window_endEnd hour of the old daily window in which fog was allowed.retiredplannerdefault 18; 14 to 20-- (-)context only-MCP rejects planner writes; retired
fog_time_window_startStart hour of the old daily window in which fog was allowed.retiredplannerdefault 6; 5 to 12-- (-)context only-MCP rejects planner writes; retired
min_fog_off_sShortest time the fogger stays off before it may start again.planner_policyplannerdefault 60; 15 to 300-54 (1d)267/270 confirmed; firmware refs 201046 (1d)materialized from climate_intent for routine set_plan
min_fog_on_sShortest time the fogger runs once it starts.planner_policyplannerdefault 60; 15 to 300-66 (1d)75/76 confirmed; firmware refs 20-materialized from climate_intent for routine set_plan
sw_fog_closes_ventHolds fog off while the vent is physically open, except when fog assists cooling.planner_policyplannerdefault 1; switch 0/1-1 (1d)readback only; firmware refs 29-materialized from climate_intent for routine set_plan

Grow lights

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
gl_grow_lux_hysteresisExtra lux above the threshold daylight must reach before the grow lights turn back off.scheduled_policyscheduledefault 8000; 0 to 25000-8000 (45m)readback only; firmware refs 9-MCP rejects planner writes; scheduled policy
gl_grow_lux_thresholdOutdoor light level (lux) below which the grow lights count it as dim and may turn on.scheduled_policyscheduledefault 40000; 100 to 100000-40000 (39m)readback only; firmware refs 9-MCP rejects planner writes; scheduled policy
gl_grow_min_off_sShortest time the grow lights stay off before they may turn on again.scheduled_policyscheduledefault 60; 0 to 3600-60 (31m)23/35 confirmed; firmware refs 17-MCP rejects planner writes; scheduled policy
gl_grow_min_on_sShortest time the grow lights stay on once switched on.scheduled_policyscheduledefault 120; 0 to 3600-120 (53m)23/35 confirmed; firmware refs 17-MCP rejects planner writes; scheduled policy
gl_grow_sunrise_hourLocal clock hour when the light window for the grow lights opens.scheduled_policyscheduledefault 7; 0 to 23-7 (3m)23/35 confirmed; firmware refs 9-MCP rejects planner writes; scheduled policy
gl_grow_sunrise_offset_minMinutes from sunrise to when the solar-phased window for the grow lights opens.scheduled_policyscheduledefault 0; -1440 to 1440-0 (17m)confirmed; firmware refs 9-MCP rejects planner writes; scheduled policy
gl_grow_sunset_hourLocal clock hour when the light window for the grow lights closes.scheduled_policyscheduledefault 19; 0 to 23-22 (54m)29/42 confirmed; firmware refs 9-MCP rejects planner writes; scheduled policy
gl_grow_sunset_offset_minMinutes from sunset to when the solar-phased window for the grow lights closes.scheduled_policyscheduledefault 0; -1440 to 1440-0 (15m)confirmed; firmware refs 9-MCP rejects planner writes; scheduled policy
gl_grow_target_light_minutesDaily minutes of light the grow lights aim for, counting bright daylight and lamp time.scheduled_policyscheduledefault 960; 0 to 1080-900 (8m)29/42 confirmed; firmware refs 9-MCP rejects planner writes; scheduled policy
gl_main_lux_hysteresisExtra lux above the threshold daylight must reach before the main (overhead) lights turn back off.scheduled_policyscheduledefault 8000; 0 to 25000-8000 (19m)readback only; firmware refs 9-MCP rejects planner writes; scheduled policy
gl_main_lux_thresholdOutdoor light level (lux) below which the main (overhead) lights count it as dim and may turn on.scheduled_policyscheduledefault 40000; 100 to 100000-40000 (16m)readback only; firmware refs 10-MCP rejects planner writes; scheduled policy
gl_main_min_off_sShortest time the main (overhead) lights stay off before they may turn on again.scheduled_policyscheduledefault 60; 0 to 3600-60 (42m)23/35 confirmed; firmware refs 17-MCP rejects planner writes; scheduled policy
gl_main_min_on_sShortest time the main (overhead) lights stay on once switched on.scheduled_policyscheduledefault 120; 0 to 3600-120 (29m)23/35 confirmed; firmware refs 17-MCP rejects planner writes; scheduled policy
gl_main_sunrise_hourLocal clock hour when the light window for the main (overhead) lights opens.scheduled_policyscheduledefault 7; 0 to 23-7 (13m)23/29 confirmed; firmware refs 10-MCP rejects planner writes; scheduled policy
gl_main_sunrise_offset_minMinutes from sunrise to when the solar-phased window for the main (overhead) lights opens.scheduled_policyscheduledefault 0; -1440 to 1440-0 (57m)confirmed; firmware refs 9-MCP rejects planner writes; scheduled policy
gl_main_sunset_hourLocal clock hour when the light window for the main (overhead) lights closes.scheduled_policyscheduledefault 19; 0 to 23-20 (48m)29/30 confirmed; firmware refs 10-MCP rejects planner writes; scheduled policy
gl_main_sunset_offset_minMinutes from sunset to when the solar-phased window for the main (overhead) lights closes.scheduled_policyscheduledefault 0; -1440 to 1440-0 (29m)confirmed; firmware refs 9-MCP rejects planner writes; scheduled policy
gl_main_target_light_minutesDaily minutes of light the main (overhead) lights aim for, counting bright daylight and lamp time.scheduled_policyscheduledefault 960; 0 to 1080-780 (54m)29/30 confirmed; firmware refs 9-MCP rejects planner writes; scheduled policy

Misting and sealed-humidification

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
mist_backoff_sSeconds the controller waits before sealing to humidify again after a sealed run times out.planner_policyplannerdefault 600; 60 to 3600-600 (1d)confirmed; firmware refs 26-materialized from climate_intent for routine set_plan
mist_max_closed_vent_sLongest time the controller keeps the house sealed to humidify before it gives up for a while.planner_policyplannerdefault 600; 120 to 900-600 (1d)confirmed; firmware refs 20-materialized from climate_intent for routine set_plan
mist_thermal_relief_sLength of the forced vent-open relief after a sealed misting run (older controller path only).planner_policyplannerdefault 90; 30 to 300-90 (1d)confirmed; firmware refs 20-materialized from climate_intent for routine set_plan
mist_vent_close_lead_sReserved lead time for closing the vent before misting.retiredplannerdefault 15; 0 to 60-15 (1d)reserved; firmware refs 12-MCP rejects planner writes; reserved/no-op
mist_vent_reopen_delay_sReserved delay before reopening the vent after misting.retiredplannerdefault 45; 0 to 120-45 (1d)reserved; firmware refs 12-MCP rejects planner writes; reserved/no-op
mister_all_delay_sSeconds each humidifying stage runs before the next, heavier one may start.planner_policyplannerdefault 300; 60 to 600-60 (1d)257/258 confirmed; firmware refs 24565 (1d)materialized from climate_intent for routine set_plan
mister_all_kpaHouse VPD above which the misters move from one zone at a time to rotating through all zones.planner_policyplannerdefault 1.9; 1 to 2.5-1.11 (1d)297/299 confirmed; firmware refs 13788 (1d)materialized from climate_intent for routine set_plan
mister_all_off_sOld fixed OFF time when every mister zone ran together.retiredplannerdefault 420; 120 to 600-420 (50m)reserved; firmware refs 8-MCP rejects planner writes; reserved/no-op
mister_all_on_sOld fixed ON time when every mister zone ran together.retiredplannerdefault 480; 120 to 600-480 (8m)reserved; firmware refs 8-MCP rejects planner writes; reserved/no-op
mister_center_penaltyWeight on the center zone’s dryness when the controller scores mister zones.planner_policyplannerdefault 0.5; 0 to 1-0.5 (1d)confirmed; firmware refs 13-set_tunable allowed; planner may write with a hypothesis
mister_daily_volume_max_galHard daily water ceiling for misting and fog.irrigation_siteoperatordefault 360; 100 to 600-- (-)context only-MCP rejects planner writes; irrigation site value, delivered in the irrigation program
mister_engage_delay_sSeconds of continuous humidifying demand before the first mister pulse.planner_policyplannerdefault 45; 30 to 300-30 (51m)273/278 confirmed; firmware refs 20565 (1d)materialized from climate_intent for routine set_plan
mister_engage_kpaHouse VPD above which the misters may start pulsing once humidifying has escalated to them.planner_policyplannerdefault 1.6; 0.5 to 2.5-0.9 (1d)282/288 confirmed; firmware refs 15792 (1d)materialized from climate_intent for routine set_plan
mister_hysteresis_kpaMinimum VPD drop before the misters step down a stage.controller_safetyoperatordefault 0.1; 0.05 to 0.5-0.1 (9m)confirmed; firmware refs 9-MCP rejects planner writes; controller safety context
mister_min_off_sShortest time a mister zone must stay off before it may pulse again.planner_policyplannerdefault 45; 30 to 120-45 (18m)confirmed; firmware refs 38-set_tunable allowed; planner may write with a hypothesis
mister_off_sOld fixed OFF time of the mister duty cycle.retiredplannerdefault 600; 120 to 900-600 (13m)reserved; firmware refs 8-MCP rejects planner writes; reserved/no-op
mister_on_sOld fixed ON time of the mister duty cycle.retiredplannerdefault 300; 60 to 600-300 (13m)reserved; firmware refs 8-MCP rejects planner writes; reserved/no-op
mister_pulse_gap_sSeconds of pause between climate mister pulses, so the mist can evaporate.planner_policyplannerdefault 45; 10 to 60-30 (1d)233/238 confirmed; firmware refs 201051 (1d)materialized from climate_intent for routine set_plan
mister_pulse_on_sSeconds each climate mister pulse runs on one zone.planner_policyplannerdefault 60; 30 to 90-33 (1d)37/38 confirmed; firmware refs 20-materialized from climate_intent for routine set_plan
mister_vpd_weightPulse-length multiplier for a very dry zone while the misters rotate through all zones.planner_policyplannerdefault 1.5; 0.5 to 3-1.7 (1d)confirmed; firmware refs 15-materialized from climate_intent for routine set_plan
mister_water_budget_galDaily soft cap on mister water, in gallons.planner_policyplannerdefault 300; 100 to 300-300 (54m)confirmed; firmware refs 13-materialized from climate_intent for routine set_plan
sw_mister_closes_ventHolds ordinary mister pulses off while the vent is physically open.planner_policyplannerdefault 0; switch 0/1-0 (1d)readback only; firmware refs 25-materialized from climate_intent for routine set_plan

Operator

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
bias_coolOld offset that moved the cooling line up or down.retiredoperatordefault 0; -10 to 10-0 (1d)reserved; firmware refs 10-MCP rejects planner writes; reserved/no-op
bias_heatOld offset that moved the heating line up or down.retiredoperatordefault 0; -10 to 10-0 (1d)reserved; firmware refs 10-MCP rejects planner writes; reserved/no-op
climate_yield_minHow long a drip run waits before giving way to misting or fog.irrigation_siteoperatordefault 15; 5 to 30-- (-)context only-MCP rejects planner writes; irrigation site value, delivered in the irrigation program
night_dryout_dp_margin_fHow much drier (by dewpoint) outdoor air must be than indoor before a dry-out pulse, in °F.controller_safetyoperatordefault 3; 1 to 15-3 (1d)confirmed; firmware refs 9-MCP rejects planner writes; controller safety context
night_dryout_kwh_capNightly limit on the electric reheat the dry-out may use, in kWh.controller_safetyoperatordefault 10; 0 to 30-10 (1d)confirmed; firmware refs 9-MCP rejects planner writes; controller safety context
night_dryout_pulse_sHow long each night dry-out pulse runs the vent and lead fan, in seconds.controller_safetyoperatordefault 120; 60 to 600-600 (1d)confirmed; firmware refs 18-MCP rejects planner writes; controller safety context
night_dryout_rest_sClosed rest after each night dry-out pulse while heat1 reheats, in seconds.controller_safetyoperatordefault 780; 300 to 3600-300 (1d)confirmed; firmware refs 18-MCP rejects planner writes; controller safety context
sched_mist_rh_max_pctScheduled mist pulses are skipped when indoor humidity is at or above this.irrigation_siteoperatordefault 90; 75 to 98-- (-)context only-MCP rejects planner writes; irrigation site value, delivered in the irrigation program

Planner

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
band_track_fractionHow tightly the controller holds the band target instead of acting only at the band edges.planner_policyplannerdefault 0; 0 to 0-0 (1d)confirmed; firmware refs 12-materialized from climate_intent for routine set_plan
dehum_aggressive_kpaHow far below the VPD band the air must be before drying uses both fans.controller_safetyplannerdefault 0.6; 0.05 to 1-0.6 (1d)confirmed; firmware refs 13-MCP rejects planner writes; controller safety context
max_relief_cyclesHow many sealed-mist and relief cycles in a row before the controller forces the vent open.controller_safetyplannerdefault 3; 1 to 10-3 (1d)confirmed; firmware refs 10-MCP rejects planner writes; controller safety context
night_vpd_bias_kpaExtra VPD added to the night VPD band, most at solar midnight, without changing the crop band.planner_policyplannerdefault 0; 0 to 0.25-0 (1d)confirmed; firmware refs 12-materialized from climate_intent for routine set_plan
vent_exchange_fractionHow much outdoor air the controller assumes one venting cycle mixes into the house (0 to 1).planner_policyplannerdefault 0.3; 0.1 to 0.6-0.3 (1d)confirmed; firmware refs 13-materialized from climate_intent for routine set_plan
vent_latch_timeout_msHow long the forced vent holds after too many relief cycles before sealing may be tried again.controller_safetyplannerdefault 1800000; 60000 to 7200000-1800000 (1d)confirmed; firmware refs 9-MCP rejects planner writes; controller safety context

Readback-only firmware inputs

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
fallback_window_sHow long every climate probe may be silent before the controller reboots itself.readback_contextfirmware internaldefault 900; 60 to 3600-3600 (57m)readback only; firmware refs 12-MCP rejects planner writes; readback context only
outdoor_dewpoint_fOutdoor dew point the controller works out from outdoor temperature and humidity.readback_contextfirmware internaldefault live; - to --33.98 (0m)readback only; firmware refs 2-MCP rejects planner writes; readback context only
outdoor_temp_fOutdoor air temperature the controller uses, from the weather station.readback_contextfirmware internaldefault live; - to --40.874 (0m)readback only; firmware refs 8-MCP rejects planner writes; readback context only

Relay dwell and rotation

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
lead_rotate_sHow often the lead fan swaps between fan 1 and fan 2 when their run times are even.controller_safetyoperatordefault 600; 60 to 1800-600 (1d)confirmed; firmware refs 8-MCP rejects planner writes; controller safety context
min_fan_off_sShortest time a fan stays off before it may start again.planner_policyoperatordefault 90; 30 to 300-90 (1d)confirmed; firmware refs 20-set_tunable allowed; planner may write with a hypothesis
min_fan_on_sShortest time a fan runs once it starts.planner_policyoperatordefault 120; 30 to 300-120 (1d)confirmed; firmware refs 20-set_tunable allowed; planner may write with a hypothesis
min_heat_off_sShortest time a heater stays off before it may start again (electric heat1 and gas heat2).planner_policyoperatordefault 180; 60 to 600-180 (1d)confirmed; firmware refs 20-set_tunable allowed; planner may write with a hypothesis
min_heat_on_sShortest time a heater runs once it starts (electric heat1 and gas heat2).planner_policyoperatordefault 120; 30 to 300-120 (1d)confirmed; firmware refs 20-set_tunable allowed; planner may write with a hypothesis
min_vent_off_sShortest time the vent stays closed before it may open again.planner_policyoperatordefault 60; 10 to 300-60 (1d)confirmed; firmware refs 20-set_tunable allowed; planner may write with a hypothesis
min_vent_on_sShortest time the vent stays open once it opens.planner_policyoperatordefault 60; 10 to 300-60 (1d)confirmed; firmware refs 20-set_tunable allowed; planner may write with a hypothesis

Safety

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
night_stress_min_dew_margin_fNight condensation guard: the minimum gap between air temperature and dewpoint for wetting at night.controller_safetysafetydefault 6; 3 to 15-6 (1d)confirmed; firmware refs 9-MCP rejects planner writes; controller safety context

Safety rails

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
safety_maxHard heat guardrail: the house temperature at which the controller goes into emergency cooling.controller_safetysafetydefault 100; 80 to 110-100 (1d)confirmed; firmware refs 25-MCP rejects planner writes; controller safety context
safety_max_seal_margin_fHow far below Safety Max sealed misting must stop.controller_safetyplannerdefault 5; 1 to 15-5 (1d)confirmed; firmware refs 7-MCP rejects planner writes; controller safety context
safety_minHard cold guardrail: the house temperature at which the controller goes into emergency heating.controller_safetysafetydefault 40; 30 to 60-40 (1d)confirmed; firmware refs 15-MCP rejects planner writes; controller safety context
safety_vpd_maxHard dry-air guardrail: the VPD above which the controller forces sealed misting.controller_safetysafetydefault 2.5; 2.5 to 3-2.5 (1d)confirmed; firmware refs 18-MCP rejects planner writes; controller safety context
safety_vpd_minHard wet-air guardrail: the VPD below which the controller forces drying.controller_safetysafetydefault 0.3; 0.1 to 1.5-0.3 (1d)confirmed; firmware refs 16-MCP rejects planner writes; controller safety context

Summer vent gate

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
outdoor_staleness_max_sOldest outdoor weather reading, in seconds, the controller still trusts.planner_policyplannerdefault 600; 120 to 1800-600 (32m)confirmed; firmware refs 12-materialized from climate_intent for routine set_plan
summer_vent_min_runtime_sReserved minimum time to keep venting once the summer vent opens.retiredplannerdefault 180; 60 to 600-180 (1d)reserved; firmware refs 16-MCP rejects planner writes; reserved/no-op
sw_summer_vent_enabledMarks cooling runs where cooler, drier outdoor air made venting the better choice.planner_policyplannerdefault 1; switch 0/1-1 (1d)readback only; firmware refs 32-materialized from climate_intent for routine set_plan
vent_prefer_dp_delta_fHow much lower the outdoor dew point must be (°F) for a cooling run to count as a summer vent.planner_policyplannerdefault 5; 2 to 15-10 (1d)confirmed; firmware refs 10-materialized from climate_intent for routine set_plan
vent_prefer_temp_delta_fHow much cooler outdoor air must be (°F) for a cooling run to count as a summer vent.planner_policyplannerdefault 5; 2 to 15-15 (1d)confirmed; firmware refs 10-materialized from climate_intent for routine set_plan

Temperature band and staging

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
cold_vent_guard_delta_fHow far below the band low edge outdoor air must be before venting is treated as cold-air venting.planner_policyplannerdefault 10; 0 to 15-15 (1d)confirmed; firmware refs 10-materialized from climate_intent for routine set_plan
cool_exit_hysteresis_fHow far below the band high edge the house must cool before ventilation stops.planner_policyplannerdefault 1.5; 0.3 to 3-1.6 (1d)confirmed; firmware refs 10-materialized from climate_intent for routine set_plan
cool_stage2_exit_hysteresis_fHow far the house must cool below the fan 2 start point before fan 2 turns off.planner_policyplannerdefault 1; 0.3 to 3-1 (1d)confirmed; firmware refs 10-materialized from climate_intent for routine set_plan
cool_stage2_over_high_fHow far above the band high edge the house must get before fan 2 joins fan 1.planner_policyplannerdefault 1; 0 to 3-1.855 (1d)66/67 confirmed; firmware refs 13-materialized from climate_intent for routine set_plan
d_cool_stage_2Old margin above the cooling line at which fan 2 joined.retiredoperatordefault 3; 2 to 15-3 (1d)reserved; firmware refs 2-MCP rejects planner writes; reserved/no-op
d_heat_stage_2Old gap below the heating line at which the gas heater (heat2) joined.retiredoperatordefault 5; 2 to 15-5 (1d)reserved; firmware refs 2-MCP rejects planner writes; reserved/no-op
heat_hysteresisHow far above the heating target the electric heater keeps running.planner_policyplannerdefault 1; 0 to 3-1 (1d)confirmed; firmware refs 14-materialized from climate_intent for routine set_plan
sw_cool_all_fans_at_high_enabledRuns both fans as soon as the house rises above the band high edge.planner_policyplannerdefault 0; switch 0/1-0 (1d)confirmed; firmware refs 28-materialized from climate_intent for routine set_plan
temp_highOld fixed temperature high limit. Not a guardrail, and not the band the controller uses now.crop_bandbanddefault 95; 40 to 100-95 (20m)confirmed; firmware refs 40-MCP rejects planner writes; dispatcher/crop-band owned
temp_hysteresisTemperature margin below the band high edge that the house must be under for some drying actions.planner_policybanddefault 1.5; 0.5 to 3-1.6 (1d)confirmed; firmware refs 5-materialized from climate_intent for routine set_plan
temp_lowOld fixed temperature low limit. Not a guardrail, and not the band the controller uses now.crop_bandbanddefault 40; 30 to 80-45 (30m)confirmed; firmware refs 43-MCP rejects planner writes; dispatcher/crop-band owned

VPD band

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
vpd_highOld fixed VPD high limit. Not a guardrail, and not the band the controller uses now.crop_bandbanddefault 2.8; 0.4 to 3-2.8 (30m)confirmed; firmware refs 40-MCP rejects planner writes; dispatcher/crop-band owned
vpd_hysteresisVPD margin inside the band edges that ends humidifying and starts drying.planner_policybanddefault 0.3; 0.05 to 0.5-0.186 (1d)confirmed; firmware refs 10-materialized from climate_intent for routine set_plan
vpd_lowOld fixed VPD low limit. Not a guardrail, and not the band the controller uses now.crop_bandbanddefault 0.35; 0.1 to 1-0.35 (30m)confirmed; firmware refs 42-MCP rejects planner writes; dispatcher/crop-band owned
vpd_watch_dwell_sSeconds VPD must stay above the band high edge before the controller starts humidifying.planner_policyplannerdefault 60; 15 to 120-52 (1d)confirmed; firmware refs 21-materialized from climate_intent for routine set_plan

Zone scoring

ParameterWhat it isClassOwnerDefault / boundsActiveReadbackRouteClamps 30dPlanner status
band_temp_target_midThe temperature the house band is centred on at solar midnight.crop_bandbanddefault 65.71; 40 to 100-65.7 (33m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_temp_target_smThe temperature the house band is centred on at solar noon.crop_bandbanddefault 78.79; 40 to 100-78.8 (39m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_temp_target_srThe temperature the house band is centred on at sunrise.crop_bandbanddefault 67.5; 40 to 100-67.5 (35m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_temp_target_ssThe temperature the house band is centred on at sunset.crop_bandbanddefault 77; 40 to 100-77 (6m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_target_midThe VPD the house band is centred on at solar midnight.crop_bandbanddefault 0.83; 0.1 to 3-0.83 (1m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_target_smThe VPD the house band is centred on at solar noon.crop_bandbanddefault 1.042; 0.1 to 3-1.04 (35m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_target_srThe VPD the house band is centred on at sunrise.crop_bandbanddefault 0.935; 0.1 to 3-0.94 (18m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
band_vpd_target_ssThe VPD the house band is centred on at sunset.crop_bandbanddefault 1.025; 0.1 to 3-1.02 (41m)readback only; firmware refs 4-MCP rejects planner writes; dispatcher/crop-band owned
east_adjacency_factorHow much east-zone dryness counts toward misting the south and center zones.controller_safetyplannerdefault 0.3; 0 to 1-0.3 (1d)confirmed; firmware refs 10-MCP rejects planner writes; controller safety context
vpd_target_centerVPD target for the center zone, worked out by the platform each cycle from the zone’s target curve.crop_bandbanddefault 0.8; 0.1 to 3-0.79 (1d)418/420 confirmed; firmware refs 36-MCP rejects planner writes; dispatcher/crop-band owned
vpd_target_eastVPD target for the east zone, worked out by the platform each cycle from the zone’s target curve.crop_bandbanddefault 1; 0.3 to 3-0.8 (1d)478/480 confirmed; firmware refs 33-MCP rejects planner writes; dispatcher/crop-band owned
vpd_target_southVPD target for the south zone, worked out by the platform each cycle from the zone’s target curve.crop_bandbanddefault 1.3; 0.3 to 3-0.85 (1d)417/419 confirmed; firmware refs 36-MCP rejects planner writes; dispatcher/crop-band owned
vpd_target_westVPD target for the west zone, worked out by the platform each cycle from the zone’s target curve.crop_bandbanddefault 1.2; 0.3 to 3-0.6 (1d)612/625 confirmed; firmware refs 36-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_center_midThe VPD the center zone (orchids) aims for at solar midnight.crop_bandbanddefault 0.7; 0.1 to 3-0.7 (47m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_center_smThe VPD the center zone (orchids) aims for at solar noon.crop_bandbanddefault 1.1; 0.1 to 3-1.1 (4m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_center_srThe VPD the center zone (orchids) aims for at sunrise.crop_bandbanddefault 0.9; 0.1 to 3-0.9 (9m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_center_ssThe VPD the center zone (orchids) aims for at sunset.crop_bandbanddefault 0.9; 0.1 to 3-0.9 (32m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_east_midThe VPD the east zone (peppers) aims for at solar midnight.crop_bandbanddefault 0.74; 0.1 to 3-0.74 (14m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_east_smThe VPD the east zone (peppers) aims for at solar noon.crop_bandbanddefault 1.22; 0.1 to 3-1.22 (11m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_east_srThe VPD the east zone (peppers) aims for at sunrise.crop_bandbanddefault 0.8; 0.1 to 3-0.8 (25m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_east_ssThe VPD the east zone (peppers) aims for at sunset.crop_bandbanddefault 0.9; 0.1 to 3-0.9 (2m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_south_midThe VPD the south zone aims for at solar midnight.crop_bandbanddefault 0.75; 0.1 to 3-0.75 (35m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_south_smThe VPD the south zone aims for at solar noon.crop_bandbanddefault 1.18; 0.1 to 3-1.18 (55m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_south_srThe VPD the south zone aims for at sunrise.crop_bandbanddefault 0.85; 0.1 to 3-0.85 (34m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_south_ssThe VPD the south zone aims for at sunset.crop_bandbanddefault 0.95; 0.1 to 3-0.95 (2m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_west_midThe VPD the west zone (citrus) aims for at solar midnight.crop_bandbanddefault 0.57; 0.1 to 3-0.57 (49m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_west_smThe VPD the west zone (citrus) aims for at solar noon.crop_bandbanddefault 1.1; 0.1 to 3-1.1 (17m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_west_srThe VPD the west zone (citrus) aims for at sunrise.crop_bandbanddefault 0.6; 0.1 to 3-0.6 (58m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned
zone_vpd_target_west_ssThe VPD the west zone (citrus) aims for at sunset.crop_bandbanddefault 0.7; 0.1 to 3-0.7 (19m)readback only; firmware refs 5-MCP rejects planner writes; dispatcher/crop-band owned

Regenerate with scripts/generate-ai-tunables-page.py; publish through scripts/publish-site-content.sh so the static context and public site stay aligned.