Functions

페이지: 설정 -> 기능

지원되는 기능의 전체 목록은 지원되는 기능을 참조하세요.

기능 컨트롤러는 종종 입력 및 출력을 사용하는 작업을 수행합니다.

사용자 정의 기능~

AoT에는 사용자 생성 기능을 AoT 시스템에서 사용할 수 있도록 하는 사용자 정의 기능 가져오기 시스템이 있습니다. 사용자 정의 기능은 [톱니바퀴 아이콘] -> 구성 -> 사용자 정의 기능 페이지에서 업로드할 수 있습니다. 가져온 후에는 설정 -> 기능 페이지에서 사용할 수 있습니다.

작동하는 기능 모듈을 개발한 경우, 새 GitHub 이슈 생성 또는 풀 리퀘스트를 고려해 보세요. 해당 모듈이 기본 제공 세트에 포함될 수 있습니다.

적절한 포맷팅 예제를 보려면 디렉토리 AoT/aot/functions에 있는 기본 제공 모듈을 열어보세요.

또한, 디렉토리 AoT/aot/functions/examples에는 사용자 정의 기능 예제가 포함되어 있습니다.

기본 제공 세트에 포함되지 않은 사용자 정의 모듈에 전념하는 또 다른 GitHub 저장소는 aot-inc/AoT-custom에서 확인할 수 있습니다.

새로운 측정값/단위가 필요한 기능의 경우, [톱니바퀴 아이콘] -> 구성 -> 측정값 페이지에서 추가할 수 있습니다.

PID 컨트롤러~

비례-적분-미분(PID) 컨트롤러는 시스템 제어를 위해 산업 전반에서 사용되는 제어 루프 피드백 메커니즘입니다. 이는 온도와 같은 측정 가능한 조건을 효율적으로 원하는 상태로 가져가고, 오버슈트와 진동을 최소화하며 그 상태를 유지합니다. 잘 조정된 PID 컨트롤러는 설정값에 빠르게 도달하고, 오버슈트를 최소화하며, 설정값을 적은 진동으로 유지합니다.

PID 설정은 PID가 활성화된 동안 변경할 수 있으며, 새로운 설정은 즉시 적용됩니다. 컨트롤러가 일시 중지된 동안 설정이 변경되면, 컨트롤러가 작동을 재개할 때 변경된 값이 사용됩니다.

PID 컨트롤러 옵션~

PID 출력 계산~

PID 컨트롤러는 지속 시간, 볼륨 또는 PWM 듀티 사이클과 같은 다양한 출력 유형을 제어할 수 있습니다. 대부분의 출력 유형에서는 PID 출력(제어 변수)이 비례적으로 작동합니다(예: 출력 지속 시간 = PID 제어 변수). 그러나 듀티 사이클을 출력할 때는 듀티 사이클 = (제어 변수 / 주기) * 100으로 계산됩니다.

PID 튜닝~

PID 튜닝은 사용되는 출력 장치와 제어 대상 환경 또는 시스템에 따라 복잡한 과정이 될 수 있습니다. 큰 변동이 있는 시스템은 안정적인 시스템보다 제어하기 더 어렵습니다. 마찬가지로 적합하지 않은 출력 장치는 PID 튜닝을 어렵게 하거나 불가능하게 만들 수 있습니다. PID 컨트롤러의 작동 방식과 튜닝 이론을 배우면 PID 컨트롤러를 더 잘 운영할 수 있을 뿐만 아니라 시스템 개발, 출력 장치 선택 및 구현에도 도움이 됩니다.

PID 튜닝 리소스~

• 수비드 PID 튜닝과 예상치 못한 전기 화재

PID 제어 이론~

PID 컨트롤러는 단순한 제어부터 복잡한 제어까지 처리할 수 있는 능력으로 인해 산업 환경에서 가장 일반적으로 사용되는 규제 컨트롤러입니다. PID 컨트롤러는 비례, 적분, 미분의 세 가지 경로를 가집니다.

P(비례)는 오차를 K_P 상수로 곱하여 출력 값을 생성합니다. 오차가 클수록 비례 출력도 커집니다.

I(적분)는 오차를 K_I로 곱한 후 이를 적분합니다(K_I · 1/s). 시간이 지남에 따라 오차가 변화하면 적분은 이를 지속적으로 합산하고 K_I 상수로 곱합니다. 적분은 제어 시스템에서 지속적인 오차를 제거하는 데 사용됩니다. K_P만 사용하여 출력이 지속적인 오차를 생성하는 경우(즉, 센서 측정값이 설정값에 도달하지 못하는 경우), 적분은 출력 값을 증가시켜 오차를 줄이고 설정값에 도달하도록 합니다.

D(미분)는 오차를 K_D로 곱한 후 이를 미분합니다(K_D · s). 시간이 지남에 따라 오차 변화율이 달라지면 출력 신호도 변화합니다. 오차 변화가 빠를수록 미분 경로가 커지며 출력 변화율을 감소시킵니다. 이는 설정값의 오버슈트와 언더슈트(진동)를 줄이는 효과를 가집니다.

K_P, K_I, K_D 게인은 P, I, D 변수가 최종 PID 출력 값에 얼마나 영향을 미치는지를 결정합니다. 예를 들어, 게인 값이 클수록 해당 변수가 출력에 미치는 영향이 커집니다.

