Installing the E2920 software ================================= - You can install the software package for Windows NT 3.51, Windows 95 and MS-DOS. - Download the archived version for WINNT, WIN95 or DOS, respectively. - Unpack the archive using the command 'pkunzip -d e2920???.zip' (The '-d' option restores the original directory structure) - If you have unpacked the archive on the system where you want to install the software, just run SETUP.EXE from the DISK1 directory. Otherwise copy the contents of the directories DISK1, DISK2, ..., DISKn onto n floppy disks and run SETUP.EXE on DISK1 on the target system - For DOS: read the file README.TXT and follow the instructions there. !! Attention !! Before installing the E2920 software under a Windows system, make sure you have removed a previously installed version by using the UNINSTALL feature ! Otherwise some undesired side effects may happen. Under Windows 95, no "Uninstall" icon will be created. Use the "Add/Remove Programms" feature of Windows 95 instead. Building your own application using the C-API and DLLs ========================================================== - Normally, you should use the DLL concept for building your own BEST2 applications. In the BIN directory you find the appropriated DLL (CAPINT.DLL for Windows NT, CAPI95.DLL for Windows 95). Please make sure the DLL is present in your application directory or in some other directory, which is specified in the %PATH% variable. - For building your C program, add the CAPI\INCLUDE path to the includes search path of your compiler. There can be found all types and function prototypes of the DLL. The file MINI_API.H includes all other necessary include files, so simply include this file into your application code. - Link your program together with the shipped import library in the CAPI\LIB directory. For Windows NT it is named CAPI32.LIB, for Windows 95 it is CAPI95.LIB. Limitations and known bugs ============================== - The RS232 driver has no baudrate autodetect feature, and the C-API expects the board running with 9600 Baud while checking the connection during the BestOpen C-API call. So make sure the card is set up to 9600 Baud while doing BestOpen, otherwise BestOpen will fail. - Resetting the card (by BestBoardReset() or reset switch) always sets the board baudrate to 9600. If you run with a different baudrate, always use the BestRS232BaudRateSet() function to switch to 9600 before resetting the board. Otherwise you are not able to re-connect afterwards. The BestClose() call sets the baudrate back to 9600 Baud automatically. - If you are using the Fast Host Interface Kit (E2925A #Opt 002) and the parallel cable is not connected to the BEST2 board, then the BestOpen call may hang (due to a floating signal in the Parallel interface card). In this case either connect the board to the interface card or terminate the application and choose the correct port after restarting. - If you are using Windows 95 in conjunction with the Fast Host Interface Kit (E2925A #Opt 002) some systems had problems having the Hardware Dongle and the Centronics cable connected to the same port. If you experience these problems try to connect the Dongle to the ordinary printer port (usually LPT1) and connect the Centronics cable to the interface card (usually LPT2). - We strongly recommend to use the Fast Host Interface Kit (E2925A #Opt 002) if you want to work with the Transaction Lister with a reasonable speed. Waveform display and Bus Cycle Lister are ok even with a slow RS232 connection, but the Transaction Lister might need to scan the entire Trace- memory in order to display all transactions and this can take a while. - If you are using Windows 95 the file picker for saving a file shows a button 'open' instead of 'save' or 'ok'. This button initiates a save and not an open in contrary to his wording. ##############################################################################