info - Information about processor

Syntax

adf=IDE_Obj.info adf=IDE_Obj.info adf=info(rx) adf=IDE_Obj.info adf=info(rx)

IDEs

This function supports the following IDEs:

Analog Devices VisualDSP++
Green Hills MULTI
Texas Instruments Code Composer Studio v3

Description

adf=IDE_Obj.info returns debugger or processor properties associated with the IDE handle object, IDE_Obj.

Using info with Multiprocessor Boards

For multiprocessor targets, the info method returns properties for each processor with the array.

Examples

Using info with IDE_Obj, which is associated with 1 processor:

oinfo = IDE_Obj.info;

Using info with IDE_Obj, which is associated with 2 processors:

oinfo = IDE_Obj.info; % Returns a 1x2 array of infor struct

Using info with MULTI IDE

Before using info, open a program in the MULTI IDE debugger. When you use info with an IDE handle object for the MULTI IDE, the info method returns the following information.

Structure Element	Data Type	Description
`adf.CurBrkPt`	String	When the debugger is stopped at a breakpoint, the field reports the index of the breakpoint. Otherwise, this value is-1.
`adf.File`	String	Name of the current file shown in the debugger source pane.
`adf.Line`	Integer	Line number of the cursor position in the file in the debugger source pane. If no file is open in the source pane, this value is -1.
`adf.MultiDir`	String	Full path to your IDE installation the root folder). For example 'C:\ghs5_01'
`adf.PID`	Double	Process ID from the debug server in the IDE.
`adf.Procedure`	String	Current procedure in the debugger source pane.
`adf.Process`	Double	Program number, defined by the IDE, of the current program.
`adf.Remote`	String	Status of the remote connection, either `Connected` or `Not connected`.
`adf.Selection`	String	The string highlighted in the debugger. If there is no string highlighted, this value is `'null'`.
`adf.State`	String	State of the loaded program. The possible reported states appear in the following list: `About to resume` `Dying` `Just executed` `Just forked` `No child` `Running` `Stopped` `Zombied` For details about the states and their definitions, refer to your IDE debugger documentation.
`adf.Target`	Double	Unique identifier the indicates the processor family and variant.
`adf.TargetOS`	Double	Real-time operating system on the processor if one exists. Provides both the major and minor revision information.
`adf.TargetSeries`	Double	Whether the processor belongs to a series of processors. For details about the processor series, refer to your IDE debugger documentation.

info returns valid information when the IDE debugger is connected to processor hardware or a simulator.

Examples

On a PC with a simulator configured in the IDE, info returns the following configuration information after stopping a running simulation:

adf=info(test_obj1)

adf = 

  CurBrkPt: 0
  File: '...\Compute_Sum_and_Diff_multilink\Compute_Sum_and_Diff_main.c'
  Line: 3
  MultiDir: 'C:\ghs5_01'
  PID: 2380
  Procedure: 'main'
  Process: 0
  Remote: 'Connected'
  Selection: '(null)'
  State: 'Stopped'
  Target: 4325392
  TargetOS: [2x1 double]
  TargetSeries: 3

When you create an IDE handle, the response from info looks like the following before you load a project.

adf=info(test_obj2)

test_obj2 = 

        CurBrkPt: []
            File: []
            Line: []
        MultiDir: []
             PID: []
       Procedure: []
         Process: []
          Remote: []
       Selection: []
           State: []
          Target: []
        TargetOS: []
    TargetSeries: []

Using info with CCS IDE

adf = IDE_Obj.info returns the property names and property values associated with the processor accessed by IDE_Obj. adf is a structure containing the following information elements and values.

Structure Element	Data Type	Description
`adf.procname`	String	Processor name as defined in the CCS setup utility. In multiprocessor systems, this name reflects the specific processor associated with `IDE_Obj`.
`adf.isbigendian`	Boolean	Value describing the byte ordering used by the processor. When the processor is big-endian, this value is `1`. Little-endian processors return `0`.
`adf.family`	Integer	Three-digit integer that identifies the processor family, ranging from 000 to 999. For example, 320 for Texas Instruments digital signal processors.
`adf.subfamily`	Decimal	Decimal representation of the hexadecimal identification value that TI assigns to the processor to identify the processor subfamily. IDs range from 0x000 to 0x3822. Use `dec2hex` to convert the value in `adf.subfamily` to standard notation. For example dec2hex(adf.subfamily) produces `'`67`'` when the processor is a member of the 67xx processor family.
`adf.timeout`	Integer	Default timeout value MATLAB software uses when transferring data to and from CCS. All functions that use a timeout value have an optional `timeout` input argument. When you omit the optional argument, MATLAB software uses 10s as the default value.

adf = info(rx) returns info as a cell arraying containing the names of your open RTDX channels.

Examples

On a PC with a simulator configured in CCS IDE, info returns the configuration for the processor being simulated:

IDE_Obj.info

ans = 

       procname: 'CPU'
    isbigendian: 0
         family: 320
      subfamily: 103
        timeout: 10

This example simulates the TMS320C62xx processor running in little-endian mode. When you use CCS Setup Utility to change the processor from little-endian to big-endian, info shows the change.

IDE_Obj.info

ans = 

       procname: 'CPU'
    isbigendian: 1
         family: 320
      subfamily: 103
        timeout: 10

If you have two open channels, chan1 and chan2,

adf = info(rx)

returns

adf = 
'chan1'
'chan2'

where adf is a cell array. You can dereference the entries in adf to manipulate the channels. For example, you can close a channel by dereferencing the channel in adf in the close function syntax.

close(rx.adf{1,1})

Using info with VisualDSP++ IDE

adf = IDE_Obj.info returns the property names and property values associated with the processor accessed by IDE_Obj. The adf variable is a structure containing the following information elements and values.

Structure Element	Data Type	Description
`adf.procname`	String	Processor name as defined in the CCS setup utility. In multiprocessor systems, this name reflects the specific processor associated with `IDE_Obj`.
`adf.proctype`	String	String with the type of the DSP processor. The type property is the processor type like "ADSP-21065L" or "ADSP-2181".
`adf.revision`	String	String with the silicon revision string of the processor.

adf = info(rx) returns info as a cell arraying containing the names of your open RTDX channels.

Examples

When you have an adivdsp object IDE_Obj, info provides information about the object:

IDE_Obj = adivdsp('sessionname','Testsession')

ADIVDSP Object:
  Session name     : Testsession
  Processor name   : ADSP-BF533
  Processor type   : ADSP-BF533
  Processor number : 0
  Default timeout  : 10.00 secs

objinfo = IDE_Obj.info

objinfo = 

    procname: 'ADSP-BF533'
    proctype: 'ADSP-BF533'
    revision: ''

objinfo.procname

ans = 

ADSP-BF533

Search MATLAB Documentation
R2012a Documentation → Embedded Coder
View documentation for other releases	Learn more about Embedded Coder

info - Information about processor

Syntax

IDEs

Description

Using info with Multiprocessor Boards

Examples

Using info with MULTI IDE

Examples

Using info with CCS IDE

Examples

Using info with VisualDSP++ IDE

Examples

See Also

Related Products & Applications