binblockwrite

(Чтобы быть удаленным) Запись binblock данные к инструменту

Этот serial, Bluetooth, tcpip, udp, visa, и gpib объектная функция будет удалена в будущем релизе. Использование serialport, bluetooth, tcpclient, tcpserver, udpport, и visadev возразите функциям вместо этого. Для получения дополнительной информации см. Вопросы совместимости.

Синтаксис

binblockwrite(obj,A)
binblockwrite(obj,A,'precision')
binblockwrite(obj,A,'header')
binblockwrite(obj,A,'precision','header')
binblockwrite(obj,A,'precision','header','headerformat')

Аргументы

obj

Интерфейсный объект.

A

Данные, которые будут записаны с помощью binblock формата.

'precision'

Количество битов, записанных для каждого значения и интерпретации битов как символ, целое число или значения с плавающей точкой.

'header'

Текст заголовка ASCII, который будет снабжен префиксом к данным.

'headerformat'

Формат спецификации преобразования языка C для текста заголовка.

Описание

binblockwrite(obj,A) пишут данные, заданные A к инструменту, соединенному с obj как бинарный блок (binblock). binblock формат задан как #<N><D><A>, где

  • N задает количество цифр в D это следует.

  • D задает количество байтов данных в A это следует.

  • A данные, записанные в инструмент.

Например, если A дан [0 5 5 0 5 5 0], binblock был бы задан как [double('#') 1 7 0 5 5 0 5 5 0].

binblockwrite(obj,A,'precision') записи binblock данные, переводящие MATLAB® значения к точности заданы precision. По умолчанию uchar точность используется. Обратитесь к fwrite функция для списка поддерживаемой точности.

binblockwrite(obj,A,'header') пишет binblock использование данных, A, и заголовок ASCII, header, к инструменту, соединенному с интерфейсным объектом, obj. Записанные данные создаются с помощью формулы

<header>#<N><D><A>

binblockwrite(obj,A,'precision','header') двоичные данные записей, A, переводя значения MATLAB в заданную точность, precision. Заголовок ASCII, header, снабжается префиксом к binblock.

binblockwrite(obj,A,'precision','header','headerformat') двоичные данные записей, A, переводя значения MATLAB в заданную точность, precision. Заголовок ASCII, header, снабжается префиксом к binblock использование формата, заданного headerformat.

headerformat преобразование языка C строки, содержащей технические требования. Технические требования преобразования состоят из символьного % и символы преобразования diOUXXFEEGGC, и s. Введите instrhelp fprintf для получения дополнительной информации о допустимых значениях для headerformat. По умолчанию, headerformat %s.

Примеры

s = visa('ni', 'ASRL2::INSTR');
fopen(s);

% Write the command: [double('#14') 0 5 0 5] to the instrument.
binblockwrite(s, [0 5 0 5]);

% Write the command: [double('Curve #14') 0 5 0 5] to the 
% instrument.
binblockwrite(s, [0 5 0 5], 'Curve ')  
fclose(s);

Советы

Прежде чем можно будет записать данные к инструменту, он должен быть соединен с obj с fopen функция. Связанный интерфейсный объект имеет Status значение свойства open. Ошибка возвращена, при попытке выполнить операцию записи в то время как obj не соединяется с инструментом.

ValuesSent значение свойства увеличено на количество значений, записанных каждый раз binblockwrite выпущен.

Ошибка происходит, если буфер вывода не может содержать все данные, которые будут записаны. Можно задать размер буфера вывода с OutputBufferSize свойство.

Примечание

Чтобы получить список опций, можно использовать на функции, нажать клавишу Tab после ввода функции на командной строке MATLAB. Список расширяется, и можно прокрутить, чтобы выбрать свойство или значение. Для получения информации об использовании этой функции завершения вкладки "Дополнительно" смотрите Используя Заполнение клавишей Tab для Функций.

Вопросы совместимости

развернуть все

Не рекомендуемый запуск в R2019b

Не рекомендуемый запуск в R2020b

Не рекомендуемый запуск в R2020b

Не рекомендуемый запуск в R2020b

Не рекомендуемый запуск в R2021a

Не рекомендуемый запуск в R2021b

Смотрите также

Функции

Свойства

Представлено до R2006a