visadev Properties

Доступ к свойствам ресурса VISA

Сконфигурируйте свой ресурс VISA и его коммуникационные настройки с помощью его свойств. После того, как вы создаете a visadev объект, можно использовать запись через точку, чтобы считать и установить свойства.

Свойства создания объекта

развернуть все

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

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

Интерфейс

Имя ресурса

TCP/IP (использующий VXI-11 или HiSLIP)TCPIP[board]::remote_host[::lan_device_name]::INSTR
Сокет TCP/IP

TCPIP[board]::remote_host::port::SOCKET

USBUSB[board]::vendor_ID::product_ID::serial_number[::interface_number]::INSTR
GPIBGPIB[board]::primary_address[::secondary_address]::INSTR
ПоследовательныйASRL[port_number]::INSTR
VXIVXI[chassis]::VXI_logical_address::INSTR
PXI

PXI[bus]::device[::function][::INSTR]

PXI[bus]::CHASSISchassis::SLOTslot[::FUNCfunction][::INSTR]

Параметры имени ресурса описаны можно следующим образом. Каждый параметр соответствует одному из visadev свойства.

Интерфейс

Параметр

Описание

Все

board

Параметр плат (значение по умолчанию 0)

TCP/IP (использующий VXI-11 или HiSLIP) и Сокет TCP/IP

remote_host

Удаленное имя хоста или IP-адрес инструмента

lan_device_name

Имя устройства Локальной сети (LAN) (значение по умолчанию inst0)

port

Удаленный серверный порт для сокета TCP/IP
USB

vendor_ID

ID производителя инструмента USB

product_ID

Типовой кодекс для инструмента USB

serial_number

Индекс инструмента на концентраторе USB

interface_number

Интерфейс USB

GPIB

primary_address

Первичный адрес инструмента GPIB

secondary_address

Вторичный адрес инструмента GPIB (значение по умолчанию 0)

Последовательный

port_number

Номер последовательного порта (значение по умолчанию 1)

VXI и PXI

chassis

VXI или индекс шасси PXI (значение по умолчанию 0 для VXI)

VXI_logical_address

Логический адрес инструмента VXI

bus

Номер шины PCI

device

Номер устройства PCI

function

Номер функции PCI (значение по умолчанию 0)

slot

Номер слота

Пример: gpibdev = visadev("GPIB0::5::INSTR") подключения к устройству GPIB, заданному ресурсом VISA, называют GPIB0::5::INSTR.

Типы данных: char | string

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

Пример: serialdev = visadev("COM4") подключения к последовательному устройству, заданному ресурсом VISA, искажают COM4.

Типы данных: char | string

Это свойство доступно только для чтения.

Тип ресурса VISA, возвращенного как один из поддерживаемых интерфейсов VISA. Некоторые свойства и объектные функции характерны для интерфейсного типа.

Пример: v.Type возвращает тип ресурса VISA.

Это свойство доступно только для чтения.

Инструментальный производитель, возвращенный как вектор символов или строковый скаляр. Это свойство пусто, если тип интерфейса VISA не предоставляет информацию о производителе.

Пример: v.Vendor возвращает имя инструментального производителя.

Типы данных: string

Это свойство доступно только для чтения.

Модель Instrument, возвращенная как вектор символов или строковый скаляр. Это свойство пусто, если тип интерфейса VISA не предоставляет информацию о модели.

Пример: v.Model возвращает имя инструментальной модели.

Типы данных: string

Это свойство доступно только для чтения.

Уникальный порядковый номер сопоставлен с инструментом, возвращенным как вектор символов или строковый скаляр. Это свойство пусто, если тип интерфейса VISA не предоставляет информацию о порядковом номере.

Пример: v.SerialNumber возвращает инструментальный порядковый номер.

Типы данных: string

Считайте и запишите свойства

развернуть все

Последовательный порядок, в котором байты располагаются в большие численные значения, возвратился как "little-endian" или "big-endian".

Пример: v.ByteOrder = "big-endian" устанавливает порядок байтов на обратный порядок байтов.

Типы данных: char | string

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

Пример: v.Timeout = 20 устанавливает период тайм-аута на 20 секунд.

Типы данных: double

Символ Терминатора для чтения и записи отключенных ASCII данных, возвращенных как "LF", "CR", "CR/LF", или номер от 0 до 255, включительно. Если чтение и терминаторы строки записи отличаются, Terminator возвращен как 1x2 массив ячеек этих значений. Установите это свойство с configureTerminator функция.

Пример: configureTerminator(v,"CR") наборы оба чтение и терминаторы строки записи к "CR".

