exponenta event banner

Свойства visadev

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

Настройте ресурс VISA и его параметры связи, используя его свойства. После создания 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

Идентификатор производителя прибора 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

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

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

Пример: v.Model возвращает имя модели прибора.

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

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

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

Пример: v.SerialNumber возвращает серийный номер прибора.

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

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

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

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

Пример: v.ByteOrder = "big-endian" устанавливает порядок байтов 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

Разъем VISA

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

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

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

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

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

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

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

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

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

Свойства VISA-USB

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

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

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

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

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

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

Код модели устройства (PID), возвращаемый в виде строки.

Пример: 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 (end или identify) в конце операции записи.

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

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

Серийный номер VISA

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

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

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

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

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

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

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

Типы данных: 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-разрядных является четным или нечетным.

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

Тип бита четностиЗначение бита четности
Если число 1 является четнымЕсли число 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 (end или identify) в конце операции записи.

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

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

Представлен в R2021a