Exponenta Banner
exponenta event banner

(последовательный) fprintf

Запишите текст в устройство

Синтаксис

fprintf (obj, 'cmd')
fprintf (obj, 'format', 'cmd')
fprintf (obj, 'cmd', 'mode')
fprintf (obj, 'format', 'cmd', 'mode')

Описание

fprintf(obj,'cmd') пишет строке cmd в устройство, соединенное к объекту последовательного порта, obj. Форматом по умолчанию является %s\n. Операция записи синхронна и блокирует командную строку, пока выполнение не завершается. cmd может быть или командой SCPI, которую вы обеспечиваете, или команда, которую вы обеспечиваете на основе инструкций от вашего поставщика устройства.

fprintf(obj,'format','cmd') пишет строку с помощью формата, заданного format.

fprintf(obj,'cmd','mode') пишет строку с доступом из коммандной строки, заданным mode. mode задает, записан ли cmd синхронно или асинхронно.

fprintf(obj,'format','cmd','mode') пишет строку с помощью заданного формата. format является спецификацией преобразования языка C.

Вам нужна открытая связь от объекта последовательного порта, obj, к устройству прежде, чем выполнить операции чтения или операции записи.

Чтобы открыть связь с устройством, используйте функцию fopen. Когда obj имеет открытую связь с устройством, он имеет значение свойства Status open. Обратитесь к Распространенным ошибкам Поиска и устранения проблем для ошибок fprintf.

Чтобы понять использование fprintf, обратитесь к Завершению Операции записи с fprintf и Правилами для Записи Терминатора.

Входные параметры

формат

ANSI C спецификация преобразования включает эти символы преобразования.

Спецификатор

Описание

C

Отдельный символ

%d или %i

Десятичная запись (подписывается)

E

Экспоненциальное представление (использующий строчный e в качестве в 3.1415e+00)

E

Экспоненциальное представление (использующий прописной E в качестве в 3.1415E+00)

F

Представление с фиксированной точкой

G

Более компактный из %e или %f. Незначительные нули не распечатывают.

G

То же самое как %g, но использование прописного E

O

Восьмеричное обозначение (без знака)

S

Строка символов

U

Десятичная запись (без знака)

X

Шестнадцатеричное обозначение (использующий строчные буквы a –f)

X

Шестнадцатеричное обозначение (использующий прописные буквы A –F)

{cmd}

Задает строку cmd, который может быть или командой SCPI, которую вы обеспечиваете, или команда, которую вы обеспечиваете на основе инструкций от вашего поставщика устройства.

режим

Задает, записана ли строка cmd синхронно или асинхронно:

  • sync: cmd записан синхронно, и командная строка блокируется.

  • async: cmd записан асинхронно, и командная строка не блокируется.

Если mode не задан, операция записи синхронна.

Если вы задаете асинхронный mode, когда операция записи происходит:

  • Значение свойства BytesToOutput постоянно обновляет, чтобы отразить количество байтов в буфере вывода.

  • Функция обратного вызова файла MATLAB®, заданная для свойства OutputEmptyFcn, выполняется, когда буфер вывода пуст.

Чтобы определить, происходит ли асинхронная операция записи, используйте свойство TransferStatus.

Для получения дополнительной информации о синхронных и асинхронных операциях записи смотрите Запись и чтение данных.

Примеры

Создайте объект последовательного порта s и соедините его с осциллографом Tektronix TDS 210. Запишите команду RS232? с fprintf. RS232? дает осциллографу команду возвращать коммуникационные настройки последовательного порта. Этот пример работает на платформе Windows®.

s = serial('COM1');
fopen(s)
fprintf(s,'RS232?')

Задайте формат для данных, который не включает терминатор строки или конфигурирует терминатор строки, чтобы опустеть.

s = serial('COM1');
fopen(s)
fprintf(s,'%s','RS232?')

Форматом по умолчанию для fprintf является %s\n. Поэтому терминатор строки, заданный свойством Terminator, автоматически записан. Однако иногда вы можете хотеть подавить запись терминатора строки.

Задайте массив форматов и команд:

s = serial('COM1');
fopen(s)
fprintf(s,['ch:%d scale:%d'],[1 20e-3],'sync')

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

| | | | | | | |

Темы

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

Была ли эта тема полезной?
Документация MATLAB
Поддержка