Пример: configureTerminator(v,"CR",10) устанавливает терминатор строки чтения на "CR" и терминатор строки записи к 10.

Типы данных: double | char | string

Это свойство доступно только для чтения.

Количество байтов, доступных в чтение, возвращенное как числовое значение.

Пример: v.NumBytesAvailable возвращает количество байтов, доступных в чтение.

Типы данных: double

Это свойство доступно только для чтения.

Общее количество записанных байтов, возвращенных как числовое значение.

Пример: v.NumBytesWritten возвращает количество записанных байтов.

Типы данных: double

Свойства коллбэка

развернуть все

Байты доступный триггерный режим коллбэка, возвращенный как "off", "byte", или "terminator". Эта установка определяет, выключен ли коллбэк, инициирован количеством байтов, заданных BytesAvailableFcnCount, или инициированный терминатором строки задан Terminator. Установите это свойство с configureCallback функция.

Пример: configureCallback(v,"byte",50,@callbackFcn) устанавливает callbackFcn коллбэк, чтобы инициировать каждый раз 50 байтов новых данных доступен, чтобы быть считанным.

Пример: configureCallback(v,"terminator",@callbackFcn) устанавливает callbackFcn коллбэк, чтобы инициировать, когда терминатор строки доступен, чтобы быть считанным.

Пример: configureCallback(v,"off") выключает коллбэки.

Типы данных: char | string

Количество байтов данных, чтобы инициировать коллбэк, заданный BytesAvailableFcn, возвращенный как двойное. Это значение используется только когда BytesAvailableFcnMode свойством является "byte". Установите эти свойства с configureCallback функция.

Пример: configureCallback(v,"byte",50,@callbackFcn) устанавливает callbackFcn коллбэк, чтобы инициировать каждый раз 50 байтов новых данных доступен, чтобы быть считанным.

Типы данных: double

Функция обратного вызова, инициированная байты доступное событие, возвращенное как указатель на функцию. Байты доступное событие сгенерировано путем получения определенного числа байтов или терминатора строки. Это свойство пусто, пока вы не присваиваете указатель на функцию. Установите это свойство с configureCallback функция.

Пример: configureCallback(v,"byte",50,@callbackFcn) устанавливает callbackFcn коллбэк, чтобы инициировать каждый раз 50 байтов новых данных доступен, чтобы быть считанным.

Типы данных: function_handle

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

Пример: v.ErrorOccurredFcn = @myErrorFcn

Типы данных: function_handle

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

Пример: v.UserData

VISA-TCP/IP

развернуть все

Это свойство доступно только для чтения.

Имя устройства LAN, возвращенное как строка.

Пример: v.LANName возвращает имя устройства LAN.

Типы данных: string

Это свойство доступно только для чтения.

Адрес TCP/IP инструмента в точечной десятичной записи, возвращенной как строка.

Пример: v.InstrumentAddress возвращает IP-адрес инструмента.

Типы данных: string

Это свойство доступно только для чтения.

Индекс сетевой платы сопоставлен с инструментом, возвращенным как положительное целочисленное значение.

Пример: v.BoardIndex возвращает индекс сетевой платы.

Типы данных: double

Сокет ВИЗЫ

развернуть все

Это свойство доступно только для чтения.

Адрес TCP/IP сокета в точечной десятичной записи, возвращенной как строка.

Пример: v.IPAddress возвращает IP-адрес сокета.

Типы данных: string

Это свойство доступно только для чтения.

Номер порта для данного адреса TCP/IP, возвращенного как строка.

Пример: v.Port возвращает номер порта, сопоставленный с адресом TCP/IP.

Типы данных: string

Свойства VISA-USB

развернуть все

Это свойство доступно только для чтения.

Идентификационный номер производителя устройства (VID), возвращенный как строка.

Пример: v.VendorID возвращает ID поставщика.

Типы данных: string

Это свойство доступно только для чтения.

Типовой кодекс устройства (ПИД), возвращенный как строка.

Пример: v.ProductID возвращает идентификатор продукта.

Типы данных: string

Это свойство доступно только для чтения.

Номер платы USB, возвращенный как положительное целочисленное значение.

Пример: v.BoardIndex возвращает номер платы USB.

Типы данных: double

Это свойство доступно только для чтения.

Номер интерфейса USB, возвращенный как положительное целочисленное значение.

Пример: v.InterfaceIndex возвращает номер интерфейса USB.

Типы данных: double

Свойства VISA-GPIB

развернуть все

Это свойство доступно только для чтения.

Параметр плат GPIB, возвращенный как положительное целочисленное значение.

Пример: v.BoardIndex возвращает параметр плат GPIB.

Типы данных: double

Это свойство доступно только для чтения.

