Довідник команд програмування Apex

Ця стаття є довідником по всім командам програмування Neptune Apex. Вся ця інформація є загальнодоступною, але розкидана по декількох документах Нептуна і повідомленнях на форумах спільноти Нептуна. Моя мета – звести всю цю інформацію в єдиний довідковий документ.

Умовні позначення в документації Перед тим, як представити список команд, наведемо огляд умовних позначень параметрів:

Назви входів, виходів та профілів виділено жирним курсивом.

Examples: If Temp > 80 Then OFF If Flow1 < 100 Then OFF If pH > 6.80 Then ON If Output Return_Pump = OFF Then OFF If FeedA 000 Then Slow_Mode

Різні параметри перераховані в квадратних дужках, розділених косою рискою: [ON/OFF/Profile_Name/%].

Приклади: If Time 08:00 To 10:00 Then [ON/OFF/Profile_Name/%] включає наступні можливі варіанти використання:

If Time 08:00 To 10:00 Then ON (вмикає вихід) If Time 08:00 To 10:00 Then OFF (вимикає вихід) If Time 08:00 To 10:00 Then Morning_Mode (встановлює вихід на використання профілю Morning_Mode) If Time 08:00 To 10:00 Then 25 (встановлює вихід на 25%)

Примітка: Профілі можна використовувати тільки на певних типах виходів. Наприклад, профіль Pump працює тільки на змінних виходах 0-10В, профілі DOS працюють тільки на виходах DOS, профілі Radion працюють тільки на виходах Radion і т.д.

Примітка: Тільки певні типи виходів підтримують відсотки. Для отримання додаткової інформації див. цей список поширених запитань Neptune: https://forum.neptunesystems.com/showthread.php?20677-Using-percentages-in-programming

