Доступ к свойствам ресурса 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 сокет |
| Имя удаленного хоста или 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 до 255Символ терминатора для чтения и записи данных, завершенных 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 - Функция обратного вызова, инициируемая событием доступности байтовФункция обратного вызова, инициируемая событием доступности байтов, возвращается как дескриптор функции. Событие доступности байтов генерируется путем приема определенного количества байтов или терминатора. Это свойство остается пустым до тех пор, пока не будет назначен дескриптор функции. Задайте это свойство с помощью 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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.