Тестовая работа с HTTP API: различия между версиями

Материал из TekonWiki
Перейти к навигацииПерейти к поиску
Новая страница: « == Введение == В статье рассматривается взаимодействие с Tekon OPC-сервер&nbs…»
 
Нет описания правки
 
(не показаны 2 промежуточные версии этого же участника)
Строка 1: Строка 1:
[[Category:REST API]]


== Введение ==
== Введение ==
Строка 10: Строка 11:
== Установка программного обеспечения ==
== Установка программного обеспечения ==


В качестве АРМ используется ПК с ОС Windows 10/11.<br/> В ОС необходимо наличие локальной учетной административной записи.&nbsp;
В качестве АРМ используется ПК с ОС Windows 10/11.<br/>В ОС необходимо наличие локальной учетной административной записи.&nbsp;


Необходимо загрузить / обновить следующее программного обеспечение:&nbsp;
Необходимо загрузить / обновить следующее программного обеспечение:&nbsp;


*[https://tekon.ru/downloads АСУД.SCADA 2.7.16] или выше
*[https://tekon.ru/downloads АСУД.SCADA]  
*[[OPCONNECTOR.EXE|OPCONNECTOR.EXE]]&nbsp;загрузить последнюю версию [https://tekon.ru/software/opconnector.zip по ссылке]&nbsp;


ПО АСУД.SCADA устанавливается в папку C:\1Tekon\ASUD Scada\
ПО АСУД.SCADA устанавливается в папку C:\1Tekon\ASUD Scada\
Строка 44: Строка 44:


Где 70308&nbsp; - это идентификатор соответствующего процесса операционной системы (см. диспетчер задач).
Где 70308&nbsp; - это идентификатор соответствующего процесса операционной системы (см. диспетчер задач).


== Настройка программного обеспечения ==
== Настройка программного обеспечения ==


После установки программного обеспечения необходимо загрузить конфигурационные файлы.
После установки программного обеспечения необходимо загрузить [https://www.tekon.ru/software/test_http_api_config.zip тестовые конфигурационные файлы].


Скопируйте папку settings в ..\ OPC Server \ settings, подтвердив замену файлов.
Скопируйте папку settings в ..\ OPC Server \ settings, подтвердив замену файлов.
Строка 59: Строка 61:
Если все выполнено правильно, вы должны увидеть, примерно следующее.
Если все выполнено правильно, вы должны увидеть, примерно следующее.


[[File:Http test 1.PNG|center|500px]]
[[File:Http test 1.PNG|center|500px|Http test 1.PNG]]
 
В тестовой конфигурации настроены:
 
*один концентратор тип&nbsp;КУН-IP8
*два концентратора сопряжения с лифтом (КСЛ)
*два устройства переговорной&nbsp;связи с лифтом (УПСЛ)
 
Условно - подъезд дома с двумя лифтами: пассажирским и грузовым.
 
Сигналы устройств:
 
*дискретные сигналы&nbsp;
*каналы управления
*каналы переговорной связи
*каналы температуры
*данные состояния лифтов
 
Пример взаимосвязи входов настроенного&nbsp;концентратора КУН-IP8 и кнопок имитатора сигналов см. ниже
 
[[File:Http test 4.PNG|center|500px|Http test 1.PNG]]Следует отметить, что:
 
*дискретные входы 1, 6 - 11 в настройках являются нормально замкнутыми (Инверсивными),<br/> признак ошибки - отжатие соответствующей кнопки в имитаторе&nbsp;
*дискретные входы 2 - 5&nbsp;в настройках являются нормально разомкнутыми<br/> признак ошибки - нажатие соответствующей кнопки в имитаторе&nbsp;
 
Закройте конфигуратор ОРС-сервера, подтвердив сохранение изменений в конфигурации.<br/> При этом будет запущена служба ОС Tekon OPC Server, и OPC DA сервер - готов к работе.
 
В имитаторе сигналов число секунд с момента последнего опроса для каждого из устройств,&nbsp;&nbsp;будет примерно 0.
 
[[File:Http test 2.PNG|center|500px|Http test 1.PNG]]
 
Запустите утилиту&nbsp;[[OPCONNECTOR.EXE|..\ OPC Server \ tools-server \ opconnector.exe]]
 
Должно произойти корректное подключение к OPC-серверу.
 
[[File:Http test 3.PNG|center|500px|Http test 1.PNG]]На этом все настройки завершены.
 
== Проверка API ==
 
Откройте браузер и в адресной строек введите&nbsp;
<pre>http://localhost:81/ServerInformation</pre>
 
В ответ вы должны увидеть&nbsp;
<pre>{"starttime":"12.12.2024 18:48:10","currenttime":"12.12.2024 18:52:29","version":"2.0"}</pre>
 
Далее вы можете продолжить работу в соответствии с описанием&nbsp;[[WEB_OPC_HTTP_API|WEB OPC HTTP API]]
 
== Формирование сигналов ==
 
Используйте имитатор сигналов&nbsp;[[KUNIP.EXE|KUNIP.EXE]]&nbsp; (см. документацию) для изменения состояния входов настроенных устройств.
 
Наблюдайте за изменениями с помощью запросов к API.

Текущая версия от 22:20, 18 февраля 2026


Введение

В статье рассматривается взаимодействие с Tekon OPC-сервер посредствам WEB OPC HTTP API в тестовом режиме, без реально подключенного оборудования.

Для реализации данной возможности будет использоваться имитатор сигналов концентратора КУН-IP8.

USB-ключ защиты ПО АСУД.SCADA в данном случае не требуется.

Установка программного обеспечения

В качестве АРМ используется ПК с ОС Windows 10/11.
В ОС необходимо наличие локальной учетной административной записи. 

Необходимо загрузить / обновить следующее программного обеспечение: 

ПО АСУД.SCADA устанавливается в папку C:\1Tekon\ASUD Scada\

В процессе работы будут использоваться следующие программные модули:

Программа визуализации SCADA - не используется.

Используемые tcp-порты:

  • OPCCONNECTOR.EXE использует по умолчанию порт tcp:81 (можно изменить в настройках).
  • KUNIP.EXE использует порт tcp:80.

По необходимости, временно отключите приложения на вашем ПК, занимающие данные порты.

Для проверки используйте команды:

netstat -ano | findstr :80
netstat -ano | findstr :81

Если порт используется вы увидите 

c:\Program Files (x86)\Nmap>netstat -ano | findstr :80
  TCP    0.0.0.0:8082           0.0.0.0:0              LISTENING       4528
 TCP    127.0.0.1:80           0.0.0.0:0              LISTENING       70308
  TCP    [::]:8082              [::]:0                 LISTENING       4528

c:\Program Files (x86)\Nmap>

Где 70308  - это идентификатор соответствующего процесса операционной системы (см. диспетчер задач).


Настройка программного обеспечения

После установки программного обеспечения необходимо загрузить тестовые конфигурационные файлы.

Скопируйте папку settings в ..\ OPC Server \ settings, подтвердив замену файлов.

Скопируйте папку kunip_rsconfig.json   в ..\ OPC Server \ tools-server

Запустите с административными правами конфигуратор ОРС-сервера, с ярылка на рабочем столе, или выбрав файл ..\ OPC Server \ opcsrv.exe

Запустите имитатор сигналов ..\ OPC Server \ tools-server \ kunip.exe и нажмите Запуск.

Если все выполнено правильно, вы должны увидеть, примерно следующее.

Http test 1.PNG
Http test 1.PNG

В тестовой конфигурации настроены:

  • один концентратор тип КУН-IP8
  • два концентратора сопряжения с лифтом (КСЛ)
  • два устройства переговорной связи с лифтом (УПСЛ)

Условно - подъезд дома с двумя лифтами: пассажирским и грузовым.

Сигналы устройств:

  • дискретные сигналы 
  • каналы управления
  • каналы переговорной связи
  • каналы температуры
  • данные состояния лифтов

Пример взаимосвязи входов настроенного концентратора КУН-IP8 и кнопок имитатора сигналов см. ниже

Http test 1.PNG
Http test 1.PNG

Следует отметить, что:

  • дискретные входы 1, 6 - 11 в настройках являются нормально замкнутыми (Инверсивными),
    признак ошибки - отжатие соответствующей кнопки в имитаторе 
  • дискретные входы 2 - 5 в настройках являются нормально разомкнутыми
    признак ошибки - нажатие соответствующей кнопки в имитаторе 

Закройте конфигуратор ОРС-сервера, подтвердив сохранение изменений в конфигурации.
При этом будет запущена служба ОС Tekon OPC Server, и OPC DA сервер - готов к работе.

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

Http test 1.PNG
Http test 1.PNG

Запустите утилиту ..\ OPC Server \ tools-server \ opconnector.exe

Должно произойти корректное подключение к OPC-серверу.

Http test 1.PNG
Http test 1.PNG

На этом все настройки завершены.

Проверка API

Откройте браузер и в адресной строек введите 

http://localhost:81/ServerInformation

В ответ вы должны увидеть 

{"starttime":"12.12.2024 18:48:10","currenttime":"12.12.2024 18:52:29","version":"2.0"}

Далее вы можете продолжить работу в соответствии с описанием WEB OPC HTTP API

Формирование сигналов

Используйте имитатор сигналов KUNIP.EXE  (см. документацию) для изменения состояния входов настроенных устройств.

Наблюдайте за изменениями с помощью запросов к API.