QUILT 1.0 - Information Manual -------------------------------- CONTENTS -------- 1) License 2) Introduction 3) Installation 4) Using QUILT 5) Contact (E-mailing list) 6) References LICENSE ------- LICENSE TERMS Copyright (c)2005 Gregory J. Briggs, Edwin J. Tan, Nicholas A. Nelson and David H. Albonesi. All rights reserved. Permission is hereby granted, without written agreement and without license or royalty fees, to use, copy, modify, and distribute this software and its documentation for any purpose, provided that the above copyright notice and the following four paragraphs appear in all copies of this software, whether in binary form or not. IN NO EVENT SHALL THE AUTHORS, THE UNIVERSITY OF ROCHESTER, CORNELL UNIVERSITY, OR THE STATE OF NEW YORK BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THEY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THE AUTHORS, THE UNIVERSITY OF ROCHESTER, CORNELL UNIVERSITY AND THE STATE OF NEW YORK SPECIFICALLY DISCLAIM ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE AUTHORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. NEITHER THE NAME OF ANY NEW YORK ENTITY NOR THE NAMES OF THE CONTRIBUTORS MAY BE USED TO ENDORSE OR PROMOTE PRODUCTS DERIVED FROM THIS SOFTWARE WITHOUT SPECIFIC PRIOR WRITTEN PERMISSION. If you use this software or a modified version of it, please cite the following paper(s): G. J. Briggs, E. J. Tan, N. A. Nelson and D. H. Albonesi, "QUILT: A GUI-based Integrated Circuit Floorplanning Environment for Computer Architecture Research and Education", In Workshop on Computer Architecture Education, pp. 26-31, Jun 2005. INTRODUCTION ------------ QUILT is a floorplanning tool and circuit performance estimator developed at the University of Rochester. It can also create floorplan coordinates used by the HotSpot thermal modeling infrastructure. It is written in Java. The tool can be downloaded from http://www.ece.rochester.edu/research/acal/quilt INSTALLATION ------------ 1. Download the QUILT Java JAR (quilt-1.0.jar) following the instructions at http://www.ece.rochester.edu/research/acal/quilt 2. This is a standard Java JAR file. The minimum requirement is Sun Java version 1.4.2. In many cases you can just double click it to execute it, or use popular decompression software to extract the source code from it. In Unix: java -jar quilt-1.0.jar In Windows: javaw -jar quilt-1.0.jar 3. Change the file association for JAR files to do this automatically. USING QUILT ----------- QUILT is a standalone Java application. The main function of the tool is to generate an input text file for a simulator while viewing or editing a graphical representation of the IC floorplan in a GUI. The tool was tested with a simulator based on SimpleScalar 3.0b with Wattch and HotSpot extensions. QUILT reads and writes HotSpot floorplan coordinate text files, and also colorizes the floorplan based on power or temperature trace files. The tool can be started from the command line and an existing floorplan file can be specified as a command line option, or it can be given a shortcut icon and associated with .flp files similar to most GUI programs. In addition to a text-based coordinate file, QUILT leverages Java's capability to generate JPEG files to produce layout images that can be used in documents. QUILT requires various parameters for the technology node of interest. For our research with QUILT, we obtained these from the 2003 ITRS Roadmap. Changing to a different node is a simple matter of replacing some constants with the desired node's "Roadmap" values. In order to obtain a proper understanding of the working of QUILT, the user is urged to refer to the WCAE paper [1] before proceeding to further sections of this manual. 1. Editing There are three editing modes: - Moving units (translation) - Resizing units (holding area constant) - Resizing units (only moving the requested edge) To perform an edit, click a unit near the edge of interest. Then, right click at the location where you would like that edge to be moved to. It will always "snap to" the nearest pre-existing edge, to help you with alignment. 2. Graphics for Publications a. Exploded 'zoom effect' view i. Open multicore *.flp file using "Open..." in File drop-down menu ii. Identify which of the cores you want to be 'zooming in' toward iii. Use Shift key to select all four corners of that core iv. Choose "Use selection as the zoom-from area" in Graphics drop-down menu v. Choose "Open for zoom effect..." in Graphics drop-down menu vi. Select the singlecore *.flp file from the folder vii. Export graphic as *.jpg if required 3. Recompiling The source code and Makefile is contained within the JAR file. To recompile, just type "make". 4. Miscellaneous There is a HotSpot connector that will run off of temperature traces, but right now the paths are fixed. Hotspot must be in the subdirectory "HotSpot-2.0". HotSpot's sim-template must read a file called 'ev6.flp', which it does. Once it works, it will color your floorplan by temperature. CONTACT (E-MAILING LIST) ------------------------ QUILT can be downloaded following the instructions at http://www.ece.rochester.edu/research/acal/quilt. In order to exchange comments, questions and answers amidst the users of QUILT, we have created an e-mailing list. We will try to monitor this list and respond to questions as quickly as possible. REFERENCES ---------- [1] G. J. Briggs, E. J. Tan, N. A. Nelson and D. H. Albonesi, "QUILT: A GUI-based Integrated Circuit Floorplanning Environment for Computer Architecture Research and Education", In Workshop on Computer Architecture Education, pp. 26-31, Jun 2005.