PID 컨트롤러의 출력은 여러 방식으로 사용할 수 있습니다. 간단한 사용 사례는 이 값을 주기적 간격(Period) 동안 출력이 켜지는 시간(초)으로 사용하는 것입니다. 예를 들어, 주기가 30초로 설정된 경우 PID 방정식은 원하는 측정값과 실제 측정값을 사용하여 매 30초마다 PID 출력을 계산합니다. 이 주기 동안 출력이 켜지는 시간이 길수록 시스템에 더 큰 영향을 미칩니다. 예를 들어, 출력이 매 30초마다 15초 동안 켜져 있으면 50 % 듀티 사이클이며, 출력이 매 30초마다 30초 동안 켜져 있으면 100 % 듀티 사이클로 시스템에 두 배의 영향을 미칩니다. PID 컨트롤러는 실제 측정값이 원하는 측정값과 얼마나 차이가 나는지(오차)를 기반으로 출력을 계산합니다. 오차가 증가하거나 지속되면 출력이 증가하여 주기 내에서 출력이 더 오래 켜지게 되고, 이는 일반적으로 측정 조건을 변경하여 오차를 줄이는 결과를 가져옵니다. 오차가 줄어들면 제어 변수가 감소하여 출력이 더 짧은 시간 동안 켜지게 됩니다. 잘 조정된 PID 컨트롤러의 궁극적인 목표는 실제 측정값을 설정값으로 빠르게 가져가고, 오버슈트를 최소화하며, 설정값을 최소한의 진동으로 유지하는 것입니다.

온도를 예로 들면, 프로세스 변수(PV)는 측정된 온도, 설정값(SP)은 원하는 온도, 그리고 오차(e)는 측정된 온도와 원하는 온도 간의 차이를 나타냅니다(즉, 실제 온도가 너무 높거나 낮은 정도를 나타냄). 이 오차는 PID의 세 가지 구성 요소 각각에 의해 조작되어 조작 변수(MV) 또는 제어 변수(CV)라고 불리는 출력을 생성합니다. 각 경로가 출력 값에 기여하는 정도를 제어하기 위해 각 경로는 게인(K_P, K_I, K_D)으로 곱해집니다. 게인을 조정하면 시스템이 각 경로에 얼마나 민감하게 반응하는지가 영향을 받습니다. 세 경로를 모두 합산하면 PID 출력이 생성됩니다. 게인을 0으로 설정하면 해당 경로는 출력에 기여하지 않으며 사실상 꺼진 상태가 됩니다.

출력은 여러 방식으로 사용될 수 있지만, 이 컨트롤러는 출력을 사용하여 측정된 값(PV)에 영향을 미치도록 설계되었습니다. 이 피드백 루프는 적절히 튜닝된 PID 컨트롤러를 통해 짧은 시간 안에 설정값에 도달하고, 진동을 최소화하며, 방해 요소에 빠르게 반응할 수 있습니다.

따라서 온도를 조절하려는 경우, 센서는 온도 센서가 되고 피드백 장치는 가열 및 냉각이 가능한 장치가 됩니다. 온도가 설정값보다 낮으면 출력 값이 양수가 되어 히터가 작동합니다. 온도는 원하는 온도를 향해 상승하며, 이로 인해 오차가 감소하고 더 낮은 출력이 생성됩니다. 이 피드백 루프는 오차가 0에 도달할 때까지 계속됩니다(이 시점에서 출력은 0이 됩니다). 온도가 설정값을 초과하여 계속 상승하는 경우(허용 가능한 범위 내일 수 있음), PID는 음수 출력을 생성하여 냉각 장치가 온도를 다시 낮추고 오차를 줄이도록 할 수 있습니다. 온도가 냉각 장치의 도움 없이도 자연적으로 낮아질 수 있다면, 냉각 장치를 생략하고 시스템을 단순화할 수 있습니다.

K_P, K_I, K_D를 효과적으로 활용하는 컨트롤러를 구현하는 것은 어려울 수 있으며, 종종 불필요하기도 합니다. 예를 들어, K_I와 K_D를 0으로 설정하면 해당 경로가 꺼지고 매우 간단한 P 컨트롤러가 생성됩니다. 또한 PI 컨트롤러도 인기가 많습니다. K_P만 활성화된 상태로 시작한 후 K_P와 K_I를 실험적으로 조합해 보고, 마지막으로 세 가지를 모두 사용하는 것을 권장합니다. 시스템은 공기 공간의 부피, 단열 정도, 연결된 장치의 영향 정도 등 다양한 요인에 따라 달라지므로, 각 경로는 실험을 통해 효과적인 출력을 생성하도록 조정해야 합니다.

빠른 설정 예제~

이 예제 설정은 특정 방향으로의 조절을 구성하는 방법을 보여주기 위한 것이며, K_P, K_I, K_D 게인을 구성하기 위한 이상적인 값을 달성하려는 것이 아닙니다. PID 값을 결정하기 위해 개발된 다양한 기술과 방법을 다루는 온라인 리소스가 많이 있으므로(여기, 여기, 여기, 여기, 여기), 변수를 이해하고 효과적으로 구현하기 위해 자체 연구와 실험을 수행하는 것이 필수적입니다.

PID 값의 변동성을 단순히 예로 들자면, 한 설정에서는 온도 PID 값(상승 조절)이 K_P = 30, K_I = 1.0, K_D = 0.5였고, 습도 PID 값(상승 조절)이 K_P = 1.0, K_I = 0.2, K_D = 0.5였습니다. 또한, 이러한 값이 최적은 아니었지만 환경 챔버 조건에서는 잘 작동했습니다.

정확한 온도 조절~

이 시스템은 두 개의 조절 장치(하나는 가열, 다른 하나는 냉각)를 사용하여 특정 온도로 온도를 올리고 내리도록 설정합니다.

센서를 추가한 다음, 각 센서에 적합한 장치와 핀/주소를 저장하고 센서를 활성화합니다.

두 개의 출력을 추가한 다음, 각 GPIO와 On Trigger 상태를 저장합니다.