Operators are also listed in square brackets, separated by a slash: [>/

If Temp > 80.0 Then OFF Якщо Temp < 76.0 Then ON

### представляє числове значення, яке може включати або не включати десяткову крапку.

Час вказується в годинах, хвилинах і секундах, представлених H, M і S відповідно. Деякі команди використовують години і хвилини, деякі – тільки хвилини, а інші – хвилини і секунди.

Якщо Час ЧЧ:ММ До ЧЧ:ММ Тоді [ON/OFF/Ім’я_профілю/%] OSC MMM:SS/MMM:SS/MMM:SS Тоді [ON/OFF/Ім’я_профілю/%] Defer MMM:SS Тоді [ON/OFF]

Довідник команд програмування Apex

Команда Set використовується для безумовного встановлення вихідного стану і зазвичай використовується як перша команда в програмі для встановлення стану за замовчуванням перед застосуванням різних умов, які можуть змінити цей початковий стан.

Якщо Час ЧЧ:ММ До ЧЧ:ММ Тоді [Увімкнено/Вимкнено/Ім’я_профілю/%]

Якщо Time використовується для встановлення стану виходу між набором фіксованих часів, включаючи час початку та закінчення.

Приклад: Set OFF If Time 10:00 to 10:01 Then ON

увімкне вихід о 10:00 і вимкне його о 10:02:

If DOW [SMTWTFS] Then [ON/OFF/Profile_Name] (Якщо DOW [SMTWTFS])

Команда DOW використовується для встановлення стану виходу на основі дня тижня. Кожен день представлений буквеним заповнювачем, починаючи з неділі і закінчуючи суботою. Якщо вказано літеру, команда буде оцінювати значення True для цього дня. Якщо замість дня стоїть тире, команда буде оцінювати значення False для цього дня.

Приклад: If DOW SMT-TFS Then ON

Ця команда увімкне вихідний сигнал у кожен день тижня, крім середи, оскільки замість дня середи вказано тире.

Ця команда використовується для вимірювання показань датчика, включаючи температуру, pH, ОВП, солоність, розчинений кисень, датчик потоку, датчик PAR, лужність Trident, кальцій Trident або магній Trident.

Якщо Output Output_Name = [ON/OFF] Then [ON/OFF/Profile_Name/%] [ON/OFF/Profile_Name/%] (Назва_виходу Output_Name = [ON/OFF])

Ця команда використовується для реагування на поточний стан виходу, фізичного або віртуального.

Ця команда використовується для реагування на поточний відсоток або швидкість виходу, наприклад, насоса COR, виходу WAV або VarSpd. Для отримання додаткової інформації див. цей розділ поширених запитань Neptune: https://forum.neptunesystems.com/showthread.php?20677-Using-percentages-in-programming

If Switch_Name [OPEN/CLOSED] Then [ON/OFF/Profile_Name/%] (Ім’я_перемикача [ВІДКРИТО/ЗАКРИТО])

Ця команда використовується для реагування на оптичний датчик, датчик витоку або перемикач, підключений до порту Breakout Box.

Якщо [FeedA/FeedB/FeedC/FeedD] MMM, тоді [ON/OFF/Profile_Name/%].

Ця команда встановлює стан виходу, коли активується цикл подачі. Затримка MMM подовжує стан виходу на кілька хвилин понад встановлений час вибраного циклу подачі.

Ця команда використовується для встановлення стану виходу на основі регіональної температури, визначеної в сезонних таблицях Apex.

Для отримання більш детальної інформації про регіональні температури див. сторінку 65 Комплексного довідника Apex: .

If Sun [+/-] [MMM] / [+/-] [MMM] Then [ON/OFF/Profile_Name/%]

Ця команда використовується для встановлення стану виходу на основі циклів сходу або заходу сонця, визначених у сезонних таблицях Apex. Перший таймер – відносно сходу сонця, а другий таймер – відносно заходу сонця. Додатне число відкладає дію на час після події, а від’ємне число передує події.

Для більш детальної інформації про If Sun див. сторінку 66 Комплексного довідника Apex:

If Moon [+/-] [MMM] / [+/-] [MMM] Then [ON/OFF/Profile_Name/%]

Ця команда використовується для встановлення стану виходу на основі циклів сходу або заходу Місяця, визначених у сезонних таблицях Apex. Перший таймер відносно сходу місяця, а другий таймер відносно заходу місяця. Додатне число відкладає дію на час після події, а від’ємне число передує події.

Більш детальну інформацію про If Moon можна знайти на сторінці 67 Комплексного довідника Apex: . Приклад використання If Moon можна знайти в моєму підручнику з Apex Lunar Schedule and Lighting Profiles: . sion-lunar-schedule-and-lighting-profiles.717.

Ця команда використовується для реагування на потужність в Амперах або Ватах, що споживається на даний момент виходом EB832. Це не стосується старих виходів EB4, EB6, EB8 або додаткових виходів DC24 EB832.

Якщо Power [Power Probe] [ON/OFF] [###] Тоді [ON/OFF/Profile_Name] [ON/OFF/Profile_Name] [ON/OFF/Profile_Name] [ON/OFF/Profile_Name].

Ця команда використовується для встановлення стану виходу на основі виявлення збою живлення. [Power Probe] – це або вершина, або ім’я приєднаної енергетичної панелі. Зверніть увагу, що команда If Power не підтримує використання відсотків, як описано в цьому розділі поширених запитань Neptune: https://forum.neptunesystems.com/showthread.php?20677-Using-percentages-in-programming.

Для отримання більш детальної інформації про If Power та інструкцій щодо інтеграції Apex з резервною батареєю ДБЖ див. мій підручник з моніторингу живлення Apex: .

OSC MMM:SS/MMM:SS/MMM:SS Потім [ON/OFF] (Увімкнути/вимкнути)

• Початкова затримка в хвилинах і секундах
• хвилини та секунди фактичного часу роботи
• хвилини та секунди подальшої затримки

Це ввімкне вихід опівночі на 5 хвилин, потім вимкне його на 5 хвилин і повториться до нескінченності:

Відкласти МММ:СС Потім [Увімкнути/вимкнути]

Затримує перемикання виходу з увімкненого стану на вимкнений або з вимкненого стану на увімкнений. Ця команда застосовується до виходу після оцінки всіх умов. Для виходу можна використовувати тільки одну команду затримки увімкнення та одну команду затримки вимкнення. Коли вихід змінює стан з увімкненого на вимкнений, застосовується тільки таймер відстрочки вимкнення. Коли вихід змінює стан з вимкненого на увімкнений, застосовується тільки таймер відстрочки увімкнення.

Встановити Вимкнути Якщо час з 10:00 до 10:01 Тоді Увімкнути Відкласти 001:00 Тоді Увімкнути

Це призведе до того, що він буде чекати до 10:01, щоб увімкнутися, а потім вимкнеться о 10:02, фактично даючи вам таймер на 1 хвилину:

Min Time MMM:SS Потім [ON/OFF]

Min Time змушує вихід залишатися увімкненим або вимкненим протягом мінімального часу, незалежно від умов, визначених у програмі. Якщо вихід увімкнений, застосовується тільки таймер Min Time Then ON. Якщо вихід вимкнений, застосовується тільки таймер Min Time Then OFF.

When [ON/OFF] > MMM:SS Then [ON/OFF] (МММ:СС Потім [ВКЛ/ВЫКЛ])

Коли використовується для перемикання плитки виходу з AUTO на OFF або ON, якщо виконується умова. Це єдина команда в мові програмування Apex, яка може фізично перемістити положення повзунка плитки виходу на приладовій панелі, і після переміщення потрібне ручне втручання, щоб встановити його назад в положення AUTO, перш ніж програмування буде відновлено.

If Error Output_Name Then [ON/OFF] (Якщо помилка Назва_виходу Тоді [ON/OFF])

Команда If Error буде оцінювати значення True, якщо буде перевищено описаний вище таймер When. Для більш детальної інформації про If Error див. https://forum.neptunesystems.com/showthread.php?18393-Using-the-%91When%92-statement

If Error Apex Then [ON/OFF]

Команда If Error Apex буде оцінювати True, якщо модуль від’єднано від Apex. Ця функція була вперше представлена в AOS 5.06_5C21 і доступна тільки в Apex 2016 і Apex-EL. Вона особливо корисна для додавання в програму EmailAlm для відправки оповіщення, якщо модуль відсутній, але також може бути використана в програмуванні на будь-якому виході. Детальніше про If Error Apex дивіться на сайті https://forum.neptunesystems.com/showthread.php?31358-AOS-5-06_5C21-has-been-released!

Fallback [ON/OFF/Profile_Name/%] (Резервний варіант [ON/OFF/Profile_Name/%])

Fallback використовується для встановлення стану виходу в модулі AquaBus, коли цей модуль втрачає зв’язок з Apex.

Source: www.reef2reef.com