환경 제어 자동화~

AoT 의 env_coordinator(화면에서는 통합 환경 제어)는 한 시설의 모든 액추에이터를 하나로 조율하는 3계층 제어 시스템입니다 — 개구부, 배기·흡기팬, 난방기, 냉방기, 분무기, 차광막, 보온커튼, 보광등, CO₂ 주입기.

서로 다른 두 곳에서 정해지는 두 가지가 있고, 이 둘을 섞는 것이 가장 흔한 혼란의 원인입니다.

• 무엇을 목표로 할지 — VPD·CO₂·DLI 등 — 는 그 시설에서 자라고 있는 구획의 것입니다. 구획에 붙은 재배 프로그램을 통해 정해집니다.
• 어떻게 달성할지 — 어떤 설비가 있는지, 넘으면 안 되는 선은 어디인지, 목표를 얼마나 바짝 쫓을지 — 는 이 함수의 것입니다.

목표는 어디서 오는가~

구획은 고른 프로그램을 내재화합니다. 구획 화면에서 단계 목표를 고치면 그 구획의 그 항목만 덮어쓰고, 프로그램 원본과 같은 프로그램을 쓰는 다른 구획은 그대로입니다. 칸을 비우면 그 항목은 프로그램 값으로 돌아갑니다 — 되돌리기 버튼을 따로 두지 않는 이유가 이것입니다.

의도한 제약이 둘 있습니다.

• 구획은 새 목표 항목을 만들 수 없습니다. 어휘는 프로그램의 것(target_defs)이라, 모르는 항목은 조용히 무시하지 않고 거절합니다.
• 곡선이 걸린 항목은 숫자로 덮을 수 없습니다. 곡선이 이기고, 구획 화면에서 그 항목은 읽기 전용으로 보입니다.

코디네이터가 매 사이클 읽는 것~

목표 항목과 제어 축은 항목 키가 아니라 물리량과 형태로 잇습니다 — 사용자가 "실내 CO₂" 라고 이름 붙인 항목도 물리량이 CO₂ 면 CO₂ 제어에 닿습니다. 물리량을 고르지 않은 항목은 어느 축에도 닿지 않고 화면에 참고 로 표시됩니다.

구획이 없을 때~

코디네이터는 멈추지 않습니다. 구획이 없거나, 프로그램이 없거나, AI 초안이 아직 검토되지 않았거나, 프로그램 종류가 구획 종류와 맞지 않거나, 오늘 날짜에 해당하는 단계가 없으면 목표가 없을 뿐입니다 — 제어는 자기 유도 범위 안에서 계속 돕니다. 이것은 이미 정의된 동작입니다. 비어 있는 온실도 난방은 돌아야 합니다.

주·야간 온도와 습도가 유도 범위를 정합니다~

1차 목표는 계속 VPD입니다. 단계의 주간 온도·야간 온도·습도는 목표가 아니라, VPD를 너무 덥고 습한 조합이나 너무 차고 건조한 조합으로 맞추는 것을 막는 가이드입니다. 코디네이터는 매 사이클 자기 유도 범위를 다음으로 바꿉니다.

• 폭은 고정이며 프로그램 설정이 아닙니다 — 재배 기술문서는 대부분 평균값만 주고 주·야간 폭을 적지 않습니다.
• 단계에 그 값이 없거나, 시설 위치를 몰라 일출·일몰을 구할 수 없으면 그 항목은 함수 자신의 유도 범위를 씁니다.
• 하드 임계(Min/Max Temperature, Min/Max Humidity)가 마지막에 적용됩니다.
• 유도 범위를 읽는 곳은 모두 따라옵니다: VPD를 나눈 온도·습도, VPD 목표가 없을 때의 중앙값, 예보 보정, 환기 온도 상한.
• 실제로 쓴 범위는 함수 설정의 구획 아래 가이드 범위로 보입니다.

코디네이터에는 자기 종료일 옵션이 없습니다. 재배를 계속할지는 구획이 정합니다. 함수에 날짜를 따로 두면 새 작물을 심은 뒤에도 그 날짜 때문에 시설이 멈춰 있을 수 있기 때문입니다.

제어 기준 — VPD 직접 / 온도 우선~

기본은 VPD 직접입니다 — 위처럼 VPD 목표를 좇고, 온도·습도는 가이드입니다. 고급 설정의 제어 기준을 온도 우선으로 바꾸면 코디네이터마다 다음처럼 돕니다.

• 온도가 1차 목표입니다. 단계의 주간·야간 온도(시설 위치의 일출·일몰 기준)를 좇습니다.
• 습도 목표는 VPD 목표에서 만듭니다 — 그 온도에서 VPD 목표가 되는 습도입니다 (예: 24 °C 에서 VPD 1.0 이면 약 66 %). 유도 범위 밖이면 범위 끝으로 자릅니다.
• VPD 는 경계입니다. 목표보다 0.4 kPa 낮거나 0.8 kPa 높아질 때만 되돌리는 쪽으로 밉니다.
• 단계에 온도가 없으면 온도를 좇지 않고 유도 범위 안에 두기만 합니다.

