chipndale11.tioga
For Internal Xerox Use Only — DRAFT
 Chipndale -- The Toy
A tentative introduction to the soon-to-be-indispensible tool
Chipndale, son of Chipmonk, known as "Chipndale" to its friends, is an interactive graphic layout tool made to run in Cedar. The Cedar environment allows Chipndale to make use of multiple windows, extensive parallel processing, vast amounts of memory, pop-up menus, and other assorted goodies. When complete, Chipndale will have a DRC and circuit extractor, a fast set of IO and checkplot routines, and modular device extensibility. What's more, everything in Chipndale will be completely technology independent, that is, all the features will be equally at home dealing with PC boards or CMOS chips. Such is the dream.
The reality is the substance of this paper. For the nonce, we (the implementors) would like you (the users) to be exposed to the skeletal features of the system -- what a viewer looks like, how to move around in a design, the difference between a terminal monitor and a control panel and so on. We do not, however, expect or even want you to be using Chipndale for new designs; in fact, it is next to impossible to do so right now. The instructions included here will allow you to call up Chipndale, read in old Chipmonk files, scale and rotate the designs, and print them out on the Versatec. You will not be limited by the size or complexity of your designs, but for now they must be in NMOS to be understood. If you are really daring, you can open the file "ChipndaleNmos.tip" and try out some of the commands listed there; the interface has been intentially designed to resemble Chipmonk. But nothing is guaranteed save the commands presented here. The moral of the story is:
The ice you are skating on is currently under development; it is apt to be thin in places.
An example of a thin spot is the fact that as of the moment, text is not read in from old Chipmonk files. So if there are pieces of your file missing, this may be the reason. Don't get mad, get even; that is, if you are miffed at these and other shorcomings, send us mail (ChipndaleImplementors^.pa or ChipndaleDiscussion^.pa). We won't know about it unless you tell us.
Saying Hello
Go find yourself a Dorado running Cedar 5.o and login. Use the DF Tool to bringover the file
[indigo]<chipndale>top>cddesign.df
Now the machine is equipped with all the information it needs to run the NMOS (CMOS) version of Chipndale with the Versatec plotting routine. If you cannot find a Dorado, don't know how to login, or generally have trouble with any of the commands, ask a nearby Dorado-user to help you out. They don't usually bite.
Becoming Acquainted
To get a Chipmonk design to play with, start up this session of Chipndale with the incantation:
%CDReadCMNMOS <optional name of design file> or
%CDReadCMCMOS <optional name of design file>
(which to the uninitiated means
ChipnDaleReadChipMonkNMOS and ChipnDaleReadChipMonkCMOS.
But its really simple, to read in good chipndale files type only CDRead)
This command will call up the Chipndale Terminal monitor (hereafter referred to as "Terminal") and will initialize the plotting module. Terminal keeps a log of all the commands issued concerning Chipndale; it is where you will look to find information about what Chipndale is trying to execute and how that execution is progressing.
It is important to know what technology the chip was designed in when you are reading Chipmonk files (the Chipndale design files know their technology). If no filename was given to the command, Terminal will respond with the request:
Input file >
Type it in at the prompt. The file may either be present locally or on one of the file servers; default is a ".chip" file. For example, you could read in a file as:
/ivy/monier/aspen
or as
aspen.chip
if it was already on the local disk. You need not type in the extension.
If all is going well, the file will be read in and a Chipndale viewer containing the design will be opened on the screen. You will also notice a control panel appear in the lower right of the screen. Functionally similar to the buttons available at the bottom of the Chipmonk screen, the description of the panel's use is reserved for a more comprehensive manual.
Making Friends
Moving Around in the Viewer
There are several methods for moving in the viewer: changing scale, changing position, and changing orientation.
Using the V-(middle click) pop-up menu allows you to scope in and out of the design quickly (quickshrink/quickgrow) or incrementally (shrink/grow). Another way to change scale is to use "<" to grow and ">" to shrink the design.
Once you have the range where you want it, it is time to move the viewer over the portion of the design you are interested in. To use the move command, while holding down the space bar, move the cursor with the middle button down. A line will be continuously traced from the starting cursor position to the current one. When you release the mouse button, the viewer will move in proportion to that vector.
If you can see the general area you want to be in the viewer, draw a rectangle around it with the left button while the space bar is down. The selected portion of the design will replace the current area in the viewer.
WARNING: Don't type commands ahead for scaling or moving on the color screen or Chipndale will crash.
Rotating the Design
In order to rotate the design 90#clockwise, select the entire layout with (Space Bar)-A. Now indicate a rotation with CTRL-R. The design will be rotated keeping the upper left corner fixed. As long as the design is selected, hitting more CTRL-R's will continue the rotation. You can remove the selection by holding down "C" and right-clicking the mouse.
This command is useful in conjunction with the plotting routine.
Printing on the Versatec
Run the vplot module by "run vplot" in the user exec, or have it run by the "Chipndale.RunPrograms" userprofile option.
Manipulate the design in the viewer so that you can see the entire amount of information you want to print. Hold down TAB-V, and with the left button down, draw a rectangle containing that part of the design that you want to come out on paper. When you release the button, Terminal will ask you to select the number of strips you want the design to be printed on (for all you VLSI wallpaper fans). A new viewer will appear, showing the middle of the horizontal stripe currently under consideration. An arrow pointing to the design will show you how far the transfer has progressed. After the transfer is complete, the connection to the Alto will be closed and the Trident file "plot.bits" will be printed on the Versatec. This routine should not break even on large and complex designs.
Using the Color Display
Chipndale also uses the color screen as a viewer. Type the command
%cdcolor
to enable the display.
================================================================
New commands

<space>-mark shows the selected Rect on an OTHER viewer
<space>-select shows the selected Rect on an this viewer
<space>-draw moves this viewer

< grows the design (see more detail on smaller part)
> shrinks the design (see more in less detail)
/ shows positions of other viewers
For Wizards Only:
-- In cmos only: CDPattern reads in a pattern file of chipmonk, specify which by using the userprofile.
-- CDColorMap reads in a chipmonk colormap
================================================================
for more documentation see [indigo]<chipndale>top>CDDoc.df
for userprofile options see [indigo]<chipndale>documentation>chipndale.profile