PID를 추가한 다음, 새로 생성된 센서를 선택합니다. 설정값(Setpoint)을 원하는 온도로 변경하고, 조절 방향(Regulate Direction)을 "양방향(Both)"으로 설정합니다. 상승 출력(Raise Output)을 가열 장치에 연결된 릴레이로 설정하고, 하강 릴레이(Lower Relay)를 냉각 장치에 연결된 릴레이로 설정합니다.

K_P = 1, K_I = 0, K_D = 0으로 설정한 다음 PID를 활성화합니다.

온도가 설정값보다 낮으면 PID 컨트롤러가 결정한 간격에 따라 히터가 활성화되어 온도가 설정값까지 상승합니다. 온도가 설정값(또는 설정값 + 버퍼)보다 높아지면 냉각 장치가 활성화되어 온도가 설정값으로 돌아갑니다. 온도가 설정값에 도달하지 않는 경우, K_P 값을 증가시키고 시스템에 미치는 영향을 확인합니다. 읽기 간격(Read Interval)과 K_P만 조정하여 적절한 조절을 달성하기 위해 실험해 보세요. K_P만으로 작동하는 조절이 이루어질 때까지 K_I와 K_D는 0으로 유지하세요.

6~12시간의 시간 범위에서 그래프를 확인하여 온도가 설정값에 얼마나 잘 조절되는지 확인하세요. "잘 조절된다"는 것은 특정 응용 프로그램과 허용 오차에 따라 다릅니다. 대부분의 PID 컨트롤러 응용 프로그램에서는 적절한 온도가 합리적인 시간 내에 도달하고 설정값 주변에서 진동이 적은 것을 선호합니다.

조절이 이루어진 후, K_P를 약간(~25%) 줄이고 K_I를 낮은 값(예: 0.1 또는 0.01)으로 증가시키며 PID를 시작하고 컨트롤러가 얼마나 잘 조절하는지 관찰하세요. K_I를 천천히 증가시켜 조절이 빠르고 진동이 적어지도록 만드세요. 이 시점에서 시스템과 K_D 값을 실험할 준비가 되었으며, K_P와 K_I가 조정된 후 K_D를 실험해 보세요.

고온 조절~

양방향 조절이 필요하지 않은 경우 시스템을 단순화할 수 있습니다. 예를 들어, 냉각이 불필요한 경우 이를 시스템에서 제거하고 상승 조절만 사용할 수 있습니다.

정확한 온도 조절 예제와 동일한 구성을 사용하되, 조절 방향(Regulate Direction)을 "상승(Raise)"으로 변경하고 "하강 릴레이(Down Relay)" 섹션은 건드리지 마세요.

PID 자동 튜닝~

자동 튜닝 기능은 PID 컨트롤러에서 사용할 적절한 Kp, Ki, Kd 게인을 결정하는 데 유용한 독립형 컨트롤러입니다. 자동 튜너는 출력을 조작하고 특정 환경/시스템에서 측정된 반응을 분석합니다. PID 게인을 계산하기 위해 충분한 데이터를 수집하려면 선택한 출력으로 시스템을 여러 번 교란해야 합니다. 이 기능을 사용하려면 측정값과 측정된 특정 조건을 조정할 수 있는 출력을 선택하세요. 그런 다음, 노이즈 밴드와 출력 단계를 구성하고 기능을 활성화합니다. 자동 튜너의 로그는 데몬 로그([톱니바퀴 아이콘] -> AoT 로그 -> 데몬 로그)에 나타납니다. 자동 튜닝이 수행되는 동안, 대시보드 그래프를 생성하여 측정값과 출력을 포함시키는 것이 좋습니다. 이를 통해 PID 자동 튜너가 수행하는 작업과 구성된 자동 튜닝 설정에서 발생할 수 있는 문제를 확인할 수 있습니다. 자동 튜닝이 완료되는 데 시간이 오래 걸리는 경우, 조작 중인 시스템에 충분한 안정성이 없어 신뢰할 수 있는 PID 게인 세트를 계산하지 못할 수 있습니다. 이는 시스템에 너무 많은 교란이 있거나 조건이 너무 빠르게 변하여 일관된 측정값 진동을 얻을 수 없는 경우일 수 있습니다. 이 경우, 시스템을 수정하여 안정성을 높이고 일관된 측정값 진동을 생성하도록 시도하세요. 자동 튜닝이 성공적으로 완료되면, PID 컨트롤러가 이를 처리할 수 있도록 교란을 다시 도입하여 추가 튜닝을 수행할 수 있습니다.

일반적인 그래프 출력은 다음과 같습니다:

그리고 일반적인 데몬 로그 출력은 다음과 같습니다:

