ToBurdockUsersDateMarch27,1985FromHalMurrayLocationPARCSubjectBurdockManualOrganizationCSLXEROXIntroductionBurdockisaprogramtohelpdebugDLionandDicentramicrocodeandhardware.DickSnowdidsomeoftheearlyworkonBurdock.PittsJarvisdidmostoftheworkonAltoBurdock.ItwasusedtodebugtheearlyDLionhardwareandmicrocode.Ifyouareintotrivia,askyouroldtimerfriendsabouttheBurdockEtherKludge.TherearetwoversionsofBurdock.OnefordebuggingDLions,andanotherfordebuggingDicentras.Therearenopicturesinthismemosomanydetailswillmakemoresenseifyoucangetsomebodytogiveyouaquickdemo.DLionBurdockTheDLionversionofBurdockhastwowindows.Oneisfordebugging/controllingtheCPandoneforworkingontheIOP.Unfortunately,theoldLogicAnalyzerlashupfromAltoBurdocktotheTektronixlogicanalyzerpluginforascopehasneverbeenrevived.Ihaven'tworkedwithDLionburdockforalongtime,soyoushouldbeextrasuspiciousaboutpartsofthismemothetalkaboutDLions,expeciallypartsthattalkabouttheIOP.DicentraBurdockTheDicentraversionofBurdockalsohastwowindows.Again,thefirstoneisfordebugging/controllingtheCP.ThesecondoneistheHistoryBuffer.It'salogicanalyzerfortracingexecutionofCPmicrocode.(Dicentrasdon'thaveanIOP,sothereisn'tanyneedforanIOPWindow.)WheretofinditThereisprobablyaBurdocksubdirectoryonyourfavoriteAMesa/APilotarchivedirectory.Mesa11.1isarchivedon[Ramrod:OSBUNorth:Xerox]11.1>.TheDLionversionisBurdockDLion.bcd.TheDicentraversionisBurdockDicentra.bcd.TheyareontheBurdock>Friendssubdirectory.(Youdon'tneedpО_/НБqО_/О_/Н8НгpО_/Н-ДqО_/Н89Н<÷О]┬НБpОY╛НБqОY╛Н8НЕpОY╛Н-ДqОY╛Н89pОUпНБqОUпН8НгpОUпН-ДqОUпН89rОNNНqsОG╠НБtОDbНєН┤НGНдН їН"╘Н&Н*⌡Н/_Н2jН8dН?gОB╩НБqО@@НєНВН╧Н&Н╟Н `Н"ЇН&Н)┴Н+├Н1dН4vН8NН:╩Н>Н?ЎО>≤НБН╦НН┼НйН Н#÷Н'4Н);Н-цН0|Н4<Н9Н?gО<ЯНБ НуНDНХН(НМН"фН%Н(DН*⌡Н.2Н2╩Н6┼Н8жН>SО;JНБО8нНєН√НзНvНЁН!]Н'4Н*(Н,VН3Н8=Н:ЕН?АО7'НБН° О4╛НєНцН3НWН║Н!mН$+Н(│Н*bН.JН2ЇН5Н9QН=Н@ҐО3НБН≥Н$НmНЗН╗Н!√Н$MН%wН)BuО/ІНБН;qО,gНєН²Н.Н!Н#ЯН*╒Н.8Н2Н9.Н=TН?АО*юНБНаН+Н!┬Н$JН&ЪН)FН.їН0ЇН3!Н6p Н?ЎО)НБН<ННцНН"qН%{Н*ШН, Н.ЙН5/Н8qН=нО'qНБННIНН┴НTН╟О$ЖНєНЁН▌НН═Н$Н)█Н+рН-Н0#Н3╗Н5sН81Н<ЁН>╚О#OНБ НWН*Н└Н/Н цН$МН'?Н)ХН-╩Н2З Н9MН<їН?gО!їНБНдН#uОYНБН▒qО НєН│Н,НЫН ЇН&LН)Н+≤Н.IН4VН8©Н;$Н>Н@╡ОbНБННПН!LН#УН&йН+ZН.Н/lН1иН6╟Н;TН=іН>мО╩НБНjНбНnН!ЎН#▓Н& Н- Н3чН7█Н:НН<ЫН@ZОНБНkНeННbН÷Н░Н"}uОеНБНRННкtОvНєН|НҐНeНeН"кН*┘Н,aН/rН4SН=UО оНБ НLН6НcНН#ЮН&'Н0┬О'НБННыНЬН!╩Н/fН3∙Н:⌠Н@╡О ─НБНjНЯН"CН$HН&іН1kpН9╔О ─О ─Н:НЭН@#ОP┌НБН█ НюНwНН"ЛН$Н%ШН(|Н,'Н.├uОM2НБqОIЦНєНYНxНЧН!АН%пН+┘Н1PН3qН85Н;ьН?ОH<НБН_НЇНїН kН$еН&╣Н*▄Н--Н3vН4аН9лН<еН?ЎОF■НБНТНёНчwОDМНХНHОCEНХ Н/Н"▐Н%Н'·Н*ЧН-├Н1ҐН4EО?ЖНХН О>NНХ Н/Н"▐Н&фН)NН,ўН/5Н3mН5УО:ЪНХНО9XНХ Н/Н"▐Н&фН)NН,ўН/5Н3mН5УsО2╨НБН{qО/jНєН╡НН9Н╘НWН!МО,ОНєНсН Н;НуН"іН%eН(9Н+·Н,пН/╟xН1qО,ОО,ОН2MН4ЫqН8цО,ОО,ОН9їН<ЁН@╡О+GНБНцНьННМН sН$,Н'Н)─Н/Н21Н4FН6ЄН:Н>:Н@9О)═НБН=НPН<Н│Н0Н!┬Н#'Н%lН(?Н,Н-╞Н0LН3Н5ZН;Н=UО'ЫНБН: НFННэН SН$гН'Н-▐Н/└Н3Н7xН8zН<Н?ЎО&QНБН≈Н-НфН═Н#xН [О&QО&QН!NН%ДqН(NО&QО&QН)9Н+гН.▄Н2eН5Н7ЗН;{О$╙НБНNНҐНuН,НвН _Н%Н(9Н+tН1·Н37Н5√Н:О"/НєН─НўН"Н!РН%вН'Н+┘pН0&О"/О"/Н0нqО"/Н4Н6"Н8├Н;wН?йО ┤НБН НаНВpНPО ┤О ┤НЬqО ┤Н 7 Н&ЙН)BН,lН/▀Н6вН<(Н=ўОЮНБНЯНpН═ОЮОЮНHqОЮН┌Н@Н"eН&|Н'фН)%Н/°Н1?Н2\Н5нН9╧Н;qН<▌О9НБОҐНєНЕН/НsН▄Н"^Н%уН'Н-∙Н1їН4yН6nН:tН=⌠Н@eОНБНUНЭН╨Н╔НН Н"≥Н)Н+Н-▐Н4Н8fН;RН?ОnНБН╨НН╘НґНЄН!Н&_sОпНБqО │НєННmНпН█Н!ШН'▒Н-═Н/√Н1KН6╗ Н=ЎН@ZОзНБНН≤НOН=НgН#DН%╒Н(MН*║Н0sН3wН5%Н76Ъ─TVm$lInter-OfficeMemorandum3PanelsThebottompartoftheCPWindowandtheIOPWindowisacontrolPanel.Panelsdon'tfollowthenormalTajouserinterfaceconventions.EachPanelhasthreecolumnsoftiles.Eachtilehasaflagcharacter,aleftsidethatcontainsasymboliclocationtobedisplayed,andarightsidethatshowsthecontentsofthatlocation.AsyoumovethemousearoundinaPanel,thesideofthetileunderthemousewillbeblackened.Theflagcharacterisnormallyblank.Itisa*ifthecontentsofthattilehavechangedduringthelastrefreshofthatcell.Itisa~ifthelocationhaschangedbuttheCPorIOPisrunningsothecontentscan'tberefreshed.Ifyouclicktheleftmousebutton(Point)whileitisoverablackenedtile,thecontentsoftheTypeInfieldwillbestoredintotheblackenedtileslot.IfTypeInisempty,thecurrentselectionwillbeused.Ifthestoregoesintotheleftsideofatile,thecorrespondingcontentstotherightsidewillbedisplayed.Ifthestoregoesintotherightsideofatile,theywillbereadbackanddisplayed.NotethatthereisaseparateTypeInslotforeachPanel.Ifyouclicktherightmousebutton(Adjust)overtheleftorrightsidesofatile,it'stextstringwillbeappendedtoTypeIn.Ifyouclicktheleftmousebutton(Point)overatilewhileLeftShiftisdown,theleftsideofthetilewillbebumpedby+1andtherightsideofthetilewillberefreshed.TypeInisusedasaworkareaforthesymbolicevaluationoftheexpression.Thetextforthenewleftsidewillbenormalizedbythesymbolmachinery.(Ifthereisanameitwillbeused.Ifnottheclosestonewillbeusedtobuildasymbol+numberexpression.)Ifyouclicktherightmousebutton(Adjust)whileLeftShiftisdown,theleftsideofthetilewillbebumpedby-1andtherightsideofthetilewillberefreshed.(Again,TypeInisusedasaworkarea.)Ifyouclicktherightandleftmousebuttons(Menu)whileLeftShiftisdown,thecolumnwillbefilledbyadding+1totheleftsideforeachtileinthecolumn,andthecorrespondingrightsideswillbedisplayed.TypeInendsupwiththesymbolicexpressionforthelasttileused.Youcanscanthingsrapidlybyholdingthemouseoverthetoptileofacolumnandalternatelydoingstoresandfills.CPWindowTheCPWindowisusedtoexamineandcontroltheCP.Ithas3sections.ThetopsectionisaFileWindowusedtorecordarunningcommentaryofvariousinterestingthings.ThelogfileisCP.log$.ThesecondsectionisaFormSW.Mostofitiscommands,butthereareafewtypeinslotsandaslottoshowthecurrentstateoftheCP.TherestofthewindowistheCPPanel.CPStateBurdockkeepstrackoftheStateoftheCP.ManyoperationsrequirethatCPsОfЕН ЮН)Ю vОfЕНEиsО_НБqО[╡НєН▌НiН_Н*Н °Н#Н(╒Н+kН-щН0щН6~Н7ШН97Н=ЭОZНБН1НеНЩН]Н"Н%IН(BН-ХОW▐НєННАНUНчН$WxН&ОW▐ОW▐Н&─qН(fОW▐ОW▐Н)AН,ЄН/Н1┤Н2╟Н5g Н;їН<яН?FОUХНБНлНLН▒НsН#фН%▒Н'² Н.0Н1Н2IН5ЇН8╚Н;√Н?ЎОTAНБНHНЬНҐНBН JН"ЬН&ўН)Н-UН2 Н3╞Н4пН8ИН;?Н>Н?ЎОR≥НБНAНCНёНЩН╗Н ≥ ОPНєН▀НRНJНфН$іН(ЦН*jН+ФН-Н.cН/тН2CН7бН9▀НвОNwНБНJНЁНН┐Н"Н#йН&░Н)kН*шН,?Н-bН.ГН0@Н2≤Н7хН:5Н?²ОLпНБНAН∙НYНGН╡НИН ґН# Н(|Н+нН-Ў ОJTНєН-НЛН0Н≈НН"vН&ОН+■Н/PН0ўН2"Н5CН6uН=Н?ЎОHґНБНTННrНHН {Н#)Н%Н)CН,Н.─Н5Н7gН:WН;эН@╡ОGНБНhН╪НyН Н"╡Н$≈Н(Н)∙Н+ХН/9Н2GН5Н7gН9пН<°Н>IН?gОE^НБНAН8НїН!UН#ЄН'Н)щН,┬Н.y Н4ОН6qН8пН<,Н?FОCЇНБНXНюНўН}НҐН▀Н ╠Н#rН%yН(╙Н,Н.у Н5aН8НН;сН?rН@ТОBНБН:ННєНАН!О?∙НєННбНПНBН┤Н"тН'8Н,▌Н/⌡Н1МН4TН6Н9PН<÷Н>JН?gО=МНБННлН╒НMН>Н"∙Н$DО;rНєН9ННSНфНNН"╪Н'AН+ЯН/Н0[Н2мН6√Н<|Н=ШО9кНБНDН╩Н∙НPН╠ННюН!╡Н'$Н)"Н+╧Н.sН0тН4(Н7Н8ҐН;Н=─Н@-О8#НБ ННиНН#Н╚Н ўН$Н&вН(МН+&Н0ф Н7BН8уН; О6|НБН╞Н\Н▌НБНеН/Н ЭН#°Н%┌ Н,²Н.▌Н0БН5÷ Н<єН>∙О4уНБНбН`Н⌠Н]Н}НБН!ИН#ъН&хН)°Н.jН1┼Н4╘Н7Н:ЎН<АН@ТО3-НБНЁО0╡НєН>Н НaНьНCН#╣Н(?Н-╨Н1┤Н7rН8ЖН=1Н?╘О/НБНЁНeНЎНН╨НєН"Н$Н%╗Н(XН*╠Н-ЭН0мН2Н4ьН7/Н9тН;Ў О-dНБНюН⌠НЪН;НИН Н#▐О*ИНєН4НЗНEНЁНН!зН$^Н(гН-лН2шН6÷Н<─Н=ШО)AНБНCН9НЕНвНkН hН$ШН'▒Н)AН+║Н.Н0ЯН3/Н6aН8аН:pН<яО' НБНsН╛Н|Н╗Н"щН%bН'- Н-}Н2*Н5?Н7*Н:Н∙ОННБНґНН⌠НБНuН!Н#vН$╠Н'dН+╞Н.шН1╔Н2ЮН5┬Н7HН:ЦН=TОFНБННлН+НжН╞НPН Н"hН'■Н(ЪН+_Н-╡uО ЬНБНAqО ╘НєН@Н#НёН ixН"жО ╘О ╘Н#╡qО ╘Н&oН(6Н*╒Н-ZН1^ Н8Н<ОН?йчTVm$∙Inter-OfficeMemorandum4tobeinareasonablestate.CP/IOPDeadmeansthattheCPhascrashed,theIOPhascrashed,ortheCPhasn'tbeenBootedyet.HaltedmeansthattheCPhasbeeninitialized(Booted)andisnowstopped.Itcouldhaverunsomealready.Ifsoithasbeenmanuallystopped.RunningmeansthattheCPisrunningusercode.(It'srunningtheCPKernelwhenit'sintheHaltedorCPBreakstates.)CPBreakmeansthattheCPhashitabreakpoint.IOPStoppedmeansthattheIOPisstoppedoratabreakpoint.TheCPmustbeStoppedbeforeitcanbemanipulated.TheCPcouldbestoppedautomaticallywhentheIOPstops,butrefreshingtheCPPanelusuallytakesseveralseconds,andthat'sawasteoftimeifyouarechasinganIOPbug.BurdockpollsthestateoftheCP.Whenitchangesamessageisprintedinthelogwindow.IfitchangestoHaltedorCPBreak,theCPPanelisrefreshed.Built-insymbolsTheCPsymbolmanipulatonroutinescontainalargecollectionofbuilt-insymbols..CRnislocationnofRealControlStore..CVnislocationnofVirtualControlStore.(Thenthinstructioninthemicrocodelisting.)Pass2ofMassdeterminesthemappingbetweenCRandCV..MRnislocationnofMainRealmemory..MVnislocationnofMainVirtualmemory..MAPnisthenthwordofthemap..RHn,.Rn,.Un,.TPCn,.LINKn,Q,andL0throughL7aretheobviousthings.Soare.IB,.PC16,.STACKP,.IBPTR,.MINT,.EKERR.Anumberisnormallyinterpretedasalocationinmainmemory.IfanexpressionforanRregisterintheleftsideofatileintheCPPanelisprefixedwitha$,theRH/Rpairwillbedisplayedasa24bitnumber.CPKernelTheCPKernelcurrently(11.1)useslocations0F6F,0F77and0F7Fthrough0FFF.(Exceptforatypingerror,theappropiatereservesareinInitDLion.mc.)IthinktheDicentraversionisactuallyafewwordssmaller,butIhaven'tgotteninterestedenoughtocheck.ForDiagnosticsandsuchwherespaceisn'tcritical,Ireserve0F5Fthrough0FFF.CPBreakpointsTheDLionCPcanhaveupto16breakpoints.TheDicentracanhaveupto256.WhiletheCPisstopped,thebreakpointsaretemporarilyremovedsotheywillbeinvisibleifyouexamineControlStore.WhentheCPisstarted,theinstructionateachbreakpointisreplacedwithajumptotheCPKernel.Breaksatc2andc3arerisky.Ifamemoryoperationwasstarted,theresultswillbelost.Youcan'tsetabreakatac*instructionbecauseBurdockneedsthecycleinfotobuildtherightbreakpointinstruction.Ifyouhitabreakpointonthewrongcycle,BurdockwillprobablydeclaretheCPtobedead.(ThiswholemessissОfЕН ЮН)Ю vОfЕНEиqО_,НБН∙Н▀Н>Нm Н@xНнО_,О_,Н лН%┐qО_,Н)Н-dН07Н2°Н4ТН7nН<лН?0О]┘НБНZН╣Н{НщН3Н!8Н$≤Н)XxН+ШО]┘О]┘Н-%qО]┘Н0zН4аН7▒Н9СНаО[щНБ Н1НзН▀НПН!МН'kН(эН,║Н/АН2pН5ЩН;!Н<°Н>YН?╘ОZ6НБНН╪xН│ОZ6ОZ6НqОZ6Н$OН(сН+БН.┌Н1Н2аН88Н;rН?QОX▐НБННvНхНeН!Н#JН$ВН'UН+эН-÷Н3cxН7ХОX▐ОX▐Н8ФqОX▐Н=зОVГНБН╩Н%Н┐НН*Н_ xН#╠ОVГОVГН$LqОVГН+Н/нН2їН5Н8 Н9Н>ЇН@┘ОU@НБН Н@ННXНЇН!·Н'Н+IН,∙Н/Н0ЧН9:Н< Н>RОS≥НБНАНН²Н"aН$нН'йН+╞Н.> Н4цН71Н9▓Н=kОQЯНБН`НПН_НН"аН#ЙН'╙Н)cН,┴Н-ИН0═Н2ТН7чН9нН<╪ОOvНєН1ННэН Н!бН$Н&гН*щН,1Н1[Н2┌Н7вН9AН>Н?ЎОMоНБН5Н╦Н:Н░НҐН kН$СН&ЇН,уН/4Н1┬Н5RН6Ў uОJНБНАqОG0НєНгНeНx Н$гН*_Н/┴Н0ЧН4╟ Н;0Н=3ОE┴НБОC НєНtН╛НН*НbН Н"2Н'5Н+Н-чН/Н0pН5■Н6мН8sН=ОAfНБНзН-Н╞ Н▄Н!<Н#²Н*LН/6Н2<Н3rН5-Н8І Н?ЎО?©НБН·НН≈НNО=CНєНяННnН≤НвН┐Н#Н&NН,Н/(Н0fН1еН6ОН8-Н9зН=vО;°НБО9 НєН╞НЗНfНеНFН нН"┤Н$ГО6╔НєНҐНtНnН&Н5НЛН!⌠Н#KН'КН)╒Н+їН.sН0єН5ПН8!Н:┴Н<ЩО4ЧНБНRНYН╛НLН╟Н%┼Н*ЛН0О2┌НєН0Н\НхН≤ Н&╚Н(YН)┐Н.╨Н0hН3ЕО0НєН;НA ННbН gН" Н&ЧН(бН+7Н-аН0╞Н2}Н3╪Н61Н7ТН:iН<рН@╡О._НБНPНkН∙Н"Н│Н ХН#юН&kН(\Н.{Н0)Н1SН38Н5UuО+НБНAqО'аНєН∙НН╦Н!ўН%їН(╧Н.█Н2ЁН6IН9Н<ФО&НБНEНqНнНН }Н$gН&Г Н-ЦН39Н5ґН7{ НAО$rНБНЇНMН)Н 'Н!хН'Н(uН+KН/▌Н4ДН7⌡Н8зН=ДО"кНБ НOН[Н+Н ├Н#S Н*хН-║Н0ТН5.Н9Н<НAО!$НБН■НHН─uОтНБНA qО┘НєН≤Н$Н■Н;Н!·Н#лН%≈Н'≤Н/─Н2uН87Н:чН>AН@oОчНБОbНєН╩ННnНыН!_Н#Ў Н+3Н-├ Н4ОН:÷НЬОU9НБН3Н}Н=НёНТНН!⌡Н$fН&ЕН)dН.MН1Н3зН⌠Н?ЖО2|НБН НjНіНДНEН"Н$шН&HН(fН*Н,vН1*Н4┤Н9йН=jН?йО0уНБНNО.YНєНDНН║Н Н"░Н%ҐН+Н/1Н1ґН2УН7шН:XН=dН@-О,╡НБНOН╧ННХН О*6НєНYНвН7НБН ╨Н# Н&ьН)┐Н+tН3Г О'╨НєНCНhН²Н8Н%єН(pН+SН0]Н1тН3█Н5ЬН9SНEН?ЄО!ПНБН≥Н<НгН'Н!Н"}Н&= Н-NН0жН3*Н9мНtО[НБ ОЮНєН\НВНaН >Н#|Н$уН(▀Н+▓Н1├Н3,Н8їН;єН>2О8НБН░ННы Н#.Н%▌Н(ЪН+ьН0─Н6·Н8 ОҐНєНoНЦНЖН"eН$мН'?Н*`Н-▌Н1ЕН8ЧН;ЎОНБНкН≈Н4Н!GН"їН%╣Н'!Н*╗Н+гН.$Н0ЯН39Н6╙Н(Н?рО[щНБН┘НEН≤НDННчН#⌠Н&vН*╠Н-<Н0Н3<Н4фН6ЗН9ИН=SОZ6НБН.Н≤НН╦ННcН!Н$1Н&хН)ПН+%Н0iН2ҐН4ЕН8Н:ўqОW╩НєНИНГН}Н"Н%EН(ЮН0ЄН2vН8.Н;gН>2ОVНБН░ННыНЖН!Н#gН&ыН)╠Н.ZН0цН6АН8MОS≤НєН├Н∙Н <Н"ьН'BН*╔Н0DН5│Н7╧Н9╨Н'ОLШНБН╧НzН"Н∙Н-Н .Н#ЖН&юН*Н,ыН0Н5▓Н7=Н9╞Н=?ОKTНБН≥НPН©НkН$Н!ґН% Н'Н,2Н.чН1^ ОHьНєНтН╡НН"гН(cН*Н+'Н-qН20Н4чН8юН;Н?╗ОG1НБНЇНвНxНVН &Н!оН$VН*"Н+╣Н.~Н/нН5zН8BН:УН=Н@oОE┼НБНлН3НъНЫН╗ОCНє НуН≈НЖН"юН%О@⌠НєН√Н Н"Н#еН&%Н*НН-BО>НєН2НSН МН%ПН+оН-ІН/Н1їН7Н9РН;▄Н?OН@ТОІО&ЯНБ НН▐Н\Н+Н$+Н)єН*ДН-8Н/ Н6"Н9Н@┘О%IНБН│Н<Н░Н─ О"нНєН{Н╚ННцНшНsН"UН$ЁН*AН1═Н3XН6┬Н<ҐН>jН@ҐО!'НБН≥НhНН╗НўН!3Н"ЬН&ґН(qН+3Н-Н/w Н6╗Н9ьН;їН?gО─НБНfН·Н%НyНc Н$YН,rН.%Н0І Н7>Н8шН=ЖН?QОьНБННпН[Н Н#рН%)Н(pН*` Н1;Н2ЪО]НєН©НйННsН%$Н'╡Н+_Н-Н/rН5tН7жН=2Н?АОІНБНцНДННЦН Н!FН%iН,ъН.ёН3?Н6Н9╛Н=ОНБНОН,НiННН8Н ≤Н&╚Н)zН*┌Н-иН0>Н5ґН9Н;ssОqНБН▐qО"НєН НїНTНъН":Н$Н)·Н,tН1FН3дН7(Н8ЎН;RН<╔О{НБН▒НчНQН■Н∙Н Н#чН&пН'эН.ПН1÷Н4┘Н8ЫН:< О сНБН3НВН[Н НГ Н&ъН(ґН-┼ Н4YН8чН;кН>4Н@╡Ъ TTVm$eInter-OfficeMemorandum7IOP.log$.ThethirdsectionisaFormSW.Mostofitiscommands,butthereareafewtypeinslotsandaslottoshowthecurrentstateoftheIOP.TherestofthewindowistheIOPPanel.IOPStateBurdockkeepstrackoftheStateoftheIOP.ManyoperationsrequirethatIOPtobeinareasonablestate.DeadmeansthattheIOPhascrashed,orithasn'tbeenBootedyet.BootedmeansthattheIOPhasbeeninitialized(Booted)butthePChasn'tbeeninitializedyet.HaltedmeansthattheIOPhasbeenrunningandisnowstopped.RunningmeansthattheIOPisrunningusercode.(It'srunningtheIOPKernelwhenit'sintheBooted,HaltedorBreakstates.)BreakmeansthattheIOPhashitabreakpoint.CPHalt/BreakmeansthattheIOPisinlimbobecauseitnoticedthattheCPencounteredabreakpointoritwashalted(byBurdock)tohalttheCP.BurdockpollsthestateoftheIOP.Whenitchangesamessageisprintedinthelogwindow.IfitchangestoHaltedorBreak,theIOPPanelisrefreshed.IOPBreakpointsIOPBreakpointsuseanRST2instruction.Youcanassembleoneintoyourcodeto"CallBurdock".ThereisnolimittothenumberofIOPbreakpointsthatcanbeactiveatthesametime.Built-insymbolsTheIOPsymbolmanipulatonroutinescontainseveralbuilt-insymbols.B,C,D,E,H,L,M,A,PCH,PCL,SPH,SPL,Flags,andRIMaresymbolsfortheobviousregisters.BC,DE,HL,SP,PSW,andPCaresymbolsfortheobviousregisterpairs.ArawnumberisanaddressinIOPmemory.IfanexpressionforanaddressinIOPmemoryisprefixedwitha$,thatlocationwillbedisplayedinwordmode.IfanexpressionforanaddressinIOPmemoryisprefixedwith%,thatlocationwillbedisplayedasaninstruction.IOPCommandsStack!displaysclumpSizewordsfromthestack.Instructions!evaluatesthecurrentselectionasanIOPsymbol,andthenstartingthere,displaysclumpSizeinstructions.Boot!goesthroughvariousstepstoinitializetheIOPandtheIOPPanelsoyoucanstartdebugging.ItforgetsallthecurrentIOPsymbolsandbreakpoints.ItthendoesalowlevelbootontheIOPandestablishescontactwiththeIOPKernel.Finally,BurdockreinitializestheIOPPanelandpreloadsitwithadefaultcollectionoftiles.ThisoperationleavestheCPintheDeadstate.AllofthevariousLoadcommandsusethecurrentselectiontospecifyafilename.ForloadingIOPcode,thedefaultextensionis.bin.sОfЕН ЮН)Ю vОfЕНEиqО_'НБННИН[Н Н!wН"╙Н)Н,⌡Н.]Н/ҐН12Н8yН;Н>≈Н@ТО]НБНіНН?ННfН Н!ПН%⌡Н(Н- Н0^Н29Н4╪Н8$Н;Н=ЦН?ЎО[ьНБННyНыНфuОX┴НБНРqОU:НєН(НТН\Н xН"_ОU:ОU:Н#аОQКНБНдxН┼ОQКОQКН}qОQКНBН╚Н"·Н%#Н(5Н*оН.Q Н4кН:═Н=FН?йОPDНБНБН< Н▐xН-ОPDОPDН VqОPDН#їН'ХН*ЄН-Н/ШН2nН5хН:ЭН=╠Н?ОN²НБxНОN²ОN²Н}qОN²Н%Н┌Н!hН#ЮН&ГН(kН-╨Н0лН4┐Н7iН<╦Н?0ОLУНБН┤НBН|Н0Н√Н"ЁН'BН)Н- xН1√ОLУОLУН2┴qОLУН5╚Н9УН<йН?0ОKNНБН└НоН& xН⌡ОKNОKNН≥Н2 qОKNН&кН+=Н.8Н0еН3ЮН5yН7UН;yН@хОIїНБНбН░НПНD Н#Н$G Н+8Н,ЭН.SН0ЪН5.Н7ёН=ґН?[ОGЪНБНAОE└НєН&НkНЎНБН!▌Н#АН'Н+%Н,oН1▌Н2╚Н7ЖН9UН>Н?ЎОCщНБН5Н╦Н:Н░НҐН kН$СН&ЇН+Н-eН0SН4Н5┴ uО@▌НБНР qО=?НєНЇ НrН Н!#Н$└Н%ъН-7Н0kН3Н9Н;ЕН>ЦО;≤НБН)НвНuО9НєН╨Н;НWН╡НuН ЙН&+Н'ЫН*Э Н2├Н5iН8 Н:Н>Н?ЎО7uНБН_uО4&НБНАqО0вНєН|НiН1 Н$6Н)┐Н.bН2СН7щО.\НєН{НhНwНOН^Н6Н{Н!sН%RН(ЫН,║Н0Н4%Н6ПН:kН<яО,╣НБННMНT НЖН ·Н#hН&3Н(▐Н,LН.ЙН1%Н3_Н8▓Н:ЇН<ЩО+НБНюО(▓НєН0НэННtНdН#NН$ЭН'ЙО&НєННБ Н│Н╔Н{Н$LН%ЮН(ЄН.Н/YН4ўН7╞Н8©Н:2Н<ГО$pНБН■Н▄Н╠НfНЖН#*Н$╡Н&╙ Н-iН/ґН1єН6∙Н8JН;>Н@╡О"иНБНPНkНPНН!UН$Н%ЯН,Н-ЎН/╞uОzНБНРqО+НєНсН Н!ґН%╨Н)!Н+─О╟НєН▌НfН!ІН&qН,Н-╔Н/├Н2dН7uН:Н=4ОНБНцНЗН·О█НєНbНpН°Н"YН%╣Н'W Н,зН/-Н2Н4╩Н7Н9ПН=╞Н?gОФНБНfНn НxНХН!gН#PН%╗Н*jН-QН2√Н5FН9Н=┬Н>ЬО>НБНGН╔НzНТНZН■Н"(Н%KН(6 Н//Н4#Н7rН:Н=)О≈НБНЦНjН ·Н"УН%шН)²Н,LН1гН3Н6(Н7IН;И ОПНБН⌡НжНПНН!&Н#┘Н%ыН'┤Н)ФН-°ОuНєНяНeН÷НAН╞Н&oН(©Н*ЫН/²Н5Н6іН;Н<"О мНБН█НwНdННcН$Н**Н+∙ХTVm$Inter-OfficeMemorandum8Load!isusedtoloadmicrocodeintoIOPRAM.FirstitresetstheIOPsymbols,IOPbreakpoints.ThenitloadstheIOPcode.ThentheIOPPanelisreset.Start!evaluatesthecurrentexpressionasanIOPsymbol,setsthePCtothatlocation,andContinue!stheIOP.TheCPwillbeautomaticallycontinuedfirstifthatmakessense.Step!letstheIOPexecuteoneinstructionandthenrefreshestheIOPPanel.Thisisimplementedbyautomaticallyinsertingabreakpointatthenextlocation,sothatinterruptroutinesmaygettorun.Iftheinstructiontobeexecutedisaconditionaljump,twobreakpointsareinserted.Continue!justletstheIOPstartrunningagain.Again,theCPwillbeautomaticallycontinuedfirstifthatmakessense.Stop!stopstheIOP.TheIOPPanelwillbeautomaticallyrefreshed.Run!runsaBurdockcommandfile.ThefilenameisintheFile:slot.Ifthatisempty,thecurrentselectionisused.Thedefaultextensionis.burdock.LoadNoSyms!islikeLoad!exceptthatthesymbolsarenotloadedintothesymboltable.Thissavestimeifyoudon'tneedthem.LoadSymbols!isusedtoloadsymbolswhenyouchangeyourmindafterusingLoadNoSyms.LoadModSymbols!loadsthesymbolsforthemodulespecifiedbythecurrentselection.Refresh!refreshestheIOPPanel.Thisinvolvesreadingallofthespecifiedlocationsandupdatingthedisplay.A*willappearnexttoeachslotthatchanges.ThedisplayisautomaticallyrefreshedeachtimetheIOPisstoppedorhitsabreakpoint.Manualrefreshcanbeusedtoseeifthehardwarehaschangeditsmind,ortocatchthesneakycasewhenyouhavetwoslotspointingatthesameregisterandyouchangedoneofthemsincethedisplaywaslastrefreshed.What!evaluatesthecurrentselectionasanIOPsymbolandprintstheansweroutinhex,decimal,andoctal.Iftheselectionisjustanumber,thiscanbeusedtoconvertfromonebasetoanother.ListBreaks!liststhecurrentIOPbreakpoints.ClearAllBreaks!forgetsallofthecurrentIOPbreakpoints.UnBreak!evaluatesthecurrentselectionasaIOPsymbol,andifthereisabreakpointatthatlocation,itiscleared.Break!evaluatesthecurrentselectionasaIOPsymbol,andsetsaIOPbreakpointthere.HBWindowTheHBWindowisusedtoexamineandcontrolthehistorybuffer.Ithas2sections.ThetopsectionisaFormSWusedtointeractwiththehistorybuffer.TherestofthewindowisFileWindow.Mostly,itisusedtodisplaythemicrocodePCsthatwererecordedbythehistorybufferhardware.ThelogfileisHB.log$.sОfЕН ЮН)Ю vОfЕНEиqО_/НєН·НЖН Н╩НЇН%SН(Н*СН/#Н2VН3 Н7RН9·НКНєН╦Н!НZН!Н$Н)\Н-Н/бН4gН7═Н;;Н>tО=DНБ О:хНєН╗Н!PН#дН)%Н+wН-КН2ЪН8пН:ЮН=TО9!НБ О6╔НєНxНyН Н#:Н'√Н*КН0|Н5╚Н7уН9хНН@ТО1╞НБ НННїН"!Н$Н'*Н(гН+ Н,XН.іН4²Н7Н<^Н>'О0НБН╧НzН"Н∙Н-Н .Н#ЖН&юН*Н,ыН0Н5▓Н7=Н9╞Н=?О.`НБН≥НPН©НkН$Н!ґН% Н'Н,2Н.чН1^ О+ЕНєНЙНчНJН# Н(рН*█Н,┼Н/└Н4YН7Н;Н=┌О*=НБНWННЧНwН.Н!вН#YН%╦Н+]Н,хН/iН0⌠Н6Н8╦Н;CН=4Н@oО(√НБНлН3НъНЫН╗О&Нє НуН≈НЖН"юН%ўО#÷НєН√Н Н"Н#еН&%Н*НН-эО!#НєН&Н<Н иН%юН+⌠Н-oН.гН1БН70Н:Н;єН?[Н@ТО|НБ НсНkН9НхН!Н"┼ОНєНМНўНГН"▀Н( Н)▓Н*∙Н-\Н2VН4ХН7bН8fН;- ОYНБsО╨НБН qОkНєН⌡НFНТНН!шН#╗Н)@Н,Н0ИН3hН8Н<ЎН>UН@ИОцНБНZН2НїНDН╞Н ыН&уН*Н+©Н0╣Н3оН6/Н:юН?FОНБН▄НMН╣НЙН^ Н$═Н)²Н*ЭН,pН/╣Н1lН6'Н8▐Н?FОuНБН╟ННҐН╧НН#╙Н'ыН.9Н1Н3dН5нН79ЪiTVm$лInter-OfficeMemorandum9HBOperationThehistorybufferisa256wordRAM.Eachtimetheclockticks,themicrocodePCand8extrabitsarewrittenintoawordoftheRAM,andthepointerintotheRAMisadvanced.WhenthePCmatchesthespecifiedTarget,nmorewordsarewritten,andthentheRAMisfrozen.Ifnisbig,thebufferwillcontainmostlydataforeventsafterthetrigger.Ifnissmall,thebufferwillcontaindataforeventsbeforethetriggerpoint.Thinkofthehistorybufferasahorizontalstripof256cellswithtimegoingfromlefttoright.Thetriggerpointmustbelocatedsomewherewithinthestrip.Thesoftwaredoesalltheworkneededtocorrectforthewraparoundofthebufferpointer.OffsetisaparameterslotintheHBWindowthatcontrolsthedistancefromtheleftedgeofthebuffertothetriggerpoint.IfOffsetissmall,yougetmostlyeventsafterthetriggerpoint.Whenthehistorybufferfinishescollectingasampleofdata,Burdockwillautomaticallyprintouttheinformation.Since256samplesisusuallywaymorethandesired,theHBWindowcontains2moreparameterstocontroltheprintout.Beforeisthenumberofwordstotheleftofthetriggertobeprinted.Afteristhenumberofwordstotherightofthetriggerpointtobeprinted.Warning:Before,Offset,andAfteraredecimalnumbers.HBPrintoutThehistorybufferprintoutisseveralcolumnsforeachsample.Thefirstcolumnisthedecimaloffsetofthislinefromthefrontofthebuffer.Itwillbeprecededbya*ifthisisthetriggerpoint.ThenextcolumnisthePCinhex.Thenexttwocolumnsarethe8extrabitsinbinaryandhex.Lookattheprintstoseethedefaultsetupfortheextrabits.Thenexttwocolumnsassumethestandardsetupfortheextrabits.Itwillshowa"D"isDoItison,andc1,c2,orc3dependinguponthecycle.ThelastcolumnisthesymboliclocationincontrolstorecorrespondingthethePC.Ifthecyclenumberofthatinstructiondoesn'tmatchwhat'sobservedintheextrabits,aconspiciouswarningwillalsobeprinted.HBClocksThereare4possibleclocksthatcanbeusedtowritedataintothehistorybufferClockwillshoweverymicroinstruction.Thisisnormallythedesiredcase.ARC(AlwaysRunningClock)willalsoshowwaitstates.Thereisatleastonewitheverymicroinstruction,butmemoryoperationsnormallyincludeseveralmore.Cycle1willshowthefirstmicroinstructionofeachclick.(Actually,ittriggersduringc3sincethat'swhenNIAispointingtoac1instruction.)Thisjustreducestheamountofdatathatgetsstoredbyafactorof3.Almostalways,youcanguesswhatthemissinginstructionswere.IBDispwillshowthefirstinstructionofeachnewMesabytecode.ExceptforsОfЕН ЮН)Ю vОfЕНEиuО_,НБН┐qО[щНєНfНАНЫНOНbН!БН%TН)│Н,щН/МН26Н5ЄН9&Н;pОZ6НБНCННJНйНyНзН" Н%─Н&ЇН*MН,Н.─Н2яН5√Н8Н<ыН?ЎОX▌НБНГНmНСН&Н!÷Н$ Н)uН+ОН1еН6▒Н7ЖН;ёН?йОVГНБНЕН∙НЁННОН!SН%ФН'`Н(єН*Н,ЇН/Н36Н5ыН:╠Н?ОU@НБНMНЄНН╙Н ■Н"CН#╪Н%UН)yН,Н0bН3;Н8GН;zН=ЕОS≤НБН1Н▒НЖОQНєНыН╟Н.НщН#*Н$ЖН&= Н,щН0 Н1ВН4╚Н7ьН;Н>TОOvНБН>Н╘НMНКН╧Н!Н$╗Н(Н)КН.÷Н5╩Н9УНЬОCНБНЗНPНрНWН#╠Н$эН(f Н/cН1Н5╠Н8Н=ўОAgНБНOН╠НъН≥Н╗НXН!╧Н$0Н%КН(LН,ЁН.cН0UН5┐Н9#Н:░Н<ЯО?юНБН⌡Н╗НVНІННюН Н$┘Н($Н)рН+цО=EНєНлН■Н!Н#гН'eН)╧Н.зuО9ЖНБН┐qО6їНєН|Н Н<Н"∙Н$Н(▒Н.Н0HН3yО4,НєНН[НSНцН &Н%JН)Н*уН-zН04Н3÷Н6Н9xН;5Н=≤О2┘НБНYННУНчНзНН8Н ≥Н#:Н$іН'Н+kО0 НєН|Н▀Н─НЛН KН"÷Н$MО-▌НєНpНtНН│Н!иН$Н%EН(╛Н+BН,ДН1'Н3сН6©Н:QН;чН>1О+ГНБН░НДНCНЛН√НтН"3Н%іО)lНєНoНqНН}Н$9Н&▀Н,Н/ЇН1ХН4:Н7═Н:▄Н;ВН>∙О'дНБННН|НнН9Н≤НOН wН"·Н$bН&2Н,ВН0▀Н2ЙО%IНєН{НЫНМНXНІН%{Н*╠Н,^Н1Н4jН=`Н?ЎО#╒НБНўНRНсНgН╣Н ░Н# Н*|Н/[Н3║Н7ЭН=ОН?ЎО!ЗНБНUНNНx НлН#Н%дН(░Н*│uО╛НБН┐qО]НєН⌠НтНУН%Н"*Н$ФН'^Н)<Н,eН.Н1lН4^Н7$Н9pН=ООАНєН НEНнН┌Н*Н-6Н.╒Н4rН6рН;⌡ОfНєНCН░Н WН$сН'▀Н*cН-ЬН0ЩН5Н9$Н:°Н(ОDНєНGНН╣Н1Н"&Н,├Н.[Н1╙Н5Z Н;аН=5О°НБНeНGНлН┴Н PН#√Н%Н*═Н,aН-²Н/Н7=Н:iН=ОУНБНJН^Н Н.НН шН%Н'Н(>Н,3Н-УН/┼Н4[Н9 Н;ЮН>tО NНБН?Н÷Н▓Н РО сНєНjНН╟НН!З Н(ъН*║Н-шН0рН4┘Н7·Н;EН?АХTVm$DInter-OfficeMemorandum10unusualcases,thisisnotveryinteresting.HBCommandsArm!evaluatesthestringinTargetasaCPsymbol,andsetsuptheHBmatchertotriggeronthataddress.Display!displaysthedatainthehistorybufferusingthecurrentvaluesofBeforeandAfter.ManualTrigger!kicksthehardwaresothatitactsliketheaddressmatcherhasseenthetarget.Again,Burdockwillautomaticallydisplaythings.Thisishandyifyoudon'tknowwhatyourmicrocodeisdoing.YouneedtoArmtheHBbeforeManualTriggerwilldoanything.Ifyoucan'tthinkofanysymboltotypeintoTargetsoyoucanArmthings,use.CR0.Fineprint:IfyouareclockingonIBDisp,andyougetaCPBreakshortlyaftertriggeringthehistorybuffer,itmayappearasthoughithasn'tyettriggered.That'sbecausetherehaven'tyetbeenenoughIBDispstofinishfillingupthebuffer.ManualTriggerwillautomaticallyswitchtoARCclockingforlongenoughwhennecessarytoavoidthisproblem.LoadArmAndGo!doesaLoadRawofthefilespecifiedinFile,ArmsthehistorybufferatthelocationspecifiedatTarget,andthenContinuestheCP.ThisisaconvenientwaytostartalowlevelCPdiagnostic.BB!(BootButton)flapsINIT/ontheMultibusbackplane.ThereareseveralcommandsontheHistoryBufferWindowthataremostlyleftoverfromhardwaredebugging.Stop!stopstheCP.Step!letstheCPexecuteaninstruction.StepFast!goesintoaloopsinglesteppingtheCP.Thisishandyforscopingthestop/gooperations.StepFastFromCSA!islikeStepFast,buttheUseCSAbitislefton,sotheDebuggerboardprovidesthesamenextinstructionindependentofwherethemicrocodetriestojump.Go!undoestheeffectsofStop.UseROMisabooleanusedtoswitchthedebuggerboardintoworkingwiththeControlStoreROMontheCPboard.ThiscanbeusedtoComparemicrocodeonthediskwiththecontentsofPROMs.UseROMdoesn'tdoanythinguntilthenexttimeyouinteractwiththedebuggerboard,sopokeBB!orsomethingtomakesureitgetsnoticed.CommandFilesBurdockhasacomplicatedcommandfilefacility.Fortunately,reasonableproblemsareeasy.Theeasiestwaytogetacommandfilegoingistostartwithanexistingone,andmakewhateverchangesarenecessary.CommandfilescanberunfromtheRun!commandintheCPwindoworthesОfЕН }Н)} vОfЕНEqО_/НБННзН{НГН\Н!kuО[ЮНБН┐qОX░НєНAНН\Н!Н"ЁН&ВН(▐Н)╒Н+ъН0ЙН3▀Н6Н8Н:[Н<пОVИНБН░НУНЭНйОTmНєНdНвНsН"ЄН$÷Н':Н,Н0sН4YН6УН;ШН@eОRфНБНRН ОPKНє Н⌠НН!~Н'▌Н)YН,.Н-▀Н0JН2ЭН5cН:TН?╘ОNёНБНН▒НДНcН# Н%сН.aН3.Н7╧Н:МННБНBНН²НН"РН$╪Н)═Н,┬Н/ЮН6·Н9/Н<Н?WН@ТОН$└Н&в О9ЖНєНpН;НFН ≤Н$ъН&ЕН)EН/- О7{НєН НЦНhН#BН%=Н'▓Н,qН0╣Н69Н8ЭН;DН?╘О5сНБНЭНcНl О3XНєНYНвН7О0эНєНCНцН#НvН!lН#\О.aНєНЇНдН▐Н╛Н!дН%ёН+Н-nН0Н3Н4yН8⌡Н:кН?ЎО,╧НБНЬ О*>НєН%НтН"цН)Н+йН.nН4KН6╛Н8\Н;Н=ЇН?ЎО(√НБН⌡НЙНяН"┬Н&]Н)д Н0В Н9>Н;OН?ЎО&ОНБН░Н■НCО$tНєН├НDНєНТН!╛О!ЬНєНтН1НLНtН"║Н$AН(lН*ҐН0╦Н4═Н7jН<╡Н?ЎО QНБНЧНёН═Н╛Н Н"kН&юН)АН,rН.iН1╚Н3`Н9cН@О╘НБНFН9НYНҐН1Н НН&≈Н,шН1·Н3╘Н9^Н<╙Н?ОНБНН╧Н╛НеН"Н%(Н)uН+6Н.⌡Н1eН3'Н9гН;sН?%О[НБН8НsОҐНБН╒qОmНєН·НН Н$,Н*ЫН-мН3Н;O ОфНБНТНQНІН≤Н!ЯН$рН&┼Н(щН*Н0{Н2НН6бН87Н9ОН= Н@-ОНБНЛНПН╗Н\Н#9Н(eН*╦ ОёНєНmН`НПНФН"┌Н%НН(SН+МН2SН4Н6kН8дН=УН?ЎєTVm$─Inter-OfficeMemorandum11IOPwindow,orfromtheBurdock.~commandintheExec.Thedefaultextensionforcommandfilesis.burdock.Anyerrorinacommandfileterminatesexecutionimmediately.Theerrormessageincludesthepositionwithinthecommandfileoftheoffendingstatement.CommentsTextenclosedwithmatching|sisignored.FunctionsMostofthecommandsavailableintheCPorIOPwindowsarealsoavailableasfunctionswithinBurdockcommandfiles.TheyuseMesaprocedurecallsyntax.Ifthenameswouldclash,thenamesfortheIOPcommandsaresuffixedwith"IOP".Forexample,"Boot[];"willboottheCP,"BootIOP[];"willboottheIOP,and"Break[Foo];"willsetaCPbreakpointatlocationFoo.Argumentstocommandsshouldbequotediftheymightconfusethescanner.Commandsthatstartexecutiontakeanadditionalparameter:thenumberofmillisecondstowaitfortheCPorIOPtostoprunning.(Thenormalreasonforstoppingisabreakpoint.)Anomittedparametermeansdon'twaitatall.(Ofcourse,youcan'tdomuchwhileit'sstillrunning.)Avalueof0meanswaitforever.Remember,numbersusedtospecifywaittimesareinterpretedashex.HereisachecklistofCPcommands:Boot[];Break[where];ClearCPPanel[];Compare[filename];Continue[(waittime)];Load[filename];LoadBoot[filename];LoadGerm[filename];LoadMore[filename];LoadNoSymbols[filename];LoadReal[filename];Reset[];SetBank[bankNumber];Start[filename(,waittime)];Stop[];Unbreak[where];HereisachecklistofIOPcommands:BootIOP[];BreakIOP[where];ClearIOPPanel[];ContinueIOP[(waittime)];LoadIOP[filename];.LoadIOPModuleSymbols[filename];LoadIOPNoSymbols[filename];LoadIOPSymbols[filename];StartIOP[where(,waittime)];sОfЕН }Н)} vОfЕНEqО_/НБНпНUНН┌НБН%рН,4Н-ЦН0CН4}Н7VН;ЪО]┬НБНН─НnНзО[НєНТНЄН╞Н&Н"уН%▄ Н,┤Н3 Н;├Н>╛ОYeНБН9Н²НЩН!>Н%┐Н'БН.CН0ґН2fН4еН; uОVНБqОRфНєНтНnН┴Н#┤Н$ХН&TuОOwНБqОL(НєН8НЩНhН ZН&!Н'шН*FН,іН.uН1oН7+Н9▀НЛНБНьН╠НтН;Н дН#BН%/Н(GН*Н-CН2ШН6vН;]Н?АО=EНБНsНтНСН╚Н ТН&Н,xН0╠Н4;Н7*Н8╧Н:ЖН=vО;·НБНХН┴НчНН Н"┴Н%yН+оН-╚Н1ёН3╚Н5/Н9аН= О9ЖНБНWННCН РН%▌Н(┬Н,1Н.┘ Н5≈Н7EО7{НєНН┐Н╛НGНН!TtО5сНвО4+НвxН╛О4+О4+Н■tН О4+О4+НnО2└НвО0эНвxНЁО0эО0эН"tНёО0эО0эНО/4Нв xН8О/4О/4Н tН(О/4О/4Н║О-▄НвxНJО-▄О-▄Н╦tН9О-▄О-▄Н°О+ЕНвxНО+ЕО+ЕН┘tНО+ЕО+ЕНiО*=НвxНгО*=О*=Н6tНІО*=О*=Н О(∙НвxН└О(∙О(∙НСtНtО(∙О(∙НвО&МНв xН2О&МО&МН║tН#"О&МО&МН#┘О%EНвxНО%EО%EНotНПО%EО%EНSО#·НвО!ЖНвxН$О!ЖО!ЖНуtН юО!ЖО!ЖН!$О NНвxНО NО NНftН"nО NО NН"ГОіНвОЪНвqО┐НєНН┐Н╛НGНН!НtОшНв О4НвxНО4О4НЩtНtО4О4НвО▄НвОДНвxН╒ОДОДН┴tН!▒ОДОДН" О<НвxНЁО<О<Н"tНёО<О<НО∙НвxН#eО∙О∙Н#тtН(UО∙О∙Н(╦ОМНвxН °ОМОМН! tН%▀ОМОМН%НО EНвxНЎО EО EН,tН#ґО EО EН$О²НвxНrО²О²НYtНпО²О²НJxН&О²О²Н tН#О²О²Н#▐ЪБTVm$GInter-OfficeMemorandum12StopIOP[];UnbreakIOP[where];HereisachecklistofHBcommands:Arm[where];PanelSetupCommandfilescanalsoinitializetilesinthePanelareas."CP[3,0]!Foo"stores"Foo"intotheleftsideofthetileinthethirdrowofthefirstcolumnintheCPPanel."CP[3,0]!Foo_13"setsitupandthenstores13(hex)intoFoo."IOP[..]"isusedtosetupIOPtiles.Tilescanbenamed(forusewithconditionalsandWriteLoc)bypreceedingtheCPwithtileName=.It'sagoodideatousethenameoftheregisterinthetileasthenameofthetile.Conditionals,Branching,HackingSetMP[tileName]putstherightsideofatileintotheMP.(Thisnumberwon'tbeinhex.)Tag:definestagatthecurrentpositioninthecommandfile.GOTO[tag]resumesexecutionofthecommandfileatthepositioncorrespondingtotag.Forwardandbackwardjumpsarebothlegal.IFoperandrelationoperand{...};.EachoperandiseitheratileNameorahexconstant.Therelationsinclude>,>=,<,<=,=,and#.Conditionalscanbenested.LogFilesClose[];closesthecurrentlogfileifthereisoneopen.OpenToAppend[filename];opensalogfileinappendmode.OpenToWrite[filename];opensalogfileinwritemode.Write[quotedstring];writesitsargumentintothelogfile.(Write[]islegal,anddoesn'tdoanything.)WriteLine[quotedstring];writesitsargumentintothelogfile,andthenwritesaCR.WriteLine[]justwritesaCR.WriteLoc[tileName(,width)];writestherightsideofthedesignatedtileintothelogfileinhex.Ifwidthisspecified,leadingblankswillbeaddedtomakethestringwrittenatleastthatwide.WriteTime[];writesthecurrenttimeintothelogfile.Simplenontrivialexample|Mumble.burdock,HGM,March22,19852:18:56amPST|Boot[];Load[MemTest];errorCount=CP[00,0]!errorCount_0;passCount=CP[01,0]!passCount_0;sОfЕН }Н)} vОfЕНEtО_,Нв О]└Нв xНшО]└О]└НбtН9О]└О]└Н°qО[ НєНН┐Н╛НGНН!▄tОYaНвxНЯОYaОYaНьtНOОYaОYaН╡uОVНБНбqОRцНєНeНPНыН ё Н&/Н)Н*╩Н-Н0ЮН4ЁН:ґН>=ОQНБН:Н(Н²Н'ННБН"WН$кН&▌Н)Н,│Н/XН1&Н3⌡Н6┬Н;▓Н=VН?йОOtНБНЩНСНоНUНДН"Н#нН%зН(▀Н+╙Н/└Н1cН4ПН7бН:УН@╡ОMмНБННлНwНeОKQНєНУНvН\НьН ┘Н"ОН&Н-║Н0NН6эН8м Н?ЎОI╙НБНExНpОI╙ОI╙НЮqНОI╙ОI╙ННfН═Н#"Н&+Н'ЙН*oН,чН0ґН2vН4ФН9тН;▓Н>Н@pОHНБНAНН╨НuОDЁНБН1 НqОAdНєxН ОAdОAdНyqНOОAdОAdН3Н5Н!▒Н$ъН'ЁН)iН*▐Н,ЙН/ЎН2Н5 Н9*Н>SО?ҐНБНсН│xО=AНєqО=AНИНїНПН┬НХН$╠Н)СН+║Н.Н4bpО:фНєqНО:фxО:фНgqН8О:фО:фННNН#tН%Н'nН-юН0Н1єН3ТН9'О9НБН░Н1НйН┌Н!ЇН%зН(.Н+jpО6ёНєxО6ёНaН⌡Н╚qО6ёН"ЕН&╦Н*BН/╪Н1>Н5AxН6│О6ёО6ёН6ЯqО6ёН<Н?}О4ЭНБН⌠НVНпН! Н#Н%ЙН'bН*:Н,bН/Н1,Н9%Н;⌡Н=vuО1╛НБН╧qО.]НєНґН≥НЬН!бН$Н&~Н'ъН+iН,тН/─О+БНєxН╧О+БО+БН(qН ╘О+БО+БН!Н" Н&Н'*Н)}Н+ГН-∙Н2─О)fНєxНLО)fО)fН╩qН<О)fО)fН÷Н ²Н$■Н%ЎН(Н*zН,(Н/іО&КНєxНcО&КО&КННкqНО&КО&КНyН│Н"█Н$rН*їН-┼Н/ТН2QН5Н:HН;ЎН?fО%DНБН═Ні О"хНє xНО"хО"хНйНoqН╨О"хО"хН Н!Н%Н&ъН-Н/яН2(Н4sН7-Н9эН<ЗН@ТО!!НБНд Н"НцНеН ОО╔НєxН║О╔О╔НqНГО╔О╔Н`xН9О╔О╔Н qН!aО╔О╔Н!зН#7Н'5Н)░Н,чН/ЁН1hН3ц Н:▐Н<ЙН?ЎОЧНБН%Н~ННxНЙН╩Н Н%Н)чН.'Н0бН2ёН6ЇН8UН;ЫН>HОWНБН∙Н-НSН!ОшНєНчНЮН ?Н% Н(.Н+Н-fН/╧uО▄НБНr Н tО=НСНпНН!─Н%ФН(#Н+iН0RН2іН5╙О∙НСОМНС О EНС О EННzН ▀ Н'ЁН)@О·НС О·ННzН ▀Н':Н(г&TVm$zInter-OfficeMemorandum13reason=CP[02,0]!reason_0;address=CP[03,0]!$address_0;expected=CP[04,0]!expected_0;found=CP[05,0]!found_0;Break[Error];|reason=1|Break[AnotherGoodPass];|reason=2|Loop:Continue[0]:SetMP[passCount]:IFreason=2{GOTO[Loop];}:OpenToAppend["Mumble.log"];WriteTime[];WriteLoc[errorCount,4];WriteLoc[passCount,5];WriteLoc[address,8];WriteLoc[expected,5];WriteLoc[found,5];WriteLine[];Close[];IFerrorCount<100{GOTO[Loop];}:Wantmoredetails?Lookatthecode.It'sCommandFiler.mesa.OddsandEndsBecauseitalreadycontainedrelatedcode,theBurdocksubdirectoryand/ordffilealsoincludeseveralotherhandyprograms.HardwarecheckoutTestUmbilicalisaprogramforcheckingoutDLion-DLionBurdockBoxes.IassumeitworkswithSongboardstoo,butI'venevertriedit.TestUmbilicalisprettysimpleminded,butIhaveforgottenallthedetails.Itprobablyincludesseveralscopeloops.Lookatthesourcecodeifyouhaveanyquestions.TestDebuggerBoardandTestHistoryBufferareusedtodebugtheDicentradebuggerboard.SeetheDicentraManualformoreinformation.CSBankTesterisusedtotestextrabanksofCPControlStore.ItispackagedwithBurdockasaninactivetoolbecausetheDLionusestheCPKerneltosetthebankregister.CPKernelTesterisleftoverfromwhenIwastryingtounderstandhowtheCPKernelworked.Itmightbehandyifyouarechasingobscureproblems.IttooispackagedwithBurdockasaninactivetool.MakingDicentraPROMsMakeControlStoreMBandMakeGermMBareusedtomakeDicentraPROMs.sОfЕН }Н)} vОfЕНEtО_,НСО_,ННzН ▀Н$ЕН&rО]└НСО]└ННzН ▀Н&&Н'ЁО[эНСО[эННzН ▀Н&HН'уОZ5НСОZ5ННzН ▀Н$≥Н&&ОX█НСОX█Н"OН#,Н'├Н)kН*÷ОVЕНСОVЕН"OН#,Н'├Н)kН*÷ОU=НСОS∙НОQМНОPEННТНNН3НhН° Н&ЎОN·НОLЖНОKNНН │ОIіНН ОGЧННDОFVННОD╞ННgОCНОA_НО?ЇННТ ННPНФН! Н*НБН≤НэНкНтН?Н#╗Н&XН(гН+kН/#Н2XН3СН<аН>О#√НБН-НwНчНмНЗН$сН&╘Н(ОН-|Н.зН4▓Н9эН>SО!ОНБНЦН│ННyНхН"Н#pН&'Н)mН, xОsНєqОsН(xН!FОsОsН"-qОsН,ўН/hН3 Н5Н9ЁНН1OН3 Н:GН=[Н?йОъНБН÷НЪН√НґН ҐН%Н&▀Н)aН+тН0щН6Н<▓Н>)Н@╡О8НБНКНН∙НCН!4Н&JuОХНБНН╟xО≥НєqО≥Н▌xН"lО≥О≥Н#аqО≥Н+ЫН.sН1жН3╛Н7┤pН=TО≥О≥Н=ЭqН@ЎО≥О≥НAB^TVm$uInter-OfficeMemorandum14TheyregisterExeccommandswiththecorrespondingname.MesaDebuggingWhenbringingupthefirstmemberofanewfamilyofmachines,thereisatimewhenitmostlyruns,buttheEmulatororGermdoesn'tworkwellenoughtobeTeleDebugged.Atthisstage,youendupdoingalotofpointerchasingtofollowstacksandsuch.Machinesaregoodatthatsortofthing.I'mlazy.CPMesaisatoolthatisincludedwithBurdock.Normallyit'sinactive.Ithastwocommands.DispStackdisplaysthecurrentstackinHEX.Eachframeisaseparateline.ListProcdisplaysthecurrentlistofprocesses.CPSymbolsCPSymbolsDebugisanothernormallyinactivetoolthatcomespackagedwithBurdock.It'sleftoverfromwhenIwasdebuggingthesymboltablemachinery.Itwilldumpthesymboltablesintoalogfile.Ifyouaretryingtounderstandalltheusesforalloftheregisters,thismightbehandy.(UsetheWhatcommandifyouarejustinterestedinafewregisters.)sОfЕН }Н)} vОfЕНEqО_/НБНkНIН╔Н!▀Н$╔Н'Н/ЭuО[ЮНБН╛qОX▓НєНщН┐НЇН 9Н#2Н(бН*²Н+ИН.ЬН3^Н59Н;╩Н?gН@ТОVЙНБННуН8НЄН3Н!аН$-Н*MН,Н0+Н4ЖН8Н;yН@oОUCНБНхНOН@НвН"≈Н%DН'ЯН)ЬН-оН.НН0УН2єН7bНН?╘ОOyНБНtН√НЪН$Н&`Н+Н.hpН/ШОOyОOyН0БqН2oОOyОOyН30Н6┴Н:eН;ІН<еОMрНБНПН^Н∙НТН#ЎН%ЭН'╣ uОJ┐НБНAxОG5Нє qОG5НьНcН#▌Н)~Н.ЁН1÷Н4█Н8зН?ОE█НБНЕНVН}Н Н#яН$ЖН'ЎН.■Н1Н5УН9y Н@іОCФНБН≤НіННДН шН#ЎН$СН'QН*Н+╘Н.kН0йН4жН6░ Н=цН?ЎОB?НБНРНFНLНН▓ Н dН#Н'*Н)1Н-нН1+Н3║Н7xН=ОН?gО@≈НБН5Нв Н"НпНЗН⌡ 5TVm$░Ъ TIMESROMANЧ÷ЪGACHAЧ÷Ъ HELVETICAЧ÷Ъ TIMESROMANЧ÷ЪLAURELЧ÷Ъ TIMESROMANЧYЪLOGOЭЄЪ TIMESROMANЧ÷Ъ TIMESROMANЧФ█S Ш o ) П3; ЧD GMґUг\rcшiтmj/pn·raRЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪ[]<>BurdockManual.tioga&Wednesday, March 27, 1985 11:35 pm PST