getnamespace (opcda)

Пробел имени сервера доступа к OPC Data

Синтаксис

S = getnamespace(DAObj)
S = getnamespace(DAObj,'Filter1',Val1,'Filter2',Val2, ...)

Описание

S = getnamespace(DAObj) возвращает целое пространство имен сервера, сопоставленного с доступом к данным (opcda) объект задан DAObjS рекурсивный массив структур, представляющий пространство имен сервера. Каждый элемент S узел в пространстве имен. S содержит поля:

  • Name — описательное имя

  • FullyQualifiedID — полностью определенный ItemID из того узла

  • NodeType — задает узел как 'branch' узел (содержащий другие узлы) или 'leaf' узел (содержащий никакие другие узлы)

  • Nodes — массив структур с теми же полями как S, представление узлов содержится в этой ветви пространства имен.

Используйте flatnamespace сглаживать иерархическое пространство имен.

S = getnamespace(DAObj,'Filter1',Val1,'Filter2',Val2, ...) позволяет вам фильтровать полученное пространство имен на основе многих доступных фильтров обзора. Доступные фильтры описаны в следующей таблице:

BrowseFilter

Описание

'StartItemID'

Задайте FullyQualifiedID из узла ветви, как вектор символов или строка. Только узлы, содержавшиеся в том узле ветви, будут возвращены. Некоторые Серверы OPC не поддерживают частичное извлечение пространства имен на основе этой опции: ошибка сгенерирована, при попытке использовать 'StartItemID' просмотрите фильтр на таком сервере.

'Depth'

Задайте глубину пространства имен, которое вы хотите, возвратился. 'Depth' значение 1 возвращает только узлы, содержавшиеся в стартовой позиции. 'Depth' значение 2 возвращает узлы, содержавшиеся в стартовой позиции и всех их узлах. 'Depth' значение Inf возвращает все узлы. Когда объединено с 'StartItemID' отфильтруйте, 'Depth' фильтр обеспечивает полезный способ исследовать иерархию сервера имени один слой за один раз.

'AccessRights'

Ограничивает поиск вершинами с конкретными характеристиками права доступа. Задайте 'read' возвратить узлы, которые включают право доступа для чтения и 'write' возвратить узлы, которые включают право доступа для записи. Пустой символьный вектор ('') возвращает узлы с любыми правами доступа. Обратите внимание на то, что узлы ветви будут все еще возвращены в пространстве имен, для того, чтобы содержать вершины, которые имеют требуемые права доступа.

'DataType'

Ограничивает поиск узлами с конкретным каноническим типом данных. Допустимыми типами данных является 'double'единственныйint8int16int32uint8uint16uint32логический, 'currency', и 'date'. Используйте 'DataType' отфильтруйте, чтобы найти серверные элементы с определенным типом данных, такие как 'double' или 'date'. Обратите внимание на то, что узлы ветви будут все еще возвращены в пространстве имен, для того, чтобы содержать вершины, которые имеют необходимый тип данных.

Примеры

Получите целое пространство имен для Сервера Симуляции Matrikon™ на локальном хосте:

da = opcda('localhost','Matrikon.OPC.Simulation');
connect(da);
nsFull = getnamespace(da)

Получите только первый уровень пространства имен:

nsPart = getnamespace(da,'Depth',1)

Добавьте узлы, содержавшиеся в первой ветви пространства имен к существующей структуре:

nsPart(1).Nodes = getnamespace(da, ...
   'StartItemID', nsPart(1).FullyQualifiedID, ...
   'Depth',1);

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

| |

Представлено до R2006a

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