--------------------------------------------------------- | TMS320C31 DSK RELEASE NOTES FOR VERSION 1.1x SOFTWARE | --------------------------------------------------------- NOTICE ------ >>> To install the DSK3 software you can now run INSTALL.BAT This batch file will create the directory C:\DSKTOOLS if it does not already exist. Additional subdirectories will be created for automated build and maintenance of DSK projects. INSTALL.BAT Creates the following directories C:\DSKTOOLS DSK Debugger, Assembler and Applications C:\DSKTOOLS\DSK3APPS Applications source, ASM backup C:\DSKTOOLS\COMMON Source files that are common to most projects C:\DSKTOOLS\PROJECT Borland C++ 3.1 project files >>> THE INSTALLATION PROCESS DESCRIBED IN THE C3X DSK USERS GUIDE DOES NOT COVER THE USE OF A INSTALLATION BATCH PROCESS CONTENTS -------- C3x DSKTOOLS INSTALLATION BATCH FILE BUILDASM.BAT CUSTOM INSTALLATION PATH STATEMENTS DSK3A ASSEMBLER DSK3D DEBUGGER APPLICATION (DEMO) SOFTWARE BORLAND C++ VER 3.1 PROJECTS ** SHAREWARE SVGA GRAPHICS DRIVER ** PLEASE READ NOTICE! C3x DSKTOOLS INSTALLATION BATCH FILE ------------------------------------ The INSTALL.BAT batch file automatically creates C:\DSKTOOLS\ and all of the associated subdirectories. If you do not want this directory to be created the batch file can be exited by pressing CTRL-C or specifying a drive which does not exist. Depending on your PC's speed this can take several minutes. INSTALL.BAT will only install DSKTOOLS in drives C-I BUILDASM.BAT ------------ This batch file is used to copy the DSK application assembly files to the DSK tools directory and then assembles them. BUILDASM expects to find the DSK3APPS directory as a subdirectory so it should be called from the tools directory. C:\DSKTOOLS\BUILDASM ... run BUILDASM from the tools directory CUSTOM INSTALLATION ------------------- To install the C3x DSK tools to a directory of your choice, first copy DSK31xx.EXE is a self extracting file that will create the proper directories when you use the -d option. To see the self expander options use a '?' for the option. Step 1) Make the directory you want the tools to go into Step 2) Copy all files to this directory Step 3) Run DSK31xx.EXE (version 1.10 or later) file with the -d option Step 4) Run BUILDASM.BAT to recreate the DSK application files MD C:\MYDIR ... make the directory CD C:\MYDIR ... change to the directory COPY A:*.* ... copy all files C:\MYDIR\DSK3111 -d ... will extract all files and directories C:\MYDIR\BUILDASM ... builds DSK application files PATH STATEMENTS --------------- Note: Your PC's PATH will NOT be changed by the installation batch file ----------------------------------------------------------------------- If you want you can add the DSKTOOLS directory to your path making it easier to call the DSK debugger and assembler. However please be aware of the following DSK3A ASSEMBLER --------------- DSK3A does not need any support files so it can be run from any directory in the current path DSK3D DEBUGGER -------------- DSK3D can find the C3X.DSK communications kernel from the DSK3D startup path but does use the current path to find applications. In other words the startup path is not searched for applications. You can however specify the full path name at the command prompt while loading an application. APPLICATION (DEMO) SOFTWARE --------------------------- Like the debugger application code examples will initialize the DSK communications from a remote startup path but are unable to load the applications *.DSK software except from the local directory. In other words the comm kernel will initialize, but the application load procedure will fail. For applications to run properly the applications *.DSK file must be in the same directory. BORLAND C++ VER 3.1 PROJECTS ---------------------------- The project build files used to create the DSK3 applications are also included in the \PROJECT subdirectory. To use these files you will need to copy them to the \DSKTOOLS directory or change the compiler include directories to match the installation path. If your compiler cannot read Borland project files, read the message at the top of each application. You will find a list of code modules that need to be compiled and linked into the project. Source code compatibility with other compiler vendors was NOT checked. Since the majority of the code follows standard C programming practices and there are no external libraries required, porting this code to other compilers and platforms should be relatively easy. NOTE: Borland C++ 4.0 (later?) will load and convert version 3.1 projects. Be sure to select version 3.1 in the Project Open dialog box and then make sure the application type is Standard DOS EXE SVGA GRAPHICS ------------- The SVGA256.BGI driver used in some DSK applications is a shareware program from Jordon Hargraphix Software. The following notice will appear if the driver is not found. This application requires an SVGA 640x480x256 color BGI driver. The driver used to develop this application (SVGA256.BGI) is a shareware graphics driver available from Jordon Hargraphix Software. The latest version can be downloaded from America On Line (AOL) at the following FTP site. Note that the last two numbers are the revision of the drivers and therefor may differ. ftp://mirrors.aol.com/pub/simtelnet/msdos/borland/svgabg55.zip SVGABG55.ZIP - Super VGA/Tweaked VGA BGI drivers Jordon Hargraphix Software NOTE: Shareware code which periodically needs updating or requires a license agreement is NOT kept on the TI BBS or Internet FTP site for download. TI will not provide this for you. You will need to download these files for yourself KEL 08/05/96 ==============================================================================