Доступ к свойствам ресурса VISA
Настройте свой ресурс VISA и его параметры связи с помощью его свойств. После того, как вы создадите visadev объект, вы можете использовать запись через точку, чтобы считать и задать свойства.
ResourceName - Имя ресурса VISAИмя ресурса VISA, возвращенное как строковый скаляр. Идентифицируйте имя ресурса устройства, к которому вы хотите подключиться, используя информацию, возвращенную visadevlist. Это свойство может быть задано только при создании объекта.
Каждый тип интерфейса VISA имеет разный формат, описанный в следующей таблице. Формат имени ресурса VISA и его параметры определяются стандартными спецификациями VISA. Замените курсивный текст значениями для заданных параметров. Параметры в скобках являются необязательными.
Интерфейс | Имя ресурса |
|---|---|
| TCP/IP (использование VXI-11 или HiSLIP) | TCPIP[board]::remote_host[::lan_device_name]::INSTR |
| Разъем TCP/IP |
|
| USB | USB[board]::vendor_ID::product_ID::serial_number[::interface_number]::INSTR |
| GPIB | GPIB[board]::primary_address[::secondary_address]::INSTR |
| Последовательный | ASRL[port_number]::INSTR |
| VXI | VXI[chassis]::VXI_logical_address::INSTR |
| PXI |
|
Параметры имени ресурса описываются следующим образом. Каждый параметр соответствует одному из visadev свойства.
| Интерфейс | Параметр | Описание |
|---|---|---|
| Все |
| Индекс платы (значение по умолчанию 0) |
| TCP/IP (с использованием VXI-11 или HiSLIP) и TCP/IP Socket |
| Имя удаленного хоста или IP-адрес инструмента |
| Имя устройства локальной сети (LAN) (значение по умолчанию inst0) | |
| Порт удаленного хоста для разъема TCP/IP | |
| USB |
| Идентификатор производителя USB-прибора |
| Модельный код для USB-инструмента | |
| Индекс инструмента на концентраторе USB | |
| Интерфейс USB | |
| GPIB |
| Первичный адрес прибора GPIB |
| Вторичный адрес инструмента GPIB (значение по умолчанию 0) | |
| Последовательный |
| Серийный номер порта (значение по умолчанию 1) |
| VXI и PXI |
| VXI или PXI индекс шасси (значение по умолчанию 0 для VXI) |
| Логический адрес прибора VXI | |
| Номер шины PCI | |
| Номер устройства PCI | |
| Номер функции PCI (значение по умолчанию 0) | |
| Номер паз |
Пример:
gpibdev = visadev("GPIB0::5::INSTR") соединяется с устройством GPIB, заданным именем ресурса VISA GPIB0::5::INSTR.
Типы данных: char | string
Alias - псевдоним VISA, сопоставленный с ресурсомПсевдоним VISA, сопоставленный с ресурсом, возвращается как строковый скаляр. Идентифицируйте псевдоним устройства, к которому вы хотите подключиться, используя информацию, возвращенную visadevlist. Псевдоним определяется в утилите строения поставщика VISA. Это свойство может быть задано только при создании объекта.
Пример: serialdev = visadev("COM4") соединяется с последовательным устройством, заданным псевдонимом ресурса VISA COM4.
Типы данных: char | string
Type - Тип ресурса VISAgpib | pxi | serial | socket | tcpip | usb | vxiЭто свойство доступно только для чтения.
Тип ресурса VISA, возвращенный как один из поддерживаемых интерфейсов VISA. Некоторые свойства и функции объекта специфичны для типа интерфейса.
Пример: v.Type возвращает тип ресурса VISA.
Vendor - Изготовитель приборовЭто свойство доступно только для чтения.
Производитель приборов, возвращается как вектор символов или строковый скаляр. Это свойство пустое, если тип интерфейса VISA не предоставляет информацию о производителе.
Пример: v.Vendor возвращает имя производителя приборов.
Типы данных: string
Model - Модель КИПиАЭто свойство доступно только для чтения.
Модель инструмента, возвращенная как вектор символов или строковый скаляр. Это свойство пустое, если тип интерфейса VISA не предоставляет информацию о модели.
Пример: v.Model возвращает имя модели прибора.
Типы данных: string
SerialNumber - Уникальный серийный номер, сопоставленный с приборомЭто свойство доступно только для чтения.
Уникальный серийный номер, сопоставленный с инструментом, возвращается как вектор символов или строковый скаляр. Это свойство пустое, если тип интерфейса VISA не предоставляет информацию о серийном номере.
Пример: v.SerialNumber возвращает серийный номер прибора.
Типы данных: string
ByteOrder - Последовательный порядок байтов"little-endian" (по умолчанию) | "big-endian"Последовательный порядок, в котором байты упорядочены в большие числовые значения, возвращается как "little-endian" или "big-endian".
Пример: v.ByteOrder = "big-endian" устанавливает порядок байтов на big-endian.
Типы данных: char | string
Timeout - Предоставленное время для выполнения операцийДопустимое время в секундах для завершения операций чтения и записи, возвращаемое как числовое значение.
Пример: v.Timeout = 20 устанавливает период ожидания 20 секунд.
Типы данных: double
Terminator - Символ терминатора для данных"LF" (по умолчанию) | "CR" | "CR/LF" | 0 по 255Terminator символа для чтения и записи данных, оконечных по ASCII, возвращается как "LF", "CR", "CR/LF"или число от 0 до 255 включительно. Если терминаторы строки чтения и записи отличаются, Terminator возвращается как массив ячеек 1x2 из этих значений. Установите это свойство с configureTerminator функция.
Пример: configureTerminator(v,"CR") устанавливает и чтение, и запись терминаторов строки равной "CR".
Пример: configureTerminator(v,"CR",10) устанавливает терминатор строки считывания равным "CR" и терминатор строки записи в 10.
Типы данных: double | char | string
NumBytesAvailable - Количество байтов, доступных для чтенияЭто свойство доступно только для чтения.
Количество байтов, доступных для чтения, возвращаемое в виде числового значения.
Пример:
v.NumBytesAvailable возвращает количество байтов, доступных для чтения.
Типы данных: double
NumBytesWritten - Общее количество записанных байтовЭто свойство доступно только для чтения.
Общее количество записанных байтов, возвращенных в виде числового значения.
Пример:
v.NumBytesWritten возвращает количество записанных байтов.
Типы данных: double
BytesAvailableFcnMode - Доступный режим триггера коллбэка в байтах"off" (по умолчанию) | "byte" | "terminator"Доступный режим триггера коллбэка в байтах, возвращается следующим "off", "byte", или "terminator". Этот параметр определяет, отключен ли коллбэк, вызванный количеством байтов, заданным BytesAvailableFcnCount, или инициируется терминатором строки, заданным как Terminator. Установите это свойство с configureCallback функция.
Пример:
configureCallback(v,"byte",50,@callbackFcn) устанавливает callbackFcn коллбэк, чтобы инициировать каждый раз, когда доступно 50 байт новых данных для чтения.
Пример: configureCallback(v,"terminator",@callbackFcn) устанавливает callbackFcn Коллбэк для запуска, когда терминатор строки доступен для чтения.
Пример: configureCallback(v,"off") отключает коллбэки.
Типы данных: char | string
BytesAvailableFcnCount - Количество байтов данных для запуска коллбэкаКоличество байтов данных для запуска коллбэков, заданное как BytesAvailableFcn, вернулся в качестве дубля. Это значение используется только когда BytesAvailableFcnMode свойство "byte". Установите эти свойства с configureCallback функция.
Пример:
configureCallback(v,"byte",50,@callbackFcn) устанавливает callbackFcn коллбэк, чтобы инициировать каждый раз, когда доступно 50 байт новых данных для чтения.
Типы данных: double
BytesAvailableFcn - Функция обратного вызова, инициируемая событием bytes availableФункция обратного вызова, инициируемая событием, доступным в байтах, возвращаемая как указатель на функцию. Событие, доступное в байтах, генерируется путем приема определенного количества байтов или терминатора строки. Это свойство пустое, пока вы не назначите указатель на функцию. Установите это свойство с configureCallback функция.
Пример:
configureCallback(v,"byte",50,@callbackFcn) устанавливает callbackFcn коллбэк, чтобы инициировать каждый раз, когда доступно 50 байт новых данных для чтения.
Типы данных: function_handle
ErrorOccurredFcn - Функция обратного вызова, вызванная событием ошибкиФункция обратного вызова, вызванная событием ошибки, возвращается как указатель на функцию. Событие ошибки генерируется, когда подключение к ресурсу VISA прерывается или когда происходит асинхронная ошибка чтения. Это свойство пустое, пока вы не назначите указатель на функцию.
Пример:
v.ErrorOccurredFcn = @myErrorFcn
Типы данных: function_handle
UserData - Свойство общего назначения для пользовательских данныхСвойство общего назначения для пользовательских данных, возвращаемое как любой MATLAB® тип данных. Для примера можно использовать это свойство для хранения данных, когда событие запускается из функции обратного вызова.
Пример:
v.UserData
LANName - имя устройства LANЭто свойство доступно только для чтения.
Имя устройства LAN, возвращенное как строка.
Пример: v.LANName возвращает имя устройства LAN.
Типы данных: string
InstrumentAddress - TCP/IP адрес прибораЭто свойство доступно только для чтения.
TCP/IP-адрес инструмента в десятичной записи через точку, возвращаемый как строка.
Пример: v.InstrumentAddress возвращает IP-адрес прибора.
Типы данных: string
BoardIndex - Индексный номер сетевой платы, сопоставленной с приборомЭто свойство доступно только для чтения.
Номер индекса сетевой платы, сопоставленной с прибором, возвращенный как положительное целое значение.
Пример: v.BoardIndex возвращает номер индекса сетевой платы.
Типы данных: double
IPAddress - TCP/IP адрес сокетаЭто свойство доступно только для чтения.
TCP/IP-адрес сокета в десятичной записи через точку, возвращаемый как строка.
Пример: v.IPAddress возвращает IP-адрес сокета.
Типы данных: string
Port - Номер порта для заданного адреса TCP/IPЭто свойство доступно только для чтения.
Номер порта для заданного адреса TCP/IP, возвращаемый как строка.
Пример: v.Port возвращает номер порта, сопоставленный с TCP/IP-адресом.
Типы данных: string
VendorID - Идентификационный номер изготовителя устройстваЭто свойство доступно только для чтения.
Идентификационный номер производителя устройства (VID), возвращенный как строка.
Пример: v.VendorID возвращает идентификатор поставщика.
Типы данных: string
ProductID - Модель кода устройстваЭто свойство доступно только для чтения.
Моделируйте код устройства (PID), возвращаемый как строка.
Пример: v.ProductID возвращает идентификатор продукта.
Типы данных: string
BoardIndex - Номер платы USBЭто свойство доступно только для чтения.
Номер платы USB, возвращенный в виде положительного целого значения.
Пример: v.BoardIndex возвращает номер платы USB.
Типы данных: double
InterfaceIndex - Номер интерфейса USBЭто свойство доступно только для чтения.
Номер интерфейса USB, возвращенный в виде положительного целого значения.
Пример: v.InterfaceIndex возвращает номер интерфейса USB.
Типы данных: double
BoardIndex - индекс платы GPIBЭто свойство доступно только для чтения.
Индекс платы GPIB, возвращенный как положительное целое значение.
Пример: v.BoardIndex возвращает индекс платы GPIB.
Типы данных: double
PrimaryAddress - Основной адрес GPIBЭто свойство доступно только для чтения.
Основной адрес GPIB, сопоставленный с инструментом, возвращается в виде целого числа от 0 до 30 включительно.
Пример: v.PrimaryAddress возвращает основной адрес GPIB.
Типы данных: double
SecondaryAddress - вторичный адрес GPIBЭто свойство доступно только для чтения.
Вторичный адрес GPIB, сопоставленный с инструментом, возвращается в виде целого числа от 0 до 30 включительно.
Пример: v.SecondaryAddress возвращает дополнительный адрес GPIB.
Типы данных: double
EOIMode - Режим EOI"on" (по умолчанию) | "off"Режим EOI, возвращенный как on или off. Это свойство определяет, задана ли линия EOI (end или identify) в конце операции записи.
Пример: v.EOIMode = "off" не устанавливает линию EOI в конце записи.
Типы данных: char | string
Port - Последовательный порт связиЭто свойство доступно только для чтения.
Последовательный порт связи, возвращенный как строка.
Пример: v.Port возвращает последовательный порт связи.
Типы данных: string
BaudRate - Скорость связиСкорость последовательной передачи в битах в секунду, возвращаемая как положительное целое число.
Пример: v.BaudRate = 14400 устанавливает скорость передачи 14400 бод.
Типы данных: double
DataBits - Количество битов для представления одного символа данных8 (по умолчанию) | 7 | 6 | 5Количество бит для представления одного символа данных, возвращаемое как 8, 7, 6, или 5.
Пример:
v.DataBits = 5 устанавливает количество битов данных в 5 битах.
Типы данных: double
StopBits - Шаблон битов, который указывает конец символа1 (по умолчанию) | 1.5 | 2Шаблон бит, который указывает конец символа или всей передачи, возвращенный как 1, 1.5, или 2. Это свойство зависит от значения DataBits свойство следующим образом.
Значение DataBits | Поддерживаемые значения StopBits |
|---|---|
8, 7, или 6 | 1 и 2 |
5 | 1 и 1.5 |
Пример:
v.StopBits = 2 устанавливает количество стоп-бит равным 2.
Типы данных: double
Parity - Тип бита четности"none" (по умолчанию) | "even" | "odd"Тип бита четности, добавленный к данным, переданным последовательным портом, возвращается следующим "none", "even", или "odd". Вы можете использовать это свойство для добавления бита четности (также называемого контрольным битом) к вашим данным. Добавление бита четности к строке двоичного кода является методом обнаружения ошибок в передаче данных путем обеспечения того, что общее количество 1-битов четное или нечетное.
Значение бита четности определяется количеством 1с в заданном наборе бит и устанавливается следующим образом.
| Тип бита четности | Значение бита четности | |
|---|---|---|
| Если количество 1с четно | Если количество 1с нечетно | |
none | Бит четности отсутствует | Бит четности отсутствует |
even | 0 | 1 |
odd | 1 | 0 |
Пример: v.Parity = "even" устанавливает тип бита четности на четный.
Типы данных: char | string
FlowControl - Режим управления скоростью передачи данных"none" (по умолчанию) | "hardware" | "software"Режим управления скоростью передачи данных, возвращенный как "none", "hardware", или "software". Задайте "none" не иметь управления потоком, "hardware" чтобы ваше оборудование определяли управление потоком и "software" чтобы позволить вашему программному обеспечению определить управление потоком.
Пример: v.FlowControl = "hardware" устанавливает управление потоком на оборудование.
Типы данных: char | string
Bus - номер шины PCIЭто свойство доступно только для чтения.
Номер шины PCI для устройства, возвращенный как положительное число. Это свойство предназначено только для объектов интерфейса VISA-PXI.
Пример: v.Bus возвращает номер шины PCI устройства.
Типы данных: double
DeviceIndex - Номер устройства PXIЭто свойство доступно только для чтения.
Номер устройства PXI, возвращенный в виде положительного числа. Это свойство предназначено только для объектов интерфейса VISA-PXI.
Пример: v.DeviceIndex возвращает номер устройства PXI.
Типы данных: double
FunctionIndex - номер функции PXIЭто свойство доступно только для чтения.
Номер функции PXI, возвращенный как положительное число. Это свойство предназначено только для объектов интерфейса VISA-PXI.
Пример: v.FunctionIndex возвращает номер функции PXI.
Типы данных: double
ChassisIndex - Номер индекса шасси PXI или VXIЭто свойство доступно только для чтения.
PXI или VXI номер индекса шасси, возвращенный в виде положительного числа.
Пример: v.ChassisIndex возвращает номер индекса корпуса PXI или VXI.
Типы данных: double
LogicalAddress - логический адрес прибора VXIЭто свойство доступно только для чтения.
Логический адрес прибора VXI, возвращенный в виде положительного числа. Это свойство предназначено только для объектов интерфейса VISA-VXI.
Пример: v.LogicalAddress возвращает логический адрес прибора VXI.
Типы данных: double
Slot - Расположение паза приборов PXI или VXIЭто свойство доступно только для чтения.
Паз прибора PXI или VXI, возвращаемое в виде положительного числа.
Пример: v.Slot возвращает местоположение паза прибора PXI или VXI.
Типы данных: double
EOIMode - Режим EOI"on" (по умолчанию) | "off"Режим EOI, возвращенный как on или off. Это свойство определяет, задана ли линия EOI (end или identify) в конце операции записи.
Пример: v.EOIMode = "off" не устанавливает линию EOI в конце записи.
Типы данных: char | string
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.