Exponenta Banner
exponenta event banner

readHistory (opcua)

Считайте исторические данные из узлов на сервере 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
Поддержка