Sound Programming Debugger`s User Manual
Contents
1. e Fill Corresponds to F command G Memory File File value File size Sound Programming Debugger User s Manual 33 e Compare Corresponds to MC command However the results are displayed in an information window Memory Compare Start address End address 200 e Move Corresponds to MM command Memory Move Start address 200 200 3400 ok D 34 oO 1G na Breakpoint Menu Breakpoint Window Software break Hardware break When selecting Software Break the following movable modal dialog box will be displayed The same operations as can be performed by the console commands B BE BC and BR can be performed Software Break TETE ETT Disable 000000 L Enable Breakpoint 0 Disable 000000 Disable 000000 Address 0 Disable 000000 Disable 000000 Command Code Disable 000000 Disable 000000 Bus Count FO 0 01 1 000000 Disable 000000 Break Count T Clear Disable 00000 Disable 000000 Disable 000000 Disable 000000 3 Disable 000000 1 2 3 4 a 5 7 3 J When selecting Hardware Break the following movable modal dialog box will be displayed The same operations as can be performed by the console commands HB HBE and HBC can be performed Sound Programming Debugger User s Manual 35 Hardware Break 0 Disable 1 Disable 000000 000000 Any Access 2 Disable OO0000 000000 Any Access Chann2. Console Console The bottom part of the window is the input area This is normal edited text so cut and paste can be used freely The result of execution of console commands is dis played in the area between the input area and the buttons at the top A backlog of results can be viewed by using the scroll bar If the backlog becomes too full the older information is lost Dump Wndow The contents of memory are displayed in this window There is a total of eight dump windows Word 6 000060 Start Address 00000060 Address 0 1 2 3 445 0123456 73S9RBCOEF 00000 z O46C n ya A ra nm 000070 0050 COdEC n n z 0050 46C n 000030 0 OdEC n 0000A 0050 O46C n 00060 0050 4 n dump start address can be input by clicking on Dump Address The display size can be selected in byte word or long word from the Dump Size menu Also by clicking on the dumped number in the window the memory can be edited e The dump window is not updated during execution of a user program Updating is performed when the user program is stopped by a break etc 38 Code Window The contents of reverse assembly are displayed in this window There are a total of eight code windows Code 4 000306 Code address 000306 RS reset start 000306 2700 SR 00030A 0000 CRAM w FT 000306 8 0 000310 000 AD 000316
3. If you should come across any incorrect or outdated information while reading through the attached document or come up with any questions or comments please let us know so that we can make the required changes in subsequent revisions Simply fill out all information below and return this form to the Developer Technical Support Manager at the address below Please make more copies of this form if more space is needed Thank you General Information Your Name Phone Document number ST 65 R1 031494 Date Document name Sound Programming Debugger User s Manual Corrections Questions comments Where to send your corrections 415 802 3963 Mail SEGA OF AMERICA Attn Manager Attn Manager Developer Technical Support Developer Technical Support 275 Shoreline Dr Ste 500 Redwood City CA 94065 REFERENCES In translating creating this document certain technical words and or phrases were interpreted with the assistance of the technical literature listed below 1 Dictionary of Science and Engineering 350 000 words 3rd Edition Inter Press Tokyo Japan 1990 2 Computer Dictionary Kyoritsu Publishing Co LTD Tokyo Japan 1978 3 IBM Dictionary of Computing McGraw Hill Inc New York New York 1994 CONTENTS Introduction 1 0 Setup Operating Environment Setup Installation Starting Up SSBug 2 0 Defintions Constants Variables Unary Operators Binary Operators Symbols Wild Cards Registers Functions
4. Sound Programming Debugger User s Manual 27 1 When Download is selected the following dialog for selecting a file is dis played 55Bug Folder Macintosh HD me k h mcomp c memory c menubar c mfill c misclib c Mmmove c msearch c 2 When a file is selected the following dialog for specifying the format or offset address is displayed Download File SCSPTOOL S28 download Format Motorola S file bd Offset Address T 3 The format is setin a menu and the offset address is set by inputting a formula 28 Upload Is equivalent to the console commands W WB WM and WS All file save operations for user programs symbols macros and batches can be performed from this menu 1 When Upload is selected the following dialog for specifying the file to be saved is displayed Format Binary File 2 The format is set in amenu and the offset address is set by inputting a formula The new line designation is only valid when the output is text The following dialog for inputting a file name is displayed next ga Desktop Macintosh HD 2 Macintosh HD D CORRE min box or TALA nr save binary file as untitled Sound Programming Debugger User s Manual 29 Verify Verify is equivalent to the console commands V and VB Operation is similar to download but the result of verify is displayed in an information window like that below 00002004 00002003 00002006 0000
5. 000202 Read 0468 subi 136 0000 FODSOCAD 2 Q FFFE Write 0200 2 Hrite 2000 4 Write 0000 000010 Read 0020 000012 Read 0 4 004 Read 136 4 Read 0000 004 0 Read 0080 004 2 Read 5 ori w 4 CAB 004 4 Read 4 800056 Write OO 000200 Read 4E73 rts In this example from 4084 to 4072 becomes the extra debugger operation that is recorded In the interval between 4072 and 4071 the debugger code is executed but is not recorded Also there is a command prefetch that was not executed at 4083 therefore the disassembly display from 4077 is shifted File Operation A working directory is introduced as a concept to operate files via console com mands The working directory is similar to the current directory in MS DOS etc and settings are changed by selecting Working Directory from the file menu The file used by console commands include e the file when the full path name is specified e the path specification in relation to the working directory when a partial path name is specified For example if the working directory is Macintosh HD Development SSBug Folder then the command r main s28 would download the file Macintosh HD Development SSBug Folder main s28 SSBug only handles the data forks of files and all files handled including binary data are TEXT PWD Format PWD Explanation Displays the cur
6. 3FFF 07 00031A 1 D A n 1C nv 000003 1A 000320 00C00000 UDPDRT Ad 000326 4 00 00004 AS 00032 400000784 ini UDP 000330 O00007E4 joyini t 000334 0000033E ini _URAM 000336 2000 MAP SR 00033A 0000048C main init URAM OO033E Sb F Z CAS The reverse assembly start address can be input by clicking on Code Address Also line assembly can be performed by clicking on the reverse assembly display in the window e The dump window is not updated during execution of a user program Updating is performed when the user program is stopped by a break etc Sound Programming Debugger User s Manual 39 Bus Trace Window Bus trace results are displayed in this window Bus Trace F w Data Code 0062 Read 46FC 500056 Write 002004 Read 2028 movea 040 0 AO 002006 Read 0400 002008 Read 2068 movea l 2 000400 Read 0000 000402 Read 0420 00200A Read 00200 Read AG Ae 000430 Read 000432 Read 00200E Read 00142 02 Ar 002010 Read 0020 12 Read 000434 Read 000426 Read 0020 14 Read Write 2012 FFFFFE Read 0010 level interrupt acknowl edge The bus cycles are distinguished as explained below when displaying on a color display Black Bus cycle for the MC68EC000 Red Bus cycle in which the EXT signal is asserted Green Bus cycle in which control is completely passed to the debugger Blue B
7. may result from applications based on the examples describe herein It is possible that this document may contain reference to or information about SEGA products development hardware software or services that are not provided in countries other than Japan Such references information must not be construed to mean that SEGA intends to provide such SEGA products or services in countries other than Japan Any reference of a SEGA licensed prod uct program in this document is not intended to state or simply that you can use only SEGA s licensed products programs Any functionally equivalent hardvvare softvvare can be used instead SEGA will not be held responsible for any damage to the user that may result from accidents or any other reasons during operation of the user s equipment or programs according to this document NOTE A reader s comment correction form is provided vvith this document Please address comments to SEGA of America Inc Developer Technical Support att Evelyn Merritt 150 Shoreline Drive Redvvood City CA 94065 SEGA may use or distribute whatever information you supply in any way it believes appropriate vvithout incurring any obligation to you 6 27 95 002 SEGA SEGA OF AMERICA INC Consumer Products Division Sound Programming Debugger User s Manual Rev 0 93 Doc ST 65 R1 031494 1994 SEGA All Rights Reserved READER CORRECTION COMMENT SHEET Keep us updated
8. or hex files However the EOF character used in CP M or MS DOS is not supported 44 Symbol Files The SDSS symbol format is defined as follows in SSBug lt WS gt lt symbol value hex gt lt WS gt lt symbol name gt lt WS gt an arbitrary number of repeat new character However lt WS gt an arbitrary number of white spaces new line character CR or CR LE Therefore by selecting the SDSS format the following symbol files can also be used e Iwasaki Giken s IR80 or other CP M class symbol files Computex company s ID68000 symbol files Restrictions with Respect to Saturn The TAS command cannot be used with the Saturn and development board MC68EC000 Also external devices cannot be reset with the RESET command Sound Programming Debugger User s Manual 45
9. the setting The pass count for the hardware break is initialized each time user execution is started is specified in Access break sets whether or not read or write is allowed per every 4 Kbytes with respect to the entire CPU area and detects pass cycles in violation of these settings via external hardware monitoring As with hardware breaks be careful that the pass cycles are terminated when a break is generated MAP Format Explanation MAP Format Explanation 18 MAP Displays a list of access break settings MAPrange acc Sets the access break condition acc in the address range range acc specifies one of the following character strings RW read write is enabled RO read only break is generated with write access NO read is disabled break is generated with a selected access If the range does not have 4 Kbyte boundaries then it is rounded up e In normal use also set the following areas as read write areas in addition to the area used by the user program 600000 67FFFF ROM mounted area 800000 82BFFF emulator mounted area A00000 AOOFFF MB89352A mounted area E00000 E07FFF debugger area F00000 FFFFFF area used by sound tool only when sound tools exists together e These settings are written in the accompanying startup file SSBug Startup Please use them as reference Bus Trace Bus trace records the bus cycles using external hardware The sound board can record up to 8192 bus cyc
10. trademark of Microsoft Corp CP Mis aregistered trademark of Digital Research Model names chip names etc are generally makers brand names Sound Programming Debugger User s Manual 3 1 0 Setup Operating Environment The following configuration is required to run SSBug e Apple Macintosh computer with a SCSI interface and KanjiTalk 7 or System 7 or later e Saturn development system can be used with sound board alone SSBug distinguishes whether it is running under KanjiTalk 7 or any other Japanese environment or more correctly an environment in which a Japanese script is operat ing It displays Japanese when it is possible to use Japanese and English when Japanese cannot be displayed thus making it fully functional when running on an English system Setup Refer to the Sound Development Manual regarding connection to a Macintosh When only SSBug is used connection can be made only via the SCSI port Also since SSBug automatically distinguishes the SCSI ID of the sound board no settings are required with respect to SSBug side SCSI Installation SSBug is supplied in the following four files SSBug Target Code ahs SSEug Startup Descriptions of the files are given below SSBug the debugger program for the Macintosh SSBug Target Code debugger program for sound board SSBug Startup sample startup file described below SSBug ReadMe latest information regarding SSBug To install take t
11. 0 005002 00800082 s systemStack 4000 Memory Edit 12 UV Enter or to terminate interactive editing Return to the previous address by entering or By entering a space advance to the next address without making any changes to the contents of the current address MS MSB MSWMSL Format MSrange expr MSBrange expr MSWrange expr MSLrange expr Explanation Searches for the data expr in the address range range The MSB MSW and MSL commands specify byte word and long word search respectively and change the default search size to byte word and long word The MS command is executed in the default search size MM Format MMrange expr Explanation Copies the contents of the address range range to after address expr e Since the MM command transfers the contents of the memory on the target board to the host and performs a replacement operation at the host operation slows down if the transfer origin and the transfer destination overlap Mc Format MCrange expr Explanation Compares the contents of the address range range with the contents after address expr Sound Programming Debugger User s Manual 13 Assemble A 14 Format Alexpr Explanation Performs line assemble from address expr The mnemonic and addressing mode notation used follows that used by Motorola but please note that constant notation and overflow in expres sion evaluation are ignored When
12. 2007 n z kR 0000200 00002011 0000201 00002010 00002020 If there are tool many results then the older information is lost from the window Working Directory When you select Working Directory the following dialog will appear Please select using the button at the bottom of the dialog box Working directory setting Sound Tools Macintosh H O Alchemy v2 6 O Cubase 2 5 O DECK2 O Digital Performers 1 4 Folder O Encore O Encore J O Galaxy Plus Editors LOGIC Audio Select LOGIC Audio Close Closes the front active window Quit Quits SSBug 30 4 Edit Menu The Edit menu is used primarily to cut and paste text in accordance with the stan dard Macintosh interface File CPU Control Memory Cut Copy Paste Clear Select All Show Clipboard e Undo is not supported CPU Control Menu This menu is used to control execution of user programs Edit ASK Memory Breakpoint 0 Stop 38 Ei Trace execution ST Step execution 5 Execute up to selected position 38H SCSP interrupt controller Except for SCSP Interrupt Controller the following commands correspond to the console commands as shown below Run G Stop STOP Trace T Step S Run to Specified Point C expr Reset RESET Sound Programming Debugger User s Manual 31 The following dialog for specifying an address is displayed for Run to Specified Point Execute up to
13. General Notice When using this document keep the following in mind 1 This document is confidential By accepting this document you acknowledge that you are bound by the terms set forth in the non disclosure and confidentiality agreement signed separately and in the possession of SEGA If you have not signed such a non disclosure agreement please contact SEGA immediately and return this document to SEGA This document may include technical inaccuracies or typographicalerrors Changes are periodi cally made to the information herein these changes will be incorporated in new versions of the document SEGA may make improvements and or changes in the product s and or the program s described in this document at any time No one is permitted to reproduce or duplicate in any form the whole or part of this document without SEGA S written permission Request for copies of this document and for technical information about SEGA products must be made to your authorized SEGA Technical Services representative No license is granted by implication or otherwise under any patents copyrights trademarks or other intellectual property rights of SEGA Enterprises Ltd SEGA of America Inc or any third party Software circuitry and other examples described herein are meant merely to indicate the character istics and performance of SEGA s products SEGA assumes no responsibility for any intellectual property claims or other problems that
14. Terms amp Expressions Order of Procedure of Operators Statements 3 0 Console Commands Execution Control Register Operation Memory Operation Assemble Software Breaks Hardware Breaks Access Break Bus Trace File Operation Symbol Operation Macro Operation Batch Jobs BA Other 4 0 Menual Environment Apple Menu File Menu Upload Verify Working Directory Close Quit Edit Menu CPU Control Menu SCSP Interrupt Controller Memory Menu Breakpoint Menu Window Menu Console Window Dump Window Code Window Bus Trace Window Register Window Status Window 5 0 Use Restrictions Problems with SCSI Interrupts Vectors Hooked by SSBug Memory Hidden by SSBug Critical Time Periods SCSI Noise Carriage Returns Symbol Files Restrictions with Respect to Saturn O 00 0 4 4 O O O EP BR Introduction SSBug is a symbolic remote debugger for the sound CPU MC68EC000 on the Saturn development board for use in Apple Macintosh computers It supports the conventional character terminal interface and the standard Macintosh user interface and debugging can be performed using either one or both of these interfaces SSBug can be used with the sound board alone but when used in conjunction with the main CPU board synchronized breaks with the main CPU are also supported Apple KanjiTalk 7 and System 7 are registered trademarks of Apple Computer Macintosh is a trademark of Apple Computer MS DOS is a registered
15. Z eudura Control Panel b Scrapbook About SSBug displays the version and other information about SSBug The window is closed by clicking in the window Target Version 0 7 SCSP Version version 0 9 3 s Help opens the help window shown below Click on the subject to see in the Help Index in the left part of the window A description of that subject will appear on the right side of the window Hardware Break HB About this version Software and hardware break setting conditions are Handling files listed Execution control Memory operation HB bpnum adr mask cnt lt fc gt lt ds gt lt rw gt Register operation Set break point per hardware break channel bpnum adr address mask address mask described later cnt break count lt fc gt function code lt ds gt access data range lt rw gt read write Help Index Assemble Disassemble Symbol operation Batch and macro Bus trace bpnum is either 0 1 or 2 adr is MC68000 address mask will be described later The abbreviated value is 1 cnt can be specified from 1 to 65535 The abbreviated value is 1 File Menu This menu deals mainly with file operations Edit CPU Control Download Upload Verify Working Directory Download Equivalent to the console commands R RB RM and BA All file load operations for user programs symbols macros and batches can be performed from this menu
16. anceled up to that point The address is specified by expr2 and the pass count by expr3 BCexpr Cancels the software breakpoint at number expr When is specified in expr all software breakpoints are canceled BEexpr Enables the software breakpoint at number expr which has been canceled by BC When is specified in expr all software breakpoints are enabled When this command is executed with respect to a software break where no settings have been made since startup the setting may occur per a meaningless address so please use caution Sound Programming Debugger User s Manual 15 BR Format BRexpr Explanation Clears the break count for breakpoint number expr When is specified in expr the break count of all software breaks is cleared Hardware Breaks A hardware break monitors the generation of the specified number of bus cycles via CPU external hardware and stops execution of the user program by providing an NMI to the CPU when the target bus cycles occur The following bus cycle condi tions can be set e Address bus e Function codes Read vvrite e Access data vvidth e Access count Up to three hardvvare breaks can be set and are called channel 0 channel 1 and channel 2 respectively Be careful a break does not come after the bus eycles are generated or after access is terminated For example in the case of vvrite access vvrite is already terminated at the time of the break Also note that
17. e symbol value In the case of S28 and other files with an address specification expr is added to the specified address e When verifying symbol files value comparison will be against the same name symbols among those already loaded and those in the file VB filenamel expr Treats the selected file filename as a binary file and compares it with the contents of memory If expr is omitted 0 is used Wlfilename rangel offset Writes the contents of the address range range to the file filename in the Motorola 28 format offset is added to the address value of the S record 0 is used when omitted Sound Programming Debugger User s Manual 21 WB Format Explanation WS Format Explanation WBlfilename range Writes the contents of the address range range to the file filename in binary format VVS filenamel Writes the currently loaded symbol to the file filename Symbol Operation SR Format Explanation SV Format Explanation SU Format Explanation SN Format Explanation SC Format Explanation SS Format Explanation 22 SR regexp Displays a symbol matching regexp When regexp is omitted the character string is used SV regexp Treats the value of symbols matching regexp as signed integers sorts in ascending order and displays them If regexp is omitted then the character string is used SUlregexp Treats the value of symbols matching regexp as unsign
18. ed inte gers sorts in ascending order and displays them If regexp is omitted then the character string is used SNfregexp Sorts symbols matching regexp in ascending order of the names and displays them Upper case and lower case are sorted in dictionary order If regexp is omitted the character string is used SCfregexp Displays the number of the symbol matching regexp If regexp is omitted the character string is used SSexpr Searches for a symbol whose value is expr and displays it SD Format Explanation SA Format Explanation Macro Operation MACRO Format Explanation EXITM Format Explanation MLIST Format Explanation WM Format Explanation SDregexp Deletes a symbol matching regexp SAname expr Records the symbol whose symbol name is name using the value expr If the same name is already recorded the value is updated e The maximum number that can be sorted by the entire symbol display commands is 16 384 No more than 16 384 symbols can be displayed by commands with sort and only the SR command can be used when the number of symbols is more than 16 384 Macro s make it possible for the user to define a selected num ber of statements as one command Macro execution is per formed by using the macro name as a command name as with other built in commands When an argument is desired a special character is used in the macro defini
19. el 0 Bus Cycle Bus Cycle in general Ll Enable Function Code Arbitrary Data Range Arbitrary Read Write Arbitrary Address Mask Bus Count Disable All Apply 36 CE Window Menu Breakpoint Close all Console Status Register Bus trace Code b Dump p Information By selecting Close All all open windows will be closed Other menu items will open their corresponding windows Individual windows cannot be closed from the window menu Console Wndow The following window is used to enter console commands ZUE E 24 echo off 00002000 USP 00000000 55 00002000 SRezv X H 2 R 00000000 00000000 00000000 00000000 00000000 00000000 0 A n n n n 00000000 00000000 00000000 00000000 00000000 0 move w 2700 SR 00002000 USP 00000000 SSF 00007000 56 2200 x Mo 2 R 00000000 00000000 00000000 00000000 00000000 00000000 0 A 00000000 00000000 00000000 00000000 00000000 00000000 0 move w 8 2 00 56 The four buttons at the top of the window have a one to one correspondence with the console commands as shown below and when a button is clicked the respective console command is entered GO button G STOP button STOP TRACE button T STEP button S Sound Programming Debugger User s Manual 37 Further if the command is not entered from the keyboard i e by execution of a batch job or a macro the file name or macro name is displayed as shown below
20. en a specified address is rewritten to illegal command Therefore a software break can only be set at a location that is an even address in the DRAM area on the sound board and is executed by the CPU as a command SSBug has 16 of these kind of software breakpoints and it is also possible to set the pass count The number of times they are passed through without stopping is referred to as the pass count and the number of times they are actually passed through is referred to as the break count When expressing software break numbers specify them in an expression with values from 0 to 15 B Format Explanation B Format Explanation BN Format Explanation BC Format Explanation BE Format Explanation B Displays a list of the software breakpoint and hardware breakpoint settings Bexpr1 Lexpr2 The software breakpoint is set at address expr1 The pass count is set in expr2 If it 0 break is continually applied When a pass count other than 0 is specified then break is applied continu ally when the break count exceeds the pass count The values that can be set in expr2 range from 0 to 65535 and becomes 0 if omitted Of the software breakpoints currently canceled the B command sets the most recent at address expr1 BNexpr1 expr2 Lexpr3 This is the same as the B command except that the number of the software breakpoint set is specified in expr1 The breakpoint set at number exprl is c
21. eriods the message in the dialog box No response is displayed No response from Saturn sound board B Execute again If the sound board should hang up at this time the SCSI bus is taken over and stopped thus hanging up the Macintosh as well This happens when display of the message in the dialog box No response is attempted the resource cannot be read in because the SCSI bus has been taken over thus resulting in a window being displayed with nothing in it and hanging up the system If this should happen attempt execution again after releasing the SCSI bus by reset ting the sound board or supplying a break from the main side Vectors Hooked by SSBug The exception vectors re written at the time of execution of the user program used by SSBug are listed below reset bus error address error illegal instruction zero divide chk instruction trapv instruction privilege violation trace un initialized interrupt spurious interrupt level 1 auto vector level 7 auto vector The operation of programs that automatically rewrite the above vectors or reference them during execution cannot be guaranteed under SSBug Programs that hold the vector table static present no problem Sound Programming Debugger User s Manual 43 In a condition in which control has shifted to the debugger and not the user pro gram the two interrupts level 2 auto vector and level 3 auto vector are replaced by the following routine i
22. expr is omitted the address following that used by the previous A command is used Dur ing interactive line assembly a prompt like that below is dis played in the input area of the console window Console 2000 002000 46F C2700 move 1 2 700 SA 002004 20780400 moved 0400 002008 2 6850010 moved 0010 A0 gt 002002 246 m va 002002 8 0 14 adda 00 14 A09 002012 4BF 900 100000 lea T n 100000 AS 002018 4 1774 jer 0000328 2 oo2z01C 4EEAOSBO ere O000257E CRC 3 z 1c 0020 12 4 56 jar FOOODZSTELPC 3 moveg 0 dq Assemble UN Enter or to terminate interactive line assembly e You can return to the previous address by entering or By entering a space you can advance to the next address without making any changes to the contents of the current address e Specifications of absolute addresses are interpreted as described below expr absolute long address expr 1 absolute long address expr w absolute short address UN Format Lrange Explanation _ Disassembles and displays the address area range When from is abbreviated the next command where the previous L com mand is completed when to is abbreviated from 1F is adopted If from is an odd number then it is made into an even number Software Breaks A software break stops the execution of the user program by generating an excep tion wh
23. he following steps 1 Copy the SSBug Target Code file to the system folder on the startup disk by dragging it to the system folder 2 Copy the remaining files to any desired location This completes installation and there is no need to restart the Macintosh Starting Up SSBug SSBug can be started by double clicking on its icon or by opening it up from the Finder Since SSBug does not support Apple Events SSBug will not startup even when double clicking on files produced using SSBug or use drag amp drop Sound Programming Debugger User s Manual 2 0 Definitions Constants The constants that can be used in SSBug are listed below e Hexadecimal constants character strings of any desired length beginning with and comprised of the characters 0 9A Fa f Decimal constants character strings of any desired length beginning with and comprised of the characters 0 9 Binary constants character strings of any desired length beginning with _ and comprised of the characters 0 1 Evaluation is performed in the 32 bit mode without sign Overflow amount is ignored and the Hexadecimal prefix can be omitted Variables The variables that can be used in SSBug are listed below 0 1 02 9 These are variables that the user can freely assign and reference with no 32 bit code Unary Operators The unary operators that can be used with SSBug are as follows positive sign negative s
24. ign 1 s complement Binary Operators The binary operators that can be used with SSBug are as follows sum difference multiplication division amp logical product logical sum remainder of the dyadic division A not if then logical sum lt lt arithmetic left shift gt gt arithmetic right shift Symbols In SSBug symbols are referenced by attaching a before the symbol name The characters that can be used as symbols are listed below A Z a z 0 9 and SSBug always distinguishes between upper case and lower in its symbols Wild Cards Wild cards are meta characters which are used when specifying multiple character strings The following wild cards can be specified in SSBug j Matches a character string of a specified length However charac ters appearing after these characters are ignored Matches any desired character Registers The CPU registers are also referenced in SSBug by attaching a period at the begin ning The following register names can be used D0 D1 D2 D3 D4 D5 D6 D7 A0 A1 A2 A3 A4 A5 A6 A7 SSP USP PC SR CCR e Case is ignored in register names e When symbol names and register names conflict the symbol name takes precedence Un e The character is added at the start only when referencing the value in a expression the character is not specified during line assemble or when substituting values per X command The value of CCR become
25. les The signals recorded are as follows e Address bus e Data bus e FC R W e MCCS B BUS select signal BH Format BHexpr Explanation Displays the past expr times worth of history since the previ ous stop Due to the MC68000 command prefetch disassembly display of this command is not necessarily correct Specifically the instruction after a conditional branch instruction is likely to be displayed incorrectly Also according to the hardware specification the operation of the debugger could be recorded In the following examples the SCSI communication condition of the debugger is recorded E _ Bus Trace Count Address Ew Data Code FFFFFZ Read 0040 level interrupt ck edge Q v FZz Write A000 Q v Fd Hrite 0000 000064 Read 000066 Read E009AA Read 2700 5R E RaRE Read Read 1F380050 647 E RaRE Read EOOGEO Read 00662 Read 1SFC CAB EOOSE4 Read 800056 Read EOOGEG Read S0 00 Q v F Hrite FF E00968 Read 0080 EOOGER Read 0056 1F39 A6 EOOGEL Read 1F38 500056 Write The contents from a SCSI interrupt is received at count 294 until the bus trace is stopped at 276 are recorded Sound Programming Debugger User s Manual 19 In the following example a software break is set at 200 Since it has not reached the pass count user execution is not stopped and is continued Bus Trace Fr Data Code 000200 Read 4AFC Illegal
26. nterrupt move w 1 SCSP_SCIRE ECE Therefore as long as the sound tool rules use only level 2 and 3 SCSP interrupts are observed interrupts will not be applied to the user program during debugger standby Memory Hidden by SSBug Since SSBug hooks to the user vector the first 80 bytes of memory is given special treatment and the memory 000000 00007F as viewed from the debugger is not actually the target 000000 00007F Therefore the following restrictions apply to the 000000 00007F memory area When an ICE etc is also used seemingly conflicting conditions may be experienced User program code cannot be placed Even if memory is dumped from SSBug an exception vector onto which the aforemen tioned SSBug hooks cannot be viewed Critical Time Periods There are critical time periods in the operation of the current version of the debugger when an emulator break etc of a hardware break etc and a CPU exception in cluding software breaks or trace executions occur almost simultaneously This is currently being addressed SCSI Noise There are cases in which the SCSI signal of SSBug appears as noise in the analog output of the sound board If this should be a problem open up a dialog box SSBug does not communicate with the sound board during dialog display Carriage Returns The carriage return characters in text files used by SSBug can by either a CR Macintosh or a CR LF MS DOS in all batch symbol
27. planation Format Explanation TU Format Explanation S Format Explanation SU Format Explanation STOP Format Explanation RESET Format Explanation 10 Glexpr11l expr21 Executes a user program from address expr1 and stops it at address expr2 VVhen expr1 is omitted the value of the current PC is used If expr2 is omitted execution of the user program continues unless it is stopped for some other reason Tlexpr1 l expr21 Executes expr1 commands from address expr2 and stops The register contents and the command to be executed next are displayed with each command If expr2 is omitted the value of the current PC is used If expr1 is omitted 1 is used TUlexpr1 l expr21 This is the same as the T command except that the register contents of each command are not displayed Slexpr11 l expr21 Executes expr1 commands from address expr2 and stops The register contents are displayed vvith each command f expr2 is omitted the value of the current PC is used If expr1 is omitted 115 used This command differs from the T command with respect to the follovving points bsr jsr Treated as 1 command from the execution of a subroutine until return e trap trapv chk A line trap F line trap Treated as 1 command from exception processing until return SUlexpr1 l expr21 This is the same as the S command except that the register contents of each command are not displayed STOP Sto
28. pression refers to character strings comprising an arbitrary number of terms and with values that can be evaluated Expressions term unary operator term term binary operator term binary operator term An arbitrary expression may be enclosed in parentheses where the part enclosed in the parentheses is treated as a single term Order of Precedence of Operators The order of precedence is as follows High 0 elementary term unary unary 1 binary binary gt gt lt lt amp N OY O1 HS ND Low 7 Statements Character strings that specify operations in SSBug are called commands Command names are formed by the following characters A F a f 0 9 72 amp Some commands require an expression or an arbitrary character string as an argu ment The character strings completed as command where include these required arguments are called statements There must be at least one white space character between command names and arguments further multiple arguments must be separated by a comma There may be any number of white space characters before or after commas Statement command argument argument argumentt In SSBug the maximum length of completed character strings of commands or state ments is 255 characters 3 0 Console Commands The console command environment is an operating environment that uses a charac ter terminal interface Opera
29. ps the execution of the user program RESET Resets the CPU registers and masks all the SCSP interrupt enable registers SCOPE Format Explanation SCOPEIarg Can periodically display in the register window the status of the CPU registers of the SSBug user program being executed The SCOPE command performs this setting Specify the following character strings for arg ON switches display ON OFF switches display OFF Omitted displays the current settings Register Operation x Format Explanation x Format Explanation X Lists the values of the CPU registers Xreg expr Sets the value expr in the CPU register reg A period is not inserted in the register name with this com mand Memory Operation D DB DWDL Format Explanation F FB FWFL Format D range DBlrangel DWIrange DLIrange Dump displays the specified address area range to the display The commands DB DW and DL result in byte display word display and long word display respectively and change the default display size to byte word and long word The D command displays in the default display size Word display and long word display are possible from odd addresses in SSBug Either from or to may be omitted per range When from is omitted the next address where any of the commands D DB DW or DL is previously completed will result When to is omitted from 7F will result Frange expr FBrange exp
30. r FWrange expr FLrange expr Sound Programming Debugger User s Manual 11 Explanation Fills the address range range with data expr Fill means to put in as much as can be held The FB FW and FL commands specify byte word and long word operation respectively and change the default fill size to byte word and long word The F command executes fill using the default fill size ME MEB MEWMEL Format MEexpr1 expr2 MEBexpr1 expr2 MEWexpr1 expr2 MELexpr1 expr2 Explanation Writes data expr2 to address expr1 The MEB MEW and MEL commands write in bytes words and long words respectively and change the default write size to byte word and long word The ME command executes in the default write size ME MEB MEWMEL Format MElexpr11 MEBlexpr11 MEWIexpr1 MEL expr11 Explanation Performs interactive memory editing from address expr1 The MEB MEW and MEL commands write in bytes words and long words respectively and change the default write size to byte word and long word The ME command executes in the default write size During interactive editing a prompt like that shown next is displayed in the input area of the console window Console x PC O000R008 USP 00000000 SSP 880A8008 SR 2700 X 0 zaf D 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 ori 0082280A DO me 6000 006000 SSOASOOE gt 00002040 00600 OO00R008 gt 0000000
31. rent working directory e SSBug remembers the working directory when the previous session is terminated and this is automatically set at startup 22 Ve 20 a R RB V VB W Format Explanation Format Explanation Format Explanation Format Explanation Format Explanation Rlfilenamel exprll Reads the file filename to offset address expr If expr is omitted 0 is used The file formats Motorola 919 528 and 537 Intelex Hex format 2500 A D symbol file ZAX symbol file and SDSS sym bol file are automatically distinguished Files that cannot be read are treated as binary files In the case of symbol files expr is added to the symbol value In the case of 28 and other files with an address specification expr is added to the specified address In the case of binary files the top address for read is used e In all of the file operation commands below the same operation as selection from the menu is performed when the file name is omitted RB filename expr Treats the selected file filename as a binary file and reads it to address expr If expr is omitted 0 is used Vi filename lexpr Compares the file filename with the contents of memory or the contents of symbol The file formats Motorola 519 528 and 537 Intelex Hex format and symbol files are automatically distin guished Files that cannot be read are treated as binary files In the case of symbol files expr is added to th
32. s the value of the lower byte of the SR register Functions The SSBug s built in functions are listed below B expr contents of one byte at address expr on sound board W expr contents of one word at address expr on sound board L expr contents of one long word at address expr on sound board BP expr address of the expr th software breakpoint EXTBL expr value of expr code sign extended from word to long word EXTBW expr value of expr code sign extended from byte to word EXTWL expr value of expr code sign extended from word to long word Case is ignored in function names characters between O and BP expr returns a value regardless of whether or not the breakpoint is enabled Terms and Expressions Term refers to character strings whose values can be evaluated Hexadecimal constants Decimal constants Binary constants Symbols Register names Functions Sound Programming Debugger User s Manual 7 The terms and expressions on the previous page are the least divisible units with their own values and are referred to as elementary terms Elementary terms can make up terms as described below Terms elementary term unary operator elementary term elementary term binary operator elementary term binary operator elementary term There can be any arbitrary number of white space characters tab characters or space characters between an operator and an elementary term Ex
33. selected position Evaluation result Value Input Hexadecimal 0 Decimal 0 SCSP Interrupt Controller Allows the operation of the interrupt enable register SCIEB and the interrupt pending registers SCIPD MCIPD of the SCSP 32 Sound CPU Interrupt allowed L External Interrupt 0 m External Interrupt 1 L External Interrupt 2 L MIDI Input L DMA End C CPU m Timer A m Timer B L Timer C L MIDI Output L Sample Interval SCSP version 3 SCSP Interrupt Controller Sound CPU Interrupt pending m External Interrupt 0 i L External Interrupt 1 C MIDI Input DMA End DJ CPU Timer A L Timer B L Timer C _ MIDI Output L Sample Interval L External Interrupt 2 L MIDI Input _ DMA End CJcpu 2 L Timer A _ Timer B L Timer C L MIDI Output O Sample Interval Cancel Main CPU Interrupt pending O External Interrupt 0 i L External Interrupt 1 m External Interrupt 2 Set Memory Menu CPU Control Breakpoint Search File Compare Move These correspond to the console commands as shown below Through each selec tion amovable modal type dialog for inputting arguments is displayed Retrieve Corresponds to MS command However the results are displayed in an information window H Memory Search Search size
34. the MC68000 performs pre fetch of program code and movem com mand data Especially when a hardware break is used for program execution the break may be applied before execution or a break may be generated by commands immediately after jmp etc which are not executed HB Format HB Explanation Displays a list of the settings of software breaks and hardware breaks HB Format HBbpnum adr mask cntl lt fc gt L lt ds gt lt rw gt Explanation Sets a break point in the hardware break channel bpnum adrr address mask address mask described below cnt break count lt fc gt function code lt ds gt access data width lt rw gt read write bpnum is 0 1 or 2 adr is the address in MC68000 16 HB HB Format Explanation Format Explanation mask is explained below It s omission value is 0 A value from 1 to 65535 can be specified for cnt It s omission value is 1 One of the following character strings is specified for lt fc gt user user mode access super supervisor mode access data data access prog program access ud user data access up user program access sd supervisor data access sp supervisor program access is set to an arbitrary mode when abbreviated One of the following character strings is specified for lt ds gt low lower byte access odd addresses high upper byte access even addresses word word access is set to an arbitrar
35. tion for reference It is not necessary to describe a dummy argument MACROname Sets the macro with name name Defining is terminated by inputting a blank line EXITMexpr This command can only be executed during macro develop ment If expr is 0 the macro being executed is exited MLIST regexp Displays macro names matching regexp and their contents Displayed after being sorted in macro name dictionary order If regexp is omitted the character string is used e The same restrictions that apply to symbol operation commands apply to sort display WMfilename Writes the currently registered macro to file filename Sound Programming Debugger User s Manual 23 RM Format Explanation Batch Jobs BA Format Explanation Startup Files Other HELP 24 Format Explanation RMfilename Reads a macro definition from the file filename Description and expansion example of argument The nth macro argument is noted as n in the macro definition where n is an integer from 0 to 9 e Macro definition MACRO wordwrite mew 0 1 Command input wordwrite 100 123 e Expansion result mew 100 123 Batch job is the reading and execution of a file in which a se lected number of statements are described These files are called batch files BAfilename Executes the batch file filename The commands RM and BA are actually the same Macros can be defined in a batch file and other statemen
36. tion is progressed per a console window like that below by inputting commands from the keyboard These are called console commands Console 00 2004 00 2005 00 200 00 2002 00 2012 002015 0020 1C 2 20730400 moyea 0400 w A0 2C6800 10 movea 2 ZE4E moved AG A 0 280014 adda 00142 2 46 900 100000 leq 00 100000 A5 4EBA 1774 jer POOOOSTSECPC 3 4 56 0 jer OOO02Z57ECPC x PC 0000R008 USP 00000000 55 88048008 SsRezv X MO 2 00000000 n n nn 00000000 n nn n n n n n 00000000 r po A 00000000 0 00000 00000000 00000000 0000000 n n n Oo ori Refer to Menu display console 0082280R 00 Environment in the next chapter for more information on how to windows and operate them Terms used in the following explanations have the following meanings range regexp specifies a range of addresses or values 2 expressions separated by commas where the first expression is referred to as from and the last expression is referred to as to and the range of values becomes from lt value lt to character strings including any selected number of the wild card characters and these are especially used when specifying multiple symbols In command notations factors surrounded by brackets can be omitted Sound Programming Debugger User s Manual 9 Execution Control G Format Ex
37. ts can also be ex ecuted in a macro file Startup files refer to batch files automatically executed when SSBug is started When the text file SSBug Startup is in the working directory when SSBug is started up this is treated as a startup file and executed HELP Opens the help window VERSION Format Explanation MEMFREE Format VERSION Displays the version of SSBug itself the target program and the SCSP MEMFREE Explanation Displays the amount of memory that can be used for macros symbols batches etc ECHO Format Explanation QUIT Format Explanation Format Explanation Format Explanation ECHOlarg ECHO ON Echoes the input line from the current input destination macro console or batch to the console This becomes a local setting for each nest of the macro console or batch ECHO OFF Switches echo off ECHO Echoes other specified character strings to the console QUIT Terminates SSBug Displays a list of user variables expr Evaluates the expression expr and displays the result Sound Programming Debugger User s Manual 25 4 0 Menu Environment SSBug can also be operated via the standard Macintosh user interface The same expressions as in the console environment can be used at all locations that accept numerical input in dialogs Apple Menu There are two items in the Apple menu File Edit CPU Control About SS BUG Help 36 Telnet E
38. us cycle from B BUS 40 Register Wndow Displays the contents of the CPU registers 1E Register 000020 12 SA 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000420 00000000 00000000 00000000 00000000 00000000 00006000 0000 100 The register values be input or changed by clicking on the respective register values Also by clicking on the flag indicator of the SR register the value of the SR register can be changed in bit units as shown below Status Register Interrupt vector level SR 2701 EJ 5 Supervisor mode T Trace mode L Expansion carry flag 1 2 Zero flag M Negative flag EJ C Carry flag 1 Overflow flag Sound Programming Debugger User s Manual 41 Status Wndow Displays execution of the user program The following display appears during execution of a user program Status User program is executing PC 0020F When the user program is stopped the following display appears However when a break is not applied without reaching the pass count with soft ware breaks an idle display or debugger program PC display may temporarily appear even when the user program is normally being executed 42 S 5 0 Use Restrictions Problems with SCSI Interrupts Communication between SSBug and the sound board is done via the SCSI level 1 auto vector Therefore when the sound board is at interrupt level one for long p
39. y mode when abbreviated One of the following character strings is specified for lt rw gt read read access write write access When abbreviated both read and write will be the target Mask is equivalent to the undefined bit in most ICE etc and the bit for which mask is 1 is ignored during address compari son For example if 1000 is specified for the address and 00FF is specified for the mask the address at which the break is actually generated becomes a selected address from 1000 to 100FF HBbpnum adr mask cnt PF To apply a break to a program fetch eliminate excessive specifi cations by writing the character string PF after cnt as shown here e This can be used in both the user mode and the supervisor mode HBbpnum llevel cnt LA To apply a break to an interrupt acknowledge cycle Write the character string IA after cnt as shown here The interrupt level is specified in level If omitted it becomes Don t care Do not specify Don t care or level 1 or level 7 Sound Programming Debugger User s Manual 17 HBC Format Explanation HBE Format Explanation Access Break HBCbpnum Cancels the hardware break in channel bpnum All channels are canceled when the character is specified in bpnum HBEbpnum Enables the hardware break in channel bpnum All channels are enabled when the character bpnum e The HBE command enables break regardless of
Download Pdf Manuals
Related Search