VPD 를 직접 좇으면 같은 허용오차가 8 °C 에서는 습도 ±9 %, 35 °C 에서는 ±1.8 % 가 되고, 저온에서는 닿을 수 없는 습도를 요구하기도 합니다. 온도 우선은 이 차이가 없습니다.

어느 쪽을 고르든 다른 쪽이 "그 기준이었다면 보냈을 명령" 을 매 사이클 함께 계산해 기록합니다 (제어에는 쓰지 않습니다). 두 방식을 같은 시설에서 비교하려는 것입니다.

범위 안에 구획이 둘 이상일 때~

간작·혼작이 정상인 도메인이라 코디네이터는 추측하지 않습니다. 시설·구역 범위 안에 구획이 둘 이상이면 그 사실을 말하고 [이걸로] 버튼을 내놓습니다. 같은 선택이 고급 설정의 기준 구획 에 저장됩니다. 지정한 구획이 끝났거나 범위 밖으로 나가도 값을 지우지 않습니다 — 화면이 "지정한 구획이 여기 없다" 고 말하고, 선택 규칙을 다시 적용합니다.

구획에 기록된 프로그램 버전은 버전 번호를 고정할 뿐 내용을 고정하지 않습니다. 프로그램을 고치면 진행 중인 구획의 해석도 함께 바뀝니다.

VPD (수증기압 포화차)~

VPD는 식물의 증산과 수분 흡수를 결정하는 핵심 지표입니다.

VPD = SVP × (1 - RH/100)
SVP = 0.6108 × exp(17.27T / (T + 237.3))  [kPa]

env_coordinator 제어 계층~

L1 — EnvTarget (목표값 설정)~

위에서 설명한 목표를 이번 사이클의 setpoint 로 푼다. Method 를 따르는 항목은 구획의 경과 주차와 시설 현지 시간대로 계산한다.

L2 — SituationReport (상황 평가)~

현재 편차, 제한 인자, 추세를 평가한다.

실내 온도·습도·VPD 는 먼저 잡음을 거릅니다. 센서 눈금(온도 0.1 °C, 습도 1 %)이 오르내리는 것만으로 창이 움직이지 않게 하려는 것입니다. 지수 평활을 쓰되, 원값과 온도 0.5 °C·습도 3 % 이상 벌어지면 실제 변화로 보고 곧바로 원값을 따릅니다. VPD 를 온도·습도로 계산하는 시설은 걸러진 온도·습도로 다시 계산합니다. 안전 게이트와 하드 임계는 거르기 전 원값으로 판정합니다 — 보호를 필터만큼 늦추지 않습니다.

VPD 목표가 있고 VPD 를 잴 수 있을 때 온·습도는 제약으로 강등된다 — VPD 를 풀어낼 범위이자 넘지 말아야 할 선이다. 이 함수는 온도 조절기가 아니다.

L3 — Coordinator (액추에이터 명령)~

장치마다 위치형 PI 로 0–100 % 명령을 냅니다. 교과서 PI 와 다른 점이 셋 있습니다.

• 적분은 누적 오차가 아니라 그 장치의 '기억된 평형 개도(%)' 이고, 늘 0–100 안에 묶입니다. 편차가 작으면 적분이 그대로 남아 직전 개도를 유지합니다.
• 한 장치가 여러 축에 닿으면 편차를 하나로 합칩니다. 예를 들어 개구부는 온도·습도· CO₂ 에 모두 영향을 줍니다. 축마다 편차를 비례 밴드(허용오차 × 6)로 나눠 같은 척도로 맞추고, 우선도 × 그 장치가 그 축에 주는 효과의 크기 로 가중 평균합니다.
• 허용오차의 절반 안은 쉬는 구간(데드존) 입니다. 그 밖에서는 데드존만큼을 뺀 값을 쓰므로 경계에서 명령이 계단처럼 튀지 않습니다.

e      = Σ(우선도 × 효과 × 편차/비례밴드) / Σ(우선도 × 효과)
e_eff  = e 에서 데드존(허용오차 × 0.5)을 뺀 값
I      = clamp(I + 0.2 × e_eff, 0, 100)          # 기억된 평형 개도
명령   = clamp(1.0 × e_eff × 100 + I, 0, 100)

