Учебный путь

Страница собирает страницы базы знаний в один маршрут: от первого проекта до Скриптера. Девять шагов идут по порядку, каждый опирается на предыдущие. После них — справочники, в которые заглядывают по мере надобности.

Путь рассчитан на интегратора, который собирает управление залом: рисует интерфейс, пишет программу и подключает устройства. Если вам нужно только одно, возьмите короткий путь:

• мне только загрузить готовый проект;

• мне только написать драйвер.

Как устроена система в целом — на странице «Как устроена система». Незнакомое слово — в «Словаре терминов».

Все шаги

Шаг	Что вы будете делать	Главная страница
1	Загрузить учебный проект и нажать кнопку на панели	«Первый проект по шагам»
2	Нарисовать свой интерфейс	«Первый интерфейс»
3	Собрать первую программу	«Первая программа по шагам»
4	Принимать события с панели	«Приём событий»
5	Менять вид на панели	«Изменение вида на панели»
6	Подключить устройство, отправить команду, принять ответ, сделать переключатели и группы	«Узлы Dynamic Driver»
7	Разобрать большой пример	«Программа «Демо-зал»: обзор»
8	Написать драйвер	«Как написать драйвер»
9	Писать логику кодом	«Скриптер: логика кодом»

Шаги 1–3 нужны всем. Шаг 8 нужен, только если для вашего устройства нет готового драйвера. Шаг 9 нужен тем, кто умеет программировать: логику можно собрать и цепочкой узлов.

Шаг 1. Первый проект

Вы научитесь:

• загружать на контроллер интерфейсы и программу учебного проекта;

• открывать интерфейс на панели, нажимать кнопку и видеть, как ответила программа;

• отличать две части проекта: интерфейс (то, что видит оператор) и программа (то, что происходит по нажатию).

Страницы:

• «Первый проект по шагам»;

• «Проекты: загрузить и скачать» — подробно о загрузке и о копии перед ней.

Что нужно уметь до этого шага: контроллер включён, компьютер видит его по сети, страница настроек открывается. Если нет — «Начало работы». Оборудование зала не нужно.

Шаг 2. Свой интерфейс

Вы научитесь:

• создавать в UI-Designer (редактор интерфейсов) интерфейс и страницу, рисовать фон и подпись;

• делать область, в которой меняется содержимое (фрейм и оверлеи), и кнопки-вкладки;

• сохранять и публиковать интерфейс, видеть его на панели;

• давать элементам имена, по которым их найдёт программа;

• настраивать кнопки: состояния, переключатель, группа «выбирается одна» (Interlock);

• делать всплывающее окно подтверждения.

Страницы по порядку:

1. «UI-Designer» — окно редактора, как включить и открыть его.

2. «Первый интерфейс» — интерфейс от пустой страницы до панели.

3. «Кнопки и состояния».

4. «Фрейм и Pop Up».

Что нужно уметь до этого шага: выполнен шаг 1 или хотя бы открывается страница настроек. UI-Designer по умолчанию выключен: его включают на странице настроек (см. «Доступ к интерфейсам»).

Шаг 3. Первая программа

Вы научитесь проходить на маленьком примере весь путь: нажали кнопку, программа отправила команду устройству, устройство ответило, на панели поменялись подпись и подсветка. Из этих же приёмов состоит любая программа для панели.

Страницы по порядку:

1. «Связь интерфейса с программой» — общая схема и порядок раздела.

2. «Первая программа по шагам» — блоки программы «Первая программа».

Что нужно уметь до этого шага:

• делать кнопки и давать элементам имена (шаг 2: «Кнопки и состояния»);

• подключить U-Logic к панели узлом UI - Panel in (шаг 2: «Первый интерфейс»);

• загрузить интерфейс «Первая программа» (шаг 1);

• знать, какие бывают элементы и как работает поле ввода («Справочник элементов», «Клавиатура и поле ввода»).

Устройства для этого шага нужны, чтобы изменились подписи и подсветка. Без них события панели всё равно приходят в программу, и их видно в отладке.

Шаг 4. Приём событий

Вы научитесь принимать события с панели узлом UI - Panel in и раскладывать их по выходам узлом ui - switch: правило для одного элемента, правило для группы, выбор события, несколько выходов, порядок правил.

Страница: «Приём событий».

Что нужно уметь до этого шага: пройден шаг 3; интерфейс сохранён и опубликован в UI-Designer; на вкладке (рабочем листе программы) развёрнут UI - Panel in.

Шаг 5. Вид на панели

Вы научитесь по ответу устройства менять на панели кнопку, ползунок, надпись, цвет, список и открывать другую страницу (узел api - helper - 2).

Страница: «Изменение вида на панели».

Что нужно уметь до этого шага:

• шаги 3 и 4: ui - switch, change, device - response - listener;

• интерфейс опубликован, на вкладке развёрнут UI - Panel out.

Шаг 6. Подключить устройство, отправить команду, принять ответ

Вы научитесь:

• создавать подключение к устройству (драйвер плюс транспорт) и отправлять через него команду узлом device - command;

• принимать ответ узлом device - response - listener и видеть его в отладке;

• связывать команду и ответ с нажатием на панели;

• проверять связь с устройством до написания драйвера;

• делать переключатель «включено / выключено» и группу кнопок «выбирается одна».

Страницы по порядку:

1. «Dynamic Driver: драйверы устройств» — что такое драйвер, подключение и транспорт.

2. «Узлы Dynamic Driver», раздел «По шагам»; проверка связи — раздел «Тестовые узлы».

3. «Команды устройствам и ответы».

4. «Переключатели и группы».

