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

Материал из TekonWiki
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
 
(не показана 31 промежуточная версия этого же участника)
Строка 1: Строка 1:
=== Введение ===


=== Введение ===
Программа предназначена для АСУД.SCADA версий 2.х
 
В АСУД.SCADA версий 3.х для получения аналогичного функционала следует использовать устройство DA Proxy \ HTTP в [[Tekon OPC-сервер|Tekon OPC-сервере.]]
 
Корректное применение утилиты вместе с сервером 3.х допускается только при одном удаленном клиентском подключении.


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


'''27-04-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;'''


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


=== Назначение ===
=== Назначение ===
Строка 12: Строка 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;
Подробнее см.&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-сервера)


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


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


Для запуска программы запустите файл ..\ tools-server \ opcconnector.exe
Для запуска программы запустите файл ..\ tools-server \ opconnector.exe
 
[[File:Opcconnector main.PNG|center|350px|Reload guids.PNG]]
 
После запуска, утилита автоматически выполнит подключение в локальному Tekon OPC-серверу.
 
Нет необходимости закрывать программу&nbsp;при запуске конфигуратора ОРС-сервера. После закрытия конфигуратора, программа автоматически переподключится к серверу.


Главное окно программы отображает:
[[File:Opcconnector main.PNG|center|350px|Reload guids.PNG]]Главное окно программы отображает:


*общий лог работы&nbsp;  
*общий лог работы&nbsp;  
Строка 46: Строка 85:


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


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


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


Нет необходимости закрывать программу&nbsp;при запуске конфигуратора ОРС-сервера. После закрытия конфигуратора, программа автоматически переподключится к серверу.
Нет необходимости закрывать программу&nbsp;при запуске конфигуратора ОРС-сервера. После закрытия конфигуратора, программа автоматически переподключится к серверу.
Главное окно программы отображает:
*общий лог работы&nbsp;
*статистику подключения клиентов
Элементы управления:
*Блокирвать ... - временно блокирует добавление новых данных в окно лога
*Сохранить - сохранит лог в папке .. \ Log


В окне статистики отображется информация:
В окне статистики отображется информация:
Строка 74: Строка 105:
  "AllowedIP": [],
  "AllowedIP": [],
  "Active": true,
  "Active": true,
  "Password": "0000",
  "Password": "",
  "KeepAlive": true,
  "KeepAlive": true,
  "Login": "http_user",
  "Login": "",
  "ListenPort": 81,
  "ListenPort": 81,
  "AllowWriteOPCItem": true
  "AllowWriteOPCItem": true,
"SuperJSON": false,
"UseUTF8": false,
"SessionLiveTime": 30,
"MaxSessions": 1
 
}</pre>
}</pre>


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