• 확정 순서는 비용 지수 순입니다(싼 장치부터). 같은 도메인 안에서 뒤 장치는 앞 장치가 만들 효과를 뺀 나머지 편차만 봅니다 — 이것이 부하 분담입니다.
• 움직여도 소용없는 장치는 쉽니다. 100 % 로 돌려도 비례 밴드의 2.5 % 미만밖에 못 움직이거나(예: 실내외 차이가 거의 없는 환기), 파킹 대상이면 사이클마다 안전 위치와의 거리를 60 % 로 줄이며 서서히 안전 위치로 갑니다. 보온커튼은 예외로 제자리에 둡니다 — 안전 위치(걷힘)로 풀면 밤에 안팎 온도차가 작아지는 순간 보온이 풀립니다. 판정에는 이력이 있습니다 — 한 번 일할 수 있다고 본 장치는 그 문턱(2.5 %)의 절반 아래로 내려가야 '쉼'으로 바뀌므로, 문턱 근처에서 흔들리는 효과 때문에 창이 열렸다 닫혔다를 되풀이하지 않습니다(근거 '주작용'↔'무구배').
• 낮에는 보온커튼을 걷어 둡니다. 효과 모델은 커튼의 열 교환만 알고 빛을 막는다는 것은 모르므로, 시설 위치의 일출부터 일몰까지는 걷어 두고 밤에만 판단합니다. 한파 같은 안전 게이트는 이 규칙보다 우선합니다.
• 커튼·차광막은 완전히 닫거나 완전히 걷습니다. 서 있는 쪽에서 반대쪽으로 가려면 명령이 60 %(걷기) 또는 40 %(닫기)를 넘어야 합니다 — 50 % 근처에서 끝과 끝을 오가지 않게 합니다. 기록과 화면에도 실제로 보낸 0/100 이 남습니다.
• 미는 방향이 뒤집히면 이어지는지 보고 따릅니다. 창의 VPD 효과는 식힘과 건조한 외기가 겨룬 합이라, 둘이 비슷하면 실외 습도 몇 %p 로 방향이 사이클마다 바뀝니다. 새 방향이 10분 이상(그리고 2사이클 이상) 이어질 때만 따르고, 그 전에는 제자리에 둡니다. 온도가 유도 상한에 막 닿았을 때 더해지는 온도 항도 넘은 만큼 서서히 무게를 얻습니다 — 선 근처를 오르내릴 때 창이 계단으로 오르내리지 않게 합니다.
• 측창은 바람을 받는 쪽을 더 엽니다. 바람을 등진 측창은 명령의 최소 20 % 까지 줄입니다. 풍속 0.5 m/s 미만에서는 걸지 않고, 3 m/s 까지 풍압(풍속²)에 비례해 서서히 강해집니다 — 약풍의 불안정한 풍향으로 측창이 사이클마다 깎였다 풀리지 않게 합니다.
• 목표를 넘어선 채 굳지 않습니다. 데드존 안이라도 "줄여야 한다" 쪽 편차가 3사이클 이어지면, 그 장치는 명령을 사이클마다 60 % 로 줄이며 물러납니다. 보온커튼·차광막도 같습니다 — 효과가 개도에 비례하므로 줄이는 쪽이 곧 효과를 줄이는 쪽입니다.
• 적분 폭주 방지. 100 % 에 막히면 넘친 만큼 적분을 되돌리고, 0 % 에 막히면 그 사이클의 적분을 멈춥니다. 한쪽 끝에 계속 붙어 있으면 적분을 실제 개도 쪽으로 줄입니다.
• 변화 속도 제한. 사이클당 최대 20 %p 까지 움직이고, 액션에 전 행정 시간이 있으면 그 장치가 실제로 움직일 수 있는 양이 더 작을 때 그 값을 씁니다. 커튼·차광막은 한 번에 열고 닫으므로 제외입니다. 5 % 미만 명령은 0 으로 보냅니다.

VPD 모드의 온도 상한. VPD 를 직접 제어하면 온도는 제어 목표가 아니지만, 그대로 두면 더워져도 창을 여는 힘이 없습니다. 그래서 다음 판단 시점의 예상 온도(현재 + 상승률 × 주기)가 유도 상한 1 °C 앞에 닿으면 환기 장치에 온도 항을 더하고, 넘은 만큼 비중을 키웁니다. 한 번 켜진 항은 예상 온도가 그 선보다 0.5 °C 더 내려가야 꺼집니다 — 선 위에 걸터앉은 온도 때문에 창이 "식힌다" 와 "쉰다" 사이를 오가지 않게 하는 것입니다. 최고 온도 하드 임계에 닿으면 냉방기에도 걸고, 식히는 방향과 맞서는 다른 축의 항을 뺍니다. 여전히 편차에 비례하는 PI 이며 무엇도 100 % 로 강제하지 않습니다 — 실외가 더 더우면 창은 오히려 닫히는 쪽으로 갑니다.

액추에이터 도메인~

부하 분담은 도메인 안에서 일어나고, 도메인은 장치가 비슷한가가 아니라 에너지의 종착점이 같은가로 가릅니다. 설정 화면도 대체로 같은 축을 따르지만, 보광등만은 예외로 차광막·보온커튼과 함께 빛과 차광에서 설정합니다.

도메인끼리는 서로가 하는 일을 보지 않으므로, 도메인 간 조율은 암묵적인 효과 누적이 아니라 선언된 인터록이 맡습니다(환기 참조).

천창과 측창은 다르게 움직인다~

둘 다 opening 액추에이터지만, 시설 도면은 천창(ridge)과 측창(side)을 구분하고 효과 모델이 그것을 씁니다.

도면에 형태가 없으면 천창·측창 구분 없이 같은 모델로 동작합니다(보정 없음).

Function 설정~

AoT UI 에서 Function → 통합 환경 제어 로 이동합니다. 액추에이터 자체는 따로 등록하거나(액추에이터 등록), 연동 시설에서 자동으로 찾습니다.

설정 화면 읽는 법~

아래 표를 읽기 전에 다섯 가지를 알아 두면 좋습니다.

