File:CedarThymeDoc.tiogaCopyright(C)1984byXeroxCorporation.Allrightsreserved.LastEditedby:SChen,August14,198412:57:27pmPDT--IFyouarereadingthisdocumentationonline,youmightwanttomakeuseoftheTiogaLevelscommandstoseedifferentlevelsoftexts.A.CedarThyme1-2-31.BringOver[Cherry]Cedar5.2>Top>Thyme.dfBringOverwithpublicaccess.ThiswillgiveyouallthefilesnecessarytorunThyme,includingallthefonts,allthesupportingpackages,anexample(CMOSInverter.thy)anditssampleoutputs,...etc.ItisconsideredagoodpracticetosetworkingdirectoryproperlybeforerunningThyme.///Thyme/issuggestedbutnotrequired.2.UserProfileThymecurrentlyexpects8bitsperpointonyourcolormonitor.Tosetyourcolormonitorproperly(onceandforall),justputthefollowinglinesinyouruserprofileiftheyarenotthereyet:ColorDisplay.Side:left--orright,ifyoulike.ColorDisplay.BitsPerPoint:8ColorDisplay.Type:640x480--or1024x768,dependingonyourmonitor.3.LoadandRunTypethymeintheCommandTool(afterbringingover),andaThymeviewerwillbecreated.Giveityourinputfilename(say,CMOSInverter)andclickRun.Itwillgoforit.Youmaysimulateanothercircuitsusingthesameviewerwhenthepreviousruniscompleted.JustchangetheinputfilenameandclickRun.TypingthymeintheCommandToolagainwillcreateanotherThymeviewer,whichshouldbeabletosimulateanothercircuitconcurrently.B.User'sGuide1.ThymeManualIfyouhavn'tgotacopyofthemanualforThymewrittenbyRichBarth,printoutacopyof/Cherry/Thyme/Top/ThymeManual.pressandreadit.ItgivesyoualotmoreinformationabouthowThymeworksandhowtouseit.SincetheThymeManualwaswrittenwhenCedarThymewasnotavailable,afewplaceswouldneedsomemodificationtobeapplicabletoCedarThyme.Thislittlep_, g] g)nIa &),[ g!% *,qX g N5 %w'q*t-04E59<=@(V :}4L!%'0S g78PHxrPH$L\/i$R'm*-/14 6= >ARKR\p`!{# *028HI\!osF\m A/# $e&*[/3u6;?E|Dmef]qAfxVr>\ !$' *,/3i9;=A>!m|$(,m.2I6:c<BRD Qm "y$(*.1d48=Sm &*9,05:?am#)-@ q g7odx r\#L "W$)+05C7>:>BDn\g#0x3/6J8|9=e@AFCW\ $(+7.;/2_ wm# "%r*%-169P; AC m" *,W.G 46:@*CDSTVm$2user'sguideiswrittenforthispurpose,i.e.,toserveasasupplementtoThymeManualforusersrunningThymeinCedar.ItisassumedherethatyoualreadyhavesomefamiliaritywiththebasicsoftheCedarenvironment.2.ViewersTheCedarThymetakesadvantageoftheCedarViewerspackageindesigningtheuserinterface.Itmaycreatetwosetsofviewers.TheonecreatedafteryoutypethymeintheCommandToolisthemainviewer(called"Thymeviewer"hereafter).Each"plot"statementinyourinputfilemaycreateadifferenttypeofviewercalled"plotviewer".2.1-Thymeviewer:TheThymeviewerisinitiallycreatedintheiconicstateandlookslikeatoolbox.Onceopened,itwillshowthreeregionsunderthewhiteonblackcaptionbar,asdescribedbelow.2.1.1-ThemenusTherearefourmenusinthisregion,namely,Stop,Run,DumpandNew.TheStopmenuwillabortthesimulationwithoutsavinganything.Sincethisissomewhatdestructive,thebuttonis"guarded"byashortlinesegment,indicatingthatthisbuttonneedsconfirmationtotakeeffect.Ifyouwanttostopthesimulation,youshouldfirstclickatitsothatthelittleguarddisappears;ifyouclickatitagainwhiletheguardhasnotreappeared,thiswillserveasaconfirmationtostopit.TheRunmenusimplystartsthesimulation.TheDumpmenumayabortthesimulationbutalsosavethecalulationthathasbeendonesofar,tobeusedastheinitialconditionofsomelatersimulations.(SeeThymeManualformoredetails.)Thelastmenu,New,maycreateanotherinstanceoftheThymeviewer,whichmaybeusedtosimulateanothercircuitconcurrently--orappeartobeso.2.1.2.-ThemiddleregionTherearefivelinesinthisregion.Theyhavetodowiththeworkingdirectory,theinputfile,theoutputfile,theprogressofsimulation,andthetypescript,respectively.Thefirstlineshowsyourworkingdirectory.(explainedbelowinadifferentparagraph.)Thesecondlineshowsyourinputfilename.Youmayspecifyyourinputfilenamehere.Itisassuminganextensionof".thy"andthehighestversion,sotg/Er_,mCz!-#j& +.;/3q56I =]m "l',U.24n5;j>AR[mA %(+7/.03G7_ qXxrU?\4L |&(+ /$4Z9;KAtCS\ UY [#%'b-&/27t:=fPImL\ j  Z"&7*/ 4o9 @KS\y $_&)-.479g=AI\F]KC\4K#(*.,036x:<=@Af\24!%E* .0o40669>A?\9!9!?rA9!9!5tW55>r5"`%(_ /4#8\>BE?4+ #4%*+q2+4&5P8;2 !P%) 13v6o;<?OB0x !$)+//02369<@/5  $%&*.Q0479 @C- $%(*?tW*?*?Tr{*?*?\#'a) &tW&&Tr& #')) 0A258: A=D %HN "@$1'm)+z/f57>:= s# [!%$r RWt R R r! R R"%).4580<As]$). s66w7B8x Dfm9 #m%+:, 469 m oW/!%.* 0 7g;t=">L yW#&*,1474 &(.#/369=BTVm${3youmayomittheextensionandtheversionnumberifthat'sthecase.Theextensionmaynotbeomittedwhentheversionofthefileisspecified.Thethirdlinewillshowyouroutputfilename(s)automaticallyonceasimulationisstarted.Thefourthlineindicatestheprogressofthesimulation.Duringthesimulation,therewillbeacursorsizedpatternshownupintheblankregionafterthelabel"Progress:".ThepatternsarethesameasthoseemployedbytheAltoThyme.Ifyouwanttoseethedetailedtime/stepinformation,letthe"details:"buttonbeinverted(whiteonblack);otherwise,justclickatthe"details:"buttontotogglethesetting.Thelastlineremindsyouthatmessagesareautomaticallystoredinthetypescriptfilenamed"Thyme.log".YoumayclicktheSaveorResetbuttonstoactonthetypescript.2.1.3-ThetypescriptThisareashowsallthemessagessentoutbyThyme.Thetextsareautomaticallystoredinthefilecalled"Thyme.log".YoumayclearthetypescriptbytheResetbuttonifyouarenotinterestedinwhathasbeenshowninitanymore.YoumaysavethetypescriptbyclickingtheSavebutton;butremembertorenamethisversionofThyme.logfiletoadifferentname,otherwiselaterversionsofThyme.logmayoverwriteit.2.2-Plotviewer:Thefirstplotviewerisalwaysdisplayedonthecolormonitor,whiletherestoftheplotviewers,ifany,arecreatedintheiconicstate.Youmayopentheseiconicviewersanytimeyoulike,evenduringthesimulation.Oncethesimulationiscompleted,theseplotviewersarecompletelyindependentoftheThymeviewer.Eachplotviewerhasthreemenubuttons,namely,SwapBackground,Save,andPress.SwapBackgroundwillswapthebackgroundcolorofthedisplaybetweenblackandwhite.Toavoidtoomuchinkfloatingintheprinter,thebackgroundcoloronhardcopyisalwayswhite.TheSavebuttonwillstoretheplottinginformationintoafile(withthefilenamealreadyshownonthecaptionoftheviewer)forlaterreview.Thefileiswritteninacompactformat,whichrequiresmuchlessspacethanthe.plotfileswiththeAltoThyme.ItispossiblethatsometimeinthefutureitwillgenerateInterpressformattedfiles.ThePressbuttonwillmakeapressfilefortheplot.Youmayprintitthroughtg/Er_,69u &), 057^; =h[h #%'-0379;>d? XWv!!$',W.3 0BKSHW"%(_.;0 9=%>F] 4" +.157~:<@SEID Ag\ >m}!'*-/ 47s:= := CR7zQ"$&(-03#6'8 >@5% ")(*/2a7)8?B$C4,$<%f(-/6i9m?0K-\4 J$*9,?.27;j=@kB$+\5v #$&(,(m| |$~)g,/-148.<> &m l $! (,!.365 =1 E %Im!\ " %+:u0e!!1b r=!!u=!!>rAr!!BNu R\r| R Rtm rP!%n' /Y246;A\m%s\\zzy!g$z&h*p+-13 9@Dm"(@,.2a57;>ACpms!A!#$&*0+A-d1 6;r mtF -r ]!z%.&X),?.|04 7:=>{TVm$4Lilac(incolor),Stinger,orRockNRollusingTSetter.3.OpenPlotYoumayreviewplotssavedfrompreviousThymesimulation,orplotscreatedbysomeotherclientsoftheOpenPlotPackage,bytheOpenPlotcommandintheCommandTool.TheOpenPackageisbroughtoverwhenyoubringoverThyme.AndthiscommandisregisteredautomaticallywhenyouloadThyme.Thecommandshouldterminategracefullyifitfindsthefilenota"plotfile".Ifyouspecifymorethanoneplotfilesinthecommandline,thefirstplotwillbeshownonthecolormonitor,andtherestoftheplotviewerswillbecreatedinitiallyiniconicstate,tobeopenedanytimeyoulike.ThisfacilityissimilartothePlotScreenprogramavailableonAlto,butitmaydisplaymorethanoneplots.3.1-Commandsyntax:OpenPlot{spec}where{spec}:=oneormoreinstancesof[switches]{filepattern},where[switches]isoptional.Tosavesometyping,"OpenP"isgenerallyunambiguousenoughfortheCommandTool.3.2-Examples:openpcmos*.plot*Plotsallfileswithnamesmatchingthepattern"cmos*.plot*".Foreachfilethathasmorethanoneversions,onlythelatestversionisopened.Theprogramiscleverenoughtoexcludefileswhosenamesendwith".press".openpfoo.plot-acmos*.plot0Plotsthelatestversionoffoo.plot;thenplotsallversionsoffileswithnamesmatching"cmos*.plot0"3.3-Switches:Themeaningfulswitchesforthecommandare:-hor-H=>(Highestversiononly.Defaulttrue)Onlythehighestversionofplotfileswhosenamesmatchthefilepatternareopened.-aor,-A=>(Allversions.Defaultfalse)Allversionsofplotfilesthatagreewiththefilepatternareopened.-#=>(Specifiesthemaxnumberofplotfilestoopentobe#.Default12)Setsthelimitofthenumberofplotstobeopenedatatimeto#.tg/Er_,mV"l$0+|/&q[xrX\ko0"&b+0 s7XX8J9;?A9V\B r#VV$%(V.468 sSm !$['R)~,l.25j7<= Qm 0'S!rNmF!"'L -/0Y36+8; <3?CLm$T!z$&&)+-4[7i9<?zB%KSm"%9'*P,.1 38;v=gImm!#T%E*$,/2sF]mH! '+u0 14j6k7}9=@C DmrAfK>\:# -!%+V- 39 9!m 7yY%'^-E 5:<5m 2K/4\ p+ "'*6. *>0W}#]&}) .|1x37[;=[(^. $&b+N.'26G8;r%G\Y p!Z "*'*-/469Z ~$<$i&")~+--13479TVm$5Aswitchaffectsallfilesinthesamecommandlineaftertheswitch,untiloverriddenbyanotherswitch.Illegalswitchesareignored.4.WorkingDirectoryTheworkingdirectoryisinitiallysettotheonewhereyouinvokeThyme.Youmaychangeittoanotherdirectory.Butifyousetthisfieldtoempty,thenThymewillsetitto///thyme/whenittriestofindtheworkingdirectory.Andifyouputaremotedirectoryastheworkingdirectory,outputfilescannotbecreated.4.1-foroutputfiles:Alloutputfiles(textfilesorplotfiles)willbecreatedinthecurrentworkingdirectory.4.2-forinputfileandincludedfiles:Ifyoudon'tspecifythedirectoriesfortheinputfileortheincludedfiles,thecurrentworkingdirectorywillbeassumed.Theinputfileandtheincludedfilesmayresideinadirectorydifferentfromthecurrentworkingdirectory.YoumayspecifythedirectoryfortheinputontheThymeviewer.(Inthe"InputFile"field.)Youmayspecifythedirectoryfortheincludedfilesinyourinputfile.(Thatis,afterthe!mark.E.g.,!/Cherry/Thyme/Cedar5.2/Top/ThymeBasics)4.3-forThyme.errorWhenThymefindsanerror,itwilllookforafileinyourworkingdirectorycalledThyme.errorinordertoprovideyouwithalittleinformationastowhatwentwrong.Ifitcan'tfinditinyourworkingdirectory,itwilltrywiththe///Thyme/directory;ifit'sstillnotthere,itwilltrytheThymereleasedirectory.Ifitshouldfailinalltheseattempts,itwouldstillgiveyoutheerrornumbers.Inthiscase,youwouldhavetolookitupinthefileThyme.errorbyyourselfforsomehintsabouttheerrors.5.MinorChanges5.1-Cmos2.0u25C.thy:Cmos2.0u25.thyisnowrenamedtoCmos2.0u25C.thysincesomeusersthinkitprovidesalittlemoreinformationbyaddingaCinthere,anditmightbemorenaturalwhenonetypesitsnameout.Ofcourseyouarefreetogiveitanyothernamesonyourdisk.C.CommentsAreAlwaysWelcomeWewouldliketomakeThymeasusefulaspossibletoourdesigners.Anycommentstg/Er^m4t"a$&o)0M36?8=1\m id!oYmRqVRxrS\4] %')+.25m9?vBQ\\Z  N mp'C"#(U+{0.246L7>BDLfm j &n)*-0!1K5;=r?Jm   #%'GpK>D!\!@!-"%)1+-24D6;m@ @K>R "=\) & &)+q/13I5;N>@;\0!!8mFZ!p'*-1 239?YB6m7 $<'J*N.1J79Y;?dAj5?m `"&* .149A;ArC3m $'+-_0238f;1m'.K> +S\t'#T$'U*o,-0?15(:@Q)\ T e%o(&+A,k/ 7&8:=A<&]mF"( .G/2H4p79$m L"b&C'*E,l.3~8 >@3A#mu"$=(k+ -036=>A!gm$SH"a#%'w),@ 4863;u=AEmOqqxHr"K\ e%'32:59@<@\,\F &c(_,./1J5+799=0?!\p !%(+/P24Z7'8;=?\q g7Ar @K^"$r(*9/{1)3 :=TVm$6fromyouarethereforealwayswelcome.tg/Er_,Ki" "TVm$ HELVETICA HELVETICALAURELLAUREL TIMESROMAN TIMESROMANL#$j/'%IO[]<>CedarThymeDoc.tioga$Tuesday, August 14, 1984 4:37 pm PDT