2018-08-04 23:32:20,876 - aot.pid_3b533dff - INFO - Activated in 187.2 ms
2018-08-04 23:32:20,877 - aot.pid_autotune - INFO - PID Autotune started
2018-08-04 23:33:50,823 - aot.pid_autotune - INFO -
2018-08-04 23:33:50,830 - aot.pid_autotune - INFO - Cycle: 19
2018-08-04 23:33:50,831 - aot.pid_autotune - INFO - switched state: relay step down
2018-08-04 23:33:50,832 - aot.pid_autotune - INFO - input: 32.52
2018-08-04 23:36:00,854 - aot.pid_autotune - INFO -
2018-08-04 23:36:00,860 - aot.pid_autotune - INFO - Cycle: 45
2018-08-04 23:36:00,862 - aot.pid_autotune - INFO - found peak: 34.03
2018-08-04 23:36:00,863 - aot.pid_autotune - INFO - peak count: 1
2018-08-04 23:37:20,802 - aot.pid_autotune - INFO -
2018-08-04 23:37:20,809 - aot.pid_autotune - INFO - Cycle: 61
2018-08-04 23:37:20,810 - aot.pid_autotune - INFO - switched state: relay step up
2018-08-04 23:37:20,811 - aot.pid_autotune - INFO - input: 31.28
2018-08-04 23:38:30,867 - aot.pid_autotune - INFO -
2018-08-04 23:38:30,874 - aot.pid_autotune - INFO - Cycle: 75
2018-08-04 23:38:30,876 - aot.pid_autotune - INFO - found peak: 32.17
2018-08-04 23:38:30,878 - aot.pid_autotune - INFO - peak count: 2
2018-08-04 23:38:40,852 - aot.pid_autotune - INFO -
2018-08-04 23:38:40,858 - aot.pid_autotune - INFO - Cycle: 77
2018-08-04 23:38:40,860 - aot.pid_autotune - INFO - switched state: relay step down
2018-08-04 23:38:40,861 - aot.pid_autotune - INFO - input: 32.85
2018-08-04 23:40:50,834 - aot.pid_autotune - INFO -
2018-08-04 23:40:50,835 - aot.pid_autotune - INFO - Cycle: 103
2018-08-04 23:40:50,836 - aot.pid_autotune - INFO - found peak: 33.93
2018-08-04 23:40:50,836 - aot.pid_autotune - INFO - peak count: 3
2018-08-04 23:42:05,799 - aot.pid_autotune - INFO -
2018-08-04 23:42:05,805 - aot.pid_autotune - INFO - Cycle: 118
2018-08-04 23:42:05,806 - aot.pid_autotune - INFO - switched state: relay step up
2018-08-04 23:42:05,807 - aot.pid_autotune - INFO - input: 31.27
2018-08-04 23:43:15,816 - aot.pid_autotune - INFO -
2018-08-04 23:43:15,822 - aot.pid_autotune - INFO - Cycle: 132
2018-08-04 23:43:15,824 - aot.pid_autotune - INFO - found peak: 32.09
2018-08-04 23:43:15,825 - aot.pid_autotune - INFO - peak count: 4
2018-08-04 23:43:25,790 - aot.pid_autotune - INFO -
2018-08-04 23:43:25,796 - aot.pid_autotune - INFO - Cycle: 134
2018-08-04 23:43:25,797 - aot.pid_autotune - INFO - switched state: relay step down
2018-08-04 23:43:25,798 - aot.pid_autotune - INFO - input: 32.76
2018-08-04 23:45:30,802 - aot.pid_autotune - INFO -
2018-08-04 23:45:30,808 - aot.pid_autotune - INFO - Cycle: 159
2018-08-04 23:45:30,810 - aot.pid_autotune - INFO - found peak: 33.98
2018-08-04 23:45:30,811 - aot.pid_autotune - INFO - peak count: 5
2018-08-04 23:45:30,812 - aot.pid_autotune - INFO -
2018-08-04 23:45:30,814 - aot.pid_autotune - INFO - amplitude: 0.9099999999999989
2018-08-04 23:45:30,815 - aot.pid_autotune - INFO - amplitude deviation: 0.06593406593406595
2018-08-04 23:46:40,851 - aot.pid_autotune - INFO -
2018-08-04 23:46:40,857 - aot.pid_autotune - INFO - Cycle: 173
2018-08-04 23:46:40,858 - aot.pid_autotune - INFO - switched state: relay step up
2018-08-04 23:46:40,859 - aot.pid_autotune - INFO - input: 31.37
2018-08-04 23:47:55,860 - aot.pid_autotune - INFO -
2018-08-04 23:47:55,866 - aot.pid_autotune - INFO - Cycle: 188
2018-08-04 23:47:55,868 - aot.pid_autotune - INFO - found peak: 32.36
2018-08-04 23:47:55,869 - aot.pid_autotune - INFO - peak count: 6
2018-08-04 23:47:55,870 - aot.pid_autotune - INFO -
2018-08-04 23:47:55,871 - aot.pid_autotune - INFO - amplitude: 0.9149999999999979
2018-08-04 23:47:55,872 - aot.pid_autotune - INFO - amplitude deviation: 0.032786885245900406
2018-08-04 23:47:55,873 - aot.pid_3b533dff - INFO - time:  16 min
2018-08-04 23:47:55,874 - aot.pid_3b533dff - INFO - state: succeeded
2018-08-04 23:47:55,874 - aot.pid_3b533dff - INFO -
2018-08-04 23:47:55,875 - aot.pid_3b533dff - INFO - rule: ziegler-nichols
2018-08-04 23:47:55,876 - aot.pid_3b533dff - INFO - Kp: 0.40927018474290117
2018-08-04 23:47:55,877 - aot.pid_3b533dff - INFO - Ki: 0.05846588600007114
2018-08-04 23:47:55,879 - aot.pid_3b533dff - INFO - Kd: 0.7162385434443115
2018-08-04 23:47:55,880 - aot.pid_3b533dff - INFO -
2018-08-04 23:47:55,881 - aot.pid_3b533dff - INFO - rule: tyreus-luyben
2018-08-04 23:47:55,887 - aot.pid_3b533dff - INFO - Kp: 0.3162542336649691
2018-08-04 23:47:55,889 - aot.pid_3b533dff - INFO - Ki: 0.010165091543194185
2018-08-04 23:47:55,890 - aot.pid_3b533dff - INFO - Kd: 0.7028026111719073
2018-08-04 23:47:55,891 - aot.pid_3b533dff - INFO -
2018-08-04 23:47:55,892 - aot.pid_3b533dff - INFO - rule: ciancone-marlin
2018-08-04 23:47:55,892 - aot.pid_3b533dff - INFO - Kp: 0.21083615577664605
2018-08-04 23:47:55,893 - aot.pid_3b533dff - INFO - Ki: 0.06626133746674728
2018-08-04 23:47:55,893 - aot.pid_3b533dff - INFO - Kd: 0.3644161687558038
2018-08-04 23:47:55,894 - aot.pid_3b533dff - INFO -
2018-08-04 23:47:55,894 - aot.pid_3b533dff - INFO - rule: pessen-integral
2018-08-04 23:47:55,895 - aot.pid_3b533dff - INFO - Kp: 0.49697093861638
2018-08-04 23:47:55,895 - aot.pid_3b533dff - INFO - Ki: 0.0887428626786794
2018-08-04 23:47:55,896 - aot.pid_3b533dff - INFO - Kd: 1.04627757151908
2018-08-04 23:47:55,896 - aot.pid_3b533dff - INFO -
2018-08-04 23:47:55,897 - aot.pid_3b533dff - INFO - rule: some-overshoot
2018-08-04 23:47:55,898 - aot.pid_3b533dff - INFO - Kp: 0.23191977135431066
2018-08-04 23:47:55,898 - aot.pid_3b533dff - INFO - Ki: 0.03313066873337365
2018-08-04 23:47:55,899 - aot.pid_3b533dff - INFO - Kd: 1.0823160212047374
2018-08-04 23:47:55,899 - aot.pid_3b533dff - INFO -
2018-08-04 23:47:55,900 - aot.pid_3b533dff - INFO - rule: no-overshoot
2018-08-04 23:47:55,900 - aot.pid_3b533dff - INFO - Kp: 0.1391518628125864
2018-08-04 23:47:55,901 - aot.pid_3b533dff - INFO - Ki: 0.01987840124002419
2018-08-04 23:47:55,901 - aot.pid_3b533dff - INFO - Kd: 0.6493896127228425
2018-08-04 23:47:55,902 - aot.pid_3b533dff - INFO -
2018-08-04 23:47:55,902 - aot.pid_3b533dff - INFO - rule: brewing
2018-08-04 23:47:55,903 - aot.pid_3b533dff - INFO - Kp: 5.566074512503456
2018-08-04 23:47:55,904 - aot.pid_3b533dff - INFO - Ki: 0.11927040744014512
2018-08-04 23:47:55,904 - aot.pid_3b533dff - INFO - Kd: 4.101408080354794