맨 위에 상태 머리말이 있습니다. 시설 선택 칸 아래에서, 제어가 지금 무엇을 하고 있는지 보여 줍니다 — 따라가는 축마다 현재 값과 목표(VPD·온도·습도·CO₂·광량), 장치 종류별 개도(개구부·난방·냉방·분무·차광 …), 마지막 판단이 몇 분 전인지. 다음 줄은 이 시설이 축마다 실제로 무엇을 조절할 수 있는지 말합니다 — 양방향, 올리기만, 내리기만, 보기만, 센서 없음. 그 아래 두 줄 요약이 따르는 구획·단계와 지금 적용 중인 목표를 말합니다. 돌 수 없는 상태는 각각 다른 문장입니다 — 이 시설에 연동된 환경 제어가 없음, 제어 꺼짐(대신 이 시설을 돌리는 제어가 있으면 그 이름까지), 이 코디네이터 자신의 기준 시간을 넘겨 판단이 없음, 아직 한 사이클도 돌지 않음. 시설을 고르기 전에는 머리말이 비어 있습니다 — 고르는 칸이 바로 위에 있기 때문입니다. 구획이 2주 안에 끝나면 그 한 줄이 더 붙습니다.

설정은 옵션 종류가 아니라 네 층으로 놓입니다.

핵심 옵션 하나가 세부를 데리고 다닙니다. 아무도 답할 수 없는 숫자("긴급 판정 배수를 3.0 으로 할까 4.0 으로 할까?")를 묻는 대신, 답할 수 있는 질문을 하고 값 여러 개를 함께 움직입니다 — 로봇청소기의 조용히/중간/강하게 와 같습니다. 그런 조작기가 셋 있습니다: 제어 성향, 환기와 냉난방 조율, 분무 빈도. 단계 이름 자체는 저장하지 않습니다 — 저장되는 것은 실제 값뿐이고, 지금 어느 단계인지는 그 값들에서 되짚습니다. 어느 단계와도 안 맞으면 직접 지정 으로 보입니다.

범위는 손잡이 둘인 밴드로 묻습니다. 온도와 습도는 질문이 하나입니다 — 몇 도에서 몇 도로 기를 것인가. 손잡이를 끌면 넘으면 안 되는 선이 고정 여유(±5 °C, ±5 %RH)로 따라 움직입니다. 끌지 않으면 하드 한계는 출하값(5–35 °C, 30–90 %) 그대로입니다. 밴드로는 하드 한계를 유도 범위보다 좁게 둘 수 없으므로 "12~32 °C 에서 기르되 30 °C 는 넘기지 마라" 는 표현할 수 없습니다 — 그 조합이 난방기와 냉방기를 서로 맞서게 하던 설정입니다. [고급] 에서 숫자를 직접 적어 그렇게 되면, 저장하는 그 자리에서 알려 줍니다 — 어느 축인지, 두 범위가 무엇인지, 실제로는 어느 범위 안에서만 목표를 세우는지 까지. 그 축의 네 값 중 하나라도 이번에 함께 저장했을 때 나옵니다. 그런 뒤 코디네이터는 유도 범위를 하드 한계 안으로 좁혀 쓰고 그 사실을 로그에 남깁니다.

[고급] 스위치 하나가 모든 숫자 칸을 엽니다. 눈금마다 숫자 칸이 함께 붙고, 고급 전용 행이 전부 드러나며, 접힌 묶음도 한 번에 펼쳐집니다. 이 스위치는 브라우저에만 있습니다 — 설정으로 저장하지 않으므로, 같은 함수를 두 사람이 다르게 보는 일이 없습니다. 상위 토글이 꺼진 설정은 비활성이 아니라 감춰집니다. 그래서 저장된 값이 계속 제출되고, 토글을 껐다 켜도 사라지지 않습니다.

어떤 설정은 특정 조건에서만 읽힙니다 — 직접 설정 구동 주기는 프로파일이 직접 지정 일 때만, 야간 시각 칸은 야간 기준이 고정 시각일 때만. 입력했는데 안 쓰이는 값이 있으면 화면이 그것을 알려 줍니다. 그러지 않으면 조용히 아무 일도 안 하기 때문입니다.

명령~

앞의 두 명령 뒤에는 다음 사이클을 한 번만 긴급으로 처리합니다 — 개구부가 구동 프로필의 간격을 기다리지 않고 움직일 수 있습니다.

시설 설정~

제어를 돌리는 시간대~

토글을 켜야 나머지가 나옵니다. 이것은 시간대별 제어가 아니라 스위치입니다. 창 밖 시간에는 목표 추종(L1~L3)이 통째로 멈춥니다 — 난방·냉방도 포함입니다. 그래도 보호는 계속됩니다.

• 사전 안전 게이트(강우·강풍·폭염·한파 등)는 매 사이클 평가됩니다. 게이트가 서면 그 강제 명령을 보냅니다. 강풍 때 바람 맞는 쪽 창만 닫는 부분 게이트도 같습니다.
• 온·습도 하드 임계의 막는 쪽도 그대로입니다. 예를 들어 실내가 최저 온도 아래로 내려가면 창과 보온커튼을 닫고 냉방을 막습니다. 하드 임계는 원래 장치를 구동하지 않으므로(난방기를 켜지는 않습니다) 시간대 밖에서도 "정지" 와 부딪히지 않습니다. 광량 임계는 보광등을 켜는 구동이라 시간대 밖에서는 쓰지 않습니다.
• 위 보호 명령을 받지 않은 장치에는 각자의 종료 동작을 보냅니다. 시각은 시설 현지 시간대로 판정하고, 시설 시간대를 모르면 서버 시각을 씁니다.

