+---------------------------------------------------------------------+
| WHATSNEW.DOC REVISION HISTORY FOR TMS320C31 DSK SOFTWARE |
+---------------------------------------------------------------------+
This file contains information covering new applications, features and
fixes that have been incorporated since rev 1.10 of the C3x DSK Software.
=========================================================================
APPLICATIONS CODE (versions after 1.10)
=========================================================================
-APPHELP.HLP These files, which are actually source files for building
-CMDHELP.HLP some DSK applications contain the text strings for various
-HARDWARE.HLP help screens. They are plain text and can be viewed or
printed with almost any program.
-DSK3HELP.EXE This application can be used in a seperate DOS box alongside
the debugger and other applications to view the debuggers
help screens as well as a new external help file 'APPHELP.HLP'
that contains lots of tips and tricks for DSK code and
hardware development. You can also copy these help screens
to files the same as if you were viewing them in the debugger.
-LOADPROM.EXE This application is a utility that reads in *.HEX files,
which are bootloadable images, and writes each byte to the
DSK's external interface using the DSK debugger. This makes
it easier to create EEPROM based daughter cards that can
be both used with the DSK debugger and used in a standalone
mode. Note that you MUST convert your application files to
the *.HEX format to use this utility
-DSK_SG.EXE Generates precision sine wave, triangle or sawtooth signals
using an interpolated table lookup. Up to 14 signals can be
added together (limited by screen display) be added together.
Includes White noise and DC level shifting. Includes AIC
control hot keys.
-DSKSG.ASM TMS320C3x source code for DSK_SG.EXE
-SAWT_SG.ASM TMS320C3x source code for creating wave tables
-SINE_SG.ASM TMS320C3x source code for creating wave tables
-RAMP_SG.ASM TMS320C3x source code for creating wave tables
-RAND_SG.ASM TMS320C3x source code for creating wave tables
-DSK_DTMF.EXE Generates precision 32 bit floating point accurate sine wave
signals using a complex vector rotation. Up to 14 sine waves
can be added together (limited by screen display). The number
keys are mapped to create DTMF tones. Includes White noise
and DC level shifting. Includes AIC control hot keys.
-DSKDTMF.ASM TMS320C3x source code for DSK_DTMF.EXE
-FFT_1024.EXE A 1024 point complex radix 2 FFT that runs 100% on-chip. This
is made possible by using a packed short float format (4:1:11)
similar to float immediate values. There is very little loss
in SNR. Data and twiddles are packed two per memory slot in
REAL:IMAG pairs. Pack/unpack routines are also included for
float16() 8:1:7 format. Includes AIC control hot keys.
-FFT1024.ASM TMS320C3x source code for FFT_1024.EXE
-FFT_512.EXE Traditional 512 point FFT using 32 bit floating point arithmetic.
The FFT is written for readability not for size or speed since
the majority of time is spent in the host updating the display.
Includes AIC control hot keys and analog loop back of a sawtooth
signal.
-FFT512.ASM TMS320C3x source code for FFT_512.EXE
-FFT_256.EXE Traditional 256 point FFT using 32 bit floating point arithmetic.
The FFT is written for readability not for size or speed since
the majority of time is spent in the host updating the display.
Includes AIC control hot keys and analog loop back of a sawtooth
signal.
-FFT256.ASM TMS320C3x source code for FFT_256.EXE
-FFT_256B.EXE Same as 256 point FFT except that the host display uses the
oscilloscope interface. Includes AIC control hot keys and analog
loop back of a sawtooth signal.
-FFT256B.ASM TMS320C3x source code for FFT_256B.EXE
-FFT_OSC.EXE Data collection and display as an oscilloscope I/F. Hot keys
allow control of the AIC, volts/div, offset and other parameters.
With the bandpass filter removed, the TLC32040 will accurately
convert and display square, triangle and sawtooth signals.
Note that the analog loop back of a sawtooth signal will show
some ringing. This is because of the DAC reconstruction filter
which cannot be defeated is bandwidth limited.
-DSKOSC.ASM TMS320C3x source code for DSK_OSC.EXE
-DSK_PWM.EXE This program is written to give the user finer control over
the two timers that are used to create the R-Y-G LED cycling.
Additionally a 0Hz frequency can be specified with a known
duty cycle between the two timers for a DC output.
-DSKPWM.ASM TMS320C3x source code for DSK_OSC.EXE
-DSK_TEST.EXE This program is used in the factory to test the DSK's
functionality. Includes an internal memory checker and a
routine for checking the external data bus for stuck bits.
Be sure to not have the DSK's data bus connected to an external
load before running this test.
-DSKTEST.ASM TMS320C3x source code for DSK_TEST.EXE
-MANDEL3X.EXE This program uses the DSK to calculate the Mandelbrot set much
faster than most PC's. Guessing algorithms are not used as in
most popular Mandelbrot viewers. Note that in many cases a
high percentage of the time is used to move the data, not
calculate it!
-MANDEL.ASM TMS320C3x source code for MANDLE3X.EXE
NOTE: This application requires an external BGI driver
SVGA256.BGI to operate. See README.DOC for details
-DSK3LOAD.EXE Loader/Bootloader utility that will either load or bootload a
DSK, COFF or HEX file to the DSK. Also includes a FILE2HEX
converter and NOLOAD option.
-DSK_HLL.EXE By loading the symbols of the last loaded DSK3D debugger file
(contents of DASMFILE.FIL) this utility can get the value of the
current PC and cross reference that value back to a line of
C level source code. This application can be run concurrent
to DSK3D.EXE in a separate DOS window in either Windows 3.1 or
Windows 95. OS/2 will not allow multiple devices to access the
printer port at the same time.
-MEMVIEW.EXE Use this utility concurrently in a second Windows DOS box
to asynchronously pole the status of the DSK and display both
a block of memory and on-chip memory mapped registers.
-REGVIEW.EXE Similar to MEMVIEW.EXE except that the display is of the context
save area giving an update of the register values as a program is
run. Also, the memory dump can be in either HEX or FLOAT.
-SIMPLE.EXE This program is a stripped down version of MEMVIEW.EXE to help
a novice code writer learn how to write host interface code for
the DSK. For example you can change the memory display to
a different format by changing the printf() statement or maybe
add graphics routines for a display. Note that the opposite
of getting a block of memory, getmem(DSPaddr,length,&HOSTaddr)
is putmem(DSPaddr,length,&HOSTaddr) making it easy to create
a DSK memory modifier.
-C3X.ASM TMS320C3x DSK Communications and debug kernel source code
-C3XMMRS.ASM TMS320C3x Memory mapped register definitions
-LOOPAIC.ASM Stand alone AIC code for either analog loop back or sawtooth
signal generation. The mode is changed by a code variable.
-SFFT.ASM The Sliding FFT or SFFT is a method of calculating an entire
FFT output within the span of one input sample. The technique
uses the previous FFT and applies a vector rotation to each
output bin before summing in the new input. Since the vector
rotation operation on a DSP is quite fast, the SFFT can be
very efficient. This demo will either create a spectrum analyzer
output, which is viewed with an oscilloscope connected to Vout,
or as a sum of all REAL's or all IMAG's. IOW an all pass filter
of either 0 or 90 degrees phase shift.
-TOGGLE.ASM Stand alone code for making the LED toggle R-G-R-G
-IDLE2.ASM Stand alone code showing how to use a feature of the IDLE2
instruction to freeze a write in progress on the bus to
eliminate the need for pull up, pull down resistors for low power
-RAND.ASM Stand alone code showing a code loop which calculates 32 bit
random numbers.
-FIR.ASM A 16 tap FIR filter example implementing the Z transform
-15
H[z] = 1 - z which is a simple comb filter
-MATH.ASM A piece of looped code that calls various math functions
for evaluation. Includes inverse float, square root, log2
and ultra-fast log2. These math functions are written for
readability not for speed. By using the debugger and utility
interfaces the functions can be analyzed to determine how
they work. Read the notices contained within the source file
for more information.
-SCANNER.EXE Host control and display code for a TSL1402 256x1 line scanner
Requires that a daughter card be constructed. The daughter
card electronics require a TSL1402, 14 pin socket, bypass
capacitor and 330 ohm resistor. You will also need a short
focal length lens and some kind of mounting hardware unless
you only want to see that shadows showing up on the line.
Read the documentation at the top of the *.CPP and *.ASM source
files on how to construct the daughter card.
-SCAN.ASM TMS320C3x source code for SCANNER.EXE
NOTE: These files are not compiled or pulled down into the
DSK3TOOLS directory since this application requires the
construction of a daughter card. Also, there is not much
space leftover on the disk for very many more applications!
- The TLC32040 that is used on the DSK is able to convert
each sample coming from the TSL1402 without being dependent
on the previous samples since the input filter can be
bypassed on that particular AIC. Other types of AIC's are
usually not suitable for this kind of application. TI also
makes a low cost 8 bit flash converter (TLC5510) but this
does require considerably more effort to breadboard so it
is not used in this application.
NOTE: This application requires an external BGI driver
SVGA256.BGI to operate. See README.DOC for details
==========================================================================
DEBUGGER COMMANDS AND OTHER FEATURES ADDED AFTER VER 1.10
NOTE: THE DSK3D HELP MENU CONTAINS A LISTING OF DSK3D FEATURES
==========================================================================
FSTEP Step through functions times
MEM View memory @ - 32 bit hex
MEMX ''
MEMI View memory @ - signed
MEMD ''
MEML ''
MEMUI View memory @ - unsigned
MEMUD ''
MEMUL ''
MEMU ''
MEMF View memory @ - TMS float
FILE2HEX .dsk|.out conversion to HEX
DSK2HEX .dsk conversion to HEX
COFF2HEX .out conversion to HEX
HEX2COFF file .hex conversion to COFF
DSK2COFF file .dsk conversion to COFF
MEM2HEX file,a,l Write memory at address for length to HEX file
MEM2COFF file,a,l Write memory at address for length to COFF file
MAXFLEN val Set max output file length
MOVE/MOV src,dst,n Move memory from src->dst n<256 times
Added functions (assembler and debugger)
----------------------------------------
rand() 32 bit long or +/- 1.0 normalized float random
srand(x) Seeded version of rand()
float() 32 bit hex of TI float 8:1:23 format
float8() 4 bit hex of TI float 4:1:3 format
float16() 16 bit hex of TI float 8:1:7 format
sfloat() 16 bit hex of TI float 4:1:11 format
.psfloat Packed sfloat() used for 1024 FFT
========================================================================
REVISION HISTORY - COVERS NEW FEATURES AND BUG FIXES
========================================================================
New for version 1.11
========================================================================
- Improved message passing between functions
- COFF loader loads more symbols. Also more descriptive
- COFF loader now loads HLL cross reference table
- Now loads and writes DSK, COFF, HEX and MEM to and from files
- File translation
- Last loaded file for debugger is now written to file DASMFILE.FIL
- Memory display and type over modify in HEX, DECIMAL and FLOAT
- Added HEX file support. Hex files are hex ascii bootloader images
- Command buffer highlighting
- Improved online help
- Source and executable code is now compressed to fit on disk
- Added an INSTALL.BAT to help installing the code
- The distribution disk now expands into a structured tree
========================================================================
New for version 1.12
========================================================================
- Improved expression analyzer stability
- Trapping of math overflow errors
- Black out of various windows on error
- LOAD (no arg) before first file is loaded no longer causes a crash
- Worked auto detection of long and float values
- pow(a,b)
- Fixed sfloat, vsfloat rounding of negative numbers
- Long commands no longer cause the command buffer to 'blank out'
- Better tracking of code in the disassembler window
- Labels and symbols not recognized
- Packed float address count in pass1 assembly
- LABEL; comment ignored
- Comment preceding || of parallel code was ignored
- FFT analyzers were moving 2x data necessary for display
- Added TMSFLOAT.CPP to distribution disk
- LOOPAIC.ASM AIC initialization routine was corrupted.
- Can now force stepping using 'shift' function steps (SF8/SF10)
through even code that turns off, masks, or loses the host
interrupt enables. Usually shows up as a load to the IE register
- Can now set a breakpoint at the end of a repeat block. Previously
the breakpoint (a trap) would wrap around to the repeat start and
therefor not step properly
- The TRAP binary opcode value was missing an offset of 32,
causing the TRAPs to begin at address zero, overlapping the
normal interrupts. Note: The DSK uses this feature to create
TRAPs that execute the standard interrupts.
As defined in the UG, this bit
pre-adds an offset of 32 to a TRAP. ------+
|
C3x TRAP = 0x74000020 = 011101000000000000000000001xxxxx
- An error in the indirect addressing filter would get confused in the
following case. Basically '+' within the offset field would be seen
as a post modifier add (it was trailing the ARx field) and generate
a bad code.
Ex. LDF *-AR0(1+1) <- Generates bad code
LDF *+AR0(1+1) <- This worked
- The following, improperly written code, would not generate an error
Ex. LDF *-AR0(1)% <- The % modifier was ignored
- If a block of code was disabled " .if 0", and a parallel code was
inside the disabled block, the second line of the opcode would
generate an error. Example.
.if 0 ; Turn off code block
ldf *AR0,R1 ;
|| ldf *AR1,R2 ; Error generated here
.endif
- If a breakpoint was set within an ISR as shown the debugger would
loose synch, in version 1.11 but not previous versions. This bug
was created by a routine that was added for benchmarking (the _dT
option in the debugger). The new routine would force a single step
of a known opcode (a branch) and use it as a standard value for
timing calculations. Since the DSK uses a low priority interrupt
for debugging it was possible to loose the debugger interrupt. By
forcing all interrupts to return to the SSTEP routine, all cases
were guarenteed to return. This bug was fixed using the singlestep
forcing feature (previous bug fix).
ISR nop ; Enters with GIE=0
b ISR ;
reti ;
========================================================================
New for version 1.15 12/15/96
========================================================================
- Lost Host Communications
If 0xC4 (XINT1,RINT1,INT2) is not logically OR'ed with IE, the
DSK kernel communications link can be lost. The effect is that
singlestepping or running can crash or be eratic.
- If host communications fail, the user is notified that 0xC4
should be logically OR'ed with IE
- Higher level interrupts block host communications
If a higher level interrupt is pending, and during its execution
fails to fully recover E (OR of 0xC4), the CPU can miss the host
communications interrupt, failing to return to the command state.
- If singlestep or run synchronization fails, the user is notified
that 0xC4 should OR'ed with IE and that SF8/SF10 can be used
to override all interrupts, forcing all interrupts to point back
to the singlestep routine.
- A BreakPoint (BP), which is a TRAP opcode, can now be set in
most locations including repeat blocks.
When a break point (TRAP) is executed the program counter (PC) is
loaded with the TRAP address+1. By then cross referencing the PC
with known BP locations, the host can then properly back up and
execute the code that was in the BP location.
However in the case that a BP is set at the end of a repeat block
the PC value will not be BP address +1. Instead the PC will be
reloaded with the starting address of the repeat block and the
RC decremented.
By verifying that the apparent BP location was not in the active
BP list, that PC=RS, and that a BP was set at the end of the
repeat block, a recovery can be made.
Conditions that cannot covered include
1) A BP cannot be set at both the end of a repeat block and
at the position RS-1. A warning will be displayed if this
condition is detected.
2) A BP cannot be set within the three opcodes immediately
following a delayed instruction. This condition is not
allowed since interrupts, and TRAPs are disabled during
those cycles.
Note: A TRAP within 3 instruction of a delayed code will be
taken after the 3rd opcode, without regard to the PC
load of the delayed instruction. A recovery is not
possible. An error is generated if this condition is
detected.
- Not all operands for parallel enhanced opcodes (PG 6 and above)
were allowed. IE use of non floating point registers and some
special opcode orderings where missing.
- Consolodated the display and source managment of help files as
follows.
- TXT2SRC.EXE utility was created to convert *.HLP text files into
properly formatted C strings. The resulting *.CPP file is then
#included into the code. TXT2SRCE was also added to the Transfer
Utility in the IDE such that auto-dependenct builds will work.
- All help files are now managed through a single display function.
- DSK_reset() function was cleaned up to eliminate dead or inefficient
code and to also make it easier to port to a Windows DLL.
- Known screen update errors and lost messages were fixed
- Saved Help files now have a *.HLP extension
- The command buffer depth was increased to 16 commands
- Can now to save the symbol table to a file.
- Changed rev to 1.15 (1.20 will be the formal release level)
- The assembler now accepts F0-F7 as valid arguments for float regs
- The assemblers defined register are now fully table driven.
- 'FP' is now accepted as 'AR3' the C frame pointer
- CREAD (TAKE) has been added to allow execution of
debugger commands stored in a file.
- CSAVE Saves command buffers, window positions, PC and SP
CSAVEALL Same as above, but also saves all onchip memory to
CSAVEALLCOFF FULLSAVE.HEX or FULLSAVE.OUT (COFF version)
- A new command 'CMDxx string' copies 'string' to command buffer xx
'PAUSE' and 'END' functions were also added
- Consolodated the command processor switch tables.
- Can now 'SAVE x,y,DASM' memory in DASM format to a file
- fcloseall() statements in DSK_COFF.CPP were changed to fclose()
of localy open files
- New commands DASM0-3 now allow various amounts of information
to be written to the DASM window.
- The 40 bit and floating point display now persist after hitting
the F2 or F3 keys. Can now edit the CPU registers as both
hexadecimal or float
- Now use ExeCmdStrg(char *) to execute command entries, rather
than seperate command processors in several boxes.
- DSK3A labels to floats ("F0 .float 1.4") are now properly listed
in the symbol table at the end of the DSK file and are properly
read in and used by the debugger
========================================================================
New for version 1.16 1/6/97
========================================================================
- 43/50 row screen modes are now supported using a new command
line option 'C4350'
- The MEM window start address can now be entered while the MEM window
is active using the F2 function key. The edit box that is opened
can accpet numerical or symbolic expressions similar to the command
line and assembler.
- Preservation of the last used cell for the MEM and CPU windows
makes it easier to go back to the location that was last edited
- The DASM window cursor location now tracks the PC value when the
window is first opened
========================================================================
New for version 1.17 2/6/97
========================================================================
- New help utility DSK3HELP.EXE
- More help files, especially for applications
- New utility LOADPROM.EXE reads *.HEX files into DSK memory assuming
that an EEPROM is present.
- INSTALL.BAT now includes version stamp recognition
- DSK3LOAD now recognizes when no file is specified
- Disassembler routines now use a hash table for faster code lookup
- TI Floating Point Tools Version 5.0 support. A new COFF file
version was added. Changed some structure definitions
- Q format view and edit of the memory window
========================================================================
New for version 1.18 3/7/97
========================================================================
- Added more application information to APPHELP.HLP
- Added DSK_WAV.EXE (DSK_WAV.CPP/DSKWAV.ASM) wave file play and record
- Improved LOADPROM.EXE user interface to have highlighted data
and reconstructed data (byte->long) for easy verify. Also set
wait state generator to maximum for slow devices.
- Added PICK.EXE ot INSTALL.BAT to replace DOS 'CHOICE' command.
CHOICE was not available before DOS 6.0 and was therefor giving
users installation errors.
- Fixed a DSK3A bug that was causing load errors
Within a .if section that was disabled, directives were not being
shown as 'nocode' lines. As a result the loader would see a .sect
that should have been disabled as active.
0x809800 directive .if 0 ; turn off assembly
0x809800 directive .sect "JUNK" ; section
0x809800 directive .endif ;
0x809800 directive .if 0 ; turn off assembly
0x809800 nocode .sect "JUNK" ; section
0x809800 nocode .endif ;
- Immediate short float values (4/1/11 format) with Exp=-8, should
disassemble to zero. This is bypassed for the DSK3A assembler
loopback test mode which is used to verify binary exactness for
disassembled -> re-assembled binary opcodes.
- Added a commented out line of in TMSFLOAT.CPP, function TMS_IEEE(), that
can be used for the conversion of 'Denormal' IEEE floating point numbers.
Denormal numbers occur when the exponent is -127 and fall outside of the
IEEE range of 2^-127 < 2^127. Denormal numbers may not be faithfully
represented or operated on in an IEEE number format. These numbers are
either treated as zero values, or as 2^-127 * Q23(frac). The C3x/C4x
on the other hand uses the range specified for denormal numbers for
floating point representation.
- An '.brstart' (or any other section change statement) imbedded into
the comment field of a section which was supposed to be turned off
in a .if block was causing the section loader to fail.
- DSK_TEST.EXE, TXT2SRC.EXE and FFT_256B.EXE were removed from the software
installation diskette to make room to fit into 1.4MB diskettes. The
source and project files for these applications are still included.
========================================================================
New for version 1.19 4/2/97
========================================================================
- Made changes to DASMC40 to remove the use of 32 bit bit fields in
the disassembler forms. This practice was not ANSI-C compliant
- Added function 'int isC4code(int);' to the dasm/assm to avoid testing
each code explicitly within the assm/dasm form functions
- Worked on STIK, TOIEEE, FRIEEE and LDA C4x codes
- dasm_assm loop now only prints to screen in verbose mode.
- STI R0,*+AR0(VeryLongName) the buffer array was limited to 16 chars
and subsequent string copies were corrupting the other data.
- WS chars are no longer appended to .include file names for people
porting the assembler
- Added code to detect section names with >16 chars. Now returns
an error
- .word, .float etc... with no argument did not generate an error
- Bump up the rev ID for all tools and apps to 1.19
========================================================================
New for version 1.20 5/12/97
========================================================================
- Bumped up version number to 1.20
- Changed primary bus control word during file conversion to bootable
HEX format to 0x10F8. This sets WS = 7 (max) which is the safest
for very 'slow' boot.
- Edited C3X.ASM to better explain primary/secondary vectors
- Added a C31/C32 command line switch option to indicate target types
- Moved to DSK.H
SIZELOC is where printer port readback mode information is
TESTLOC is where R/W verification determines if kernel load is OK
VECTLOC is where the primary or secondary vector table is located
STEPLOC is where _dT is tested. SIZELOC was used since the contents
of SIZELOC which are either 3 or 7 decode to ABSF instructions
- Removed several unused enumerated MSGS to free up much needed string
space. Was once again getting 'dgroup exceeds 64K' linker error
- For C32 HEX files, the section destination address is used to
determine which STRB space to use. IE bottom two hex are
0x00 Internal
0x60 IOSTRB
0x64 STRB0
0x68 STRB1
- Added following command line switches for controlling the default
Wait state setup for the bus control registers of the C31 and C32.
NOTE:
- NO white spaces are allowed on either side of the '='
- Values are either C style hexidecimal or decimal
- If 'WS=x' command is used for a C31 target, the WS value
will overwrite the WS field as defined in the 'pbuscon=xxxx' field
For a C32 target the 'WS=xx' command is not used for the default
strobe setups, but is used for subsection loads.
ws=3 defines default WS for all strobes
pbuscon=0x1038
-or- p_buscon=0x1038 boot p_buscon value
IOSTRB=0x10F8 boot IOSTRB value
STRB0=0x10F8 boot STRB0 value
STRB1=0x10F8 boot STRB1 value
- Added a getch(); pause in DSK3A to see errors/warnings when the
assembler is run from a batch file or IDE shell.
- Detect and do not load DSK files that did not completely assemble.
All valid files (no errors) end with ">>>> END DSK" string.
- Finished code for two channel AIC swapping (DSK_OSC2.EXE stereo ADC!)
- Added section to describe porting C31-C32 systems
- Vector tables -vs- branch tables
- PAL synchronization of H3 instead of H1
- Hardcoded values passed as elements in symbol table
- Added serial to parallel PAL circuit description to APPHELP.HLP
- Added valid C32 memory ranges to the hard coded memory map of the
C31. Some memory locations will appear to be valid that are not
actually there. (See to do list)
- Added target identification switch to kernel
- Added "C3X.DSK" "C32.DSK" kernel name switch when C32 command line
option is used to select a C32 target system
- Fixed bug in interim 1.20 beta release regarding R0 not updating
in the debugger. The cause was that when the STEP_LOC variable
was added to the kernel, the location being singlestepped was
corrupting R0. Changed STEP_LOC to point to a benign 1 cycle
opcode.
- When the -cr option was used with the C compiler, the FILE2HEX
converter did not substitute the .bss start address for the
beginning of the .cinit section
- Expression analyzer errors that were caused by executing
operators in the wrong order when expressions where nested
within parenthesis of a function have now been fixed. The
implimented fix is a function which scans for parenthesis
and then evaluate each subexpression, replacing the contents
with a temporary variable (foo_var).
.float 32000*sin(($-SinWave)*2*PI/N)
zzz .sdef $-SineWave
.float 32000*sin(zzz*2*PI/N) ; This works
- The symbol table number type and symbol type flags are no longer
hardcoded values. IE INTEGER, FLOAT, AUTO are now enumerated.
However, to compact the symbol table, these types are stored as
characters in the SYM[] structure. If you plan to work on the
SYM[] tables or symbol processing, go into SYMBOLS.H and change
these back to enumerated values to enable type checking by the
compiler. Note however that this will cause the symbol table
size to increase, likely causing a 'DATA GROUP EXCEEDS 64K' error
from the linker. Either temporarily decrease the size of the
symbol storage array, or compile with the huge model. If you
compile with the huge model, be aware that the objects that are
created will NOT be compatible with the other DSK project builds,
the code size of DSK3D will get much larger and will execute
slower. This is because all pointers will be converted to 32 bit
huge pointers.
- Added a switch to the symbol listing to show the contents at a
memory location 'LABEL'. The display is cycled between the value
of the label, hexadecimal contents and floating point (if NUM_TYPE
is FLOAT) by pressing the space bar. A check is also made to make
sure the address does not point to the host port interface address.
- Added a C32 target switch to the DASM_WINDOW routine (SCREEN.CPP)
to force data reads to 32 bits when fetching external program
words to be disassembled.
- Added another variable to the C3X.ASM symbol table to indicate the
starting point of the host port interface. At this time the host
does not use the value of this symbol for any data accesses but it
may be important for C32 support.
- memqxx memory view and edit windows now support fractional Q formats.
The assembler was not affected since this was already supported.
memq15.5 3.1415926 Note: Decimal point is not at a bit boundary
.q15.5 3.1415926
- CPU register window cell edit did not recognize white space characters
and would concatenate fields before conversion 0.5 3e-1 became 0.053
- Wrote a HEX2ROM utility. The utility converts DSK, HEX and OUT files
to INTEL, MOT_S1, MOT_S2, MOT_S3, TEKTRONIX, TI-TAG and ASCII ROM
formats. LS/MS Swapping is supported as well as any combination of
ROMS and ROMWIDTH. This utility will also generate a HEX30.CMD file
that can be used with the COFF tools HEX30 utility. HEX30.CMD was
used to ensure that HEX2ROM output matched HEX30. The user interface
is fully interactive and includes a sample display window showing
how the ROM output will look.
This utility uses a HEX file input and will convert DSK and OUT files
to either C31 or C32 bootable hex files. The C32 options for setting
up the bus control registers are selected on the command line.
At this time, the converter assumes that ROM output is that of a
bootable file, and not a ROM that will be used in uP mode.
- In the symbol listing menu, changed to a curly brace around the
contents of a 'fix label' in sym listing. Also, like the contents
of a float, an integer now displays as decimal and hexadecimal as
the output type is cycled
- Found that the STEPLOC that was being used, though a valid code, was
also changing the value of R0. This only affects the beta version
1.20. The new safe STEPLOC location was set to spin0 (or 4,IE).
This opcode is benign and does not affect the IE since the value
must has bit 0x4 set to run the kernel anyway.
- PUSH/POP of ST register was not required for host receive and transmit
routines in the C3X.ASM kernel. These are functions and not ISRs.
Saved several lines of code.
- XREAD and XWRITE had several lines of common code in the lead-in.
Effectively reused several lines by adding a BUD instruction as shown
R_HOST bud R_HOSTx ; BUD allows reuse of 3 lines of code
W_HOST push AR0 ;1 common
push AR1 ;2 common
push DP ;3 common
ldp HPADDR ; begin non-common code
|| || ;
;====================================================
R_HOSTx ldp HPADDR ; begin non-common code
|| ||
- Changed load of host port address to facilitate porting kernel to the
C30_EVM and other targets. Does require one more memory location, but
made this back in removing ST push/pop and common code overlay.
ldi 0xF000,AR0 ; LDI sign extends to 0xFF000, OK for DSK
ldi @HPADDR,AR0 ; Load from a memory location ok for all
HPADDR .word HP_ADDR ; 32 bit HPA value stored here
- DSK3A Overlay detection did not printf to screen, DSK3A listing output
file was OK. Fixed by turning off quiet (quiet=0).
- Changed DASM of several DForm0 (LSH,ASH,RPTS...) instructions to
disassemble with decimal immediate values rather than hexadecimal.
- Added MEM2 (base 2) memory window format to allow easy bit manipulation
- Added expression analysis editing (F3 key) of memory window values
- Re-compiled all code using Borland C++ 4.51 to locate more potential
porting problems for users who are porting the code to other OS and
platforms. Borland 4.51 identified many new warnings and some errors.
The warning count is now down to 2 warnings during DSK3D build.
- Added BCBUILD.BAT, MKTOOLS.BAT to DSK3SRCE batch build
- Changed *.DOC and *.HLP files to *.TXT file extensions
- Added SFFT.TXT and DSK_WAV.TXT copy to root in BUILDASM.BAT
- Added Freq peak and measure (acurate to 1 hz) to all FFT_xxxx.EXE apps.
- FFT_1024 now works concurrently with MEMVIEW. A non graphics mode
was added otherwise graphics routines like DSK_OSC will halt while
a background task.
- STEPLOC default value was not set properly. Now using INT2 branch
code. INT2 is a better choice than spin0 since spin0 can move with
C3X.ASM versions whereas the INT2 branch is fixed.
- Bumped up version ID to 1.21
- Added instruction promotion where syntax using fewer operands or
abreviated syntax is allowed. Note that the COFF tools recognizes
*AR4% as *AR4. An error or *AR4++(1)% would be a more logical choice
Promotion of MPYF||ADDF to MPYF3||ADDF3 (and similar) was added to
OPCODES2.CPP table but is temporarily disabled (via comment) because
of a DGROUP>64 K linker error. Need to shrink total mem usage again
Original Promoted
-------- --------
CMPI AR4,*AR5 -> CMPI3 AR4,*AR5
LDF *AR4%,R0 -> LDF *AR4,R0
ABSF R0 -> ABSF R0,R0
NEGI R1 -> NEGI R1,R1
MPYF R1,R0,R2 -> MPYF3 R1,R0,R2
RND R1 -> RND R1,R1
MPYF R1,R0,R2 -> MPYF3 R1,R0,R2 ; Currently disabled
|| ADDF *AR1,*AR0,R2 -> || ADDF3 *AR1,*AR0,R2 ; see note
========================================================================
New for version 1.21 9/1/97
========================================================================
- DGROUP > 64 K linker error was resolved by merging common strings.
Next code shrink can be done by specifying an x386/x486 as the minimum
processor, followed by a numeric coprocessor. The last option is to
promote all projects to the HUGE memory model.
- DSK functions and global variables have been extended to be Windows
DLL compatable using the following construct. Basicaly if a DLL or
Windows application is being created, __DSKWINAPP is defined and the
DLLEXTEND keyword expands to include the 'FAR PASCAL _export'
keywords. If Windows is not the target, DLLEXTEND is replaced with
a NULL string. This is currently defined in 'TYPEDEFS.H' which will
probably get changed soon as this is not a logical place to look for
such things.
#ifdef __DSKWINAPP
#define DLLEXTEND FAR PASCAL _export
#else
#define DLLEXTEND
#endif
- The Windows application, currently named 'IMPLCALL.EXE' is essentialy
a glorified memory dump window. However, this window is capable of
displaying data in many formats. The user can enable column information
for displaying the address, symbols, and data either in hex or auto
detect mode depending on the symbol storage type.
A disassembler mode was also added making this application essentialy
capable of showing the same information as the DSK3D disassembly, CPU
register and memory dump windows. Currently cell editing is not
included.
- Added C32 target options to the online documentation
- Added C32 specific lines to the autogenerated HEX30.CMD in HEX2ROM
- Added 'DLLEXTEND' to some additional global variables and functions
for supporting windows applications.
- With the code now reasonably stable, DSK.H is now all inclusive of
all sub header information.
- Renamed Windows application 'IMPLCALL.EXE' to 'CHAINSAW.EXE'
- Added '-byte' support to the HEX2ROM.EXE utility
- Edited SFFT.TXT
- Improved and edited SFFT.ASM. Application now requires fewer setup
parameters. Both REAL and IMAG summation are now included in the
inner SFFT loop calculation. Speed is now 7 cycles/bin if both
REAL and IMAG sums are calculated.
- C level applications now written include simple AIC loop program
'LOOP_C.C', SFFT general application for filtering 'SFFT_C.C' and
host interactive SFFT analyzer/signal generator 'DSK_BODE.C' and
'DSKBODE.CPP'.
- Bumped rev information number up to 1.22
- Worked on all of the source code to make it compatible between DOS and
windows applications. Platforms that can now compile code with no
warnings and errors include Borland 3.1 (all DOS apps), Borland 4.51
(all DOS and all Windows apps), and MicroSoft Visual C (Chainsaw
Windows app only). Porting of the Windows graphical shell for the
FFT/OSC display has not been started yet.
Note that the code is somewhat cabagged (not pretty) and includes
'#if _WIN32' statements in many places for conditional compiling.
_WIN32 is used since it is specific to MSVC and __WIN32 to Borland.
A new #define will be created in the near future to make the operation
of the switch more apparant.
MultiTask protection is temporarily disabled if MSVC is used to build
an application
- Worked on a Borland 4.51 IDE message translator extension for DSK3A.
This translator will filter DSK3A Warning and Error messages for
display in the IDEs message window. By then clicking on a line in
the IDE message box, the IDE will open up the offending file and point
directly to the error. Also plan to retrofit this work to the Borland
3.1 IDE (I prefer this DOS editor over all else!), and MicroSoft
Visual C++ IDE.
- Created a DSKGRAPH.EXE program to graph the memory contents at an
address. Need to add support for LIN-LIN, LIN-LOG, LOG_LIN, LOG-LOG
graphing, file load/boot run functions.
TO DO
-----
- When 'reset' command is issued from DSK3D, the DASMBGN value is not
used for the dasm window. Not an error?
- Check HEX2ROM Motorola file name extension as M0 (zero)
- Add to FFT/SFFT documents topic that the Impulse response will be
affected by the time of arrival realtive to the window.
- asm patch routine
asm 0x809801 .float (3.14*.01) Works
asm 0x809801 .float (3.1415*.01) Fails
When the line overruns the CMD box length, the expression is assembled
and loaded to DSK memory properly, but the memory window is not updated
- Numeric keypad entry is not working in DSK3D
- XXX .set 1,2 Multiple values should generate an error
- FFT_XXX.EXE programs do not disable_Mtask() before PSTRB=0
This is allowing printer DLL's to see PERR=0, and crash the program
- Add '//' and /* */ style comment operators
- By using the expression analyzer, or patch assembler, to edit each cell
of the Windows application, the functionality can be substantialy
extended. Also to consider is adding the 'Load', 'RUN', 'HALT',
'Set BP', 'ANIMATE' and other commands. This way, no matter what cell
is currently being edited can be popped open to be a command line entry
location.
NOTE: The symbol table, expression analyzer and assembler are currently
linked into the DLL but various function calls may need to be
'DLLEXTEND'ed to make this a reality.
- Consider adding the command line commands to the expression analyzer.
By adding to the expression analyzer both expression analysis and command
entry would use a common input function.
- Write seperate functions for detect power and DSK active. Pull out
should make init easier for windows port. Fall back one layer,
passing tokenized messages.
- Look into adding some support for CIO functions like printf. With
little on-chip memory, the DSK solution needs to utilize the host
capabilities for these kinds of functions as much as posible. For
example, the printf() must display the resulting string to the host
box, so why not call the printf() function that comes with the host
compiler.
Note: This approach does not solve the need of the customer when it
comes to the DSP connecting directly to a console. In this case a
full blown string format parser/analyzer would be required. The DSK
memory is simply too small for this. See the COFF level tools for
a solution for this.
- Frequency counter, DSK_FREQ.EXE. To measure a high frequency, run TIM0
from DSP clock (can also be external), and TIM1 from the clock pulse
rate to be measured. The ratio TIM0/TIM1 can then be calculated from
the count of the two timers.
T1 = T0 * ((T1new-T1old)/(T0new-T0new)); // T0 is a known constant
At low frequencies the best solution is to count CPU counts between
events. However, to remove phase jitter, many samples may be
required.
- Modify SFFT.ASM to be used as a graphic equalizer. Essentialy go
through the Fbins and multiply by a magnitude value before
reconstruction.
- Added a C30_EVM option to the possible TARGET definitions. The low
level driver modifications are not quite finished yet. Will primarily
affect DRIVER.CPP.
- Add C32 extension information to online help
- Add an editor to the symbol listing to allow modification of
variables and contents of memory locations. LIkely implimentation
will be similar to the command line ASM patch.
- When running to a breakpoint, a singlestep operation occurs that
causes background ISRs to run.
- Make memory map user defineable, currently hardcoded.
- File loading forces some registers back to the 'reset' state which
may be causing boot trouble or overwrites of the previous state.
IE IF,IE, ST are cleared
- Verify ver 5.0 COFF support
- add MMR dump commands that break out individual bit fields (modify?)
This could be done as an external application to DSK3D.
- Add DSK2HEX and COFF2HEX file conversion to LOADPROM utility.
Currently use DSK3LOAD utility which has the converter built in.
- Find reason for not being able to debug in LOWPOWER mode.
Do not recall earlier version not working... Timeout?
- Add mapoff command
- add EEPROM page write ability to LOADPROM.EXE to make loads of
large files faster.
KEL 7/28/97