Доступ к свойствам ресурса 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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.