조건부 기능~

조건부 기능은 사용자가 생성한 Python 코드를 기반으로 간단한 작업부터 복잡한 작업까지 수행하는 데 사용됩니다. 조건부 기능은 Python 3 코드를 실행하고, 코드 내에서 AoT와 상호작용하기 위해 조건(Conditions) 및 작업(Actions)을 사용할 수 있도록 합니다. 조건은 일반적으로 AoT에서 데이터를 가져오는 데 사용되며(예: 입력 측정값), 작업은 AoT에 영향을 미치는 데 사용됩니다(예: 출력 작동 또는 PID 컨트롤러 일시 중지). 추가한 각 조건과 작업은 Python 코드에서 사용하는 방법을 보여주는 설명과 예제 코드를 제공합니다.

조건부 옵션~

조건은 Run Python Code 내에서 사용할 수 있는 함수로, 특정 정보를 반환합니다.

조건부 설정 가이드~

Python 3 환경에서 이러한 조건부 기능이 실행됩니다. Python 코드 내에서 다음 함수를 사용할 수 있습니다.

### 조건부 함수 사용 예제

다음은 조건부 함수에서 사용할 수 있는 몇 가지 예제입니다. 각 `self.condition("ID")`은 해당 조건의 최신 측정값을 반환하며, 설정된 최대 연령(Max Age) 내에 있는 경우에만 값을 반환합니다.

```python
# 예제 1: 측정값이 None인 경우
# 입력이 작동하지 않을 때 이메일 알림 작업을 실행하는 데 유용합니다.
if self.condition("asdf1234") is None:
    self.run_all_actions()  # 모든 작업 실행

# 예제 2: 두 개의 측정값 조건 테스트
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    # 두 측정값이 모두 None이 아닌 경우
    if measure_1 < 20 and measure_2 > 10:
        self.run_all_actions()  # 모든 작업 실행

# 예제 3: 두 측정값과 측정값 합계 테스트
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    sum_ = measure_1 + measure_2
    if measure_1 > 2 and 10 < measure_2 < 23 and sum_ < 30.5:
        self.run_all_actions()

# 예제 4: 조건 결합
measurement = self.condition("asdf1234")
if measurement is not None and 20 < measurement < 30:  # 조건 결합
    self.run_all_actions()

# 예제 5: 두 측정값 테스트
# Edge Input을 0 또는 1에서 True 또는 False로 변환
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    if bool(measure_1) and measure_2 > 10:
        self.run_all_actions()

# 예제 6: "or" 조건 및 반올림된 측정값 테스트
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    if measure_1 > 20 or int(round(measure_2)) in [20, 21, 22]:
        self.run_all_actions()

# 예제 7: self를 사용하여 여러 실행 간 변수 저장
measurement = self.condition("asdf1234")
if not hasattr(self, "stored_measurement"):  # 변수 초기화
    self.stored_measurement = measurement
if measurement is not None:
    if abs(measurement - self.stored_measurement) > 10:
        self.run_all_actions()  # 차이가 10보다 큰 경우
    self.stored_measurement = measurement  # 측정값 저장

위 예제는 조건부 함수의 기본적인 사용법을 보여줍니다. 필요에 따라 코드를 수정하여 특정 요구 사항에 맞게 조정하세요.

```python
# 예제 1: 측정값이 None인 경우
# 입력이 작동하지 않을 때 이메일 알림 작업을 실행하는 데 유용합니다.
if self.condition("asdf1234") is None:
    self.run_all_actions()  # 모든 작업 실행

# 예제 2: 두 개의 측정값 조건 테스트
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    # 두 측정값이 모두 None이 아닌 경우
    if measure_1 < 20 and measure_2 > 10:
        # measure_1이 20보다 작고 measure_2가 10보다 큰 경우
        self.run_all_actions()  # 모든 작업 실행

