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

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

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

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

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

Для просмотра всех свойств объекта доступа к данным панели инструментов OPC с их текущими значениями используйте 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 используйте 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, используйте 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 для любого значения.