GPIB первичный адрес, сопоставленный с инструментом, возвращенным как целое число от 0 до 30, включительно.

Пример: v.PrimaryAddress возвращает GPIB первичный адрес.

Типы данных: double

Это свойство доступно только для чтения.

GPIB вторичный адрес, сопоставленный с инструментом, возвращенным как целое число от 0 до 30, включительно.

Пример: v.SecondaryAddress возвращает GPIB вторичный адрес.

Типы данных: double

Режим EOI, возвращенный как on или off. Это свойство задает, утверждается ли EOI (заканчивают или идентифицируют) линия в конце операции записи.

Пример: v.EOIMode = "off" не утверждает линию EOI в конце записи.

Типы данных: char | string

Последовательный ВИЗОЙ

развернуть все

Это свойство доступно только для чтения.

Последовательный порт, возвращенный как строка.

Пример: v.Port возвращает последовательный порт.

Типы данных: string

Скорость последовательной передачи в битах в секунду, возвращенных как положительное целое число.

Пример: v.BaudRate = 14400 устанавливает скорость в бодах на 14 400.

Типы данных: double

Количество битов, чтобы представлять один символ данных, возвращенных как 8, 7, 6, или 5.

Пример: v.DataBits = 5 определяет номер битов данных к 5 битам.

Типы данных: double

Шаблон битов, который указывает на конец символа или целой передачи, возвратился как 1, 1.5, или 2. Это свойство зависит от значения DataBits свойство можно следующим образом.

Значение DataBitsПоддерживаемые значения StopBits
8, 7, или 61 и 2
51 и 1.5

Пример: v.StopBits = 2 определяет номер стоп-битов к 2.

Типы данных: double

Тип бита четности, добавленный к данным, переданным последовательным портом, возвращенным как "none", "even", или "odd". Можно использовать это свойство добавить бит четности (также называемый контрольным битом) к данным. Добавление бита четности к строке двоичного кода является методом обнаружения ошибок в передаче данных путем гарантирования, что общее количество 1 бита является четным или нечетное.

Значение бита четности определяется числом единиц в данном наборе битов и установлено можно следующим образом.

Тип бита четностиЗначение бита четности
Если число единиц является четнымЕсли число единиц является нечетным
noneНикакой бит четности не установленНикакой бит четности не установлен
even01
odd10

Пример: v.Parity = "even" устанавливает тип бита четности на даже.

Типы данных: char | string

Режим для уровня передачи данных управления, возвращенного как "none", "hardware", или "software". Задайте "none" не иметь никакого управления потоками, "hardware" позволять вашему оборудованию определить управление потоками и "software" позволять вашему программному обеспечению определить управление потоками.

Пример: v.FlowControl = "hardware" устанавливает управление потоками на оборудование.

Типы данных: char | string

VISA-VXI и свойства VISA-PXI

развернуть все

Это свойство доступно только для чтения.

Номер шины PCI для устройства, возвращенного как положительное число. Это свойство только для объектов интерфейса VISA-PXI.

Пример: v.Bus возвращает номер шины PCI устройства.

Типы данных: double

Это свойство доступно только для чтения.

Номер устройства PXI, возвращенный как положительное число. Это свойство только для объектов интерфейса VISA-PXI.

Пример: v.DeviceIndex возвращает номер устройства PXI.

Типы данных: double

Это свойство доступно только для чтения.

Номер функции PXI, возвращенный как положительное число. Это свойство только для объектов интерфейса VISA-PXI.

Пример: v.FunctionIndex возвращает номер функции PXI.

Типы данных: double

Это свойство доступно только для чтения.

PXI или индекс шасси VXI, возвращенный как положительное число.

Пример: v.ChassisIndex возвращает PXI или индекс шасси VXI.

Типы данных: double

Это свойство доступно только для чтения.

Инструмент VXI логический адрес, возвращенный как положительное число. Это свойство только для объектов интерфейса VISA-VXI.

Пример: v.LogicalAddress возвращает инструмент VXI логический адрес.

Типы данных: double

Это свойство доступно только для чтения.

PXI или инструментальное местоположение слота VXI, возвращенное как положительное число.

Пример: v.Slot возвращает PXI или инструментальное местоположение слота VXI.

Типы данных: double

Режим EOI, возвращенный как on или off. Это свойство задает, утверждается ли EOI (заканчивают или идентифицируют) линия в конце операции записи.

Пример: v.EOIMode = "off" не утверждает линию EOI в конце записи.

Типы данных: char | string

Смотрите также

| | |

Внешние веб-сайты

Введенный в R2021a
Для просмотра документации необходимо авторизоваться на сайте