Embedded IDE Link™ CC

configure - Define size and number of RTDX™ channel buffers

Syntax

configure(rx,length,num)

Description

configure(rx,length,num) sets the size of each main (host) buffer, and the number of buffers associated with rx. Input argument length is the size in bytes of each channel buffer and num is the number of channel buffers to create.

Main buffers must be at least 1024 bytes, with the maximum defined by the largest message. On 16-bit processors, the main buffer must be four bytes larger than the largest message. On 32-bit processors, set the buffer to be eight bytes larger that the largest message. By default, configure creates four, 1024-byte buffers. Independent of the value of num, CCS IDE allocates one buffer for each processor.

Use CCS to check the number of buffers and the length of each one.

Examples

Create a default link to CCS and configure six main buffers of 4096 bytes each for the link.

 cc=ticcs            % Create the CCS link with default values.

TICCS Object:
  API version      : 1.0
  Processor type   : C67
  Processor name   : CPU
  Running?         : No
  Board number     : 0
  Processor number : 0
  Default timeout  : 10.00 secs

  RTDX channels    : 0

rx=cc.rtdx              % Create an alias to the rtdx portion.

RTDX channels    : 0

configure(rx,4096,6)  % Use the alias rx to configure the length 
                      % and number of buffers.

After you configure the buffers, use the RTDX tools in CCS IDE to verify the buffers.

See Also

readmat, readmsg, write, writemsg

close

convert