AULNet

Общее описание AULNet

Для связи между удаленным прибором и программой управления AKTAKOM используется технология AULNet, которая в качестве конечных точек сетевых коммуникаций использует TCP/IP-подмножество сокетов, знакомых как пользователям UNIX, так и пользователям Windows.

В приведённой схеме в качестве "сервера AULNet" может выступать как встроенный LAN-контроллер прибора, так и приложение-сервер, запускаемое на удалённом компьютере, к которому локально подключён прибора.

С точки зрения пользователя, обращение к инструменту в произвольной точке сети посредством AULNet практически не отличается от обращения к локальному инструменту. Единственное отличие: при вызове функции инициализации (в данной программе вызывается при команде подключиться к устройству) следует указать «полное имя» прибора.

Полное имя инструмента содержит его уникальный идентификатор (тип прибора и модели + серийный номер), способ физического подключения (тип системного драйвера, осуществляющего связь прибора с локальной ОС) и имя сервера. Части имени разделяются двойным двоеточием.

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

Синтаксис:

Треугольные скобки (<>) обозначают вводимые пользователем имена и параметры, квадратные ([]) – необязательные поля. Остальные символы должны использоваться без изменений. Вертикальная черта (|) разделяет альтернативные способы ввода параметров, «либо|либо».

[AULNET[<тип_интерфейса>]::[<сокет>::]]<имя_устройства>

где:

<тип_интерфейса> - одно из символических обозначений используемых в AUL интерфейсов, например: AUN (стандартный драйвер AUNUsb.sys), AUXPR (драйвер USB Xpress), AVCOM (виртуальный COM-порт), AEPP (драйвер параллельного EPP-порта).

<сокет>=<номер_сокета >|<параметры_сокета >

Указывает сокет, используемый для связи с устройством. Используется либо номер сокета, введенного ранее функциями работы со списком серверов, либо прямо описываются параметры сокета (см. далее). Номер сокета из списка указывается десятичным числом.

<параметры_сокета>=@N<сервер>[@P<порт>][@T<таймаут>][@L<логин>]

@N<сервер> - доменное имя (DNS, не более 256 символов) либо IP-адрес сервера, к которому физически подключен инструмент. @P<порт> - номер порта сокета (десятичное число, по умолчанию - 1024). @T<таймаут> - величина таймаута для связи с сокетом (в миллисекундах, значение по умолчанию - 5000). @L<логин> - логин для подключения к серверу (не более 248 символов, по умолчанию используется строка AULNetPass).

Например:

@Nwww.user123.aktakom.com@P1080@Llogin123 или: @N127.0.0.1@P1024

<имя_устройства>=<имя_модели>[ #<серийный номер>]

Имя AUL-устройства, составленное из имени модели (8 символов) и необязательного серийного номера (не более 16 символов), разделенных пробелом со знаком "диеза" - #. Например: AHP-3121 #2310768.

Подстановочные знаки и умолчания:

Некоторые части полного имени устройства могут быть опущены или заменены знаком звездочки - *.

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

Если опущено поле <тип_интерфейса>, то интерфейс выбирается по умолчанию в зависимости от указанной модели инструмента.

Если в поле <имя_устройства> не указан серийный номер, то делается попытка обращения к первому свободному устройству, пригодному для использования в качестве данной модели.

Если в качестве поля <сокет> использован символ ‹*›, выполняется поиск указанного устройства по всем серверам из списка серверов (список серверов задается специальными функциями).

Если в качестве поля <серийный номер> использован символ ‹*›, то делается попытка обращения к первому свободному устройству, точно соответствующему указанной модели.

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

Примеры:

ACK-3106

обращение к первому свободному прибору, который может использоваться в качестве ACK-3106 (в т.ч. осциллографический модуль в составе ACK-4106, ACK-4166, ACK-3107 с модулем USB-хаба), подключенному к локальной машине. Используется прямое подключение, без использования AULNET.

AULNET::@N127.0.0.1@P1024::ACK-3106 #*

обращение к первому свободному прибору типа ACK-3106 (осциллографические модули в составе ACK-4106, ACK-4166, ACK-3107 с модулем USB-хаба игнорируются), подключенному к локальной (127.0.0.1 – IP-адрес для обращения по сети «сам к себе») машине по 1024 порту. Если в списке серверов еще нет сокета с такими параметрами, он будет добавлен в список. Номер добавленного сокета в списке можно затем получить по хэндлеру открытого устройства. Используется подключение через AULNET.

AULNETAUN::2::AME-1204 #123456789

обращение к конкретному прибору типа AME-1204 с серийным номером 123456789, подключенному по интерфейсу AUNUsb к сокету, определяемому записью номер 2 из ранее введенного списка серверов. Если такой записи в списке нет, будет возвращена ошибка EAULNET_SOCKET_INDEF (-25) «Сокет не определен».

AULNET::*::AHP-3121 #123456789

поиск конкретного прибора типа AHP-3121 с серийным номером 123456789 по всем серверам из заданного ранее списка (в т.ч. и в первую очередь проверяются прямые локальные подключения).

Настройка сокетов AULNet в приложении

Позволяет пользователю настроить сокеты для работы с приборами через компьютерную сеть TCP/IP (в т.ч. через Интернет).

Таблица представляет список сокетов AULNet. Отметьте «галочками» те, на которых программа должна искать доступные устройства. Для редактирования содержимого таблицы воспользуйтесь управляющими элементами внизу вкладки.

Имя – имя сокета, доменное имя (DNS, не более 256 символов) либо IP-адрес сервера, к которому физически подключен инструмент.

Порт – номер порта сокета (десятичное число).

Таймаут – величина таймаута для связи с сокетом (в миллисекундах, значение по умолчанию - 5000).

Логин – строка-логин для подключения к серверу (не более 248 символов, по умолчанию используется строка AULNetPass).

- кнопки «Добавить сокет» (введенные параметры добавляются в таблицу как новый сокет), «Удалить сокет» (из таблицы удаляется выделенный сокет), «Изменить сокет» (введенные параметры заменяют в таблице выделенный сокет), «Обновить список» (содержимое таблицы синхронизируется со списком сокетов, хранящимся в драйвере прибора).

Подключение прибора AULNet в приложении

Модель прибора – список для выбора желаемой модели.

Список доступных устройств – имена найденных подходящих приборов. Выберите нужный или введите имя в формате AULNet вручную.

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

 – Поиск всех доступных для подключения устройств, сканирование проводится по всем указанным сокетам (см. выше).

 – Подключение указанного устройства и его тестирование.