목표와 성향~

[고급] 을 켜면 각 범위 밴드가 뒤에 있는 숫자 넷(유도 T 하한/상한, 최저/최고 온도, 그리고 습도의 짝)을 함께 보이고, 제어 성향은 멤버를 보입니다.

같은 자리에 있지만 단계가 정하지 않는 멤버가 둘 더 있습니다. 같은 축의 미세 조정이기 때문입니다: 직접 설정 구동 주기 (초) — 프로파일이 직접 지정 일 때만 쓰입니다 — 와 긴급 시 최소 간격 (초), 기본 60. 뒤엣것은 긴급 상황에서도 두 번의 개구부 명령 사이에 두는 하한입니다.

구동 프로파일은 측창·천창이 실제로 움직이는 간격만 정합니다. 감지와 계산은 매 사이클 주기마다 그대로 돌고, 커튼·차광막은 한 번에 열고 닫으므로 해당이 없습니다. 안전 게이트의 강제 명령(강우·강풍 폐쇄 등)은 이 값과 무관하게 그 장치에만 즉시 나가고, 강제받지 않은 다른 창은 이 간격을 그대로 지킵니다. 이 간격을 통째로 건너뛰는 긴급은 실내 온도가 급변할 때와, 편차가 긴급 판정 임계값을 넘은 채 계속 벌어지고 있을 때뿐입니다 — 목표에서 멀리 떨어진 채 머무는 것만으로는 긴급이 아닙니다.

환기~

환기와 냉난방 조율은 토글 셋을 한 번에 움직입니다.

• 환기로 못 갈 때 창 닫기 — 환기는 실내를 실외 쪽으로만 밉니다. 목표가 실외의 반대편에 있으면 아무리 열어도 멀어질 뿐입니다. 대표적인 경우가 야간 제습으로, 실외가 실내보다 습할 때입니다. 켜 두면 개구부와 배기·흡기팬이 밤새 반쯤 열린 채 있는 대신 닫힌 채 파킹합니다.
• 환기로 닿으면 냉난방 쉬기 — 실외 공기가 이미 목표 너머에 있으면 환기만으로 닿을 수 있고, 그때 냉난방을 함께 돌리는 것은 바깥 공기가 공짜로 할 일을 돈 주고 하는 것입니다. 조건 셋을 모두 만족해야 합니다: 실외가 목표를 허용오차보다 더 지나 있고, 제어 대상 변수가 전부 그러하며, 환기에 여력이 남아 있어야 합니다(직전 사이클의 최대 개도가 90 % 미만). 실외가 목표까지의 일부만 메울 수 있으면 냉난방은 그 몫을 뺀 나머지 편차만큼만 돕니다. 15분이 지나도 목표에 못 닿으면 전부 냉난방에 넘깁니다 — 예측이 틀렸다는 뜻이기 때문입니다. 강우·풍속 값을 잃어 개구부를 더 열 수 없는 동안에는 이 판정 자체가 꺼집니다 — 더 열 수 없는 창의 도움을 믿고 냉난방이 물러나면 안 되기 때문입니다.
• 냉난방 가동 중 창 닫아 두기 — 돌고 있는 기계 옆에서 환기하면 그 열이나 냉기를 그대로 밖으로 버립니다. 다만 실외가 목표 쪽으로 도와줄 수 있는 계절에는 그 도움까지 버리게 됩니다.

가동 감지에는 근거가 필요하고, 근거는 둘뿐입니다 — 이 코디네이터가 그 기계를 직접 명령하거나, 기계가 돌 때 값이 오르는 측정을 신호 칸에 지정하거나. 실내 온도로 추측하지 않습니다. 햇빛이 강한 낮에는 냉방기가 없어도 실내가 실외보다 서늘해질 때가 있어, "실내가 실외보다 서늘하면 냉방 중" 이라는 판정은 여유를 두어도 자주 틀립니다.

신호에 자기 유효시간이 없으면 그 측정의 주기(×2, 하한 300초)로 판정합니다. 만료된 신호는 가동 중이 아님 으로 보고, 그 사실을 로그에 남깁니다.

야간 닫기가 있는 이유는 밤에 습도가 오르고 이슬이 맺히기 때문입니다. 해질 무렵 쓸모 있어 보이던 개구도 아침까지 작물을 젖은 채로 둘 수 있습니다. 하위 설정은 토글을 켜야 나옵니다.

닫아 두는 것이 오히려 위험해지면 스스로 풉니다. 온도·습도 하드 임계를 넘었을 때, 그리고 결로가 임박했는데 환기가 그것을 덜어 줄 때입니다. 결로 임박은 실내 온도와 이슬점의 차가 2 °C 보다 작은 것이고, "덜어 준다" 는 외기를 조금 섞었을 때 그 차가 벌어지는 것입니다. 차고 습한 외기는 실내를 식혀 오히려 결로를 부를 수 있어, 실외가 건조하다는 것만으로는 열지 않습니다. 풀린 뒤에는 차가 3 °C 로 회복되거나 환기가 더는 도움이 안 될 때 다시 닫습니다. 실외 값을 모르면 풀지 않습니다.