# 예제 3: 두 측정값과 측정값 합계 테스트
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    sum_ = measure_1 + measure_2
    if measure_1 > 2 and 10 < measure_2 < 23 and sum_ < 30.5:
        self.run_all_actions()

# 예제 4: 조건 결합
measurement = self.condition("asdf1234")
if measurement is not None and 20 < measurement < 30:  # 조건 결합
    self.run_all_actions()

# 예제 5: 두 측정값 테스트
# Edge Input을 0 또는 1에서 True 또는 False로 변환
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    if bool(measure_1) and measure_2 > 10:
        self.run_all_actions()

# 예제 6: "or" 조건 및 반올림된 측정값 테스트
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    if measure_1 > 20 or int(round(measure_2)) in [20, 21, 22]:
        self.run_all_actions()

# 예제 7: self를 사용하여 여러 실행 간 변수 저장
measurement = self.condition("asdf1234")
if not hasattr(self, "stored_measurement"):  # 변수 초기화
    self.stored_measurement = measurement
if measurement is not None:
    if abs(measurement - self.stored_measurement) > 10:
        self.run_all_actions()  # 차이가 10보다 큰 경우
    self.stored_measurement = measurement  # 측정값 저장

# 예제 1: 지난 30분 동안의 측정값에서 특정 값 찾기 (최대 연령: 1800초)
measurements = self.condition_dict("asdf1234")
if measurements:  # 목록이 비어 있지 않은 경우
    for each_measure in measurements:  # 목록의 각 측정값을 반복
        if each_measure['value'] == 119:
            self.logger.info("119 경고가 타임스탬프 {time}에서 발견되었습니다.".format(
                time=each_measure['time']))
            self.run_all_actions()
            break  # for 루프 종료

고급 조건부 Run Python Code 예제:

이 예제들은 위의 초급 예제를 확장하여 특정 작업을 활성화합니다. 다음 예제에서는 조건부 기능의 Actions 섹션에서 찾을 수 있는 ID를 참조하는 작업을 사용합니다. 두 개의 예제 작업 ID가 사용됩니다: "qwer1234" 및 "uiop5678". 추가로, self.run_all_actions()는 여기서 사용되며, 생성된 순서대로 모든 작업을 실행합니다.

# 예제 1
measurement = self.condition("asdf1234")
if measurement is None:
    self.run_action("qwer1234")
elif measurement > 23:
    self.run_action("uiop5678")
else:
    self.run_all_actions()

# 예제 2: 두 개의 측정값 테스트
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    if measure_1 < 20 and measure_2 > 10:
        self.run_action("qwer1234")
        self.run_action("uiop5678")

# 예제 3: 두 개의 측정값과 측정값 합계 테스트
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    sum_ = measure_1 + measure_2
    if measure_1 > 2 and 10 < measure_2 < 23 and sum_ < 30.5:
        self.run_action("qwer1234")
    else:
        self.run_action("uiop5678")

# 예제 4: 하나의 조건으로 결합
measurement = self.condition("asdf1234")
if measurement is not None and 20 < measurement < 30:
    self.run_action("uiop5678")

# 예제 5: 두 개의 측정값 테스트, Edge 입력을 0/1에서 True/False로 변환
measure_1 = self.condition("asdf1234")
measure_2 = self.condition("hjkl5678")
if None not in [measure_1, measure_2]:
    if bool(measure_1) and measure_2 > 10:
        self.run_all_actions()

# 예제 6: "or" 조건 및 반올림된 측정값 테스트
measure_1 = self.measure("asdf1234")
measure_2 = self.measure("hjkl5678")
if None not in [measure_1, measure_2]:
    if measure_1 > 20 or int(round(measure_2)) in [20, 21, 22]:
        self.run_action("qwer1234")
        if measure_1 > 30:
            self.run_action("uiop5678")

작업이 메시지(E-Mail 또는 Note)를 수신하는 유형인 경우, 이 메시지에 추가 정보를 포함하도록 수정할 수 있습니다. 이를 통해 새로운 정보가 Note, E-Mail 등으로 전달되기 전에 함수에 전달됩니다. 이를 수행하려면 문자열을 변수 self.message에 추가하고, 이를 self.run_action() 또는 self.run_all_actions()의 message 매개변수에 추가하세요. 아래는 몇 가지 예제입니다. = 대신 +=를 사용하여 문자열을 변수 self.message에 추가하는 점에 유의하세요. 이는 기존 값을 덮어쓰지 않고 추가합니다.

# 예제 1
measurement = self.measure("asdf1234")
if measurement is None and measurement > 23:
    self.message += "측정값은 {}".format(measurement)
    self.run_action("uiop5678", message=self.message)

# 예제 2
measure_1 = self.measure("asdf1234")
measure_2 = self.measure("hjkl5678")
if None not in [measure_1, measure_2]:
    if measure_1 < 20 and measure_2 > 10:
        self.message += "측정값 1: {m1}, 측정값 2: {m2}".format(
            m1=measure_1, m2=measure_2)
        self.run_all_actions(message=self.message)

로깅은 self.logger를 사용하여 데몬 로그에 메시지를 기록하는 데도 사용할 수 있습니다. 로깅 수준에는 "info", "warning", "error", "debug"가 포함됩니다. 디버그 로그 라인은 입력의 로깅 수준이 "Debug"로 설정된 경우에만 데몬 로그에 나타납니다.

# 예제 1
measurement = self.measure("asdf1234")
if measurement is None and measurement > 23:
    self.logger.error("경고, 측정값은 {}".format(measurement))
    self.message += "측정값은 {}".format(measurement)
    self.run_action("uiop5678", message=self.message)

