VisualDSP++ 2.0 User's Guide for ADSP
Contents
1. Project window Control menu Toolbars Output window Status bar VisualDSP also provides many debugging windows to show you what is going on You need to learn only one interface to debug all your DSP applications VisualDSP supports ELF DWARF 2 Executable Linkable Format Debugging Information Format executable files VisualDSP supports all executable file formats produced by the linker VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 3 Parts of the User Interface Title Bar The three figures below show the different parts of the title bar gt Analog Devices VisualDSP Target 405P 21065L 405P 2106 Simulator Project dot_product_asm dpj OF x The title bar includes these components Control menu button Application name Analog Devices VisualDSP Name of the active target Project name Filename when an Editor window is maximized in the main window Standard Windows buttons Clicking the control menu button opens the control menu which contains commands for positioning resizing minimizing maximizing and closing the window Double clicking the control button closes VisualDSP The control menu and title bar right click menu see below are identical 3 4 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Additional Information in Title Bars A register window title bar displays its numeric format such as hexadecimal An Editor window ti2. Remove the file from a project Specify options for the file View the file s properties VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 2 27 VisualDSP Windows Automatic File Placement Automatic file placement helps you save time by automatically placing new project files into folders Placement is determined by the file extensions associated with each folder By default project folders are associated with these file extensions Default Associations Header Files h hpp hxx Linker Files df dib If you choose you can change the file extensions associated with a folder Rules The following rules apply to file placement Any file added to a project is placed in the first folder located with the same extension If no folders exist the new file goes to the project level Example You create a folder labeled C Source Files and specify it with c cpp and cxx file extensions You create a second folder labeled Asm Files and associate it with asm files If you add three files filel cpp filel asm and file2 c to the project filel cpp and file2 c are automatically placed in the C Source Files folder and filel asm goes into the Asm Files folder 3 28 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Note After automatic placement you can manually place a file anywhere Editor VVindovvs Use Editor windows to develop source code and edit project files Figur
3. it is called a docked toolbar You can detach a toolbar from a window and move it to another location anywhere on the desktop A floating toolbar is a stand alone window as it is not docked A docked toolbar does not show its name but a floating toolbar displays its title The following example is a floating Help toolbar 02 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 11 Parts of the User Interface Toolbar Button Appearance You can choose the appearance of the toolbar buttons Two options cool look and large buttons provide slightly different button appearances The cool look option includes a pair of vertical bars on the toolbar s left side but removes the square box from each button The vertical bars visually separate toolbar buttons into groups toolbars The large buttons option makes the area of each button larger The figures in the following table demonstrate these options Cool look Off Large buttons Off Cool look On Large buttons Off Cool look Off Large buttons On Cool look On Large buttons On 3 12 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Toolbar Shape You can change the shape of a floating toolbar These examples show two toolbar shapes Horizontal Vertical Help H EI x P k Note Depending on the number of tools in the toolbar you can create other length and width arrangements Toolbar Rules Be aware of thes
4. the far left of the Disassembly window The symbols located at the left of the Disassembly window are Current source line The current instruction is being aborted due to a branch or jump instruction A breakpoint is enabled A breakpoint is disabled This instruction is currently in the Fetch Address stage of the pipeline This instruction is currently in the Instruction Decode stage of the pipeline This instruction is currently in the Execute stage of the pipeline Note The display of pipeline stages is available only when e The selected session is connected to a simulator target e Enable pipeline display is selected on the General tab page of the Preferences dialog box available from the Settings menu VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 55 Debugging Windows Expressions Window The Expressions window shown in Figure 3 18 enables you enter an expression to evaluate in your program Expression evaluations are based on the current debug context Expressions ix Co Qu Qu odo n fu TT 0 C9 de Ce dO dim nm Xn Figure 3 18 Expressions Window Note Because of the way registers are saved and restored on the stack the register value on which the expression relies may be incorrect if you change VisualDSP s context with the Call Stack window The Expressions window s right click menu includes commands that let you change the displays number format Delete Cle
5. 57 Debugging Windows Locals Window The Locals window displays the value of local variables within a function as shown in Figure 3 20 Locals AA e 8 000 xc i e i e e e index A 4 conversion ee Figure 3 20 Locals Window Use this window with a Step or Halt command to display the current value of variables as you move through your program Note Complex variables C structures and C classes appear with a plus sign Click on the plus sign to display all variable information The vvindovvs right click menu provides these commonly used commands w Hexadecimal Float Unsigned Integer Integer Uctal Allow Docking Close Float In Main Window 3 58 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Statistical Linear Profiling Results Window Depending on the target the title of the window can be Statistical Profiling Results or Linear Profiling Results The window comprises two panes as shown in Figure 3 21 CalculateOu 102 void Calculate QutputPul x Generatelnp 105 CO Initializes 104 Pf o i FC UxB8247 0 z 105 1 FC UxB8248 0 29 106 fori int 1 0 itniInp FO UxB265f 107 1 E FOC UxB8270 10 97 108 fori int J 0 jen PB l x 3ycl 103 j 5 GenerateImp Tas 110 Output i rj E FC UxB26h 99x 111 l a Total Samples 499005 Elapsed Time 00 00 40 Enabled Figure 3 21 Statist
6. Guide for ADSP 21xxx DSPs Environment Console Tab From the Output vvindovvs Console tab page Figure 3 9 you can View VisualDSP or target status error messages View STDIO output from C C programs View I O streams messages Scroll through previous commands Just press the keyboard s up arrow T and down arrow J keys Perform multi line selection copy paste and clear Issue Tel commands e Auto complete Tcl commands Execute a previously issued Tcl command Just double click on the command Enter multi line Tcl commands by adding a backslash character to the end of a statement Use bookmarks e Toggle a bookmark by pressing Ctrl F2 Moveto the next bookmark by pressing the keyboard s F2 key All text displayed on the Console tab page is also written to the VisualDSP log file VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 33 VisualDSP Windows Output Window Customization You can specify preferences that Configure Output window fonts and colors Enable command auto completion By default the Output window resides at the bottom of the main application window You can resize or move the Output window which is a Windows docking bar to a different portion of the screen by dragging it to the selected location The Output window s Console tab can interact with the VisualDSP Tel engine All Tcl input and output is sent to the Console tab page shown in Figure 3 9 Output Window
7. and data memory transfers Locals All local variables within a function Use this window with step or halt commands to display variables as you move through your program Linear Profiling Simulation only The target s PC register is Results sampled at every instruction cycle to provide an accurate picture of where instructions were executed Linear profiling is much slower than statistical profiling 3 50 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Statistical JTAG emulation only VisualDSP randomly Profiling Results samples the target processors program counter PC and presents a graphical display of the resulting samples showing where the application spends time Call Stack A means of moving the call stack back to the previous debug context Register Current values of registers You can change register contents and change the number format A view of DSP memory Similar number format and edit features as register windows plus fill and dump capability Memory Map The memory map of the selected processor A graphical display of values from memory addresses The window supports linear and FFT real and complex visualization modes and allows you to export an image to a file the clipboard or to a printer Instruction pipeline VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 51 Debugging Windows Disassembly Windows By default a Disassembly window appears when you open a new ses
8. main window and to the Plot window features described in the following table VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 87 Debugging Windows Data cursor You can move the Plot window s data cursor position over a data point and view the point s memory data value in the left side of the Plot window s status bar Use the keyboard s arrow keys to move around on the graph Zooming You can zoom in to view a specified region of the plot You can also reset the Plot window to its initial full scale display Plot configuration From the Plot window you can access the Plot Configuration dialog box from which to add remove or modify data sets You can also change the plot type and rename the plot Settings You can customize the plot s appearance You modification can specify settings for the plot grids colors margins fonts axes and so on and you can specify settings for each data set data processing Settings storage You can save plot configuration settings for and retrieval future use Plot settings are stored but the data is not stored You can retrieve settings VPS file and load new plot data You can export the plot image to various destinations including the Windows clipboard Save the plot image as a file jpg gif tif eps txt or dat format or print a hard copy 3 88 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Plot Configuration A plot configuration com
9. the mouse pointer over a variable with the pointer still on top of the variable VisualDSP evaluates the variable If the variable is in scope the value appears in a tool tip window Viewing an Expression You can view an expression in different ways When the Editor window is in mixed mode you can view an expression by moving the pointer over a register in an assembly instruction The register contents are displayed in a tool tip Highlighting an Expression You can highlight an expression in the Editor window and then move the pointer on top of the highlighted expression to display its value in a tool tip VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 79 Debugging Windows Source Mode vs Mixed Mode You can specify an Editor window s display format Your two options are source mode and mixed mode Source Mode Source mode shown in Figure 3 34 displays C code only B Convolution c IBEX float index 0 0 yy Used for x float conversion 0 0 Conversic k first generate the Sine Table 31 0 14 360 iH 1 Convert degrees to radians then cc J 1 conversion RADIANS mun Tahlefil sin cunversiun H g Figure 3 34 Editor Window Source Mode Format Mixed Mode Mixed mode displays the assembled code after the line of the corresponding C code The assembly code takes a specified color Note e You must compile the source file with debugging information to vi
10. the plot You can modify a plot s configuration and immediately view the revised plot From a Plot window you can zoom in on a potion of a plot or view the values of a data point You can print a plot save the plot image to a file or save the plots data to a file For details refer to the online Help in VisualDSP VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 85 Debugging Windows Plot Window Features Plot windows include a status bar and a right click menu Status Bar The status bar located at the bottom of the Plot window displays the plot type and other information depending on the plot type and other settings The following examples show different plot information displayed on the status bar PF ine Plot z 7 740 220 Waterfall Plot EET as DM LinePlet In a waterfall plot the status bar indicates the azimuth and elevation viewing angles If you zoom in on a region the status bar indicates that zoom is enabled When you use the data cursor the status bar shows the selected point s data value 3 86 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Right Click Menu The Plot window s right click menu is shown below Data Cursor Reset Zoom Configure Modity Settings Save Settings Export wv Allow Docking Close w Float In Main window This menu provides access to the standard window options docking closing and floating in the
11. types of files e ASM assembly C C files C header Linker Description Files e Tc1 Tool Command Language script files 3 76 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Right Click Menu The Editor vvindovvs right click menu provides the following commands Copy Ctrl C Toggle Bookmark Ctrl F 2 Next Bookmark 2 Insert Breakpoint F3 Hun to Cursor Ctrl F10 Goto Lire Find Ctrl F DOUCE Mixed Select Format d Hexadecimal Float Unsigned Integer Integer Octal Notes The available number formats under Select Format are DSP dependent e An additional command Source Tel Script is available when you are editing a Tel script VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 2 7 Debugging Windows Editor Window Symbols The Editor windows gutter left margin displays icons that indicate breakpoints bookmarks and the current position of the program counter PC The current source line to be executed PC location An enabled breakpoint A disabled breakpoint A bookmark Bookmarks Bookmarks are pointers in Editor windows You bookmark a location so you can go it quickly later 3 78 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Context Sensitive Expression Evaluation You can evaluate an expression in an Editor window only if your DXE program is loaded for debugging As you move
12. x PO Loading C Convolution Convolution B5UE F Load complete depsethbreak processor F3 020006 there z already a breakpoint at address Kil IB Figure 3 9 Output Window Console Tab Page 3 34 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Log File The VisualDSP log file contains all status and error messages written to the Output window s Console tab page Figure 3 10 shows a sample log file El YisualDbSP_Log txt Notepad He Edt Search Help Loading C Program Files Analog DeuicesXUisualDS Load complete Hit breakpoint at 6x18 Loading C Program Files Analog Devices YisualD Load complete Hit breakpoint at x18 Loading C Program Files Analog DeuicesXUisualDS Figure 3 10 Sample Log File These messages are saved to the log file VisualDSP_Log txt which is located in the C Program Files Analog Devices VisualDSP Data directory Notes The above file path assumes that you installed VisualDSP by accepting default settings All sessions append to the log file Occasionally open the file and delete parts of it or all of it to conserve disk space VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 35 VisualDSP Windows Right Click Menu The Output windows right click menu is shown below Clear Copy Toggle Bookmark Lhrl F 2 w Allow Docking Hide Float In Main Window This menu enables you to 3 36 Dock the window Floa
13. 2 4 d l nic m Source File j Pos Header File wm Device Flags y Project z Clock Frequency MHz 160 T Tick Period ms 5 m History Buffer Size 256 id Running Threads 20 MT Debug Enabled true EI Thread Types Elna Mel master 5o e Priority 4 j 5 Stack Size 255 m Source File Adsl master cpp m Header File Adsl master h Eh ConvertChannelD ata Friarity 3 m Stack Size 255 A Source File CanvertChannelD ata cpp ConvertChannelD ata h Friority 5 Stack Size 255 Re Source File VorceChannel cpp VorceChannel h Adsl master Adsl nic c Adsl nic h Environment Figure 3 5 Kernel Tab Page Expanded View of VDK Elements Refer to the VisualDSP Kernel VDK Users Guide for complete details about VDK VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 23 VisualDSP Windows Project Window Right Click Menus From the Project window you can access four different right click menus that enable you to operate on Project window objects the project folders or files These right click menus are Project window menu e Project icon menu e Folder icon menu e File icon menu Depending on the context selected object right click menus provide an alternative means of performing an action You can perform many of the actions from the menu bar commands or toolbar buttons Project Window Menu The Project windows right click menu enables you to Hide the Project window from view Dock
14. 3 ENVIRONMENT In This Chapter This chapter contains the following topics e Parts of the User Interface on page 3 2 e VisualDSP Windows on page 3 17 Environment Customization on page 3 37 e Window Operations on page 3 44 Debugging Windows on page 3 50 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 Parts of the User Interface Parts of the User Interface VisualDSP is an intuitive easy to use user interface for programming Analog Devices DSPs When you open VisualDSP the application s main window Figure 3 1 appears Analog Devices VisuallSP Target ADSP 21065L ADSP 2106x Simulator Output Window 3 2 Fie Edit Session View Project Register Memory Debug Settings Tools Window Help El Project Window E 008005 mop 008006 008007 nop 008008 nop 008009 nop 008004 nop 008006 nop El 100800 1 nop O0800D nop 00800E nop OOS00F nop 008010 nop 008011 Paed C dE MA Figure 3 1 VisualDSP Main Window Example This work area contains everything you need to build manage and debug your DSP project You can set up preferences that specify the appearance of application objects fonts visibility and so on VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment In addition to the main application window frame VisualDSP includes these parts e Title bar Menu bar
15. Running to main after load Docking new windows Recycling Editor windows Standard I O STDIO support Auto loading an executable after a successful build VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Work Environment Customization The user interface comprises many parts Arrange portions of the interface to meet your needs You can customize the following components to meet your needs e Toolbars e Workspaces Windows e Application user preferences In addition you can show or hide the Output window status bar toolbars or tool tips VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 39 Environment Customization Workspace Specification Open multiple windows and place them anywhere you want After you set up the windows save the window configuration as a workspace which you can restore load at another time You can create up to ten workspaces and quickly switch among them via the Workspace toolbar shown below menu commands or keyboard shortcuts Keyboard shortcuts ALT 1 ALT 2 ALT 0 provide fast access to Workspace 1 Workspace 2 Workspace 10 respectively Modify the keyboard shortcuts to meet your needs Each debug session maintains a default workspace that is automatically saved when you close the debug session This workspace is automatically restored when you load that session Window Color Customization You can specify window colors for items such as symbo
16. User s Guide for ADSP 21xxx DSPs
17. User s Guide for ADSP 21xxx DSPs Environment Status Bar The status bar located at the bottom of the main application window provides various informational messages The following examples show different information displayed on the status bar Ready Halted ee Step ane line Halted 100000000 a For Help press F1 Line 21 Cal 1 NUM 2 The type of information that appears in the status bar depends on your context what you are doing e When you move the mouse pointer over a toolbar button or a menu bar command a brief description of the button or command appears e When you halt program operation with a Halt command the address where the program halted appears e While running a trace the word Running appears e While using some Tcl commands the status bar provides information such as when the menu item has focus VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 25 Parts of the User Interface While you are editing a file the right side of the status bar provides Editor window information Line Cursor current line number Col Cursor current column number The keyboard s Caps Lock key is latched down The keyboard s Num Lock key is latched down SCRL The keyboard s Scroll Lock key is latched down 3 16 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment VisuaIDSP Windows From the application s main window you can open a Project window Editor windows an Outpu
18. User s Guide for ADSP 21xxx DSPs 3 19 VisualDSP Windows Project Tab Page Right Click Menus The following right click menus also called popup menus or context menus are available Node The menus content depends on the context selected node Title bar From this menu you can dock hide or float the window You can also view project properties Project Folders Project window folders 7 3 organize files within a project You can specify properties for folders The following rules apply to folders e Folders can be nested to any depth Folders carry no attributes to the build process as they do not reflect the file system Folders do not appear in directory listings as in Windows Explorer e When you automatically add files to the project tree each file is placed in the first folder that has been configured with the same file extension After automatic placement you can move a file anywhere manually Tip To move a file out of one folder and into another folder select the file and drag it onto the other folder 3 20 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Project Files In the Project window files are represented by the following icons Files that use project options Files that use options that differ from project options Files excluded from the current configuration The files appear in an expandable and collapsible node tree Source files are the C C langua
19. Windows buttons are located on the right side of the title bar as shown below Project MyProject dpi fir_fr16 asm MEJ ES These buttons resize and close the window as described in the following table Minimize reduces the window to its Windows icon Maximize enlarges the window to fill the screen non minimized non maximized position Close closes the application window and exits the program Restore which appears only after maximizing m the window returns the window to its last VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 49 Debugging Windows Debugging Windows VisualDSP provides these debugging windows to display DSP program operation and results Output The Console tab displays standard I O text messages such as file load status and error messages and streams You can interactively enter Tcl commands and view Tcl output The Build tab displays build messages Editor Syntax coloring context sensitive expression evaluation and status icons that indicate breakpoints bookmarks and the current PC position Disassembly Code in disassembled format This window provides fill and dump capability Expressions The means to enter an expression and see its value as you step through program execution Trace A history of processor activity during program execution including buffer depth instruction lines cycle count and instructions executed such as memory fetches program memory writes
20. ar w Hexadecimal Float Unsigned Integer Integer Octal Allow Docking Close Float In Main Window 3 56 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Trace Windows You perform a trace also called an execution trace or a program trace to analyze the run time behavior of your DSP program to enable I O capabilities and to simulate source to target data streaming Figure 3 19 shows data displayed in a Trace window Trace 1 1566608801Cycle 8600864711 PM 6662823c 12 114 12 riler11 r12 66866882 RD PM 8882602361 4dfe8eG88886 99898083 Cycle 60006472 PM 6602823d if eq r amp r r2 66866885 RD PM 806626231 ae8b66868001 1586608861 Cycle 1866664731 PM 6662623e il2 dm m7 16 66866887 RD DM 1886311131 6862613d 668666893 RD PM 866262480 ae8786808002 15806088a1Cycle 60006474 PM188020231 rll dm 8xl 17 15666668b RD DM 8663fffl 68668686 1566660684 RD PM 66626241 683734800696 Figure 3 19 Trace Window The Trace window displays Buffer depth as specified by the Custom depth box in the Trace Buffer Depth dialog box The clock cycle when the instruction occurred The address of the instruction that was executed The disassembled instruction Memory results have the following fields Access type RD or WR Memory type PM or DM The address in brackets 11 The data value that was written or read VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3
21. ata set as well as line type and width as shown below Fz L 3 In addition to the many presentation options you can select a rectangular area as shown in Figure 3 37 and zoom in on it xl Zw Line Plot Example Line Plot Example Yi and Y2 ID m E L Figure 3 37 Plot Window Selecting an Area to Zoom in on 3 90 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Plot Presentation Options You can configure a plots presentation Depending on the type of plot many options are available In the Plot Settings dialog box these options are grouped by function on tab pages as follows Tab Page Options you can specify General Title and subtitle grid lines margins background colors and legend 2 D Axis For X axis and Y axis axis titles start and increment values scales 3 D Axis For X axis Y axis and Z axis axis titles Z axis settings step sizes scale multipliers color and mesh Font name color and size For a data set line type width color symbol and type Data Processing For a data set data processing algorithm sample rate number of stored traces and triggering You can specify a plots presentation options before you generate the plot while configuring the plot or you can specify plot options after generating the plot VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 91 Debugging Windows 3 92 VisualDSP 2 0
22. ats A horizontal Bar Current dats Athin green vertical line Arrows indicate thread a scroll bar Cursor Indicates a thread cursor position indicates a thread switch IM m Ftitr Hb k alasopFer read ik dilaz pPer razi 1 lvl BK lazer crece uz l m creat Trz 7 thoes 2 ped Idle T we SS 1 1 T kz EDCOEEVEIEX TE T ev ur nk y 1800000001 N Rok Bao ra i EE 2nd Enable the da a cursor to wewrthe status bar The status bar provides event details Thread status The green portion of the Thethin green line horizontal bar indicates below athread statusbar th eti methethread wee indicates the currently adive Trace thread switch active thread history by following the thin green line Figure 3 32 State History Window Thread status appears as horizontal bars and thread events appear as arrows above the horizontal bars Status bars and event symbols are color coded based on thread status and event type 3 72 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Thread Status and Event Colors All events of the same type are drawn in the same color The thin green line below the thread status bar indicates the currently active thread When a thread is switched the green line is drawn vertically to the next active thread Trace the thread switch history by following the thin green line Right click on the plot a
23. ats The four Memory windows that follow show examples of different number formats for the Data Memory type 168 00008509 000084 5 000084 5 000084 5 UODLBC 000084 5 000084 5 000084 5 0000848 5 0001 0 00008465 000084 5 0001 21 00005425 00008539 Figure 3 23 Data Memory Window Hex Number Format 3 64 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Data DM Memory Octal 108 109 LOOD DIOE LOOD DIOC 1 00 DakafOM Memory Binary 0001081 0001091 PU D1 B 010 1 1001 00000000000000001000000111110000 00000000000000001000000111110000 01111111111111111111111111111111 00000000000000001000000111110000 00000000000000001000000111110110 000001002760 000001002760 LPP PP PPP Pe 00000100260 00000100766 AYYYYYYYYY Y S 4p Memory Unsigned Integer LU D Be 34057 34021 34021 OODLBC 34021 34021 L D BE 34021 34021 El 0001 0 34021 34021 0001 21 34021 34105 Figure 3 26 Data Memory Window Unsigned Integer Format VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 65 Debugging Windows Right Click Menu Memory windows provide the following right click menu Go To Ctrl G Dump Fill Lack Columns Select Format oa Hexade
24. ble and disable the display of pipeline symbols while in mixed mode C C and assembly By default the current source line to be executed is highlighted by a light blue horizontal bar as shown in the following example gt 1663665 jump fftrad2 db 7 You can configure the color of the current source line and other window items VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 53 Debugging Windows Other Disassembly Window Features From the Disassembly window you can do the following Move to a different An address field and double click Then address select the address from the ensuing Go To dialog box Insert or remove a An instruction and double click breakpoint Toggle enable or An instruction and right click Then choose the appropriate command from the disable a breakpoint ensuing menu Right Click Menu The Disassembly window s right click menu provides access to these commands Edit Edit laa Tn tle laa To Chrl G Dump Dump Fill Fill Insert Breakpoint F3 Hun Ta Cursor Ctrl F10 View Source w Allow Docking Close Float In Main Window Remove Breakpoint F3 Disable Breakpoint Fun To Cursor Ltrl FT View Source w Allow Docking Close Float In Main Window 3 54 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Disassembly Window Symbols The Disassembly window denotes program execution stages with symbols at
25. cimal Octal New Tracking qay a d Binary v Allow Docking Signed Integer Clase LInsigned Integer Floating Point 32 bit Floating Point 40 bit Signed Fractional Unsigned Fractional Float In Main Window This menu enables you to run commands such as those used to change the number format of the display 3 66 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Memory Map Windows Environment The Memory Map window Figure 3 27 displays the memory map for the selected processor Memory Map 025000 0250440 0 0020 0 3600 025400 0 2000 Dt Od 300 00 O60 ct Dat OG 2 Od StF difi Ox20000 2077 Figure 3 27 Memory Map Window Program PM Memory Memory Memory Program PM Memory DatalD M Memory Fragram FHM Memory M Memory Memory Memon Memory 0230 0x30 z 0x20 0x20 0x30 0x20 0220 0220 0220 If no DSP program is loaded into the processor the memory map displays all available memory in the processor If a program is loaded the memory map is the map defined in the memory section of the programs LDF file For each portion of memory the window displays the start address end address and width VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 67 Debugging Windows Register Windows De
26. dsID ataPacket SemaphoreBlocked Blocked on kDataRecievedFromhetwork Figure 3 31 VDK Status Window When you halt execution of a VDK program VisualDSP reads thread data and displays thread state and status data in this window When a thread is created it is added to the display A thread is removed from the display when it is destroyed 3 70 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Initially thread information appears in a collapsed state in which only the thread name and its current state are displayed When a thread is in the Ready state its priority is displayed Clicking the plus sign next to the thread name expands the view When thread status information is not accessible thread out of context no information is displayed These are the possible thread states Running Ready SemaphoreBlocked EventBlocked DeviceFlagBlocked SemaphoreBlockedWithTimeout EventBlockedWithTimeout DeviceFlagBlockedWithTimeout Sleeping Unknown Refer to the VisualDSP Kernel VDK Users Guide for details VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 71 Debugging Windows State History Window VDK state history and VDK target load plots are available when a DSP executable is built with VDK support During execution of a VDK enabled program thread and event data is collected in a history buffer The State History window described in Figure 3 32 displays the history buffer plots An arrows D
27. e 3 6 shows items that you can customize in Editor windows Specify colors for text objects C N shell asm PES OFX QVAR a coeff1N1 5Cdi rdflpa da VAR something do b543 1 4 section codeCSeg pmcode start 10 delav line Qnitializati Control menu Toggle book marks 4 Specify Specify comment start tab widths Specify font 7 7 strinqs Figure 3 6 Editor Window Customization VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 29 VisualDSP Windows Open as many Editor windows as you like Editor windows support the following features and functions e User defined color coded comments strings keywords and tabs e Print print preview and user defined headers and footers Bookmarks e Find and replace wrap around search regular expression matching e Go to a specified line number Jump to the next or previous syntax error e Copy cut paste undo and redo more than 500 levels of edits for each open file Use the Editor windows right click menu to perform these functions Undo or redo the last edit e Cut copy or paste text Toggle a bookmark 3 30 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Output Window The Output window Displays standard I O text messages such as file load status and error messages Displays build status information for the current project build Provides access to errors in source fil
28. e following windows are examples of three different number formats The actual appearance depends on your DSP family VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 83 Debugging Windows This window appears in hexadecimal format DakafDM Memory Hexadecimal OOD1BS 00008509 000084E5 0D1B 000084E5 000084E5 0D1BC 000084E5 000064 5 1 000084 5 000084 5 001 0 000084 5 000084 5 001 2 000084 5 00008539 This vvindovv appears in octal format Memory Octal O0D108 00000100760 000109 00000100760 0D10A 17777777777 0D1B80B 00000100760 10 1 00000100766 1001 1 37777777777 This window appears in binary format 3 84 Datat DM Memory Binary 000D0E LU 1 1000108 00010 1 10001001 00000000000000001000000111110000 00000000000000001000000111110000 01111111111111111111111111111111 00000000000000001000000111110000 00000000000000001000000111110110 11111111111111111111111111111111 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Plot Windows Use a Plot window to display a plot which is a visualization of values obtained from DSP memory You can display one or multiple Plot windows Figure 3 36 shows an example of a plot in a Plot window zw Line Plot Example Line Plot Example Line Plot Figure 3 36 Plot Window Plot Example You specify the contents and presentation of
29. e rules when working with toolbars e You can customize any built in toolbar For example you can remove a button from the File toolbar but you cannot delete a built in toolbar e For a built in toolbar you can reset the buttons to their original default button set e You can prevent a toolbar from docking by pressing and holding the Ctrl key while dragging the toolbar to a new location e You can change the name of a user defined toolbar but you cannot change the name of a built in toolbar For example you cannot change the name of the File toolbar VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 13 Parts of the User Interface e Moving a toolbar to the bottom of a window creates a new docking site and docks the toolbar You can tell when a toolbar is going to dock by the size and shape of its moving outline as you drag it Its outline becomes slightly smaller than its floating outline User Tools Save time running commands by configuring user tools You can configure up to ten user tools A user tool runs a command which can Contain parameters to launch an application Bea command You access configured user tools from the Tools menu or from the User Tools toolbar shown below When a user tool is configured its menu name label appears in the Tools menu The label also appears when you move the mouse pointer over a user tool button 3 14 VisualDSP 2 0
30. es e Acts as an interface to Tcl The Output window shown in Figure 3 7 contains build status information oMProqran Files Analog Dewvices VisualDSP cc lk c dotprod main c 0l g C Program Files Analog Devices VisualD5P cc lk exe debug dotprod main du Build completed successtully e Hi g Figure 3 7 Output Window with Build Status Information Display the Output window by choosing Output Window from the View menu VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 31 VisualDSP Windows Output Window Tabs The Output windows two tabs Console and Build provide different information and capabilities Build Tab The Build tab page Figure 3 8 displays error messages generated during a build Double click on an error message to jump to the offending code in an Editor window Double click un an error to view the source GC MXProagratmFilez alog Devices Y isualDsP cc l shell c ine sl17 7 expected a int output NH out gt x shell c line 16 XError 17 gt expected a 1 int input NUM FEC Console Build Lal r3 EL Figure 3 8 Output Window Error Messages Tip Scroll through error messages by choosing Next Error or Prev Error from the Edit menu By default VisualDSP output is blue and tool output is black but you can change these colors in the Preferences dialog box 3 32 VisualDSP 2 0 User s
31. ew the source file in mixed mode e You can enable and disable the display of pipeline symbols while in mixed mode 3 80 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Figure 3 35 shovvs an example of the mixed mode format Bi Example3 c E void secondi int j maini 1 P dE 7 si OOO04F md 14 000050 dm id m7 si 000051 si toppestack 000052 dntid m7 si 000053 m5 x3ff2 000054 modify id4 m5 000055 si m 000056 dmfid m si ine x int yll l while il outside 10 000057 Ox000a ba dmfoutside outsidel l 000059 dm outsidel outsides 10 000054 ar x a Environment Figure 3 35 Editor Window Mixed Mode Example VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 81 Debugging Windows Expressions in an Expressions Window You can enter these types of expressions in an Expressions window Expression Description o ee eee ee eee eee EOCLLLOUOLAILLELEDEIALUULUULULEAg9 9 Oj AELULHAOULLULL COAOAACCZLLLL UU CLL EAXARE Memory address The memory addresses can be data DM or program PM The size of an address is 32 bits Precede memory identifiers with a sign for example 50116 0 2000 Register expression Precede register names with a sign for example r0 ax0 or imask C C statements Use standard C C arithmetic and logical operators About Expressions T
32. ge or assembly language files in your project Source files provide the project with code and data You can add delete and modify source files Each project must include a LDF file which contains command input for the linker If you do not include a LDF file in the project the project is built with a default LDF file Besides source files a DSP project may use additional files Optionally a project can include data files and header files VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 21 VisualDSP Windows Kernel Tab Page The Kernel tab of the Project window is available only to VDK enabled projects From this tab page you can add modify and delete kernel elements such as thread types priorities semaphore and events VisualDSP automatically updates vdk_config cpp and vdk conff1g h to reflect the changes you make from the Kernel tab page The example in Figure 3 5 shows an expanded view of the elements on the Kernel tab page for a VDK enabled project 2 22 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Project EesE5 dpj Bi Parameter Value 2 1 Kernel El System Header File Ee VMoiceChannel Header File E Boot Threads ERES SystemStarter Thread Type Bii Round Robin Priorities B amp Semaphares Red NewsdelDataPacket fl amp VoiceDataCompressed H S ReadiForMesiPacket Bl amp DataFecievedFromMet i mi Event Bits E Events E Interupts 12 48 Device Drivers
33. he Expressions window displays the current value of each expression as you step through your program Expressions are evaluated based on the current debug context For example if you enter expression a and a global variable a exists you see its value If you then step into a function that has local variable a you see the local value until the debug context leaves the function When a variable goes out of context a string displays next to the variable to inform you that the variable is out of context The expressions described above are C expressions The current syntax also allows you to use registers in expressions For example the following is a valid expression RO 410 Register expressions and C expressions can be mixed in an expression 3 82 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Register expressions follovv these rules Precede register names vvith a character Register names can be uppercase or ovvercase characters Registers have no context A register expression always evaluates to the current value of the register Number Formats You can select the number format used to display a particular register window or memory window The available number formats which depend on your DSP family can include the following Hexadecimal Octal Binary Signed integer Unsigned integer Floating Point 32 bit Floating Point 40 bit Signed fractional Unsigned fractional Th
34. ical Profiling Results Window VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 59 Debugging Windows Left Pane The left pane shows a list of functions assembly source lines PCs with no debug information that were executed and the percent of time each item spent on execution The order of the items in the display is determined by the percentage of global execution time each item took to execute The left pane includes this information Graphically represents the 1 Horizontal bar chart P yor execution percentage Execution percent in text format with two A right click menu allows decimal places for you to choose whether to example 15 01 view the execution as a or percent or a sample count PC sample count These items are sorted by the percentage of the global List of functions execution time each item assembly source lines took to execute with the and PCs for which highest percentage items at there is no debug info the top of the list and the lowest percentage at the bottom If you double click on a line with a function or assembly source line in the left pane the right pane displays the corresponding source file and jumps to the top of that function or assembly source line respectively If you double click on a PC address that has no debug information the Disassembly window jumps to that address 3 60 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Right Pane The right pane i
35. icking a toolbar button Use toolbars to organize the tasks you use most often Position the toolbars on the screen for fast access to the tools that you plan to use The application includes standard built in toolbars You can create custom toolbars Built In Toolbars These are the standard default toolbars File a ree cici AlAlelalPisi nA EE x b in etx ES ki Configuration box Window Ems er VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 9 Parts of the User Interface el ES MUR ES a E C al User Tools Workspaces To obtain information about a tool move the mouse pointer over the tool and press the F1 key Toolbar Customization By default nine standard toolbars appear near the top of the application window below the menu bar You can change the appearance of toolbars by Moving docking or floating the toolbars Adding or removing buttons to or from toolbars Displaying cool look buttons large buttons or both You can also e Hide toolbars from view e Add and delete custom built toolbars 3 10 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Toolbars Docked vs Floating By default toolbars are located under the application s menu bar You can move them to the following locations Over a docked window e On the main window Anywhere on the desktop When a toolbar is attached to a window
36. indows control menu only when the window is floating in the main window For more information see Debugging Windows on page 3 50 Menu Bar The menu bar shown in Figure 3 2 appears directly below the application title bar and displays menu headings such as File and Edit He Edit Session View Project Register Memory Debug Settings Tools Window Help Figure 3 2 VisualDSP Menu Bar To display menu commands and submenus click a menu heading You can also access many menu bar commands as follows e Click toolbar buttons Type keyboard shortcuts e Right click the mouse and choose a command from a context menu VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 7 Parts of the User Interface Command Information 3 8 When the mouse pointer is over a menu bar command or a toolbar button a short description tool tip of the command appears in the status bar at the bottom of the main window Context sensitive Help is available for each command To learn more about an individual menu command 1 Press Shift F1 or click the toolbar s Help button k The pointer becomes a Help pointer X 2 Move the Help pointer over a menu command If necessary navigate through submenus 3 Click the mouse View the description of the command in the ensuing Help window VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Toolbars and User Tools A toolbar is a set of buttons You can run a command quickly by cl
37. l Category 3 42 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment You can customize colors for various categories such as the Output Window selected below Category Command Test TD R Test Error T ext Window Background Build Output Tool Output For the Output Window category you can customize the color of these Output window items e Console text e VVindovv background e Command text e Build output e STDIO text e Tool output e Frror text VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 43 Window Operations Window Operations Window Manipulation The Window menu commands shown below enable you to manipulate your windows display and update windows during program execution Refer to your Windows documentation for more information MA indor Tile Horizontally Tile Vertically Cascade Close All Refresh Right Click Menu Options Each window presents a menu when you right click in the window or on its title bar Select these menu options to affect window s behavior Allow Docking Enables disables docking Float in Main Window Causes the window to become a normal MDI child window like an Editor window and disables its docking ability 3 44 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Scroll Bars and Resize Pull Tab Scroll bars appear along the right and bottom edges of the application or document window as shown below scroll bar Sc
38. ls and data that appear in VisualDSP debugging windows One set of options configures the display of objects in all the debugging windows other than the Output window Another set of options configures the appearance of the Output window 3 40 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment You specify colors for all debugging windows other than the Output window from the Preferences dialog box General category on the Colors tab page You can select a color for each of the following items e Data values Uninitialized data e Memory labels e Pipeline symbols e Address values e Selection highlight Modified data e Current PC highlight e Disabled data e Mixed mode assembly text A horizontal bar in the Disassembly window highlights the current source line to be executed as shown in the following example 1663665 jump fftrad2 db 7 By default the bar is light blue You can change its color by configuring Current PC Highlight on the Colors tab of the Preferences dialog box shown in Figure 3 11 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 41 Environment Customization Preferences Gerd 2 2 Data Values Memory Labels Address Values Modified Data Choose Disabled Data Uniritialized Data Pipeline Symbols Selection Highlight Current PC Highlight Mixed Mode Assembly Text Unfocused MP Window Background Figure 3 11 Preferences Dialog Box Colors Tab Page Genera
39. mber of PC samples collected View Sample Count When this option is selected each execution unit or source line in the Statistical Linear Profiling Results window shows the PC sample count for that line 3 62 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Call Stack Window The Call Stack window Figure 3 22 enables you to double click on a stack location to move the call stack back to a previous debug context Call Stack x b maint Figure 3 22 Call Stack VVindovv Note This window functions with C C code only Use this window to analyze the state of parent functions when erroneous data is being passed to the currently executing function and to see the context from which the current function is being called Use this debugging feature by walking up the call stack and viewing local variables in different scopes VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 63 Debugging Windows Memory Windows Memory windows similar to register windows provide Number format and edit features e Fill and dump capability From a Memory window you can e Display the address of a value Move the mouse pointer over the value and press and hold the keyboard s Ctrl key Lock the number of columns currently displayed which resizes the window horizontally without altering the display Track expressions that the window tracks whenever it refreshes Memory Types and Number Form
40. n zoom in on a region to examine that area in more detail Hold the left mouse button down while dragging the mouse to create a selection box Then release the mouse button to expand the plot To restore the plot to its original scale right click on the plot and choose Reset Zoom Actions You can Perform from the Plot The State History windows right click menu shown below provides easy access to operations that you can perform on the state history plot Data Cursor Reset zoom Status Legend Event Legend Export Pin Fa Processor w Allow Docking Close w Float In Main Window 3 74 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Target Load Window A target load plot Target Load window shown in Figure 3 33 displays the percent of time the target spent in the idle thread DSP O b Target Load Target Load e Target Load Figure 3 33 Target Load VVindovv A load of 0 means VDK spent all of its time in the idle thread A load of 100 means the target did not spend any time in the idle thread Load data is processed using a moving window average VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 75 Debugging Windows About Debugging Windows Editor Window Features An Editor window provides these features e Status icons Expression evaluation e Two view formats source mode or mixed mode Syntax Coloring Specify colors to help you locate information in these
41. ncludes this information Execution percent in text format with two 1 decimal places for example 1 03 Or the PC sample count for each source line Line numbers of the source file Entire source file Each source line occupies one line in the grid control The status bar at the bottom of the window shows the total number of PC samples collected and the total elapsed time and indicates whether statistical profiling is enabled Right Click Menu The window provides the following right click menu w Enable Load Profile Save Profile Concatenate Profile Clear Profile View Execution Percent View Sample Count Allow Docking Close Float n Main Window VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 61 Debugging Windows The following table describes the menu commands Enables disables statistical profiling Load Profile Opens the Select a Statistical or Linear Profile to Load dialog box from which to restore statistics saved from a previous run Save Profile Allows you to save the current run s data to a file Concatenate Profile Loads and concatenates statistics saved from a previous run Clear Profile Clears statistics saved from a previous run View Execution When this option is selected each Percent execution unit or source line in the Statistical Linear Profiling Results window shows the execution percent which is the PC sample count for that line divided by the total nu
42. nd choose Status Legend or Event Legend to display the legends shown below in the State History window Thread Status Fead EH Running 7 Event Blocked L Semaphore Blocked E 1 Semaphore Blockedwith Timeout 99 Device laq Blucked L Device Flag Blocked With Timeout Event Blocked With Timeout Unknown BH Sleeping Thread Events E Thread Destroyed Thread Created B Event Bit Set 1 1 Semaphore Pended Semaphore Posted Device FlagPended 7 Event Pended EH Event Bit Cleared BE ThreadTimedOut O Device setivated D Device FlagPosted 2 3 Unknown EH ThreadSuitched 1 Thread Status Change Window Operations The state history status bar bottom of plot shows the event s details and thread status Event details include the event type the tick when the event occurred and an event value The value for a thread switched event indicates the thread being switched in or out VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 73 Debugging Windows Right click on the plot and choose Data Cursor to activate the data cursor which is used to display event and thread status details Based on the event that occurred the thread status changes Press the keyboard s right arrow key or left arrow key to move to the next or previous event When the data cursor hits a thread switch event it moves to the thread being switch in The yellow triangle to the right of the thread name indicates the currently active thread You ca
43. ng Windows The following illustrations show floating not docked windows The Project window in Figure 3 13 is floating in the main window Float In Main Window is selected Bo Oo a Al TA mix ml Project mizedCand4S__ jie xi misir shell c setupllA DIRIIRc DSP ni Project Figure 3 13 Project Window Floating Example 1 of 3 The Project window in Figure 3 14 is also floating in the main window Float In Main Window is selected E 110 0 077 Ed 9 50 a icix Figure 3 14 Project Window Floating Example 2 of 3 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 47 Window Operations The Project window in Figure 3 15 is floating but not in the main window Float In Main Window is not selected d Project elli miir hell setupllR dsp 7 liy Project Figure 3 15 Project Window Floating Example 3 of 3 Window Position Rules These rules apply to window positions Unless Allow Docking is disabled a window must reside within the main window An Editor window cannot be docked to the main window A window specified as an MDI child cannot be positioned over a docked window Unless the Output window is floating in the main window you cannot position a window specified as an MDI child over the Output window 3 48 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Standard Windows Buttons The standard
44. pending on your processor you have access to various Register windows A Register window enables you to View and change register contents Change the presentation number format Figure 3 28 shows an example of an active register file in a Register window Active Register File x reuse er soe Re SEGRE ad 3 00 5 00 G ld Fle 48 90 969 GAAAAAALAA R11 G t n 9190 R12 seen ae 9995 RLS eno eenonog lann RI4 G00606060606066 al R15 ease Figure 3 28 Active Register File in a Register Window Register window number formats include standard formats such as hexadecimal octal and binary Depending on the DSP other formats are available You can change a register s data directly from a Register window The modified register content is used during program execution Edits to data do not affect your source files To make changes permanent edit the source file and rebuild your project Stack Windows Depending on your processor you have access to various Stack windows such as the Loop Address stack For more information about your processors Stack windows consult online Help 3 68 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Custom Register Windows While debugging you can configure and display custom Register windows Each custom register window has a user specified title and displays only the registers you choose to monitor For example the following c
45. prises two parts Data values e Presentation configuration settings You create data sets and configure the data for each data set A data set is a series of data values in DSP memory You specify the memory location the number of values and other options that identify the data 3 D plots require additional specifications for row and column counts VisualDSP offers many plot presentation options You choose the type of plot for example waterfall and the axis associated with each data set You configure options for titles grids fonts colors and axis presentation You can recall a plot from saved settings You must identify the settings VPS file to be used VisualDSP uses these settings and reads DSP memory to generate and display a plot in a Plot window Plot Window Presentation You can customize the presentation of a Plot window to fit your needs You configure presentation settings from the Plot Setting dialog box which you invoke as follows Right click from within a Plot window e Click the Settings button from in Plot Configuration dialog box The Plot Settings dialog box provides the following tabs Plot Settings El Ei General 2 0 Axis Font Style Data Processing VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 89 Debugging Windows Options on the tab pages enable you to configure the Plot window s presentation On the Style tab page for example you can easily specify symbols for a d
46. roll box Pull tab The scroll boxes inside the scroll bars indicate your vertical and horizontal location in the document Use the mouse to scroll to other parts of the document When the application window is not maximized the resize pull tab appears in the lower right corner of the window Click and drag the pull tab to resize the application window Windows Docked vs Floating en a window is attached to the application s frame it is referred to as a Wh d ttached to the applicat docked window You can detach a window from the main window and move it to another location anywhere on the desktop A floating window stands alone because it is not docked VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 45 Window Operations Depending on your needs you can e Dock a window to the application s main window frame Float a window A window s right click menu provides commands to dock or float the window The Allow Docking option and the Float In Main Window option are mutually exclusive Example of a Docked Window The Project window shown in Figure 3 12 is docked Allow Docking is selected le fa er 5 d Ge EM Pa 0770 s Gl E CI Figure 3 12 Project Window Docked Tip To prevent a window from docking hold down the keyboard s Ctrl key while dragging the window to another position 3 46 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Examples of Floati
47. sion Figure 3 16 and Figure 3 17 show examples of Disassembly windows 010232 010293 010294 010295 010296 010297 010298 010233 010294 01029 010290 010291 01029E Disassembly x 020119 rz2m3 8280114 dmi 8xTT T T S 16 r2 0201156 rzz amp i 020110 dm Oxfffffffd ie 2r2 6260110 dm S xTT T cC 16 r2 182611E REX I S28011F dmi Oxfffffffb iG rl 87501768 dmiextfffffffa ioj rl 920121 Fese 12 modify i4d4 3 0 0 0 0007 axl dm x 4 0 4 1 1 0 00089 4 1 call mrintf 2374 modify 144 3 0 0 0007 axl dm x 4 0 Om i4 m5 aul Figure 3 17 Disassembly Window Example 2 of 2 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Disassembly vvindovvs display code in disassembled form vvhich is useful for temporarily modifying the code to test a change or to view code when no source is available The Disassembly vvindovv allovvs you to examine the assembly code generated by the C C compiler Note To make changes permanent modify the code and rebuild the project Disassembly windows provide e Number format and edit features similar to register windows Dump and fill capability e Symbols at the far left of the window denoting program execution stages and pipeline stages You can ena
48. t the window Hide the window Display the hidden window by choosing Output Window from the View menu Copy selected text Clear the text in the windows Toggle bookmarks VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Environment Customization User Preferences You can customize your work environment Use the tab pages of the Preferences dialog box to specify user preferences These options affect many aspects of the VisualDSP user interface Preferences Ei ES Commands Keyboard Tools l Plugins General Froject Colors E ditor Toolbars These are some of the preferences you can specify Toolbars content and appearance e Keyboard shortcuts modify or add Fonts used in debugging windows and the Output window e Colors in debugging windows and the Output window Project options for files saving synchronization editing project dependencies and reload options e Font color and spacing tabs for various file types in an Editor window VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 37 Environment Customization Other Available Customizations VisualDSP enables you to customize these additional options Editor window appearance source mode vs mixed mode Command auto completion Pipeline support Colors of focused and unfocused windows Workspace specifying saving and loading Visibility of objects such as the status bar Display of the Target Halted message
49. t window and various Debugging windows Project Window w The Project window has a Project tab bj Project When a project is VDK enabled the Kernel tab Kernel also appears as shown in Figure 3 3 Project Test DK dbi WOK Source Files 205 A Kernel folder Linker Files appears only Kernel Files when the project includes VisualDSP j Project kernel support Figure 3 3 Project Window with Kernel Tab VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 17 VisualDSP Windows Project Tab Page The Project tab page displays a tree of your project s folders and files Nodes are arranged in a hierarchy similar to the file structure in Windows Explorer Figure 3 4 shows the node hierarchy on the Project tab page Add folders to qc b organize Your File cpp files File2 cpp d Asm asm Asme asm H ke File icuns indicate eader Files und d Linker Files ulu options ni Project Figure 3 4 Project Window Node Hierarchy on the Project Tab Page 3 18 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Project Nodes The Project window comprises three types of nodes Only one project is permitted A closed folder An opened folder revealing its contents i A file that uses project settings Fil A file vvith options that differ from the project options A file excluded from the current configuration VisualDSP 2 0
50. the Project window to the frame Float the Project window View project properties 3 24 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Project Icon Menu The Project icon liy right click menu is shovvn belovv Build Project Clean New Folder Add File s to Project Project Options Allow Docking Hide Float In Main Window Properties This menu provides a project context which enables you to Build the project Clean delete intermediate and target files Add folders and files View and specify project options View project properties VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 2 25 VisualDSP Windows Folder Icon Menu The Folder icon E right click menu is shovvn belovv Hew Folder Add File s to Folder Delete Folder Allow Docking Hide Float In Main Window Properties The folder menu provides a container context from which to perform these local operations e Add or delete a folder Add files to the folder View folder properties 3 26 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment File Icon Menu The File icon right click menu is shown below Open File Build File Remove File from Project File Options Allow Docking Hide Float In Main Window Properties This menu provides a fi e context from which to perform these operations Open the selected file for editing Build the file
51. tle bar displays the name of the source file Title Bar Right Click Menus A menu like the one below appears when you right click within the VisualDSP title bar or the title bar of a child window Hestore Move Size Minimize Close Alt F 4 From the VisualDSP title bar s right click menu you can e Resize or move the application window Close VisualDSP VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 5 Parts of the User Interface Control Menu Commands in a control menu system menu shown below move size or close a window Restore Move Bize Minimize I aximize Close Alt FA Program Icons Click a program icon to open a control menu Program icon for the application and debugging windows Program icon for Editor windows When you place the mouse pointer over a control menu command a brief description of the command appears in the status bar at the bottom of the application window 3 6 VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs Environment Editor VVindovvs A floating Editor window s control menu includes Next which moves the focus to another window When an Editor window floats in the main application window its program icon resides at the left side of its title bar When an Editor window is maximized the program icon resides at the left end of the menu bar Debugging Windows Fach debugging window has a control menu You can open a debugging w
52. ustom Register window displays the contents of four registers my custom Register window 0000204200 0000204200 0000000000 0000000000 00000000 Figure 3 29 Custom Register Window Example A custom register window appears immediately after you create it Pipeline Window The Pipeline window Figure 3 30 displays the read only contents of the target s instruction pipeline Contents are updated on each processor halt PO Pipeline Address EADDR Invalid 1 DADDR Invalid 2 AADDR Invalid d FADDR Invalid 4 5 PADDE Invalid LADDE Invalid ba m tj te oe df Figure 3 30 Pipeline Window VisualDSP 2 0 User s Guide for ADSP 21xxx DSPs 3 69 Debugging Windows VDK Status Window The VDK Status window Figure 3 31 is available when a DSP executable is built with VDK support DSP h v Dk Status ski Curent Tick H a Idle Thread El Thread H ikedel master Template ID I Priority 5 Stack Address e MumTimesRun 3 EreationTime cycles I RunStartT ime cycles v RunLastTime cycles 5 HunTatalTime cycles Me 5 CreationT ime ticks 8 RunStartTime ticks E RunLastT ime ticks 8 RunTotalTime ticks S Thread 1 kCanvertChannel F lt Thread 2 kVoiceChannel 11 Ready Running kPriantid 0 0000 kdel_ master O 0006 0 00004423 4 H966 559252 479556 2451 0 11 q 0 SemaphoreBlocked Blocked on kNewe
Download Pdf Manuals
Related Search