Сконфигурируйте свойства объектов доступа к данным OPC Toolbox

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

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

  • opcda свойства объекта клиента управляют аспектами связи с Сервером OPC и информацией о событии, полученной из сервера. Например, можно использовать Timeout свойство задать, сколько времени ожидать сервера, чтобы ответить на запрос от клиента.

  • dagroup свойства объектов управляют аспектами набора элементов, содержавших в той группе, включая все свойства логгирования. Например, UpdateRate свойство задает, как часто элементы в группе должны проверяться на изменения значения, а также уровень, на котором данные будут отправлены от сервера во время сеанса логгирования.

  • daitem свойства объектов управляют аспектами одного серверного элемента. Например, вы используете DataType свойство задать тип данных, который сервер должен использовать, чтобы отправить значения того серверного элемента к программному обеспечению OPC Toolbox.

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

  • Просмотрите список всех свойств, поддержанных объектом с их текущими значениями

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

  • Получите информацию о свойстве

  • Установите значение свойства

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

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

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

Этот пример использует get функционируйте, чтобы отобразить список всех свойств dagroup OPC объект 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.

Примечание

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

Этот пример использует 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 свойство к любому значению.

Специальные режимы только для чтения

Некоторые свойства объектов Доступа к данным OPC Toolbox изменяют свое состояние только для чтения, в зависимости от состояния объекта (заданный другим свойством того объекта или родительским элементом того объекта). Тулбокс использует два специальных режима только для чтения:

  • 'whileConnected': Эти свойства не могут быть изменены, в то время как клиент соединяется с Сервером OPC. Например, Host клиента свойство только для чтения, в то время как соединено.

  • 'whileLogging': Эти свойства не могут быть изменены в то время как dagroup объект регистрирует. Например, LoggingMode свойство только для чтения при логгировании. Для получения дополнительной информации о логгировании смотрите, Регистрируют Данные о Сервере OPC.

  • 'whilePublic': Эти свойства не могут быть изменены, потому что группа является общедоступной группой. Для получения дополнительной информации об общедоступных группах смотрите работу с Public Groups.

    Примечание

    Свойства, которые изменяют их состояние только для чтения, всегда отображаются при использовании set отобразить устанавливаемые свойства, даже когда они не могут быть изменены из-за состояния объекта.

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