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

Цель свойств объектов

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

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

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

Чтобы просмотреть все свойства объекта 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

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

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

Функция 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

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

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 на любое значение.