Работа с API
Стороннее ПО может взаимодействовать с OwenCloud с помощью REST-подобного программного интерфейса (API). API предназначено для доступа к имеющимся в сервисе данным. В качестве основного формата вывода применяется JSON, однако клиент также может запросить данные в формате XML.
Документация по API доступна по ссылке: https://api.owencloud.ru/.
В OwenCloud имеется ограничение на число запросов, которые могут быть обработаны за интервал времени, равный 10 секундам, поступающих с одного IP адреса. Отсчет времени начинается с первого запроса в новой последовательности запросов. В случае превышения ограничения возвращается код состояния 429 (Too Many Requests). Ограничения описаны ниже:
/v1/parameters/last-data – не более 10 запросов за 10 секунд;
/v1/device/index – не более 10 запросов за 10 секунд;
/v1/parameters/data – не более 10 запросов за 10 секунд;
/v1/auth/open – не более 10 запросов за 10 секунд;
/v1/parameters/write-data – не более 1 запроса за 10 секунд;
все остальные запросы – не более 30 запросов за 10 секунд.
Передача данных из OwenCloud в SCADA системы
OwenCloud поддерживает передачу данных в SCADA-системы при помощи бесплатного OPC-сервера ОВЕН или по OPC UA.
Получение данные из OwenCloud в SCADA-системы, имеющие OPC DA клиента, обеспечивается при помощи бесплатного OPC-сервера ОВЕН.
Также имеется возможность записи параметров из SCADA-системы в OwenCloud.
Передача данных в SCADA-систему:
Если SCADA-система поддерживает OPC UA, считывание данных производится без использования дополнительных OPC серверов.
Если SCADA-система не поддерживает OPC UA протокол, считывание данных производится OPC-сервером (с протоколом OPC UA) с последующей передачей данных в SCADA-систему.
Настройка обмена данными между OPC-сервером ОВЕН и OwenCloud
OPC-сервер ОВЕН (версия 1.9.54 и выше) производит чтение и запись параметров приборов, добавленных в OwenCloud, для интеграции со SCADA-системами и другим программным обеспечением.
OPC-сервер распространяется бесплатно и доступен для скачивания по ссылке Программное обеспечение/OPC-серверы/OPC-сервер ОВЕН.
Для подключения OPC-сервера к OwenCloud:
Скачайте и установите OPC-сервер.
Запустите OPC-сервер. Откроется окно:
Нажмите кнопку Добавить узел. Откроется окно:
Выберите Узел 1 и установите в разделе Общие настройки / Протокол – OwenCloud.
Нажмите кнопку Добавить устройство. Откроется окно авторизации в OwenCloud:
Введите Логин и Пароль от учетной записи OwenCloud и нажмите кнопку Войти. Откроется окно с приборами пользователя:
Установите галочки для приборов, которые необходимо добавить в OPC-сервер. Нажмите кнопку Добавить. Откроется окно:
Выберите прибор и нажмите кнопку Запустить опрос. Откроется окно с результатами считывания данных:
Качество – отображается состояние считывания значения параметра. Возможные значения: GOOD– значение считано; BAD – при считывании возникла ошибка.
Для изменения значения параметра дважды нажмите в поле Значение и введите новое.
Настройка обмена между Multi-Protocol MasterOPC Server и OwenCloud по протоколу OPC UA
OwenCloud поддерживает протокол OPC UA в режиме сервера. OPC UA клиент (например, интегрированный в SCADA-систему) может подключиться к OwenCloud и производить чтение данных.
Настройка обмена данными при подключении к OwenCloud по OPC UA с помощью Multi-Protocol MasterOPC Server:
Установите и запустите Multi-Protocol MasterOPC Server.
Выберите Server / Добавить протокол. Откроется окно, в котором выберите протокол OPC UA Client:
Выберите Протокол / Добавить устройство. Откроется окно:
Выберите команду Подключение OPC UA сервера:
Откроется окно:
Укажите адрес и порт OwenСloud, используемый протоколом OPC UA: opc.tcp://opc.owencloud.ru:4843. Нажмите кнопку Поиск.
В результатах выберите точку подключения с политикой безопасности Basic256Sha256.
Введите имя пользователя и пароль учетной записи OwenСloud. Нажмите кнопку Готово.
Откроется окно проверки подключения:
Нажмите кнопку Да.
Выберите устройство / Добавить / Теги протокола (импорт). Откроется окно:
Откроется окно:
Нажмите кнопку Соединить.
Установите галочки для нужных параметров приборов.
Нажмите кнопку Готово. Откроется окно:
Сохраните конфигурацию OPC-сервера, нажав кнопку Сохранить как.
Для проверки считывания значений параметров запустите OPC-сервер:
Настройка обмена данными между MasterSCADA 3.11 и OwenCloud по протоколу OPC UA
Установите и запустите MasterSCADA 3.11.
Создайте новый проект.
Выберите Система / Вставить / Компьютер:
Выберите Компьютер / Вставить OPC UA сервер / OPC UA сервер:
Откроется окно:
Выберите сервер.
Нажмите кнопку Настройки. Откроется окно, в котором укажите:
адрес и порт OwenСloud, используемый протоколом OPC UA: opc.tcp://opc.owencloud.ru:4843.
политику безопасности – Basic256Sha256.
имя пользователя и пароль учетной записи OwenСloud. Нажмите кнопку ОК.
- Нажмите кнопку Подключится. Откроется окно:
Установите галочки для нужных параметров приборов. Нажмите кнопку Применить. Откроется окно:
Нажмите кнопку Пуск для запуска режима исполнения. После запуска в окне отобразятся значения параметров:
