Индикатор уровня¶

Задачей сервиса является расчет индикаторов уровня для последующей рассылки значений индикатора серверам системы Caps-Сlock для отображения. Каждый сервер системы Caps-Clock затем отправляет на соответствующие часовые машины команды отображения информации в зависимости от конфигурации каждой часовой машины.

Ручная установка/удаление сервиса¶

Для установки сервиса, необходимо запустить исполняемый файл level_ctrl_service.exe из директории, в которую был скопирован сервис, в командной строке, с параметром install:
_ level_ctrl_service.exe –install _
Для удаления сервиса, необходимо запустить исполняемый файл level_ctrl_service.exe из директории, в которую был скопирован сервис, в командной строке, с параметром uninstall:
_ level_ctrl_service.exe –uninstall _

Конфигурирование сервиса¶

Для конфигурации сервиса, необходимо запустить исполняемый файл level_ctrl_service.exe из директории, в которую был установлен сервис. Исполняемый файл для конфигурации можно запустить как приложение, набрав в командной строке *level_ctrl_service.exe –app*, или как сервис – запуск без параметров (_level_ctrl_service.exe_).

Запуск сервиса как приложение:

{{Image("app.JPG","nolink")}}

, как сервис:

{{Image("service.JPG","nolink")}}

В любом из этих случаев, для конфигурации нажимаем на кнопку Config или _Configure_.

Если данный сервис уже запущен, параметры можно изменить через кнопку Config контекстного меню, если кликнуть правой кнопкой мыши по иконке {{Image("tray_icon.JPG","nolink")}} в System Tray.
В появившемся окне выводится список доступных индикаторов.
{{Image("indicators_list.JPG","nolink")}}
(Список используемых индикаторов)

В списке индикаторов присутствуют 3 поля:

1. название – название индикатора уровня;
2. источник сигнала – название устройства источника сигнала;
3. состояние индикатора – включен/выключен.

Добавление/редактирование индикатора¶

Для того, чтобы создать новый индикатор нужно нажать на кнопку _Добавить_.

Для редактирования индикатора нужно выбрать требуемый индикатор в списке индикаторов уровней, и нажать на кнопку _Редактировать_.

В появившемся диалоговом окне нужно настроить параметры создаваемого индикатора.

{{Image("add_indicator.JPG","nolink")}}
(Параметры индикатора)

Название – название индикатора уровня.

Источник– источник аудио данных, сигнал, с которого будет обрабатывать индикатор уровня и отправлять на Caps-Clock сервер.

Тип индикатора – псевдопиковый и квазипиковый индикаторы. Индикатор уровня будет рассчитываться согласно выбранному типу.

Канал - моно/стерео.

Сдвиг уровня – величина, позволяет учесть несогласованность уровней аудио карт, коррекцию уровня и пр. Она м.б. положительная или отрицательная и задается в децибелах.

Доступные серверы - Caps-Clock серверы, доступные для графического представления расчетных данных отправляемых индикатором уровня. Для того, чтобы расчетные данные отправлялись на необходимый часовой сервер, его (часовой сервер) нужно указать в списке серверов, отметив нужный сервер галочкой. Если выбрать несколько серверов, то расчетные данные будут отправляться на все выбранные часовые серверы.

Состояние – включен/выключен. Для того чтобы расчетные данные отправлялись на часовые серверы, необходимо включить индикатор.

Кнопка {{Image("audio_source_btn1.JPG","nolink")}} открывает диалоговое окно настройки Источников данных.

При нажатии на кнопку _Применить_, индикатор будет создан, и появится в списке индикаторов уровня.
Нажатие на кнопку Отмена закроет диалог настройки индикатора, при этом данные сохранены не будут.

Удаление индикатора¶

Для удаления индикатора нужно выбрать требуемый индикатор в списке индикаторов уровней, и нажать на кнопку _Удалить_.

Редактирование источников¶

Для редактирования параметров источников данных, нужно нажать на кнопку _Источники_.
В появившемся диалоговом окне, нужно выбрать требуемый источник данных. После выбора источника, поля – Частота дискретизации, количество блоков и размер блока заполняются автоматически. Если требуется, эти параметры так же можно изменить в ручную.

При изменении частоты дискретизации, параметр – размер блока, изменяется автоматически, поэтому если требуется установить другое значение, сначала нужно выбрать требуемую частоту дискретизации.

При изменении размера блока, в поле - размер блока в секундах, будет выводиться значение, соответствующее длительности размера блока в секундах. Это поле доступно только для чтения.

В поле – Название, можно указать синоним для названия источника данных. При этом, в списке - источник,_ _диалога – Свойства индикатора, будет выводиться не название источника данных, а его синоним.

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

{{Image("sources1.JPG","nolink")}}
(Источники данных)

{{Image("sources2.JPG","nolink")}}
(Диалоговое окно с выбранным источником данных)

Настроенные параметры автоматически сохраняются при нажатии на кнопку _Выход_, или при изменении Источника данных в списке источников.

Работа с использованием Caps-Clock серверов
h3. Добавление/Редактирование Caps-Clock серверов

Для редактирования Caps-Clock серверов нужно нажать на кнопку – _Серверы_.

В появившемся диалоговом окне представлен список доступных серверов.В списке часовых серверов присутствуют 4 поля:

