binblockwrite

Запись данных бинблока в инструмент

Синтаксис

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). Формат бинблока определяется как #<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, префиксируется к двоичному блоку.

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

headerformat является спецификацией преобразования строки , содержащей C. Спецификации преобразования состоят из символов % и символы преобразования d, i, o, u, x, X, f, e, E, g, G, c, и 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 не соединяется с прибором.

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

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

Примечание

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

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

расширить все

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

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

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

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

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

См. также

Функции

Свойства

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