Документация

Асинхронные операции чтения

Для объектов последовательного порта вы задаете, являются ли операции чтения синхронными или асинхронными со свойством ReadAsyncMode. Можно сконфигурировать ReadAsyncMode к continuous или manual.

Если ReadAsyncMode является continuous (значение по умолчанию), объект последовательного порта постоянно запрашивает инструмент, чтобы определить, доступны ли данные, чтобы быть считанными. Если данные доступны, они асинхронно хранятся во входном буфере. Чтобы передать данные от входного буфера до рабочего пространства MATLAB, вы используете один из синхронных (блокирование) функции чтения, такие как fgetl, fgets, fscanf или fread. Если данные будут доступны во входном буфере, эти функции возвратятся быстро.

s = serial('COM1');
fopen(s)
s.ReadAsyncMode = 'continuous';
fprintf(s,'*IDN?')
s.BytesAvailable
ans =
    56
out = fscanf(s);

Если ReadAsyncMode является manual, объект последовательного порта постоянно не запрашивает инструмент, чтобы определить, доступны ли данные, чтобы быть считанными. Чтобы считать данные асинхронно, вы используете функцию readasync. Вы затем используете одну из синхронных функций чтения, чтобы передать данные от входного буфера до рабочего пространства MATLAB.

s.ReadAsyncMode = 'manual';
fprintf(s,'*IDN?')
s.BytesAvailable
ans =
    0
readasync(s)
s.BytesAvailable
ans =
    56
out = fscanf(s);

Запись и чтение асинхронных данных

Этот пример исследует асинхронные операции чтения и операции записи с помощью объекта последовательного порта. Используемый инструмент был осциллографом Tektronix(R) TDS 210.

Чтобы начаться, создайте объект последовательного порта, сопоставленный с портом COM1. Осциллограф сконфигурирован к скорости в бодах 9 600, 1 стоп-бит, терминатор строки перевода строки, никакая четность и никакое управление потоками.

s = serial('COM1');
s.Baudrate=9600;
s.StopBits=1;
s.Terminator='LF';
s.Parity='none';
s.FlowControl='none';

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

fopen(s);

Если объект был успешно соединен, его свойство Status автоматически сконфигурировано к open.

s.Status

ans = 
    open

Чтобы начаться, считывайте данные постоянно.

s.ReadAsyncMode='continuous';

Теперь, запросите инструмент для пика к пиковому значению сигнала на канале 1.

fprintf(s, 'Measurement:Meas1:Source CH1');
fprintf(s, 'Measurement:Meas1:Type Pk2Pk');
fprintf(s, 'Measurement:Meas1:Value?');

Позвольте время для ответа. В типовом приложении это - то, где вы могли сделать другие задачи.

pause(0.5);

Поскольку свойство ReadAsyncMode установлено в continuous, объект постоянно спрашивает инструмент, если какие-либо данные доступны. Если последняя функция fprintf завершается, инструмент начинает отправлять данные; данные считаны из инструмента и хранятся во входном буфере.

s.BytesAvailable

ans =
    14

Можно принести данные из входного буфера объекта в рабочее пространство MATLAB с fscanf.

data = fscanf(s)

data =
    5.99999987E-2

Затем, считайте данные вручную.

s.ReadAsyncMode='manual';

Теперь, запросите инструмент для частоты сигнала на канале 1.

fprintf(s, 'Measurement:Meas2:Source CH1');
fprintf(s, 'Measurement:Meas2:Type Freq');
fprintf(s, 'Measurement:Meas2:Value?');

Позвольте время для ответа. В типовом приложении это - то, где вы могли сделать другие задачи.

pause(0.5);

Если последняя функция fprintf завершается, инструмент начинает отправлять данные. Однако, поскольку ReadAsyncMode установлен в manual, объект не считывает данные, отправляемые от инструмента. Поэтому никакие данные не считываются и помещаются во входной буфер.

s.BytesAvailable

ans =
     0

Считайте данные.