세 가지가 보장됩니다. 안전 게이트가 이깁니다(여름밤 고온이면 창은 그래도 열립니다), 온·습도 하드 임계를 넘으면 파킹이 풀리고, 태양시를 구할 좌표가 없으면 아예 파킹하지 않습니다. 이와 별개로 야간 닫기에 국한되지 않는 네 번째 규칙이 있습니다 — 실외 값 자체를 모르면(캐시가 비어 실외=실내로 가정한 합성값만 있을 때) 애초에 창을 닫지 않고 지금 위치를 그대로 유지합니다. 이번 판정에서 이 규칙이든 다른 규칙이든 이미 내린 닫기 결정도 이 유지가 덮어씁니다(다만 비·강풍 같은 비상 안전 게이트는 이 유지보다 우선해 창을 닫을 수 있습니다). 지어낸 실외=실내 값을 근거로 닫아 버리면, 기상대가 죽었을 때 한여름 낮에도 창이 닫힌 채로 남을 수 있기 때문입니다. 시각은 서버가 아니라 시설 현지 시간대로 읽습니다. 시설 팝업에서 이 옵션으로 닫힌 장치는 밤이라 닫아 둠 — 냉난방이 대신합니다 로 표시되며, 지금 이 장치가 바꿀 수 있는 것이 없음 과 구분됩니다.

냉난방·가습~

분무 밸브는 거의 전부 on/off 라 물살을 줄일 방법이 없습니다. 조절할 수 있는 것은 한 번에 몇 초 켜느냐와 다음까지 얼마나 기다리느냐뿐이고, 이 눈금이 그것을 정합니다.

일소 보호는 빈도와 별개의 결정입니다 — 둘을 따로 두어야 "자주 뿌리되 강한 볕에는 잠가 달라" 같은 조합을 정할 수 있습니다.

보호 여부와 무관하게 습윤형 분무기는 연속 변조가 아니라 펄스로 도징됩니다 — 연속 변조는 잎이 마를 틈을 주지 않기 때문입니다. 1회 시간과 간격은 분무 빈도 눈금의 값을 쓰고(출하값 자주: 1회 최대 20초, 건조 간격 600초), 값이 비어 있을 때만 30초/180초로 돕니다.

습윤형 분무는 최고 습도 하드 임계보다 앞에서도 잠깁니다. 습도가 이번 사이클의 습도 기준(VPD 목표에서 나눈 습도, 유도 범위 안) + 5 % 를 넘으면 잠그고, 습도를 모를 때도 잠급니다. 이미 젖은 공기에서 잎을 더 적시지 않기 위해서입니다. 안개형(고압 미세포그)은 해당하지 않습니다.

빛과 차광~

양 끝을 각각 끌 수 있고, "끔" 의 뜻은 두 끝에서 반대입니다. 아래 손잡이가 0 이면 보광 안 함, 위 손잡이를 끄면 차광 안 함 입니다. 시설에 차광막이나 보광등이 등록돼 있지 않으면, 아무 일도 못 하는 손잡이를 내놓는 대신 화면이 그렇게 말합니다.

차광 쪽 기준선은 닫힌 막 아래의 광량이 아니라 막을 걷었을 때 얼마나 밝은가로 판정합니다 — 그러지 않으면 닫는 순간 어두워져 판정이 풀리고, 다음 사이클에 다시 걷습니다. 실외 광량을 모르면(실내 센서만 있는 설치) 지금 값으로 판정합니다. 차광이 걸려 있는 동안에는 보광과 개방을 동시에 강제하지 않습니다. 두 기준선을 함께 만족시킬 수 없으면 — 막을 닫으면 보광 기준선보다 어두워지는 설정 — 차광을 우선하고, 그 모순을 로그에 한 번만 남겨 사람이 고칠 수 있게 합니다.

실제 값은 최소 광량 임계값 (보광)(기본 0)와 최대 광량 임계값(기본 800)이고, 둘 다 [고급] 에서 보입니다.

관련된 값 셋은 이 화면에 없습니다.

• 차광막 투과율은 시설의 것이고, 시설 편집기의 차광 커튼 아래에 있습니다. 실내 광센서가 없을 때만 쓰입니다 — 그때는 실외 일사와 차광 개도로 실내 광량을 어림합니다. 값이 없거나 범위 밖이면 0.50 으로 돌아가고, 차광막이 없다고 선언한 시설에서는 1.0 입니다. 천이 다른 차광막 하나는 자기 Action 에서 따로 지정할 수 있습니다.
• 피복재 투과율은 외피 자재에서 자동으로 나옵니다(유리 0.85 · 2중 비닐 0.78 · 부직포 0.50 등). 차광막이 없어도 지붕은 늘 빛을 깎으므로 실내 광량 추정에 함께 곱합니다. 그래서 광량 상·하한은 실내 기준입니다. 같은 250 이라도 유리온실과 부직포 하우스에서 작물이 받는 빛은 두 배 가까이 다릅니다.
• 광포화점은 차광 임계가 아니라 프로그램의 작물 K_L 에서 파생합니다. 둘을 한 값으로 두면 차광을 일찍 하려고 임계를 낮추는 순간 광합성 모델이 "빛은 이미 충분하다" 고 판정해, 강한 햇빛 아래에서도 광 제한을 보지 못하게 됩니다. K_L 이 없으면 시스템 기본 600 W/m² 를 씁니다.

고급 설정~

기본으로 접혀 있고, 재배자가 아니라 이 함수를 시험하는 사람을 위한 묶음입니다.

효과 캘리브레이션~

예보 피드포워드~

디버그 로깅은 더 이상 별도 옵션이 아닙니다. 프레임워크의 디버그 스위치와 같은 스위치가 둘이던 상태였고, 이 옵션이 감싸던 것은 거의 전부 DEBUG 레벨이라 혼자서는 아무것도 출력하지 않았습니다. 이제 함수 고급 설정의 스위치 하나가 둘 다 합니다. 중요 사건 — 안전 게이트, 디스패치 실패, 런타임 상태 오류 — 은 이 값과 무관하게 항상 기록됩니다.

액추에이터 등록~

연동 시설 도면에 그려진 액추에이터는 자동으로 찾습니다. 그 밖의 장치는 이 함수에 환경 제어(Environment Control) 액션으로 등록하고, 장치마다 액션을 하나씩 추가합니다. 수동 액션은 시설에서 찾은 목록과 병합됩니다.

디바이스 타입별 자동 변환~

명령은 언제나 0–100 % 로 산출됩니다. 어댑터는 Output 모듈의 메타데이터에서 정해지고 별도 설정이 없습니다.

습윤형 분무기는 여기에 펄스 도징이 한 겹 더 씌워집니다 — 1회 분무를 최대 작동 시간에서 끊고, 건조 간격이 지나기 전까지는 아무 명령이 와도 뿌리지 않습니다.

관수 유량은 시설 도면에서 집계합니다 — 한 레이어에 딸린 모든 emitter 유량을 합해 그 액추에이터의 flow_lpm 으로 두고, 용량형 어댑터가 그 값을 그대로 씁니다. 없을 때의 우선순위는 액추에이터별 유량 → 시설 전체 합계 → 1.0 L/min 입니다.

포그 효과 모델은 다른 유량을 씁니다 — 그 액추에이터의 드립이 아닌 분사 노즐 유량만 보고, 폴백하지 않습니다. 투여량에는 뿌리로 가는 드립이 들어가야 하지만, 공기 중으로 증발하는 양에는 들어가지 않기 때문입니다. 그래서 도면에 노즐 정보가 없는 분무기는 시설 합계를 물려받는 대신 냉각·가습 효과가 아예 없는 것으로 계산됩니다.

측정이 없는 축, 장치가 없는 축~

시설마다 갖춘 장치가 다릅니다. 잴 수는 있는데 움직일 수단이 없는 축, 반대로 움직일 수는 있는데 잴 수단이 없는 축이 모두 정상 구성입니다. 코디네이터는 그 조합을 보고 스스로 다르게 움직입니다.

함수 설정 맨 위의 조절 가능 줄이 이 조합을 축마다 한 단어로 보여 줍니다 (온도·습도·VPD·CO₂·광량). 장치 구성과 이번 사이클에 잰 값으로 코디네이터가 계산한 것이고, 단어에 마우스를 올리면 그 축을 움직이는 장치 이름이 보입니다.

장치도 센서도 없는 축은 표시하지 않습니다. 창이 CO₂ 를 조금 내리는 것처럼 부수 효과로만 움직이는 축은, 센서가 없으면 역시 표시하지 않습니다. VPD 는 온도와 습도 양쪽 장치를 함께 봅니다 — 가습 분무는 VPD 를 내리고, 환기는 실외가 건조하면 VPD 를 올립니다. 이 줄은 지금은 표시 전용이고, 제어는 위 표의 규칙대로 돕니다.

안전 게이트도 같은 규칙입니다. 실내 값을 잃으면 게이트가 그 사실에 이름을 붙여 화면과 로그에 남기지만, 강제 명령은 만들지 않습니다. 모든 장치를 안전 기본 위치로 모는 것(개구부는 닫히고 스크린은 걷힘)은 근거가 없다는 이유로 장비를 움직이는 것이기 때문입니다. 실외 값을 잃었을 때와 같은 판단이고, 제어를 통째로 멈추지도 않습니다: CO₂ 나 광량처럼 아직 잴 수 있는 축은 계속 제어합니다.

⚠ 비바람처럼 실외만으로 판단할 수 있는 위험은 그대로 막습니다. 반대로 폭염·한파는 실내 온도를 모르면 판정하지 않습니다 — 그 게이트는 전 장비를 한쪽으로 몰기 때문에 근거가 확실할 때만 서야 합니다.

어긋난 조합은 건강 점검이 함께 알려 줍니다:

python3 -m aot.scripts.check_env_coordinator_health

