------------------------------------------------------------------------ HDLGen (c) 2000 by Eduardo Augusto Bezerra, version 0.1beta, 28/02/2000. It is free for non-commercial use. ------------------------------------------------------------------------ This directory contains HDL Generator (HDLGen), which is a tool to guide VHDL designers in the task of creating synthesizable VHDL programs (template files). ------------------------------------------------------------------------ USER IDENTIFICATION Please, fill in the following fields before proceeding. A personal password to open some of the files will be sent to the email address given. Name: Email: Organization: Country: ------------------------------------------------------------------------ DOWNLOAD HDLGen.zip (or download from UK) HDLGen v. 0.1beta (java class files only). VHDLparser v. 0.1.4 by Christoph VHDLparser.zip (or download from UK) Grimm (modified by Eduardo Bezerra in Jan. 2000). HDLLib is a library of VHDL source HDLLib.zip (or download from UK) files, written following VHDL for synthesis standards. index.html (or download from UK) This file. index.txt (or download from UK) Text version of this file. The Java Runtime Environment (JRE) JRE for Linux (or download from UK) for Linux. Download it only if you do not have a JRE installed in your computer. The Java Runtime Environment (JRE) JRE for Solaris for Solaris. Download it only if you do not have a JRE installed in your computer. The Java Runtime Environment (JRE) JRE for Windows (or download from for Windows. Download it only if you UK) do not have a JRE installed in your computer. Compilation of guides and manuals VHDL for synthesis documentation (or with standards to be followed in download from UK) order to develop synthesizable VHDL programs. ------------------------------------------------------------------------ HOW TO INSTALL AND RUN IT 1. Download HDLGen.zip and VHDLparser.zip. In order to have examples of synthesizable VHDL programs, it may be interesting to download HDLLib.zip. 2. Create an empty directory (proj1, for example). 3. Go to the new directory and create two sub-directories: HDLGen, and VHDLparser (both are case sensitive). 4. Go to the new directory HDLGen and unzip the file HDLGen.zip. 5. Go to the new directory VHDLparser and unzip the file VHDLparser.zip. 6. Include the directory's path (e.g. proj1) to the CLASSPATH environment variable (See the section below for details on how to set up this variable). 7. Create a directory called HDLLib (in any place) and unzip the file HDLLib into it. 8. Go to the HDLGen directory and run HDLGen: java HDLGen (If you do not have Java installed in your computer, please see the "Getting the Java Runtime Environment" section below). ------------------------------------------------------------------------ HOW TO SET UP THE CLASSPATH VARIABLE * Unix users: Assuming the use of Korn Shell, just add the line below to the .profile file: CLASSPATH=/home/eduardob/proj1:$CLASSPATH; export CLASSPATH In this case the files were unzipped to the proj1 directory, and the user's home is /home/eduardob * Windows-NT users: If the files were unzipped, for example, into the directory \users\eduardo\proj1\ then the path to be added to the CLASSPATH variable should be: \users\eduardo\proj1\ In the "Control Panel", run the "System" program. Select the fold "Environment" and fill in the field "Variable" with the world CLASSPATH, and the field "Value" with the path for the directory where HDLGen and VHDLparser were placed. If the CLASSPATH variable is already on the list of environment variables, then just click on it, and add the new path to the end of the list of paths for this variable. In short: Variable: CLASSPATH Value: e:\users\eduardo\proj1\ * Windows'95 and Windows'98 users: Add the lines below to the autoexec.bat file, replacing the two occurrences of %1 by the path where HDLGen is installed. For example, if HDLGen is located at e:\users\eduardo\proj1\ then %1 must be replaced by e:\users\eduardo\proj1\ @echo off echo **************** echo setup for HDLGen echo **************** if DEFINED CLASSPATH goto var_found goto var_not_found :var_found set CLASSPATH=%1;%CLASSPATH% goto end_setup :var_not_found set CLASSPATH=%1 :end_setup WARNING!!! THIS SOLUTION HAS NOT BEEN TESTED. IF YOU HAVE ANY PROBLEM RUNNING HDLGen UNDER Windows'95 or Windows'98 SYSTEMS, PLEASE SEND ME AN E-MAIL. ------------------------------------------------------------------------ GETTING THE JAVA RUNTIME ENVIRONMENT The Java Runtime Environment (JRE) is free and versions for Windows and Linux are available at: http://www.sussex.ac.uk/~tapu9/download/java More details about JRE and other versions can be found and downloaded from Sun's web site: Windows version http://java.sun.com/products/jdk/1.2/jre/download-windows.html US English version of Java 2 Runtime Environment (~6MB) Internationalized version of Java 2 Runtime Environment (~8MB) Solaris version http://www.sun.com/software/solaris/jre/download.html Linux version http://java.sun.com/products/jdk/1.2/jre/download-linux.html US English version of Java 2 Runtime Environment for Linux (~12MB) ------------------------------------------------------------------------ The Java source code of HDLGen will be available as soon as possible. The class files were generated by using java version "1.2.2" Classic VM (build JDK-1.2.2-001, native threads, symcjit). ------------------------------------------------------------------------ BUG REPORTS Please send comments and bug reports to: E.A.Bezerra@sussex.ac.uk or eduardob@inf.pucrs.br ------------------------------------------------------------------------ !!!!!!!!!!! NO WARRANTY !!!!!!!!!!! HDLGen is still under development! ------------------------------------------------------------------------ Contact addresses 1. Address (Department of Electrical Engineering at UFSC, Florianopolis, SC, Brazil): Eduardo Augusto Bezerra Universidade Federal de Santa Catarina, UFSC Departamento de Engenharia Elétrica, CTC Campus Trindade CEP 88.040-900 Florianopolis, SC, BRAZIL 2. Phone numbers: +55 (48) 3721 2359 – GSE/LCS/EEL/CTC/UFSC +55 (48) 3721 9506 – EEL/CTC/UFSC +55 (48) 3721 9516 – LISHA/INE/CTC/UFSC 3. Fax number: +55 (48) 3721 9280 – EEL/CTC/UFSC 4. Email addresses: Eduardo.Bezerra @ ufsc.br