|
|
|
| R2012a Documentation → Embedded Coder | |
Learn more about Embedded Coder |
|
| Contents | Index |
IDE_Obj = adivdsp
IDE_Obj = adivdsp('propname1',propvalue1,'propname2',propvalue2,…,'timeout',value)
IDE_Obj = adivdsp('my_session')
Note The output object name (left side argument) you provide for adivdsp cannot begin with an underscore, such as _IDE_Obj. |
This function supports the following IDEs:
Analog Devices VisualDSP++
If the IDE is not running, IDE_Obj = adivdsp opens the VisualDSP++ software for the most recent active session. After that, it creates an object, IDE_Obj, that references the newly opened session. If the IDE is running, adivdsp returns object IDE_Obj that connects to the active session in the IDE.
adivdsp creates an interface between MATLAB software and Analog Devices VisualDSP++ software. The first time you use adivdsp, supply a session name as an input argument (refer to the next syntax).
IDE_Obj = adivdsp('sessionname','name','procnum','number',...) returns an object handle IDE_Obj that you use to interact with a processor in the IDE from MATLAB.
Use the debug methods with this object to access memory and control the execution of the processor.
The adivdsp function interprets input arguments as object property definitions. Each property definition consists of a property name followed by the desired property value (often called a PV, or property name/property value, pair). Although you can define any adivdsp object property when you create the object, there are several important properties that you must provide during object construction. These properties must be properly delineated when you create the object. The required input arguments are as follows:
sessionname — Specifies the session to connect to. This session must exist in the session list. adivdsp does not create new sessions. The resulting object refers to a processor in sessionname. To see the list of sessions, use listsessions at the MATLAB command prompt.
procnum— Specifies the processor to connect to in sessionname. The adivdsp object only supports connecting to processor 0. As such, the default value for procnum is 0 for the first processor on the board. If you omit the procnum argument, adivdsp connects to the first processor.
After you build the adivdsp object IDE_Obj, you can review the object property values with get, but you cannot modify the sessionname and procnum property values.
To connect to the active session in IDE, omit the sessionname property in the syntax. If you do not pass sessionname as an input argument, the object defaults to the active session in the IDE.
Use listsessions to determine the number for the desired DSP processor. If your IDE session is single processor or to connect to processor zero, you can omit the procnum property definition. If you omit the procnum argument, procnum defaults to 0 (zero-based).
IDE_Obj = adivdsp('propname1',propvalue1,'propname2',propvalue2,…
,'timeout',value) sets the global time-out value
to value in IDE_Obj. MATLAB waits
for the specified time-out value to get a response from the IDE application.
If the IDE does not respond within the allotted time-out period, MATLAB exits
from the evaluation of this function.
If the session exists in the session list and the IDE is not already running, IDE_Obj = adivdsp('my_session') connects to my_session. In this case, MATLAB starts VisualDSP++ IDE for the session named my_session.
The following list shows some other possible cases and results of using adivdsp to construct an object that refers to my_session.
If my_session does not exist in the session list and the IDE is not already running, MATLAB returns an error stating that my_session does not exist in the session list.
When my_session is the current active session and the IDE is already running, MATLAB connects to the IDE for this session.
If my_session is not the current active session, but exists in the session list, and the IDE is already running, MATLAB displays a dialog box asking if you want to switch to my_session. If you choose to switch to my_session, all existing handles you have to other sessions in the IDE become invalid. To connect to the other sessions you use adivdsp to recreate the objects for those sessions.
If my_session does not exist in the session list and the IDE is already running, MATLAB returns an error, explaining that the session my_session does not exist in the session list.
These examples demonstrate some of the operation of adivdsp.
IDE_Obj = adivdsp('sessionname','my_session','procnum',0);
returns a handle to the first DSP processor for session my_session.
IDE_Obj = adivdsp without input arguments constructs the object IDE_Obj with the default property values, returning a handle to the first DSP processor for the active session in the IDE.
IDE_Obj = adivdsp('sessionname','my_session'); returns a handle to the first DSP processor for the session my_session.
Learn more about Simulink through this collection of videos, articles, technical literature and the Getting Started with Simulink Guide.
| © 1984-2012- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |
