Home

Suite56 DSP Simulator User`s Manual

1. Command Resulting Simulator Action display Immediately displays all currently enabled registers and memory display p 0 300 Immediately displays p memory addresses 0 through 300 display test asm 7 Immediately displays memory location corresponding to line 7 of source file test asm display xdat Immediately displays memory location corresponding to symbolic label xdat display all Immediately displays all registers plus the enabled memory locations 12 18 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc down Move Down the C Function Call Stack 12 11 down Move Down the C Function Call Stack DOWN n The down command is used to move down the call stack It can be used in conjunction with the where frame and up commands to display and traverse the C function call stack After entering a new call stack frame using down that call stack frame becomes the current scope for evaluation This means that for C expressions the evaluate command acts as though this new frame is the proper place to start looking for variables n Optional The number of frames to move down If no number is specified the Simulator moves down one frame in the call stack Table 12 15 DOWN Commands Command Resulting Simulator Action down Moves down the call stack by one stack frame down 2 Moves down the call stack by
2. 0 00 0 1 7 1 87 Dunpd Watch bist 2 23 fe eu ttt a ad Be RR ih E Pik ee a 1 9 1 9 Setting and Modifying Breakpoints 0 0 0 eee eee 1 10 1 10 Starting the Execution of Instructions with GO 020 0000 1 13 Chapter 2 Controlling Execution 2 1 Starting the Execution of Instructions with GO 0 000202 eee 2 1 2 2 STEP Through InsttuctiDHs ce oc FR POR EN Ee A awe tele 2 1 2 3 TRACE the Execution of Instructions 0 0 00 2 2 24 Executing the NEXT Instruction yas a ket ho base cd ke cha 2 3 2 5 Providing an UNTIL CONO E ee 2 4 2 6 Pausine Execution with WAIT a id Oo dees Giada Oe daabes 2 5 2 7 Allowing the Current Function to FINISH after an UNTIL Condition or a Breakpoint 20 000055 2 6 2 8 Stopping Program EXecutlon dee Ad d 2 7 29 Resettine the Device ds be Las ae ls e Seto Le al ky 2 7 Chapter 3 Object Files and Data Files 3 1 Displaying the Current PATH 0 A AS 3 1 3 2 Savina Object Bless is dd de bn us 3 3 Motorola iii For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 4 Managing Memory and Registers 4 1 Displaying Register Valles 40d aa a Aot 4 1 42 Changing Resister Y alUGS VAS ASE E AA 4 3 4 3 Displaying Memory Values 00 cee eee e 4 3 44 Changing Memory Vales ba we e Rb Ves whoa et A 4 5 4 5 Copying Memory from One Block to Another 000020000 4 6 4 6 Disasse
3. simw ctrlbr Check for CTRL C signal simw cursor line column Move cursor to specified line column simw endwin End the Simulator display simw getch Non translated keyboard input simw_gkey Translated keyboard input simw putc c Output character to terminal simw puts line column text flag Output string to terminal at line and column simw redo device Repaint screen with output from device simw redraw count Redraw screen after scrolling count simw refresh Screen update after buffering output simw scrnest Nest output buffering another level simw_unnest Pop output buffering one level simw winit Initialize window parameters simw_wscr string commandflag Write string and perform logging functions 13 4 1 simw ceol Clear to End of Line simw_ceol This function must clear the display from the current column to the end of line then return the cursor to the previous position Motorola C Library Functions 13 27 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Screen Management Functions 13 4 2 simw ctrlbr Check for CTRL C Signal simw_ctrlbr This function must check for the occurrence of a CTRL C signal from the terminal If the CTRL C signal occurs it sets a flag for the active breakpoint dsp def
4. Commands Resulting Simulator Action wlist lfile lst Opens a list window with the text file Ifile 1st displayed wlist win2 Opens a list window with a window number of 2 with text Ifile txt displayed If TES LE ewe list window 2 already exists replaces the contents with Ifile 1st wlist win2 off Closes list window number 2 wlist off Closes all open list windows wlist win3 Opens a list window with a window number of 3 with no text file displayed 12 52 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc wmemory GUI Memory window 12 49 wmemory GUI Memory window WMemory wn space addr WMemory wn OFF The wmemory command opens a memory window Multiple device windows may be opened for debugging simulations with multiple DSPs wn Optional Window number The window number is an arbitrarily assigned number used to keep track of possible multiple memory windows If no window number is specified when opening a new window the Simulator will automatically assign the next available number space The space parameter indicates the memory space to display addr Optional Used with the first form of the wmemory command Indicates the address in memory at which to begin displaying values OFF Optional Closes the memory window If no window number wn is specified when closing a window all memory windows will be closed
5. Figure 4 6 Changing the Value in Memory 2 Select the memory space that you want to change 3 Under Start Address type the value of the beginning address that you want to change 4 Under End Address type the value of the ending address that you want to change 5 Under Value type the value to which the specified addresses should be changed Keep in mind that all values including the starting and ending values will be changed to the value that you specify The format of this value HEX decimal etc will automatically be the same as the current default radix If you want the format of the value to differ from the default you must use the appropriate radix specifier denotes value as hexadecimal denotes value as decimal denotes value as binary 6 Click OK Motorola Managing Memory and Registers 4 5 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Copying Memory from One Block to Another Section 12 6 change Change Register or Memory Value on page 12 13 provides a complete command description 4 5 Copying Memory from One Block to Another You can copy memory blocks from one location to another The source and destination memory maps may be different This allows you to move data or program code from one memory map to another or to a different address within the same memory map To copy memory from one block to another 1 From the Modify menu choose Copy Memory
6. Table 12 51 WMEMORY Command Command Resulting Simulator Action wmemory pi Opens a memory window for the internal program pi memory space for the current device wmemory xi 0 Opens a memory window for the xi memory space containing address 0 for the current device wmemory win3 x Opens a memory window for memory space x with a window number of 3 for the current device wmemory off Closes all memory windows for the current device wmemory win3 off Closes memory window 3 for the current device Motorola Command Reference 12 53 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc woutput GUI File Output window 12 50 woutput GUI File Output window WOUTPUT OFF The woutput command opens a file output window listing all of the assigned outputs See the output command for more information Multiple output windows may be opened for each separate device when debugging on systems with multiple DSPs OFF Optional Closes the output window Table 12 52 WOUTPUT Commands Command Resulting Simulator Action Opens an output window for the current device woutput Closes the output window for the current device woutput off 12 51 wregister GUI Register window WREGISTER winn periph OFF The wregister command opens a register window Multiple register windows may be opened for each pe
7. move up the tree by selecting a directory from the drop down box that displays the parent directory select a directory from the History menu which shows recently selected directories 4 Click once on the desired directory from the list of subdirectories so that it is highlighted Notice that the highlighted directory appears in the area labeled Directory Motorola Introduction amp Getting Started 1 5 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Loading Object Files 5 Click on Select The selected directory is now the working directory Display the Current PATH to see the absolute path of the working directory To set an alternate path 1 From the File menu choose Path then select Add 2 If appropriate select another drive from the Volumes menu 3 Move up or down the directory tree until the directory you want is in the list of subdirectories 4 Highlight the desired directory by single clicking on it in the list of subdirectories 5 Click on Select The selected directory is now added to the end of the list of alternate paths Display the Current PATH to see the list of alternate paths To clear the alternate paths 1 From the File menu choose Path then select Clear Alternate Path List The list of alternate paths is cleared for all devices The path of the working directory is not cleared The Simulator maintains a separate working directory for each device
8. 4 Usea watch list 5 Set and modify break points 6 Go or step through instructions Motorola Introduction amp Getting Started 1 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting and Clearing the Path When you become familiar with the Simulator you will not have to manually perform each step described above You can position your windows as you like them by saving the windows settings using Window Preferences Command macros can set the path load the program and set up watch expressions Once you are comfortable with these basics you can proceed to more complex debugging using simulated device input and output I O If you are using C code as your source code you use specific commands useful in debugging C source code Refer to the following sections of this manual to learn about more advanced techniques Section 5 1 Introduction to Device I O Input Output on page 5 1 Section 6 1 Introduction to Simulator Configuration on page 6 1 Section 7 1 Introduction to Debugging C Source Code on page 7 1 Section 9 1 Introduction to Expressions on page 9 1 Section 10 1 Using the Tool Bar on page 10 1 Section 12 1 Command Overview on page 12 1 1 5 Setting and Clearing the Path The Suite 56 DSP Simulator uses two types of paths to save and access files the working directory path alternate directory paths The working directory
9. From the File menu choose Log then select Commands Specify the filename and save The default filename extension is cmd A different extension can be used for the sake of consistency we do not recommend this If you specify a filename that already exists you can choose to overwrite the file or append the new commands to the end of the existing file The log file is now recording all Simulator commands whether issued from the menu bar or from the command line in the Command window Use the Simulator commands just as you would during normal program execution Note that there is an exception If you stop program execution while recording commands the stop is not recorded The only way to pause execution from within a macro is to use STEP NEXT TRACE UNTIL WAIT or use a breakpoint If you have any question about whether a command can be recorded think of it this way if it appears in the command window it is recorded To stop recording from the File menu choose Log then select Close From the dialog box select Commands Click OK The command macro is now saved and can be replayed or edited Motorola Macros Scripts and Log Files 8 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Logging Output from the Session Window To run a command macro 1 From the File menu choose Macro 2 Specify the file to run and click Open The command macro begins The commands are displayed in
10. char newfn 80 dsp startup dsp new 0 56116 Create new dsp structure dsp path dv const sv 0 pathwork filter2 lod newfn dsp ldmem 0 newfn Load file into dsp device 0 Motorola C Library Functions 13 11 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points 13 2 15 dsp_rapin Read DSP Analog Pin State int dsp rapin device _index pin retvf int device index DSP device index to be affected by command int pin Pin number to read float retvf Pointer to floating point single precision return value This function reads a dsp analog device pin value It is only valid for device pins which are defined as having analog values such as codec output pins other pins will return 0 0 as the analog value The function return value will be DSP PINVAL L and a floating point value returned in retvf if found or DSP ERR if there is an error condition Use the Simulator s help pin command to produce a list of the valid pin names and each pin s corresponding pin index The device pin number can also be obtained by using the pin name as a key and calling the function dsp_findpin The DSP PINVAL return values are defined in the simdev h file See Example 13 15 Example 13 15 dsp rapin int devn int pinnum int err float aval dsp startup devn 0 dsp new devn 56156
11. device Displays a list of all devices and their current status Also displays the list of possible device types device dv9 Makes device dv9 the current device If device dv9 does not exist creates device dv9 Because no device type is specified it is initialized with the default device type device dvl on Enables device dv1 cycle execution If device dv1 doesn t exist creates it with the default device type device dv0 56116 Creates device dvO and initializes it as device type 56116 Motorola Command Reference 12 15 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc disassemble Object Code Disassembler 12 9 disassemble Object Code Disassembler DISASSEMBLE B byte wide addr _block The disassemble command allows you to review DSP object code in its machine language and assembly language mnemonic format Invalid opcodes are disassembled to a define constant DC mnemonic B byte wide addr block Table 12 11 Optional Constructs the instruction words by taking one byte from each word of memory starting from the specified address Optional Specifies the address or range of addresses to disassemble Symbolic labels and line numbers in source code that correspond to an address in memory can also be used A range of addresses can be specified by typing start addritcount where start addr is the first address o
12. Allocate structure for device 0 a 56156 dsp findpin devn spkp amp pinnum Get pin number for pin named spkp err dsp rapin devn pinnum amp aval Read value of device 0 pin spkp ct ct ct 13 2 16 dsp rmem Read DSP Memory Location int dsp mem device_index memory_map address return value int device index DSP device index to be affected by command enum memory map memory map memory designator unsigned long address DSP memory address to read unsigned long return value Memory value or values will be returned here This function reads the contents of a selected dsp memory location and writes it to return value If the memory map implies a two word value the least significant word will be returned to return value the most significant word will be returned to the return value 1 location This function also returns a flag that indicates whether or not the memory location exists It returns 1 if the location exists O otherwise The memory map parameter selects the appropriate dt memory structure from dt var mem for the selected device These structures are describe in the simdev h file which is included with the Simulator The memory map parameter can be obtained with the function dsp findmem by using the memory name as a key Use the Simulator help mem command for a list of valid memory names The memory map enum is memory map concatenated 13 12 Suite
13. DSP device index to be affected by command char device type Name corresponding to DSP device type This function creates a new dsp structure that represents a DSP device and initializes it It will be necessary to use the dsp unlock function call prior to dsp new if the selected device type is password protected See Example 13 13 Example 13 13 dsp new Create DSP device structures for a three device simulation int devn dsp startup for devn 0 devn lt 3 devn dsp new devn 56116 Create new dsp structures 13 2 14 dsp path Construct Filename dsp path path name base name suffix new name char path name Directory pathname char base name Base filename to be appended to path name char suffix Suffix string to be appended to base name char new name Pointer to return buffer for constructed pathname i This function concatenates the user provided pathname base name and suffix If the base_name begins with a pathname separator or with a device designator the path_name will not be prepended to the base name If the base name already ends with and some suffix the suffix will not be appended See Example 13 14 Example 13 14 dsp path Load a file named filter2 1od from the current working directory for device 0 include simcom h include simdev h extern struct dev const dv const Simulator device structures
14. Go to www freescale com Freescale Semiconductor Inc Assigning an Output File 5 12 Assigning an Output File You can write a single data item from the default device to a file or to the session window terminal The data item may be a single memory location a port a range of pins a peripheral or execution history You must establish a separate output file for each data item written To create an output file 1 From the File menu choose Output then select Open The following dialog box appears Open Output File Ea From Port Radix Output Number Memory ctrl a Decimal 1 x C Port C Fractional ml C Pin Pin C Floating Point C Register m Hexadecimal Lal T Timed Peripheral C Unsigned Ta History iini E C String f File C Extended History m C Terminal Memory reset Eg Memory Space p y Register Address q C Benipheral t E File Name File Cancel Figure 5 2 Creating an Output File 2 Under Output Number select the number you want to assign to this output The default number shown is the next available number Output numbers do not have to be consecutive they can be assigned arbitrarily which means that you can assign output numbers in any way that helps you organize the output files 3 Mark the checkbox labeled Timed if the data contains time data pairs Motorola Device I O and Peripheral Simulation 5
15. The Device button allows you to set the default device to which all commands will be directed yu Breall 2 p QQd1QE h deucb pr Q1QE cyr 244 xe SHHHHHHHHHHHM HHHHHHHHHHHH a qqqQqQQQbbbbbb b QQbbbbbbbbbbQQ x I HHHHHH xHeCHHHHHH r9 HHHHHH SH gietHHHHHH yHeSHHHHHH rh HHHHHH um o 32 00 at bbbbbb 39 aquaaa r5 DDDDAA ns a I Me SHH iS MHHMHHH RS HH AG AMABA tim r2 f99bt7Q rs ty Figure 10 6 Device Button Notice that when you designate another device as the default device that the Session window and Command window automatically reflect information for the new device However other windows such as the Assembly window Source window Stack window etc must be specifically opened to reflect the information for the new default device Section 6 2 Setting the Default DEVICE on page 6 2 provides more information about setting default devices Section 12 8 device Multiple Device Simulation on page 12 15 provides a complete command description 10 6 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Repeat Button 10 8 Repeat Button The Repeat button repeats the last command in the history buffer C yu Breall 2 p 000108 h deucb pr Q1QE rur z244 x SHHHHHHHHHHHH ye HHHHHHHHHHHH 3 q0QQQQQQbbbbbb b QQbbbbbbbbbbqQ XIeSHHHHHH xHeCHHHHHHO r4 HHHHRH nz m
16. device number number of register window Dv00 Register Winl core pe of peripheral L 000000000000 y 000000000000 value of a 00000000000000 b 00000000000000 register x x1 000000 o in hexadecimal y1 000000 pl a2 00 al 000000 a b2 00 b1 000000 b teonnnn or t nnmnn Figure 4 2 Displaying the Register Values Notice that the title bar of the register window indicates the device number where the peripheral resides thenumber of the Register window This number is shown because you can display other Register windows for other peripherals thetype of peripheral The peripheral type is shown for easy identification Several register windows can be open each corresponding to a different peripheral Section 12 10 display Display Register or Memory on page 12 17 provides a complete command description Suite56 DSP Simulator User s Manual For More Information On This Product Go to www freescale com Motorola Freescale Semiconductor Inc Displaying Memory Values 4 2 Changing Register Values You can change the value of the device registers when instruction execution is halted To change the value of a specific register 1 From the Modify menu choose Change Register The following dialog box appears Change Register x Registers Value Cancel Apply Figure 4 3 Changing the Value of Register 2 Selec
17. unsigned long value Pointer to value to write to memory location This function writes a memory block of selected dsp memory The memory map parameter is a memory type that selects the appropriate dt memory structure from dt var mem for the selected device These structures are describe in the simdev h file which is included with the Simulator The memory map parameter can be obtained with the function dsp findmem by using the memory name as a key Use the Simulator help mem command for a list of valid memory names The memory map enum is memory map concatenated with a valid memory name As an example memory map pa refers to off chip pa memory on the 96002 device If the selected memory map requires two word values the least significant word should be at the value location and the most significant word at the value 1 location If the memory address selects an external memory location the dspl xmwr function will be called The dspl mwr function is provided in source form in the file simvmem c and can be modified to simulate special external memory characteristics See Example 13 9 Example 13 9 dsp fmem Write 300 locations beginning at p 200 with the value 4 int devn unsigned long address memval blocksize address 0x200L blocksize 300 memval 4L dsp startup devn 0 dsp new devn 56116 Allocate structure for device 0 a 56116 dsp_fmem devn memory_map_p address blocksize amp memv
18. 0 xfile rd Stores values written to memory location x 0 in output file xfile io The data values will be stored in decimal output ssi0 ssiOfile a Stores values from the SSIO peripheral to output file ssiOfile io Appends to the file if it already exists output a15 a0 afile Stores output values for address pins a15 through a0 to output file afile io output 2 t bg term Outputs time and data pairs from the device BG pin to the terminal Output number 2 is explicitly replaced by this command output 2 off Output number 2 is explicitly turned off by index number reference output spkp spfile rf Outputs untimed single precision floating point values for the analog pin spkp to the output file spfile io output xdatl xfile Stores values written to memory location associated with the symbolic label xdat1 to the output file xfile io The data values will be stored in the default hexadecimal radix output history hisfile Stores device execution history to output file hisfile io output ehistory hisfile Stores extended device execution history to output file hisfile io 12 34 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc path Specify Default Pathname 12 25 path Specify Default Pathname PATH pat PATH pat PATH thname thname pathname The path command d
19. Another way is to type the beginning address followed by the pound sign and the size of the range For example to specify a range from address p 101 to p 107 type p 510047 If the cld file contains symbolic debug line number information breakpoint addresses may also be specified by using line numbers in source code that correspond to an address in memory SS on bn 1 Optional Break number s Used with the third form of the break command to specify one or more break numbers Each break number should be separated by a comma Consecutive numbers can be represented by two periods For example to indicate break numbers 3 through 8 type 3 8 OFF E enable D disable Used with the third form of the break command This form of the beak command is used to indicate that the breakpoint should be removed OFF enabled E or disabled D DR dma read DW write DRW access Used with the fourth form of the break command Indicates the type of access by a DSP DMA Direct Memory Access controller that should be detected for the breakpoint condition to be true Motorola Command Reference 12 11 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc break Set Modify or Clear Breakpoint Table 12 7 BREAK Commands Command Resulting Simulator Action break Display all currently enabled breakpoi
20. See Example 13 6 Example 13 6 dsp findport int devn int pnum unsigned long pmask int ok dsp startup devn 0 dsp new devn 56116 Allocate structure for device 0 a 56116 ok dsp findport devn portb amp pnum amp pmask Get info for portb Motorola C Library Functions 13 7 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points 13 2 7 dsp findreg Get Peripheral and Register Index for Register Name dsp findreg device index reg name periph number reg number int device index DSP device index to be affected by command char reg_name register name int periph_number return peripheral index int reg number return register index This function searches the dt var periph structures for a match to the reg name string provided in the function call If a match is found dsp_findreg returns the peripheral index through periph number the register number through the reg number parameter and 1 as the function return value otherwise it just returns O as the function return value You may also use the Simulator help reg command to obtain a list of the valid periph num and reg num values and reg val size for each register See Example 13 7 Example 13 7 dsp findrg int devn int regnum int pnum int ok dsp startup devn 0 dsp new devn 56116 Alloca
21. lt less than or equal to logical or equal to logical negate gt greater than or equal to amp bitwise and gt greater than bitwise or l not equal to a bitwise one s complement addition A bitwise exclusive or subtraction lt lt shift left division gt gt shift right Command Reference For More Information On This Product Go to www freescale com 12 9 Freescale Semiconductor Inc break Set Modify or Clear Breakpoint See Chapter 5 Device I O and Peripheral Simulation on page 5 1 for more detailed information on expression evaluation The breakpoint expression usually involves comparison of register or memory values Any register name may be used in an expression There are also two special flag variables that may be referenced in the breakpoint expression Table 12 5 Flag Variables in a Breakpoint Expression Variable Expression Returns eof True if an end of file condition occurs in an input file assigned to a peripheral or memory location jump True if a jump change of flow occurs during code execution break action Optional The Simulator can take various actions when a breakpoint is encountered during DSP program execution If no break action parameter is entered the default action is to halt program simulation and to display all enabled registers and memory blocks Alternative Simulator actions can be specified by ent
22. n Optional Specifies the number of the frame in the call stack which will be selected as the current call stack frame After entering a new call stack frame using the frame command that call stack frame becomes the current scope for evaluation The frame command executes instructions until a return from subroutine RTS instruction is executed within the current subroutine The Simulator simply steps checking if any instruction is an RTS If so that RTS is executed and instruction execution halts immediately afterward While stepping if a branch to subroutine or jump to subroutine instruction is encountered tests for the RTS instruction are suspended until execution resumes at the address following the subroutine call Table 12 17 FRAME Commands Command Resulting Simulator Action frame 2 Selects call stack frame number two frame 40 Selects call stack frame number zero innermost frame Motorola Command Reference 12 21 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc go Execute DSP Program 12 15 go Execute DSP Program GO from location R reset to break number bn occurrence count The go command begins execution of DSP code The Simulator fetches de codes and executes instructions in the exact manner as the device that is being simulated The go command will pass control to the Simulator until a breakpoint is r
23. p 00000F 000000 000000 000000 000000 000000 p 000014 000000 000000 000000 000000 000000 p 000019 000000 000000 000000 000000 000000 p 00001e 000000 000000 000000 000000 000000 p 000023 000000 000000 000000 000000 000000 p 000028 000000 000000 000000 000000 000000 p 00002d 0 000n ADONON_ 000000 OnODC 7 073065 Lll hd Figure 4 5 Displaying Memory Values Notice that the title bar of the memory window indicates the device number that you are viewing the number of the memory window This is shown because you can display other memory windows simultaneously e the type of memory space Again you could have several memory windows open each corresponding to a different memory space 4 4 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Changing Memory Values Section 12 10 display Display Register or Memory on page 12 17 provides a complete command description 4 4 Changing Memory Values You can change the values in memory any time instruction execution is halted To change the value in memory 1 From the Modify menu choose Change Memory The following dialog box appears Change Memory X Memory Space p Start Address End Address Value Cancel Apply
24. value will repeat forever Motorola Device I O and Peripheral Simulation 5 7 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Assigning an Input File Table 5 4 Terminal Input Data Data Sample Explanations t 45 This untimed IRQA pin input file prompts you for a new input value every 45 clock cycles ffcc c1000 t ab12 t 6444 This untimed memory file input data prompts you for the third and fifth values that are read from the specified memory location 10 5555 10 3333 43 566 t 800 t This timed port input file prompts you for port input data at cycle 566 and 800 after alternating the input data sequence 5555 3333 three times at ten cycle intervals See Section 6 3 Changing the Radix on page 6 2 for more advanced information about specifying your radix 5 11 Assigning an Input File By providing an input file you can retrieve simulated peripheral memory location or device pin data If you are not sure about the valid peripheral and port names for the device that you are working on use the Simulator s help periph and help port commands in the Command window to obtain a list of the peripherals and ports To provide input data 1 From the File menu choose Input then select Open The following dialog box appears 5 8 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www frees
25. 2 file i o comands 13 20 commands 13 19 filename 13 11 initialization 13 9 memory 13 32 object module 13 10 state file 13 10 13 15 13 23 13 25 13 32 File menu 3 3 Load 6 4 6 5 Macro 8 1 8 2 Save 3 3 filename suffixes cld 13 10 lod 13 10 sim 13 10 13 15 files 6 4 FINISH 2 6 Finish 2 6 FINISH Button 10 5 fonts 6 6 format 5 1 I O files 5 1 Frame 7 2 7 3 frame 12 21 examples 12 21 function 2 6 G Getting Started 1 3 global variables 13 36 Go 12 22 H Help 12 23 help 11 3 hexadecimal 6 3 History 4 8 11 2 I O files 5 1 formatting 5 1 in macro 13 19 13 20 Initialization of a particular device 13 9 of external memory 13 23 initialization Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc by dsp_new 13 11 dsp_init 13 9 of external memory 13 24 of window parameters 13 30 Input 5 8 5 9 5 10 12 24 12 25 examples 12 26 instruction 2 1 2 2 11 5 11 6 interrupt 2 7 Introduction to the DSP Simulator 1 1 IO Redirect 7 5 IO Streams 7 5 L line 1 2 1 3 2 2 List 11 1 12 27 examples 12 27 Load 1 6 6 4 lod 13 10 Log 8 2 LOG Log Commands Profile 12 30 Session 12 30 Profile 12 31 Log Files 8 1 macro command file execution 13 19 13 20 macros 8 1 malloc 13 22 memory access functions 13 1 13 22 13 24 13 25 13 26 13 34 allocation 13 22 change values 12 13 change values in 4 5 di
26. 3 Set Register or Memory Radix Dialog Box 040 6 4 6 4 Window Preferences Dialog BOX do 6 6 7 1 Displaying the Call Stack outs ia 7 1 7 2 Moving Up the Call Stack iae ss Raw ERR RERO m 7 2 7 3 Moving Down the Call Stack etica eva cnn ede 7 3 Motorola xiii For More Information On This Product Go to www freescale com Freescale Semiconductor Inc 7 4 Dynamic Display of C Function Calls oo ooooooomooo o o 7 4 7 5 Displaying the Type of a C Variable or Expression 7 6 9 Evaluating an E xXpressION cios eoe Ad 9 9 2 Displaying a Value in a Watch List oo ooooooomoom oo 9 8 10 1 GO BOR s it edd ec ad iii A 10 2 10 2 SOP BUON ote tech oe teh etek UE SAIL bie bao a 10 2 10 3 Step B ttoi ss Tentative CABE hy the hn eae dE de Stele 10 3 10 4 Next DUtOTkc esi rer ada doo c dal doe eo 10 4 10 5 PR cis e pi tta oS vta PRS RIA 10 5 10 6 Device BUOD as ko dr RU ROI ER e OU AD OR UE bara OG ol e oe 10 6 10 7 R epeab DUO c doe bh bc con Eco To eae EDT Dio Et DA Yt 10 7 10 8 Reset BUttOH a es AAA ac La PA OEC P Ce Ut eta 10 8 11 1 Displaying the Current BreakpoidtS oo oooooooocoomooo o 11 1 11 2 Displaying the Command Window esee eese 11 3 11 3 Pausing Output to the Session Wind0W ooo ooocoocooocoom o 11 5 11 4 Using the Assembly WIBHIOW eue xa as ERA TUE SE SE VS 11 5 11 5 Displaying the Source Window oo ooocoococooconcco ooo 11 6 xiv Su
27. C expressions can be used enclosed in braces c expression Symbolic references can be used if symbols have been loaded from the object module The values are re calculated and output at each break in execution To display a value in a WATCH list 1 From the Windows menu choose Watch The following dialog box appears 2 Select the window number where you want the expression to appear You will want to do this when you have more than one Watch window open Add Watch Expression To Window x Window Radix C Decimal Fractional C Figating Rorrt C Hexadecimal Unsigned Expression Default 1 J cxi Cancel Apply Figure 9 2 Displaying a Value in a Watch List 9 8 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting Up and Modifying a Watch List 3 Under Expression type in the expression that you want to appear in the Watch window 4 Under Radix select the radix format in which you want the variables displayed Click OK The expression that you specified now appears in a Watch window If the expression you type is not valid you will get an error message explaining why the expression is not valid A C expression which refers to C variables can only be evaluated in the context in which the watch is established That is while all the variables used in the expression are in scope So if one or more of th
28. CH QUUM HHHHHH yHeSHHHHHH r HHHHHH nm 5H a2 a0 at bbbbbb 39 0QQQQQ r5 jbbbbQQ n5 a Wwe HH Wie SHHHHHH o H SHHHHHH rAs HHHHHH nim CH ra jbh5b n 9 Figure 10 7 Repeat Button The Repeat button repeats the last command in the history buffer that is listed in the Command window Pressing this button is the same as clicking on the last command in the history buffer in the Command window and pressing lt ENTER gt Section 11 3 Command Window on page 11 2 provides more details about the Command window Motorola Simulator Tool Bar 10 7 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Reset Button 10 9 Reset Button The Reset button resets the current device piv Hes 02920 Cw o di 2 amp 2 i fi yu Breall 2 p QQd1QE h deucb pr Q1QE cuc z244 xe SHHHHHHHHHMHM y HHHHHHHHHHHH a qqqQqqqQQbbbbbb b qQbbbbbbbbbbQd x efHHHHHH xHeCHHHHHH r9 S HHHHHH naM gt giefHHHHHH yHeSHHHHHH o rA9 S HHHHHH nmi i a2 fqq 21 fbbbbbb 39 aquaaa rs jbbbbQd ns a hye HH SAHARA SHAH A HA nhai e e r2 f99bt7Q rs fut Figure 10 8 Reset Button The Reset button generates a RESET command for the current device The device will be reset in the same operating mode Section 2 9 Resetting the Device on page 2 7 provides more information about resetting devices Section 12 29 reset Reset Device or State on
29. Closes the stack window for the current device 12 55 wwatch GUI Watch window WWATCH win num 4n radix reg addr expression c_expression WWATCH win num 4n OFF The wwatch command opens a watch window Multiple watch windows may be opened one for each watch list or for separate devices when debugging on systems with multiple DSPs win num Optional An arbitrary number assigned to each watch window Multiple lists can be defined each being displayed in a separate window If no number is specified the Simulator will automatically add the watch item to the lowest numbered watch window 3n Optional Watch item number If no number is specified the Simulator will assign the next available number to the watch item radix Optional The radix parameter indicates the number base in which to display the watch item The radix may be specified by using d for decimal for fractional h for hexadecimal or u for unsigned If no radix is specified the default radix of the specified item is used The default display radix of a watch item can be changed with the radix command reg addr expression c expression This parameter specifies the watch item to be added to the watch list A watch item can be a register address expression or C expression OFF Optional Closes the specified watch window If no window number is specified closes all watch windows 12 56 Suite56 DSP Simulator User s Manual Moto
30. DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting and Modifying Breakpoints For example it may be convenient to allocate breakpoints so that one function is assigned breakpoints 1 to 10 another uses 11 to 20 and so on 3 Under Type select whether you are setting a breakpoint at a particular memory location register or expression 4 If the breakpoint is being set for a memory location or a register under Access specify what kind of access should be detected by the breakpoint For example if you want the breakpoint to detect when a memory location is read but not written to select Read If you want either a read or a write to be detected chose Read Write 5 If the breakpoint is being set on a memory location under Memory select the memory space If the memory address you want to break on is a single location as opposed to a memory block type in the address under Start Address and leave the End Address blank If you want to set the breakpoint on a range of addresses type in the Start Address and End Address of the range Setting a range means that the breakpoint will be recognized if any address in the range is accessed You can also define a line number in the source program as a breakpoint The source program must contain symbolic debug line number information Specify the line number under Start Address in the form filenameQ line number
31. DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc output Assign Output File 12 24 output Assign Output File OUTPUT n T addr port periph pin group OFF TERM file RD RF RH RU RS A 0O C OUTPUT fn T history OFF TERM file A 0O C OUTPUT fn T ehistory OFF TERM file A O C The output command stores data from a peripheral memory location or device pin to a specified destination The output data is in ASCII format Valid port peripheral and pin names for the device can be listed with the help port help periph and help pin commands There are three forms of the output command The first form allows output from a memory location port peripheral or pin to either a file or to the Session window TERM The second form of the output command creates a continuous log of the device execution addresses and disassembled opcodes The output format is similar to the output generated by the Simulator history command The third form of the command which specifies ehistory is an extended version of the output history command Additional execution history information is logged to the output file Only one of output history or output ehistory may be active tn Optional The number that will be assigned to this output Output numbers do not have ot be consecutive they can be assigned arbitrarily which means that you can assign o
32. For a complete description of the steps required to load object files in either COFF or OMF format see Section 1 6 Loading Object Files on page 1 6 To save a COFF cld file 1 From the File menu choose Save then select Memory COFF 2 Under Memory Space select the memory to save 3 Under Start Address type the beginning address of the memory block 4 5 Under File Name type in the filename of the file to save or click on File to browse Under End Address type the last address of the memory block the directories The extension default is cld Click OK If no directory path is specified the file will be saved in the working directory If the file already exists you will be prompted to decide whether to overwrite the file or to append it The Simulator does not store symbolic debug information To save an OMF lod file l From the File menu choose Save Then select Memory OMF 2 Under Memory Space select the memory to save 3 Under Start Address type the beginning address of the memory block 4 5 Under File Name type in the filename of the file to save or click on File to browse Under End Address type the last address of the memory block the directories The extension default is lod Click OK If no directory path is specified the file will be saved in the working directory If the file already exists you will be prompted to decide whether to overwrite the file or to append it
33. Information On This Product Go to www freescale com Freescale Semiconductor Inc Resetting the Device Mode MO C MI C M2 C M3 C M4 C M5 C MB C M C M8 Cancel Figure 2 4 Resetting the Device Registers 4 Select the operating mode to which the device should be reset 5 Click OK To reset the simulation memory 1 From the Execute menu choose Reset then select State This resets the entire Simulator state to the start up condition All breakpoints are cleared the memory is initialized and all logging and I O files are closed Section 12 29 reset Reset Device or State on page 12 39 provides a complete command description 2 8 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 3 Object Files and Data Files To efficiently manage and use the object files and data files in your project you will need to understand how the Simulator sets and clears paths For a complete discussion of the working directory path and alternate directory paths see Section 1 5 Setting and Clearing the Path 3 1 Displaying the Current PATH The DSP Simulator uses two types of paths to save and access files the working directory alternate directories The Simulator uses the working directory as the default directory when searching for an input file assuming no path is explicitly specified with the i
34. Remember to enclose C expressions in curly brackets For example gi i 3 Click OK 4 The data type is displayed in the Session window If the result of the expression is a storage location for example a variable name or an element of an array the address of the storage location will be displayed in addition to its data type Section 9 1 Introduction to Expressions on page 9 1 provides more information about expressions Section 12 35 type Display the Result Type of C Expression on page 12 45 provides a complete command description Another useful tool for debugging C source code is the watch list See Section 1 8 Using a Watch List on page 1 9 for step by step instructions on setting up a watch list 7 6 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 8 Macros Scripts and Log Files 8 1 Creating and Running a Command Macro The command macro is a useful tool for performing multiple Simulator commands The command macro is useful for performing commonly repeated tasks such as setting the path loading source programs and setting up watch windows However a macro can consist of almost any Simulator command The command macro is a standard ASCII text file you can create or edit it with any text editor You can also create the macro by recording commands to a log file To record a command macro 1 2
35. Section 12 30 save Save Simulator File on page 12 40 provides a complete command description Motorola Object Files and Data Files 3 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Saving Object Files 3 4 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 4 Managing Memory and Registers To efficiently manage the memory and registers associated with your project you will need to know how to reset the device For a complete discussion of the resetting the device see Section 2 9 Resetting the Device 4 1 Displaying Register Values You can display the device registers and memory any time instruction execution is halted To display the value in a register 1 From the Windows menu choose Register The following dialog box appears Open Register Window x Peripheral core gt Cancel Apply Figure 4 1 DSP Simulator Register Dialog Box 2 Select the peripheral that you want to view 3 Click OK The register values for the peripheral that you chose appear in a register window For example if you choose to display the register values for the core you see a window similar to the following Motorola Managing Memory and Registers 4 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Displaying Register Values
36. Streams select the type of stream that you want redirected stdin stdout or stderr 3 Under File Name specify the filename to redirect the stream or click on the File button to browse for the file 4 Click OK To stop redirecting the stream I O 1 From the File menu choose IO Streams then select Off 2 Select the type of stream to stop redirecting 3 Click OK Motorola Debugging C Source Code 7 5 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Display the Type of a C Variable or Expression To display redirected stream I O 1 From the Display menu choose Redirected IO Streams 2 View the Session window The redirected stream will be listed with the filename to which the streams are being directed Section 12 28 redirect Redirect stdin stdout stderr for C Programs on page 12 38 provides a complete command description 7 7 Display the Type of a C Variable or Expression You can display the type of a C variable or expression Keep in mind that you might need to move up or down the call stack to select the desired expression context You can also change the current context when monitoring C function calls To display the type of a C variable or expression 1 From the Display menu choose Type The following dialog box appears Type EG Expression Ce Cancel Apply Figure 7 5 Displaying the Type of a C Variable or Expression 2 Type in the expression
37. The following dialog box appears Copy Memory Ed m From To Memory Space Memory Space P s gt y Start Address Start Address End Address Cancel Apply Figure 4 7 Copying Memory from One Block to Another 2 In the From Memory Space pane select the memory space to copy from Then in the text boxes type the starting address and the ending address of the block that you want copied 3 In the To Memory Space pane select the memory space to copy to Then type the starting address to begin copying values 4 Click OK Section 12 7 copy Copy a Memory Block on page 12 14 provides a complete command description 4 6 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Disassembling Code Stored in Memory 4 6 Disassembling Code Stored in Memory You can disassemble instructions that have been loaded so that you can review DSP object code in its assembly language mnemonic format Invalid opcodes are disassembled to a define constant DC mnemonic To disassemble code stored in memory 1 From the Display menu choose Disassemble then select Memory Block The following dialog box appears Disassemble Memory Ed Memory Space gt yl Start Address End Address Cancel Figure 4 8 Disassembling Code Stored in Memory 2 Select the memory space that you want to disassemble 3 Inthe Start Address
38. cross reference is an offset to the proper dev xpval structure from the xportval pointer in the dev var structure Each pin has a primary name and a possible alternate peripheral function pin name You may modify the names or delete or add clt xpin structures from this array but do not change the portindex and pinmask members of the dt xpin structures mem 56116 This array of dit memory structures can be modified to change parameters associated with the DSP56116 memory attributes The name member is the memory name used by the simulator commands to reference the memory space The memsize member determines the size of arrays allocated for on chip memory The memattr member determines whether the memory is located on or off chip and whether it is ram or rom The romval pointer can point to initialization data for the memory space If itis NULL the memory space will be initialized to zero at start up and in response to the reset s command Although you may change the memory names memory size memory attributes and initialization data do not add or delete dt memory structures from the mem 56116 array pval This array of dt_xpidata structures is used by the simulator to initialize the input pin data in the dev var xportval structures at simulator start up and in response to the reset s command 13 38 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semi
39. default device 1 From the Modify menu choose Device then select Set Default The following dialog box appears Set Default Device Ed Device Cancel Figure 6 1 Set Default Device Dialog Box 2 Under Device select the number of the device that you are choosing as the default device the current device 3 Click OK The Simulator applies commands to the default device When you change the default device the Session window and the Command window automatically change to reflect the information for the new device However other windows such as the Assembly window Source window etc do not automatically update themselves to reflect the new device This allows you to display the information for separate devices in separate windows To see the information for the new default device open another Assembly window Source window etc Section 12 8 device Multiple Device Simulation on page 12 15 provides a complete command description 6 3 Changing the Radix You can change the default radix number base that the Simulator uses for command parameters and other values that you input You can also change the radix used to display specific registers and memory locations As an alternative to changing the default radix you can also denote the number base of a value by preceding it with a dollar sign an apostrophe 7 or a percent sign 6 2 Suite56 DSP Simulator User s Manual Motorola For More Information On Thi
40. file in several ways For example if you are in a long development session and want to take a break save the Simulator state to a state file so as not to lose your place Or if a particular part of a program is proving troublesome you can save the state just before the problem area simplifying the setup for repeated attempts to isolate the problem There are of course many reasons for saving the state of the Simulator To load a Simulator state file 1 From the File menu choose Load then select State 2 Specify the name of the state file in the dialog box 3 Click on Open The current state of the Simulator is replaced by the state information in the sim file Motorola Simulator and Device Configurations 6 5 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Changing and Saving Window Preferences 6 5 Changing and Saving Window Preferences You can save the window positions when you exit the Simulator Thus when you restart the Simulator it restores all windows to their positions on exit To save window status on exit 1 From the File menu choose Preferences Preferences x All Windows n Assembly Source Register Memory Stack of 4 b Font PF Save Window Status On Exit ENTM Figure 6 4 Window Preferences Dialog Box 2 Mark the checkbox labeled Save Window Status On Exit 3 Click OK 6 6 Suite56 DSP Simulator User s Manual Motorola
41. files and continue without issuing the continuation prompt Motorola Command Reference 12 43 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc trace Trace Through DSP Program 12 34 trace Trace Through DSP Program TRACE count breakpoints CY cycles LI lines IN instructions H halt at The trace command gives a snap shot of the enabled registers and memory after each instruction or clock cycle is executed Execution terminates after count number of cycles lines or instructions count Optional When included the count parameter indicates the number of cycles lines instructions to execute before halting execution If no count is specified the default count is 1 CY cycles LI lines IN instructions Optional As the default the trace command steps in instruction increments if viewing the assembly or register screens and in source line increments if viewing the source screen The CY LI and IN options permit cycles source line or instruction increments to be specified explicitly H halt at breakpoints Optional The default is to ignore all breakpoints while the trace command is executing The h parameter enables halting at breakpoints Table 12 37 TRACE Commands Command Resulting Simulator Action trace Executes one instruction or source line depending on the display mode then stops and displays the enabl
42. for an OMF file lod will be appended to filename If the COFF file extension cld is specified explicitly in the filename the memory contents will be stored in the DSP COFF object file format The Simulator does not store symbolic debug information in the output COFF object file An address block can be specified by typing start_addr count where start addr is the first address of the block and count represents the size of the block An address block can also be specified by typing start_addr end_addr For example p 5420 indicates 20 locations beginning from program memory location 5 p 5 24 indicates program memory locations 5 through 24 The name of the file to be saved Optional The CA O or C parameter may be used to indicate append overwrite or cancel if the file fi 1ename already exists If you do not specify this parameter and the filename already exists you will be prompted during command execution to make the decision to append overwrite or cancel Appending is not a valid option for state files Table 12 33 SAVE Commands Command Resulting Simulator Action sessionl a save p 0 Sff x 0 20 Saves all three memory maps to OMF file session1 lod If the file already exists append to it save s lunchbrk Saves the Simulator state to filename lunchbrk sim save s lunchbrk b c Saves the Simulator state to filename lunchbrk b If the file already exists cance
43. is a lower level function that does not invoke the user interface modules for pathname and automatic lod suffix extension The entire pathname must be specified The function returns 1 if the load is successful O if an error occurred loading the file See Example 13 11 Example 13 11 dsp Idmem Create DSP device structures for a three device simulation int devn int err dsp startup for devn 0 devn lt 3 dewvn dsp new devn 56116 Create new dsp structures Load device 1 with a program named filter2 lod err dsp_ldmem 1 filter2 1lod 13 2 12 dsp load Load All DSP Structures from State File int dsp_load filename char filename Full name of State File to be loaded This function loads the Simulator state of all devices from a specified Simulator state file It is not necessary to allocate the device structures prior to calling dsp_load This function does not invoke the user interface modules for pathname and automatic sim suffix extension the entire filename must be specified See Example 13 12 13 10 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points Example 13 12 dsp load int err dsp startup err dsp load lunchbrk sim 13 2 13 dsp new Create New DSP Device Structure dsp new device index device type int device index
44. is the primary path The Simulator uses the working directory as the default when searching for an input file assuming no path is explicitly specified with the input filename The Simulator automatically searches alternate paths if it does not find the requested input file in the working directory This allows you to keep object files source files and command macros in separate directories but still access them without constantly redefining the path To set the path of the working directory 1 From the File menu choose Path then select Set A dialog box similar to the following appears 1 4 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting and Clearing the Path parent directory list of subdirectories Select Directory History Special View Volumes win NTA y moves up directory tree gds553 GUI56 MA GUIS63 moves down directory tree currently selected directory Directory au Cancel Open Figure 1 2 Setting the Working Directory Path 2 If appropriate select another drive from the Volumes menu 3 Move up or down the directory tree until the directory you want is in the list of subdirectories There are a number of ways to do this You can move up and down the directory tree with the left arrow and right arrow buttons move down the tree by double clicking in the list of subdirectories
45. its device type evaluate evaluates expressions in five different radices help displays device specific information in the Session window path defines the working directory and alternate directories quit ends a simulation session radix specifies the default number base hex decimal etc used during expression evaluation and data entry or data display system executes an operating system command in two modes wait specifies a number of seconds to pause a macro before proceeding to the next command list displays a specified source file when symbolic debug is in effect view allows selection of the Simulator display mode Source Assembly or Register unlock provides password enabling of unannounced device types 12 1 6 Windows Controls The following commands control the display of windows and are particularly useful in writing command macros wasm opens an assembly window displaying addresses labels and mnemonics wbreakpoint opens a breakpoint window displaying current breakpoints wcalls opens a C call stack window wcommand opens a command window winput opens an input window wlist opens a list window displaying contents of a specified file wmemory opens a memory window woutput opens an output window wregister opens a register window wsession opens the Session window wsource opens a Source window wstack opens a hardware stack window wwatch opens a watch window displaying expressions that have been specified for the watch l
46. page 12 39 provides a complete command description 10 8 Suite56 DSP Simulator User s Manual For More Information On This Product Go to www freescale com Motorola Freescale Semiconductor Inc Chapter 11 Displaying Information 11 1 Display the Current Breakpoints It is often useful to display the enabled and disabled breakpoints for the current device by opening the Breakpoints window To display the current breakpoints 1 From the Windows menu choose Breakpoints A dialog box shows a list of the breakpoints set for the current device The following dialog box shows an example of a list of six breakpoints Dv00 Breakpoints Al ES Break 1 jump n Break 2 r p 00c420 h disabled Break 3 r p 00a100 00af00 s Break H4rah Break 5 21 h Break 6 p 000108 h oft Figure 11 1 Displaying the Current Breakpoints Disabled breakpoints such as the Break 2 are indicated with the word disabled 2 Double click on a breakpoint from the list to toggle it from disabled to enabled or from enabled to disabled Breakpoints that were set by double clicking on the Source window such as Break 5 above are identified by the line number Breakpoints that were set by double clicking on the Assembly window such as Break 6 above are identified by the address Motorola Displaying Information 11 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc D
47. processing The memory map parameter will be a value representing the memory space being accessed Use the Simulator s help mem command to obtain a list of the valid memory space prefixes See Example 13 38 Example 13 38 dspl xmwr Write value of 3 to xe memory location 5 of device 2 unsigned long address int devindex int ok unsigned long newval int store address 5L devindex 2 newval 3L store 0 ok dspl xmwr devindex memory_map_xe address newval store 13 4 Simulator Screen Management Functions The following sections describe functions which are provided in source code form in the Simulator package in the file scrmgr c These functions define all the operations associated with Simulator terminal I O The code includes conditionally compiled sections for MSDOS UNIX and VMS The code is provided to allow customization of the Simulator terminal I O for a particular environment The user may for example wish to 13 26 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Screen Management Functions redefine the control characters used by the Simulator so that they map to some particular terminal Table 13 4 is a quick reference list of the Simulator screen management functions Table 13 4 Screen Management Functions Function Description simw ceol Clear to end of line
48. register screens and the next line if viewing the source screen The 1i and in parameters permit source line or instruction increments to be specified explicitly H halt at breakpoints Optional As the default all breakpoints are ignored while the next command is executing The h parameter enables halting at breakpoints Table 12 26 NEXT Commands Command Resulting Simulator Action next Steps over subroutine calls or macros or otherwise just advances one instruction or source line depending on the display mode and displays the enabled registers and memory blocks next li Steps over subroutine calls or macros or otherwise just advances one source line and displays the enabled registers and memory blocks next in Steps over subroutine calls or macros or otherwise just advances one assembly instruction and displays the enabled registers and memory blocks next 10 Executes the equivalent of the next 10 instructions halting to display the enabled registers and memory blocks only after the tenth instruction is completed next 10 1i Executes the equivalent of the next 10 lines halting to display the enabled registers and memory blocks only after the tenth line is completed next 10 h Executes the equivalent of the next 10 instructions halting to display the enabled registers and memory blocks after the tenth instruction is complete or when a breakpoint is encountered 12 32 Suite56
49. start addr is the first address of the block and count represents the size of the block An address block can also be specified by typing start addr end addr For example p 5 20 indicates 20 locations beginning from program memory location 5 p 5 24 indicates program memory locations 5 through 24 The radix command is used to define the default number base However the default radix can be overridden on a individual usage basis Hexadecimal constants can always be specified by preceding the constant with a dollar sign Likewise a decimal value can be specified by preceding the constant with a grave accent and a binary value may be specified by preceding the constant with a percent sign Table 12 30 RADIX Commands Command Resulting Simulator Action radix Displays the default input radix currently enabled radix h Changes default input radix to hexadecimal Hexadecimal constant entries no longer require a preceding dollar sign but any decimal constants will require a preceding grave accent radix f x 0 10 x0 y0 a b Change the display radix for the specified registers and memory blocks to floating point Motorola Command Reference 12 37 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc redirect Redirect stdin stdout stderr for C Programs 12 28 redirect Redirect stdin stdout stderr for C Programs REDIRECT STDIN OFF file REDIRECT ST
50. streams Enable Disable Handling of I O for C Programs STREAMS ENABLE DISABLE The streams command is used to enable and disable the handling of input and output on the host side for C programs By default streaming is enabled When enabled all input and output that is done in the C program running on the device is handled on the host side For example when an fopen call is made in the C program running on the DSP call the host software intercepts the call and does the fopen on the host side If the streams command is performed with no parameters the current status of streaming is displayed in the Session window ENABLE DISABLE Optional Enables or disables streaming Table 12 35 STREAMS Commands Command Resulting Simulator Action streams e Enables handling of C input output All input output calls done in a C program running on the DSP will be handled by the host software e g fopen fwrite printf etc streams d Disables handling of C input output 12 42 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc system Execute System Command 12 33 system Execute System Command SYSTEM C continue immediately system command parameter list The system command allows you to execute an operating system command from within the Simulator Operating system commands invoked f
51. the Simulator will lead you to the best configuration of these windows 1 8 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Using a Watch List 1 8 Using a Watch List You can watch the contents of a specific memory location register or expression by setting up a Watch list The Watch list is updated every time program execution is stopped The expression that you watch can be valid even if it is not calculated during program execution You can use C expressions but you must enclose them in curly brackets c expression You can use symbolic references if you have loaded symbols from the object module To add an item to a Watch list 1 From the Windows menu choose Watch The following dialog box appears Add Watch Expression To Window Ed Window Radix C Decimal C Fractional Floating Paint Hexadecimal Unsigned Expression Default 1 al xi Cancel Apply Figure 1 4 Add ltem to a Watch List 2 Under Window select the window number that you want to assign to the Watch window This is useful when you have more than one Watch window open 3 Under Expression type the expression that you want to appear in the Watch window If the expression is a C expression enclose it in curly brackets c_expression 4 Under Radix select the radix format in which you want the variables displayed 5 Cl
52. the Command window as they are executed The commands are also echoed in the Session window along with any output that is generated You can stop the command macro by choosing Stop from the Execute menu or by clicking on the Stop Button on the tool bar Section 2 6 Pausing Execution with WAIT on page 2 5 and Section 2 8 Stopping Program Execution on page 2 7 provide more information about stopping or pausing a command Section 12 21 log Log Commands Session Profile on page 12 30 provides a complete command description 8 2 Logging Output from the Session Window You can log all output that the Simulator displays in the Session window This is especially useful if you are capturing information that spans several screens To log output displayed in the Session window From the File menu choose Log then select Session 2 Specify the filename that you want to give the log file and click OK The Simulator writes all output that is echoed in the Session window to the log file you specified Section 12 21 log Log Commands Session Profile on page 12 30 provides a complete command description 8 2 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 9 Expressions 9 1 Introduction to Expressions The Simulator allows you to use an expression in most places where a constant is valid For example an expression can
53. the Simulator following a system command after loading the device state with the load s filename command or after switching devices in a multiple device simulation with the device command 13 4 40 simw redraw Redraw Screen After Scroll Count simw redraw count int count Number of lines to scroll before repainting the Screen This function scrolls up or down count lines in the display buffer then redisplays the text in the buffer at that position This function only displays the text that is in the scrolling portion of the display Motorola C Library Functions 13 29 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Screen Management Functions 13 4 11 simw_refresh Screen Update After Buffering Output simw_refresh The Simulator buffers screen output in implementations other than MSDOS in order to decrease the time spent repainting the screen This provides a fixed display effect for consecutive trace commands The simw_refresh function will take care of refreshing the screen following buffering of screen output It also resets the sim const scrnest variable to O to coincide with the non buffered status of the screen following the refresh 13 4 12 simw scrnest Increase Screen Buffering One Level simw scrnest This function increments a counter to signify the screen output buffering level The companion simw unnest and simw refresh functions provide the ou
54. the family device number contain the non display versions of the same object modules In addition the libraries with the prefix cm followed by the family device number contain object modules required by both the display and non display versions of the Simulator As an example relinking the display version of the sim56100 Simulator requires libraries ww36100 and cm56100 a non display version of the Simulator requires the libraries nw56100 and cm56100 13 2 Simulator Object Library Entry Points The following is a quick reference list of the higher level Simulator entry points provided in the Simulator object libraries The prefix indicates whether or not the function is available in the non display version of the Simulator Function names beginning with the prefix dsp or dspt are available to both the display and non display versions of the Simulator while function names beginning with sim are only available when using a display version of the Simulator The dspt_ prefix indicates a device dependent function The xxxxx suffix on these indicate a device family number Lower level Simulator functions which have a prefix of dspl siml or dsptl are not intended for direct access by the user s program They are not described in this document The higher level functions listed below are described in detail in Section 13 2 1 dspt masm xxxxx Assemble DSP Mnemonic through Section 13 2 30 sim gtcmd Get Command String from Terminal Tabl
55. the input data The source pin may optionally be preceded by a device number to allow the simulation of pin to pin connections in systems consisting of multiple devices Used with the third form of the input command this parameter represents the destination address All subsequent reads of this memory address will reference the address specified as the input source Used with the third form of the input command this parameter represents the address of the source of the input data The address may optionally be preceded by a device number DVn The third form of the command causes the Simulator to read the memory location of a specified source specified by dvn addr each time the destination memory address is accessed for a read This enables simulation of a system consisting of multiple devices via dual port memory The source device must exist new devices can be added with the device command prior to issuing this form of the input command Table 12 21 INPUT Commands Command Resulting Simulator Action input xe 800 xfile rd Gets values for external memory location x 800 from input file xfile io The data values are stored in decimal form in the input file input ssi0 hfile Gets values for the SSIO peripheral from input file hfile io Motorola Command Reference 12 25 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc input Assign Input Fi
56. to exit its reset state in a pre defined operating mode Once the Simulator is active you can change the operating mode under program control by changing the value of the device Operating Mode Register OMR The mode pins are automatically configured to the default operating mode You can set the operating mode that the device simulates following a simulated hardware reset when resetting the device registers and memory The full external memory map of the device is by default RAM memory The large external memory space is simulated using a virtual memory technique which automatically pages memory blocks to disk if the operating environment fails to allocate the required space in memory By changing memory values you can change the on chip bootstrap and data ROM areas You can specify the bootstrap ROM by using PR as the memory space designator You can specify the data ROMs by XR or YR Loading an assembler output file with the Simulator load can also modify the bootstrap ROM or data ROM areas You can reinitialize the ROM areas by selecting Reset from the Execute menu then selecting State Motorola Simulator and Device Configurations 6 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting the Default DEVICE Section 2 9 Resetting the Device on page 2 7 provides more information 6 2 Setting the Default DEVICE You can specify a particular device as the default device To set the
57. two stack frames Motorola Command Reference 12 19 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc evaluate Evaluate an Expression 12 12 evaluate Evaluate an Expression EVALUATE B binary D dec F float H hex U unsigned expression c expression The evaluate command is used as a calculator for evaluating arithmetic expressions or for converting values from one radix to another B binary D dec F float H hex U unsigned Optional Specifies the radix in which the result of the expression will be displayed If a radix is not specified in the evaluate command line the current default radix specified by the radix command will be used expression c expression An expression consists of an arithmetic combination of operators and operands An operand can be a register name a memory location or a constant value The order of evaluation of an expression s operators will be associated from left to right Parentheses can be used to force the order of evaluation of the expression A more extensive discussion of the expressions which are valid for the evaluate command is presented in Chapter 5 Device I O and Peripheral Simulation on page 5 1 When values held in the device s registers or memory spaces are used in an expression that involves a multiply operator the display radix specified by the radix command will determine whether the operation execute
58. used by the Simulator 13 28 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Screen Management Functions 13 4 7 simw putc Output Character to Terminal simw putc c char c This function outputs the character in the variable c at the current cursor and column position It advances and updates the sim const curclmvariable This function is not used often by the Simulator and it is not very time critical when it is used so the Simulator implementation is just to call simw puts after creating a temporary string from the character c 13 4 8 simw puts Output String to Terminal simw puts line column text flag int line Move cursor to this line for output int column Move cursor to this column for output char text Text string to be output int flag O non bold 1 bold on off by 2 all bold This function outputs a string to the terminal at the specified line and column Highlighting of output can be enabled either by setting the 1ag parameter to 2 or by enclosing text in curly braces and setting the 1ag parameter to 1 13 4 9 simw redo Repaint Screen With Output From Device simw redo device int device Use screen buffer from this device to repaint Screen This function repaints the screen from a device screen buffer It is normally only called when re entering
59. 11 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Assigning an Output File 4 Under To select the destination of the output file Select File if the output data is to be written to a file Select Terminal if you want to write the output data to the Session Window 5 Under From select the source of the data a memory space port pin register a peripheral history or extended history Selecting History writes a record to the file for each instruction execution The last record in the file is always the next instruction to be executed Selecting Extended History writes a record for each execution cycle The Simulator logs additional execution history information to the output file including device wait state cycles and bus arbitration cycles and indication of other stall conditions The extra information is preceded by double asterisks in the log file The output record contains a record number the optional timing field containing the cycle number and the data value For the history file the data is comprised of the pc program counter the instruction word s in hexadecimal and the disassembled instruction 6 If the output data is being written from a memory space under Memory select the memory space Then type in the Address referencing the output data Assigning output to a memory address causes all subsequent writes of that memory address to write the data to the output file 7 If the
60. 12 15 12 9 disassemble Object Code Disassembler 0000000 12 16 12 10 display Display Register or Memory 0200 e ee eee eee 12 17 12 11 down Move Down the C Function Call Stack oo o ooo oo 12 19 12 12 evaluate Evaluate an EXpressiots oar eae ep t 12 20 12 13 finish Execute Until End of Current Subroutine 12 21 12 14 frame Select C Function Call Stack Frame oo ooo ooooocmom oo o 12 21 12 15 go Execute DSP POSTA ra 12 22 12 16 help Simulator Help Texts X mIRC RC AS RE ROI 12 23 12 17 history Disassemble Previously Executed Instruction 12 24 12 18 input Assign Input File ocu xs ep y o eve EL DERE ES 12 24 12 19 list Last Source File Lines id 12 27 12 20 load Load DSP Files or Configuration ooooooooccoororocoonooo 12 28 12 21 log Log Commands Session Profile e E Re OR 12 30 12 22 more Enable Disable Session Paging Control o oo oooooom oo o 12 31 12 23 next Step Over Subroutine Calls or Macros llle 12 32 12 24 output Assign Output File 2 ko eee E Erit Rs 12 33 12 25 path Specify Default Pathnamie uo secre E Rees 12 35 12 26 quit Quit Simulator Session xi335 eR aaa 12 36 12 27 radix Change Input or Display Radix 0 0 0 eee ee eee 12 36 vi Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Se
61. 2 44 WATCH commands Command Resulting Simulator Action watch ro Adds register rO to the watch list watch x 0 Adds x 0 to the watch list watch count 1 total Adds the given C expression to the watch list watch h count 2 Adds the given C expression to the watch list in display radix hex watch b flag Adds the given C variable to the watch list in display radix binary watch r0 x 0 Adds the expression r0 x 0 to the watch list watch Displays the watch list watch 3 off Removes item number three from the watch list watch off Removes all items from the watch list Motroa ommandReferene 1249 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc wbreakpoint GUI Breakpoint Window 12 43 wbreakpoint GUI Breakpoint Window WBREAKPOINT OFF The wbreakpoint command opens a breakpoint window Multiple device windows may be opened for debugging simulations with multiple DSPs OFF Optional Closes the wbreakpoint window Table 12 45 WBREAKPOINT Commands Command Resulting Simulator Action wbreakpoint Opens a breakpoint window for the current device wbreakpoint off Closes the breakpoint window for the current device 12 44 wcalls GUI C Calls Stack window WCALLS OFF The wcalls command opens a C call stack window Multiple device windows may be opened for debugging simulations with multiple
62. 3 5 Non Display Simulator Topics concerning the non display version of the Simulator are discussed in section 13 5 Section 13 6 Multiple Device Simulation Simulation of multiple dsp devices is fully supported by the dsp library functions Section 13 6 Multiple Device Simulation discusses topics related to simulating and interconnecting multiple dsp devices Section 13 7 Reserved Function Names provides a description of the public function names used by the Simulator Motorola C Library Functions 13 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc C Object Libraries Section 13 8 Simulator Global Variables describes the global variables used by the Simulator Section 13 9 Modification of Simulator Global Structures describes modifications that can be made to the Simulator global structures Section 13 10 Modification of Device Global Structures describes modifications that can be made to device global structures 13 1 C Object Libraries The Simulator software includes object libraries that enable you to rebuild the Simulator A separate set of display and non display libraries are provided so that you have the option of generating a non display version of the Simulator The libraries with the prefix ww followed by the family device number contain the display version of the object modules The libraries with the prefix nw followed by
63. 30 40 s Display enabled registers and memory and continue program simulation if any program memory location from decimal 30 to 40 is accessed break 1 10 d Disable breakpoints numbers 1 through 10 break j 2 Halt if the C expression j 2 is true break e Enable all breakpoints 12 12 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc change Change Register or Memory Value 12 6 change Change Register or Memory Value CHANGE register block addr block expression The change command can be used to change the value of a register memory location block of registers or block of memory register _block addr _block expression Optional The register s or adress es to be changed A register block is represented by two register names separated by two periods For example r0 r3 means registers rO through r3 A memory block can be specified using start_addr count where count represents the size of the block An address block can also be specified with start addr end addr For example p 5420 indicates 20 locations beginning from program memory location 5 p 5 24 indicates program memory locations 5 through 24 Optional The expression to write to the specified register or address The expression can be a simple constant value or a complex expression with multiple operators and operands A more extensiv
64. 56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points with a valid memory name As an example memory_map_pa refers to off chip pa memory on the 96002 device This function calls the function dsp1_xmra if the address indicates an external memory location The dspl xmrd function is provided in source form in the file simvmem c and can be modified to simulate special external memory characteristics See Example 13 16 Example 13 16 dsp rmem Read X memory location 100 from device 0 unsigned long address unsigned long memval int devn int ok dsp startup devn 0 dsp new devn 56116 Allocate structure for device 0 a 56116 address 100L ok dsp rmem devn memory map x address amp memval 13 2 17 dsp rpin Read DSP Pin State int dsp rpin device index pin int device index DSP device index to be affected by command int pin Pin number to read This function reads a dsp device pin value The return value may be DSP_PINVAL_L DSP PINVAL H DSP PINVAL F DSP PINVAL 0 or DSP_PINVAL 1 indicating low output high output floating low input or high input pin state Use the Simulator s help pin command to produce a list of the valid pin names and each pin s corresponding pin index The device pin number can also be obtained by using the pin name as a k
65. 6 run 8 2 S Save 3 3 6 6 12 40 examples 12 40 SAVE Save Simulator File 12 40 screen buffer 13 30 scripts 8 1 scrmgr c 13 26 13 35 Session 11 4 11 5 sim 13 10 13 15 sim docmd 13 19 sim gmcmd 13 20 sim gtcmd 13 21 Simulator 1 1 Introduction 1 1 memory configuration 6 1 preferences 6 6 running 1 3 simvmem c 13 22 13 34 simw_ceol 13 27 simw ctrlbr 13 28 simw cursor 13 28 simw endwin 13 28 simw_getch 13 28 simw gkey 13 28 simw putc 13 29 simw puts 13 29 simw redo 13 29 13 35 simw redraw 13 29 simw refresh 13 30 simw scrnest 13 30 simw unnest 13 30 simw winit 13 30 simw wscr 13 30 Source 11 6 source code 1 6 3 3 7 1 11 5 Stack 7 2 7 3 11 7 start execution 1 13 state 2 7 2 8 6 4 6 5 resetting 2 7 state file create 13 15 13 25 l iv load 13 23 Step 12 41 examples 12 41 step 12 32 STEP Step Through DSP Program 12 41 STEP Button 10 3 stop 2 6 2 7 STOP Button 10 2 Streams 12 42 examples 12 42 STREAMS Enable Disable Handling of I O for C Programs 12 42 subroutine 2 6 syntax 12 4 of commands 12 4 System examples 12 43 SYSTEM Execute System Command 12 43 T terminal i o functions 13 1 Trace 2 3 12 44 examples 12 44 TRACE Trace Through DSP Program 12 44 Type 7 6 examples 12 45 TYPE Display the Result Type of C Expression 12 45 U unlock 12 15 UNLOCK Unlock Password Protected Device Type 12 46 ntil 2 4 examples 12 46 UNTIL S
66. 6 2 Device 5 11 5 12 6 2 11 3 Device Button 10 6 Device IO 5 1 6 2 introduction 5 1 device type 12 15 directory 3 1 3 2 disable 11 1 11 6 Disassemble 4 7 11 5 Display 6 6 11 1 11 2 11 3 11 5 Display menu 3 1 Path 3 1 3 2 Down 7 2 7 3 12 19 down examples 12 19 dsp alloc 13 22 dsp exec 13 6 dsp findmem 13 6 dsp findpin 13 7 dsp findport 13 7 dsp_findreg 13 8 dsp fmem 13 9 For More Information On This Product Go to www freescale com dsp_free 13 8 DSP_GEOI 13 33 DSP_GEOR 13 33 DSP_GILLEG 13 33 dsp_init 13 10 dsp_ldmem 13 10 13 32 dsp_load 13 11 13 32 dsp_new 13 11 13 16 13 31 dsp_path 13 11 dsp_rapin 13 12 dsp_rmem 13 13 dsp_rpin 13 13 13 35 dsp_rport 13 14 13 35 dsp_rreg 13 15 dsp_save 13 15 13 32 dsp_startup 13 15 dsp_unlock 13 16 dsp_wapin 13 16 dsp_wmem 13 17 dsp_wpin 13 17 13 35 dsp_wport 13 18 13 35 dsp_wreg 13 19 dspl_xmend 13 22 dspl_xmfree 13 23 dspl_xminit 13 23 dspl_xmload 13 23 dspl_xmnew 13 24 dspl_xmrd 13 24 dspl_xmsave 13 25 dspl_xmstart 13 25 dspl_xmwr 13 26 dspt_masm_xxxxx 13 5 dspt unasm xxxxx 13 5 during 2 6 E edit 11 5 11 6 enable 11 1 11 5 entering commands 1 2 11 2 Evaluate 9 1 9 2 execute 2 7 GO command 12 22 pause 2 6 Execute menu 2 7 Finish 2 6 GO 1 13 1 15 2 1 Reset 2 7 2 8 Stop 2 7 executing 13 6 13 19 13 33 Exit 6 6 expression 12 20 EVALUATE 12 20 expressions 9 1 Freescale Semiconductor Inc introduction 9 1 F Features 1
67. DOUT STDERR OFF file A O C REDIRECT OFF The redirect command is used to redirect the stdin stdout stderr for C programs It allows you to redirect stdin from a file and redirect stdout stderr to files Performing the redirect command with no parameters will display the status of each I O stream in the Session window Beware that no I O processing or handling of redirection occurs if I O streaming has been disabled with the streams command STDIN OFF file STDOUT STDERR A 0 C OFF Used with the first form of the redirect command The STDIN parameter indicates that the standard input is to be redirected Used with the first and second forms of the redirect command The OFF parameter indicates that the redirection of the specified input output is to be turned off In the context of the first form of the redirect command the file parameter indicates the name of the file from which standard input will be provided In the context of the second form of the redirect command the file parameter indicates the name of the file to which standard output or standard error will be written In all cases 1f no file extension is specified when specifying file with the redirect command the Simulator will assume the cio file extension Used with the second form of the redirect command The STDOUT STDERR parameter indicates that standard out or standard error is to be redirected
68. DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 2 Controlling Execution 2 1 Starting the Execution of Instructions with GO The most common way to initiate program execution is with GO When you indicate GO to the Simulator 1t fetches decodes and executes instructions in the exact manner a device would if you were debugging an actual device The GO command executes the program until one of the following occurs the Simulator reaches a breakpoint e you indicate STOP the Simulator encounters a debug instruction Section 1 10 Starting the Execution of Instructions with GO on page 1 13 provides a step by step task description for executing with GO from the GUI interface 2 2 STEP Through Instructions You can specify the number of instructions lines or cycles the Suite56 Simulator executes before stopping Stepping through instructions is a quick way to specify the execution of a number of instructions without setting a breakpoint The STEP instruction is similar to the TRACE instruction except that the display of the registers and memory blocks occurs only after the specified number of cycles lines or instructions have been executed If the next instruction to be executed calls a subroutine or begins execution of a macro the subroutine or macro is not executed However it is possible to allow the current function to FINISH To st
69. DSPs OFF Optional Closes the stack window Table 12 46 WCALLS Commands Command Resulting Simulator Action wcalls Opens a C call stack window for the current device wcalls off Closes the C call stack window for the current device 12 50 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc where GUI C Calls Stack window 12 45 wcommand GUI Command window WCOMMAND OFF The wcommand command opens a Command window Only one Command window may be open The current device is always the device that is related to the Command window Use the device command to change the current device OFF Optional Closes the command window Table 12 47 WCOMMAND Commands Command Resulting Simulator Action wcommand Opens a command window wcommand off Closes the command window for the current device 12 46 where GUI C Calls Stack window WHERE n The where command displays the C function calls in the Session window It can be used in conjunction with the frame down and up commands to display and traverse the C function call stack n Optional This parameter indicates the number of frames of the call stack to display where n is the number of frames Optional the plus sign and the minus sign can be used to indicate the whether to display the call stack beginnin
70. For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 7 Debugging C Source Code 7 1 Introduction to Debugging C Source Code The Suite56 DSP Simulator provides several features specifically used in debugging C source code The following topics will help you understand how best to use the Simulator for debugging C source code When you compile your source code remember to include debug information Section 12 1 Command Overview on page 12 1 also provides complete description of the commands discussed in this chapter 7 2 Displaying the Call Stack You can display the C function call stack beginning with the frame you specify To display the call stack 1 From the Display menu choose Call Stack 2 The following dialog box appears Display Call Stack E r Frames Innermost pos C Dutermost 1 2j Cancel Figure 7 1 Displaying the Call Stack Motorola Debugging C Source Code 7 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Moving Up and Down the Call Stack 3 Under Frames select whether you want to display the innermost or outermost frames 4 Under Count specify the number of frames you want to display 5 Click OK If you are writing a script it can be useful to use the WHERE command to display the C function call stack Section 11 7 Stack Window on page 11 7 provides more informat
71. For example to set a breakpoint on line 22 of the source file named clrmem cld under the Start Address you type clrmem 22 6 If the breakpoint is being set on a register under Register select the register 7 Tf the breakpoint is being set on an expression under Expression type the expression Remember if the expression is a C expression enclose the expression in curly bracket c expression A breakpoint expression can be any logical expression that is valid for the Motorola DSP Assembler Table 1 1 provides a list of operators that can be used in the breakpoint expression Table 1 1 List of Operators Operator Function less than amp E amp logical and lt less than or equal to logical or equal to logical negate Motorola Introduction amp Getting Started 1 11 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting and Modifying Breakpoints Table 1 1 List of Operators Continued Operator Function gt greater than or equal to amp bitwise and gt greater than bitwise or l not equal to bitwise one s complement addition A bitwise exclusive or subtraction lt lt shift left division gt gt shift right 8 The breakpoint expression usually involves comparison of register or memory eof values You can use any
72. Freescale Semiconductor Inc Suite56 DSP Simulator User s Manual Release 6 3 DSPS56SIMUM D Document Rev 3 0 07 1999 DSP e r3 pi SUE DSP Development Tools M MOTOROLA For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Suite56 OnCe and MFAX are trademarks of Motorola Inc Motorola reserves the right to make changes without further notice to any products herein Motorola makes no warranty representation or guarantee regarding the suitability of its products for any particular purpose nor does Motorola assume any liability arising out of the application or use of any product or circuit and specifically disclaims any and all liability including without limitation consequential or incidental damages Typical parameters which may be provided in Motorola data sheets and or specifications can and do vary in different applications and actual performance may vary over time All operating parameters including Typicals must be validated for each customer application by customer s technical experts Motorola does not convey any license under its patent rights nor the rights of others Motorola products are not designed intended or authorized for use as components in systems intended for surgical implant into the body or other applications intended to support life or for any other application in which the failure of the Motorola product could create a situation
73. HHHHH yHeSHHHHHH rA HHHHHH nm SH 32 QQ ai bbbbbb 39 0QQQQQ rs jbbbbQQ ns a oe SHH SARA SHA rA HHHHHH tie SH d r3 5Dbbbqq ns a Figure 10 4 Next Button If the next instruction to be executed calls a subroutine or begins execution of a function all the instructions of the subroutine or function are executed before stopping The enabled registers memory and other updated values are then displayed In order to recognize functions the symbolic debug information for the program code must be loaded To execute the next instruction from the toolbar 1 Make sure that program execution is halted and that the Source window is not open 2 Click on the Next button on the toolbar The Simulator executes the next assembly instruction 10 4 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Finish Button To execute the next line from the toolbar 1 Make sure that program execution is halted and that the Source window is open If the Source window is not open the Simulator automatically executes the next instruction in the Assembly window rather than then next line in the Source window 2 Click on the Next button on the toolbar The Simulator executes the next executable line of code in the Source window Comments lines in the source code are ignored Notice that the values in the Register window the Memory window and all o
74. However all devices share the same alternate directory paths To be safe always check the path of the working directory after adding a device or setting the default device Remember that in order to change the path of a device that is not currently the default device you must first change the default device discussed in Section 6 2 Setting the Default DEVICE and Section 12 25 path Specify Default Pathname on page 12 35 in Chapter 12 Command Reference 1 6 Loading Object Files You can load DSP Object Module Format OMF files or DSP Common Object File Format COFF files directly into the Simulator memory OMF files are identified by the od extension COFF files are identified by the cld extension Motorola s Suite56 DSP Assembler generates the OMF file format To generate COFF files with the Suite56 Assembler you can use the cldlod utility to generate lod files the cldlod utility converts files from COFF file format cld to OMF file format lod You can also generate both of the file formats with the DSP Simulator when you save object files 1 6 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting Up the Display Environment To load a COFF cld file 1 From the File menu choose Load then select Memory COFF 2 Under Load select memory debug symbols or both The Simulator will process the symbol and line number info
75. Memory Block Table 12 8 CHANGE Commands Continued Command Resulting Simulator Action change r0 r3 0 pi 30 300 0 Changes the values in registers rO through r3 to 0 x Sfffe 55 pc 100 internal p memory addresses hexadecimal 30 through 300 to 0 x memory address hex fffe to hex 55 and the program counter to decimal 100 12 7 copy Copy a Memory Block COPY f rom addr block to addr The copy command copies memory blocks from one location to another The source and destination memory maps may be different This allows you to move data or program code from one memory map to another or to a different address within the same memory map from addr block to addr The memory address or memory address block from which to copy A memory block can be specified using start_addr count where count represents the size of the block An address block can also be specified with start_addr end_addr For example p 5 20 indicates 20 locations beginning from program memory location 5 p 5 24 indicates program memory locations 5 through 24 The memory address to which the data will be copied If an addr block was specified this address will be the beginning address to which the data will be copied Table 12 9 COPY Commands copy puss100 9500 x 500 Copies the values located in internal program memory addresses hexadecimal 100 through hexadecimal 500 to x memory starting at
76. Motorola Introduction amp Getting Started 1 13 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Starting the Execution of Instructions with GO e you indicate STOP the Simulator encounters a debug instruction To start executing instructions with GO 1 From the Execute menu choose GO You will see the following dialog box doa Goto Breakpoint Go From T Address Reset Break Number 1 Eg Address Gel om Da zi Cancel Apply Figure 1 5 Execution Instructions with Go 3 Under Go From choose whether to GO from an address or RESET If you choose Reset the Simulator simulates the reset sequence in the processor The instruction pipeline instruction counter and cycle counter will be cleared before program simulation begins The device registers are reset and execution begins at the reset exception address 4 If you chose to GO from an address under Address type in the address from which you want to begin executing instructions If you leave the address blank execution will begin from the current program counter value If you specify an address the instruction pipeline instruction counter and cycle counter will be cleared before program simulation Execution will begin from the address you specify 5 Select the Go to Breakpoints checkbox if you want to stop execution at a particular breakpoint If selected all other
77. Optional The CA O or C parameter may be used to indicate append overwrite or cancel if the filename file already exists If you do not specify this parameter and the filename already exists you will be prompted during command execution to make the decision to append overwrite or cancel Optional Used with the third form of the redirect command When used as the only parameter the OFF parameter turns off all redirected STDIN STDOUT and STDERR Table 12 31 REDIRECT Commands Command Resulting Simulator Action redirect Displays the redirect list which shows each of the three streams that can be redirected along with where they are being redirected to redirect stdin input Redirects the C stdin standard input stream from the file input cio cio is the default ex tension 12 38 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc reset Reset Device or State Command Resulting Simulator Action redirect stdout output txt Redirects the C stdout standard output stream to the file output txt redirect stderr errors Redirects the C stderr standard error stream to the file errors cio redirect stdout output o Redirects the C stdout stream to the file output cio overwriting the file if it already exists redirect stdout output a Redirect
78. P It is usually best to precede such hexadecimal constants by a dollar sign to distinguish them from registers of the same name Section 4 1 Displaying Register Values on page 4 1 provides more information on register values 9 2 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Using Assembler Debug Symbols 9 5 Using Assembler Debug Symbols The Simulator load command processes the symbol and line number information present in a COFF format object file cld file which has been generated with the assembler s g option If symbol information has been loaded the evaluator will accept symbol names or source file line numbers and translate them into an associated memory address In general you can reference a symbol name in the Simulator just as it was defined in the original source file except that symbol names which conflict with a Simulator register name must be preceded by the character A symbol name may be further delimited by specifying a containing section name in the form section nameG8symbol name with the character being used as the separator The section name global may be used for the global section If a symbol is specified without a preceding section name the evaluator assumes the section containing the current pc Line numbers may be expressed simply as a decimal integer preceded by the character when referring to a line
79. Simulator cycle count and a data value are stored each time a word is written In the untimed output mode a single data value is stored each time a word is written No tristate information is stored in the port output data 5 8 Memory Data When assigned to a memory location the input file data value supplies the value that is read when the Simulator references that memory location The least significant memory bit maps to the least significant bit of the data value The input data value can be in decimal binary hexadecimal or floating point form The Simulator interprets the data based on the input radix specified in the input command The default input radix is hexadecimal If a data value contains a decimal point the data will be input as a floating point value overriding the input radix specification The number base of data values can also be denoted by preceding the data value with a dollar sign an apostrophe or a percent sign input as hexadecimal input as decimal input as binary The Simulator applies untimed memory input data values each time the device performs a read operation on the memory location In other words the input file acts like a stack of input data each successive data value is retrieved from the stack file when a read operation occurs The Simulator applies timed input data values to the memory location at the specified relative time intervals t ime or at the exact Simulato
80. This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points 13 2 29 sim gmcmd Get Command String from Macro File sim gmcmd device index command string int device index DSP device index to be affected by command char conmmand string Pointer to return buffer for command line This function reads the next Simulator command string from a macro file The sim docmd function will normally determine that a command is a macro open the macro file and set the device structure sim const in macro flag The sim gmcmd function returns the next line from the open macro file each time it is called It will clear the in macro flag at the end of macro execution or if an invalid macro command is processed The command string buffer should be at least 80 characters See Example 13 29 Example 13 29 sim gmomd Execute the macro command file startup cmd on dsp device structure 0 include simcom h include simusr h extern struct sim const sv const Simulator device structures char command string 80 int devn dsp startup devn 0 dsp new devn 56116 Create new dsp structure sim docmd devn startup Begin the startup macro while sv const in macro sim gmcmd devn command string Get command string from macro file sim docmd devn command string Execute command string 13 2 30 sim gtcmd Ge
81. VAL F DSP PINVAL N or DSP_PINVAL P indicating low high floating negative pulse or positive pulse Use the Simulator s help pin command to produce a list of the valid pin names and each pin s corresponding pin index The device pin number can also be obtained by using the pin name as a key and calling the function dsp findpin The DSP PINVAL values are defined in the simdev h file See Example 13 25 Example 13 25 dsp wpin include simcom h include simdev h Write the reset pin of device 0 with a high level int devn int pinnum dsp startup devn 0 dsp new devn 56116 Allocate structure for device 0 a 56116 dsp findpin devn reset amp pinnum Get pin number for pin named reset dsp wpin devn pinnum DSP PINVAL H Motorola C Library Functions 13 17 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points 13 2 26 dsp wport Write DSP Port State dsp wport device index port mask data force int device index DSP device index to be affected by command int port Port number to write unsigned long mask Pin mask for this port unsigned long data Port data value unsigned long force Port forcing state This function forces data on a dsp device port from outside the device The value supplied in the data parameter contains th
82. VALUATE evaluate an expression 11 Click OK To clear a breakpoint 1 From the Execute menu choose Breakpoints then select Clear A dialog box displays a list of all the current breakpoints 2 Selectthe breakpoint you want removed so that it is highlighted If you are clearing consecutive breakpoints you can click and drag to highlight more than one breakpoint Or hold down the CTRL key while clicking on breakpoints to select more than one 3 Click OK to delete the breakpoints you selected Breakpoints will not be renumbered For example if you have set breakpoints 1 2 and 3 and then clear breakpoint 2 the Simulator will number the remaining breakpoints 1 and 3 The Simulator does not renumber the breakpoints it retains the original number you assigned to the breakpoints For more detailed information see Section 9 1 Introduction to Expressions on page 9 1 and Section 11 1 Display the Current Breakpoints on page 11 1 Section 12 5 break Set Modify or Clear Breakpoint on page 12 8 provides a complete command description 1 10 Starting the Execution of Instructions with GO The most common way to initiate program execution is with GO When you indicate GO to the Simulator it fetches decodes and executes instructions in the exact manner a device would if you were debugging an actual device The GO command executes the program until one of the following occurs the Simulator reaches a breakpoint
83. _xmsave Save DSP External Memory to State File int dspl_xmsave device_index fp int device_index DSP device index to be affected by command FILE fp Pointer to file opened in write mode This function must save the external memory state to a Simulator state file The dspl_xmsave call is the last step of the dsp_save function which saves a Simulator state file The file pointer provided to dsp1_xmsave will have been opened with fp fopen filename w and the remainder of the Simulator state will have already been saved to the state file The return value of dspl_xmsave should be 1 if successful O if an error occurred The dsp_save function will close the file following the dsp1_xmsave call See Example 13 37 Example 13 37 dspl_xmsave Call of dspl xmsave from dsp save int status FILE fp fp fopen filename w Saving of other Simulator state structures status dspl xmsave devindex fp 13 3 9 dspl xmstart Start DSP External Memory Access dspl xmstart device index memory map int device index DSP device index to be affected by command enum memory map memory map memory designator The core simulation calls this function during the first clock cycle of each external memory access The memory map parameter will be a value as returned by dsp_findmem Use the Simulator help mem command for a list of valid memory names The memory m
84. a number to a breakpoint definition or to specify an existing breakpoint A break number can be any positive decimal integer in the range 1 to 99 If you do not specify a breakpoint number the Simulator automatically assigns the lowest unused number expression Optional A breakpoint expression can be any logical expression that is valid for the DSP Assembler If the cld file contains C symbolic debug information breakpoint expressions can include any valid C expression for the program Remember to enclose C expressions in curly brackets Another useful form of a breakpoint expression breaks at an address only when the opcode from that memory location is being decoded for next cycle execution Other forms of the breakpoint expressions that check the value of the pc register or check for a read of a p memory location are less definitive due to the pipelined prefetch of the device This special form of breakpoint is indicated by specifying the breakpoint expression as a single address in p memory 12 8 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Motorola Freescale Semiconductor Inc break Set Modify or Clear Breakpoint The following is a list of operators that can be used in the breakpoint expression Table 12 4 Breakpoint Operators Operator Operator Function less than ES logical and
85. a sequence within the parentheses to repeat forever Timed values can appear within a repeat group and in this case the relative time mode t ime should be used Table 5 1 Repeat Punctuation Input Data Data Sample Explanation 1FF 20 Repeats the untimed data item 1FF twenty times 5 CC 10 33 45 Repeats the sequence of timed data pairs 5 CC 10 33 five times CC354 CC333 C7000 Repeats the untimed data sequence CC354 CC333 C7000 forever 145 045 Repeats the untimed data sequence 1 1 1 1 10000 0 forever 5 4 Comments Any information following a semicolon up to the end of line is considered to be a user comment and is not interpreted as input data or timing Example 5 1 Comment Code FFC 333 972 next three p memory data words In this example the first three data values are applied to the device The information following the semicolon is a user comment 5 2 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Peripheral Data 5 5 Timing Information If the t key character is specified in the input or output command then the assigned file will contain cycle timing information preceding each piece of I O data The timing information relates to the Simulator cycle counter value cyc register at the time when the data transfer occurs The timing information is always expressed in decimal If the timing in
86. address hexadecimal 500 copy x 04100 p 0 Copies one hundred memory locations beginning at x memory address 0 to p memory beginning at address O copy lab 14100 lab 2 Copies one hundred memory locations beginning at the memory location corresponding to symbolic label lab 1 to memory beginning at the address corresponding to symbolic label lab 2 copy xdat xdat 40 ydat Copies 40 memory locations beginning at the address corresponding to symbolic label xdat to the block beginning at the address corresponding to symbolic label ydat copy p 0 20 p 40 Copies p memory addresses 0 through 20 to p memory addresses 40 through 60 12 14 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc device Multiple Device Simulation 12 8 device Multiple Device Simulation DEVICE DVn dev_type ON OFF X The device command allows you to create and manage simulated target systems consisting of multiple DSP devices It allows you to add a simulated device on which commands can be executed to disable or enable existing devices or to delete a device Ifthe device command is typed with no parameters a list of all the possible device numbers that you can assign will be displayed including each device s status and device type DVn dev type ON OFF Optional Device munber The device number
87. al 13 2 10 dsp_init Initialize a Single DSP Device Structure dsp_init device index int device index DSP device index to be affected by command This function initializes a device to the same state that existed following the dsp new call which created it It is equivalent to performing the Simulator reset s command AII memory spaces are cleared the registers are reset breakpoints and input output file assignments are cleared See Example 13 10 Motorola C Library Functions 13 9 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points Example 13 10 dsp init dsp startup dsp new 0 56116 Create new dsp structure Other Simulator commands dsp_init 0 Reinitialize device 0 13 2 11 dsp Idmem Load DSP Memory from OMF File int dsp ldmem device index filename int device index DSP device index to be affected by command char filename Full pathname of OMF format file to be loaded This function loads the memory space of a specified dsp device from an object file The file may be created as the output from the DSP MACRO ASSEMBLER or by using the Simulator save command and may be either COFF format or lod format In order to specify a COFF format file the filename suffix must be cld A filename with any other suffix is assumed to be in lod format This
88. al decimal etc 12 If the input data is coming from a file under File Name type in the name of the input file or click on the File button to browse for the file The default filename extension is io The data file may contain only data in which case each access to the object returns the next value in the data file Alternatively the file may contain time data pairs In this case each pair specifies the value to input at or after the specified cycle count Repeated accesses will return the same value until the simulated cycle count reaches the time specified in the next time data pair 13 Click OK If you are entering the data from the terminal keyboard the Interactive Input dialog box appears which prompts you for the first data value Type in the first data value and click OK After you enter a value and click OK the Interactive Input dialog box appears ready for the second data value Continue to enter values and click OK until you have entered all values When you have entered all values click Cancel in the Interactive Input dialog box The Simulator creates a file in the working directory that contains the data you entered from the keyboard The filename will be similar to term0000 i0 You can reuse this file as you would any other input file Section 12 18 input Assign Input File on page 12 24 provides a complete command description 5 10 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product
89. alog box appears 2 2 Suite56 DSP Simulator Users Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Executing the NEXT Instruction Count Increment 1 I C Cycles i C Lines Instructions Halt at Breakpoints Cancel Apply Figure 2 2 Trace Program Execution 2 Under Increment select Cycle Line or Instruction 3 Under Count specify the total number of cycles lines or instructions to trace Execution stops after this number of cycles lines instructions 4 Select the checkbox labeled Halt at Breakpoints if you want to observe breakpoints 5 If you do not select the checkbox the Simulator ignores breakpoints and does not halt program execution 6 Click OK Notice that the Simulator updates values in the register window the memory window and all other windows after it executes each cycle line or instruction It updates these values at the speed of execution so they will pass by very quickly In order to review the values scroll back through the Session window once execution has stopped It is often useful to log output from the Session window Log Section 12 34 trace Trace Through DSP Program on page 12 44 provides a complete command description 2 4 Executing the NEXT Instruction You can specify the number of instructions or lines the Simulator executes before stopping When you execute the next specific number of
90. am execution is halted and that the Source window is not open 2 Click on the Step button on the toolbar The Simulator executes the next assembly instruction To step one line at a time from the toolbar 1 Make sure that program execution is halted and that the Source window is open If the Source window is not open the Simulator automatically executes the next instruction in the Assembly window rather than then next line in the Source window 2 Click on the Step button on the toolbar The Simulator executes the next executable line of code in the Source window Comment lines in the source code are ignored Notice that the values in the Register window the Memory window and all other Simulator windows are updated each time you click on Step Section 2 2 STEP Through Instructions on page 2 1 and Section 2 4 Executing the NEXT Instruction on page 2 3 provide more information about stepping through instructions Motorola Simulator Tool Bar 10 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Next Button Section 12 31 step Step Through DSP Program on page 12 41 provides a complete command description 10 5 Next Button The Next button executes the next instruction or line yu Breal 2 p 000198 h deucb pr Q1QE rur 244 xe SHHHHHHHMHHHHH y HHHHHHHHHHHH a qqqQQQQQbbbbbb b QQbbbbbbbbbbQd x fHMHHHH xH SHHHHHH r S HHHHHH neH gie H
91. ameters are used to specify whether the logfile will contain only commands C or all session output S A keycharacter A O or C may be specified to select append overwrite or cancel if the filename already exists If no append overwrite option is included with the log command you will be prompted during command execution If no suffix is specified for fi le the suffixes cmd is automatically added to the command log file similarly log is automatically added to the session log file The P parameter specifies that a program execution profile is to be created The program to be profiled must be loaded before issuing the log p command Both memory and symbols must be loaded Information is gathered as program execution is simulated and the profile output files are written when the profiling is terminated with the command log off p For profile logging two suffixes are used a log file which contains plain text which may be printed on any 80 column printer and a ps file which is formatted for a postscript printer V source display status line Used with the second form of the log command the V parameter enables logging of the source display status line to a session log file It is primarily intended for testing the Simulator display In multiple device simulations there is a separate session log file associated with each simulated device but there is only a single command log associated with the entire multiple devi
92. any breakpoint go r Clears the Simulator pipeline and starts program execution at the reset vector The simulated machine state is also reset according to the processor reset sequence go 5 Begins execution from the current instruction Halts on the first occurrence of breakpoint number 5 go 5 3 Begins execution from the current instruction Halts on the third occurrence of breakpoint number 5 go lab_d 5 3 Starts execution from symbolic address lab_d after clearing the Simulator pipeline Halts on the third occurrence of breakpoint number 5 12 22 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc help Simulator Help Text 12 16 help Simulator Help Text HELP command reg topic The help command provides syntax and examples of Simulator commands descriptions of device register bit fields and help on other topics related to device or Simulator operation If no keyword is entered the Simulator displays a summary of the possible help topics command reg topic Optional The command register or topic for which to display help If the keyword is a command name the Simulator displays a summary of that command s parameters along with a brief description and examples If the keyword is a register name the Simulator displays the specified register s contents along with the help text associated with the regis
93. ap Motorola C Library Functions 13 25 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Screen Management Functions enum is memory map concatenated with a valid memory name As an example memory map pa refers to off chip pa memory on the 96002 device 13 3 10 dspl xmwr Write DSP External Memory Location int dspl xmwr device index mem map address value store int device index DSP device index to be affected by command enum memory map memory map memory designator unsigned long address DSP memory address to write unsigned long value Value to be written to memory location int store Flag indicating that a device store is in effect This function must store a value to a dsp device s external memory location The Simulator calls dsp1_xmwx when a dsp device writes an external memory location or when the Simulator user interface alters the location The store parameter will indicate if the reference is from the dsp device store 1 during simulation of device cycle execution or some other source store 0 not related to device cycle execution For example the change memory Simulator command will set the parameter store to 0 The store parameter is not used in the dspl xmwr function provided in the file simvmem c but is available to the user if modifications are made to the simvmem c file for special external memory
94. ay also be expressed as a line number in the program source file Specification of a line number is valid only if the symbolic debug information has been loaded from a COFF format cld file The debug information is generated at the time of assembly using the assembler s g option Line numbers may be specified as 11ename8line number for a line number in a particular file or simply by 1ine number for line numbers in the currently displayed file H halt at breakpoints Optional The default is to ignore all breakpoints while the until command is executing The h parameter enables halting at breakpoints Table 12 40 UNTIL Commands Command Resulting Simulator Action until 20 Executes until the instruction associated with line 20 in the current file is reached until p 50 Executes until the instruction at hexadecimal address p 50 is reached Ignores breakpoints until p 50 h Executes until the instruction at hexadecimal address p 50 is reached Does not ignore breakpoints until lab 2 Executes until the instruction at label lab 2 is reached 12 46 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc view Select Display Mode 12 38 up Move Up the C Function Call Stack UP n The up command is used to move up the call stack It can be used in conjunction with the where frame and down comman
95. ay and non display versions of the Simulator The library nwsim contains functions available to the non display version of the Simulator The library wwsim contains functions that may only be used in a display version of the Simulator For each device type there are also display and non display device specific libraries named wwxxxxx and nwxxxxx where the xxxxx 1s the device number The source code contained in snwdsp c can be linked with the nwxxxxx and nwsim libraries to create a non display version of the Simulator Elimination of the user interface functions cuts the code size of the Simulator almost in half However all of the functions listed in Section 13 4 and sim_docma sim_gmcmd and sim_gtcmd described in Section 13 2 are sacrificed The remainder of the functions in Section 13 2 and all of the functions in Section 13 3 are available in the non display Simulator libraries Some major features of the Simulator are eliminated by the loss of the sim_docma function In particular there are no low level entry points provided to set a breakpoint or to assign input or output files to DSP peripheral functions However the basic functions required to create a device load a program execute the code and test or modify device registers are all still available In addition the dsp save function provides the capability to save the state of the non display version The state file can later be reloaded by a display version of the Simula
96. c and src2 to the list of alternate source pathnames path Clears the list of alternate source pathnames path Shows the default working directory and help file directory for the current device and the list of alternate source pathnames Motorola Command Reference 12 35 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc quit Quit Simulator Session 12 26 quit Quit Simulator Session QUIT E enable D disable The quit command passes control back to the operating system after closing all log files input and output files and macro files E enable D disable Optional Quit enable E and quit disable D control the action taken by the Simulator if an error occurs during the execution of a macro command The quit enable specifies that the macro command should be aborted and the Simulator quit immediately with a non zero exit status The quit disable command specifies that the Simulator should not exit Table 12 29 QUIT Commands Command Resulting Simulator Action quit Closes all currently open files and returns to the Operating System quit e Specifies that errors in a macro command will cause the Simulator to exit with a non zero status 12 27 radix Change Input or Display Radix RADIX B binary D dec F float H hex U unsigned reg block addr block The radix command allows you to change the default number base for c
97. cale com Freescale Semiconductor Inc Assigning an Input File Open Input File Ed To Part Radix ae Memory ctrl H Decimal 1 5 C Port C Fractional C Pin Pin Floating Pont O Resister Start Hexadecimal Timed C Peripheral reset E Unsigned From r Memory File End C Terminal Memory Space reset E gl m Register Address ql REN nt E File Name TUN Figure 5 1 Providing Input Data 2 Under Input Number select the number you want to assign to this input The default number shown is the next available number Input numbers do not have to be consecutive they can be assigned arbitrarily which means that you can assign input numbers in any way that helps you organize the sources of the inputs 3 Mark the checkbox labeled Timed if the data contains time data pairs 4 Under From select the source of the input data Select File if the input data comes from an existing file Select Terminal if you will enter the input data directly from the keyboard 5 Under To select the data destination Memory Space Port Pin Register or a Peripheral 6 If the input data is being sent to a memory space under Memory select the memory space Then type the desired address in the Address text box Assigning data to a memory address causes all subsequent reads of that memory address to reference the input source You can use this method
98. ce When it switches to a new device it refreshes the entire screen from the device s display buffer Motorola C Library Functions 13 35 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Reserved Function Names 13 7 Reserved Function Names The public function names used in the Simulator all begin with the prefixes dsp or sim Functions which begin with simare only available when a display version of the Simulator is created Functions which begin with dsp are available to both display and non display versions The screen management functions all begin with simw In general functions which begin with dsp or sim are higher level functions available for direct reference from the user s code those beginning with dspl or siml_ are meant only for internal use by the Simulator The higher level functions and the screen management functions are documented in Sections 13 2 13 3 and 13 4 The public function names are listed in the file named global sym which is included with the distribution 13 8 Simulator Global Variables In order to reduce conflicts with user variable names the Simulator global variables have been grouped together into several large structures In general the structure names beginning with s are used defined in simusr h and are only used in the display version of the Simulator while those beginning with d are defined in simdev h and are used by both the display and non display
99. ce simulation If a device type is changed using the device command the user interface information associated with the discarded device type including the session log file name is cleared so it is best to specify the log s command following the device command for a particular device 12 30 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc more Enable Disable Session Paging Control Table 12 24 LOG Commands Command Resulting Simulator Action log Displays currently opened log files log s NdebuggerNsessionl Logs all display entries to session1 log in directory debugger log c macrol a Logs all commands to the file macro1 cmd Append if it already exists log off c Terminates command logging Log OEE Terminates all logging log v Logs source display status line and all display entries to session1 log log s sessionl load px41v17 cld Loads memory and symbols for program px41v17 and log the program profile in files px41v17 log and px41v17 ps Overwrites these files without warning if they already exist Note that the program s to be profiled must have been loaded before this log command is issued log p px41lv17 o 12 22 more Enable Disable Session Paging Control MORE OFF The more command allows you to enable or disable the paging of data in the Session window This is particu
100. ched while in the middle of a subroutine Section 1 9 Setting and Modifying Breakpoints provides a detailed discussion of breakpoint funtions In any instance where the Simulator stops execution in the middle of a subroutine or function the subroutine or function can be made to finish execution To finish execution of the current function or subroutine 1 From the Execute menu choose Finish The Simulator continues until it encounters an RTS instruction Execution continues only to the end of the current function If the Simulator encounters another function during a FINISH operation the execution of the encountered function does not complete Alternatively you can use the Finish button on the toolbar Section 12 13 finish Execute Until End of Current Subroutine on page 12 21 provides a complete command description 2 6 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Resetting the Device 2 8 Stopping Program Execution You can stop program execution or the execution of a command macro at any time To stop program or command macro execution 1 From the Execute menu choose Stop notice that this is the only menu item you can choose while program or command macro execution is in progress If you began the execution by providing an UNTIL condition the Simulator will clear this temporary breakpoint The Assembly window and the So
101. columns for R 24 Figure 11 5 Displaying the Source Window 2 You can use the Source window to set halt breakpoints To set or clear a breakpoint double click on any line in the Source window The breakpoint is added to the breakpoint list displayed in the breakpoint window and highlighted in blue in the Assembly window Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Stack Window 11 7 Stack Window You can watch the hardware stack by opening the Stack window To display the hardware stack 1 From the Windows menu choose Stack The hardware stack will be displayed Section 7 1 Introduction to Debugging C Source Code on page 7 1 provides more information about the Simulator s hardware stack Motorola Displaying Information 11 7 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Stack Window 11 8 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 12 Command Reference 12 1 Command Overview There are a total of fifty two Suite56 DSP Simulator commands that you can perform from the command line The command line is a part of the Command window These commands and their syntax are useful to know if you are writing a command macro The Simulator commands can be grouped into six cat
102. conductor Inc Modification of Device Global Structures Table 13 5 Lower Level Structures amp Define Constants Function Description xports This array of dt_xpid structures determines port names that can be used in the simulator input and output commands These names are in addition to the peripheral names that are specified in the individual peripheral modules The port names are just a convenient way to specify a subgroup of pins within a single physical port for input and output operations dx 56116 This structure is mostly a conglomeration of the other substructures defined within the module for this device type The only member of this structure that should be modified is devname which will be used to specify the new device type in the simulator device command mem dispfw56116 This structure provides display field width information for the different memory spaces defined in the mem 56116 defined previously hlp 56116 This structure provides the help pointers that will be used by the simulator when help is requested for this device type Sx periph 56116 This structure points to display information for the registers of each peripheral the actual display information is defined locally in each peripheral module The file portb100 cis provided in source form with the simulator package as a model to be used when creating new peripheral structures Motorola C Library Functions 13 39 For More Informatio
103. d by this option from file If only a file parameter is specified the Simulator assumes that the file is an object file The object file may be in either the special ASCII OMF format Chapter 3 Object Files and Data Files on page 3 1 or in the DSP COFF format generated by the DSP Assembler The OMF format file can be created using the Simulator save command or with a text editor A directory path may be specified with the filename If no filename suffix is specified the Simulator will search first for an OMF format lod file then for a COFF format cld file Loading a COFF format file replaces the Simulator s symbolic debug information unless the M option is specified If the S parameter is specified but no filename suffix is specified the sim file extension is assumed 12 28 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc load Load DSP Files or Configuration Table 12 23 LOAD Commands Command Resulting Simulator Action load source testloop obj Loads the OMF format testloop obj file from directory source load NsourceNtestloop cld Loads the COFF format testloop cld file from directory source including the memory contents and any symbolic debug information contained in the file load lasttest Loads the OMF format lasttest lod file from current d
104. d is a floating point or integer multiply Table 12 16 EVALUATE Commands Command Resulting Simulator Action evaluate r0 p 550 Adds the value in rO register to the value in program memory address hexadecimal 50 and displays the result using the default radix evaluate b 345 Converts hexadecimal 345 to binary and displays the result evaluate lab d Displays the address of the location associated with symbolic label lab d evaluate count Displays the value of the C variable count evaluate h 10101010 amp p r0 Calculates the bitwise AND of the program memory address specified by the value in rO register and the binary value 10101010 and displays the result in hexadecimal 12 20 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc frame Select C Function Call Stack Frame 12 13 finish Execute Until End of Current Subroutine FINISH The finish command executes instructions until the current subroutine or function call is completed This is useful if execution has for some reason been halted in the middle of a subroutine or function 12 14 frame Select C Function Call Stack Frame FRAME tn The frame command is used to select the current call stack frame It can be used in conjunction with the where down and up commands to display and traverse the C function call stack
105. de 7 1 Introduction to Debugging C Source Code 0 0 ee eee eee 7 1 12 Displaying the Call Stack sic A A A 7 1 7 3 Moving Up and Down the Call Stack 0 2 0 0 0 0 eee eee eee 7 2 7 4 Dynamically Displaying C Function Calls oo oooooooooomooo 7 4 7 5 Boabling Disabling I O Streams 23 snes pete Cere RAO d Nt Sakae 7 5 7 6 Redirecting an VOTE 4 RE A As OER SS RES OH 7 5 7 Display the Type of a C Variable or Expression 0 20000 005 7 6 Chapter 8 Macros Scripts and Log Files 8 1 Creating and Running a Command Macro 0000 cece eee eee 8 1 8 2 Logging Output from the Session Window 0 0c ce eee eee 8 2 Chapter 9 Expressions 9 1 Introduction to EXPTESSIO S ds 9 1 D2 Evaluate Expressions aac guts de A NU UU A E 9 9 3 Using Memory Space SymMboOlS ooo oooocooccooconconoc o 9 2 94 Using Register Name Symbols o er RE ER ATUS CC OSA EV 9 2 9 5 Using Assembler Debug Symbols 0 0 00 cee cee eee 9 3 9 6 3USIIE C ONSTANIS co o3 4o e HO NON e de ye ve eR 9 4 OT Numetc Constants dessei esa a es a Step WES CIC ERES 9 4 9 8 Operators in Expressions cars ma hm or eb eR Es NIU do 9 5 9 9 Operator Precedence st a ed t kal b E MIC e eed And 9 7 9 10 Setting Up and Modifying a Watch List 0 0 00 eee eee 9 8 Chapter 10 Simulator Tool Bar TO Usine the Eoo Batu Leto rei ok eee a al dl a a Lek ag 10 1 10 25 oCIOJBUGON ts ae hans ite a
106. des 55 ae As Cet vat 12 52 12 49 wmemory GUI Memory window 0 0 ce eee ees 12 53 12 50 woutput GUI File Output window 0 0 c eee ee eee 12 54 12 51 wresister GUI Register window 224444005 sees ees thee dees dis 12 54 12 52 wsession GUI Session window 0 0 eee eee eee eee ees 12 55 12 53 wsource GUI Source window iie Ve eee be e 12 55 12 34 wstack GUI Stack wind0w 325 4 sav tote Ee eS vam PES UEM eR edet 12 56 12 55 wwatch GUI Watch windOW A 12 56 Motorola vii For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 13 C Library Functions IS T C Object Libraries e cid bal ae ea bes ld Maths TU UE dd 13 2 13 2 Simulator Object Library Entry Points 02 0 22 13 2 13 3 Simulator External Memory Functions 0 0 2 0 elles 13 21 13 4 Simulator Screen Management Functions 0000s 13 26 13 5 NonsDisplay Simulator A a 13 31 13 6 Multiple Device Simulation s 2a eR er bem I RPW E UR S RR os 13 33 15 7 Reserved Function Names la ett Maa a dese ER Ad 13 36 13 8 Simulator Global Vartabless oodd uet A A 13 36 13 9 Modification of Simulator Global Structures 02000005 13 36 13 10 Modification of Device Global Structures oo ooooommmoom o 13 37 viii Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconduct
107. ds to display and traverse the C function call stack After entering a new call stack frame using up that call stack frame becomes the current scope for evaluation This means that for C expressions the evaulate command acts as though this new frame is the proper place to start looking for variables n Optional The number of frames to move up If no number is specified the Simulator moves up one frame in the call stack Table 12 41 UP Commands Command Resulting Simulator Action up Moves up the call stack by one stack frame up 3 Moves up the call stack by three stack frames 12 39 view Select Display Mode VIEW A assembly S source R register The view command changes the Simulator display mode There are three display modes assembly source and register section 1 7 Setting Up the Display Environment describes the display environment When no parameter is entered the display mode cycles to the next display mode in the order source assembly register The same results can be obtained by typing ct rl w A assembly S source R register Optional The mode that is to be displayed in the Session window The assembly and source views will indicate the next instruction to be executed with a pointer to the left of the instruction The register mode will display the values of registers enabled for display see the display command including highlighted values for registers that were written to
108. e function is described in Section 13 2 Simulator Object Library Entry Points 13 5 3 Executing Device Cycles After creating a new device as described in Section 13 5 1 Creating a New Device and loading a program or state file as described in Section 13 5 2 Loading Program Code or Device State the Simulator is ready to execute the program code 13 32 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Multiple Device Simulation Execution will begin at the start address specified in the load file or continue from the previous location in a Simulator state file The user s code may select a new execution address by writing register pc using the dsp_wreg function The Simulator will advance the device state by one clock cycle each time the dsp_exec function is called The device pin states are updated each clock cycle and can be examined or changed using the dsp rpin dsp wpin dsp rport or dsp wport functions 13 5 4 Testing Breakpoint Conditions The display version of the Simulator provides a way to specify breakpoint conditions that are evaluated each time dsp exec is called If the breakpoint condition is met the Simulator displays the enabled registers and clears the device structure sim var stat executing flag assuming the breakpoint action is halt The non display Simulator does not provide a way to specify brea
109. e 13 1 lists the higher level functions 13 2 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points Table 13 1 Higher Level Functions Function Description dspt masm xxxxx mnemonic ops err Assemble mnemonic string to ops dspt unasm xxxxx ops sr omr sdbp Disassemble dsp opcodes dsp_exec devn Execute one clock cycle for dsp device dsp findmem devn memname map Get map index for memory prefix dsp_findpin devn pinname pinnum Get pin number for pin name dsp findport devn portname pnum pmas k Get port number and mask for port name dsp findreg devn regname pval rval e Get peripheral and register index for register dsp_fmem devn map addr blocksz val e Fill memory block with a value dsp_free devn Free memory allocated for a dsp device dsp init devn mode Initialize selected device and mode dsp ldmem devn filename Load device memory from filename dsp_load filename Load all device states from filename dsp_new devn device type Create new dsp device dsp path path base suffix new name Create filename from path base and suffix dsp rapin devn pin_number val Read output analog pin state from device dsp_rmem devn map addr me
110. e discussion of valid expressions is presented in Chapter 5 Device I O and Peripheral Simulation on page 5 1 Multiple register names memory locations and expressions can be specified on the same command line Each specified destination must be followed by the value or expression to be assigned to it An interactive mode of the change command can be initiated by specifying a single register or memory location without an associated expression In this mode each register or memory location can be examined and optionally modified Typing the ESC key causes the interactive mode of the change command to terminate Table 12 8 CHANGE Commands Command Resulting Simulator Action change pc Displays register values individually starting with the program counter and prompts you for new values change xi 55 Displays internal x memory location hexadecimal 55 and prompts you for a new value change p 20 123456 Changes the value at p memory address hexadecimal 20 to hexadecimal 123456 change xdat 234 Changes the value at the x memory address that corresponds to symbolic label xdat to hexadecimal 234 change xdat xdat 5 35 Changes the values in the memory block beginning at the address corresponding to symbolic label xdat and ending at xdat 5 to decimal value 35 Motorola Command Reference 12 13 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc copy Copy a
111. e new input data to be written to the port The value supplied in the force parameter indicates which port bits are actually being driven as inputs to the device The value supplied in the mask parameter specifies which pins in the port are to be affected by this write the other pins in the port remain in their previous state The port parameter acts as the index to the dev var xportval array A list of port names and the corresponding port index can be obtained using the Simulator s help port and help periph commands The port index and mask value can also be obtained by using the port name as a key when calling dsp findport This function call can be paired with the dsp rport function to simulate a port to port connection between devices See Example 13 26 Example 13 26 dsp wport Write portb of device 1 from portb of device 0 int portnum unsigned long portbdata portbforce unsigned long portmask dsp startup dsp new 0 56116 Allocate structure for device 0 a 5611 dsp new 1 56116 Allocate structure for device 1 a 5611 dsp findport 0 portb amp portnum amp portmask dsp rport 0 portnum amp portbdata amp portbforce dsp wport 1 portnum portmask portbdata portbforce el Py DN 13 2 27 dsp wreg Write a DSP Device Register dsp wreg device index periph num reg num reg val int device index DSP device index
112. e variables in an expression goes out of scope either because a function call or return from a function the value is replaced with the message Expression out of scope When all elements of the expression are back in scope the value is again displayed An expression which has gone out of scope because of function a call may be evaluated and displayed by selecting the stack frame for the evaluation context The stack frame assignment remains in effect only until the next instruction is executed An expression that is out of scope because of an exit from a function cannot be evaluated until the function is called again as its variables no longer exist Section 12 42 watch Set Modify View or Clear Watch item on page 12 49 provides a complete command description A WATCH list can also be used in conjunction with the EVALUATE command See Section 9 2 Evaluate Expressions on page 9 1 for more information Motorola Expressions 9 9 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting Up and Modifying a Watch List 9 10 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 10 Simulator Tool Bar 10 1 Using the Tool Bar You can use the toolbar to control program execution The icons located on the toolbar duplicate the same kind of control commands found under the Execute menu The
113. e will be displayed Table 12 38 TYPE Commands Command Resulting Simulator Action type count Displays the type and location of the variable count type 0 5421 Displays the type of the given expression 0 5 i Motorola Command Reference 12 45 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc unlock Unlock Password Protected Device Type 12 36 unlock Unlock Password Protected Device Type UNLOCK dev_type password The unlock command provides unlocks unannounced device types Once unlocked the device type may be selected for simulation using device command dev type The type of device that is to be unlocked password The password to unlock the device Table 12 39 UNLOCK Commands Command Resulting Simulator Action unlock 56001 x51 234 Enables device type 56001 for simulation using the password x51 234 12 37 until Execute Until Address UNTIL addr H halt at breakpoints The until command sets a temporary breakpoint at the specified line or address then begins execution from the address indicated by the current program counter until that breakpoint is encountered The Simulator then clears the temporary breakpoint and displays the enabled registers and memory blocks in the same manner as the step command addr The addr parameter specifies the address in memory at which execution will be halted The addr parameter m
114. eached or until program execution is otherwise stopped Entering the go command with no parameters will start simulation from the current program counter value from location R reset Optional The location parameter represents the address symbolic label or line number if symbolic debug information has been loaded from which execution will begin The reset R parameter causes a simulation of the reset sequence in the processor The device registers are reset and execution begins at the reset exception address If an address or reset parameter is included the instruction pipeline instruction counter and cycle counter will be cleared before program execution begins to break number bn Optional The optional Hon parameter may be used to cause execution to halt if the breakpoint condition represented by break number bn occurs All other breakpoint conditions are ignored occurrence count Optional The count parameter causes execution to halt only if the breakpoint has occurred count times If Hon is not specified simulation will stop if count number of breakpoint conditions have occurred Table 12 18 GO Commands Command Resulting Simulator Action go Starts program simulation from the current instruction Stops at the first occurrence of any breakpoint go 100 Starts program simulation at program memory address hex 100 after clearing the instruction pipeline Stops at the first occurrence of
115. ecutes the display is updated at each break in execution The next instruction to be executed is always displayed highlighted in red To use the Assembly window 1 From the Windows menu choose Assembly The Assembly window appears red highlight indicates that this Dy00 Assembly A x is the next instruction to be Scroll To Address executed Address f Label Mnemonic 000100 p3 0253 move H 80 10 al 000101 p3 0254 move 80 14 El 000102 p3 0255 move tt c0 r2 blue indicates 000103 p3 0256 move 8 m0 an enabled 000104 p3 0257 move H 8 m4 breakpoint 000105 p3 0258 move H 8 m2 000106 p3 0259 move H 3 n2 000107 p3 0260 move H 3 n4 000108 p3 0261 do lt 3 113 pink indicates 00010a p3 0263 do lt 3 112 a disabled 00010c p3 0265 clr a x 10 x0 y r4 n4 y0 breakpoint 00010d p3 0266 rep H 2 00010e p3 0267 mac y0 x0 a x 10 x0 y r4 n4 vt EJ Figure 11 4 Using the Assembly Window 2 To scroll to a specific address type the address in the box labeled Scroll To Address and press ENTER Motorola Displaying Information 11 5 For More Information On This Product Go to www freescale com Source Window Freescale Semiconductor Inc 3 To edit an instruction single click on the mnemonic Notice that the mnemonic text 1s now highlighted Type the new assembly instruction and press ENTER Notice that the next instruction is highlighted In order to avoid accidentally typing over that
116. ed registers and memory blocks trace li Executes one source line regardless of the display mode then stops and displays the enabled registers and memory blocks trace 20 Executes 20 instructions or source lines depending on the display mode and displays the enabled registers and memory blocks after each trace execution Ignores breakpoints trace 20 in Executes 20 instructions regardless of the display mode and displays the enabled registers and memory blocks after each instruction Ignores breakpoints trace 20 h Executes 20 instructions and displays the enabled registers and memory blocks after each instruction Halts if a breakpoint is encountered trace 10 cy Executes 10 clock cycles and displays the enabled registers and memory blocks after each clock cycle Ignores breakpoints 12 44 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc type Display the Result Type of C Expression 12 35 type Display the Result Type of C Expression TYPE c expression The type command is used to display the result type of a C expression in the Session window c expression The C expression to be examined remember to enclose in curly brackets If the result of the expression is a storage location e g just a variable name or an element of an array the address of the storage location in addition to its data typ
117. efines the default pathname that is used by the Simulator to store temporary files log files macro command files object files and peripheral I O files If no parameters are specified the current default pathname is displayed in the Session window The default pathname can be overridden by explicitly specifying a pathname as a prefix to the filename in any of the commands which reference a file pathname Optional Used in the first form of the path command indicates the directory to use as the pathname tpathname pathname Used in the second form of the path command Alternate source pathnames may be specified using the path form of the command Each time the command is issued the specified pathname or comma separated list of pathnames is added the current list When searching for files the Simulator will first search the default pathname then search in each of the alternate source pathnames in the order that they were specified The third form of the command path deletes the entire list of alternate source path names Table 12 28 PATH Commands Command Resulting Simulator Action path sim Defines the default working directory for Simulator files as sim path sim day2 Defines the default working directory for Simulator files as sim day2 path gere Adds pathname src to the list of alternate source pathnames path src src2 Adds pathnames sr
118. egories memory register modification file O simulation execution control C source code debug commands miscellaneous tasks windows controls used especially in writing command macros 12 1 1 Memory Register Modification The following commands relate to modifying memory and registers These allow you to assemble ASM DSP instructions change register or memory locations copy a block of memory to a new location disassemble code stored in the simulated DSP memory space display registers and memory values display the Simulator revision number or memory configuration reset the device use the history command to disassemble and display the previous thirty two instructions executed by the device use a watch list to display a variable whenever single stepping or program execution is halted Motorola Command Reference 12 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Command Overview 12 1 2 File I O The following commands relate to file input and output These allow you to input peripheral or memory location values from a file output peripheral or memory location values to a file load DSP Assembler object module files or previous simulation state files log Simulator commands session display output or DSP program execution profile save Simulator memory to an object module file or the Simulator state to a state file 12 1 3 Simulation Execution Control The followi
119. emiconductor Inc List of Figures 1 1 DSP Simulator Command Window 0 0 00 ee eee eee 1 2 1 2 Setting the Working Directory Path 0 0 0 0 ee eee 1 5 1 3 Setting Up the Display Environment 0 000 0008 1 8 1 4 AddItem t a Walch list oes u e E EAS 1 9 1 5 Execution Instructions with Go 0 eee eee ee eee 1 14 2 1 Step through Program Instructions 0 00 cece eee eee 2 2 2 2 Trace Program Excusas 2 3 2 3 Providing an Until Condition sox 52st a A av ER ERA 2 5 2 4 Resetting the Device Registers ia av dE OES EG EE E S 2 8 3 1 Displaying Current Paths aye dor Rr Or REX V exo Res 3 2 4 DSP Simulator Register Dialog BO0X oo ooooooocooomooo o 4 4 2 Displaying the Register Values eem tre armes o e e 4 2 4 3 Changing the Value of Register sti ue y ele Re se Rye 4 3 4 4 DSP Simulator Memory Dialog Box 0oo oooooocoocooooom oo 4 4 4 5 Displaying Memory Valles exactes SR REX EAE S EN ERAS EE 4 4 4 6 Changing the Value in Memory rias LEEREN 4 5 4 7 Copying Memory from One Block to Another o o o oo 4 6 4 8 Disassembling Code Stored in Memory 020000000 4 7 5 1 Providins Input alas ose s qd e ce e Aa So oe os eo aee a 5 9 5 2 Creating am Output EIE osos aos glad Ue Oey eR ek 4 CEOS aR 5 11 6 1 Set Default Device Dialog BOX 4 shan eh ee ek KI in A A 6 2 6 2 Set Default Radix Dialog BOX 4 3 264 cio Ie E e REX P4 e 6 3 6
120. ence 1 parenthetical expression innermost first unary minus unary negate unary logical negation multiplication division mod addition subtraction Shift less than greater than less or equal greater or equal equal not equal bitwise AND bitwise EOR 10 bitwise OR 11 logical AND 12 logical OR VOD 00 10 tA BE U N Operators of the same precedence are evaluated left to right All integer results including intermediate of expression evaluation are 32 bit truncated integers Valid operands include numeric constants memory addresses or register symbols The logical bitwise Motorola Expressions 9 7 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting Up and Modifying a Watch List unary negate unary logical negation and shift operators cannot be applied to floating point operands That is if the evaluation of an expression after operator precedence has been applied results in a floating point number on either side of any of these operators an error will be generated 9 10 Setting Up and Modifying a Watch List You can watch the contents of a specific memory location register or any arbitrary value or expression by setting up a Watch window Watch items are kept on a watch list that gets updated every time program execution is stopped The value or expression that you watch can be valid even if it is not calculated during program execution
121. ep through program instructions 1 From the Execute menu choose Step You will see the following dialog box Motorola Controlling Execution 2 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc TRACE the Execution of Instructions Count Increment 1 2 C Cycles X C Lines Instructions Halt at Breakpoints Cancel Apply Figure 2 1 Step through Program Instructions 2 Under Increment select whether to step by Cycles Lines or Instructions 3 Under Count specify the number of cycles lines or instructions to step 4 Select the checkbox labeled Halt at Breakpoints if you want breakpoints to be observed If you do select the checkbox the Simulator ignores breakpoints and does not halt program execution 5 Click OK Notice that the Simulator updates the values in the Register window the Memory window and all other windows after it executes the last cycle line or instruction Alternatively use the STEP Button on the toolbar to step one instruction or line at a time Section 12 31 step Step Through DSP Program on page 12 41 provides a complete command description 2 3 TRACE the Execution of Instructions When you trace program execution you can look at a snapshot of the enabled registers and memory after the Simulator executes each instruction or clock cycle To trace program execution 1 From the Execute menu choose Trace The following di
122. er than gt equal or less than or equal lt greater than or equal gt not equal Relational operators all work the same way If the indicated condition is true the result of the expression is an integer 1 If it is false the result of the expression is an integer 0 For 9 6 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Operator Precedence example if D has a value of 3 and E has a value of 5 then the result of the expression D lt E is 1 and the result of the expression D gt E is 0 Each operand of the conditional operators can be either floating point or integer Test for equality involving floating point values should be used with caution since rounding errors could cause unexpected results Relational operators are primarily intended for use with the Simulator BREAK command Logical operators Logical AND amp amp Logical OR The logical AND operator returns an integer 1 if both of its operands are non zero otherwise it returns an integer 0 The logical OR operator returns an integer 1 if either of its operands is non zero otherwise it returns an integer 0 The types of the operands may be either integer or floating point Logical operators are primarily intended for use with the Simulator BREAK command 9 9 Operator Precedence Expressions are evaluated with the following operator preced
123. erence Input output from to ASCII files for device peripherals Help file and help line display of Simulator commands Command macros editable scripts for executing multiple Simulator commands Display enable disable of registers and memory e Fractional hexadecimal decimal binary calculator 1 3 Entering Commands You will perform most of your work with the Simulator using the menu bar and the toolbar But sometimes it is convenient to perform some commands from a command line and Motorola s DSP Simulator provides you the option of entering commands at a command line The command line is a part of the Command window shown in Figure 1 1 command history Command AT ES wasm E wcommand help help pin F command line help io help 0 device number help line asm break change copy device disassemble lt space gt more Figure 1 1 DSP Simulator Command Window 1 2 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Getting Started with the DSP Simulator The Command window displays several common commands on the help line You can display the remaining commands by pressing the SPACE bar when the cursor is at the beginning of the command line You do not have to type the complete command The Simulator recognizes each command when you type the first one to three characters of the command The help line high
124. ering one of the following break action parameters Table 12 6 Break Action Parameters Parameter Resulting Simulator Action H Halts execution This is the default when no break action is specified In Increments the n counter register CNTn where n represents the number of the counter to increment There are four possible counters n 1 4 N Note displays the breakpoint expression in the Session window and continues with execution S Show displays the enabled register memory set in the Session window and continues with execution X Executes a Simulator command at the breakpoint The command can be any valid Simulator command except for commands that are related to device execution Device execution commands such as step trace or go will not execute R read W write RW access reg addr block 12 10 Used with the second form of the break command Indicates the type of access read write or both of a register or address that should be detected in order for the breakpoint condition to be true Register or address or address block A range of addresses can be specified in two ways One way is to type the beginning address followed by two periods and the ending adress For example Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc break Set Modify or Clear Breakpoint p 101 p 107
125. ernal memory configurations The functions can be modified for example to simulate the 13 34 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Multiple Device Simulation response of dual port RAM or special memory mapped peripherals Another good reason to modify the external memory functions is to increase the speed of the simulation If the user s simulation only requires some minimum amount of external memory then the virtual memory management functions provided with the Simulator are probably overkill 13 6 4 Multiple DSP Pin Interconnections The dsp exec function will automatically update the DSP device pin states by one clock cycle change each time it is called The display version of the Simulator will also retrieve or send data to assigned I O files as defined by the input and output commands The input command supplies a method of connecting device pins back to other device pins on the same device as well as to device pins on another device The device pin states for any device can be examined or written using the dsp rpin and dsp wpin functions described in Section 13 2 Simulation of pin to pin connection simply requires reading the state of the output pin each cycle with dsp rpin and writing it to the input pin with dsp wpin A bidirectional pin connection requires reading and writing both pins The Simulator maintains separate buffers for
126. es DSP structures It should be called once and only once at the first of your program prior to any calls to dsp new See Example 13 21 Example 13 21 dsp startup dsp startup dsp new 0 56116 Allocate structure for device 0 a 5611 dsp new 1 56116 Allocate structure for device 1 a 5611 OV OY 13 2 22 dsp unlock Unlock Password Protected Device Type dsp_unlock device_type password char password Pointer to string containing password char device_type Name corresponding to DSP device type This function provides the password for protected device types It must be used prior to the dsp_new function call if the device type is password protected See Example 13 22 Motorola C Library Functions 13 15 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points Example 13 22 dsp unlock Create a device simulation of the password protected 56001 device int devn dsp startup dsp_unlock 56001 x51 234 provide password for device devn 0 dsp_new devn 56001 Create new dsp structures 13 2 23 dsp wapin Write DSP Analog Pin State int dsp wapin device index pin value int device index DSP device index to be affected by command int pin Pin number to write float value Input value for specified
127. ey and calling the function dsp findpin The DSP PINVAL return values are defined in the simdev h file See Example 13 17 Example 13 17 dsp rpin int devn int pinnum int pin value dsp startup devn 0 dsp new devn 56116 Allocate structure for device 0 a 56116 dsp findpin devn rw amp pinnum Get pin number for pin named rw pin value dsp rpin devn pinnum Read value of device 0 pin rw CT CT CT Motorola C Library Functions 13 13 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points 13 2 18 dsp_rport Read DSP Port State dsp rport device index port data force int device index DSP device index to be affected by command int port Port number to read unsigned long data Return port data value goes here unsigned long force Return port forcing state goes here This function reads a dsp device port state It returns two values The value returned in the data parameter contains the current pin data state for all pins in the port In the case of input pins this is the last value written to the input pin in the case of output pins the data state is the last data written to the port by the device The value returned in the force parameter indicates which port bits are actually being driven as outputs by the device The port parame
128. f the block and count represents the size of the block An address block can also be specified by typing start addr end addr For example p 5 20 indicates 20 locations beginning from program memory location 5 p 5 24 indicates program memory locations 5 through 24 If no address is specified the next 20 instructions will be disassembled beginning with the address indicated by the value in the program counter DISASSEMBLE Commands Command Resulting Simulator Action disassemble Disassemble the next 20 instructions beginning with instruction pointed to by the program counter Repeatedly entering this command will result in consecutive 20 instruction blocks being disassembled disassemble Disassembleprogram bootstrap ROM memory address block 0 to 20 PEs O20 disassemble Disassemble memory address block beginning at the address corresponding to lab 1 ab symbolic label lab_1 and ending at lab_2 disassemble Disassemble10 instructions beginning at the address corresponding to symbolic xdat 20 label xdat disassemble Disassemble instructions beginning at the address corresponding to line 7 in the current source file disassemble Disassemble instructions beginning at the address corresponding to line 8 in the test asme8 source file test asm disassemble Disassemble10 instructions starting at x memory map hex 50 x S50 10 disassemble Disassemble40 instructions starting at address y 1000 The instr
129. formation is preceded by a plus sign it indicates a relative number of cycles from the preceding specified timing value otherwise it indicates the exact value of the Simulator cycle register at the time of the transfer 5 6 Peripheral Data You can assign and input or output file to each DSP peripheral The following general information applies to all peripheral files The peripheral data value can be represented in hexadecimal decimal binary or floating point Specify the default input radix in the input command specify the output radix in the output command You can express floating point input in the usual methods For example 035 5e 1 5 0E 1 are all acceptable data input values If a data value contains a decimal point the data will be input as a floating point value overriding the input radix specification The number base of data values can also be denoted by preceding the data value with a dollar sign an apostrophe or a percent sign input as hexadecimal input as decimal input as binary Untimed peripheral input data values are applied only during cycles when the peripheral function is enabled Some peripherals retrieve data from the input file when the peripheral would normally receive new data other peripherals retrieve the data each cycle The final specified data value remains applied to the peripheral indefinitely The repeat punctuation and repeat count can specify durations of longer
130. g with the innermost or outermost frames The plus sign indicates innermost frames The minus sign indicates the outermost frames If no sign is specified the Simulator will assume that the innermost frames are intended for display Table 12 48 WHERE Commands Command Resulting Simulator Action where Display the call stack where 3 Display the three innermost frames in the call stack where 5 Display the five outermost frames in the call stack Motorola Command Reference 12 51 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc winput GUI File Input window 12 47 winput GUI File Input window WINPUT OFF The winput command opens an input window listing all of the assigned inputs See the input command for more information Multiple input windows may be opened for separate devices when debugging on systems with multiple DSPs OFF Optional Closes the winput window Table 12 49 WINPUT Commands Command Resulting Simulator Action winput Opens an input window for the current device winput off Closes the input window for the current device 12 48 wlist GUI list window WLIST OFF The wlist command opens a list window Multiple device windows may be opened for debugging simulations with multiple DSPs OFF Optional Closes the list window Table 12 50 WLIST Commands
131. ge 9 1 and Section 11 2 Displaying the Radix Section 12 42 watch Set Modify View or Clear Watch item on page 12 49 provides a complete command description 1 9 Setting and Modifying Breakpoints You can use the Assembly window which is updated at each break in program execution and the Source window which displays the source code loaded into the Simulator s memory to set halt breakpoints To set a halt breakpoint in the Assembly window double click on an address or label field To set or clear a halt breakpoint in the Source window double click on any source code line The Assembly window and the Source window indicate the breakpoints you have set Enabled breakpoints appear in blue Disabled breakpoints appear in pink Chapter 11 Displaying Information provides a detailed discussion of the Simulator s display capabilities including the Assembly and Source windows To set a breakpoint with conditions you specify an action to take when the Simulator encounters each breakpoint You can set more than one breakpoint on the same location so that more than one action can be taken To set a breakpoint with conditions 1 From the Execute menu choose Breakpoints then select Set 2 Under Breakpoint Number select the number you want to assign to this breakpoint The default number that is shown is the next available number Breakpoint numbers do not have to be consecutive they can be assigned arbitrarily 1 10 Suite56
132. h device retains its own session buffer In order to see the Session window for another device you must specify the other device as the current device When another device is selected as the current device the Session window is refreshed with the buffer for that device The Session window buffers the last 100 lines of output It might be necessary to scroll through the Session window to see previous output At times you might have a command that displays more than 100 lines of output to the Session window In this case you will want to pause the output to the Session window To pause output to the Session window 1 From the Display menu choose More Then select On 2 The Session window will now pause if more than 100 lines of information are displayed at once For example if you perform a command such as typing help io from the command line it is likely that the resulting output to the Session window will be greater than 100 lines The following dialog box will appear 11 4 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Assembly Window GUI56300 x Figure 11 3 Pausing Output to the Session Window 3 Click on OK to display the next 100 lines in the Session window 11 5 Assembly Window The Assembly window allows you to display and edit the contents of memory set and clear breakpoints and follow program execution As the program ex
133. ick OK The expression that you specified now appears in a Watch window If the expression you type is not valid you get an error message explaining why the expression is not valid Motorola Introduction Getting Started 1 9 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting and Modifying Breakpoints Keep in mind that a C expression that refers to C variables can only be evaluated in the context in which the watch is established That is the variables in the expression are only valid while they are in scope If one of the variables in an expression goes out of scope because of either a function call or a return from a function the value is replaced with the message Expression out of scope When all elements of the expression are back in scope the Watch window displays the value again An expression that has gone out of scope because of a function call can be evaluated and displayed by selecting the stack frame for the evaluation context The stack frame assignment remains in effect only until the next instruction is executed An expression that is out of scope because of a function exit cannot be evaluated until the function is again invoked since the expression s variables no longer exist Refer to the following sections of this manual to learn about more advanced topics Section 7 3 Moving Up and Down the Call Stack on page 7 2 Section 9 1 Introduction to Expressions on pa
134. icons on the toolbar are Motorola p m hn m kel pa o d e iO Go button Starts program execution from the next address All breakpoints are observed Stop button Stops program execution or a command macro if running Step button Executes next instruction or line Next button Executes next instruction or line Finish button Allows the current function to execute to completion Device button Allows setting of the default device to which all commands will be directed Repeat button Repeats the last command in the history buffer Reset button Resets the current device Simulator Tool Bar 10 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Go Button 10 2 Go Button The Go button starts program execution from the next address yim Her beny ibe Ian EA del rE Brean 2 p a00108 h deucb pr Q1QE cur 244 i CHHHHHHHHHHHH ye S HHHHHHHHHHHH 3 q0qQQQQQbbbbbb b QQbbbbbbbbbbQd x efHMHHHH xH SHHHHHH r 9 S HHHHHH n9 SH viso HHHHHH y HeTHHHHHH C m HHHHHH nm tH 32 QQ at bbbbbb 39 0QQQQQ rs jbbbbQQ ns a m HH HI e HHHHHH SHA CASSHHHHHH nhe 5H ra jbbbb Q n as ad Figure 10 1 Go Button Section 1 10 Starting the Execution of Instructions with GO on page 1 13 provides more information about starting program execution Section 12 15 go Execute DSP Program on page 12 22 provides a c
135. ics will be displayed If the Simulator is in the register display mode this command will switch it to the source display mode and display the source file lines associated with the specified address or line number If the display mode is already source or assembly the display mode is not altered The assembly display mode displays disassembled instructions corresponding to the specified address or line number addr Optional The next or previous pages of the currently displayed source file may be selected by specifying or In addition the source or assembly associated with the current execution address may be selected by specifying period or by using the list command without a parameter If the addr parameter is used with the list command the disassembled instructions from the specified address will be displayed Alternatively a line number can be provided in place of addr symbolic debug information must be loaded Table 12 22 LIST Commands Command Resulting Simulator Action list 20 Lists source or assembly corresponding to line 20 of the current source file list test asme20 Lists source or assembly corresponding to line 20 of the source file test asm list test asm Lists source or assembly corresponding to line 1 of the source file test asm list Displays the next page of the current source file or assembly list Displays source or assemb
136. ide you the developer an accurate measurement of code execution time critical in DSP applications The Simulator executes object code generated by the Suite56 DSP Assembler see the Suite56 DSP Assembler Reference Manual or the Simulator s internal single line assembler The Simulator also executes object code generated by C compilers such as Motorola s Star Core 100 Family C C Compiler or Suite56 compilers for the 56000 56300 56600 and 56800 families The object code is loaded into the simulated device s memory map The entire internal and external memory space of the DSP is simulated During program debugging you can display and change any of the device s registers or memory locations Instruction execution can proceed until the program encounters a user defined breakpoint or in single step mode until it reaches a stopping point by executing a specified number of instructions or cycles Motorola Introduction amp Getting Started 1 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc DSP Simulator Features 1 2 DSP Simulator Features Features of the Motorola DSP Simulator include the following Multiple device simulation Source level symbolic debug of assembly and C source programs Conditional or unconditional breakpoints Program patching using a single line assembler disassembler nstruction and cycle timing counters Session and or command logging for later ref
137. ily devices and 96k for the 96000 family devices Example 13 2 dspt unasm xxxxx Disassembly of the opcode representing NOP unsigned long ops 3 Instruction words to be disassembled char return string 120 The return mnemonic goes here int numwords Number of operands used by disassembler ops 0 201 ops 1 0L ops 2 0L numwords dspt_unasm_56k ops return_string OL OL NULL Now numwords 1 return string nop Motorola C Library Functions 13 5 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points 13 2 3 dsp_exec Execute Single Device Clock Cycle dsp_exec device index int device index DSP device index to be affected by command This function executes a single dsp device cycle and updates the selected dsp device structure All device inputs outputs and registers are updated as a result of this call In addition it tests user defined breakpoint conditions and clears the device s executing status flag if a breakpoint occurs It also calls the functions which handle cycle by cycle I O from assigned input or output files See Example 13 3 Example 13 3 dsp exec Execute 1000 cycles on a device int devn int cycles dsp startup devn 0 dsp_new devn 56116 allocate new device for cycles 0 cycles lt 1000 cycles dsp exec devn 13 2 4 dsp fi
138. in the current source file If an address field is being specified in a command the line number s preceding character may be omitted A line number in a particular source file may be expressed in the form source filename8line number Below are valid forms of symbol names and line numbers Table 9 1 Valid Forms of Symbol Names and Line Numbers Name Form Explanation symbol name translates to the address associated with symbol name Example change pc lab d Qsymbol name translates to the address associated with symbol name Example disassemble Gstart 1 section name8symbol name translates to the address associated with symbol name in section section name Example display sec3 xdata Qsection name8symbol name translates to the address associated with symbol name in section section name Example display sec3 xdata line number translates to the address associated with line_number in the current source file Example break 30 line number translates to the address associated with line_number in the current source file Example change pc 30 Motorola Expressions 9 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Using Constants Table 9 1 Valid Forms of Symbol Names and Line Numbers Name Form Explanation Source filenametline number translates to the address associated with line number in the named source file Exam
139. in the last executed instruction Table 12 42 VIEW Commands Command Resulting Simulator Action View Selects the next display mode among source assembly and register modes View S Selects source display mode view a Selects assembly display mode view r Selects register display mode Motorola CommandReferene 1247 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc wait Wait Specified Time 12 40 wait Wait Specified Time WAIT count seconds The wait command pauses for count seconds or until you click on Cancel before continuing to the next command This command is particularly useful in command macros If the wait command is entered without a count parameter the pause will continue indefinitely and will only terminate if you click on Cancel count seconds Optional The number of seconds to pause 12 41 wasm GUI Assembly window WASM OFF The wasm command opens an assembly window Multiple device windows may be opened for debugging simulations with multiple DSPs OFF Optional Closes the assembly window Table 12 43 WASM Commands Command Resulting Simulator Action wasm Opens the assembly window for the current device wasm off Closes the assembly window for the current device 12 48 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freesca
140. ined by sv_const breakdev It returns the sim_var stat CTRLBR flag for the current device This allows the program to select the device that will halt in response to the CTRL C signal from the keyboard in a multiple device simulation 13 4 3 simw_cursor Move Cursor to Specified Line and Column simw cursor line column This function must move the cursor to the specified line and column and update the sim const curline and sim const curcim variables 13 4 4 simw endwin End Simulator Window simw endwin This function is normally called when returning to the operating system level from the Simulator It must terminate any special processing associated with terminal I O for the Simulator and clear the display 13 4 5 simw getch Non translated Keyboard Input simw_getch This function gets a single character in a non translated mode from the terminal It is not used much by the Simulator only when returning from the execution of the system command prior to the time when the Simulator s special terminal I O processing is reinitialized 13 4 6 simw_gkey Translated Keyboard Input simw_gkey This function gets a keystroke from the terminal and maps it to one of the accepted internal codes used by the Simulator The internal codes are defined in simusr h This function should not output the character to the terminal This function is a good candidate for modification if you want to change the set of input control characters
141. input and output data for each pin so there is no problem writing a pin even if it is defined as an output The input value will be stored but will only be used if the pin is subsequently reconfigured as an input An entire port state can be read or written using the dsp rport and dsp wport functions described in Section 13 2 The port and pin states are derived from the same storage variables in the device structure The dsp rport dsp wport dsp rpin and dsp wpin functions just provide a convenient method of retrieving the data from this structure 13 6 5 Multiple DSP Simulator Display The Simulator display functions are contained in the source file scrmgr c in the Simulator package This code supports a virtual screen for each simulated dsp The supplied display code uses a single window The lines above the command line form a scrollable region in which session output is displayed The command line error line and help line are the three bottom lines of the display Each allocated device contains screen buffer memory which saves the previous 100 lines of output which is written to a device s scroll region The terminal screen update is inhibited unless the sim const viewdev value matches the device index but the output is always placed in the device s screen buffer The screen can be completely refreshed from a selected device screen buffer by executing the simw redo function The device command allows the user to switch the displayed devi
142. instruction click on an area outside of the mnemonic 4 Breakpoints can be set disabled or cleared by double clicking on an address or label field Double click on the address or label to set the breakpoint Double click again on the address or label to disable the breakpoint Double click again on the address or label to remove the breakpoint Enabled breakpoints appear in blue Disabled breakpoints appear in pink 11 6 Source Window The Source window displays the source code that has been loaded in memory The source code may reside in the directory containing the object module or any or the directories specified in the path 1 From the Windows menu choose Source The Source window indicates the current program counter PC and highlights the corresponding source line red To display the Source window source code line Source window numbers E information Dv00 Source Ox src matmul asm 14 pc matmul asm317 pi 188 lt p3 253 gt section global al 15 16 org p 100 17 move 80 r 0 Set up r8 to point to matrix A 18 move 80 r4 Set up r4 to point to matrix B 19 noue it c8 r2 Set up r2 to point to answer matrix El 28 move Hp1xp2 1 m0 Set up modulo p1xp2 for matrix A r8 pointer 21 noue Hp1xp3 1 m4 Set up modulo p1xp3 for matrix B rh pointer 22 noue Hp2x p3 1 m2 Set up modulo p2xp3 for matrix C r2 pointer 23 move Hp3 n2 Set up affset n to p3 of columns for C es Bio ne er up offset uh te r3 ef
143. instructions you can quickly control execution without setting a breakpoint Executing instructions with NEXT is similar to performing a STEP through instructions except that you can only specify the number of lines or instructions and not cycles Like stepping through instructions the Simulator displays the registers and memory blocks only after it executes the specified number of lines or instructions Motorola Controlling Execution 2 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Providing an UNTIL Condition The important difference between NEXT and STEP is the way each instruction handles subroutines If the next instruction executed calls a subroutine or begins execution of a macro all the instructions of the subroutine or macro are executed before execution stops The Simulator then displays enabled registers memory and other updated values In order to recognize macros the symbolic debug information for the program code must be loaded The debug information is included in the COFF format cld files generated using the Motorola Suite 56 DSP Assembler s g option Motorola s Suite56 C Compilers and the Star Core 100 C C Compiler also provide debug information when you use the g option To execute the next program instruction 1 From the Execute menu choose Next 2 Under Increment select to execute by lines or by instructions 3 Under Count specify the number of lines or inst
144. ion interface It allows the user to simply execute the high level load or load s Simulator commands to load program code or a Simulator state file The non display version of the Simulator makes use of the lower level function calls dsp_ldmem and dsp_load to accomplish the same results They are described in Section 13 2 The major difference from their high level counterparts is that no file name expansion is provided in the lower level calls The program code loaded by the dsp_1dmem function may be any COFF format or OMF format file The OMF format is created as the output of versions of the macro assembler prior to release 4 0 and of the Simulator save command The COFF format files are the output of the macro assembler beginning with release 4 0 or those saved by the Simulator save command with the suffix cld The Simulator state loaded by the dsp_load function may have previously been saved by a display or non display version of the Simulator The formats are the same The dsp_save function is provided as a low level entry point that saves the Simulator state for a non display version of the Simulator It is the same function that is called during execution of the high level save s command which is only available in the display version The only limitation is that the full save filename must be specified No automatic expansion is done for the working path or filename suffix as in the higher level Simulator calls The dsp sav
145. ion about the stack window Section 12 46 where GUI C Calls Stack window on page 12 51 provides a complete command description 7 3 Moving Up and Down the Call Stack You can move the current frame up and down the call stack To move up the call stack 1 From the Modify menu choose Up The following dialog box appears Cancel Figure 7 2 Moving Up the Call Stack 2 Under Frames select the number of frames to move up in the stack 3 Click OK The frame to which you moved is now the current starting point for evaluations 7 2 Suite56 DSP Simulator Users Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Moving Up and Down the Call Stack To move down the call stack 1 From the Modify menu choose Down The following dialog box appears Figure 7 3 Moving Down the Call Stack 2 Under Frames select the number of frames to move down the stack 3 Click OK The frame to which you moved is now the current starting point for evaluations See Section 12 38 up Move Up the C Function Call Stack on page 12 47 and Section 12 11 down Move Down the C Function Call Stack on page 12 19 for complete command descriptions Motorola Debugging C Source Code 7 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Dynamically Displaying C Function Calls 7 4 Dynamically Displaying C Function Calls You can m
146. ion window displays the result of your evaluation C expressions are evaluated in the context of the current stack frame by default that is the value displayed is that which would have been returned if the expression had been included in the program at the current execution point C expressions can be evaluated in the context of any of the functions on the call path to the current function Section 12 12 evaluate Evaluate an Expression on page 12 20 provides a complete command description 9 3 Using Memory Space Symbols The Simulator evaluator interprets a memory space symbol followed by an expression as the contents of a memory location Use the Simulator s help mem command to obtain a list of the valid memory space prefixes and their corresponding address ranges The following expression is converted to an integer constant in the address range of the DSP Some memory space symbols such as p or x require the evaluator to first read the device Operating Mode Register OMR Others such as xi or pr refer to an exact memory location regardless of the chip operating mode 9 4 Using Register Name Symbols The Simulator evaluator interprets a register symbol as the contents of that register To obtain a list of valid register names use the Simulator help reg command on the command line in the Command window Note that some hexadecimal constants such as a0 or d1 may also be valid register names for the selected DS
147. irectory load d test cld Loads the symbolic debug information from the COFF format test cld file ignoring the memory contents of the file load m test cld Loads the COFF format test cld file ignoring any symbolic debug information in it load s lunchbrk Loads lunchbrk sim replacing the entire current Simulator state Motorola Command Reference 12 29 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc log Log Commands Session Profile 12 21 log Log Commands Session Profile LOG OFF C commands S session P profile file A O C LOG OFF V source display status line The log command allows you to record command entries to record all session display output or to record an analysis of DSP program execution Record of commands is useful as a method of generating macro command files Recording all session display output provides a convenient way for you to review the results of an extended sequence of commands Since the output log files are in ASCII format they can easily be printed or reviewed using an editor program Recording a program profile assists in the analysis of program structure and execution characteristics Entering the log command with no parameters will cause the Simulator to display the currently opened log filenames OFF Optional The OFF parameter is used to terminate logging C commands S session P profile file A 0 C The C and S par
148. is a number assigned to a particular device The number is in the form DVn where n is an integer from 0 to 31 A target system can be comprised of up to 32 devices If the device command is executed with a device number and no dev type the device number specified will become the default device If the device does not yet exist it will be created with the default device type and made active Optional Specifies the device structure to be simulated by device DVn Non disclosed devices must be unlocked with the unlock command prior to using the device command Optional Enables the specified device DVn This means that the device will respond to commands that cause device execution go step or trace During execution cycles each enabled device executes a single clock cycle in turn Device to device pin interconnections specified by the input command are updated following each cycle for active devices Optional Disables the specified device DVn Disabling a device causes the device to not respond to commands that cause device execution go step or trace Optional Deletes device DVn If device DVn is the current device it will be deleted and another device will become the current device The Simulator requires at least one device to be allocated which means that it is not possible to delete the current device if it is the only device in the target system Table 12 10 DEVICE Command Resulting Simulator Action
149. isplaying the Radix 11 2 Displaying the Radix You can display the default radix number base that is currently used for command parameters and other values that you input That is the radix that is used when you type a value into a dialog box or at the command line This is what is meant by the default radix To display the current default radix 1 From the Display menu choose Radix 2 The default radix is displayed in the Session window If the default radix for the Simulator is set to decimal this means that values can be entered in decimal without typing a preceding apostrophe If the default radix for the Simulator is set to hexadecimal this means that values can be entered in hexadecimal without typing a preceding dollar Similarly if the default radix is unsigned or binary their respective specifiers do not need to be typed before the value Be careful to distinguish the input radix from the output radix The default radix refers to the input radix The output radix is the radix in which values are displayed You can change the radix for a particular register or for a particular memory location So be careful to note when you have changed the output radix of a particular register or memory location Section 6 3 Changing the Radix on page 6 2 provides more information about changing the radix 11 3 Command Window The Command window permits you to enter Simulator commands on a command line In this way the Co
150. ist For more information about macros see section 8 1 Creating and Running a Command Macro Motorola Command Reference 12 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Command Syntax 12 2 Command Syntax The command syntax line contains special punctuation to indicate command keywords required or optional fields repeated fields and implied actions For example the syntax of the display evaluate wait commands looks like this DISPLAY ON OFF R W RW reg block group addr block EVALUATE B binary D dec F float H hex U unsigned expression c expression WAIT count seconds The punctuation of the syntax line includes Table 12 1 Command Syntax Elements in Motorola DSP Documentation Syntax Syntax Description CAPS Capitalized words indicate command keywords The user must enter command keywords exactly as shown as opposed to variables or arguments that are provided by the user Command keywords can be entered in either uppercase or lowercase in the software tool BOLD In the command syntax line boldface is only used in command keywords The portion of the command keyword shown in boldface represents the minimum portion of the keyword that must be typed in order for the command to be valid The portion of the keyword that is not in boldface can be typed if desired but is not required For example in the wait command the u
151. ite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Operators in Expressions 12345 integer 6E10 floating point 6 floating point 2 7e2 floating point A constant can be written without a leading radix indicator by changing the radix For example a hexadecimal constant can be written without the leading dollar sign if the input radix is set to hex The input radix defaults to decimal Section 6 3 Changing the Radix on page 6 2 provides more information about setting your radices 9 8 Operators in Expressions You can use some of the evaluator operators with both floating point and integer values If one of the operands of the operator has a floating point value and the other has an integer value the integer will be converted to a floating point value before the operator is applied and the result will be floating point If both operands of the operator are integers the result will be an integer value Similarly if both the operands are floating point the result will be a floating point value Operators recognized by the Assembler include the following Unary operators minus negate integer only logical negate integer only The unary negate operator will return the one s complement of the following operand The unary logical negation operator will return an integer 1 if the operand following it is 0 and will re
152. ite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc List of Examples 5 1 Comment Code vs ds pak argon vhs ses PA CREDE EPA derat tog Re 5 2 13 1 ASPE AAA AI 13 5 13 2 a AAA A beste Rea Naevi Lacy 13 5 13 3 USPS IA hls hae Series Marte ai As dera 13 6 13 4 dsp findme m serrie paca e pdt udis 13 6 13 5 USP A ba ERE da Oa EA 13 7 13 6 dsp findport ood s ir e tuc Ae eic oO vp E Y av sd uh y 13 7 13 7 aspas XO dett pice uota Le cts 13 8 13 8 OA A quo bt uat te ba Aue SR A dde st ie a E 13 8 13 9 HS NCI aoo c eder lad nw lod ber itai ts WEST bx ke eas seges 13 9 13 10 AS UML cs ent So as as ds e a ERU Ls 13 10 13 11 dsp Tertio scu e ele es ANE SS ahaa 13 10 13 12 USP 10d MMC 13 11 13 13 US PIANC We s d d A tou ea A tt idad 13 11 13 14 CIS OANA AE 13 11 13 15 CSP PADI Sue a O e A at oct Mate he aa Ae M Sede ie o eee 13 12 13 16 dSD NS HE ae A ne iae doe assu e re oe aang 13 13 13 17 A ee ce ee a a ee ee uec Ee ee ae eae ee 13 13 13 18 ASP TPOM SSA As 13 14 13 19 USD i rae estos ace ned dap bt n lm ait a 13 14 13 20 M c c DM 13 15 13 21 SPACE S eese aet aptos 13 15 13 22 USP MIG y o tees e dtes 13 16 13 23 UP ehe otek guise et users dcs ae Suede 13 16 13 24 a ES UNS MEET P 13 17 13 25 SD DII noie ce eS da SI o EE E a eae ee a S h 13 17 13 26 CSP WOK o Scy oe vito Xo atom acutae adt dais cai aa aedes 13 18 13 27 A cce eode M e D eM pua
153. ix Dialog Box Under Radix select the number system to use 3 Under Registers select the register that will be displayed with the new radix To 5 select more than one register hold down the CTRL key while clicking once on the register names This does not affect the default input radix Under Memory select the memory space and addresses that will be displayed with the new radix This does not affect the default input radix Click OK Section 11 2 Displaying the Radix on page 11 2 provides more information about the radix Section 12 27 radix Change Input or Display Radix on page 12 36 provides a complete command description 6 4 Loading Simulator State Files You can load a previously saved simulation state file The state file acts like an initialization file which includes information about 6 4 the state of all DSP devices in the system and their device type enabled registers counters status registers peripheral registers etc the entire contents of memory the windows settings the command history buffer the Session window output buffer for each device Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Loading Simulator State Files Essentially a state file contains all the information needed to exactly duplicate the condition of the Simulator as it existed when it saved the state file You can use a state
154. kpoint conditions It is up to the user s code to examine device registers or memory conditions and decide whether or not to continue cycle execution The device registers and memory can be examined using the dsp rreg and dsp rmemfunctions The example program snwdsp c simply checks the Simulator cycle counter for device 0 and terminates execution after some number of cycles Another variable that may be particularly useful in breakpoint testing is dev var flg stat It maintains bit flags which signal end of instruction DSP_GEOT end of repeat cycle DSP GEOR and illegal opcode DSP_GILLEG The bit flag definitions are defined in simdev h 13 6 Multiple Device Simulation The SIMDSP Simulator initially simulates a single dsp device but additional devices can be created using the device command Device to device pin connections or device to device memory map connections can be specified with the Simulator input command The following sections describe some details about the way the Simulator handles multiple device simulation Section 13 6 1 describes the required steps which allocate and initialize multiple dsp structures Section 13 6 2 describes the method of interleaving device execution in order to maintain multiple device synchronization Section 13 6 3 describes simulation of the external memory space of the dsp devices Section 13 6 4 describes multiple device pin connections Section 13 6 5 describes display of device ou
155. ks A dors buque eoe veri rd orae nes aeg Bde t 12 23 12 20 List of Help Topic Key worlds ee mt eme c ets 12 23 Motorola ix For More Information On This Product Go to www freescale com Freescale Semiconductor Inc For More Information On This Product Go to www freescale com 12 21 INPUT Commands s sce ese RU EXON o sedo ina 12 25 12 22 LIST Commands 3 aii Nem anser t ei mrs 12 27 12 23 LOAD ComMmMa dS ee seg pe t par n S PUR De a oes C UR Ded 12 29 12 24 LOG Commands nit aou vete au UR Re Ao ide 12 31 12 25 MORE Commatidsu us edax cotes ee AR EU S een 12 31 12 26 NEXT Commands i3 5525255023555 LEM e RE IPSA 12 32 12 27 OUTPUT Commands ds aa to ceed 12 34 12 28 PATH Commands rs e S bo qe 12 35 12 29 QUIT Command socie cd is eds 12 36 12 30 RADIX Commands siere risa S er Un e en 12 37 12 31 REDIRECT Commands s dto o de ice eet C ICE OR etre gas 12 38 12 32 RESET Commands A E atu 12 39 12 33 SAVE Commands s oe eere ete te see pre de 12 40 12 34 STEP Commands on ao e y Cr xb C e RA ES A GER TEE IS 12 41 12 35 STREAMS COMMISSION wad 12 42 12 36 SYSTEM Commands cos rox war SE B UN A A 12 43 12 37 TRACE Comimands REED ej ads Deter RETE MN ER 12 44 12 38 TYPE Commands esce e ie e RPM DN E e c ene 12 45 12 40 UNTIL C mmandS AA lis 12 46 12 39 UNEOCK Commands avril ao ta 12 46 12 42 VIEW Commands 0044 A oc te p AU be e 12 47 12 41 UP Commands sc 6 ree tag etit ee dd Aste M ose foe Mea 4 12 47 12 43 WASM Commands eect
156. l this command 12 40 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc step Step Through DSP Program 12 31 step Step Through DSP Program STEP count CY cycles LI lines IN instructions H halt at breakpoints The step command allows you to execute Count instructions or clock cycles before displaying the enabled registers and memory blocks This command gives you a quick way to specify execution of a number of instructions without having to set a breakpoint It is similar to the trace command except that display occurs only after the count number of cycles or instructions have occurred Unlike the next command if the next instruction to be executed calls a subroutine or begins execution of a macro the instructions of the subroutine or macro are counted towards the total number of instructions that were specified to be executed with the step command If execution stops in the middle of a subroutine or function execution can continue to the end of the subroutine or function by using the finish command count Optional When included the count parameter indicates the number of cycles lines instructions to execute before halting execution If no count is specified the default count is 1 CY cycles LI lines IN instructions Optional As the default the step command steps in instruction increments if viewi
157. larly useful when displaying large amounts of data and you wish to examine page by page OFF Optional Turns off paging The paging feature is turned off by default Data will scroll vertically across the screen when it is larger than the size of the screen Table 12 25 MORE Commands Command Resulting Simulator Action more Turns on session display paging control more off Disables session display paging control reset or default state Motorola Command Reference 12 31 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc next Step Over Subroutine Calls or Macros 12 23 next Step Over Subroutine Calls or Macros NEXT count LI lines IN instructions H halt at breakpoints The next command functions the same as the step command except that if the next instruction to be executed calls a subroutine or begins execution of a macro all the instructions of the subroutine or macro are executed before stopping to display the enabled registers In order to recognize macros the symbolic debug information for the program code must be loaded count Optional When included the count parameter indicates the number of lines instructions to execute before halting execution If no count is specified the default count is 1 LI lines IN instructions Optional As the default the next command executes the next instruction if viewing the assembly or
158. lay Register or Memory reg _block _group addr _block V version Optional The register s or address es to display Entering the display command with a register or address parameter but without one of the enable keywords will cause immediate display of the registers addresses locations This does not affect their enable status Peripheral names can be used in the place of register names to enable or display all the registers associated with that peripheral The valid peripheral names for the selected device can be obtained by using the Simulator s help periph command The word a11 can be used to enable or display all of the device registers Entering the display command with the single parameter v will display the Simulator version number in the Session window Table 12 13 DISPLAY Commands Command Resulting Simulator Action display on Enables all registers for display display on pi 0 20 xi 30 40 Enable internal p memory address block 0 to 20 and internal x memory address block 30 to 40 for display display off Disables display of all registers and addresses then 1 enables display of the DSP core registers and the PSP a SEE SSIO peripheral registers display w r0 r3 x 0 100 Displays registers rO through r3 and x memory locations O through 100 if they have been written to since the last display Table 12 14 DISPLAY Commands Without Enable Keywords
159. le Command Resulting Simulator Action input d15 d0 dfile Gets values for pins D15 through DO from input file dfile io input d15 d0 dfile Gets values for pins D15 through DO from input file dfile io input irqb dv1 pb0 Inputs values for the current device s irqb pin from device dv1 s pbO pin input t irqa term Inputs time and data pairs from the terminal for the device IRQA pin input x 500 dv5 x 3000 Inputs data for memory reads of x 500 of the current device from device number 5 address x 3000 input 42 x 800 xfile rd Gets values for external memory location x 800 from input file xfile io The data values are stored in decimal form in the input file Input assignment number 2 is explicitly replaced due to the 2 in this command form input 42 off Inputs assignment number 2 is explicitly deleted by index number input mic micfile rf Inputs untimed analog pin data for the mic analog pin from the file micfile io 12 26 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc list List Source File Lines 12 19 list List Source File Lines LIST addr The list command displays source lines or disassembled instructions from the specified source file or beginning at the specified address The current display mode determines whether a source file or assembly mnemon
160. le Semiconductor Inc Redirecting an l O Stream 7 5 Enabling Disabling l O Streams You can enable or disable stream I O for C programs that are running on the current device The standard stream files are supported stdin stdout and stderr Any references by C programs to these files may be redirected to files on the host Stream file handling may be configured independently for each device Streams handling is enabled by default If a C program attempts to access a stream file while it is not enabled and redirected the access is ignored Output is discarded and a standard value is supplied as input To enable or disable the stream I O 1 From the File menu choose IO Streams 2 Select Enable or Disable Section 12 32 streams Enable Disable Handling of I O for C Programs on page 12 42 provides a complete command description 7 6 Redirecting an l O Stream You can redirect an I O stream from the current device to a file on the host Each stream file can be assigned individually unwanted streams do not have to be redirected Streams can be redirected whether stream support is enabled or disabled however for the redirection to be effective stream operations must be enabled Disabling stream support while a stream is redirected does not terminate the redirection It merely makes it ineffective until streams are enabled again To redirect the stream I O 1 From the File menu choose IO Redirect then select Streams 2 Under
161. le Semiconductor Inc watch Set Modify View or Clear Watch item 12 42 watch Set Modify View or Clear Watch item WATCH wn radix reg addr expression c expression WATCH wn OFF The watch command is used to add modify view and clear items on the watch list The watch list is a list of registers addresses and expressions that gets updated every time execution is halted or a breakpoint condition is met If the watch command is performed without any parameters the current watch list is displayed in the Session window wn Optional An arbitrary number assigned to each watch list Multiple lists can be defined each being displayed in a separate window If no number is specified the Simulator will automatically add the watch item to the lowest numbered watch list radix Optional The radix parameter indicates the number base in which to display the watch item The radix may be specified by using D for decimal F for fractional H for hexadecimal or U for unsigned If no radix is specified the default radix of the specified item is used The default display radix of a watch item can be changed with the radix command reg addr expression c expression This parameter specifies the watch item to be added to the watch list A watch item can be a register address expression or C expression OFF Used with the second form of the watch command Turns off all watched registers addresses and expressions Table 1
162. les the specified registers and memory locations so that they are always automatically displayed when program execution is stopped If no registers or memory locations are specified all registers are enabled for display OFF Disables the specified registers and memory locations so that they are not automatically displayed when program execution is stopped If no registers or memory locations are specified all registers and memory locations are disabled for display Displays the following registers and memory locations if they were accessed for a read operation since the last display Displays the following register and memory locations if they were accessed for a write operation since the last display RW Displays the following register and memory locations if they were accessed for read or write operations since the last display Motorola The R W and RW functions initiate the accumulation of a list of accesses from display to display All accesses to register locations can be saved The memory lists store a maximum of 16 memory accesses for each memory space If more than 16 locations were accessed since the previous display only the last 16 will be stored Register and memory locations that have been accessed for a write operation are highlighted when displayed Command Reference 12 17 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc display Disp
163. lights the minimum number of required characters for each command The help line displays the syntax for a particular command when you type the required characters and then pressing the SPACE bar The command line considers any text that follows a semicolon a user comment You might use comments to log output from the Session window or to create and run a command macro The command line executes the command when you press the ENTER key or the CARRIAGE RETURN key If you enter a command that is not a valid Simulator command the Simulator interprets the command as the name of a command macro and executes the macro if it exists For more information about command syntax see Section 12 1 Command Overview Section 12 2 Command Syntax and Section 12 3 Command Parameters List of Abbreviations 1 4 Getting Started with the DSP Simulator The Motorola Suite 56 DSP Simulator gives you flexibility in debugging your object code You can take multiple approaches there is no one correct way in which to go about debugging your code Whichever approach you choose you will want to become familiar with some fairly common windows and commands Here are a few steps to help you begin a typical session with the Simulator Typically you will want to 1 Set the path of the working directory 2 Load an object file 3 Set up the display environment open windows to view the source code assembler code register values and memory values
164. locations so that two or three locations are required to store each 16 or 24 bit instruction If assembled into program memory this code cannot be executed directly it is intended for use with code similar to the byte wide loader in the ROM bootstrap code Byte wide assembly may be used interactively as in this example or to assemble a single instruction 12 5 break Set Modify or Clear Breakpoint BREAK ibn expression break action BREAK ibn R read W write RW access reg addr block break action BREAK bn bn OFF E enable D disable BREAK ton DR dma read DW write DRW access addr block break action The break command can be used to set modify or clear a breakpoint condition and to specify the action that occurs if the breakpoint condition is true The break command has four possible forms as indicated by the four command syntax lines above The first form causes a break condition if the evaluated expression is non zero The second form causes a break condition if a selected register or memory location is accessed by the core The third form permits a breakpoint or list of breakpoints to be selectively enabled disabled or deleted The fourth form causes a break condition if a selected memory location is accessed by a DSP DMA Direct Memory Access controller It is valid only for devices with on chip DMA controllers bn Optional Break number The break number is used to assign
165. ly corresponding to the current execution address list Displays the previous page of the current source file or assembly list test asm Lists source or assembly corresponding to line 1 of the source file test asm list lab 1 Lists source or assembly corresponding to symbolic address lab 1 Motorola CommandReferene 1227 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc load Load DSP Files or Configuration 12 20 load Load DSP Files or Configuration LOAD S state M memory only D debug symbols only from file The load command can be used to load DSP object module format lod files or DSP COFF cld files into the Simulator memory or to load a previously saved simulation state file S state M memory only D debug symbols only Optional If the S key character is specified the Simulator will load filename as a Simulator state file The Simulator state file can be created using the Simulator save s command Loading the Simulator state changes the entire setup of the Simulator to the previous definition saved in the state file If the M key character is specified the Simulator will load object file without modifying the Simulator s symbolic debug information If the D keycharacter is specified the Simulator will load only the symbolic debug information from the object file The device memory contents are not altered Only the COFF format files cld suffix are supporte
166. m val Read dsp memory map address to mem val dsp rpin devn pin number Read output pin state from device dsp rport devn port data force Read output port state from device dsp rreg devn periphn regn regval Read dsp peripheral register to regval dsp save filename Save the state of all devices to filename dsp_startup Initialize Simulator structures dsp_unlock device_type password Unlock password protected device type Motorola C Library Functions 13 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points Table 13 1 Higher Level Functions Function Description dsp_wapin devn pin value Write device analog input pin with value dsp_wmem devn map addr val Write dsp memory map address with val dsp_wpin devn pin value Write device input pin with value dsp_wport devn port mask data force Write device port with data and force value dsp wreg devn periphn regn regval Write dsp peripheral register with regval sim docmd devn command string Perform Simulator command on dsp device sim gmomd devn command string Get command string from macro file S im gt cmd devn command st ring m Get command string from terminal 13 2 1 dspt masm xxxxx Assemble DSP Mnemonic int dspt masm xxxxx mnemonic ops err
167. m xxxxx Assemble the instruction move r0 r1 unsigned long opcodes 3 char error ptr int retval retval dspt masm 56k move r0 r1 amp opcodes 0 amp error ptr 13 2 2 dspt unasm xxxxx Disassemble DSP Mnemonics int dspt_unasm_xxxxx ops return_string sr omr gdbp unsigned long ops Pointer to opcodes to be disassembled unsigned long sr Value of device status register unsigned long omr Value of device operating mode register char gdbp Return value reserved for use by debugger char return_string Pointer to return character buffer This function disassembles ops 0 and possibly ops 1 and ops 2 if ops 0 requires a second or third word and places the disassembled mnemonic in the return string buffer supplied by the user If correct disassembly requires a device status register and or operating mode register value the values should be provided in the sr and omr parameters The gdbp parameter is a pointer reserved for use by the symbolic debugger and should be NULL for other applications The mnemonic may require as many as 120 characters of return buffer The function returns the number 1 to 3 of words consumed by the disassembly It returns 0 for illegal opcodes and a return string containing a DC directive See Example 13 2 Note The xxxxx in the function name should be replaced by a device family number It should be 56k for the 56000 family devices 56100 for the 56100 fam
168. mbers and labels if debug information has been loaded from a COFF file To specify an address include the memory space followed by a colon followed by the address For example to execute instructions until address 00c103 is reached type p 00c103 To specify a line number in the currently loaded source file just type in the line number Or to specify a line number of a particular source file include the filename For example to execute until line number 20 of a source file named clrmem cld located in the working directory type c1rmeme 20 3 Select the checkbox labeled Halt at Breakpoints if you want the instruction to observe breakpoints If you do not select the checkbox the instruction ignores breakpoints and does not halt program execution 4 Click OK Section 12 37 until Execute Until Address on page 12 46 provides a complete command description 2 6 Pausing Execution with WAIT You can pause macro execution by specifying the number of seconds you want the Simulator to wait Execution resumes after the pause The WAIT instruction is particularly useful when you write a command macro That is if you cause the simulation to WAIT while logging commands you can then save the log file A command macro results The pause that was recorded while logging commands will be replayed when the macro is executed The wait instruction provides a useful way to pause execution so that you can examine certain values or windows Motor
169. mbling Code Stored in Memory 0 0000 ce eee eee eee 4 7 4 7 Displaying a History of Recent Instructions 0 00000 e ee 4 8 Chapter 5 Device I O and Peripheral Simulation 5 1 Introduction to Device I O Input Output 0 0 0 0 ee eee eee 5 1 22 How Are VO Files Fornatted said leds 5 1 3 Repeat Pancita at Ouid edo ae aur dde 5 2 DA COMMENTS E heed we ee hie RO ee CE EDCR Eb ose 5 2 O5 Vinnie Informatie o 3icr ice eta 3 64 ELENA ES e metet et aap 5 3 50 Peripheral Data a ab p aa EX qus tacit 5 3 ST o AAA the kaa ee Ped do E esee e eG tesi ded qnd 5 4 aor Memory Data oss a a ERA SA AS LI LESE 5 5 59 Pinon Pin Group Data s eser ey ice x soy er D DER EX Sed xeu 5 6 5 10 Terminal Input of Data Values c iudoeax wx v ERR USEN M RIS D EX ER RR RN 5 7 OLI Assigning am Input Piles e E T 5 8 5 12 Assigning an Output Flle or2 soy e iE pos kal v as 5 11 Chapter 6 Simulator and Device Configurations 6 1 Introduction to Simulator Configuration esses 6 1 6 2 Setting the Default DEVICE suere o EI yt 6 2 5 3 Xh nging he AAA te re A ed CE ERAN Ra utate ade 6 2 6 4 Loading Simulator State Files 2 2 20 0 0 cece ee nee 6 4 6 5 Changing and Saving Window Preferences 02 00 c ee eee eee 6 6 iv Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 7 Debugging C Source Co
170. med memory input file causes the data sequence 7FFF 7F3F 5D3C 7FC3 to appear during consecutive reads of the specified memory location LFF 0 The untimed memory input file causes the data sequence 1FF 0 to appear repeatedly during consecutive reads of the specified memory location 10 0 5 10 0 3 The timed memory input file causes the data sequence 0 5 0 3 to alternate in the specified memory location 10 cycle intervals 2000 1C3 2005 1CF The timed memory input file causes 1C3 to appear in the specified memory location at cycle 2000 and 1CF to appear at cycle 2005 5 9 Pin or Pin Group Data When assigned to a pin or pin group the input file data value supplies the zero 0 or L one 1 or H a negative pulse within a single cycle N a positive pulse within a single cycle P or a tristate X value to be applied to the pin or to each pin in the group with the first specified pin mapping to the least significant bit of the data value Each data word must contain as many characters 0 1 L H N P or X as there are pins in the group If an analog input file is assigned to a device analog pin the input command must specify the floating point radix with the rf radix designator in the input command Likewise an analog output pin file must be specified with the rf radix designator in order to generate floating point output for the pin rather than the digital pin values described in the preceding paragra
171. memory map memory designator The core simulation calls this function during the last clock cycle of each external memory access The memory map parameter will be a memory designator as returned by dsp findmem Use the Simulator help mem command for a list of valid memory names The memory map enum is memory map concatenated with a valid memory name As an example memory map pa refers to off chip pa memory on the 96002 device 13 22 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator External Memory Functions 13 3 3 dspl_xmfree Free DSP Device External Memory dspl_xmfree device index int device index DSP device index to be affected by command This function must free any memory that has been allocated to represent the external memory space of a selected device Note that this function should not be called directly by the user s code It is called as one of the steps in freeing an entire device structure by dsp free See Example 13 32 Example 13 32 dspl xmfree Free external memory of dsp device structure 0 int devn devn 0 dspl_xmfree devn 13 3 4 dspl xminit Initialize DSP Device External Memory dspl xminit device index int device index DSP device index to be affected by command This function must initialize the values in any structures used to represent the external me
172. miconductor Inc 12 28 redirect Redirect stdin stdout stderr for C Programs 12 38 12 29 reset Reset Device OL tae ade Wo deve ces oec s cepe ei oa 12 39 12 30save Save simulator Ee us esa eX ss 12 40 12 31 step Step Through DSP Program usada AE 12 41 12 32 streams Enable Disable Handling of I O for C Programs 12 42 12 33 system Execute System Command 34 44 42 42345446 OS ES RE RC IPS 12 43 12 34 trace Trace Through DSP Program 0 00 0 cece eee ee 12 44 12 35 type Display the Result Type of C Expression 00 12 45 12 36 unlock Unlock Password Protected Device Type 04 12 46 12 37 until Execute Until Address rss ee du rev Sasa ede e 12 46 12 38 up Move Up the C Function Call Stack 0 0 0 0 000 0000 12 47 12 39 view select Display Moderada ds 12 47 12 40 wait Wait Specified Time dex st SR OR Re a 12 48 12 41 wasm GUI Assembly window 0 0 00 eee eens 12 48 12 42 watch Set Modify View or Clear Watch item oo ooooooooo o 12 49 12 43 wbreakpoint GUI Breakpoint Window 0 0020 12 50 12 44 wcalls GUI C Calls Stack window 0 0 0 ee eee eee 12 50 12 45 wcommand GUI Command window 0c eee eee eee 12 51 12 46 where GUI C Calls Stack window 0 00 eens 12 51 12 47 winput GUI File Input window isc Rr t RR EUER 12 52 12 48 list GUILD Ist NWIndOW o
173. mmand window provides an alternative to using the menu bar or the toolbar the command line also let you monitor the syntax of the Simulator commands The Command window is also a useful source of information in that it echoes the commands from the menu bar and from the toolbar It also provides a source of history The command history buffer holds the ten most recent commands If the last command is repeated exactly the duplicate is not stored To display the Command window 1 From the Windows menu choose Command The Command window appears 11 2 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Command Window command history Command Al x wasm E weommand help help pin command line help io i help z device number asm break change copy device disassemble lt space gt more Figure 11 2 Displaying the Command Window 2 Notice that the device number is indicated This is the device to which the commands are applied In order to affect another device the default device must be changed The Command window also provides device specific information that is not available elsewhere in the Simulator To display device specific information 1 From the command line of the Command window type help 2 A list of help topics is displayed in the Session window Check the list for the device specific information that you are wanti
174. mory of a dsp device The Simulator commands reset s and load s will call dspl minit in the processes of initializing or reloading the Simulator state See Example 13 33 Example 13 33 dspl xminit Initializing external memory for device 1 int devn devn 1 dspl xminit devn 13 3 5 dspl xmload Load DSP External Memory from State File int dspl xmload device index fp int device index DSP device index to be affected by command FILE fp Pointer to file opened in text read mode r This function must restore external memory from a Simulator state file Note that this function should not be called directly by the user s code The dspl xmload call is the last step of the asp 1oad function which loads a Simulator state file The file pointer provided to dsp1_xmload will have been opened with p fopen filename r and the remainder of the Simulator state will have already been restored from the state file The steps used to restore the external memory should complement the steps used to save external memory in the dsp1_xmsave function The return value of dspl mload should be 1 if successful O if an error occurred The dsp_load function will close the file following the dsp1_xmload call See Example 13 34 Motorola C Library Functions 13 23 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator External Memory Functions E
175. n addr input Assign Input File The destination of the input data All subsequent reads of the destination will reference the source of the input data The source of the input data Providing the OFF parameter disables the input specified by n Providing the TERM parameter indicates that the input data will be typed from the keyboard Providing a filename indicates that the input data is contained in file Ifa filename suffix is not specified the Simulator will assume 10 for a non timed input file and t io for a timed input file Optional The default input radix for the data may be specified by using RD for decimal RYF for fractional RH for hexadecimal or RU for unsigned Hexadecimal input is the default for addr port and peripheral data values Input analog pin data files must be assigned with the RF radix designator and the file data must be single precision floating point values The time value is always expressed in decimal Chapter 3 Object Files and Data Files on page 3 1 contains an extensive description of the input file format In the second form of the input command this parameter represents the name of the pin that is the destination of the input data The second form of the input command allows input to a device pin from another device pin without having to store the data in a disk file In the second form of the input command this parameter represents the name of the pin that is the source of
176. n dspl xmsave devn fp Save DSP External Memory to State File dspl xmstart devn map Start DSP External Memory access dspl xmwr devn map add val store Write DSP External Memory with val The external memory access functions are provided in source form so that the external memory map attributes can be customized This is especially useful for multiple dsp simulations in which complex configurations such as dual port memory may be required The functions in simvmem c simulate the entire external memory space of up all dsp devices 13 3 1 dsp alloc Allocate Simulator Program Memory void dsp alloc numbytes unsigned int numbytes Size of memory block needed in bytes This function must return a character pointer to the requested number of bytes of memory It is not necessary for the memory to be cleared A simple version could just call malloc The Simulator will not recover if the dsp alloc call fails so an exit must occur within dsp alloc if the requested memory cannot be allocated See Example 13 31 Example 13 31 dsp alloc Allocate memory for a new structure void dsp alloc struct new struct char buf 1000 int bufindex newp newp struct new struct dsp alloc sizeof struct new struct 13 3 2 dspl xmend End DSP External Memory Access dspl xmend device index memory map int device index DSP device index to be affected by command enum memory map
177. n On This Product Go to www freescale com Freescale Semiconductor Inc Modification of Device Global Structures 13 40 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc A alternate directory 3 1 ASM examples 12 7 12 8 ASM Single Line Interactive Assembler 12 7 Assembly 11 5 11 6 assign 5 11 output file 5 11 5 12 5 13 B binary 6 3 break 2 4 2 7 12 8 breakpoint 1 15 12 12 action 12 10 clear 13 9 examples 12 12 testing 13 6 13 19 13 33 Breakpoints 1 13 11 1 11 5 11 6 byte wide 12 7 C C 7 1 Call Stack 7 1 7 2 Calls 7 4 CHANGE 13 26 change 12 13 examples 12 14 cld 13 10 cmd 13 20 COFF 3 3 command 8 1 8 2 11 2 11 3 12 5 12 6 ASM 12 7 DEVICE 12 15 DISASSEMBLE 12 16 DISPLAY 12 18 DOWN 12 19 entering 1 2 FINISH 12 21 HISTORY 12 24 INPUT 12 24 12 25 LIST 12 27 command entry command line editing 13 20 expansion 13 20 from macro file 13 19 13 20 Motorola Index from terminal 13 19 13 20 13 28 command execution go mode 13 19 macros 13 19 13 20 trace mode 13 19 13 30 Command Overview 12 1 Command Syntax 12 4 commands load 13 32 system 13 28 13 29 comment from dspt masm 13 4 configuration custom external memory 13 22 13 34 Copy 12 14 examples 12 14 Copy Memory 4 6 create 8 1 CTRLBR 13 34 CTRL C 13 28 13 34 D data 5 9 5 10 debugging 7 1 decimal 6 3 default
178. n a file or from the keyboard The second form allows input to a device pin from another device pin without having to store the data in a disk file The third form of the input command causes the Simulator to read the memory location of a specified source specified by from dwn addr each time the destination memory address is accessed for a read This enables simulation of a system consisting of multiple devices via dual port memory Data values may be expressed in hexadecimal decimal or floating point for memory and peripheral name assignments as one of 5 input values 0 1 n p or X for assignment to individual digital pins or as single precision floating point values for analog input pins n Optional The number that will be assigned to this input Input numbers do not have to be consecutive they can be assigned arbitrarily which means that you can assign input numbers in any way that helps you organize the sources of the inputs If no number is provided the Simulator will automatically assign the next available number T timed Optional When included with the input command this parameter indicates that the source data is in the form of time data pairs addr port periph pin _group 12 24 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc OFF TERM file RD RF RH RU pin from DVn pin addr from DV
179. ndmem Get Map Index for Memory Prefix dsp findmem device index memory name memory map int device index DSP device index to be affected by command char memory name memory space name enum memory map memory map return memory map type This function searches the dt_var mem structure for a match to the memory name string provided in the function call If a match is found dsp_findmem returns the memory map maintype structure value through the memory map parameter and 1 as the function return value otherwise it just returns O as the function return value See Example 13 4 For a list of memory names use the Simulator help mem command Example 13 4 dsp findmem include coreaddr h int devn enum memory map map int ok dsp startup devn 0 dsp new devn 56116 Allocate structure for device 0 a 56116 ok dsp findmem devn p amp map Get memory map index for p memory 13 6 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points 13 2 5 dsp findpin Get Pin Number for Pin Name dsp findpin device index pin name pin number int device index DSP device index to be affected by command char pin name pin name int pin number return pin index This function searches the dt var xpin structures for a match to the pin name s
180. new device type that can then be created by the simulator s device command The basic idea is to create a new device type and definition by modifying a previous definition in the dsp file As an example using the 56116 device in the file dsp56100 c the procedure would be Make a copy of dsp56100 c and name it something else Modify the makefile file to include this new module name for compilation and linking in the same manner that makefile handles the dsp56116 In the new file rename the dx 56116 structure to some name other than dx 56116 and put a pointer to this new structure in the dx a11 array in the file simglob c In the new dt var structure change the device type name to some name other than 56116 this is in the first member of the dt var structure In the new file change the sx 56116 structure to some name other than sx 56116 and put a pointer to this new structure in the sx a11 array in the file simglob c Motorola C Library Functions 13 37 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Modification of Device Global Structures After the above steps are completed lower level structures and define constants in the new module can be modified to change such parameters as on chip memory size number of peripherals or number and names of pins Continuing with the 56116 example Table 13 5 is a list of the lower level structures and define constants associated with the 56116
181. ng You might have to scroll back up the Session window to see the whole list 3 From the command line of the Command window type help followed by the name of the help topic For example to list the on chip I O registers and their addresses type help io The help information is displayed in the Session window Some of this information can be lengthy so it might be useful to log the Session window output See Section 8 2 Logging Output from the Session Window on page 8 2 for information about logging output Motorola Displaying Information 11 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Session Window 11 4 Session Window The Session window is the main output for the Simulator The Session window displays anecho of all commands input at the command line from the Command window output from commands e information from the Display menu views of source code and assembly code registers and memory locations enabled for display at breakpoints and after execution error messages To display the Session window 1 From the Window menu choose Session 2 The Session window opens You will probably have to scroll and resize the window to be suitably visible Note that it is not possible to have more than one Session window open at a time The Session window displays output for the current device only However each device writes output to its own buffer That is eac
182. ng commands relate to control of program execution specify break conditions go until a break condition is met step a specified number of instructions or cycles before displaying register and memory changes trace a specified number of instructions or cycles displaying register and memory changes at each step The next instruction operates essentially the same as the STEP instruction except that if the instruction being executed calls a subroutine or function execution continues until return from the subroutine or function The until instruction has the effect of setting a temporary breakpoint at a specified address executing until a breakpoint is encountered then clearing the temporary breakpoint The finish instruction executes instructions until the current subroutine or function completes 12 1 4 C Source Code Debug Commands The following commands relate to debugging C source code 12 2 where to display the C function call stack up down and frame are used to traverse the call stack redirect is used to redirect data from stdin stdout stderr to files streams enable the io streams type displays the data type of a variable function or C expression Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Command Overview 12 1 5 Miscellaneous Tasks The following commands include miscellaneous tasks device specifies a new device and
183. ng the assembly or register screens and in source line increments if viewing the source screen The CY LI and IN options permit cycles source line or instruction increments to be specified explicitly H halt at breakpoints Optional The default is to ignore all breakpoints while the step command is executing The h parameter enables halting at breakpoints Table 12 34 STEP Commands Command Resulting Simulator Action step Steps one instruction or source line depending on the display mode and displays the enabled registers and memory blocks step li Steps one source line regardless of the display mode and displays the enabled registers and memory blocks step 50 Executes hex 50 instructions or source lines depending on the display mode then stops and displays the enabled registers and memory blocks at the end of the hex 50th instruction step 50 in h Executes hex 50 instructions regardless of the display mode then stops and displays the enabled registers and memory blocks at the end of the hex 50th instruction Halts if a breakpoint is encountered during the execution step 20 cy Executes 20 clock cycles and displays the enabled registers and memory blocks at the end of the 20th clock cycle Motorola Command Reference 12 41 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc streams Enable Disable Handling of I O for C Programs 12 32
184. nput filename Alternate directories are also searched in turn if an input file is not found in the working directory To display the current paths 1 From the Display menu choose Path 2 Open the Session window if not already open The Simulator displays the current working directory and the alternate source paths Motorola Object Files and Data Files 3 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Displaying the Current PATH Session window for device 03 Dv03 Session OF x wsession path Device Working Directory C DSPtools software Win NT GUI563 BIN No Alternate Source Paths Figure 3 1 Displaying Current Paths Keep in mind that the Simulator displays a separate directory path for each device This means that as you switch from one device to another the working directory also changes according to the current device The top left corner of the Session window indicates the current path Section 12 25 path Specify Default Pathname on page 12 35 provides a complete command description 3 2 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com 3 2 Freescale Semiconductor Inc Saving Object Files Saving Object Files You can save memory blocks in DSP COFF or ASCII OMF object files The object files can be reloaded in the Simulator or in any other environment where such files are used
185. nt device is always the device that is displayed in the Session window Use the device command to change the current device OFF Optional Closes the Session window Table 12 54 WSESSION Commands Command Resulting Simulator Action wsession Opens a session window for the current device Closes the session window wsession off 12 53 wsource GUI Source window WSOURCE OFF The wsource command opens a source code window which list the source code of the currently loaded program cld file Source debug information must be included in the source file for source code to appear in this window OFF Optional Closes the source window Table 12 55 WSOURCE Commands Command Resulting Simulator Action wsource Opens a source window for the current device Closes the source windows for the current device wsource off Motorola Command Reference 12 55 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc wstack GUI Stack window 12 54 wstack GUI Stack window WSTACK OFF The wstack command opens a device stack window which displays the current call stack Multiple stack windows may be opened for debugging on systems with multiple DSPs OFF Optional Closes the stack window Table 12 56 WSTACK Commands Command Resulting Simulator Action wstack Opens a stack window for the current device wstack off
186. nts break off Remove all breakpoints break 41 3 5 9 off Remove breakpoints numbers 1 3 and 5 through 9 break pc 500 Halt DSP program simulation and display enabled registers and memory when the program counter register is greater than or equal to hexadecimal 500 break 1c 10 amp amp pc 100 Halt if the loop counter is less than 10 and the program counter is greater than 100 break jump n Display breakpoint message if a jump change of flow occurs during execution break eof l pc fff Halt if an end of file condition occurs in an assigned peripheral input file or if the program counter is greater that hexadecimal FFF break r0 r1 Halt when the value of register rO equals the value of register r1 break lc 0 amp amp jump il Increment variable cnt1 if a jump occurs and the loop counter is greater than 0 break r ro Halt if register rO is accessed for a read operation break p 100 Halt if the execution address is p 100 break w lc Halt if the loop counter register is written during code execution break 10 x evaluate h Set a breakpoint at the address corresponding to line 10 of the ro current source file Execute the Simulator command evaluate h r0 when the breakpoint occurs break myfile asme20 Set a breakpoint at the address corresponding to line 20 of source file myfile asm break r xdat xdat 50 Halt if a read occurs from one of the 50 addresses beginning at the address associated with the symbol xdat break rw p
187. oduct Go to www freescale com Freescale Semiconductor Inc Assigning an Output File is io The Simulator can store data only or time data pairs The output time value is always expressed in decimal The output file is in ASCII format 13 Click OK Section 12 24 output Assign Output File on page 12 33 provides a complete command description Motorola Device I O and Peripheral Simulation 5 13 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Assigning an Output File 5 14 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 6 Simulator and Device Configurations 6 1 Introduction to Simulator Configuration You can specify a specific DSP configuration for each device The selected device configuration determines the internal memory attributes and simulated peripherals The Simulator determines external memory access by the device configuration To set the configuration of a device 1 From the Modify menu select Device Then choose Configure Under Device select the number of the device that you want to configure Under Configure select Type Under Device Type select the type of device that you want to simulate Click OK nA RC N The Simulator contains the predefined memory map of the default device type as the default memory configuration You can configure the device
188. ola Controlling Execution 2 5 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Allowing the Current Function to FINISH after an UNTIL Condition or a Breakpoint To pause execution 1 From the Execute menu choose Wait 2 Select the number of seconds to pause or click on the checkbox Forever to pause indefinitely 3 Click OK 4 An information box appears to let you know that the Simulator is paused If you don t want to wait for the pause to end automatically you can resume program execution by clicking Cancel Keep in mind that if you click cancel while recording a command macro that the cancellation of the pause is not recorded So for example 1f you specify a WAIT of ten seconds and then cancel after three when the command macro executes it will pause for the full ten seconds Section 8 1 Creating and Running a Command Macro on page 8 1 provides more detailed information Section 12 40 wait Wait Specified Time on page 12 48 provides a complete command description 2 7 Allowing the Current Function to FINISH after an UNTIL Condition or a Breakpoint Sometimes a program execution stops while in the middle of executing a subroutine or function This might occur for several reasons Execution may stop if you specify that a certain number of steps be executed which happened to end in the middle of the subroutine Or execution may stop if an UNTIL condition or breakpoint is rea
189. om Freescale Semiconductor Inc asm Single Line Interactive Assembler 12 4 asm Single Line Interactive Assembler ASM B byte wide beginning at addr assembler mnemonic The asm command allows you to create or edit DSP object code in memory using assembly language mnemonics The assembler mnemonic is immediately converted into machine language code and stored in memory The line of assembly source code is not saved B byte wide beginning at addr assembler mnemonic Optional When provided this parameter causes the assembler mnemonic to be divided and stored as a sequence of single bytes This option is typically used to store a program as a byte wide program in the bootstrap ROM area of the target device This option could also be used to store a byte wide program in external memory which might hold for example overlay program code Optional The addr parameter specifies the beginning address to be edited The address can be in any of the memory maps p x y pr etc of the target device The Y memory is only valid for DSP56000 and DSP96002 family members Use the Simulator s help mem command to obtain a list of the valid memory space prefixes If no address is specified assembly begins in the p program memory space using the current program counter value as the beginning address The pr memory designation specifies the special bootstrap ROM area of the DSP Optional The mnemonic to be written
190. ommand entry or for display of registers and memory locations The Simulator by default uses decimal input radix and hexadecimal display radix when it is initially invoked Changing the default input radix allows you to enter constants in the chosen radix without typing a radix specifier before each constant If no parameters are used with the radix command the current default radix is displayed in the Session window B binary D dec F float H hex U unsigned Optional This parameter when not followed by a register name or memory location specifies the radix to use as the default input radix When followed by a register name or memory location the radix will be applied as the default display radix when displaying the values conatined in the register memory location reg block addr block Optional Specifying a list of register and or memory locations following the radix specifier will set the display radix of the registers and memory to the radix specified This does not affect the default input radix A range of registers can be specified by typing start reg end reg where start registhe beginning register and end reg is the last register of the block 12 36 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc radix Change Input or Display Radix A range of addresses can be specified by typing start_addr count where
191. omplete command description 10 3 Stop Button The Stop button stops program execution or if a command macro is running stops the macro Brean 2 p 5 000108 h dcu b pe aide cyc 244 CHHHHHHMHHHM In ya HHHHHHHHHHHH 2 addqqqqgpbbbbb b QQbbbbbbbbbb d xI HHHHHH xHeCHHHHHH r 9 S HMHHHH SH ted meni yHeSHHHHHH ras THHHHHH tmb 32 09 at bbbbbb 39 00QQQQ rs jbbbbud n5 a hye SOS s E r2 vara rs q Figure 10 2 Stop Button Section 2 8 Stopping Program Execution on page 2 7 provides more information about stopping program execution 10 2 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Step Button 10 4 Step Button The Step button executes the next instruction or line yu Breall 2 p 500010 h deuzb pr Q1QE cyr 244 x SHHHHHMHHHHHM HHHHHHHHHHHH a qqqqQQQQbbbbbb b QQbbbbbbbbbbQQ xI S HAHAHA xH SHHHHHH r 9 S HHHHHH u e H C SN LN a Ma 040 rua y4 gQJz4 5 DEL axo Figure 10 3 Step Button If the Source window is open displaying the program source the Step button executes one line of code Otherwise the Step button executes one instruction On encountering a JSR instruction the Simulator begins with the first instruction of the function and steps through it one instruction at a time To step one instruction at a time from the toolbar 1 Make sure that progr
192. onductor Inc Modification of Device Global Structures DSP_CMDSZ This define constant determines the size of the previous command stack The Simulator commands are stored in the stack and can be reviewed using the ctrl f and ctrl b key entries As a default the previous command stack size is set to 10 DSP HISTSZ This define constant determines the size of the execution history buffer which stores device instructions as the Simulator executes The buffer is used by the Simulator history command and has a default size that can save 32 instruction words DSP WINSZ This define constant determines the size of the screen buffer that is maintained and displayed by the scrmgr c functions It specifies the number of display lines that will be allocated for each device as they are created with the Simulator device command The user can use the ctrl u ctrl t ctrl v and ctrl d key sequences to review display lines that have scrolled off the screen This constant should not be set to a value smaller than the number of lines in the display window 13 10 Modification of Device Global Structures The device types available to the simulation are defined in the source module named with the prefix dsp followed by the device family name As an example the file dsp56100 c contains the global structures dx 56116 and sx 56116 which define device specific information about the DSP56116 device in the 56100 family You may wish to modify this module to define a
193. onitor the calls that are made by C functions by displaying the Calls window The Calls window dynamically monitors the C function calls as they occur To monitor C function calls 1 From the Windows menu choose Calls level in the function label nesting address Dv0O0 Calls HO p 0x112 in loop H1 p 0 10a in Figure 7 4 Dynamic Display of C Function Calls The Calls window updates as each instruction is executed If the instruction contains no function call three question marks are shown to indicate that no function is recognized 2 Double click on a stack level to select it as the expression context to evaluate expressions Each function call adds another stack frame each return removes one Entry 0 is the most nested function that is the top entry on the stack The highest number is the main function Each entry shows a number to indicate the level to which the call is nested the PC return address 1 e the address after the function call and the name of the function The top level represents the entry to the debug monitor and so indicates the next instruction to be executed The call stack also indicates the context to use for evaluating C expressions As each function may have its own copy of a named variable it may be necessary to indicate which instance is required 7 4 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freesca
194. operating mode 0 as the default operating mode following subsequent hardware reset sequences reset s Resets the entire Simulator state to the start up condition All breakpoints are cleared the memory is initialized and all logging and I O files are closed Motorola Command Reference 12 39 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc save Save Simulator File 12 30 save Save Simulator File SAVE S state addr _block filename A O C The save command allows creation of a Simulator state file from the current Simulator state or creation of an object module format file or a COFF format file from specified memory blocks S state addr block filename A 0 C If S is specified as the second parameter a Simulator state file is created It contains the entire simulation state including memory contents breakpoint settings and the current pointer position of any open files This file is in an internal format that is efficient for the Simulator to store and load see the load s command description The default suffix for a Simulator state filename is sim If the addr _block parameter is used the memory areas specified are stored in object format so the file can be reloaded with the Simulator load command The default object format is the OMF format described in Chapter 6 If no file extension is explicitly specified the extension
195. operating mode in the form Mn pathname Any valid pathname periph Valid peripheral names are displayed by the Simulator help periph command pin Valid pin names are displayed by the Simulator help pin command A pin name may optionally be preceded by pin in order to resolve conflicts that may exist between pin and register names or constants pin block pin pin port Valid port names are displayed by the Simulator help port command Motorola Command Reference 12 5 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Command Parameters List of Abbreviations Table 12 2 Command Parameter Abbreviations Continued Abbreviation Meaning reg Valid register names are displayed by the Simulator display all command A register name may optionally be preceded by reg inorder to resolve conflicts that may exist between register and pin names or constants reg block reg reg reg group An address may be specified as a source file line number or as a symbol name if a previously loaded COFF object file contains symbolic debug information Otherwise a memory space designator must be used Use the help mem command from the command line of the Command window to obtain a list of the valid memory space prefixes topic addr location addrffcount 12 6 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale c
196. or Inc List of Tables 1 1 35t 0E ODGratOte 4 iis poi OE A A E RR 1 11 1 2 Breakpoint Actions 3 brotar A ORI Re 1 12 5 1 Repeat Punctuation Input Data cti sy byes EP REO ah oe vey 5 2 5 2 Input Memory ata su A RUE Pah eae oe Reale eae atv s 5 6 5 3 Pin or Pin Group Input Dada A 5 7 5 4 Te minal Input Data ooh a A eps a Red 5 8 9 1 Valid Forms of Symbol Names and Line Numbers 9 3 12 1 Command Syntax Elements in Motorola DSP Documentation 12 4 12 2 Command Parameter Abbreviations eese 12 5 12 3 asm Command Ss esses sicca nde ite eG NOD Neq desi v Rie 12 7 12 4 Breakpornt Operators a AR ge t Se Rat req ORO 12 9 12 6 Break Action Parameters ve uade ep e n nes c ds Pe 12 10 12 5 Flag Variables in a Breakpoint Expressi0NM oo ooooooooooo 12 10 12 7 BREAK Commands tutti ben kalba pd un AUN Ende x Ap 12 12 12 8 CHANGE Commander ri da 12 13 12 9 COPY Commandos massa oa a ds e ocala Sees 12 14 12 10 DEVICE Command icororia tee xe Rer d EROR n 12 15 12 11 DISASSEMBLE Commands seen 12 16 12 12 DISPLAY Enable Keywords 4 oe 32 45 45 RUE Ere ee Vua 12 17 12 13 DISPLAY COMMAND ED ve CR de eS yog S 12 18 12 14 DISPLAY Commands Without Enable Keywords 12 18 12 15 DOWN Commands rever made ti ed p RE ees 12 19 12 16 EVALUATE Commands 3 eus ea ERES quA RE PNEEIN E EEK 12 20 12 17 FRAME COMMISSION P 12 21 12 18 GO Commlmdlds is ASAS p eee eek UNES 12 22 12 19 HELP Syntax o3
197. or ptr char mnemonic unsigned long ops char error ptr Pointer to assembler mnemonic string Where to put the words of assembled opcode Will point to error message if an error occurs This function invokes the single line assembler to assemble a DSP mnemonic Table 13 2 list the different integ er code it returns Table 13 2 Integer Code Code Description i An error occurred The user supplied error pointer will point to a message that explains the error 0 The line mnemonic provided was a comment 1 The mnemonic assembled correctly and required 1 word of code The code will be in the ops 0 location 2 The mnemonic assembled correctly and required 2 words of code The first word will be in placed in ops 0 the second in ops 1 3 The mnemonic assembled correctly and required 3 words of code The first word will be in placed in ops 0 the second in ops 1 the third in ops 2 Note Note that the xxxxx in the function name should be replaced by a device family number It should be 56k for the 56000 family devices 56100 for the 56100 family devices and 96k for the 96000 family devices 13 4 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points Example 13 1 shows how to use the dspt_masm_xxxxx function Example 13 1 dspt mas
198. ory space The character string will be displayed or Motorola Command Reference 12 33 For More Information On This Product Go to www freescale com output Assign Output File A 0 C history ehistory Freescale Semiconductor Inc written to an output file This string radix is provided primarily for use when debugging programs created with the C Compiler The output time value is always expressed in decimal Chapter 3 contains a thorough description of the output file format Optional The CA O or C parameter may be used to indicate append overwrite or cancel if the filename already exists If you do not specify this parameter and the filename already exists you will be prompted during command execution to make the decision to append overwrite or cancel Used with the second form of the output command This usage creates a continuous log of the device execution addresses and disassembled opcodes The output format is similar to the output generated by the Simulator history command Used with the third form of the output command This usage is an extended version of the output history command Additional execution history is included in the output including device wait state cycles and bus arbitration cycles and indication of other stall conditions The extra information is preceded by double asterisks in the log file Table 12 27 OUTPUT Commands Command Resulting Simulator Action output x
199. output data is being sent from a port under Port select the name of the port The list of available ports varies depending on the device that you are targeting To see a list of port names and their index and mask type help port from the command line of the Command window 8 If the output data is being sent from a pin under Pin select the pin location If the pin that you want to send the data from is a single location as opposed to a range of pins select the name of the pin under Start If you want the output data to come from a range of pins select the name of the Start and End pin To see a list of pin names and their indices type help pin from the command line of the Command window 9 If the output data is being sent from a register under Register select the register 10 If the output data is being sent from a peripheral under Peripheral select the name of the peripheral The list of available peripherals varie depending on the device that you target To see a list of peripheral names with indices type help periph from the command line of the Command window 11 UnderRadixselectthe number system hexadecimal decimal etc in which the output data should be written 12 If the output data is being sent toa file under File Name type in the name of the output file or click on the File button to browse for the file The default filename extension 5 12 Suite56 DSP Simulator User s Manual Motorola For More Information On This Pr
200. package in the file simvmem c These functions define all the operations associated with reading writing or storing dsp external memory locations The Simulator memory allocation function is also included in this module since the representation of external memory is implemented with a virtual memory technique that is integrated with the memory allocation service The external memory functions with the exception of dsp alloc would not normally be called directly from the user s code They are referenced from other Simulator functions such as dsp_load or dsp_rmem described in Section 13 2 Table 13 3 is a reference list of the external memory functions Table 13 3 External Memory Functions Function Description dsp_alloc num_bytes Allocate Simulator Program Memory dspl xmend devn map End DSP External Memory access dspl xmfree devn Free DSP Device External Memory dspl xminit devn Initialize DSP Device External Memory dspl xmload devn fp Load DSP External Memory from State File dspl xmnew devn Create New External Memory Structure dspl xmrd devn map add val fetch Read DSP External Memory Location to val i Motorola C Library Functions 13 21 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator External Memory Functions Table 13 3 External Memory Functions Continued Function Descriptio
201. ph Floating point io files may only be assigned to a single analog pin The Simulator applies untimed pin input data values to the specified pin in each Simulator clock cycle Timed pin input data values will be applied to the specified pin at the specified relative time intervals t ime or at the exact Simulator cycle indicated by the timing information within the file 5 6 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Terminal Input of Data Values If a lower case letter t is placed in a data position of the input file you will be prompted for the next input data value as described in the section below titled Terminal Input of Data Values Storage of pin data to an output file will occur any time the pins data value changes including changes to tristate 1 0 H or L In the timed output mode the Simulator cycle count and a data value are stored each time a word is written In the untimed output mode a single data value is stored each time a word is written The Simulator also provides a special mode that allows pin data input reception from the output of another pin without the necessity of an intermediate disk file Table 5 3 Pin or Pin Group Input Data Data Sample Explanations 0 0 1 This untimed Reset pin input file causes the Reset pin to go low for two cycles then back high 12000 0 12010 1 This timed IRQA pin in
202. pin This function writes a selected dsp device pin with a single precision floating point input value Use the Simulator s help pin command to produce a list of the valid pin names and each pin s corresponding pin index The device pin number can also be obtained by using the pin name as a key and calling the function dsp findpin See Example 13 23 Example 13 23 dsp wapin include simcom h include simdev h Write the reset pin of device 0 with a high level int devn int pinnum float pinval dsp startup devn 0 dsp_new devn 56156 Allocate structure for device 0 a 56156 dsp findpin devn mic amp pinnum Get pin number for pin named mic pinval 0 709 dsp_wapin devn pinnum pinval 13 2 24 dsp wmem Write DSP Memory Location dsp_wmem device_index memory_map address value int device_index DSP device index to be affected by command enum memory_map memory_map memory designator unsigned long address DSP memory address to write unsigned long value Pointer to value to write to memory location This function writes a selected dsp memory location The memory map parameter is selects the appropriate dt memory structure from dt var mem for the selected device These structures are describe in the simdev h file which is included with the Simulator The memory map parameter can be obtained with the function dsp findmem by using
203. ple change pc test asm 30 Qsource filename line number translates to the address associated with line number in the named source file Example change pc test asm 30 source filename translates to the address associated with the first line in the named source file Example list test asm Qsource filename translates to the address associated with the first line in the named source file Example list test asm 9 6 Using Constants Constants represent quantities of data that do not vary in value during the execution of a program 9 7 Numeric Constants Numeric constants can be in one of three bases e Binary constants consist of a percent sign followed by a string of binary digits 0 1 For example 11010 1001100 Hexadecimal constants consist of a dollar sign followed by a string of hexadecimal digits 0 9 A F or a f For example SFF S12FF 12ff Decimal constants can be either floating point or integer Integer decimal constants consist of a string of decimal 0 9 digits Floating point constants are indicated either by a preceding following or included decimal point or by the presence of an upper or lower case E followed by the exponent The special constants inf and nan can be used in floating point expressions to represent the IEEE floating point values of infinity and not a number for DSP devices which operate with IEEE floating point values For example 9 4 Su
204. put causes the IRQA pin to go low at cycle 12000 then back high at cycle 12010 200 0 20 1 9 This timed IRQB pin input causes the IRQB pin to go low after 200 cycles and stay low for 20 cycles The sequence is repeated 9 times 5 10 Terminal Input of Data Values The Simulator provides two levels of terminal data input If the input command specifies term as the input filename the Simulator opens an editor which allows creation of an input data file without leaving the Simulator The data file is given a temporary name termxxxx io or termxxxx tio xxxx being a numeral between 0000 9999 and is saved on the disk at the termination of the input command You can specify the entire contents of the input file in this manner A second level of terminal data input allows you to be prompted any time the next input data value is needed This method is triggered if the lower case letter t is encountered in the data field of the input file This is only valid for the data field not for the time field Each time a t is encountered you will be prompted for a single data value from the terminal The Simulator will read the input data using the radix specified in the input command Hexadecimal is the default input radix If you just type the return key at the prompt without entering a data value the previous data value will be repeated If you type the ESC key at the prompt an end of file status will be simulated and the previous data
205. r cycle indicated by the timing information within the file If the first timing information in the file is a relative value time the Simulator waits until the first read of that memory location before getting the first data value Otherwise the data application occurs at the exact specified cycle If a lower case letter t is placed in a data position of the input file you will be prompted for the next input data value as described below in Section 5 10 Terminal Input of Data Values Storage of data to a memory output file occurs any time a write operation occurs to the memory location In the timed output mode the Simulator cycle count and a data value are Motorola Device I O and Peripheral Simulation 5 5 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Pin or Pin Group Data stored each time a word is written In the untimed output mode a single data value is stored each time a word is written The output data value can be in decimal binary hexadecimal floating point or string form Specify the output radix in the output command The default output radix is hexadecimal The string form of output data uses the value written to the memory location as the starting address in the same memory space of a zero terminated ASCII character string The character string is written to the output file Table 5 2 Input Memory Data Data Sample Explanation 7FFF 7F3F 5D3C 7FC3 The unti
206. register name in the expression There are also two special flag variables that you may reference in the breakpoint expression Jump 9 Under Action select what action is taken when the breakpoint is encountered Table 1 2 provides a list of breakpoint actions Is TRUE if an end of file condition occurs in an input file assigned to a peripheral or memory location Is TRUE if a jump change of flow occurs during code execution Table 1 2 Breakpoint Actions Action Behavior Halt Stops program execution when the breakpoint is encountered Note Displays the breakpoint expression in the Session window each time it is true Program execution continues The display in the Session window is not updated until program execution stops Show Displays the enabled register memory set Program execution continues Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Starting the Execution of Instructions with GO Table 1 2 Breakpoint Actions Continued Action Behavior Command Executes a Simulator command at breakpoint Device execution commands such as trace or go will not execute Increment n Increments the counter n variable by one 10 If the action specified executes a command under Command type the Simulator command For example a common command to perform in conjunction with a breakpoint is E
207. ripheral or for separate devices when debugging on systems with multiple DSPs winn Optional Window number The window number is an arbitrarily assigned number used to keep track of multiple register windows If no window number is specified when opening a new window the Simulator will automatically assign the next available number periph OFF Optional The periph parameter is the name of a peripheral and indicates that only the registers of that particular peripheral should be displayed If no peripheral name is specified the Simulator will display the core registers The OFF parameter closes the register window If no window number winn is specified when closing a window all register windows will be closed Table 12 53 WREGISTER Commands Command Resulting Simulator Action wregister Opens a register window for the current device wregister win3 host Opens a register window with a window number of 3 and displays only the registers associated with the host peripheral for the current device wregister off Closes all register windows for the current device 12 54 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc wsource GUI Source window 12 52 wsession GUI Session window WSESSION OFF The wsession command opens a Session window Only one Session window may be open at a time The curre
208. rmation contained in a COFF format object file cld file only if the file was compiled or assembled with debugging enabled In the Motorola DSP Assembler this is represented by the g option If symbol information has been loaded the evaluator will accept symbol names or source file line numbers and translate them into an associated memory address 3 Under Filename specify the filename of the object file to load or click on the File button to browse for the file 4 Click OK If the cld file is not found in the selected directory the Simulator will try to load the file from the working directory If the file does not exist in the working directory the Simulator will try to load the file from the alternate directories An error message is displayed if the file is not found in any of these directories To load an OMF lod file 1 From the File menu choose Load then select Memory OMF 2 Specify the filename in the dialog box It is not necessary to type the extension with the filename The Simulator assumes the lod extension 3 Click Open Keep in mind that the object file is loaded into the memory of the current device If you want to load the file into another device you must first select that device as the default device Chapter 6 Simulator and Device Configurations provides more details and Chapter 12 Command Reference provides a full command description 1 7 Setting Up the Display Environment The Simulator di
209. rola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc wwatch GUI Watch window Table 12 57 WWATCH commands Command Resulting Simulator Action wwatch ro Opens a watch window for the current device with the register rO displayed If the window already exists adds rO to the list of watched items wwatch x 100 Opens a watch window for the current device with the memory location x 100 displayed If the window already exists adds x 100 to the list of watched items wwatch r2 3 Opens a watch window for the current device with the expression r2 3 displayed If the window already exists adds r2 3 to the list of watched items wwatch win2 ro Opens a watch window for the current device with a window number of 2 with the register rO displayed If the window already exists adds rO to the list of watched items wwatch off Closes all watch windows for the current device wwatch win3 off Closes watch window 3 for the current device wwatch 2 off Removes watch element 2 from first watch window s list of watched elements wwatch win4 Q02 off Removes watch element 2 from watch window 4 s list of watched elements Motorola Command Reference 12 57 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc wwatch GUI Watch window 12 58 Suite56 DSP Simulator User s Manual Motorola For More Informa
210. rom within the Simulator are not logged to the Session window for review 7C continue immediately Optional The C parameter causes control to return to the Simulator after the operating system command is completed without prompting you This may be useful in macro commands allowing system commands to be used without requiring operator intervention If the C parameter is not specified before control returns to the Simulator you are prompted to Hit return to continue This allows you to inspect the command output before it is destroyed system command parameter list Optional Ifa System command is included in the system command the specified system command is executed including any parameters specified in the parameter list If the command line does not contain a system command then a mode is entered in which multiple system commands may be entered Return to the Simulator occurs when you enter exit on the operating system command line Table 12 36 SYSTEM Commands Command Resulting Simulator Action system dir Executes the system dir command and immediately returns to the Simulator System dir io Executes the system dir io command system dir io del he io exit Leaves the Simulator temporarily Executes the system dir io and del he io commands Returns to the Simulator when the system exit command is executed system c del e temp lod Deletes the specified temporary
211. rreg int devn 13 14 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points int periph_num reg_num unsigned long regval dsp startup devn 0 dsp new devn 56116 Allocate structure for device 0 a 56116 if dsp findreg devn ec amp periph_num amp reg_num dsp_rreg devn periph num reg num amp regval 13 2 20 dsp save Save All DSP Structures to State File int dsp save filename char filename Full name of State File to be saved This function saves a dsp device structure to a simulation state file This function does not invoke the user interface functions which provide pathname and sim suffix extension so the entire filename must be specified The function returns 1 if the save is successful O if an error occurs when saving the file This function will call the function dspl xmsave as one of the steps of saving the dsp structure See Example 13 20 Example 13 20 dsp save int ok dsp startup dsp new 0 56116 Allocate structure for device 0 a 56116 dsp new 1 56116 Allocate structure for device 1 a 56116 Save device 0 and 1 to state file lunchbrk sim ok dsp save lunchbrk sim 13 2 24 dsp startup Initialize DSP Structures int dsp startup This function initializ
212. ructions to execute 4 Select the checkbox labeled Halt at Breakpoints if you want to observe breakpoints If you do not select the checkbox the instruction will ignore breakpoints and will not halt program execution 5 Click OK Notice that the Simulator updates the values in the Register window the Memory window and all other windows after it executes the last line or instruction Alternatively you can use the Next button on the toolbar to execute the next instruction or line Section 10 5 Next Button on page 10 4 provides more advanced information Section 12 23 next Step Over Subroutine Calls or Macros on page 12 32 provides a complete command description 2 5 Providing an UNTIL Condition An UNTIL condition causes the Simulator to execute the currently loaded program until it encounters a specified location You can specify the location as a program line number an address or a label An UNTIL condition works essentially as a temporary breakpoint cleared when execution stops To provide an UNTIL condition 1 From the Execute menu choose Until 2 4 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Pausing Execution with WAIT Line Address Label Halt at Breakpoints Cancel Figure 2 3 Providing an Until Condition 2 Type the line address or label at which to stop execution You can only use line nu
213. s Product Go to www freescale com Freescale Semiconductor Inc Changing the Radix value is hexadecimal value is decimal value is binary The Simulator begins with the default radix set to decimal for input and hexadecimal for most output Changing the default input radix allows you to enter values without having to type the radix specifiers before each value To change the radix of input 1 From the Modify menu choose Radix then select Set Default The following dialog box appears Set Default Radix Ea Radix Decimal C Hexadecimal C Unsigned C Binary Cancel Figure 6 2 Set Default Radix Dialog Box Note that the current default radix is automatically selected 2 Under Radix select the number system to use This system will be the default for values that you provide when performing commands 3 Click OK 6 3 1 Changing the radix in which to display a register or memory locations 1 From the Modify menu choose Radix then select Set Display The following dialog box appears Motorola Simulator and Device Configurations 6 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Loading Simulator State Files Set Radix Ed Radix Registers Memory C Decimal Memory Space Hexadecimal p v C Fractional bi C Floating Pont Unsigned Start Address End Address Cancel Figure 6 3 Set Register or Memory Rad
214. s addr and reg are abbreviations The following is a list of abbreviations used for parameters on the command syntax line Table 12 2 Command Parameter Abbreviations Abbreviation Meaning addr An address may be specified as a source file line number or as a symbol name if a previously loaded COFF object file contains symbolic debug information Otherwise a memory space designator must be used Use the help mem Command from the command line of the Command window to obtain a list of the valid memory space prefixes addr_block addr location addrffcount bn Break number A decimal integer constant in the range 1 to 99 break action H halt In increment CNTn N note S show X command count Positive integer expression in range 1 to 7fffffff dev num Device number in the form DVn where n represents the number of the device Range is dvO to dv31 dev type Device type expression Any arithmetic expression valid for the DSP Assembler Register names can also be used in the expression Cc expression Any expression valid in the current C program A c expression must be enclosed in curly braces file Any valid filename including relative and absolute paths ioradix RD decimal RF float or fractional RH hexadecimal RU unsigned location Integer expression It will be mapped into the device address range For ex ample 1 translates to the maximum address mode Device
215. s ports retrieve new data from an assigned input file only once for each memory fetch The port data value can be represented in hexadecimal decimal binary or floating point The default input radix can be specified when assigning an input file the output radix can be specified when assigning an output file Floating point input can be expressed in the usual methods For example 9 25 5e 1 5 0E 1 are all acceptable data input values If a data value contains a decimal point the data will be input as a floating point value overriding the input radix specification The number base of data values can also be denoted by preceding the data value with a dollar sign an apostrophe or a percent sign input as hexadecimal input as decimal input as binary Timed port input data values are applied to the port at the specified relative time intervals t ime or at the exact Simulator cycle indicated by the timing information within the file 5 4 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Memory Data If a lower case letter t is placed in a data position of the input file you will be prompted for the next input data value as described below in Section 5 10 Terminal Input of Data Values Storage of data to a port output file will occur any time a write operation occurs to the port In the timed output mode the
216. s tang Rim ESI bq ag AED ERE S eer 12 48 12 44 WATCH commands e da Ss 12 49 12 45 WBREAKPOINT Commands 020 20 e eee eee 12 50 12 46 WCALIS Commands 2o s mee OER CER Ai 12 50 12 47 WCOMMAND Commands Lev ubaet3g exte ds 12 51 12 48 WHERE Commands 0455 act p ome ce ed ute See PSI 12 51 12 50 WEIST Commands Aser oy eese qs oS eh CU REIR SUN CRISI 12 52 12 49 WINPU T Commands iesene boo EQ E E PEE EE VES AR 12 52 12 51 WMEMORY Command z c A 12 53 X Suite56 DSP Simulator User s Manual Motorola 12 52 12 53 12 54 12 55 12 56 12 57 13 1 13 2 13 3 13 4 13 5 Motorola Freescale Semiconductor Inc WOUTPUT Command vito 12 54 WREGISTER Commands yr S ag E PEE EE EYES 12 54 WSESSION Commands uude ated dare De Re COCA US Dew 12 55 WSOURCE Conmmniatds oos 13 4 S epe Roe te Se us t eds 12 55 WSTACK Commands thats ne EE ete e tha th 12 56 WWATCH coimatdss 5525 Rr Ed e LU SI LEM A 12 57 Eirsher Level Functions 25 4 63 S RS ebbe a ds a a ts J 13 3 Interer Coles a te e Oi e 13 4 External Memory Functions 00 0 e eee ee eee eee 13 21 Screen Management Functions o ooo 13 27 Lower Level Structures amp Define Constants o oooo ooo o o 13 38 xi For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Xii Suite56 DSP Simulator User s Manual For More Information On This Product Go to www freescale com Motorola Freescale S
217. s the C stdout stream to the file output cio appending to the end of the file if it already exists redirect stdout output c Redirects the C stdout stream to the file output cio but doesnt redirect if the file already exists 12 29 reset Reset Device or State RESET S state D device mode The reset command can be used to reset the device registers D or the entire Simulator state S It can also be used to select the operating mode that the device will be set to in response to a simulated hardware reset sequence S state D device The S parameter indicates that the the entire Simulator state should be reset to the start up condition All breakpoints are cleared the memory is initialized and all logging and I O files are closed The D parameter indicates that the device should be reset to the start up condition All device registers are reset to the defined reset conditions mode Optional The mode parameter specifies the DSP operating mode in the form Mn nzdecimal digit To see the Operating Modes that are available for a particular device 1 At the command line type help mode 2 View the Session window It will contain a list of operating modes available to the particular device that you are simulating Table 12 32 RESET Commands Command Resulting Simulator Action reset d Resets all device registers to the defined reset conditions reset d m0 Resets the device registers and select
218. ser only needs to type the letter w for the command to be recognized The slash is used to separate a list of mutually exclusive choices The slash is not entered as a part of the command For example in the evaluate command the first parameter can be one and only one of the following B D F H or U Parentheses surround a description of an implied action This is included to help clarify some of the abbreviations used in the command syntax line Neither the parentheses nor the description within are entered as part of the command For example when entering the evaluate command the optional first parameter consists of one letter The words binary dec float hex and unsigned are only included in the command syntax line for clarity An ellipsis three consecutive periods indicates that a parameter can be repeated several times ina command line For example the display command can specify multiple registers or register blocks Square brackets indicate enclose command parameters that are optional The brackets themselves are not entered as a part of the command For example in the wait command the count parameter is optional 12 4 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Command Parameters List of Abbreviations 12 3 Command Parameters List of Abbreviations Many of the command parameters such a
219. splay 4 3 4 4 free 13 8 13 23 initialization 13 23 initialize 13 9 load 13 10 load from state file 13 23 read 13 12 resetting 2 7 save to state file 13 25 write 13 9 13 16 mnemonic 12 7 modify 4 3 memory 4 5 registers 4 3 Modify menu 6 3 Device 6 2 Motorola Radix 6 2 multiple dsp simulation device index 13 19 halting 13 28 interleaving execution 13 34 N Next 2 3 11 5 11 6 examples 12 32 next 12 32 Next Button 10 4 10 5 non display simulation executing device cycles 13 33 library file 13 31 loading program code 13 32 testing breakpoint conditions 13 33 numbering system 6 2 nwsim 13 31 nwxxxxx 13 31 O object code 1 6 3 3 11 5 12 16 object module loading 13 10 OMF 3 3 Output 5 11 5 12 5 13 11 7 12 33 P parameters 12 5 Path 3 1 12 35 examples 12 35 pause 2 7 peripheral 5 8 5 9 5 10 pins 5 10 preferences 6 4 Q QUIT Quit Simulator Session 12 36 R Radix 6 3 6 4 11 2 12 36 RADIX Change Input or Display Radix 12 36 Redirect 12 38 examples 12 39 REDIRECT Redirect stdin stdout stderr for C Programs 12 38 register 4 1 4 2 12 17 12 18 change values 12 13 program counter 13 33 read function 13 14 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc write function 13 18 registers 2 7 change values of 4 3 resetting 2 7 REPEAT Button 10 7 Reset 2 7 examples 12 39 RESET Button 10 8 RESET Reset Device or State 12 39 RTS 2
220. splays two windows when it first starts the Session window and the Command window You might need to scroll around to get both windows into view at the same time but the screen should look something like this Motorola Introduction amp Getting Started 1 7 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Setting Up the Display Environment Y Sim56300 A ES File Display Modify Execute Windows Help BHC MO 2 wsource wsession wasm wcommand Command wsource wsession asm break change copy device disassemble lt space gt more Figure 1 3 Setting Up the Display Environment When we talk about the display environment we are simply talking about the way you arrange the windows of the Simulator on your monitor There is no right or wrong way to set up the display environment However there are some windows that you will commonly want to have opened besides the Session and Command windows These include the Assembly window the Source window if a COFF file with debugging information is loaded awindow displaying register values awindow displaying memory values and perhaps aWATCH List If you are debugging a program written in C keep the Call Stack window open so that you can see the call stack Depending on the size and resolution of your monitor having all of these windows open at once will mean that there will be some overlapping Your own experience with
221. stop breakpoints will be ignored 1 14 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Starting the Execution of Instructions with GO 6 Under Break Number select the breakpoint where you want to stop execution To see where you have breakpoints set display the current breakpoints in the Breakpoint window 7 Under Count specify how many times the Simulator should encounter the breakpoint before stopping For example if you set the count to 3 the program execution will be stopped on the third time that the breakpoint is encountered The last instruction executed will be the breakpoint 8 When all conditions are set Click OK Execution begins Notice that during execution the status bar in the lower left corner of the Simulator window shows the number of the device where execution is taking place the PC program counter and the cycle count updated every 1 000 cycles As an alternative you can start program execution using the GO Button located on the toolbar Fore more details see Section 2 9 Resetting the Device on page 2 7 Section 12 15 go Execute DSP Program on page 12 22 provides a complete command description Motorola Introduction Getting Started 1 15 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Starting the Execution of Instructions with GO 1 16 Suite56
222. t Command String from Terminal sim gtcmd device index command string int device index DSP device index to be affected by command char conmmand string Pointer to return buffer for command line This function gets the next command string from the terminal in an interactive mode The command line editing command expansion and on line help functions are invoked by this terminal command input function The command string is fully checked for errors prior to returning The command string buffer should be at least 80 characters See Example 13 30 13 20 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator External Memory Functions Example 13 30 sim gtomd Get and execute Simulator commands for device 0 until a go type command is entered include simcom h include simusr h extern struct sim const sv_const Simulator device structures char command_string 80 int devn dsp startup devn 0 dsp_new devn 56116 Create new dsp structure while sv_const sv devn gt stat executing Check for go sim gtcmd devn command string Get command sim docmd devn command string Execute command 13 3 Simulator External Memory Functions The following sections describe functions which are provided in source code form in the Simulator
223. t the register whose value you want to change 3 Under Value type in the value to which you want the register to be set 4 Click OK Section 12 6 change Change Register or Memory Value on page 12 13 provides a complete command description 4 3 Displaying Memory Values You can display the values in memory any time instruction execution is halted To display the value in memory 1 From the Windows menu choose Memory The following dialog box appears Motorola Managing Memory and Registers 4 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Displaying Memory Values Open Memory Window x p 0 0 ffffff pe pi or pr depending upon address and omr M Cancel Apply Figure 4 4 DSP Simulator Memory Dialog Box 2 From the drop down list box select the memory space whose values you want to change 3 Click OK The memory values for the memory space you choose appear in a memory window For example if you display values in the p memory space you see a window similar to the following type in address you device number memory space want displayed first value of this row Dv00 Memory Wini p roll To ddress this column displays the address of the p 000000 0014a0 0001 e0 SEO SO 000033 j first value of this row p 000005 0000ff 000255 16776961 0000255 0000255 Bl p 00000a 000000 000000 000000 000000 000000
224. take the place of the start and stop location in the specification of an address range An expression comprises a combination of symbols constants operators and parentheses Expressions follow the conventional rules of algebra and boolean arithmetic Expressions may contain any combination of integers floating point numbers memory space symbols and register symbols 9 2 Evaluate Expressions You can evaluate DSP assembler expressions and C expressions and write the result to the session window To evaluate an expression 1 From the Evaluate menu choose Evaluate The following dialog box appears Evaluate Expression x Radix Expression C Binary Do C Decimal Fractional Floating Point C Hexadecimal Unsigned All Cancel Apply Figure 9 1 Evaluating an Expression Motorola Expressions 9 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Using Memory Space Symbols 2 Under Expression type the expression that you want to evaluate If the expression is a C expression enclose it in curly braces c_expression 3 Under Radix select the radix in which to display the result of the expression C expressions display the type of the expression and the value in normal format for the expression type if All is selected Selecting All when evaluating a DSP assembler expression displays select radices depending on the expression itself 4 Click OK The Sess
225. te structure for device 0 a 56116 ok dsp findreg devn pc amp pnum amp regnum Get index for pc register 13 2 8 dsp free Free a Device Structure dsp free device index int device index DSP device index to be affected by command This function frees all allocated memory associated with a device structure and closes any open files associated with the device structure See Example 13 8 Example 13 8 dsp free Create three new device structures then get rid of device 2 dsp startup dsp new 0 56116 Allocate structure for device 0 a 56116 dsp new 1 56116 Allocate structure for device 1 a 56116 dsp new 2 56116 Allocate structure for device 2 a 56116 dsp free 1 Free structure previously allocated for device 1 13 8 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points 13 2 9 dsp_fmem Fill Memory Block with a Value dsp_fmem device index memory map address block_size value int device index DSP device index to be affected by command enum memory map memory map memory designator unsigned long address DSP memory start address to write unsigned long block size Number of locations to write
226. tep Until Address 12 46 Up 7 2 UP Move Up the C Function Call Stack 12 47 Using the Tool Bar 10 1 c V VIEW Select Display Mode 12 47 WwW Wait 12 48 WASM 12 48 Watch 9 8 9 9 examples 12 49 WATCH Set 12 49 Modify View Suite56 DSP Simulator Users Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc or Clear Watch item 12 49 WBREAKPOINT GUI Breakpoint Window 12 50 WCALLS GUI C Calls Stack window 12 50 WCOMMAND GUI Command window 12 51 WHERE GUI C Calls Stack window 12 51 windows 6 6 11 2 11 5 WINPUT GUI File Input window 12 52 WLIST GUI list window 12 52 working directory 3 1 3 2 WREGISTER GUI Register window 12 54 WSESSION GUI Session window 12 55 WSOURCE GUI Source window 12 55 WSTACK GUI Stack window 7 2 12 56 wwatch examples 12 57 WWATCH GUI Watch window 12 56 wwsim 13 31 WWXXXxx 13 31 Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Motorola Suite56 DSP Simulator User s Manual For More Information On This Product Go to www freescale com vi
227. ter Table 12 19 HELP Syntax Command Resulting Simulator Action help Displays a summary of all available commands and their parameters help asm Displays a summary of the assemble command and its parameters help omr Displays the contents of the DSP s Operating Mode Register The topic keywords in Table 12 20 provide online help for the described topics Table 12 20 List of Help Topic Keywords Keyword Help Topic io list of on chip io registers and their addresses int list of interrupt vector addresses for the device periph list of peripheral names pin list of pin names and numbers and the current pin states port list of port names mode initial chip operating mode summary map memory map descriptions for various omr settings mem memory names with block addresses sym display program symbol table names and values reg display register size register and peripheral index stack display of values on the device stack Motorola Command Reference For More Information On This Product Go to www freescale com 12 23 Freescale Semiconductor Inc history Disassemble Previously Executed Instruction 12 17 history Disassemble Previously Executed Instruction HISTORY The history command disassembles and displays the previous 32 instructions executed by the device The instructions are displayed in the order that they were executed with the most recent ins
228. ter acts as the index to the dev var xportval array A list of port names and the corresponding port index can be obtained using the Simulator s help port and help periph commands The port index can also be determined by using the port name as a key when calling dsp findport See Example 13 18 Example 13 18 dsp rport int devn int portnum unsigned long portbdata portbforce unsigned long portmask dsp startup devn 0 dsp new devn 56116 Allocate structure for device 0 a 56116 dsp findport devn portb amp portnum amp portmask dsp rport devn portnum amp portbdata amp portbforce 13 2 19 dsp rreg Read a DSP Device Register dsp rreg device index periph num reg num reg val int device index DSP device index to be affected by command int periph num DSP peripheral number int reg num DSP register number unsigned long reg val Return register value goes here This function reads a selected register from the regval array in a DSP dev periph structure Registers which return more than one word as the register value will return the least significant word in reg val 0 Use the Simulator help reg command to obtain a list of the valid periph_numand reg num values and reg val size for each register Also dsp findreg can be used to obtain the peripheral and register number by using the register name as a key See Example 13 19 Example 13 19 dsp
229. text box type the address where you want to begin to disassemble 4 In the End Address text box type the address where you want to stop disassembling 5 Click OK 6 View the Session window to see the mnemonics of the memory block you specified Section 12 9 disassemble Object Code Disassembler on page 12 16 and Section 12 27 radix Change Input or Display Radix provide complete command descriptions Motorola Managing Memory and Registers 4 7 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Displaying a History of Recent Instructions 4 7 Displaying a History of Recent Instructions You can disassemble and display a history of the most recent instructions executed by the device A typical use for displaying the history would be to determine the sequence of instructions that terminated in a user defined breakpoint You would set the breakpoint conditions then issue the GO command When the break condition is met instruction execution halts and the currently enabled registers appear You can then display the history to view the last 32 instructions that executed prior to the breakpoint To display a history 1 From the Display menu choose History 2 View the Session window to see the last 32 instructions executed by the device The instructions appear in the order executed with the most recent instruction appearing at the bottom of the list The last instruction in
230. than one cycle Timed peripheral input data values will be applied to the peripheral at the time intervals or at the exact Simulator cycles indicated by the timing information within the file If the Motorola Device I O and Peripheral Simulation 5 3 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Port Data first timing information in the file is a relative value timing preceded by the Simulator will wait until the peripheral function is enabled before applying the data If a lower case letter t is placed in a data position of the input file you will be prompted for the next input data value as described below in Section 5 10 Terminal Input of Data Values Storage of data to the peripheral output file will begin when the peripheral is enabled In the timed output mode the Simulator cycle count and a data value are stored each time the peripheral output changes In the untimed output mode a data value and a following repeat count are stored each time the data changes 5 7 Port Data When assigned to a DSP port the input file data value represents the value applied to all the pins of the port The least significant port bit maps to the least significant bit of the data value The following general information applies to all port files A port is simply a convenient grouping of device pins Untimed data applied to a port is retrieved each clock cycle with one exception the data bu
231. that may be changed in the new file Table 13 5 Lower Level Structures amp Define Constants Function Description DSP PI SIZE 116 This define constant determines the size of the on chip program memory DSP PR SIZE 116 This define constant determines the size of the on chip bootstrap rom memory DSP XI SIZE 116 This define constant determines the size of the on chip X data memory DSP XP SIZE 116 This define constant determines the size of the on chip X memory mapped peripheral register space dx periph 56116 This structure can be modified to add peripherals to or remove peripherals from the newly defined device If you modify this structure you must also modify the SX periph 56116 structure in a similar manner The file portb100 cis provided in source form with the simulator package as a model to be used when creating new peripheral structures bootrom This is the default initialization data for the on chip bootstrap rom It is loaded at start up and in response to the reset s command You can also change the contents of the bootstrap rom with the simulator asm load and change commands xpin This structure determines the names assigned to device pins as well as the order in which the pins are displayed in output pin lists It also provides a cross reference from the pin name to the physical bit and storage port in which the simulator maintains the pin data The portindex
232. the list has been fetched and decoded by the device and enters the execute phase in the next device cycle It is in the same state as instructions that are disassembled and displayed at the end of each trace display The device execution history can also be logged continuously to an output file using the Simulator output command The device execution history can also be logged continuously to a file by assigning an output file When you assign the output file choose to output from extended history Remember to close the file before viewing its contents Section 5 12 Assigning an Output File on page 5 11provides more detailed information Section 12 17 history Disassemble Previously Executed Instruction on page 12 24 provides a complete command description 4 8 Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 5 Device I O and Peripheral Simulation 5 1 Introduction to Device I O Input Output The Suite 56 DSP Simulator provides you with the ability to simulate the data input and output If you were actually debugging a DSP device you would need several pieces of hardware The hardware includes an actual device and peripheral devices that supply input to the DSP device and recognize output from the DSP device In the Simulator environment of course you are not debugging an actual device which means that there is no communica
233. the memory name as a key Use the Simulator help mem command 13 16 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points for a list of valid memory names The memory_map enum is memory_map_ concatenated with a valid memory name As an example memory map pa refers to off chip pa memory on the 96002 device If the selected memory map requires two word values the least significant word should be at the value location and the most significant word at the value 1 location If the memory address selects an external memory location the dspl xmwr function will be called The dspl xmwr function is provided in source form in the file simvmem c and can be modified to simulate special external memory characteristics See Example 13 24 Example 13 24 dsp wmem int devn unsigned long address memval address 2001 memval O0L dsp startup devn 0 dsp_new devn 56116 Allocate structure for device 0 a 56116 dsp wmem devn memory_map_p address amp memval 13 2 25 dsp wpin Write DSP Pin State int dsp wpin device_index pin value int device_index DSP device index to be affected by command int pin Pin number to write int value Input value for specified pin This function writes a selected dsp device pin with a value DSP_PINVAL_L DSP_PINVAL_H DSP PIN
234. thee coke thaw a AM e era M aut 13 19 13 28 O AY oC vade A e 13 19 Motorola XV For More Information On This Product Go to www freescale com Freescale Semiconductor Inc 13 29 sim emeMd sr RR 13 20 13 30 A e p b e do e ear E 13 21 13 31 dsp AOC A ERA AS apna tee aid 6 eli NES OR 13 22 13 32 dspl Semftee oaa S ere A qr os amies scs 13 23 13 33 aspas e ta il ed LUE 13 23 13 34 espl xmloagd uses weed EU AE ASE 13 24 13 35 dSplUXIMNEW s sas IRURE dun dere b aS eth ets 13 24 13 36 A A Colb doe pde ed abu Ho ecu A cele esa 13 25 13 37 ESI INSANE o ono ee bsc rtu Ria d ee og I and itunes 13 25 13 38 CLS OU EHE CU au Asse Moet besde Sce Anat het ded ies de E o Maat Ae eM E Gale Ee Mie ot 13 26 13 39 Code to Create New DeyIGe uu dopo Ux ONE ea eee e 13 32 xvi Suite56 DSP Simulator User s Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 1 Introduction amp Getting Started 1 1 Introduction to Motorola s Suite56 DSP Simulator The DSP Simulator is a software tool for developing programs and algorithms for Motorola Digital Signal Processors DSPs The DSP Simulator duplicates the functions of supported Motorola DSP chips all on chip peripheral operations all memory and register updates associated with program code execution allexception processing activity The Simulator also simulates the device s pipelined bus activity enabling the Simulator to prov
235. ther Simulator windows are updated each time you click on Next Section 12 23 next Step Over Subroutine Calls or Macros on page 12 32 provides a complete command description 10 6 Finish Button The Finish button allows the current function to execute to completion yu Breal 2 p QQQ1QE h deucb pr Q1QE cyc 244 x SHHHHHHHMHHHHM y HHHHHHHHHHHH a 9qqQqqQQqQbbbbbb b QQbbbbbbbbbbQd xIeSMHMHHM xH SHHHHHH r 9 S HHHHHH 15H giefHHHHHH yHeSHHHHHH nh m S HHHHHH utm 5H a2 ag at bbbbbb 39 agqgad r5 jbbbbQQ n5 a i he SHH WI SHHHHMH NHe HHHHHH A MAA tim ra jbbbbQO Sus Figure 10 5 Finish Button When stepping through a program it is possible that execution will stop in the middle of a function or subroutine Clicking on the Finish button completes the execution of the function or subroutine The Simulator continues until encountering an RTS instruction If another function is encountered during a finish operation execution continues to the end of the current function Section 2 7 Allowing the Current Function to FINISH after an UNTIL Condition or a Breakpoint on page 2 6 provides more information Section 12 13 finish Execute Motorola Simulator Tool Bar 10 5 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Device Button Until End of Current Subroutine on page 12 21 provides a complete command description 10 7 Device Button
236. tion On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 13 C Library Functions The SIMDSP Simulator package includes several object code libraries of Simulator functions that were used to create the Simulator The libraries allow the user to build his own customized Simulator and integrate it with your unique project The Simulator package includes the source code for many of the Simulator functions including the code that defines the dsp external memory accesses the code for the main entry point the code for the terminal I O functions and example code for a non display version of the Simulator The source code can be modified to create a Simulator customized for a particular application Object libraries are supplied which support display or non display versions of the Simulator The user may choose to eliminate the user interface functions altogether and control the simulation directly through lower level function calls The rest of this chapter covers these aspects plus the following aspects of the specification and use of the libraries Section 13 2 Simulator Object Library Entry Points lists each Simulator entry point that is available to you the user e Section 13 3 Simulator External Memory Functions provides a description of the external memory access functions Section 13 4 Simulator Screen Management Functions provides a description of the terminal I O functions Section 1
237. tion with peripherals ports or pins Instead the Simulator provides simulated input and output by using I O files These I O files communicate with the Simulator as if the input and output were coming from an actual peripheral port pin or memory location You can specify whether the input data is to come from a file or from the keyboard terminal The Simulator simulates DSP on chip peripherals on a cycle by cycle basis 5 2 How Are I O Files Formatted Simulated input and output is represented in ASCII format which means that you can conveniently edit and print I O files from a text editor An input file or output file can contain repeat punctuation comments e timing information e peripheral data e port data pin data memory data Motorola Device I O and Peripheral Simulation 5 1 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Repeat Punctuation 5 3 Repeat Punctuation The Simulator provides a way to specify repeated input or output data values and sequences A single data value can be repeated by adding the following syntax after a data item count Enclosing several data items in parentheses indicates that the data items are to be treated as a group The entire group can then be repeated by placing count immediately following the closing parenthesis The parentheses can be nested A closing parenthesis without a following repeat count causes the dat
238. to be affected by command int periph num DSP peripheral number int reg num DSP register number unsigned long reg val Value to be written to register cT CT This function writes a selected register in the a dsp structure Use the Simulator help reg command to obtain a list of the valid periph_numand reg_num values and reg_val size for each register Also the function dsp_findreg can be used to obtain the peripheral and register number by using the register name as a key 13 18 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator Object Library Entry Points If a register requires more than one word to represent the data value the least significant word should be at reg val with more significant words at reg _val 1 etc See Example 13 27 Example 13 27 dsp wreg int devn int periph_num reg_num unsigned long regval dsp startup devn 0 dsp_new devn 56116 Allocate structure for device 0 a 56116 regval 100L if dsp findreg devn pc amp periph num amp reg_num dsp wreg devn periph num reg num amp regval 13 2 28 sim docmd Execute Simulator User Interface Command sim docmd device index command string int device index DSP device index to be affected by command char command string User interface command to be executed This function e
239. to memory If no assembler mnemonic is specified on the command line an interactive mode of the asm command will be initiated Invoking the intereactive mode causes the object code at the beginning address to be disassembled and displayed on the screen You can then edit the instruction If the new instruction cannot be assembled correctly an error message is displayed on the error line of the command window and the cursor is placed at the point of error Pressing the ESC key causes the interactive asm command to terminate Table 12 3 asm Commands Command Resulting Simulator Action asm p 50 Starts the interactive assembler at address 50 hex in p memory asm x 0 move r0 rl Writes the instruction move r0 r1 to address 0 in the x memory space asm Starts the interactive assembler at the current program counter value asm lab d 5 Starts the interactive assembler at symbolic address lab_d 5 asm myfile asmQ7 Starts the interactive assembler at the address corresponding to myfile asm line 7 Motorola Command Reference 12 7 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc break Set Modify or Clear Breakpoint Table 12 3 asm Commands Command Resulting Simulator Action asm b y 040100 Performs byte wide assembly from address 40100 in the pr memory space Each byte of the instruction is stored in successive
240. to simulate your unique Motorola Device I O and Peripheral Simulation 5 9 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Assigning an Input File memory mapped peripherals or to short circuit the simulation of the on chip peripherals 7 Ifthe input data is being sent to a port under Port select the name of the port The list of available ports will vary depending on the device that you are targeting To see a list of port names and their index and mask type help port from the command line of the Command window 8 If the input data is being sent to a pin under Pin select the pin location If the input receiving pin is a single location as opposed to a range of pins select the name of the pin under Start If you want the input data to go to a range of pins select the names of the Start and End pins in the appropriate drop down box To see a list of pin names and their indices type help pin from the command line of the Command Window 9 Tf the input data is being sent to a register under Register select the register 10 If the input data is being sent to a peripheral under Peripheral select the name of the peripheral The list of available peripherals varies depending on the device that you are targeting To see a list of peripheral names with indices type help periph from the command line of the Command window 11 Under Radix select the input data s number system hexadecim
241. tor for visual examination of the registers and memory contents The following sections cover several topics that concern the non display version of the Simulator Section 13 5 1 deals with creating a new device Section 13 5 2 describes how to load a program or state file Section 13 5 3 describes how to execute device cycles Section 13 5 4 describes how to test breakpoint conditions 13 5 1 Creating a New Device The simcom h file defines the maximum number of DSP devices in the constant DSP MAXDEVICES A new device can be created and numbered from 0 to DSP MAXDEVICES 1 The structures are allocated by calls to the dsp_new function described in Section 13 2 13 dsp new Create New DSP Device Structure See Example 13 39 Motorola C Library Functions 13 31 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Non Display Simulator Example 13 39 Code to Create New Device The following C source code illustrates the steps necessary to create 3 DSP devices dsp startup dsp_new 0 56116 Allocate structure for device 0 a 56116 dsp_new 1 56116 Allocate structure for device 1 a 56116 dsp_new 2 56116 Allocate structure for device 2 a 56116 13 5 2 Loading Program Code or Device State The display version of the Simulator provides the high level sim_docmd funct
242. tput buffering operations for the Simulator The sim const scrnest variable is incremented each time this function is called 13 4 13 simw unnest Decrease Screen Buffering One Level simw unnest This function decrements the sim const scrnest variable each time it 1s called If the screen buffering level drops below one simw unnest will call simw refresh to update the screen 13 4 14 simw wvinit Initialize Window Parameters simw winit This function initializes any screen or keyboard parameters that are required for the Simulator terminal I O environment It is called whenever the Simulator is entered from the operating system level which includes the initial Simulator entry and re entry following the system command 13 4 15 simw wscr Write String and Perform Logging simw_wscr text command_flag char text Text string to write to screen int command_flag Flag l string is a command 0 not a command This function outputs the string to the terminal above the command line after scrolling the display up one line It also takes care of writing the text string to the proper log files specified by the Simulator log s or log c commands 13 30 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Non Display Simulator 13 5 Non Display Simulator The Simulator package contains object libraries which support both displ
243. tput in the multiple device environment Motorola C Library Functions 13 33 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Multiple Device Simulation 13 6 1 Allocation and Initialization of Multiple Devices Most of the higher level Simulator functions require a device index as one of the parameters The Simulator uses the device index to select a previously allocated DSP structure The DSP structures are allocated dynamically by calling the dsp_new function for each device The device type is also selected in the dsp_new function call In the display version of the Simulator the device command handles the details of calling dsp new The proper sequence of instructions necessary to allocate three DSP devices is shown below dsp startup dsp new 0 56116 Allocate structure for device 0 a 56116 dsp new 1 56116 Allocate structure for device 1 a 56116 dsp new 2 56116 Allocate structure for device 2 a 56116 13 6 2 Interleaving Multiple DSP Simulations The dsp exec function executes a single DSP clock cycle and updates the selected DSP device structure In order to simulate simultaneous multiple DSP execution dsp exec should be called for every device before proceeding to the next clock cycle The simdsp Simulator executes a single clock cycle for each active dsp device then halts if any acti
244. tring provided in the function call If a match is found dsp_findpin returns the pin number through the pin number parameter and 1 as the function return value otherwise it just returns O as the function return value See Example 13 5 Use the Simulator s help pin command to produce a list of the valid pin names Example 13 5 dsp findpin int devn int pinnum int ok dsp startup devn 0 dsp new devn 56116 Allocate structure for device 0 a 56116 ok dsp findpin devn reset amp pinnum Get index for reset pin Ct ct ct 13 2 6 dsp findport Get Port Number and Mask for Port Name dsp findport device index port name port number mask val int device index DSP device index to be affected by command char port name port or peripheral name int port number return memory map index unsigned long mask val Pin mask for this port or peripheral name This function searches the dt var xport structure and the dt var periph structures for a match to the port name string provided in the function call If a match is found dsp findport returns the port number through the port nuriber parameter the port mask value through the mask val parameter and 1 as the function return value otherwise it just returns 0 as the function return value The Simulator help port and help periph commands may also be used to produce a list of valid port and peripheral information
245. truction appearing at the bottom of the list The last instruction in the list has been fetched and decoded by the device and will enter the execute phase in the next device cycle It is in the same state as instructions that are disassembled and displayed at the end of each trace display A typical use for this command would be to determine the sequence of instructions that terminated in a user defined breakpoint You would set the breakpoint condition using the break command then issue the go command When the break condition is met instruction execution halts and the currently enabled registers are displayed You can then issue the history command to view the last 32 instructions that executed prior to the breakpoint The device execution history can also be logged continuously to an output file using the Simulator output command 12 18 input Assign Input File INPUT 4n T timed addr port periph pin group OFF TERM file RD RF RH RUJ INPUT 4n pin from DVn pin INPUT 4n addr from DVn addr The input command causes the retrieval of data from a source that you specify to a peripheral memory location or device pin The input data is in ASCII format Valid port peripheral and pin names for the device can be listed with the help port help periph and help pin commands There are three forms of the input command The first form allows input to a memory location port peripheral or pin from data provided either i
246. turn a 0 otherwise The operand must have an integer value Arithmetic operators addition subtraction multiplication division mod 5 Motorola Expressions 9 5 For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Operators in Expressions The divide operator applied to integer numbers produces a truncated integer result The mod operator applied to integers will yield the remainder from the division of the first expression by the second If the mod operator is used with floating point operands the mod operator will apply the following rules Y Z YifZ 0 XifZ lt gt 0 where X has the same sign as Y is less than Z and satisfies the relationship Y i Z X where i is an integer Bitwise operators binary AND amp Integer only inclusive OR 1 Integer only exclusive OR Integer only Bitwise operators cannot be applied to floating point operands Shift operators binary shift right gt gt Integer only shift left lt lt Integer only The shift right operator causes the left operand to be shifted to the right and zero filled by the number of bits specified by the right operand The shift left operator causes the left operand to be shifted to the left by the number of bits specified by the right operand The sign bit will be replicated Shift operators cannot be applied to floating point operands Relational operators less than great
247. turns a flag value of 1 if the memory location exists O if it doesn t exist The fetch parameter indicates to dsp1_xmrd whether or not the read is being executed by the dsp device If fetch 1 the dsp device is fetching the memory location during execution of a device cycle If fetch 0 dspl_xmrd is being called from some other source not associated with device cycle execution for example from the memory display routines Although the fetch parameter is not used in the version of dsp1_xmrd provided in the file simvmem c it is provided to enable special processing that should only occur when the device cycle simulation is taking place The memory map parameter will be a value representing the memory space being accessed Use the Simulator help mem command for a list of valid memory names The memory map enum is memory map concatenated with 13 24 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Simulator External Memory Functions a valid memory name As an example memory map pa refers to off chip pa memory on the 96002 device See Example 13 36 Example 13 36 dsp xmrd Read pe memory location 5000 of device 2 unsigned long address int devindex unsigned long retval int ok int fetch address 0x5000L devindex 2 fetch 0 ok dspl_xmrd devindex memory_map_pe address amp retval fetch 13 3 8 dspl
248. uction words are y 1000 40 constructed by taking one byte from each location thus depending on the target processor two or three locations are required to hold each instruction word 12 16 Suite56 DSP Simulator User s Manual For More Information On This Product Go to www freescale com Motorola Freescale Semiconductor Inc display Display Register or Memory 12 10 display Display Register or Memory D D ISPLAY V version ISPLAY ON OFF R W RW reg block group addr block The display command allows you to examine the contents of a specific register a register group or a memory block It can also be used to enable conditionally enable or disable the particular registers or memory locations that are displayd when a debug command such as step or trace is executed You can also display the Simulator version number Entering the display command with no parameters will display all enabled registers and memory blocks in the Session window The default radix for the display of most registers and memory locations is hexadecimal However you can specify the display radix of each register and memory location individually by using the radix command ON OFF R W RW Registers and memory locations can be enabled or disabled by entering the command with one of these keywords Table 12 12 DISPLAY Enable Keywords Enable Keyword Resulting Simulator Action ON Enab
249. urce window if applicable highlight the next instruction to be executed in red When program execution is stopped the Session window will display Simulation Aborted Notice that the Simulator updates the values in the Session window the Register window the Memory window and all other windows to reflect the last instruction or line executed Alternatively you can use the Stop button on the toolbar to stop program execution For more details about stopping program execution see Section 2 9 Resetting the Device and Section 10 8 Repeat Button on page 10 7 2 9 Resetting the Device You can reset the device or the entire Simulator state any time instruction execution is halted Resetting the device also allows you to select the operating mode that the device will be set to in response to a simulated hardware reset sequence To reset the device 1 Before you reset the device you will want to know which operating modes are available to the device that you are simulating To see the available operating modes open the Command window At the command line type help mode 2 View the Session window It now contains a list of the operating modes available for the device that you are simulating Now that you know the operating modes from which you can choose proceed in resetting the registers 3 From the Execute menu choose Reset then select Device The following dialog box appears Motorola Controlling Execution 2 7 For More
250. utput numbers in any way that helps you organize the outputs If no number is provided the Simulator will automatically assign the next available number T Optional When included with the output command this parameter indicates that the output data is in the form of time data pairs addr port periph pin group The source of the data Assignment to a memory address causes all subsequent writes of that memory address to store data in the output file Session window OFF TERM file The destination of the output data Providing the OFF parameter disables the output specified by n Providing the TERM parameter indicates that the output data will be typed to the Session window Providing a filename indicates that the output data will be written to file Ifa filename suffix is not specified the Simulator will assume 10 for a non timed output file and tio for a timed output file RD RF RH RU RS Optional The default output radix for the data may be specified by using RD for decimal RF for fractional RH for hexadecimal RU for unsigned or RS for character string The RF radix when specified for a single output pin will output the analog single precision floating point value associated with the pins analog function The RS radix is valid only for output memory locations It interprets values written to the specified memory location to be the address of a null terminated character string in the same mem
251. ve device has cleared its sim var stat executing flag It allows Simulator commands such as register or memory modifications on the viewed device until a command sets the executing flag again The device which causes a breakpoint becomes the viewed device by default but the viewed device can be changed with the device command without changing the status of any device A particular device can be halted by setting the CTRLBR flag in its sim var stat structure This has the same effect as typing CTRL C at the keyboard while a device is running It breaks device execution at the end of the current instruction Note that it is not mandatory to wait for the sim var stat executing flag to be set to begin device execution or to halt if the executing flag is clear These are just convenience features for the Simulator user interface Device cycle execution can be advanced in single cycle increments at any time by calling dsp exec 13 6 3 External Memory Definition The Simulator package contains the C source file simvmem c which contains all the external memory access functions used by the SIMDSP Simulator These functions are described in detail in Section 13 3 The functions as written will automatically simulate the entire external memory space of all DSP devices assuming that the operating system can allocate enough memory to store the device structures for the devices The user may wish to modify the simvmem c functions in order to define special ext
252. versions of the Simulator The prefixes st and dt_ are used for structure names of device type structures that is structures which must be defined for each device type The prefixes sim and dev are used for structure names of general device or simulation structures Global variable names may have a prefix dx dv sx or sv The prefix x is used for variables of dt structures The prefix dv is used for variables of dev structures The prefix sx is used for variables of st_ structures The prefix sv is used for variables of sev structures A list of Simulator global variables is included in the distribution file named global sym 13 9 Modification of Simulator Global Structures The source file simglob c which is included in the Simulator package contains the global structures sv const and dv const There are some useful modifications described below that can be made to the constant definitions at the beginning of simglob c The simglob c module must then be recompiled and relinked using the make file provided with the Simulator package In addition to these there may be device specific modifications that can be made to the Simulator DSP MAXDEVICES This define constant determines the maximum number of devices that can be allocated using the Simulator s device command As a default it is set to 32 13 36 Suite56 Simulator Reference Manual Motorola For More Information On This Product Go to www freescale com Freescale Semic
253. where personal injury or death may occur Should Buyer purchase or use Motorola products for any such unintended or unauthorized application Buyer shall indemnify and hold Motorola and its officers employees subsidiaries affiliates and distributors harmless against all claims costs damages and expenses and reasonable attorney fees arising out of directly or indirectly any claim of personal injury or death associated with such unintended or unauthorized use even if such claim alleges that Motorola was negligent regarding the design or manufacture of the part Motorola and 44 are registered trademarks of Motorola Inc Motorola Inc is an Equal Opportunity Affirmative Action Employer All other tradenames trademarks and registered trademarks are the property of their respective owners O Copyright Motorola Inc 1999 All rights reserved For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Table of Contents Chapter 1 Introduction amp Getting Started 1 1 Introduction to Motorola s Suite56 DSP Simulator 1 1 12 DSP Simulator Eogtites rs is a DP RS 1 2 13 Entre Commatids odo E X RR d DO RI e ebd edite 1 2 1 4 Getting Started with the DSP Simulator oooooccooccoonocooooomoo 1 3 KO oSet ng and Clearme the Pall surta atados 1 4 Lo Loading Object Files iocos oer e dy ies vali a S Re Fate s 1 6 1 7 Setting Up the Display Environment
254. xample 13 34 dspl xmload Call of dspl xmload from dsp load int status FILE fp fp fopen filename r Loading of other Simulator state structures status dspl xmload devn fp 13 3 6 dspl xmnew Create New External Memory Structure dspl xmnew device index int device index DSP device index to be affected by command This function must create and initialize the external memory for a device Note that this function should not be called directly by the user s code The dsp new function calls dspl xmnew as part of the process of creating a new dsp device structure See Example 13 35 Example 13 35 dspl xmnew Call to dspl xmnew from dsp new dspl xmnew devn 13 3 7 dspl xmrd Read DSP External Memory Location int dspl xmrd device index mem map address return value fetch int device index DSP device index to be affected by command enum memory map memory map memory designator unsigned long address DSP memory address to read unsigned long return value Memory value will be returned here int fetch Flag indicating that a dsp fetch is in progress This function must return the value of a dsp device s external memory location The Simulator calls dspl xmrd when a dsp device reads an external memory location or when the Simulator user interface reads the location for display purposes This function also re
255. xecutes any Simulator command that the Simulator normally accepts from the terminal SIMDSP normally calls sim gtcmd to get a valid command string from the terminal then calls sim_docmd to execute it The device index determines which dsp device in a multiple dsp simulation is affected by the command execution The devices are numbered 0 1 2 n 1 in an n device system so be very careful for example to use O for the device index parameter in a single device system If the command string begins macro execution the selected device structure in macro flag will be set by sim docmd SIMDSP retrieves valid commands from the macro file by calling sim gmcma as long as the in macro flag is set The commands are still executed by sim docmd whether they come from the terminal or a macro file Commands which initiate device cycle execution such as go or trace will set the device structure sim var stat executing flag SIMDSP executes device cycles until the executing flag is cleared by an execution breakpoint See Example 13 28 Example 13 28 sim docmd int devn dsp startup devn 0 dsp_new devn 56116 Allocate structure for device 0 a 56116 sim docmd devn change pc 40 Change device 0 pc register to 40 sim_docmd devn break r p 80 Set a breakpoint for device 0 sim docmd devn go Begin execution of device 0 Motorola C Library Functions 13 19 For More Information On
256. y EN eR Gates arida qs 10 2 T0 3 Stop BUM OM o uy S s NIA RS AAA AA DS R S 10 2 TOA Step BUT e e bas qe bea 10 3 103 Next Buttoni s oo ee Gee E EA S em ea ie s 10 4 OA id o AA A kw eal beet oce fea t de 10 5 LOC Device Buttoni arado 10 6 10 8 Repeat Button o atas io ORC Orte eed E daa is 10 7 10 9 Reset BUON A e ert e One te n e det ar CERES OE RECIBE E SM 10 8 Motorola M For More Information On This Product Go to www freescale com Freescale Semiconductor Inc Chapter 11 Displaying Information 11 1 Display the Current Breakpoints bic td 11 1 11 2 Displaying ihe RAE NS AS SE ote 11 2 IS Command Window iio A AAA 11 2 11 4 Session Window e Os o le e ose edis 11 4 IES Assembly WindOW ees ise a eese REN Rt ode ge AH TEUER ic 11 5 Ll SOURCE WINdOW s 3 eu sc Rae d RD pte eS RES eo noe ova A 11 6 LIT Stack Wind Wet nt eed Me s SR tb ea a ok Neon eite 6 11 7 Chapter 12 Command Reference 12 1 Command Overview JS Hey Eee evi d patus ar RS SEEN CV SC 12 1 12 2 Commands da Rt bed ab e Eua 12 4 12 3 Command Parameters List of Abbreviations o o ooooooocmooooo o 12 5 12 4 asm Single Line Interactive Assembler o ooo ooooomomoom o 12 7 12 5 break Set Modify or Clear Breakpoint 0 00 00 0 eee eee 12 8 12 6 change Change Register or Memory Value 004 12 13 12 7 copy Copy a Memory Blocks ios id 12 14 12 8 device Multiple Device Simulation 242 3454 aid

Suite56 DSP Simulator User`s Manual

Contents

Download Pdf Manuals

Related Search

Related Contents