1. Название – название часового (Caps-Clock) сервера.
2. IP – IP адрес Caps-Clock сервера.
3. Макрос – Название макроса, расположенного на Caps-Clock сервере и обрабатывающего данные, поступающие от Индикатора уровня.
_4. Статус соединение – статус соединения с Caps-Clock серверов, имеет значения: Установлено_/_Разорвано._’

{{Image("servers_list.JPG","nolink")}}
(Список доступных серверов)

Для подключения к Caps-Clock серверу нужно создать с ним соединение, для этого необходимо указать требуемые параметры.
Если требуемого сервера не существует – нужно нажать на кнопку – _Добавить_.
Для редактирования сервера нужно выбрать требуемый сервер в списке доступных серверов, и нажать на кнопку _Редактировать_.

В появившемся диалоговом окне, настроить требуемые параметры.

{{Image("add_server.JPG","nolink")}}
(Диалог настройки параметров подключения к Caps-Clock серверу)

Требуется заполнить следующие поля:

1. название – произвольная строка, название Caps-Clock сервера;
2. IP – ip адрес Caps-Clock сервера;
3. порт – порт Caps-Clock сервера;
4. макрос - имя макроса, обработчика на сервере.

Поле _Порт _расположенное внизу диалога, не требуется для обязательного заполнения, а нужно лишь для проверки связи с Caps-Clock сервером.
Заполнив это поле, нужно нажать на кнопку Проверка связи; если соединение произошло успешно, появится сообщение:

{{Image("msg1.JPG","nolink")}}

, иначе появится сообщение с ошибкой.

Один Caps-Clock сервер может содержать несколько макросов, поэтому разрешается добавлять несколько одинаковых серверов с различными именами макросов.

Удаление Caps-Clock сервера¶

Для удаления сервера нужно выбрать требуемый сервер в списке доступных серверов, и нажать на кнопку _Удалить_.

Работа с использованием Джинн¶

Для отображения расчетных значений индикатора уровня можно использовать Джинн (версии не меньше 2.15).

Настройка взаимодействия¶

1. Необходимо иметь в наличии соответствующую конфигурацию Джинн или выполнить настройку конфигурации вручную.
Настройка конфигурации вручную выглядит следующим образом:

В корневом каталоге Джина в подкаталоге SYSTEM нужно выбрать необходимом vid файл. Открыть этот файл для редактирования и добавить
скрипт для создания и расположения индикатора в нужной закладке как показано ниже.

CREATE_OBJ_LVL_IND OBJID_LVL_IND

SET_VIEW_TAB_OBJ VIEW_T1 OBJID_LVL_IND Indicator

INIT_EVENT_SERVER djin.xml

Скрипт CREATE_OBJ_LVL_IND создает индикатор OBJID_LVL_IND.

Скрипт SET_VIEW_TAB_OBJ добавляет индикатор OBJID_LVL_IND на закладку VIEW_T1 с названием Indicator.

Скрипт INIT_EVENT_SERVER инициализирует работу индикатора с событиями приходящими от удаленного приложения, которым является сервис индикатора уровня.
В файле djin.xml описывается взаимодействие с сервисом индикатора уровня. Данный файл так же должен находится в каталоге SYSTEM.

2. Настроить конфигурационный файл djin.xml для взаимодействия с сервисом индикатора уровня. Данный файл в минимальном наборе должен содержать следующие тэги:

, где атрибуты:

HOST - название запущенной копии Джина, которая будет принимать сообщения от сервиса индикатора уровня;

TYPE - клиент(CLIENT);

IP - ip адрес компьютера, где запущена копия приложения - сервиса индикатора уровня;
PORT - порт на компьютере с адресом IP, через который будет осуществляться взаимодействие.

3. Настроить конфигурационный файл level_ctrl_service.xml для взаимодействия с Джин-ом. Данный файл так же должен находится в каталоге SYSTEM. Данный файл в минимальном наборе должен содержать следующие тэги:

, где атрибуты:

HOST - название запущенной копии сервиса - индикатор уровня, которая будет взаимодействовать с Джином;

TYPE - сервер (SERVER);

IP - ip адрес компьютера, где запущена копия приложения - Джина;
PORT - порт на компьютере с адресом IP, через который будет осуществляться взаимодействие с Джином.

4. Запустить сервис - индикатор уровня. Настроить его в соответствии с данным описанием без использования Caps-Clock серверов и запустить.
5. Запустить Джин. На закладке Indicator содержится визуальное представление индикатора уровня.

{{Image("Indicator.JPG","nolink")}}

Для того, чтобы настроить подключение к сервису индикатора уровня,
необходимо кликнуть мышкой по названию индикатора (по умолчанию названием является слово - Индикатор).

{{Image("IndConnectSett.JPG","nolink")}}

В появившемся диалоговом окне нужно указать Адрес источника (в нашем случае названием является значение атрибута HOST конфигурационного файла level_ctrl_service.xml).

Далее нужно выбрать индикатор уровня, значения которого необходимо получать. Для этого нужно нажать на кнопку *обновить*, при этом в список Название индикатора попадут доступные индикаторы.

{{Image("IndConnectSett2.JPG","nolink")}}

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

{{Image("IndicatorPreview.JPG","nolink")}}

Завершение редактирования параметров сервиса¶

Если существуют работающие индикаторы уровней, то обновление параметров связанных с этими индикаторами произойдет после выхода из главного диалога редактирования. При этом индикаторы автоматически перезапустятся с новыми параметрами.