조건부를 활성화하기 전에 모든 가능한 시나리오를 철저히 탐색하고 충돌을 제거하는 구성을 계획하는 것이 좋습니다. 일부 장치나 출력은 빠르게 켜고 끄는 경우 비정상적으로 반응하거나 실패할 수 있습니다. 따라서 장치를 출력에 연결하기 전에 구성을 시험 실행해 보세요.

트리거~

트리거 컨트롤러는 출력이 켜지거나 꺼지는 것, GPIO 핀이 전압 상태를 변경하는 것(에지 감지, 상승 또는 하강), 다양한 타이머(지속 시간, 시간 간격, 특정 시간 등)를 포함한 시간 이벤트, 또는 특정 위도와 경도의 일출/일몰 시간과 같은 이벤트가 트리거될 때 작업을 실행합니다. 트리거가 구성되면, 해당 이벤트가 트리거될 때 실행할 작업을 원하는 만큼 추가하세요.

출력 (켜짐/꺼짐) 옵션~

출력 상태를 모니터링합니다.

출력 (PWM) 옵션~

PWM 출력 상태를 모니터링합니다.

에지 옵션~

핀 상태의 상승 및/또는 하강 에지를 모니터링합니다.

PWM 메서드 실행 옵션~

지속 시간 메서드를 선택하면 선택한 PWM 출력에 메서드에서 지정한 듀티 사이클이 설정됩니다.

일출/일몰 옵션~

위도와 경도를 기준으로 일출 또는 일몰(또는 해당 시간의 오프셋) 시 이벤트를 트리거합니다.

타이머 (지속 시간) 옵션~

타이머를 실행하여 설정된 주기마다 조건부 작업을 트리거합니다.

타이머 (일일 특정 시간) 옵션~

매일 특정 시간에 조건부 작업을 트리거하는 타이머를 실행합니다.

타이머 (일일 시간 범위) 옵션~

설정된 시작 시간과 종료 시간 사이에서 특정 주기로 조건부 작업을 트리거하는 타이머를 실행합니다. 예를 들어, 시작 시간을 10:00, 종료 시간을 11:00, 주기를 120초로 설정하면, 10시부터 11시 사이에 120초마다 조건부 작업이 트리거됩니다.

이 기능은 특정 시간 동안 출력이 켜져 있어야 하며, 단순한 특정 시간 타이머가 전원 장애로 인해 사이클이 중단되는 것을 방지하고자 할 때 유용합니다. 예를 들어, 시작 -> 종료 시간 동안 몇 분마다 출력을 켜도록 설정하면, 해당 시간 동안 출력이 유지되도록 보장할 수 있습니다.

Trigger - Sequence~

시퀀스는 여러 개의 출력 장치(밸브·펌프·조명 등)를 정해진 순서와 시간표에 따라 자동으로 켜고 끄는 기능입니다. "밸브 A를 30분 열고, 그다음 밸브 B를 30분 열고…" 처럼 여러 단계로 이어지는 작업을 사람이 일일이 조작하지 않고 반복 실행하도록 자동화할 때 사용합니다. 관수 순환, 다단계 환기(창문 열기 → 대기 → 팬 가동) 등에 특히 유용합니다.

예시로 알아보기: 급수 펌프 + 밸브 3개 순차 관수~

가장 흔한 사용 사례로 살펴보겠습니다. 메인 급수 펌프 1대와, 구역별로 순서대로 물을 주는 밸브 A·B·C가 있다고 가정합니다. 원하는 동작은 다음과 같습니다.

• 펌프는 관수가 진행되는 동안 처음부터 끝까지 계속 켜져 있어야 합니다.
• 밸브 A → B → C 순서로 각각 30분씩 급수한 뒤 자동으로 꺼집니다.

설정 방법:

1. 함수 목록에서 시퀀스를 새로 추가합니다.
2. 동작 추가에서 "출력: 켜기/끄기/지속시간"을 선택하고 메인 펌프의 출력을 골라 추가합니다. 모드는 전체(Total)로 지정합니다 — 이 모드는 "시퀀스가 도는 내내 계속 켜져 있어야 하는 장치"에 씁니다.
3. 밸브 A, B, C를 이 순서로 추가합니다. 각각 모드는 단일(Single), 지속시간은 1800초(30분)로 지정합니다.
4. 저장하면 등록한 순서(위젯에서는 드래그로 재배열 가능)대로 실행됩니다.

시간이 흐르는 모습을 표로 보면 다음과 같습니다.

밸브 C가 꺼지는 순간 펌프도 함께 꺼집니다. 전체(Total) 모드는 이렇게 "다른 단계가 전부 끝날 때까지 켜져 있어야 하는" 장치 한 개(보통 메인 펌프)에 사용하고, 나머지 단계들은 단일(Single) 모드로 순서대로 실행되는 것이 기본 패턴입니다.

예시로 알아보기: 밸브 여러 개를 동시에 열기~

위 예시에서 밸브 B와 C를 순서대로가 아니라 동시에 열고 싶다면 어떻게 할까요? 이럴 때는 두 단계를 장치 그룹으로 묶습니다. 위젯이나 통합 모달에서 밸브 B·C의 그룹 칸에 같은 이름(예: 구역2)을 입력하면, 두 밸브가 하나의 슬롯으로 묶여 같은 시간에 함께 켜지고 꺼집니다.

이렇게 순차 실행(펌프+단일 단계)과 동시 실행(장치 그룹)을 섞어서 쓸 수 있습니다. 그룹으로 묶인 밸브들은 같은 지속시간을 공유하며, 자세한 규칙은 아래 장치 그룹을 참고하세요.

실행 모드: 단일 vs 전체~

