2 Getting started 2.1 ZXSIM files --------------- The ZXSIM 1.30 program package consists of the following files: UNPACK.DOC quick reference ZXSIM.EXE the executable simulation program loader ZXOVL.EXE the executable simulation program ZXSIM.HLP the online help file ZXSIM.CFG the configuration file, updated by executing ZXSIM ZXSIM.DOC printable ZXSIM manual (this manual) STAR.DRV a printer driver, originally for the STAR NL10 (probably for all EPSON compatible printers with 8/9 needles) NEC_MD.DRV medium density 24 needles NEC printer driver NEC_HD.DRV high density 24 needles NEC printer driver CGA.BGI video display driver CGA display ATT.BGI ,, AT&T display EGAVGA.BGI ,, EGA or VGA display HERC.BGI ,, Hercules display PC3270.BGI ,, Philips PC3270 display IBM8514 ,, IBM 8514 display SERVO.MDL example model servo system MASSSPR.MDL ,, mass-spring system EBERS-M.MDL ,, Ebers-Moll transistor Ic/Vce curves PENDULUM.MDL ,, swinging physical pendulum BALL.MDL ,, bouncing ball, showing DDT- and REL-blocks PHYSBE.MDL ,, physiological blood circulation benchmark model FIOTEST.MDL ,, time response first order function PIDTEST.MDL ,, time response PID-controller PULSEGEN.MDL ,, pulse generator using FNC-block SAWTOOTH.MDL ,, sawtooth generator using FIX-block UPDWNCTR.MDL ,, digital up-down decade counter LISSAJS.MDL ,, lissajous diagram demonstration FFTDEMO.MDL ,, Fast Fourier Transform demonstration model WINDOW.MDL ,, demonstration of FFT-windowing function FIR.MDL ,, transversal finite impulse response filter IIR.MDL ,, recursive infinite impulse response filter CON-DIS.MDL ,, sampled continuous waveform, discretely filtered (FIR) and reconstructed again RESAMPLE.MDL ,, discrete system resampling 1.25 x Fs by interpolating, filtering and decimation FILTER.MDL ,, separate FIR filter of the resampling model; the filterparameters reside in the import file FILTER.IMP FILTER.IMP ,, import file containing filter parameters for resampling model and corresponding filter QUANTEST.MDL ,, shows quantisation methods and relation of word length (bits) with overflow limits OVERFLOW.MDL ,, shows overflow methods for quantised values - 3 - 2.2 Installation procedure -------------------------- The program runs on any XT or AT IBM compatible personal computer with 640K of RAM (at least 490K free) and equipped with a standard graphics display. For the simulation of large models and Fourier analysis at least a 386 or even better a 486 or Pentium AT-compatible computer with a fast hard disk (more than 7.5Mbyte free) is recommended to get acceptable response times. If you are updating an older version (1.20), first delete all existing ZXSIM program files and supporting files in the program directory. Before startup all above mentioned files, except the model example files, should be placed into the program directory. This directory can be freely choosen; a proper choice would be C:\ZXSIM. For that case the command sequence to install the package onto the hard disk is: >C: >MD \ZXSIM >CD \ZXSIM >A:\ZXSIM13\UNPACK Be sure to append the ZXSIM program directory to the DOS search path, using the PATH command, e.g. in AUTOEXEC.BAT. You may now delete all unused video driver files (.BGI). Unpack the example model files by making the desired target directory current and enter the command: A:\ZXSIM13\MODELS 2.3 Starting ZXSIM ------------------ ZXSIM is started by typing the command ZXSIM at the MS-DOS prompt, optionally followed by the model file name, with or without the default model extension .MDL. After startup ZXSIM initializes variables, loads the configuration file and the printer driver, checks the amount of memory and finally clears the graphic video display buffer and the printer buffer. If insufficient memory is reported the program is aborted. After this initialisation procedure a model is loaded if specified on the command line. If while starting up ZXSIM can't find the config file, or the config file version number is incorrect, default configuration settings are being used. Graphics printing will be disabled in that case, as no printer driver is specified. During the first time ZXSIM is being started up, the program must be configured for your specific computer system. This procedure concerns mainly the printer driver, see par. 2.5. - 4 - 2.4 The pull down menus ----------------------- After startup the main menu comes up with the leftmost FILE pull-down menu. With the <- or -> cursor keys you can select another pull down menu. A command can be activated by typing the character which is in uppercase in the name of the command in the pulled down menu, or by using the up and down cursor keys and then by striking the ENTER key if the desired option is being highlighted. Some of the commands can be reached immediately by means of the function keys or Alt keys: F1: HELP Alt B: toggle beep mode F2: SAVE Alt D: toggle dxf mode F3: LOAD Alt H: toggle hpgl mode F5: EDIT Alt P: toggle printer mode F7: TIMING Alt R: toggle refresh crt.mode F9: SIMULATE to video screen Alt X: leave ZXSIM F10: FOURIER analysis From any selected command or any model editor action an escape is possible with the ESCAPE key. 2.5 Configuring ZXSIM --------------------- The configuration is modified by selecting the OPTIONS pull down menu. Having completed the configuration procedure the current settings are stored in the file ZXSIM.CFG upon exiting ZXSIM. Configuring the printer. After selecting the options pull down menu 'Load prt driver' can be selected if already a printer driver resides in the current directory. Only three example printer drivers (8-needle STAR and medium or high density 24-needle NEC printers) are available in this package (files STAR.DRV, NEC_MD.DRV and NEC_HD.DRV). If your printer is not compatible with any of these you should select 'Install printer' in the options pull down menu, and answer the questions. All codes must be entered in decimal format, just enter the demanded sequences of control codes, separated by spaces or commas. The maximum number of codes per sequence is 20. Consult your printer manual for the expected code sequences for any of the below printer commands. - 5 - Printer file name: File name for the printer driver control codes to switch from wide to small characters: Codes your printer expects to switch from wide to normal text (10 CPI standard font). control codes to switch from small to wide text size: Codes your printer expects to switch from normal to double width text mode. control codes to set graphic mode: codes to be sent to your printer for every graphic line. For most printers this includes the number of dots on the graphic print line (which is the vertical axis in the ZXSIM plot). control codes to select text new line spacing: codes to be sent to the printer to set the correct line spacing for a new line whilst printing text. control codes to select graphic new line spacing: codes to be sent to the printer to set the correct line spacing for a new line whilst printing graphics. control codes to reset printer: codes that reset the printer. For most of the printers this should be 27 followed by 64. control codes for a form feed: Codes upon which the printer feeds to the next page. For most printers this should be 12. number of needles: number of used needles of the printers print head. This should equal 8, 12 or 24. Note: for 12 (medium density) a 24-needle printer is needed. number of dots on a graphic print line (along vertical plot axis): On most printer the codes to set a printer in graphics mode also helds the number of graphic bytes which must be printed on that graphic line. The number of dots on a graphic line must be the same. The maximum is 600 dots. number of dots in horizontal direction: The plot is printed 90 degrees rotated. Along the horizontal axis the time or frequency scale is plotted with a maximum of 800 dots. This corresponds with the number of vertically printed dot lines. At this point you are ready now to enter your first model or to simulate one of the supplied example models. 2.6 Model compatibility ----------------------- Version 1.30 is capable of reading models created by version 1.20, not of earlier versions. The reverse is not possible. - 6 -