Exponenta Banner

readHistory

Считайте исторические данные из узлов на сервере UA OPC

свернуть все на странице

Синтаксис

UaData = readHistory(UaClient,NodeList,StartTime,EndTime)
UaData = readHistory(UaClient,NodeList,StartTime,EndTime,ReturnBounds)
UaData = readHistory(NodeList,StartTime,EndTime)
UaData = readHistory(NodeList,StartTime,EndTime,ReturnBounds)

Описание

UaData = readHistory(UaClient,NodeList,StartTime,EndTime) считывает хранимые исторические данные из узлов, идентифицированных NodeList, на сервере, сопоставленном со связанным клиентом UaClient, с источником устанавливают метку времени между StartTime (включительно) и EndTime (исключительный).NodeList один объект узла UA OPC или массив узлов. StartTime и EndTime могут быть значения datetime MATLAB или числа даты.

пример

UaData = readHistory(UaClient,NodeList,StartTime,EndTime,ReturnBounds) позволяет вам указывать, что возвращенные данные должны включать значения ограничения. Ограничивающие значения сразу являются значениями вне области значений времени, которую требуют (первое значение незадолго до StartTime, или первое значение после EndTime) когда значение не существует точно на заданном пределе области значений времени. Установка ReturnBounds к true возвращает значения ограничения; установка ReturnBounds к false (значение по умолчанию), возвращает значения строго в течение заданных времен начала и конца.

UaData = readHistory(NodeList,StartTime,EndTime) и UaData = readHistory(NodeList,StartTime,EndTime,ReturnBounds) читайте из узлов, идентифицированных NodeList. Все узлы должны иметь тот же связанный клиент.

Примеры

свернуть все

В этом примере показано, как получить историю в течение текущего дня от локального сервера.

uaClnt = opcua('localhost',62550);
connect(uaClnt);
nodeId = '1:Quickstarts.HistoricalAccessServer.Data.Dynamic.Double.txt';
nodeList = opcuanode(2,nodeId,uaClnt);
dataObj = readHistory(uaClnt,nodeList,datetime('today'),datetime('now'));

Входные параметры

свернуть все

Клиент UA OPC задал как объект клиента UA OPC. Клиент должен быть соединен.

Список узлов в виде массива объектов узла или одного узла. Можно создать использование объектов узла getNamespace, browseNamespace, или opcuanode. Для получения информации о функциях объекта узла и свойствах, введите:

help opc.ua.Node

Вы можете только для чтения от узлов типа переменной, не узлов типа объекта. Если вы задаете объектный узел, чтобы читать, возвращаемое значение является пустым массивом, и качество установлено в Bad:AttributeIdInvalid.

Исходный отрезок времени в виде значений datetime MATLAB или чисел даты. Исходные времена падают между StartTime (включительно) и EndTime (исключительный).

Запросите значения ограничения в виде TRUE или FALSE.

Выходные аргументы

свернуть все

Исторические данные, возвращенные как вектор из Объектов данных UA OPC. Если readHistory сбои, чтобы получить историю для данного узла, тот узел не возвращен в Объекте данных UA OPC, и предупреждение выдано. Если все требуемые узлы перестали работать, ошибка сгенерирована.

Смотрите также

Функции

Введенный в R2015b

Документация OPC Toolbox

Поддержка