User`s guide

readmat

Purpose Matrix of data from RTDX channel

Note Support for readmat on C5000 and C6000 processors will be

removed in a future version.

Syntax data = readmat(rx,channelname,'datatype',siz,timeout)

data = readmat(rx,channelname,'datatype',siz)

Description data = readmat(rx,channelname,'datatype',siz,timeout) reads

a matrix of d ata from an R TDX channel conﬁgured for read access.

datatype deﬁnes the type of data to read, and channelname speciﬁes

the queue to read.

readmat reads the desired data from the RT DX link

speciﬁed by

rx.

Before you read from a channel, open and enable the channel for read

access.

Replace

channelname with the string you speciﬁed when you opened

the desired channel.

channelname must identify a channel that you

deﬁned in the program loaded on the processor.

You cannot read data from a channel you have not opened and

conﬁgured for read access. If necessary, use the RT DX tools provided in

CCS IDE to determine which channels exist for the loaded program.

data contains a matrix whose dimensions are given by the input

argument vector

siz,wheresiz can be a vector of two or more e lements.

To operate properly, the number of elements in the output matrix

data

must be an integral number of channel messages.

When you omit the

timeout input argument, readmat re ads messages

from the speciﬁed channel until the output matrix is full or the global

timeout period speciﬁed in rx e lapses.

7-120