OPCONNECTOR.EXE: различия между версиями

Материал из TekonWiki
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
 
(не показано 35 промежуточных версий этого же участника)
Строка 1: Строка 1:
=== Введение ===
Программа предназначена для АСУД.SCADA версий 2.х
В АСУД.SCADA версий 3.х для получения аналогичного функционала следует использовать устройство DA Proxy \ HTTP в [[Tekon OPC-сервер|Tekon OPC-сервере.]]


=== Введение ===
Корректное применение утилиты вместе с сервером 3.х допускается только при одном удаленном клиентском подключении.


Версия:
Версия:


'''27-03-2024 (сборка АСУД.SCADA 2.7.15)'''
'''3.3 от 18-02-2025 '''
 
*адаптация к АСУД.SCADA 3.x
*дополнительные параметры настройки
 
'''3.2 от 24-03-2025 '''
 
*дополнительные логи 
*корректная обработка кодировки utf-8 в POST-данных
 
'''3.1 от 18-03-2025 '''
 
*для кодировки utf-8 отменена выдача результата с escape-последотельностями
*корректное отображение xml внутри json
 
'''2.1 от 05-02-2025 '''
 
*возможность выбора кодировки windows-1251 или utf-8
 
В данной версии следует использовать установить SuperJSON=true (подробнее см. далее)
 
'''10-11-2024'''
 
*отображение имени проблемного Item, свойства которого не смогли корретно прочитаться<br/> в процессе подключения к DA-серверу
 
'''30-10-2024'''


*первая версия программы
*корректное отображение в JSON свойств varOleStr, содержацих многострочные строки.<br/> Данные передаются в "сжатом" JSON формате


'''21-10-2024 (сборка АСУД.SCADA 2.7.17)'''
*поддержка работы с Tekon OPC версии 2.8.х
*поддержка новых API-вызовов версии 2.0
'''03-05-2024&nbsp;(сборка АСУД.SCADA 2.7.15)'''
*поддержка новых API-вызовов
'''27-04-2024&nbsp;'''
*первая версия программы


=== Назначение ===
=== Назначение ===
Строка 13: Строка 55:
Утилита представляет собой OPC-HTTP шлюз и позволяет получить доступ к данным любого OPC DA сервера посредством&nbsp;[[WEB_OPC_HTTP_API|WEB OPC HTTP API]]
Утилита представляет собой OPC-HTTP шлюз и позволяет получить доступ к данным любого OPC DA сервера посредством&nbsp;[[WEB_OPC_HTTP_API|WEB OPC HTTP API]]


В программном обеспечении АСУД.SCADA утилита применяется для организации доступа АРМ к&nbsp;удаленному Tekon OPC-серверу, минуя DCOM-подключение по сети.<br/> Утилита применяется в связке с драйвером OPC HTTP шлюза в&nbsp;[[Tekon_OPC-сервер|Tekon OPC-сервер]].
В программном обеспечении АСУД.SCADA утилита применяется для организации доступа&nbsp; АРМ с АСУД.SCADA&nbsp;&nbsp;к удаленному&nbsp;[[Tekon_OPC-сервер|Tekon OPC-серверу]], минуя DCOM-подключение по компьютерной сети.
 
Подробнее см.&nbsp;[[Подключение_к_удаленному_Tekon_OPC_через_HTTP-шлюз|Подключение к удаленному Tekon OPC через HTTP-шлюз]]


=== Установка программы ===
=== Установка программы ===


