safety-interlocks

Skill implementuje mechanizmy ochronne (safety interlocks) dla systemów sterowania. Zapobiega przekroczeniu bezpiecznych limitów operacyjnych i nasyceniu wyjść sterujących. Zawiera gotowy wzorzec integracji z pętlą sterowania, który najpierw sprawdza warunki bezpieczeństwa, a dopiero potem stosuje komendy. Idealny dla aplikacji HVAC, przemysłowych i robotycznych, gdzie bezpieczeństwo sprzętu jest krytyczne.

1. Zainstaluj skill z repozytorium benchflow-ai. Skill zawiera funkcję apply_safety_limits() — punkt wejścia do implementacji ochrony.

2. Zdefiniuj parametry bezpieczeństwa dla Twojego systemu: maksymalny i minimalny limit pomiaru (np. temperatura, ciśnienie), oraz maksymalny i minimalny zakres wyjścia sterującego (np. 0–100%).

3. Przed każdym zastosowaniem komendy sterowania, przekaż bieżący pomiar czujnika, żądaną komendę oraz zdefiniowane limity do funkcji apply_safety_limits(). Funkcja zwraca bezpieczną komendę i flagę sygnalizującą aktywację zabezpieczenia.

4. Zintegruj skill z pętlą sterowania, tworząc instancję klasy SafeController. Przekaż jej kontroler (np. PID), maksymalny limit i zakresy wyjścia. Klasa automatycznie rejestruje zdarzenia bezpieczeństwa w liście safety_events.

5. W każdej iteracji pętli sterowania wywołaj metodę compute() klasy SafeController, podając pomiar i przyrost czasu (dt). Skill najpierw sprawdzi warunki bezpieczeństwa — jeśli pomiar osiągnie limit, wyzwoli natychmiastowe wyłączenie (emergency cutoff).

6. Monitoruj listę safety_events, aby śledzić aktywacje zabezpieczeń i dostosować parametry systemu w razie potrzeby.