readasync(s);

Позвольте время для ответа.

pause(0.5);

Важно помнить, что, когда объект последовательного порта находится в ручном режиме (свойство ReadAsyncMode сконфигурировано к manual), данные, которые отправляются с инструмента на компьютер, не автоматически хранимы во входном буфере связанного объекта последовательного порта. Данные не хранимы до readasync или одной из функций чтения блокирования называется.

Ручной режим должен использоваться, когда поток данных отправляется от вашего инструмента, и вы только хотите получить фрагменты данных.

Определение асинхронного коллбэка чтения

При продолжении примера от предыдущего раздела сконфигурируйте последовательный объект уведомить вас, когда терминатор строки будет считан.

s.ReadAsyncMode='continuous';
s.BytesAvailableFcn={'dispcallback'};

Отметьте, значение по умолчанию для свойства BytesAvailableFcnMode указывает, что функция обратного вызова, заданная свойством BytesAvailableFcn, будет выполняться, когда терминатор строки был считан.

s.BytesAvailableFcnMode

ans =
    terminator

Функция dispcallback отображает сообщение, содержащее тип события, имя объекта, который заставил событие происходить, и время, которое имело место событие.

 callbackTime = datestr(datenum(event.Data.AbsTime));
 fprintf(['A ' event.Type ' event occurred for ' obj.Name ' at ' 
     callbackTime '.\n']);

Запросите инструмент в течение периода сигнала на канале 1. Если терминатор строки читается из инструмента и помещается во входной буфер, dispcallback выполняется, и сообщение добавлено к окну команды MATLAB, указывающему, что событие BytesAvailable имело место.

fprintf(s, 'Measurement:Meas3:Source CH1')
fprintf(s, 'Measurement:Meas3:Type Period')
fprintf(s, 'Measurement:Meas3:Value?')

Позвольте время для ответа.

pause(0.5);

A BytesAvailable event occurred for Serial-COM1 at <date and time>.

s.BytesAvailable

ans =
    7

data = fscanf(s, '%c', 10)

data =

    2.0E-6

Обратите внимание на то, что последнее чтение значения является переводом строки (10).

Теперь предположите, что на полпути посредством асинхронной операции чтения, вы понимаете, что сигнал, отображенный на осциллографе, был неправильным. Вместо того, чтобы ожидать асинхронной операции, чтобы завершиться, можно использовать функцию stopasync, чтобы остановить асинхронное чтение. Обратите внимание на то, что, если бы асинхронная запись происходила, асинхронная операция записи была бы также остановлена.

s.BytesAvailableFcn='';
fprintf(s, 'Curve?');
pause(0.25);
S.BytesAvailable

ans =
    126

stopasync(s);
s.BytesAvailable

ans =
    262

Данные, которые были считаны из инструмента, остаются во входном буфере. Можно использовать одну из синхронных функций чтения, чтобы принести эти данные в рабочее пространство MATLAB. Однако, поскольку эти данные представляют неправильный сигнал, функция flushinput вызвана, чтобы удалить все данные из входного буфера.

flushinput(s);
s.BytesAvailable

ans =
    0

Можно выполнить асинхронную запись с fprintf или функциями fwrite путем передачи 'async' как последнего входного параметра.

fprintf(s, 'Measurement:Meas3:Value?', 'async')

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

fclose(s);
delete(s);
clear s

Завершение операций записи

Операция записи с помощью fprintf или fwrite завершается, когда одно из этих условий удовлетворено:

В дополнение к этим правилам можно остановить асинхронную операцию записи в любое время с функцией stopasync.

Текстовая команда обрабатывается инструментом только, когда это получает необходимый терминатор строки. Для объектов последовательного порта каждое вхождение \n в команде ASCII заменяется значением свойства Terminator. Поскольку форматом по умолчанию для fprintf является %s\n, все команды, записанные в инструмент, закончатся значением Terminator. Значение по умолчанию Terminator является символом перевода строки. Терминатор строки, требуемый вашим инструментом, будет описан в его документации.

