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

Свойства базы и интерфейса

Требуемое поведение объекта инструмента устанавливается путем настройки значений свойств. Можно настроить значения свойств с помощью set функция или точечная нотация, или путем указания пар имя/значение свойства во время создания объекта. Можно вернуть значения свойств с помощью get функция или точечная нотация.

Объекты интерфейса имеют два типа свойств:

Возврат имен и значений свойств

После создания объекта инструмента можно задать конфигурируемые свойства. Кроме того, если свойство имеет конечный набор значений символьных векторов, то set также возвращает эти значения.

Например, конфигурируемые свойства объекта GPIB g показаны ниже. Сначала перечисляются базовые свойства, за которыми следуют свойства GPIB.

g = gpib('ni',0,1);
set(g)
    ByteOrder: [ {littleEndian} | bigEndian ] 
    BytesAvailableFcn
    BytesAvailableFcnCount
    BytesAvailableFcnMode: [ {eosCharCode} | byte ]
    ErrorFcn
    InputBufferSize
    Name
    OutputBufferSize
    OutputEmptyFcn
    RecordDetail: [ {compact} | verbose ]
    RecordMode: [ {overwrite} | append | index ]
    RecordName
    Tag
    Timeout
    TimerFcn
    TimerPeriod
    UserData
    
    GPIB specific properties:
    BoardIndex
    CompareBits
    EOIMode: [ {on} | off ]
    EOSCharCode
    EOSMode: [ {none} | read | write | read&write ]
    PrimaryAddress
    SecondaryAddress

Можно отобразить одно или несколько свойств и их текущие значения в переменной или в командной строке.

Например, все свойства и их текущие значения для объекта GPIB g показаны ниже. Сначала перечисляются базовые свойства, за которыми следуют свойства GPIB.

get(g)
    ByteOrder = littleEndian
    BytesAvailable = 0
    BytesAvailableFcn = 
    BytesAvailableFcnCount = 48
    BytesAvailableFcnMode = eosCharCode
    BytesToOutput = 0
    ErrorFcn = 
    InputBufferSize = 512
    Name = GPIB0-1
    OutputBufferSize = 512
    OutputEmptyFcn = 
    RecordDetail = compact
    RecordMode = overwrite
    RecordName = record.txt
    RecordStatus = off
    Status = closed
    Tag = 
    Timeout = 10
    TimerFcn = 
    TimerPeriod = 1
    TransferStatus = idle
    Type = gpib
    UserData = []
    ValuesReceived = 0
    ValuesSent = 0

    GPIB specific properties:
    BoardIndex = 0
    BusManagementStatus = [1x1 struct]
    CompareBits = 8
    EOIMode = on
    EOSCharCode = LF
    EOSMode = none
    HandshakeStatus = [1x1 struct]
    PrimaryAddress = 1
    SecondaryAddress = 0

Чтобы отобразить текущее значение для одного свойства, укажите имя свойства для get.

g.OutputBufferSize
ans =
   512

Для отображения текущих значений нескольких свойств необходимо включить имена свойств в качестве элементов массива ячеек.

g.BoardIndex
ans = 
    [0]  

g.TransferStatus
ans = 
    'idle'

Можно также использовать точечную нотацию для отображения одного значения свойства.

g.PrimaryAddress
ans =
     1

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

Можно настроить значения свойств с помощью объекта

g.EOSMode = 'read'

Чтобы настроить значения для нескольких свойств, можно задать каждое из них следующим образом.

g.EOSCharCode = 'CR'
g.Name = 'Test1-gpib'

Обратите внимание, что одновременно можно настроить только одно значение свойства с помощью точечной нотации.

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

Указание имен свойств

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

g.EOSMode = 'read'
g.eosmode = 'read'
g.EOSM = 'read'

Однако при включении имен свойств в файл следует использовать полное имя свойств. Эта практика может предотвратить проблемы с будущими выпусками программного обеспечения Instrument Control Toolbox™, если укороченное имя больше не является уникальным из-за добавления новых свойств.

Значения свойств по умолчанию

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

Если свойство имеет конечный набор значений символьных векторов, то значение по умолчанию заключено в {} (фигурные скобки). Например, значение по умолчанию для EOSMode свойство - none.

g.EOSMode
ans =

none

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

Использование завершения закладки для функций

Для получения списка опций, которые можно использовать в функции, нажмите клавишу Tab после ввода функции в командной строке MATLAB. Список расширяется, и можно выполнить прокрутку для выбора свойства или значения. Например, при создании gpib можно получить список установленных поставщиков:

g = gpib('

При нажатии клавиши Tab после скобок и одной кавычки, как показано здесь, отображается список установленных поставщиков GPIB, например keysight, ics, mcc, и ni.

Формат функции конструктора объектов GPIB:

g = gpib('vendor',boardindex,primaryaddress) 

При нажатии клавиши Tab, где должно появиться поле, появляется список параметров для этого поля. Другие объекты интерфейса, такие как Bluetooth, Serial, TCP/IP и т.д., также включают эту возможность в свои функции конструктора объектов.

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

s = serial('COM1','Terminator',' 

Нажмите клавишу Tab после ввода одной кавычки после Terminator чтобы получить возможные значения для этого свойства, как показано здесь.

Многие другие функции панели инструментов также имеют завершение закладок. Например, при использовании fread можно указать тип точности с помощью функции завершения табуляции.

data = fread(s,256,' 

Нажмите клавишу Tab после ввода одной кавычки после size (256 значений в этом примере), поскольку точность является следующим аргументом fread функция принимает, чтобы получить возможные значения для типов точности, такие как 'double', 'int16'и т.д.

Если список возможных значений длинный, во всплывающем окне появляется полоса прокрутки, как показано в этом примере.

Инспектор свойств

Инспектор свойств позволяет проверять и задавать свойства для одного или нескольких объектов инструмента. Он предоставляет список всех свойств и отображает их текущие значения.

Настраиваемые свойства в списке связаны с устройством редактирования, которое соответствует значениям, принятым определенным свойством. Например, графический интерфейс пользователя конфигурации обратного вызова для установки ErrorFcn, всплывающее меню для установки RecordModeи текстовое поле для указания TimerPeriod. Значения свойств, доступных только для чтения, отображаются серым цветом.

Вы открываете инспектор свойств с помощью inspect функция. Можно также открыть инспектор свойств в браузере рабочего пространства, щелкнув правой кнопкой мыши объект инструмента и выбрав в контекстном меню пункт «Вызвать инспектор свойств» или дважды щелкнув объект.