• 단일 (Single, 기본값): 각 단계마다 독립적인 실행 시간을 적용합니다.
  • 계산식: 총 활성 시간 = Head Overlap + Base Duration + Tail Overlap
  • 동작: 이전 단계가 끝나기 Overlap 초 전에 다음 단계가 시작되어 부드러운 전환을 지원합니다(예: 밸브를 닫기 몇 초 전에 다음 밸브를 미리 열어 배관 압력이 갑자기 떨어지지 않게 함).
• 전체 (Total, Full-span): 위 펌프 예시처럼, 전체 시퀀스가 실행되는 동안 계속 켜져 있어야 하는 단계에 사용합니다. 시퀀스의 시작부터 마지막 단일 단계가 종료될 때까지 유지됩니다.

그 밖의 주요 개념~

• 동적 기간 (Dynamic Duration): action_duration_id 옵션을 통해 특정 입력(Input)의 측정값을 실행 시간으로 사용할 수 있습니다.
  • 형식: Input_UUID 또는 Input_UUID,Measurement_UUID.
  • 유효성: time_offset_minutes 내의 최신 측정값만 사용하며, 없을 경우 설정된 기본 action_duration을 사용합니다.
• 오버랩 (Overlaps): output_duration 설정값을 사용하여 단계 사이의 전환 시간을 결정합니다. 첫 번째 액션은 Tail Overlap만, 중간 액션은 Head & Tail Overlap을, 마지막 액션은 Head Overlap만 가집니다.
• 제약 사항 (Window & Latency):
  • Execution Window: timer_start_time ~ timer_end_time 사이에만 시퀀스가 시작되거나 실행됩니다. 범위를 벗어나면 강제 종료됩니다.
  • Start Latency: 트리거(활성화) 발생 후 실제 시퀀스 시작까지의 대기 시간(timer_start_offset)을 초 단위로 설정합니다.

설정 옵션 명세~

장치 그룹 (동시 작동)~

앞의 예시에서 본 것처럼, 여러 단계를 하나의 장치 그룹으로 묶으면 순차 실행이 아니라 같은 시간 창에서 동시에 켜지고 꺼집니다. 상세 규칙은 다음과 같습니다.

• 묶는 방법: 위젯 또는 통합 모달에서 단계 이름을 클릭 → 그룹 칸에 같은 그룹 이름을 입력합니다. 같은 이름을 가진 단계들이 하나의 슬롯으로 접혀 표시됩니다. 그룹 칸을 비우면 해당 단계가 그룹에서 빠져 단독 작동으로 돌아갑니다.
• 공통 기간 (리더 상속): 그룹은 하나의 공통 작동 시간을 공유합니다. 어떤 단계가 기존 그룹에 합류하면 그 그룹의 공통 action_duration(및 동적 기간 리더 action_duration_id)을 자동으로 상속합니다. 슬롯의 대표(가장 앞선 위치의 멤버)가 그룹 전체의 기간·동적 리더를 결정합니다.
• 실행 순서: 슬롯 순서는 각 그룹이 처음 등장한 위치를 따릅니다. 이미 존재하는 그룹의 뒤쪽 멤버는 앞선 슬롯으로 folding(접힘)되어 새 슬롯을 만들지 않습니다.
• 제약: total(Full-span) 모드 단계는 그룹으로 묶을 수 없습니다. 그룹은 본질적으로 single(동시-단일) 모드입니다.

요일별 스케줄 (Weekly Schedule)~

기존의 단일 시작·종료 시간 대신, 요일마다 다른 작동 시간·주기를 설정할 수 있습니다. 스케줄은 Trigger.timer_schedule에 JSON으로 저장되며 두 가지 모드를 지원합니다.

• shared (공유 모드): 모든 요일이 하나의 시작·종료·주기를 공유합니다. 활성 요일만 선택합니다(기존 방식과 동일).
• per_day (요일별 모드): 월~일 각 요일이 독립적인 시작(start)·종료(end)·주기(period)와 활성 여부(enabled)를 가집니다. 나아가 요일별로 다음을 개별 오버라이드할 수 있습니다.
  • actions: 요일별 단계 활성/비활성 (전역 enabled 플래그를 덮어씀).
  • groups: 요일별 장치 그룹 소속 (전역 group_name을 덮어씀). 빈 문자열은 "그 요일에는 그룹에서 제외"를 의미합니다.
  • durations: 요일별 작동 시간 (전역 action_duration을 덮어씀).

시간 규칙:

• 요일 인덱스는 Python 관례를 따릅니다: 0=월, 1=화, … 6=일.
• 시간은 장치 로컬 타임존의 벽시계 HH:MM 형식입니다.
• 종료 시간 24:00은 "하루의 끝"을 의미하며 내부적으로 1440분으로 저장됩니다.
• 자정을 넘기는 창(start >= end)은 허용되지 않습니다. 각 요일은 00:00~24:00 범위 안에서만 작동합니다.
• 자정 연속성: 앞 요일의 종료가 24:00이고 다음 요일의 시작이 00:00이며 두 요일이 모두 활성이고 인접해 있으면, 데몬은 자정에 사이클을 리셋하지 않고 연속으로 이어서 실행합니다.

통합 모달 · 시간휠~

시퀀스 위젯의 단계 목록에서 시간·그룹·이름·요일 스케줄을 하나의 통합 모달에서 편집합니다.

• 단계 이름을 클릭하면 표시 이름(display_name)·모드(single/total)·장치 그룹을 함께 수정하는 모달이 열립니다.
• 시작·종료 시간은 시간휠(time wheel) 컴포넌트로 입력하여 모바일에서도 정확하게 시:분을 선택할 수 있습니다.
• 레거시 시작·종료·요일 컬럼은 스케줄 저장 시 자동으로 동기화되어(하위 호환), 스케줄을 사용하지 않는 구형 뷰에서도 대표 값이 유지됩니다.