5. «Редактор драйверов» — если нужного драйвера нет в списке.

Что нужно уметь до этого шага:

• принять событие с панели и разложить его по выходам ui - switch (шаг 4);

• иметь драйвер устройства (готовый или добавленный в редакторе драйверов), адрес и порт устройства;

• для страницы «Переключатели и группы» — как устроены переключатели и группы Interlock в UI-Designer («Кнопки и состояния»).

Шаг 7. Большой пример

Вы научитесь загружать большую программу «Демо-зал» и проходить по её блокам: что делает каждый и где про него читать подробно. В ней все приёмы шагов 3–6 работают вместе.

Страницы:

• «Программа «Демо-зал»: обзор»;

• «Проект или flow.json» — если нужно добавить программу в уже работающую.

Что нужно уметь до этого шага: пройти шаг 3 («Первая программа»). Интерфейсы «Демо-зал» и «Рецепты» загружаются раньше программы (порядок — в «Проекты: загрузить и скачать»).

Шаг 8. Свой драйвер

Вы научитесь писать драйвер для устройства, у которого его нет: команды, разбор ответов, вход на устройство, HTTP, несколько устройств на одном подключении. Если программировать не хотите, набросок кода сделает ИИ по описанию протокола.

Страницы по порядку:

1. «Драйвер с помощью ИИ» — набросок по документации протокола; можно пропустить, если пишете сами.

2. «Как написать драйвер» — из чего состоит драйвер, команды.

3. «Ответы устройства» — как разобрать то, что прислало устройство.

4. «Расширенные возможности» — читайте то, что нужно вашему драйверу.

5. «Примеры драйверов» — драйвер, который можно проверить без оборудования.

Что нужно уметь до этого шага:

• подключать устройство и отправлять ему команду (шаг 6);

• знать JavaScript (для набросков от ИИ это не обязательно) и иметь описание протокола устройства: команды, формат, ответы.

Шаг 9. Скриптер

Вы научитесь описывать логику кодом на JavaScript: реагировать на нажатия на панели, отправлять команды устройствам, обновлять надписи и кнопки. Редактор Скриптера нужен, когда кода много: в нём есть подсказки по именам из вашей программы и диагностика рядом с кодом.

Страницы по порядку:

1. «Скриптер: логика кодом».

2. «Редактор Скриптера».

Что нужно уметь до этого шага:

• собирать программу цепочкой узлов (шаги 3–7): начинающим проще цепочка, а к Скриптеру переходят, когда цепочки становятся громоздкими;

• использовать драйверы устройств (шаг 6): Скриптер отправляет команды существующих драйверов и не заменяет драйвер;

• для редактора — основы Скриптера (ctrl, три фазы, подписки) из первой страницы.

Справочники

К этим страницам возвращаются, когда нужна конкретная настройка.

Что нужно найти	Страница
Узлы U-Logic: что делает каждый, поля окна	«Узлы U-Logic»
Общие сведения о U-Logic: терминология, горячие клавиши	«U-Logic»
Переменные Node, Flow, Global	«Понимание переменных»
Какой элемент интерфейса выбрать и какие у него свойства	«Справочник элементов»
Оформление интерфейса, сложная графика	«Оформление интерфейса», «Сложная графика: рецепты»
Поле ввода и экранная клавиатура	«Клавиатура и поле ввода»
Видео с камеры в интерфейсе	«Просмотр RTSP-потока в интерфейсе»
Горячие клавиши UI-Designer	«Горячие клавиши»
Как открыть и использовать UI-Panel	«UI-Panel»
Доступ к интерфейсам, пропуска, пароль	«Доступ к интерфейсам»
Режим HTTPS	«Режим HTTPS»
Сетевые порты	«Сетевые порты и протоколы»
HTTP API страницы настроек	«HTTP API страницы настроек»
Сброс контроллера и панели	«Сброс настроек»
Вопросы и поддержка	«Часто задаваемые вопросы»
Что-то не работает	«Не работает: где смотреть»
Имена элементов, раскладка программы по блокам	«Соглашения»

Короткий путь: мне только загрузить готовый проект

Проект на контроллере состоит из двух архивов: интерфейсы и программа. Загружайте сначала интерфейсы, потом программу.

1. Откройте страницу настроек («Начало работы»).

2. Скачайте копию своего проекта: загрузка заменяет проект целиком.

3. Загрузите интерфейсы: «Загрузить проект интерфейсов».

4. Загрузите программу: «Загрузить проект программы».

5. Впишите адреса и пароли устройств в подключениях и нажмите «Развернуть».

Всё о загрузке — в «Проекты: загрузить и скачать». Если загрузили, а не работает, смотрите раздел «Частые ошибки» той же страницы. Пример загрузки с проверкой на панели — «Первый проект по шагам».

Короткий путь: мне только написать драйвер

Что нужно уметь до этого пути: знать JavaScript, иметь описание протокола устройства и доступ к U-Logic. Как подключить устройство и отправить ему команду — раздел «По шагам».

1. Прочитайте раздел «Как это устроено» страницы «Dynamic Driver»: драйвер, подключение, транспорт.

2. Откройте редактор и создайте драйвер: «Редактор драйверов».

3. Опишите команды: «Как написать драйвер». Набросок можно получить от ИИ: «Драйвер с помощью ИИ».

4. Разберите ответы: «Ответы устройства».

5. Проверьте связь и команду узлами «Тестовые узлы» и цепочкой из раздела «По шагам». Драйвер, который проверяется без оборудования, — в «Примерах драйверов».

6. Если устройство требует вход, работает по HTTP или нужен периодический опрос — «Расширенные возможности».