Доступ к свойствам ресурса VISA
Сконфигурируйте свой ресурс VISA и его коммуникационные настройки с помощью его свойств. После того, как вы создаете a 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 |
| ID производителя инструмента 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
— Модель InstrumentЭто свойство доступно только для чтения.
Модель Instrument, возвращенная как вектор символов или строковый скаляр. Это свойство пусто, если тип интерфейса VISA не предоставляет информацию о модели.
Пример: v.Model
возвращает имя инструментальной модели.
Типы данных: string
SerialNumber
— Уникальный порядковый номер сопоставлен с инструментомЭто свойство доступно только для чтения.
Уникальный порядковый номер сопоставлен с инструментом, возвращенным как вектор символов или строковый скаляр. Это свойство пусто, если тип интерфейса VISA не предоставляет информацию о порядковом номере.
Пример: v.SerialNumber
возвращает инструментальный порядковый номер.
Типы данных: string
ByteOrder
— Последовательный порядок байтов"little-endian"
(значение по умолчанию) | "big-endian"
Последовательный порядок, в котором байты располагаются в большие численные значения, возвратился как "little-endian"
или "big-endian"
.
Пример: v.ByteOrder = "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
возвращает ID поставщика.
Типы данных: string
ProductID
— Типовой кодекс устройстваЭто свойство доступно только для чтения.
Типовой кодекс устройства (ПИД), возвращенный как строка.
Пример: 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 (заканчивают или идентифицируют) линия в конце операции записи.
Пример: v.EOIMode = "off"
не утверждает линию EOI в конце записи.
Типы данных: char |
string
Port
— Последовательный портЭто свойство доступно только для чтения.
Последовательный порт, возвращенный как строка.
Пример: v.Port
возвращает последовательный порт.
Типы данных: string
BaudRate
— Коммуникационная скоростьСкорость последовательной передачи в битах в секунду, возвращенных как положительное целое число.
Пример: v.BaudRate = 14400
устанавливает скорость в бодах на 14 400.
Типы данных: double
DataBits
— Количество битов, чтобы представлять один символ данных
(значение по умолчанию) | 7
| 6
| 5
Количество битов, чтобы представлять один символ данных, возвращенных как 8
, 7, 6
, или
5
.
Пример:
v.DataBits = 5
определяет номер битов данных к 5 битам.
Типы данных: double
StopBits
— Шаблон битов, который указывает на конец символа
(значение по умолчанию) | 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 бита является четным или нечетное.
Значение бита четности определяется числом единиц в данном наборе битов и установлено можно следующим образом.
Тип бита четности | Значение бита четности | |
---|---|---|
Если число единиц является четным | Если число единиц является нечетным | |
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 (заканчивают или идентифицируют) линия в конце операции записи.
Пример: v.EOIMode = "off"
не утверждает линию EOI в конце записи.
Типы данных: char |
string
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.