목표는 있는데 측정이 없는 경우, 목표는 있는데 장치가 없는 경우, 장치는 있는데 그 장치가 미는 축을 하나도 못 재는 경우를 설정 점검에 보고합니다. 측정만 있고 목표도 장치도 없는 축은 보고하지 않습니다 — 그것이 곧 참고값입니다.

안전 기본 위치~

각 액추에이터에는 안전 게이트 발동, 긴급 정지, 외부 force_safe_state() 호출 시 이동할 안전 위치가 있습니다. 이 위치는 장치 종류를 따릅니다 — 보온커튼과 차광막은 100 % 로 파킹하고, 나머지는 0(끔)입니다. 시설 도면에서 찾은 액추에이터든 액션으로 등록한 액추에이터든 같습니다.

Method (제어 곡선)~

Method 는 setpoint 가 시간에 따라 어떻게 변하는지 정의합니다. Method 는 이 함수가 아니라 프로그램의 목표 항목에 붙습니다 — 곡선이 걸린 항목은 구획 화면에 곡선을 따름 으로 표시되고 숫자로 덮을 수 없습니다.

• Daily — 시각(HH:MM)별 setpoint
• Duration — 시작 후 경과 시간(h)별
• Daily Bezier — 부드러운 일주 곡선
• Repeating — 반복 패턴

생육 주차로 진행하는 곡선은 구획 시작일을 기준으로 계산합니다. 날짜만 있는 값은 시설 현지 시간대의 자정으로 읽고, 주차는 구획 화면·구획 일지와 같은 계산을 씁니다.

작물 단계 스케줄 예시(토마토):

SEED: 로 시작하는 Method 는 시드 프리셋이라 읽기 전용입니다. 편집하려면 복제한 뒤 수정하세요.

안전 게이트~

안전은 L1~L3 조율 알고리즘 밖에서 돕니다 — 매 사이클 L1~L3 앞에서 평가하는 Pre-Gate 와, L3 결과를 내보내기 직전에 검증하는 Post-Gate 입니다. 한 번 발동한 Pre-Gate 는 마지막 발동 후 최소 300초 동안 유지됩니다(빠른 on/off 반복 방지). 게이트가 풀리면, 게이트가 움직인 장치는 게이트가 둔 위치에서 평형을 다시 찾습니다. 게이트 전의 평형 개도로 곧장 돌아가지 않습니다 — 그사이 조건이 바뀌었을 수 있기 때문입니다. 게이트의 강제 명령은 구동 주기를 기다리지 않고 즉시 나가며, 게이트가 서 있는 동안 매 사이클 다시 보냅니다. 게이트가 강제하지 않은 장치는 평소 구동 주기를 그대로 지킵니다 — 한 장치에 게이트가 서 있다고 시설 나머지가 빨라지지 않습니다.

Pre-Gate (L1~L3 진입 전 평가)~

값을 잃은 것은 비상이 아니라 제약입니다. 실내 값 끊김과 실외 비·바람 끊김은 둘 다 강제 명령을 만들지 않고, 300초 유지도 걸지 않으며, 이 둘만 서 있으면 L1~L3 가 정상 실행됩니다. 근거가 없다는 이유로 장비를 움직이지 않는다는 규칙이고, 움직일지 말지는 코디네이터가 축별로 판단합니다.

강우·폭염·한파 임계는 코드에 고정돼 있고, 함수 옵션으로 노출된 것은 강풍 임계 하나뿐입니다. 여러 게이트가 동시에 활성일 수 있으며(예: 강우 + 강풍), 그때 개구부는 풍향과 무관하게 무조건 닫힙니다.

게이트가 걸린 사이클도 사이클입니다. 게이트가 사이클을 일찍 끝내면 축소 요약을 남기고 사이클 도장을 찍습니다. 그래서 시설 위젯이 무슨 일이 있었는지 계속 보여 주고, 코디네이터가 무응답인 것처럼 보고하지 않습니다. 축소 요약에도 이번 사이클에 실제로 잰 환경 값은 그대로 실립니다 — 게이트가 걸려 있어도 센서는 계속 재고 있기 때문입니다. 빠지는 것은 L1~L3 가 만들었을 값(목표·편차 등)뿐입니다. 장치도 게이트가 강제한 것만이 아니라 전부 목록에 남습니다 — 건드리지 않은 장치는 0 % 가 아니라 명령 자체가 없습니다.

Post-Gate (L3 이후, 디스패치 직전 검증)~

긴급 정지와 안전 상태~

긴급 정지 후 60초 동안 다음 사이클이 지연됩니다. 그 직후 액추에이터가 움직이지 않는 것은 고장이 아니라 이 지연입니다.

트러블슈팅~

AI와의 연동~

AoT 의 AI 채팅과 MCP 로 연결한 AI 는 다음 도구로 이 코디네이터를 봅니다. 쓰기 도구는 모두 사람의 승인을 거칩니다.

목표는 이 함수가 아니라 구획의 단계 계획에 있습니다. 한 구획의 목표만 바꾸려면 구획 화면에서 고칩니다. AI 가 프로그램을 고치는 도구(modify_program)로 단계 목표를 바꿀 수도 있지만, 그 프로그램을 쓰는 모든 구획에 적용됩니다.

관련 페이지~

• AI 개요
• Function 가이드
• Method 가이드