Программа устанавливается автоматически в составе комплекта ПО АСУД.SCADA.
Программа устанавливается автоматически в составе комплекта ПО АСУД.SCADA 2.7.15 и выше<br/> (для предыдущих версий АСУД.SCADA загрузите последнуюю версию&nbsp;программы&nbsp;[https://tekon.ru/software/opconnector.zip по ссылке].<br/> Программа совместима с любой версией Tekon OPC-сервера)


Иначе скопируйте ее в папку:
Иначе скопируйте ее в папку:
Строка 23: Строка 67:
*..\OPC Server\tools-server&nbsp; - если на ПК установлено ПО АСУД.SCADA  
*..\OPC Server\tools-server&nbsp; - если на ПК установлено ПО АСУД.SCADA  
*любую папку если ПО АСУД.SCADA не установлено  
*любую папку если ПО АСУД.SCADA не установлено  
Программа в процессе установки и&nbsp;работы не вносит никаких изменений в конфигурацию оборудования&nbsp; АРМ.


=== Запуск программы ===
=== Запуск программы ===


Для запуска программы запустите файл opcconnector.exe
Для запуска программы запустите файл ..\ tools-server \ opconnector.exe
 
[[File:Opcconnector main.PNG|center|350px|Reload guids.PNG]]Главное окно программы отображает:
 
*общий лог работы&nbsp;
*статистику подключения клиентов
 
Элементы управления:
 
*Блокирвать ... - временно блокирует добавление новых данных в окно лога
*Сохранить - сохранит лог в папке .. \ Log
 
Для возможности работы после перезагрузки ПК, следует добавить программу в меню автозагрузки операционной системы.
 


[[File:Settings refresh.PNG|center|350px|Reload guids.PNG]]


=== Работа с программой ===
=== Работа с программой ===


По-умолчанию, программа пытается прочитать настройки из папки&nbsp; ..\settings. Если необходимо прочитать настройки из другой папки, следует выбрать каталог нажав на кнопку "...".
После запуска, утилита автоматически выполнит подключение в локальному OPC DA-серверу.
 
Нет необходимости закрывать программу&nbsp;при запуске конфигуратора ОРС-сервера. После закрытия конфигуратора, программа автоматически переподключится к серверу.
 
В окне статистики отображется информация:
 
*о состоянии подключения к локальному ОРС-серверу
*об активных сетевых подключениях клиентов


Программа определяет тип настроек, исходя из полного пути к каталогу настроек:
[[File:Opcconnector stat.PNG|center|350px|Reload guids.PNG]]


*если в имени содержится \SCADA, то это настройки Scada, например:&nbsp; C:\1Tekon\ASUD Scada'''\Scada'''\settings
После первого запуска программы автоматически создается конфигурационный файл .. \ settings \&nbsp;httpconnector.conf
*если в имени содержится \OPC, то это настройки OPC-сервера,&nbsp;например:&nbsp; C:\1Tekon\ASUD Scada'''\OPC'''&nbsp;server\settings
<pre>{
*иначе программа сообщит об ошибке
"AllowedIP": [],
"Active": true,
"Password": "",
"KeepAlive": true,
"Login": "",
"ListenPort": 81,
"AllowWriteOPCItem": true,
"SuperJSON": false,
"UseUTF8": false,
"SessionLiveTime": 30,
"MaxSessions": 1


Тип настроек отобразится в левом нижнем углы программы.
}</pre>


Доступные настройки:
, где


*Демонстрационный режим - (по-умолчанию)&nbsp; программа просто проверит папку настроек, не выполняя никаких изменений с файлами
*AllowedIP - позволяет через&nbsp;; указать список разрешенных IP-адресов клиентов<br/> (вы также можете настроить параметры разршения в Брандмауэре Windows)
*Переносить в \Backup - (рекомендуется) все файлы, определенные программой, как некорректные для данной конфигурации, будут перенесены в папку \settings\backup&nbsp;  
*Active - разрешено подключение клиентов
*Удалить -&nbsp;все файлы, определенные программой, как некорректные для данной конфигурации, будут удалены
*Password - пароль подключения, рекомендуем изменить в процессе настройки
*Login - логин подключения, рекомендуем изменить в процессе настройки
*KeepAplive - разрешить клиенту подключаться в режиме keep-alive
*ListenPort - порт, который слушает приложение
*AllowWriteOPCItem - разрешить ли клиентам выполнять запись значений в Item OPC-сервера, иначе - только чтение
*SuperJSON - отправлять ответы в JSON-формате с&nbsp;разделением на строки (удобно в целях отладки).<br/> В данном режиме&nbsp;&nbsp;не выполняется замена перевода&nbsp;строк на последовательность \r \n
*UseUTF8 - установите в true, если вы хотите получать данные в кодировке utf-8
*SessionLiveTime - время жизни сессии в отсутствии запросов клиента.
*MaxSessions [0,1] - максимальное число подключенных клиентов.  0 - без ограничений 1 - только одно клиентское подключение. При подключении к серверу 3.х должен быть 1.


При проверке настроек Scada, программа дополнительно анализирует конфигурацию файла карты (map.conf) и проверяет, что фоновые изображения, используемые в карте, сохранены в папку \settings\Images. По возможности программа переносит файлы в указанный каталог.<br/> (это работает только для локальных настроек)
=== Известные проблемы ===


&nbsp;
В версии 2.1 есть ошибка при отображении xml-данных в json, при значении настроечного параметра SuperJSON=false.<br/> Следует выполнить обновление до версии 3.2&nbsp;или установить&nbsp;SuperJSON=true


[[Category:Утилиты]][[Category:Tools-Server]]
[[Category:Утилиты]] [[Category:Tools-Server]]

Текущая версия от 09:52, 19 февраля 2026

Введение

Программа предназначена для АСУД.SCADA версий 2.х

В АСУД.SCADA версий 3.х для получения аналогичного функционала следует использовать устройство DA Proxy \ HTTP в Tekon OPC-сервере.

Корректное применение утилиты вместе с сервером 3.х допускается только при одном удаленном клиентском подключении.

Версия:

3.3 от 18-02-2025 

  • адаптация к АСУД.SCADA 3.x
  • дополнительные параметры настройки

3.2 от 24-03-2025 

  • дополнительные логи 
  • корректная обработка кодировки utf-8 в POST-данных

3.1 от 18-03-2025 

  • для кодировки utf-8 отменена выдача результата с escape-последотельностями
  • корректное отображение xml внутри json

2.1 от 05-02-2025 

  • возможность выбора кодировки windows-1251 или utf-8

В данной версии следует использовать установить SuperJSON=true (подробнее см. далее)

10-11-2024

  • отображение имени проблемного Item, свойства которого не смогли корретно прочитаться
    в процессе подключения к DA-серверу

30-10-2024

  • корректное отображение в JSON свойств varOleStr, содержацих многострочные строки.
    Данные передаются в "сжатом" JSON формате

21-10-2024 (сборка АСУД.SCADA 2.7.17)

  • поддержка работы с Tekon OPC версии 2.8.х
  • поддержка новых API-вызовов версии 2.0

03-05-2024 (сборка АСУД.SCADA 2.7.15)

  • поддержка новых API-вызовов

27-04-2024 

  • первая версия программы

Назначение

Утилита представляет собой OPC-HTTP шлюз и позволяет получить доступ к данным любого OPC DA сервера посредством WEB OPC HTTP API

В программном обеспечении АСУД.SCADA утилита применяется для организации доступа  АРМ с АСУД.SCADA  к удаленному Tekon OPC-серверу, минуя DCOM-подключение по компьютерной сети.

Подробнее см. Подключение к удаленному Tekon OPC через HTTP-шлюз

Установка программы

Программа устанавливается автоматически в составе комплекта ПО АСУД.SCADA 2.7.15 и выше
(для предыдущих версий АСУД.SCADA загрузите последнуюю версию программы по ссылке.
Программа совместима с любой версией Tekon OPC-сервера)

Иначе скопируйте ее в папку:

  • ..\OPC Server\tools-server  - если на ПК установлено ПО АСУД.SCADA
  • любую папку если ПО АСУД.SCADA не установлено

Программа в процессе установки и работы не вносит никаких изменений в конфигурацию оборудования  АРМ.

Запуск программы

Для запуска программы запустите файл ..\ tools-server \ opconnector.exe

Reload guids.PNG
Reload guids.PNG

Главное окно программы отображает:

  • общий лог работы 
  • статистику подключения клиентов

Элементы управления:

  • Блокирвать ... - временно блокирует добавление новых данных в окно лога
  • Сохранить - сохранит лог в папке .. \ Log

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


Работа с программой

После запуска, утилита автоматически выполнит подключение в локальному OPC DA-серверу.

Нет необходимости закрывать программу при запуске конфигуратора ОРС-сервера. После закрытия конфигуратора, программа автоматически переподключится к серверу.

В окне статистики отображется информация:

  • о состоянии подключения к локальному ОРС-серверу
  • об активных сетевых подключениях клиентов
Reload guids.PNG
Reload guids.PNG

После первого запуска программы автоматически создается конфигурационный файл .. \ settings \ httpconnector.conf

{
 "AllowedIP": [],
 "Active": true,
 "Password": "",
 "KeepAlive": true,
 "Login": "",
 "ListenPort": 81,
 "AllowWriteOPCItem": true,
 "SuperJSON": false,
 "UseUTF8": false,
 "SessionLiveTime": 30,
 "MaxSessions": 1

}

, где

  • AllowedIP - позволяет через ; указать список разрешенных IP-адресов клиентов
    (вы также можете настроить параметры разршения в Брандмауэре Windows)
  • Active - разрешено подключение клиентов
  • Password - пароль подключения, рекомендуем изменить в процессе настройки
  • Login - логин подключения, рекомендуем изменить в процессе настройки
  • KeepAplive - разрешить клиенту подключаться в режиме keep-alive
  • ListenPort - порт, который слушает приложение
  • AllowWriteOPCItem - разрешить ли клиентам выполнять запись значений в Item OPC-сервера, иначе - только чтение
  • SuperJSON - отправлять ответы в JSON-формате с разделением на строки (удобно в целях отладки).
    В данном режиме  не выполняется замена перевода строк на последовательность \r \n
  • UseUTF8 - установите в true, если вы хотите получать данные в кодировке utf-8
  • SessionLiveTime - время жизни сессии в отсутствии запросов клиента.
  • MaxSessions [0,1] - максимальное число подключенных клиентов. 0 - без ограничений 1 - только одно клиентское подключение. При подключении к серверу 3.х должен быть 1.

Известные проблемы

В версии 2.1 есть ошибка при отображении xml-данных в json, при значении настроечного параметра SuperJSON=false.
Следует выполнить обновление до версии 3.2 или установить SuperJSON=true