visadev Properties

Доступ к свойствам ресурса 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 Socket

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

Terminator символа для чтения и записи данных, оконечных по 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