Завершение операций чтения

Операция чтения с fgetl, fgets, fscanf или readasync завершается, когда одно из этих условий удовлетворено:

Операция чтения с fread завершается, когда одно из этих условий удовлетворено:

В дополнение к этим правилам можно остановить асинхронную операцию чтения в любое время с функцией stopasync.

Функции и свойства

Эти функции используются при чтении и записи двоичных данных:

Эти свойства сопоставлены с чтением и записью двоичных данных:

Конфигурирование и соединение с последовательным объектом

Необходимо создать последовательный объект. В этом примере создайте объект последовательного порта, сопоставленный с портом COM1.

s = serial('COM1');

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

fopen(s)

Если объект был успешно соединен, его свойство Status автоматически сконфигурировано к open.

s.Status

ans = 
    open

Запись двоичных данных

Вы используете функцию fwrite, чтобы записать двоичные данные в инструмент. По умолчанию функция fwrite действует в синхронном режиме. Это означает, что fwrite блокирует командную строку MATLAB, пока одно из следующего не происходит:

По умолчанию функция fwrite пишет двоичные данные с помощью точности uchar. Однако другая точность может также использоваться. Для списка поддерживаемой точности смотрите страницу ссылки на функцию для fwrite.

Бинарные свойства записи

Свойство OutputBufferSize задает максимальное количество байтов, которые могут быть записаны в инструмент целиком. По умолчанию OutputBufferSize является 512.

s.OutputBufferSize

ans = 
    512

Если команда, заданная в fwrite, содержит больше чем 512 байтов, ошибка возвращена, и никакие данные не записаны в инструмент.

Сконфигурируйте размер буфера вывода объекта к 3 000. Отметьте, OutputBufferSize может быть сконфигурирован только, когда объект не соединяется с инструментом.

fclose(s);
s.OutputBufferSize = 3000;
fopen(s);

Свойство ValuesSent указывает на общее количество значений, записанных в инструмент, поскольку объект был соединен с инструментом.

s.ValuesSent

ans = 
    581

Запись двоичные данные Int16

Запишите форму волны как массив int16.

fwrite(s, 'Data:Destination RefB');
fwrite(s, 'Data:Encdg SRPbinary');
fwrite(s, 'Data:Width 2');
fwrite(s, 'Data:Start 1');

t = (0:499) .* 8 * pi / 500;
data = round(sin(t) * 90 + 127);
fwrite(s, 'CURVE #3500');

Обратите внимание на то, что одно значение int16 состоит из двух байтов. Поэтому следующая команда запишет 1 000 байтов.

fwrite(s, data, 'int16')

Чтение двоичных данных

Вы используете функцию fread, чтобы считать двоичные данные из инструмента.

Функциональные блоки fread командная строка MATLAB до одного из следующего происходят:

По умолчанию функция fread считывает двоичные данные с помощью точности uchar. Однако другая точность может также использоваться. Для списка поддерживаемой точности смотрите страницу ссылки на функцию для fread.

Бинарные свойства чтения

Свойство InputBufferSize задает максимальное количество байтов, которые могут быть считаны из инструмента целиком. По умолчанию InputBufferSize является 512.

s.InputBufferSize

ans = 
    512

Свойство ValuesReceived указывает на общее количество значений, считанных из инструмента.

s.ValuesReceived

ans = 
    256

Чтение int16 Двоичные данные

Считайте ту же форму волны на канале 1 как массив int16.

fread(s, 'Data:Source CH1');
fread(s, 'Data:Encdg SRPbinary');
fread(s, 'Data:Width 2');
fread(s, 'Data:Start 1');
fread(s, 'Data:Stop 2500');
fread(s, 'Curve?')

Обратите внимание на то, что одно значение int16 состоит из двух байтов. Поэтому следующая команда считает 512 байтов.

data = fread(s, 256, 'int16'):

Очистка

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

fclose(s)
delete(s)
clear s