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

Назначение свойств объекта

Все объекты OPC Toolbox™ Data Access поддерживают свойства, которые позволяют вам управлять характеристиками объекта:

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

Просмотр значений свойств объекта

Чтобы просмотреть все свойства объекта OPC Toolbox Data Access с их текущими значениями, используйте get функция.

Если вы не задаете возврата значение, get функция отображает свойства объекта в категориях, которые группируют подобные свойства вместе. Используйте форму отображения get функция для просмотра значения всех свойств объекта тулбокса.

Этот пример использует get функция для отображения списка всех свойств OPC dagroup grp объекта.

get(grp)

  General Settings:
    DeadbandPercent = 0
    GroupType = private
    Item = []
    Name = group1
    Parent = [1x1 opcda]
    Tag = 
    TimeBias = 0
    Type = dagroup
    UpdateRate = 0.5000
    UserData = []

  Callback Function Settings:
    CancelAsyncFcn = @opccallback
    DataChangeFcn = []
    ReadAsyncFcn = @opccallback
    RecordsAcquiredFcn = []
    RecordsAcquiredFcnCount = 20
    StartFcn = []
    StopFcn = []
    WriteAsyncFcn = @opccallback

  Subscription and Logging Settings:
    Active = on
    LogFileName = opcdatalog.olf
    Logging = off
    LoggingMode = memory
    LogToDiskMode = index
    RecordsAcquired = 0
    RecordsAvailable = 0
    RecordsToAcquire = 120
    Subscription = on

Просмотр значения конкретного свойства

Чтобы просмотреть значение конкретного свойства объекта OPC Toolbox Data Access, используйте get функция, задающая имя свойства как аргумент. Вы также можете получить доступ к значению свойства, так как вы бы поле в MATLAB^® структура.

Этот пример использует get функция для извлечения значения Subscription свойство для dagroup объект.

get(grp,'Subscription')

ans =

on

Этот пример иллюстрирует, как получить доступ к тому же свойству путем ссылки на объект, как если бы он был структурой MATLAB.

grp.Subscription

ans =

on

Получение информации о свойствах объекта

Чтобы получить информацию о конкретном свойстве, используйтеpropinfo или opchelp функция.

propinfo функция возвращает структуру, которая содержит информацию о свойстве, например, его тип данных, значение по умолчанию и список всех возможных значений, если свойство поддерживает такой список. Этот пример использует propinfo чтобы получить информацию о LoggingMode свойство.

propinfo(grp,'LoggingMode')

ans = 

               Type: 'string'
         Constraint: 'enum'
    ConstraintValue: {'memory'  'disk'  'disk&memory'}
       DefaultValue: 'memory'
           ReadOnly: 'whileLogging'

opchelp функция возвращает ссылочную информацию о свойстве с полным описанием. Этот пример использует opchelp чтобы получить информацию о LoggingMode свойство.

opchelp(grp,'LoggingMode')

Установите значение свойства объекта

Чтобы задать значение конкретного свойства объекта OPC Toolbox Data Access, используйте set функция, задающая имя свойства как аргумент. Можно также присвоить значение свойству, так же как и полю в структуре MATLAB.

Этот пример использует set функция для установки значения LoggingMode свойство.

set(grp,'LoggingMode','disk&memory')

Чтобы проверить новое значение свойства, используйте get функция.

get(grp,'LoggingMode')

ans =

disk&memory

Этот пример задает и просматривает значение свойства при помощи записи через точку.

grp.LoggingMode = 'disk';
grp.LoggingMode

ans =

disk

Просмотр списка всех настраиваемых свойств объекта

Чтобы просмотреть список всех свойств объекта тулбокса, которые можно задать, используйте set функция.

set(grp)

  General Settings:
    DeadbandPercent
    Name
    Tag
    TimeBias
    UpdateRate
    UserData

  Callback Function Settings:
    CancelAsyncFcn: character vector -or- function handle -or- cell array
    DataChangeFcn: character vector -or- function handle -or- cell array
    ReadAsyncFcn: character vector -or- function handle -or- cell array
    RecordsAcquiredFcn: character vector -or- function handle -or- cell array
    RecordsAcquiredFcnCount
    StartFcn: character vector -or- function handle -or- cell array
    StopFcn: character vector -or- function handle -or- cell array
    WriteAsyncFcn: character vector -or- function handle -or- cell array

  Subscription and Logging Settings:
    Active: [ {on} | off ]
    LogFileName
    LoggingMode: [ {memory} | disk | disk&memory ]
    LogToDiskMode: [ {index} | append | overwrite ]
    RecordsToAcquire
    Subscription: [ {on} | off ]

При использовании set функция для отображения списка настраиваемых свойств, все свойства с предопределенным набором допустимых значений перечисляют эти значения после свойства. Значение по умолчанию заключено в фигурные скобки ({}). Для примера из отображений, показанных выше, можно задать Subscription свойство для dagroup объект к 'on' или 'off', со значением по умолчанию 'on'. Можно задать LogFileName свойство любому значению.