Assignmentssmartdrv

MMEVS0508OM/DMODULAREVALUATIONSYSTEMfor68HC05and68HC08OPERATIONSMANUALMICROCONTROLLERSMotorola,Inc.
,1995;AllRightsReservedMotorolareservestherighttomakechangeswithoutfurthernoticetoanyproductshereintoimprovereliability,function,ordesign.
Motoroladoesnotassumeanyliabilityarisingoutoftheapplicationoruseofanyproductorcircuitdescribedherein;neitherdoesitconveyanylicenseunderitspatentrightsnortherightsofothers.
Motorolaproductsarenotdesigned,intended,orauthorizedforuseascomponentsinsystemsintendedforsurgicalimplantintothebody,orotherapplicationinwhichthefailureoftheMotorolaproductcouldcreateasituationwherepersonalinjuryordeathmayoccur.
ShouldBuyerpurchaseoruseMotorolaproductsforanysuchunintendedorunauthorizedapplication,BuyershallindemnifyandholdMotorolaanditsofficers,employees,subsidiaries,affiliates,anddistributorsharmlessagainstallclaims,costs,damages,andexpenses,andreasonableattorneyfeesarisingoutof,directlyorindirectly,anyclaimofpersonalinjuryordeathassociatedwithsuchunintendedorunauthorizeduse,evenifsuchclaimallegesthatMotorolawasnegligentregardingthedesignormanufactureofthepart.
MotorolaandtheMotorolalogoareregisteredtrademarksofMotorolaInc.
MotorolaInc.
isanEqualOpportunity/AffirmativeActionEmployerMS-DOSisaregisteredtrademarkofMicrosoftCorporation.
IBMisaregisteredtrademarkofIBMCorporation.
MMEVS05softwareisP&EMicrocomputerSystems,Inc.
*,1995;AllRightsReserved.
PortionsofthesoftwareareBorlandInternational,1987.
PortionsofthesoftwareareTurboPowerSoftware,1988.
_______*P&EMicrocomputerSystems,Inc.
P.
O.
Box2044Woburn,MA01888-2044(617)353-9206MOTOROLA3ListofSectionsTableofContents5GeneralDescription7Installation13LoadingandInitialization21UserScreens27OperationFundamentals45Command-LineCommands61S-RecordInformation137Index.
1434MOTOROLAListofSectionsMOTOROLACSICMICROCONTROLLERSMMEVS0508OM/DMOTOROLATableofContents5TableofContentsGeneralDescriptionContents7Introduction7AboutthisManual8SystemFeatures9SystemComponents10HostComputerRequirements.
11Acronyms.
12InstallationContents13Introduction14ConfiguringthePlatformBoard15InstallingtheEM17RemovingtheEM17MakingSystemConnections.
18ResetSwitch19SerialConnectorandCableInformation20LoadingandInitializationContents21SoftwareDistributionFormat.
22InstallingMMEVSSoftware.
22PersonalityFiles23UsingMMEVSSoftware23MMEVSCommunication26TableofContentsMMEVS0508OM/D6TableofContentsMOTOROLAUserScreensContents27Introduction28MainWindowScreens.
28Pop-UpWindows.
37MouseOperation.
42ChangingScreenColors44OperationFundamentalsContents45Introduction46SystemInitialization.
46SystemCommands52DebugCommands.
57Command-LineCommandsContents61Introduction64CommandSyntax64CommandExplanations66S-RecordInformationContents137Introduction137S-RecordContent138S-RecordTypes.
139S-RecordCreation.
140S-RecordExample140Index143MMEVS0508OM/DMOTOROLAGeneralDescription7GeneralDescriptionContentsIntroduction7AboutthisManual8SystemFeatures.
9SystemComponents.
10HostComputerRequirements11Acronyms12IntroductionTheM68MMEVS05/08MotorolaModularEvaluationSystem(MMEVS)isatoolfordevelopingembeddedsystemsbasedonanMC68HC05orMC68HC08microcontrollerunit(MCU).
TheMMEVSisamodularemulationsystemthat,whenconnectedtoauser'stargetsystem,givestheuserinteractivecontrolofamicrocontrollerapplication.
TheRAPIDsoftwareprovidesanintegrateddevelopmentenvironmentandincludesaneditor,assembler,andauserinterfacetotheMMEVSsystem.
Theenvironmentallowsforsource-leveldebuggingandsimplifieswritinganddebuggingcodeforanembeddedMCUsystem.
Thesefeaturessignificantlyreducedevelopmenttime.
AcompleteMMEVSsystemcontainstheplatformboard(M68MMPFB0508),anemulationmodule(EM),andatargetcableassembly.
AnEMcompletesMMEVSfunctionalityforaparticularMCUorMCUfamily.
ToaccommodateemulationofthenumerousMCUsavailable,theMMEVSusesavarietyofdifferentEMs.
Refertotheappropriateuser'sGeneralDescriptionAboutthisManualMMEVS0508OM/D8GeneralDescriptionMOTOROLAmanualforEMinstallationinstructions.
Forconnectiontoatargetsystem,aseparatelypurchasedtargetcablewiththeappropriatetargetheadalsoisneeded.
TousetheMMEVS,anIBM(orcompatible)hostcomputerandauser-suppliedpowersupplyareneeded.
A9-to-25pinRS-232serialcablealsoisprovidedwiththeMMEVS.
AboutthisManualThismanualcoversMMEVSsoftware,hardware,andreferenceinformationasfollows:Installationonpage13explainsM68MMPFB0508hardware.
LoadingandInitializationonpage21explainshowtoloadandinitializetheMMEVSsystemsoftware.
UserScreensonpage27explainsthewindowscreens,aswellashowtouseamouse.
OperationFundamentalsonpage45describescommandusages.
Command-LineCommandsonpage61explainsMMEVScommandsyntax.
S-RecordInformationonpage137givesreferenceinformationaboutMotorolaS-records.
GeneralDescriptionSystemFeaturesMMEVS0508OM/DMOTOROLAGeneralDescription9SystemFeaturesTheMMEVSisafull-featureddevelopmentsystemthatprovidesin-circuitemulation.
Itsfeaturesinclude:Real-time,non-intrusive,in-circuitemulationMC68HC11K1systemcontrollerforfastcommandtransfer64KbytesofemulationmemorytoaccommodatethelargestavailableROMsize64hardwareinstructionbreakpointsoverthe64-KmemorymapADOSpersonalityfileforeachEM.
Eachpersonalityfileprovidesaforegroundmemory-mapdefinition.
Latch-upresistantdesign(47-seriesresistoronI/Oconnectionstothetargetsystem)tomakepower-upsequencingunimportant.
Foursoftware-selectableinternallygeneratedoscillatorclocksourcesCommandandresponseloggingtodiskfilesSCRIPTcommandforautomaticexecutionofasequenceofMMEVScommandsAssembly-languagesource-leveldebuggingRS-232operationspeedsashighas57600baudOn-screen,context-sensitivehelpviapop-upmenusandwindowsCHIPINFOcommandformemory-map,vectors,register,andpin-outinformationpertainingtothedevicebeingemulatedGeneralDescriptionSystemComponentsMMEVS0508OM/D10GeneralDescriptionMOTOROLAEmulationthatallowsmultipletypesofreset:–RESETcommandresetstarget–RESETGOcommandresetstargetandbeginsexecution–WAIT4RESETcommandresetstargetviatargethardwareassertionoftheRESETsignalMouseorkeyboardcontrolofhostsoftwareStatuslinethatdisplayssuchinformationasemulatorstate,communicationsport,andcommunicationsrateCompactsize:8.
25inchesdeep,10.
5incheswideConnections,configuration,specifications,andotherrelatedinformationisexplainedintheinstallationsectionofthisdocument.
ForsimilarinformationwithregardtoEMs,seethecorrespondingEMuser'smanual.
SystemComponentsThefollowingitemsareincludedwiththeM68MMPFB0508:Platformboard:TheM68MMPFB0508platformboard9-to-25pinRS-232serialcable:ThecablethatconnectsthestationmoduletothehostcomputerRS-232port.
Serialadapter:DB9MtoDB25FRS-232adapterforconnectingtoa25-pinserialportonahostsystem.
Systemsoftware:RAPIDintegrateddevelopmentenvironmentfeaturingeditor,assembler,andassemblysourceleveldebugger(3.
5-inchdiskettes)RAPIDdocumentation:ARAPIDIntegratedDevelopmentEnvironmentUser'sManualMMEVSdocumentation:AnMMEVS05/08OperationsManual(MMEVS0508OM/D–thismanual).
SoftwareReleaseGuide:Documentationonthecurrentreleaseofsystemsoftware.
GeneralDescriptionHostComputerRequirementsMMEVS0508OM/DMOTOROLAGeneralDescription11SeparatelypurchasedMotorolapersonalityproductsinclude:Anemulationmodule(EM):OneofmanyprintedcircuitboardsthatcompleteMMEVSfunctionalityforoneormoreparticularMCUs.
ThetwoDINconnectorsonthebottomoftheEMfitintoconnectorsonthetopoftheM68MMPFB0508platformboardforpowerandsignalconnections.
TheEMalsohasaconnectorforthetargetcable.
EMsarepurchasedseparatelyfromtheplatformboardandareshippedwithauser'smanualcontaininginformationspecifictothemodule.
Optionaltargetcable:Aseparatelypurchasedtargetcablethatispartofacableassembly,usedtoconnectthetargetsystemtotheMMEVSsystemOptionaltargetheadadapter:Aseparatelypurchasedtargetheadadapterthatispartofacableassembly,usedtoconnectthetargetsystemtotheMMEVSsystemUsersuppliedcomponentsinclude:Hostcomputer:ForfurtherinformationrefertoHostComputerRequirementsPowersupply:Requiredpoweris+5volts@1ampHostComputerRequirementsThehostcomputerfortheMMEVSmustbehardwareandsoftwarecompatiblewithIBMATorPS/2computers.
ThehostcomputermustrunDOS5.
0orlaterversions.
Thehostsoftwarerequiresapproximately512Kbytes.
Anasynchronouscommunicationsport,configuredasCOM1,COM2,COM3,orCOM4,isrequiredforcommunicationsbetweentheMMEVSandthehostcomputer.
GeneralDescriptionAcronymsMMEVS0508OM/D12GeneralDescriptionMOTOROLAForimprovedproductperformance,additionalsystemenhancementscanbeadded.
Theseare:80386-or80486-basedsystems,aharddiskdrive,andahigh-resolutioncolormonitorwitheitheranEGAorVGAgraphicsadaptercard.
TheMMEVSsystemsoftwarealsosupportsaMicrosoft,Logitech,orIBMmouse.
Othermicemaybecompatible,butMotoroladoesnotguaranteetheirsatisfactoryperformancewithMMEVSsoftware.
AcronymsTable1providesdefinitionsfortheacronymsusedthroughoutthismanual.
Table1.
AcronymDenitionsTermDescriptionM68MMPFB0508TheplatformboardwherecommonhardwareforallM68HC05andM68HC08emulationresides.
EMAnemulationmodulethatconnectstotheplatformboardtocustomizetheMMEVSforaparticularMCUorfamilyofMCUs.
RAPIDAnintegrateddevelopmentenvironmentthatincludesaneditorandallowsapplicationssuchasassemblersanddebuggerstobeblendedintoasingleenvironment.
MMEVSMotorolaModularEvaluationSystem.
Agenerictermthatdescribesatwo-boardevaluationsystemconsistingoftheplatformboard,oneofmanyemulationmodules,andsystemsoftware(RAPIDintegrateddevelopmentenvironment,CASMassemblerandMMEVSdebugger).
CASMCrossassemblerthatassemblesM68HC05(CASM05)orM68HC08(CASM08)code.
MMEVS05MotorolaModularEvaluationSystemforM68HC05emulation.
RequiresMMEVS05debuggersoftwareandanemulationmodulethatsupportsaM68HC05MCU.
MMEVS08MotorolaModularEvaluationSystemforM68HC08emulation.
RequiresMMEVS08debuggersoftwareandanemulationmodulethatsupportsaM68HC08MCU.
MMEVS0508OM/DMOTOROLAInstallation13InstallationContentsIntroduction14ConfiguringthePlatformBoard.
15FactoryTestHeader(J1)15PortVoltageControlHeaders(J2–J4)16InstallingtheEM17RemovingtheEM17MakingSystemConnections18HostComputerConnection18TargetCableConnection18PowerConnection19ResetSwitch.
19SerialConnectorandCableInformation.
20InstallationIntroductionMMEVS0508OM/D14InstallationMOTOROLAIntroductionCompleteMMEVSinstallationconsistsofconfiguringtheplatformboard,configuringandinstallingtheappropriateemulationmodule(EM),andmakingsystemcableconnections.
Consulttheintroductorysectionofthisdocumentforalistofallthesystemcomponents,includingaseparatelypurchasedEM.
NotethatEMconfigurationisspecifictoaparticularEM;followtheguidanceofthespecificEMuser'smanual.
FollowtheguidancegiveninthissectiontocompletetheMMEVSinstallation.
Figure1showstheM68MMPFB0508platformboard.
ThehardwareresetswitchandpowerLEDareonthefrontoftheplatformboard.
Thepowerconnectoristothebackandthe25-pinRS-232serialconnectorisontheleftfacingtheplatformboard.
Thecircularconnector,P4,isalsoontheleftsideoftheplatformboard.
Thisconnectoristhe+5-voltoutconnector,whichisreservedforfuturefeatures.
NOTE:Thismanualusesthewordsleftandrightrelativetoleftandrighthandsastheuserfacesthefrontoftheplatformboard.
Figure1.
M68MMPFB0508PlatformBoardPOWERLEDHARDWARERESETSWITCH+5VOUTPOWERCONNECTORRS-232SERIALCONNECTOREMMODULEDINCONNECTORS(FRONTSIDE)InstallationConfiguringthePlatformBoardMMEVS0508OM/DMOTOROLAInstallation15ConfiguringthePlatformBoardTheM68MMPFB0508platformboardhasfourjumperheaders,alllocatednearthefrontoftheplatformboard.
JumperheaderJ1isforfactorytest.
Dependingonthedesignofeachemulationmodule,jumperheadersJ2,J3,andJ4maycontrolthevoltagelevelsforportsAthroughD.
NOTE:ThefactoryconfigurestheplatformboardcorrectlyforvirtuallyallusersbeforeshippingtheM68MMPFB0508.
Theseplatformboardjumpersshouldnotbereconfiguredunlessinstructedtodosobyanemulationmodule(EM)user'smanual.
FactoryTestHeader(J1)ThisdiagramshowsthefactoryconfigurationofjumperheaderJ1.
Thefabricatedjumperbetweenpins1and2iscorrectforMMEVSoperation.
Thealternatejumperpositionhassignificanceonlyforfactorypersonnel.
123RUNBOOTJ1FABRICATEDJUMPERInstallationConguringthePlatformBoardMMEVS0508OM/D16InstallationMOTOROLAPortVoltageControlHeaders(J2–J4)JumperheadersJ2throughJ4,locatedneartherightfrontcorneroftheplatformboard,setthevoltagelevelsforportsAthroughD.
Thefollowingdiagramshowsthefactoryconfiguration.
Thefabricatedjumpersbetweenpins1and2oftheseheaderssetthe+5-voltlevelforallports.
ThisisthecorrectconfigurationforMMEVSoperation,unlesstheEMuser'smanualsaysthattheEMisalow-voltageboard.
IftheEMcanoperateatlowvoltage,anyoftheportscanbeoperatedatthelow-voltagelevel.
Todoso,repositionthefabricatedjumperofthecorrespondingheadertopins2and3.
JumperheaderJ2controlsthevoltagelevelofportA,jumperheaderJ3controlsthevoltagelevelofportB,andjumperheaderJ4controlsthevoltagelevelofportCorD,whicheverpertainstotheEM.
123J2FABRICATEDJUMPERSJ3J4PORTAPORTBPORTC/DVPRU+5InstallationInstallingtheEMMMEVS0508OM/DMOTOROLAInstallation17InstallingtheEMFollowsteps1through3toinstallanEM:1.
Makesurethatplatformboardpowerisoff.
2.
Makesurethatnylonspacersareinthecorrectpositionsfortheemulationmodule(EM).
3.
InstalltheEMontheplatformboard:Carefullyfitthefemale96-pinconnectors(locatedonthebottomoftheEM)ontothecorrespondingmaleDINconnectorsonthetopoftheplatformboard.
SnaptheEMontothenylonspacersandmakesurethattheDINconnectorsarejoinedtogetherfirmly.
NOTE:ManyEMboardsmayhave64-pinfemaleDINconnectors.
Ifso,thesewillmatewiththemaleDINconnectorsontheplatformboard.
Thekeyedplasticontheconnectorwillensureproperalignment.
RemovingtheEMFollowsteps1and2toremoveanEM:1.
Turnoffthepowersupplytotheplatformboard.
2.
DisconnectthetargetcablefromtheEMtargetconnector.
UnsnapallnylonspacersfromtheedgesoftheEM.
ThencarefullylifttheEMstraightup,separatingitfromtheplatformboard.
InstallationMakingSystemConnectionsMMEVS0508OM/D18InstallationMOTOROLAMakingSystemConnectionsThespecificapplicationdeterminesthenumberofMMEVSconnectionsrequired.
Attheveryleast,theplatformboardandEMmustbeconnectedtothehostcomputerandtoapowersupply.
Cableconnectionsareexplainedinthefollowingsections:HostComputerConnection,TargetCableConnection,andPowerConnection.
HostComputerConnectionUsethe9-to-25pinserialcabletoconnectahostcomputer's9-pinserialporttotheMMEVS25-pinserialcableconnector(ontheleftsideoftheplatformboard).
Notewhichcomputerserialportisused.
IftheCOM1port(thedefault)isnotused,theportnumbermustbespecifiedintheMMEVSsoftwarestart-upcommand.
IfthedevelopmentsystemisoperatedintheRAPIDenvironment,RAPIDmustbeconfiguredtocommunicatethroughtheproperserialport.
TargetCableConnectionIftheMMEVSwillinterfacewithauser'stargetsystem,thetargetsystemshouldbeconnectedtotheEMboardthroughatargetcableassembly.
Acableassemblyconsistsofatargetheadandatargetcable.
ThetargetconnectorwillbeontherightsideoftheEMmodule.
ConnectoneendofthetargetcabletotheEMtargetconnectorandtheotherendofthetargetcabletotheuser'stargetsystembeforepower-up.
SeethespecificEMuser'smanualforspecificinformationonthetargetheadandtheappropriatetargetcable.
Makesurethatthetargetheadandtargetcablematecorrectly.
ConsulttheEMmanualforproperconnection.
Connectingthetargetcableanyotherwaycandamagethesystem.
Whenconnectingatargetcable,pressonlyontherigidplasticconnectorsateitherendofthecable.
Pressingontheflexiblepartofthecablecandamagethecable.
InstallationResetSwitchMMEVS0508OM/DMOTOROLAInstallation19PowerConnectionThefinalMMEVSconnectionisauser-suppliedpowersupply.
TheMMEVSrequiresa+5Vdc@1.
0amppowersupply.
UseleverterminalP3toconnectpowertotheMMEVS.
Contact1(blacklever)istheground.
Contact2(redlever)isforVDD,the+5Vdcpower.
Use20or22AWGwireforpowerconnections.
Foreachwire,trimtheinsulationbackashortdistancefromtheend,lifttheappropriateP3lever,insertthebarewireintoP3,andclosethelever.
Donotusewirelargerthan20AWGinconnectorP3becausesuchwirewilldamagetheconnector.
MakesurethepowertotheplatformboardisturnedoffwheninstallingtheEMorremovingtheEMfromtheM68MMPFB0508.
SuddenpowersurgescandamageMMEVScircuits.
Thiscompletesthecableconnections.
TheMMEVSsoftwareisreadytobeinstalledinthehostcomputer.
ResetSwitchRS-232handshakesignalscontrolMMEVSresets.
Aresetinitializesthecontrolboardfromitsstart-uppoint.
Ifthecomputerserialportdoesnotimplementhandshaking,resettheMMEVSmanually.
Pressgentlytotriptheswitch.
InstallationSerialConnectorandCableInformationMMEVS0508OM/D20InstallationMOTOROLASerialConnectorandCableInformationThissectioncontainspinidentificationandsignalnamesforconnectorscommontoallMMEVSsystems.
ForpinoutinformationforaparticularEMconnector,refertothecorrespondingEMuser'smanual.
Thisdiagramshowspinnumberingforthe25-pinserialconnectorofthecontrolboard.
Table1liststhesignalavailableateachpin,aswellasthesignalstransmittedonthe9-leadserialcable.
Table1.
SerialConnectorandCablePinAssignmentsConnectorPinMnemonicSignal1GNDGROUND2TXTRANSMITDATA—Serialdatainputline3RXRECEIVEDATA—Serialdataoutputline4RTSREQUESTTOSEND—Inputsignalthatrequestspermissiontotransferdata5CTSCLEARTOSEND—Outputsignalthatindicatesaready-to-transferdatastatus6DSRDATASETREADY—Outputsignalthatindicateson-line/in-lineservice/activestatus7SIG-GNDSIGNALGROUND—SignalgroundorcommonreturnconnectionbetweentheMMEVSandhostcomputer8DCDDATACARRIERDETECT—Outputsignalthatindicatesdetectionofanacceptablecarriersignal9-19,21-25—Noconnection20DTRDATATERMINALREADY—Inputsignalthatindicateson-line/in-line/activestatus1131425MMEVS0508OM/DMOTOROLALoadingandInitialization21LoadingandInitializationContentsSoftwareDistributionFormat22InstallingMMEVSSoftware22PersonalityFiles23UsingMMEVSSoftware23RunningMMEVS0524RunningMMEVS0825MMEVSCommunication.
26LoadingandInitializationSoftwareDistributionFormatMMEVS0508OM/D22LoadingandInitializationMOTOROLASoftwareDistributionFormatMMEVSsoftwareisdistributedon3.
5-inchhigh-densitydiskettes.
TheinstallprocessplacestheRAPIDenvironmentfilesandtheMMEVSsoftwarefilesinthedirectorydesignatedduringtheinstallprocess.
Table2describesthesystemfilesrequiredtocontroltheMMEVSsystem,wherexdenotesaversionnumber.
RefertotheSoftwareReleaseGuideforinformationonotherfilesloaded.
InstallingMMEVSSoftwareTheinstallprocesswillplaceMMEVSandallsupportingfilesonaharddrive.
ToinstalltheMMEVSfiles,insertthedistributiondiskettesintoanactivedrive.
Maketheinstallationdriveactivebytypingthedriveletterfollowedbyacolon(:)andpress.
TypeINSTALLandpress.
Followthedirectionsaspromptedbytheinstallsoftware.
RefertotheSoftwareReleaseGuideforfurtherinformationontheinstallationprocess.
Table2.
MMEVSSoftwareFilesFileNameDescriptionMMEVS05.
EXEMMEVS05hostsoftwareMMEVS05X.
EXEMMEVS05hostsoftwareforrunninginaDOSwindowunderWindowsMEVS05Vx.
HLPHELPcommandwindowsfortheMMEVS05commandsMMEVS08.
EXEMMEVS08hostsoftwareMMEVS08X.
EXEMMEVS08hostsoftwareforrunninginaDOSwindowunderWindowsMEVS08Vx.
HLPHELPcommandwindowsfortheMMEVS08commandsLoadingandInitializationPersonalityFilesMMEVS0508OM/DMOTOROLALoadingandInitialization23PersonalityFilesVariousdesignsofMCUsrequiredifferentconfigurationsoftheMMEVSsystem.
TheappropriatesetupforeachMCUisspecifiedinauniquepersonalityfile.
NOTE:ThesefilesareshippedwithseparatelypurchasedEMs.
PersonalityfilesareusuallyinstalledinthedirectoryfromwhichtheMMEVSsoftwareisexecuted.
Thesepersonalityfileshaveastandardextensionof.
MEM.
Ifapersonalityfileisnotlocatedintheworkingdirectory,thesoftwaredisplaysasearchwindowusedtofindthecorrectfile.
TodeterminethepersonalityfilesusedbyaparticularEMmodule,refertotheappropriateEMuser'smanual.
Morethanonepersonalityfilecanbeinstalled;theMMEVSoperatingsoftwareautomaticallyloadsthedefaultpersonalityfilethatcorrespondstothecurrentlyconnectedEMmodule.
Asdiscussedinthefollowingparagraph,otherpersonalityfilescanbeloadedviatheLOADMEMcommandorthroughuseofthe–Moption.
UsingMMEVSSoftwareThecorrectexecutablefiletorunisdependentonwhichtypeEMisinstalledontheMMEVSplatformboard.
IfanHC05EMisinstalled,theMMEVS05.
EXEfileshouldberun.
IfanHC08EMisinstalled,theMMEVS08.
EXEfileshouldberun.
ThefollowingparagraphsdiscussthepropersyntaxforrunningtheHC05andHC08software.
Alternatively,theMMEVScanbecalledfromwithintheRAPIDenvironment.
RunningtheMMEVS05orMMEVS08fromRAPIDmayrequirerunningRINSTALL,RAPID'sconfigurationset-upprogram,tosetupthedirectorypath,serialport,etc.
,asdescribedintheRAPIDuser'smanual.
NOTE:IfyouplantousetheMMEVSsoftwareinaDOSwindowunderWindows,usetheMMEVS05X.
EXEorMMEVS08X.
EXEfiles.
LoadingandInitializationUsingMMEVSSoftwareMMEVS0508OM/D24LoadingandInitializationMOTOROLARunningMMEVS05TocalltheexecutabledirectlyfromtheDOSprompt,typethiscommand:C:\MMEVS05>MMEVS05Notethesefiveoptionsforthestartupcommand:1.
IftheMMEVS05isconnectedtoCOM2,COM3,orCOM4,addthecorrespondingintegertothecommand:C:\MMEVS05>MMEVS0522.
Ifthecomputerhasamonochromemonitor,addBWtothecommand:C:\MMEVS05>MMEVS05BW3.
Tospecifyapersonalityfiletobeloadedautomatically(insteadofthedefault),addthe–Moption,followedbythefilename(DonotputaspacebetweentheMandthefilename).
Ifthespecifiedpersonalityfilehasa.
MEMextension,the.
MEMextensionmaybeomittedfromthefilename:C:\MMEVS05>MMEVS05–M4.
TospecifyanS-recordfile(andanymapfilewiththesamename)tobeloadedautomatically,addthefilenameoption.
IfthespecifiedS-recordfilehasa.
S19extension,the.
S19extensionmaybeomittedfromthefilename:C:\MMEVS05>MMEVS055.
Tospecifyadefaultbaudrateof9600,addthe–Boption:C:\MMEVS05>MMEVS05–BNOTE:Multipleoptionsinthestart-upcommandshouldbeseparatedbyaspace.
LoadingandInitializationUsingMMEVSSoftwareMMEVS0508OM/DMOTOROLALoadingandInitialization25RunningMMEVS08TocalltheexecutabledirectlyfromtheDOSprompt,typethiscommand:C:\MMEVS08>MMEVS08Notethesefiveoptionsforthestartupcommand:1.
IftheMMEVS08isconnectedtoCOM2,COM3,orCOM4,addthecorrespondingintegertothecommand:C:\MMEVS08>MMEVS0822.
Ifthecomputerhasamonochromemonitor,addBWtothecommand:C:\MMEVS08>MMEVS08BW3.
Tospecifyapersonalityfiletobeloadedautomatically(insteadofthedefault),addthe–Moption,followedbythefilename.
(DonotputaspacebetweentheMandthefilename.
)Ifthespecifiedpersonalityfilehasa.
MEMextension,the.
MEMextensionmaybeomittedfromthefilename:C:\MMEVS08>MMEVS08–M4.
TospecifyanS-recordfile(andanymapfilewiththesamename)tobeloadedautomatically,addthefilenameoption.
IfthespecifiedS-recordfilehasa.
S19extension,the.
S19extensionmaybeomittedfromthefilename:C:\MMEVS08>MMEVS085.
Tospecifyadefaultbaudrateof9600,addthe–Boption:C:\MMEVS08>MMEVS08–BNOTE:Multipleoptionsinthestartupcommandshouldbeseparatedbyaspace.
LoadingandInitializationMMEVSCommunicationMMEVS0508OM/D26LoadingandInitializationMOTOROLAMMEVSCommunicationThehostprogramestablishescommunicationswiththeMMEVSsystemanddisplaystheappropriatedebugscreenasshowninthesectiononuserscreens.
Ifthehostprogramfailstoestablishcommunications,anerrorscreenappearsandthesystemoperationisreturnedtoDOS.
Theinformationintheerrorscreenhelpsdeterminewhythesoftwaredoesnotrun.
Forbestperformanceofthesystem,communicationsbetweenthehostandthestationmoduleshouldbeatthemaximumavailablebaudrate.
Atpower-up,thehostsoftwareautomaticallysetsthemaximumbaudforthesystem.
Reducethebaudrateifacommunicationerrormessageappears.
RefertoRunningMMEVS05andRunningMMEVS08ontheprecedingpagestosetthestartupbaudrateat9600.
Ifcommunicationerrorspersist,turnoffthediskcache(SMARTDRV.
EXE)onthecomputer.
EntercommandsinresponsetotheMMEVScommandprompt(>).
Whentheemulationanddebuggingsessionhasbeencompleted,terminatethesessionbyenteringtheEXITorQUITcommand.
MMEVS0508OM/DMOTOROLAUserScreens27UserScreensContentsIntroduction28MainWindowScreens28StatusArea.
32CPUWindow33Source/CodeF2Window33CodeF2Window33SourceWindow34VariablesF8Window35MemoryF3Window35DebugF10Window36Pop-UpWindows37StackWindow38SetMemoryWindow39BaudWindow40EmulatorClockFrequencyWindow41OtherWindows42MouseOperation42ChangingScreenColors.
44UserScreensIntroductionMMEVS0508OM/D28UserScreensMOTOROLAIntroductionTheuserinterfacescreentotheMMEVSdevelopmentsystemconsistsofastatusarea,fivestaticmainwindowsandseveralpop-upwindows.
Thescreendisplaysthecode,dataandstatusinformationrequiredfortheusertocontroltheemulationenvironment.
Thissectionprovidesadescriptionofthescreenfunctionality,includingmouseoperation.
MainWindowScreensFigure2andFigure3showthedebugscreenfortheMMEVS05andtheMMEVS08versionsofthesoftware,respectively.
ThescreenisidenticalforbothversionsofthesoftwareexceptfortheCPUwindow.
Thescreenconsistsofastatusareaandfivestaticwindowswhichdisplaysourceorobjectcode,variables,thecommandlineandthecontentsoftheCPUregistersormemory.
Tocarryoutactionsassociatedwithawindowofthedebugscreen,selectthewindow.
Toselectawindow,pressthenumberedfunctionkeyincludedinthewindowtitle.
Forinstance,presstheF2keytoselectthesource/codeF2window,presstheF8keytoselectthevariablesF8window,andsoforth.
Toreturntothedebugcommandline,pressF10.
Notethatseveraloperationscanalsobemousecontrolled.
RefertoMouseOperationonpage42fordetailedinformationonmouseusage.
Table3liststhekeycommandsavailableinanyofthemainwindows.
UserScreensMainWindowScreensMMEVS0508OM/DMOTOROLAUserScreens29Figure2.
MMEVS05DebugScreenMEMORYF3008053313D4443484152S1=DCHAR0088472F434841524745G/CHARGE00900420202053323D4F.
S2=000985054494F4E532020PTIONSCPUAcc00PC0029XregB9SPFFCCR111HIN.
CVARIABLESF8RSLTCLKTIMECURVALDISLINE1$0000!
0$30%00110000$00%00000000S1=DCHARdeleteSOURCE:init.
asmbeginldastapcresetinlogfileCOM1:57600clrbgnldxclrasta-B>incxcpxbne#$40tcr#flag0,xrslt+4clrbgn;clearsbrgostopgotilstepinfozoomidleInstbrkpt/IllegalAddressDEBUGF10>BR0029>g>idle>Instbrkpt/IllegalAddressF1:HelpF2:CodeF3:MemF8:varsF9:rptF10:Debug↑↓↑↓↓↓↑↑UserScreensMainWindowScreensMMEVS0508OM/D30UserScreensMOTOROLAFigure3.
MMEVS08DebugScreenMEMORYF3005053313D4443484152S1=DCHAR0058472F434841524745G/CHARGE00600420202053323D4F.
S2=000685054494F4E532020PTIONSCPUAccFEPC00A8Hreg00SP00F3CCR.
11.
IN.
.
VARIABLESF8RSLTCLKTIMECURVALDISLINE1$0000!
0$30%00110000$E7%11100111S1=DCHARdeleteSOURCE:init.
asmbeginldastapcresetinlogfileCOM1:57600-B>clrbgnldxclrastaincxcpxbne#$40tcr#flag0,xrslt+4clrbgn;clearsbrgostopgotilstepinfozoomidleInstbrkpt/IllegalAddressDEBUGF10>BR00A7>g>idle>Instbrkpt/IllegalAddressF1:HelpF2:CodeF3:MemF8:varsF9:rptF10:Debug↑↓↑↓↓↑↓↑F1XregtargetpwrUserScreensMainWindowScreensMMEVS0508OM/DMOTOROLAUserScreens31Table3.
KeyFunctionalityofDebugScreenWindowsKeyDescriptionF1ActivatetheHELPpop-upwindowF2ActivatetheCodeF2window(ifobjectcodeisdisplayed)F3ActivatetheMemoryF3windowF8ActivatetheVariablesF8windowF9RepeattheprecedingcommandF10orReturnstodebugF10window↑Scrollsthewindowdownoneline,sameasclickingonthe↓symbolatwindowedge↑Scrollsthewindowuponeline,sameasclickingonthe↑symbolatwindowedgePageDownScrollsthewindowdownonepagePageUpScrollsthewindowuponepageAlt-XTerminateshostsessionAlt-SWritesscreencontentstologleHomeScrollsthewindowtothehomelineDeleteahighlightedvariableintheVariablesF8windowUserScreensMainWindowScreensMMEVS0508OM/D32UserScreensMOTOROLAStatusAreaThestatusarea,locatedattheleftcenterofthedebugscreen,displaysseveralitemsofstatusinformation.
Table4explainstheindicatorsthatmayappearinthisarea.
Table4.
StatusAreaIndicatorsIndicator,PositionStatus,MeaningMCUstate,leftscreenedgeabovedebugF10windowIdle,Running,Stopped,Wait,orInResetfollowedbythereasonforastatuschangeRESETINsignalstate,belowsource/codeF2windowResetin—TargetsystemcanresetemulatingMCU(blank)—TargetsystemcannotresetemulatingMCURESETOUTsignalstate,betweenvariablesF8andmemoryF3windowsResetout—RESETcommandresetsemulatingMCUandthetargetsystem(blank)—RESETcommandresetsonlytheemulatingMCULoggingstate,betweenvariablesF8andmemoryF3windowsLogle—Logginginprogress(blank)—LoggingnotinprogressTargetsystempower,betweenvariablesF8andmemoryF3windowsTargetpwr—Targetsystempowerison(blank)—TargetsystempowerisnotdetectedCommunicationsportandrate,abovedebugF10windowCOMX:BBBBB—ThehostsoftwareiscommunicatingwiththeMMEVSthroughportX,atBBBBBbaudSpecialstatusmessage,totherightoftheMCUstatestatusarea,abovedebugF10windowInstbrkpt/IllegalAddress—AbreakpointorillegaladdresshasbeenencounteredandexecutionhashaltedWriteprotect—AnattemptwasmadetowritetomemorydesignatedasROMorisunusedmemoryspace.
Programcounterwillbeatthenextinstructionthatwouldhavebeenexecutedhadtheerrornotoccurred.
UserScreensMainWindowScreensMMEVS0508OM/DMOTOROLAUserScreens33CPUWindowTheCPUwindowislocatedattheupperleftofthedebugscreen.
Thiswindowdisplaysthecontentsoftheaccumulator(Aregister),theindexregister(Xregister),theprogramcounter(PC),thestackpointer(SP),andtheconditioncoderegister(CCR).
Whenanewvalueforanyoftheseregistersisentered,thenewvalueappearsinthewindow.
NOTE:ForMMEVS08usersanadditionalregister,theHregister(upperbyteoftheindexregister),isshownaswellastheVbitintheCCR.
TheCCRbitdesignatorsarelocatedatthelowerrightoftheCPUwindow.
TheCCRpatternisV11HINZC(Vistwo'scomplementoverflowforM68HC08MCUonlyandis1forM68HC05MCU,Hishalf-carry,Iisinterruptmask,Nisnegative,Ziszero,andCiscarry).
AletterinthesedesignatorsmeansthatthecorrespondingbitoftheCCRisset;aperiodmeansthatthecorrespondingbitisclear.
Notethatthiswindowcannotbeselectedandcannotbeusedtochangevalues.
Instead,thiswindowshowschangesmadeviaotherwindowsorchangesthatoccurduetorunningcode.
Source/CodeF2WindowThewindowlocatedintheupperrightcornerofthescreenhastwooperatingmodes.
Thefunctionalityofthewindowisdifferentforeachoftheoperatingmodes.
Undercertainconditionsexplainedbelow,youmaytogglebetweentheoperatingmodes.
Onemode(CodeF2)displaystheobjectcodefroma.
S19fileloadedintotheMMEVSsystem.
Theothermode(Source)displaysthesourcecodefroma.
MAPfileloadedintotheMMEVSsystematthesametimeastheobjectcode.
Moredetailandadescriptionofthedifferencesintheoperatingmodesarediscussedbelow.
CodeF2WindowOnenteringMMEVSsoftware,thewindowdefaultstoobjectcode,thewindowtitleisCODEF2,andwindowcontentsareadisassembledrepresentationofMCUmemory.
Inthisobjectcodedisplay,thedisassembledinstructionschangewhencorrespondingbytesofmemorychange.
Toscrollthroughthiswindow,presstheF2key(toselectthewindow),thenusethearrowkeys,sincethemousedoesnotfunctionwiththiswindow.
UserScreensMainWindowScreensMMEVS0508OM/D34UserScreensMOTOROLASourceWindowWhena.
MAPfileexistsinthesamedirectoryasthe.
S19file,theMMEVSsoftwareloadsbothfilesatthesametimeandthesourcecodegeneratedfromthe.
MAPfileisavailableforuseinthedebugprocess.
Thecontentsofthiswindowchangetosourcecode(andthetitlechangestoSOURCE:filename.
asm)if:1.
A.
MAPfilehasbeenloadedand2.
Theprogramcounter(PC)pointstoamemoryareacoveredbythe.
MAPfile.
Oncea.
MAPfilehasbeenloadedandthePCpointstoanareaofusercode,theSOURCEcommandcanbeusedtotogglebetweensourcecodeandobjectcode.
Ifamouseisinstalled,thesymbolsthatappearatthebottomofthesourcewindowcanbeselected.
Usethemouseorarrowkeystoscrollthroughtheinformationinthewindow.
ThereareseveralAlt-commandsassociatedwiththesourcewindow.
ThelistofAlt-commandsappearsatthebottomofthedebugscreenwhenthekeyispushed.
Table5liststhekeycommandsavailableinthiswindowwhenasourcecodeisdisplayed.
NOTE:TheF2functionkeydoesnotactivatethiswindowinthesourcecodeoperatingmode.
TheSourcewindowandtheDebugF10windowwillbothbeactiveatthesametime.
Usethemouseorarrowkeystoselect/scrolltheinformationintheSourcewindow.
Table5.
SourceWindowKeyCommandsNameKeyDescriptionBreakpointAlt-BSetsorremovesabreakpointathighlightedlineFindAlt-FFindstherstoccurrenceofthespeciedstringinthesourceleFindNextAlt-LFindsthenextoccurrenceofthespeciedstringinthesourceleGoTilAlt-GExecutescodefromthecurrentPCaddresstothehighlightedlineListModulesAlt-MListsavailablesourcecodemodulesPCAlt-PSetstheprogramcounter(PC)totheaddressonthehighlightedlineUserScreensMainWindowScreensMMEVS0508OM/DMOTOROLAUserScreens35VariablesF8WindowThevariablesF8window,locatedattheleftsideofthedebugscreen,isinitiallyblank.
Thewindowshowsasmanyas11variables,specifiedviatheVARcommand.
PresstheF8functionkeytoselectthiswindowsothatthearrowkeyscanhighlightexistingvariables.
Ifmorethan11variableshavebeendeclared,usethearrowkeysandthepageup/downkeystodisplayallvariables.
Todeleteapreviouslysetvariable,highlightthevariableandpressthedeletekey.
NOTE:ThedeleteoperationcanbeperformedviathemousebyselectingthevariableandclickingonthewordDELETEatthebottomofthewindow.
Itispossibletospecifyasmanyas32variablesviatheVARcommand.
Thevariablesappearwiththeircurrentvaluesinhexadecimal,binary,decimal,orASCIIformat.
RefertothesectionentitledCommand-LineCommandsformoreinformationabouttheVARcommand.
MemoryF3WindowThememoryF3window,locatedattherightsideofthedebugscreen,displaysthecontentsof32memorylocations.
ThevaluestoredataspecificlocationisdisplayedinbothhexadecimalandASCIIformat.
IntheASCIIareatotherightinthewindow,controlandothernon-printingcharactersappearasperiods(.
).
Asthecontentsoftheselocationsaremodified,thenewvaluesappearinthiswindow.
Usethescrollbartotherightofthewindowtodisplayotherareasofmemory.
Toselectthiswindow,presstheF3functionkey.
Thescrollbardisappears;usethearrowkeysandthepageup/downkeystodisplaylowerorhigheraddressranges.
Dashesreplacethevalueswhencodeisexecuting.
Updatedvaluesreappearwhenexecutionstops.
UserScreensMainWindowScreensMMEVS0508OM/D36UserScreensMOTOROLADebugF10WindowThedebugF10window,locatedatthebottomofthedebugscreen,isthedefaultactivewindow.
Thiswindowcontainsthecommandline,identifiedbythecommandprompt(>).
Enter(type)acommandattheprompt.
Toprocessthecommand,press(thatis,presstheENTER,RETURN,orcarriage-returnkey).
Thesoftwaredisplaysanyadditionalprompts,messages,ordatathatpertaintothecommand.
Ifthecommandisnotenteredcorrectlyorisnotvalid,thesoftwaredisplaysanappropriateerrormessage.
(RefertothesectionentitledCommand-LineCommandsonpage61foralistandexplanationoftheoftheavailablecommands.
)Aftercommandexecution,thesoftwareagaindisplaysthecommandprompt.
AsanewlineappearsinthedebugF10window,precedinglinesscrollupward.
Thewindowdisplaysasmanyasfourlines.
Whenanyotherwindowisselected,thecursordisappearsfromthedebugF10window.
ToreturntothedebugF10window,presstheF10functionkey.
TheMMEVSmaintainsacommandbufferofcommandsenteredonthecommandline.
Themousecanbeusedtoselectthe↓and↑arrowsymbolstosequenceforwardsorbackwardsthroughthecommandbuffer.
Pressthekeytothenrepeatthecommand.
Torepeatthelastcommandexecutedatanytime,presstheF9key.
UserScreensPop-UpWindowsMMEVS0508OM/DMOTOROLAUserScreens37Pop-UpWindowsInadditiontothefivemainwindows,severaltemporarypop-upwindowssuchasthestackwindow,thesetmemorywindow,thebaudwindow,andtheemulatorclockfrequencywindowmayappearduringMMEVSoperation.
Table6liststhekeycommandsforthesesubordinatewindows.
Table6.
WindowKeyCommandsKeyDescription↑Movescursordownoneline↑Movescursoruponeline↑Movescursorleft↑MovescursorrightHomeMovescursortotoplineofwindowEndMovescursortobottomlineofwindowPageDownScrollsdownonepage(HELPonly)PageUpScrollsuponepage(HELPonly)F6Savesmemorymaptole(SETMEMonly)andappliesmemorymaptotheMMEVSF7Appliesmemorymaptoemulatorandreturnstodebugscreen(SETMEMonly)Appliesselectiontoemulatorandreturnstodebugscreen,exceptSETMEMForHELP,displayswindowforselecteditemForCOLORS,acceptstheexistingcolorselectionForSTACK,returnstothedebugscreenReturnstodebugscreenwithoutapplyingselectiontoemulatorForCOLORS,returnstothedebugscreenwithoutacceptinganymorecolorsForSTACK,returnstothedebugscreenUserScreensPop-UpWindowsMMEVS0508OM/D38UserScreensMOTOROLAStackWindowThetemporarystackwindowappearsnearthecenterofthedebugscreenwhentheSTACKcommandisentered.
AsFigure4shows,thiswindowdisplaysthecontentsoftheSPregisteratthetopofthewindow.
The12bytesatthetopofthestackaredisplayedtotheleft.
Theinterpretationofthestackshowntorightinthewindowisvalidonlyifthelastpushtothestackwascausedbyaninterrupt.
Pressthekeytoremovethestackwindowandreturntothedebugwindow.
NOTE:Theinterruptstackdatatotherightsideofthewindowisaninterpretationofthetopfivebytesonthestack.
IfthelastpushtothestackwasduetoaBSRorJSRinstruction,fivebyteswerenotpushedtothestackandtheinterruptstackinformationisinvalid.
Figure4.
StackWindowSTACKStackPointer=00F8RawBytes:.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
00FF7D00FE0100FD4400FC0200FB1000FAFF00F9E5SP>00F807InterruptStack:.
.
.
HINZCCCR>11100101A>FFX>10ret>0244UserScreensPop-UpWindowsMMEVS0508OM/DMOTOROLAUserScreens39SetMemoryWindowThetemporarysetmemorywindow(Figure5)appearsnearthecenterofthedebugscreen.
Enterthesetmemory(SETMEM)commandtocustomizethememorymap.
TheSETMEMcommandallowsmappingovermemorydefinedasRAM,ROM,orundefined.
However,mappingoverinternalresourcessuchasoptionRAM,I/O,orEEPROMisnotallowed.
Figure5.
SetMemoryWindowRAM1XXXXXXXXRAM2XXXXXXXXRAM3XXXXXXXXROM00020004FROM1010008FFROM21FF01FFFROM3XXXXXXXXF6:SAVEF7:EXECUTE:CANCELVector1FFECustomMapRAM0008000FFUserScreensPop-UpWindowsMMEVS0508OM/D40UserScreensMOTOROLABaudWindowThetemporarybaudwindow(Figure6)appearsnearthecenterofthedebugscreenwhenthebaud(BAUD)commandisentered.
TheBAUDcommandsetsthebaudrateforcommunicationsbetweenthesystemcontrollerandthehostcomputer.
Thiswindowshowstheavailablebaudrates.
Figure6.
BaudWindowBAUD240048009600192003840057600UserScreensPop-UpWindowsMMEVS0508OM/DMOTOROLAUserScreens41EmulatorClockFrequencyWindowDependingontheEMboardused,theM68MMPFB0508platformboardcansupplytheoscillatorclockfortheMCUsOSC1input.
NotethattheEMbeingusedwillrequireaspecificjumperconfigurationinordertousethisclocksource.
RefertotheEMuser'smanualfortheavailabilityofthisfeature.
FortheMMEVS05,fourinternallygeneratedclockfrequenciesareavailable:8MHz,4MHz,2MHz,and1MHz.
Enteringemulatorclock(OSC)commandwithoutthedesignatedfrequencybringsupthetemporaryMMEVSemulatorclockfrequencywindownearthecenterofthedebugscreen.
Usetheup/downarrowkeystoselecttheemulatorMCU'sclockfrequencyandpresstocompletetheselection.
Thedefaultemulatorclockrateis2MHzasshowninFigure7.
FortheMMEVS08,fiveinternallygeneratedclockfrequenciesareavailable:16MHz,8MHz,4MHz,2MHz,and1MHz.
Thedefaultemulatorclockrateis4MHzasshowninFigure8.
Beforechangingtheclockrate,makesurethattheemulationMCUsupportsthedesiredfrequencyandtheappropriatejumpersaresetcorrectly.
Figure7.
MMEVS05EmulatorClockFrequencyWindowFigure8.
MMEVS08EmulatorClockFrequencyWindowEMOSC8Mhz.
4Mhz.
2Mhz.
1Mhz.
EMOSC16Mhz.
8Mhz.
4Mhz.
1Mhz.
2Mhz.
UserScreensMouseOperationMMEVS0508OM/D42UserScreensMOTOROLAOtherWindowsInadditiontothescreenwindowsdescribedinthissection,severalothertransientdialogwindowswillbeencountered.
Manyareforfilesearchselectionsinwhichthedirectorypathscanbescannedforadesiredfile.
Otherwindowswillappearwhenusinghelpcommands.
Toselectanitemfromamenuorfilelist,movethehighlightcursorusingthe↑and↓keystothedesireditemandpress.
Tocloseawindowwithoutselectinganitem,pressthekey.
MouseOperationMMEVSsoftwaresupportsaMicrosoft,Logitech,orIBMmouse.
Installthemouseaccordingtothemanufacturer'sinstructions,usingtheaccompanyingmousedriversoftware.
Micemadebyothermanufacturersmaybecompatible,butMotoroladoesnotguaranteetheirperformancewiththeMMEVSsystem.
SomeMMEVSoperationscanbeaccomplishedbyusinganinstalledmousetoselectadesiredfunction.
Notethattheselectsymbolsareonlyvisibleifamouseisinstalled.
Themousecanbeusedtoscrollthroughthesourcewindow,variablesF8,memoryF3,anddebugF10windows.
"Clickingon"anitemmeanspositioningthemousecursorontheitem,thenquicklypressingandreleasingtheleftmousebutton.
Themouseoperationsare:General–Scrollthroughawindow—Clickonthe↑and↓symbolstorightedgeoftheselectedwindow.
VariableF8Window–HighlightitemsinthesourceandvariablesF8windows—Movemouseoverdesireditemandclick.
–DeletethehighlightedvariableinthevariablesF8window—ClickonthewordDELETEatthebottomofthewindow.
–Pressingtherightbuttonofthemousetoduplicatethefunctionalityofthekey.
UserScreensMouseOperationMMEVS0508OM/DMOTOROLAUserScreens43SourceWindow–SetthePCtotheaddressoftheinstructiononahighlightedline—ClickonPCatthebottomofthesourcewindow.
–Setorclearabreakpointatthehighlightedinstructioninthesourcewindow—ClickonBRatthebottomofthesourcewindow.
–BeginexecutinginstructionsstartingatthePCaddress—ClickonGOatthebottomofthesourcewindow.
–Stopexecutinginstructions—ClickonSTOPatthebottomofthesourcewindow.
–ExecuteinstructionsbeginningwiththeinstructionattheaddressinthePCandstoppingatthehighlightedinstructioninthesourceF2window—ClickonGOTILatthebottomofthesourcewindow.
–ExecutetheinstructionattheaddressinthePC—ClickonSTEPatthebottomofthesourcewindow.
–DisplaythesourcefilelinenumberofthehighlightedlineofthesourceF2window,alongwithitsaddress,disassembledcontents,andthenameofthefile—ClickonINFOatthebottomofthesourcewindow.
–Togglethesizeofthesourcewindowbetweennormalandenlarged—clickonZOOMatthebottomofthesourcewindow.
UserScreensChangingScreenColorsMMEVS0508OM/D44UserScreensMOTOROLAChangingScreenColorsTochangescreencolors,entertheCOLORScommandfromthedebugscreen;thecolorswindowappears.
Thiswindowincludesalistofscreenelementsandamatrixofforeground/backgroundcolorcombinations.
Eachcolorcombinationhasa2-digithexadecimalnumber.
Apromptasksforthecolorofthefirstscreenelement.
Toacceptthecurrentcolor,press.
Tochangethecolor,enterthenumberofthechoice,thenpress.
Anewpromptasksforthecolorofthenextelement.
Selectthecolorforeachelementinthesameway.
ThecommandendswhenacolorhasbeenselectedforthelastscreenelementorwhenESCispressed.
Inthecolormatrix,rowscorrespondtobackgroundcolorsandcolumnscorrespondtoforegroundcolors.
Thismeansthatcolorchoicesfromthesamerowresultindifferentlycoloredlettersandnumbersagainstthesamebackgroundcolor.
Makingthebackgroundofhighlightsandhelpscreensadifferentcolorsetstheseelementsofffromthemainscreen.
ThesoftwarestorescolorselectionsinfileCOLORS.
05orCOLORS.
08.
WhenMMEVSisexecutedagain,thesoftwareappliesthenewlyselectedcolors.
Usethecolorselectionfilewithanothersystemtoretaintheselectedcolors.
NOTE:DeletetheCOLORSfilefromtheMMEVSsubdirectorytoreturntothedefaultcolors.
MMEVS0508OM/DMOTOROLAOperationFundamentals45OperationFundamentalsContentsIntroduction46SystemInitialization46SettingCommunicationsBaudRate47StandardMemoryMapping47CustomMemoryMapping48InitializingtheClockSpeed49LoadingUserSoftware49InitializingMemory50InitializingAssemblyLanguage50InitializingMemoryData51SystemCommands.
52ScriptCommands52InformationCommands53LogFileCommands55DebugScreenControl55ExittheEnvironment56DebugCommands57SettingCPURegisters57MemoryDisplay57ResetControloftheEmulationSystem58UsingBreakpoints58TracingInstructions59ExecutionInstructions59OperationFundamentalsIntroductionMMEVS0508OM/D46OperationFundamentalsMOTOROLAIntroductionAnemulationsystemgivestheuserthetoolsneededtodevelopanembeddedMCUapplicationinthemostefficientwaypossible.
ThissectiondescribesthebasicoperationoftheMMEVS.
DetailofspecificcommandsisavailableinCommand-LineCommandsonpage61.
OperationoftheMMEVSmaybedividedintothreemainareas:SystemInitializationSystemInformationDebugOperationAstart-upscriptfile,describedinScriptCommandsonpage52,canbesetuptoperformasetofcommandsautomaticallyeachtimetheMMEVSsoftwareisrun.
Thisstart-upfilemusthavethenameSTARTUP.
05orSTARTUP.
08.
SystemInitializationInitializingtheMMEVSsystemincludes:InitializingthecommunicationsbaudrateSettingthememorymapInitializingtheclockspeedLoadingusersoftwareandasymboltableInitializingmemoryEachpartofinitializationanduseoftheappropriatecommandsisdiscussedhere.
OperationFundamentalsSystemInitializationMMEVS0508OM/DMOTOROLAOperationFundamentals47SettingCommunicationsBaudRateForbestsystemperformance,communicationsbetweenthehostandthestationmoduleshouldbeatthemaximumavailablebaudrate.
Atpower-up,theMMEVSsystemautomaticallynegotiatesthemaximumbaudforthesystem.
Alldatatransfersbetweenthehostcomputerandthestationmoduleareatthespecifiedbaudrate;maximumperformanceisatthehighestratethecomputersupports.
UsetheBAUDCHKcommandtodetermineandsetthatrate.
However,ifthesoftwaredisplayscommunicationserrormessages,reducethebaudrate.
UsetheBAUDcommandtochangethebaudrate.
Thepossibleratesare2400,4800,19200,38400,and57600baud.
IftheBAUDcommandisenteredwithnoratevalue,thebaudwindowappearsoverthedebugscreen.
Toselectaratefromthiswindow,usethearrowkeystohighlighttherate,thenpressordoubleclickthemousewhenthecursorisonthedesiredbaudrate.
StandardMemoryMappingVariousMCUdesignsrequiredifferentmemorymapconfigurationsoftheMMEVSsystem.
TheappropriatememorymapisspecifiedinapersonalityfileforeachMCUthattheEMsupports.
ThesefilesareshippedwiththeseparatelypurchasedEMs.
RefertotheappropriateEMuser'smanualtodeterminethepersonalityfilesusedbyaparticularEMmodule.
PersonalityfilesareusuallyinstalledinthedirectoryfromwhichtheMMEVSsoftwareisexecuted.
Ifapersonalityfileisnotlocatedinthatdirectory,thesoftwaredisplaysasearchwindowusedtofindthecorrectfile.
TheMMEVSoperatingsoftwareautomaticallyloadsthedefaultpersonalityfilethatcorrespondstotheEMmodulecurrentlyconnected.
OperationFundamentalsSystemInitializationMMEVS0508OM/D48OperationFundamentalsMOTOROLACustomMemoryMappingForcreatingcustommemoryconfigurations,usethecustomizememorymap(SETMEM)command.
Whenthiscommandisentered,thesetmemorywindowappearsoverthedebugscreen.
Viathiswindow,asmanyasfourblocksofRAMandfourblocksofROMcanbedefined.
(ROMiswrite-protected;attemptingtowritetoROMstopsprogramexecution.
)NOTE:TheSETMEMcommandcanbeusedtoexpandthenormalRAMandROMrangestemporarilyduringdebugging.
BesuretorestoretheoriginalsizeandconfigurationoftheMCUmemorybeforefinaldebugging.
Otherwise,thecodecouldfailtofitorruninanMCU'smemoryspace.
Foreachmemoryblock,specifytheaddressrangeandmemorytype.
Towritethemaptoafile,presstheF6functionkey,thenenterafilenameinresponsetotheprompt.
Topreventlossofsystemfiles,acustomfilenameshouldnotduplicateanyfilesshippedwithanEMmodule.
PresstheF7keytoapplythemaptomemorywithoutsavingthemaptoafileforfutureuse.
Tocancelthecommand,press.
Usetheloadpersonalityfile(LOADMEM)commandtoloadastoredcustommapduringfutureemulationsessions.
NotethattheLOADMEMcommandcanbepartofthestart-upscriptfile,sothatloadingthecustommapbecomesanautomaticpartofMMEVSstart-up(.
MEMfilesalsocanbeloadedatstart-upbyusingthe–MoptionwiththeMMEVSexecutable.
)TheLOADMEMcommandalsocanbeusedtorestorethestandardmemorymapping.
RefertotheappropriateEMuser'smanualtodeterminethedefaultpersonalityfilesusedbyaparticularEMmodule.
OperationFundamentalsSystemInitializationMMEVS0508OM/DMOTOROLAOperationFundamentals49InitializingtheClockSpeedTheM68MMPFB0508platformboardcansupplyanoscillatorclocksourcefortheMCU'sOSC1input.
ClockcontrolisavailableviatheOSCcommand.
NotethatmanyEMsrequireaspecificjumperconfigurationsothatthisclocksourcecanbeused.
RefertothespecificEMuser'smanualforEMclocksourceinformation.
FortheMMEVS05,fourinternallygeneratedclockfrequenciesareavailable:8MHz,4MHz,2MHz,and1MHz.
Enteringtheemulatorclock(OSC)commandwithoutthedesignatedfrequencybringsupthetemporaryMMEVSemulatorclockfrequencywindownearthecenterofthedebugscreen.
FortheMMEVS08,fiveinternallygeneratedclockfrequenciesareavailable:16MHz,8MHz,4MHz,2MHz,and1MHz.
LoadingUserSoftwareSoftwareforthetargetsystemmustbeavailableonthehostcomputerinS-recordformat.
UsetheLOADcommandtoloadanS-recordfileintotheemulatorandtheaccompanyingmap(symbol)fileintothehostcomputer.
TheassemblershippedwiththeMMEVS(CASM)hastheabilitytogenerateacurrentmapeachtimeanassemblyprogramisassembled.
ThespecificS-recordtoloadcanbespecifiedonthecommandlinebytypingtheS-recordfilenameaftertheLOADcommand.
Ifthefilehastheextension.
S19,thentheextensioncanbeomitted.
Alternatively,ifnofilenameisspecified,thenasearchwindowappears,displayingthefileswitha.
S19extensioninthecurrentdirectory.
OperationFundamentalsSystemInitializationMMEVS0508OM/D50OperationFundamentalsMOTOROLAInitializingMemoryDuringadebuggingsession,specificmemorylocationsshouldcontainknownvalues.
Therequiredvaluesarestoredinmemoryasnumericvaluesorasinstructionsassembledindividually.
Thecommandsthatstoreandmanipulatethecontentsofmemoryaredescribedinthefollowingparagraphs.
InitializingAssemblyLanguageTheassembleinstructions(ASM)commandisimportantformakingminoralterationstoobjectcode.
Thiscommanddisplaysthespecifiedaddressanditscontentsfollowedbyaprompt.
Enteravalidinstructionandpress.
Thecommandassemblesthecode,storesthecodeinmemoryattheindicatedaddress,anddisplaystheinstruction.
Thecommandthenupdatesitslocationcounteranddisplaystheupdatedaddressandapromptforthenextinstruction.
TheASMcommandcontinuestoassemblecodeonelineatatimeuntilaperiod(.
)isentered.
NOTE:ChangesmadetocodeviatheASMcommandcannotbesavedtoanS-recordfileortoasourcecodefile.
Thiscommandshouldbeusedonlytocreateandmodifycodetoberunduringthecurrentdebugsession.
NOTE:Ifthesource/codeF2windowshowssourcecodeandtheASMcommandisusedtomodifythecode,thesource/codeF2windowcontinuestoshowunmodifiedsourcecode.
EntertheCLEARMAPcommandtodeletethesourcecodedisplay.
Toincorporatemodificationsintosourcecode,reassemblethecodeanddownloadagain.
Thedisassembleinstructions(DASM)commandcomplementstheASMcommand.
TheDASMcommandallowsmemorycontentstobedisassembled,displayingtheassemblyinstructionsthatcorrespondtothevaluesinthespecifiedmemoryaddressrange.
EachDASMcommanddisassemblesthreeinstructionsanddisplaystheaddresses,theopcodes,andtheoperandswhereappropriate.
WhentheDASMcommandisenteredwithtwoaddresses,itdisassemblesinstructionsbeginningatthefirstaddressandendingwiththeinstructionatthesecondaddress.
Iftherangeincludesthreeormoreinstructions,onlythelastthreedisassembledinstructionsaredisplayedinthedebugF10window.
Theentireblockiswrittentoalogfilewhenoneisopen.
OperationFundamentalsSystemInitializationMMEVS0508OM/DMOTOROLAOperationFundamentals51InitializingMemoryDataTheblockfill(BF)commandallowsplacementofnumericvaluesinablockofmemoryaddresses.
Thiscommanddefinesablockofmemory,thenplacesabyteorwordpatternthroughouttherange.
Thememorymodify(MM)commandletstheuserinteractivelyexamineandmodifycontentsofmemorylocations.
Ifanydataargumentsareenteredwiththiscommand,thesystemstoresthevaluesbeginningatthespecifiedaddress.
Whenonlyanaddressissupplied,thecommanddisplaysthecontentsoftheaddressfollowedbyaprompt.
Enterthevalueandpress.
Thecommanddisplaysthenextaddressanditscontents.
Thecommandcontinuestostorethevaluesentereduntilaperiod(.
)isentered.
BoththeBFandMMwritestomemoryareverified;a"writedidnotverify"messageisdisplayedifthewritecouldnotbeverified.
Notethatthismessagemaybeacceptableinsomesituations,suchaswritingtoregistersthathavewrite-onlybits.
OperationFundamentalsSystemCommandsMMEVS0508OM/D52OperationFundamentalsMOTOROLASystemCommandsSystemcommandsfortheMMEVSperformthesefunctions:ExecutingcommandscontainedinscriptfilesObtaininginformationabouttheemulatorandthehostsystemCapturingandsavingdatadisplayedonthescreeninalogfileControllingtheformatofthedebugscreenLeavingtheMMEVSenvironmenttemporarilyorpermanentlyThefollowingparagraphscoverusageofthesystemcommands.
ScriptCommandsTheexecutescriptfile(SCRIPT)commandreadscommandsfromascriptfileandpassesthemtothecommandinterpreterforexecution.
EnteringtheoneSCRIPTcommandhasthesameeffectasenteringthesequenceofcommandscontainedinthescriptfileindividually.
Usingscriptfilessavestimeandpromotesaccuracy.
AscriptfileisatextfileofMMEVScommandsandisappropriateforanysequenceofcommandsthatisusedoften.
Aspecialscriptfile,giventhefilenameSTARTUP.
05orSTARTUP.
08,executesautomaticallyeachtimetheMMEVSsoftwareisloaded.
Sometimesascriptfilemustcontainapausebetweencommands.
Thepause(WAIT)commandcausesthecommandinterpretertowaitbeforeprocessingsubsequentcommands.
AspartoftheWAITcommand,thewaittimecanbeenteredinseconds.
IfatimevaluefortheWAITcommandisnotentered,thecommandinterpreterpausesforfiveseconds.
NOTE:AllvaluesenteredontheMMEVScommandlinearehexadecimal.
Theinputvalue10,forexample,isthedecimalvalue16.
OperationFundamentalsSystemCommandsMMEVS0508OM/DMOTOROLAOperationFundamentals53TheBELLcommandwillsoundthecomputerbellthespecifiednumberoftimes.
Thisisusefultolettheuserknowscriptcommandexecutionhasreachedacertainpoint.
TheREMcommandaddsadisplaycommenttoascriptfile.
Whenthescriptfileisexecuted,thesystemdisplaysthiscomment.
NOTE:AllotherMMEVScommandscanbecontainedinthescriptfile.
InformationCommandsTheEVALcommandperformsmathematicaloperationsontwonumericalarguments.
Itdisplaysthevalueoftheresultinhexadecimal,decimal,octal,andbinaryformatsdenotedbythesuffixesH,T,O,andQ.
IfthevalueisequivalenttoanASCIIcharacter,theASCIIcharacteralsoisdisplayed.
Thiscommandsupportsaddition(+),subtraction(–),multiplication(*)anddivision(/).
TheREGcommanddisplaysthecontentsoftheCPUregistersinthedebugF10window.
Thecommandalsowilldisplaytheinstructionpointedtobythecurrentprogramcountervalue.
ThetemporarystackwindowappearsnearthecenterofthedebugscreenwhentheSTACKcommandisentered.
ThiswindowdisplaysthecontentsoftheSPregisteratthetopofthewindow.
The12bytesatthetopofthestackaredisplayedtotheleft.
Theinterpretationofthestackshowntorightinthewindowisvalidonlyifthelastpushtothestackwascausedbyaninterrupt.
NOTE:Theinterruptstackdatatotherightsideofthewindowisaninterpretationofthetopfivebytesonthestack.
IfthelastpushtothestackwasduetoaBSRorJSRinstruction,fivebyteswerenotpushedtothestackandtheinterruptstackinformationisinvalid.
Forinformationaboutahighlightedlineinthesource/codeF2window(filename,linenumber,address,andsoforth)usetheINFOcommand.
OperationFundamentalsSystemCommandsMMEVS0508OM/D54OperationFundamentalsMOTOROLATodisplaythevalueofasymboldefinedinamap(symbol)file,usetheWHEREIScommand.
Thedisplayversion(VERorVERSION)commanddisplaystheversionnumberofthehostsoftwareandthepersonalityfile.
Thesysteminformation(SYSINFO)commandshowstheamountofhostcomputermemoryremaining.
Thedisplaymemorymap(SHOWMEM)commanddisplaystheRAMandROMrangeofthecurrentmap.
Thedisplayhelpinformation(HELP)commanddisplaysadialogwindowfromwhichtoaccesstheMMEVShelpsystem.
Notethatthehelpsystemiscontextsensitive:Highlightanelementofascreen,thenpresstheF1helpkeyforcorrespondinghelpinformation.
Thechiphelpinformation(CHIPINFO)commandgivesaccesstoregisteranduservectorlocations,MCUmemory-map,andpin-outinformationspecifictothepartbeingemulated.
Notethatthishelpinformationisonlyavailableoncertainparts.
Amessageisdisplayedifnohelpisavailable.
Notethatthehelpsystemiscontextsensitive:Highlightanelementofascreen,thenpresstheforcorrespondinghelpinformation.
OperationFundamentalsSystemCommandsMMEVS0508OM/DMOTOROLAOperationFundamentals55LogFileCommandsTheMMEVScanmaintainalogfilethatwillcaptureeventsdisplayedonthedebugscreen.
Entriesintheloginclude:CommandsenteredonthecommandlineCommandsreadfromascriptfileResponsestocommandsErrormessagesNotificationsofchangesinstatus,suchasbreakpointsandWAITorSTOPinstructions.
PicturesofthemainscreenWiththelogfile(LF)command,afilecanbeopenedtoreceiveinformationbeinglogged.
Ifthespecifiedfilealreadyexists,thesystemallowsappendageofthecurrentloginformationtothatfile,orreplacementoffilecontentswiththecurrentloginformation.
Whilethelogfileremainsopen,theloginformationiswrittentothefile.
EnteranotherLFcommandtoterminateloggingtothefile.
NOTE:TheLFcommanddoesnotautomaticallyappendafilenameextensiontologfiles.
Motorolarecommendsthattheextension.
logforlogfilesbeused.
Thesavescreen(SNAPSHOT)commandwillsavethedebugscreentoanopenedlogfile.
DebugScreenControlThesourcewindowdisplay(SOURCE)commandtogglesbetweensourcecodeanddisassembledcodeinthesource/codeF2windowlocatedattheupperrightofthedebugscreen.
OnenteringMMEVSsoftware,thewindowdefaultstodisassembledcode,thewindowtitleisCODEF2,andwindowcontentsareadisassembledrepresentationofMCUmemory.
Inthisobjectcodedisplay,thedisassembledinstructionschangewhencorrespondingbytesofmemorychange.
SourcecodewillbedisplayedifanS-recordfileanditscorrespondingmapfileareloadedandthePCpointstoamemoryareacoveredbythemapfile.
OperationFundamentalsSystemCommandsMMEVS0508OM/D56OperationFundamentalsMOTOROLAOncea.
MAPfilehasbeenloadedandthePCpointstoanareaofusercode,theSOURCEcommandcanbeusedtotogglebetweensourcecodeandobjectcode.
Ifamouseisinstalled,thesymbolsthatappearatthebottomofthewindowcanbeselected.
Usethemouseorarrowkeystoscrollthroughtheinformationinthewindow.
NotethattheF2keydoesnotpertaintothiswindowifitshowssourcecode.
NOTE:Whenmemorydatathatwasgeneratedfromasourcefileisaltered,themodifiedcodeappearsinthecodewindowbutnotthesourcefilewindow.
UsetheCLEARMAPcommandtodeletethesourcefilefromthesourcecodedisplay.
Theresizesourcewindow(ZOOM)commandtogglesthesizeofthesourcewindowbetweennormalandenlarged.
Theenlargedwindowcanbehelpfulbyallowingimprovedvisibilityofcommentsinthesourcefile.
TheenlargedwindowwillremovetheCPUregisterswindowfromthedebugscreen.
Theregisterswillbere-displayedbytypingtheZOOMcommandagain.
Thesetscreencolors(COLORS)commandcanbeusedtoalterthedefaultscreencolorsdisplayedinthevariouswindowsoftheemulationenvironment.
Toreturntothedefaultcolors,deletethefilenameCOLORS.
05orCOLORS.
08intheMMEVSworkingdirectory.
ExittheEnvironmentThedebugenvironmentcanbeexitedeithertemporarilyorpermanently.
ToshelltoDOStemporarily,usetheSHELLcommand.
TypeEXITattheDOSprompttoreturntotheMMEVSenvironment.
Toexitthecurrentdebugsessionpermanently,executetheEXITorQUITcommand.
TheemulationsystemalsocanbeexitedbypressingtheAlt-Xkeys.
OperationFundamentalsDebugCommandsMMEVS0508OM/DMOTOROLAOperationFundamentals57DebugCommandsTheMMEVScommandsthatapplytothedebuggingphaseofsystemdevelopmentaredescribedinthissection.
SettingCPURegistersThecontentsoftheCPUregistersandtheconditioncoderegisteraredisplayedintheCPUwindow.
Theseregisters–A,H(MMEVS08only),X,PC,SP,andCCR–containtheenvironmentforexecutionofaninstructionand,aftertheinstructionhasbeenexecuted,theresults.
Anyoftheseregisters,exceptSP,canbemodifiedbyenteringthecorrespondingregisterdesignatorcommandandanappropriatevalue.
ThecommandsthataffecttheCPUregistersareA,ACC,X,XREG,PC,CCR,H,I,N,Z,andC.
AdditionalcommandstosupporttheM68HC08MCUareHX,HREG,andV.
Whenispressed,theregisterdisplayshowsthenewvalue.
RefertoCommand-LineCommandsonpage61forexamplesonhowtomodifyCPUregistervalues.
MemoryDisplayMemorycontentsaredisplayedinthememoryF3window.
Thirty-twoconsecutivebytesofmemoryaredisplayedinbothhexadecimalandASCIIformat.
Thememorydisplay(MD)commandspecifiesthebeginninglocationofthe32bytesdisplayed.
Thewindowcanbescrolledviathemouseorbyselectingthewindow(F3)andusingpageup/downkeystoviewothermemoryranges.
TheVARcommanddisplaysthespecifiedaddressanditscontentsinthevariablesF8window.
Asmanyas32variablescanbedeclaredinthevariablesF8window.
Thewindowshows11variablesatatime.
Ifamapfilehasbeenloaded,symbols(labels)fromthesourcecodecanbeusedasarguments.
Thevariablescanbedisplayedinbyte,word,orstringformat.
Abytedisplayishexadecimalandbinary,whileaworddisplayishexadecimalanddecimal,andastringdisplayisASCII.
ForanASCIIstring,thenumberofcharactersdisplayedcanbespecified.
Controlandothernon-printingcharactersappearasperiods(.
).
OperationFundamentalsDebugCommandsMMEVS0508OM/D58OperationFundamentalsMOTOROLAResetControloftheEmulationSystemTheRESETcommandresetstheemulationMCUandsetsthePCtothecontentsoftheresetvector.
Usercodeisnotexecutedduringthiscommand.
TheRESETGOcommandcarriesoutthesameactionsastheRESETcommand,thenstartscodeexecutionfromthePC-valueaddress.
TheRESETINcommandallowstheresetsignaltoenterintotheemulationsystemthroughthetargetcable;thissignalmustbeenabledforcorrectoperationoftheWAIT4RESETcommand.
TheRESETOUTcommandallowstheRESETcommandtosendaresetsignaloutthetargetcable.
UsingBreakpointsThesetinstructionbreakpoint(BR)commandsetsabreakpointataspecificaddressorateachaddressofarange.
Breakpointaddressesmustbeinstructionfetch(opcode)addresses.
Amaximumof64breakpointscanbeset.
IftheBRcommandisenteredwithoutanyaddress,thecommanddisplaysallactivebreakpoints.
Toclearbreakpoints,usetheclearbreakpoints(NOBR)command.
AninstructionbreakpointoccurswhentheMCUaccessesaninstructionataspecifiedaddressoranaddresswithinaspecifiedaddressrange.
Whenexecutionarrivesatabreakpointaddress,emulationstopsjustbeforeexecutionoftheinstructionatthataddressandthesoftwaredisplaysthismessage:idleInstbrkpt/IllegalAddressAproperlydefinedbreakpointpermitsanalysisofthecontentsofregistersandmemorylocationsandthestatesofvarioussignalsatdesignatedaddressesintheprogram.
NOTE:Theidlestatusalsooccursifthesystemattemptstoexecutecodeatanaddressnotdefinedasavalidmemoryaddress.
OperationFundamentalsDebugCommandsMMEVS0508OM/DMOTOROLAOperationFundamentals59TracingInstructionsThestep(ST,STEP,andTareidentical)commandswillexecuteaspecifiednumberofinstructionsbeginningatthecurrentPCvalue.
TheSTEPFORcommandbeginsinstructionexecutionatthecurrentPCvalue,continuinguntilakeyispressedoruntilexecutionarrivesatabreakpoint.
TheSTEPTILcommandexecutesinstructionsfromthecurrentPCvaluetoaspecifiedaddress.
NOTE:Donotuseanystepcommand(ST,STEP,STEPFOR,STEPTIL,orT)ifthePCpointstointernalRAM(suchasoptionRAM)orEEPROMorifthecodebranchesintointernalRAMorEEPROM.
Thestepcommandsarenotreal-time.
Theyexecuteoneinstructionatatime,thenreturncontroltothemonitor.
Donotrelyontimervalues.
ExecutionInstructionsThego(GorGO)commandstartsemulationattheaddressinthePCoratanaddressenteredwiththecommand.
Executioncontinuesuntilitencountersabreakpoint,untilthebusanalyzer(optionally)stopsit,oruntiltheSTOPcommandisentered.
IfasecondaddressisenteredwiththeGorGOcommand,executionstopsatthesecondaddress.
TheGOTILcommandstartsemulationatthelocationinthePCandstopsattheaddressenteredwiththecommand.
TheSTOPcommandstopstheemulator.
TheRESETGOcommandresetstheMCU,fetchestheresetvectoraddress,andbeginscodeexecutionatthataddress.
OperationFundamentalsDebugCommandsMMEVS0508OM/D60OperationFundamentalsMOTOROLAMMEVS0508OM/DMOTOROLACommand-LineCommands61Command-LineCommandsContentsIntroduction64CommandSyntax64CommandExplanations66A—SetAccumulator68ACC—SetAccumulator69ASM—AssembleInstructions70BAUD—SetCommunicationsBaudRate.
71BAUDCHK—BaudRateCheck72BELL—SoundBell73BF—BlockFill.
74BR—SetInstructionBreakpoint75C—Set/ClearCBit76CCR—SetConditionCodeRegister.
77CHIPINFO—ChipHelpInformation78CLEARMAP—RemoveSymbols79COLORS—SetScreenColors80DASM—DisassembleInstructions81EVAL—EvaluateArgument82EXIT—TerminateHostSession83G—BeginProgramExecution84GO—BeginProgramExecution85GOTIL—ExecuteProgramuntilAddress86H—Set/ClearHBit87HELP—DisplayHelpInformation88HREG—SetHRegister89HX—SetH:XIndexRegister90I—Set/ClearIBit.
91INFO—DisplayLineInformation.
92Command-LineCommandsContentsMMEVS0508OM/D62Command-LineCommandsMOTOROLALF—LogFile.
93LOAD—LoadS19File94LOADMAP—LoadSymbols95LOADMEM—LoadPersonalityFile96MD—MemoryDisplay.
97MM—MemoryModify98N—Set/ClearNBit100NOBR—ClearBreakpoints101OSC—SelectEmulatorClockFrequency.
102PC—SetProgramCounter103QUIT—TerminateHostSession104REG—DisplayRegisters105REM—AddCommenttoScriptFile106RESET—ResetEmulationMCU107RESETGO—ResetandRestartMCU108RESETIN—ResetInputEnable109RESETOUT—ResetOutputEnable110SCRIPT—ExecuteScriptFile.
111SETMEM—CustomizeMemoryMap112SHELL—AccessDOS114SHOWMEM—DisplayMemoryMap.
115SNAPSHOT—SaveScreen116SOURCE—SourceWindowDisplay.
117ST—SingleStep(Trace)118STACK—DisplayStack119STEP—SingleStep(Trace)120STEPFOR—StepForever121STEPTIL—SingleSteptoAddress.
122STOP—StopProgramExecution123SYSINFO—SystemInformation124T—SingleStep(Trace)125V—Set/ClearVBit126VAR—DisplayVariable.
127VER—DisplayVersion128VERSION—DisplayVersion.
129WAIT—PausebetweenCommands.
130Command-LineCommandsContentsMMEVS0508OM/DMOTOROLACommand-LineCommands63WAIT4RESET—WaitforTargetReset.
131WHEREIS—DisplaySymbolValue132X—SetXIndexRegister.
133XREG—SetXIndexRegister.
134Z—Set/ClearZBit135ZOOM—ResizeSourceWindow136Command-LineCommandsMMEVS0508OM/D64Command-LineCommandsMOTOROLAIntroductionKeyboardentryistheprimarymeansofMMEVScontrol.
Individualcommandsareenteredatthecommand-linepromptinthedebugF10window.
Thecommandsareusedtoinitializeemulationmemory,displayandstoredata,debugusercode,andcontrolflowofcodeexecution.
Thissectionexplainstherulesforcommandsyntaxandarguments,thengivesindividualexplanationsforeachcommand.
Someofthesecommandscanbeexecutedviamousecontrol.
Fordetailonusingthemouse,seethesectiontitledMouseOperation.
CommandSyntaxAcommand-linecommandisalineofASCIItextthatisenteredviathecomputerkeyboard.
Presstoterminateeachline,activatingthecommand.
Thetypicalcommandsyntaxis:>[].
.
.
Where:>Thecommandprompt.
ThesystemdisplaysthispromptinthedebugF10windowwhenreadyforanothercommand.
Acommandnameinupper-orlower-caseletters.
RefertoTable8forcommandchoices.
Oneormorearguments.
Table7explainsthemanykindsofpossiblearguments.
Incommandsyntaxdescriptions,brackets([])encloseoptionalitems,averticalline(|)meansor,andanellipsis(.
.
.
)meanstheprecedingitemcanberepeated.
Exceptwhereotherwisenoted,numericalvaluesinexamplesarehexadecimal.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands65Table7.
ArgumentTypesArgumentTypeSyntaxIndicatorsExplanationNumeric,,,Hexadecimalvalues,unlessotherwisenoted.
Leadingzeroscanbeomitted.
Fordecimalvalues,usetheprex!
orthesufxT.
Forbinaryvalues,usetheprex%orthesufxQ.
Example:54=!
100=100T=%1100100=1100100QAddressFourorfewerhexadecimaldigits(leadingzeroscanbeomitted).
Ifanaddressisdecimalorbinary,useaprexorsufxpertheexplanationofnumericarguments.
RangeArangeofaddressesornumbers.
Specifythelowvalue,thenthehighvalue,separatedbyaspace.
Leadingzeroscanbeomitted.
Symbol,SymbolsofASCIIcharacters,usuallysymbolsfromsourcecodeFilenameThenameofaleinDOSformat;eightorfewerASCIIcharacters.
Anoptionalextension(threeorfewercharacters)canbeincludedafteraperiod.
Iftheleisnotinthecurrentdirectory,precedethelenamewithacompletepath.
CommandsItemsfromthecommandsetmaybeusedasanargumentfortheHELPcommand.
Operator+(add);–(subtract);*(multiply);or/(divide)TypeSpeciesbyte,word,orstringdataoperationsTextThetextenteredwillbedisplayedwhencommandisexecuted.
TerminationTheterminatorcontrolscommandowinthememorymodifycommand.
Command-LineCommandsMMEVS0508OM/D66Command-LineCommandsMOTOROLACommandExplanationsTable8liststhecommand-linecommands.
Individualexplanationsofeachofthesecommandsfollowthetable.
NotethatthecommandparseroftheMMEVShostsoftwareisnotcasesensitive.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands67Table8.
CommandSummaryMnemonicDescriptionMnemonicDescriptionASetaccumulatorOSCSelectemulatorclockfrequencyACCSetaccumulatorPCSetprogramcounterASMAssembleinstructionsQUITTerminatehostsessionBAUDSetcommunicationsbaudrateREGDisplayregistersBAUDCHKBaudratecheckREMAddcommenttoscriptleBELLSoundbellRESETResetemulationMCUBFBlockllRESETGOResetandrestartMCUBRSetinstructionbreakpointRESETINResetinputenableCSet/ClearCbitRESETOUTResetoutputenableCCRSetconditioncoderegisterSCRIPTExecutescriptleCHIPINFOChiphelpinformationSETMEMCustomizememorymapCLEARMAPRemovesymbolsSHELLAccessDOSCOLORSSetscreencolorsSHOWMEMDisplaymemorymapDASMDisassembleinstructionsSNAPSHOTSavescreentoalogleEVALEvaluateargumentSOURCESourcewindowdisplayEXITTerminatehostsessionSTSinglestep(Trace)GBeginprogramexecutionSTACKDisplaystackGOBeginprogramexecutionSTEPSinglestep(Trace)GOTILExecuteprogramuntiladdressSTEPFORStepforeverHSet/ClearHbitSTEPTILSinglesteptoaddressHELPDisplayhelpinformationSYSINFOSysteminformationHREG*SetHregisterTSinglestep(Trace)HX*SetHXindexregisterV*SetoverowVbitISet/ClearIbitVARDisplayvariableINFODisplaylineinformationVERDisplayversionLFLogleVERSIONDisplayversionLOADLoadS19leWAITPausebetweencommandsLOADMAPLoadsymbolsWAIT4RESETWaitfortargetresetLOADMEMLoadpersonalityleSTOPStopprogramexecutionMDMemorydisplayWHEREISDisplaysymbolvalueMMMemorymodifyXSetXindexregisterNSet/ClearNbitXREGSetXindexregisterNOBRClearbreakpointsZSet/ClearZbit*MMEVS08onlyZOOMResizesourcewindowCommand-LineCommandsMMEVS0508OM/D68Command-LineCommandsMOTOROLAASetAccumulatorATheAcommandsetstheaccumulatortoaspecifiedvalue.
TheAandACCcommandsareidentical.
Syntax:AWhere:ThevaluetobeloadedintotheaccumulatorExample:>A10Settheaccumulatorto10.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands69ACCSetAccumulatorACCTheACCcommandsetstheaccumulatortoaspecifiedvalue.
TheACCandAcommandsareidentical.
Syntax:ACCWhere:ThevaluetobeloadedintotheaccumulatorExample:>ACC20Settheaccumulatorto20.
Command-LineCommandsMMEVS0508OM/D70Command-LineCommandsMOTOROLAASMAssembleInstructionsASMTheASMcommandassemblesM68HC05FamilyorM68HC08Familyinstructionmnemonicsandplacestheresultingmachinecodeintomemoryataspecifiedaddress.
Thecommanddisplaysthespecifiedaddress,itscontents,andapromptforaninstruction.
Aseachinstructionisentered,thecommandassemblestheinstruction,storesanddisplaystheresultingmachinecode,anddisplaysthecontentsofthenextmemorylocationwithapromptforanotherinstruction.
Toterminatethecommand,enteraperiod(.
).
Syntax:ASM[]Where:Anaddressatwhichtheassemblerplacesthefirstmachinecodegenerated.
Ifisnotspecified,thesystemcheckstheaddressusedbythepreviousASMcommand,thenusesthefollowingaddressforthisASMcommand.
Examples:ThefirstexampleshowstheASMcommandwithanaddressargument:>asm10001009DNOP>CLRA01004FCLRA01019DNOP>.
ThesecondexampleshowstheASMcommandwithnoargument:>ASM01019DNOP>STA0A0101B70ASTA0A01039DNOP>.
NOTE:ChangesmadetocodeviathiscommandcannotbesavedtoanS-recordfileortoasourcecodefile.
Thiscommandshouldbeusedonlytocreateandmodifycodetoberunduringthecurrentdebugsession.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands71BAUDSetCommunicationsBaudRateBAUDTheBAUDcommandchangesthebaudrateforcommunicationsbetweenthesystemcontrollerandthehostcomputer.
Forbestperformanceofthesystem,communicationsshouldbeatthemaximumavailablebaudrate.
Reducethisrateifthesoftwaredisplayscommunicationserrormessages.
Enteringthiscommandwithoutarateargumentcallsupthebaudratewindow.
Abaudratecanbeselectedviathiswindow.
NOTE:Atpower-up,MMEVSsoftwareautomaticallysetsthemaximumbaudrateforthesystem.
Ifthebaudrateisreducedbutcommunicationerrorspersist,turnoffthediskcache(forinstance,SMARTDRV.
EXE).
Syntax:BAUD[]Where:Oneofthesedecimalbaud-ratevalues:24004800960019,20038,40057,600Example:>BAUD9600Changethecommunicationsbaudrateto9600.
NOTE:Tospecifyadefaultbaudrateof9600,addthe–BoptionwhenfirstrunningtheMMEVScommand.
Command-LineCommandsMMEVS0508OM/D72Command-LineCommandsMOTOROLABAUDCHKBaudRateCheckBAUDCHKTheBAUDCHKcommandsetsthecommunicationratebetweenthehostsoftwareandtheMMEVSsystem.
Thecommandfirstcheckscommunicationatthemaximumpossiblerateof57600baudandsuccessivelylowerstherateuntilcommunicationwiththeMMEVSisestablished.
Syntax:BAUDCHKExample:>BAUDCHK57600baudcommunicateswellThecommanddisplaysamessageindicatingthemaximumavailablebaudrate.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands73BELLSoundBellBELLTheBELLcommandsoundsthecomputerbellthespecifiedhexadecimalnumberoftimes.
Thebellsoundsonceifanargumentisnotentered.
Toturnoffthebellasitissounding,pressanykey.
Syntax:BELL[]Where:ThehexadecimalnumberoftimestosoundthebellExamples:>BELLSoundthebellonce.
>BELLCSoundthebell12(decimal)times.
>BELL12Soundthebell18(decimal)times.
Command-LineCommandsMMEVS0508OM/D74Command-LineCommandsMOTOROLABFBlockFillBFTheBFcommandfillsablockofmemorywithaspecifiedbyteorword.
Ifthesystemcannotverifyawritetooneofthedesignatedmemorylocations,itwillstopcommandexecutionandreportanerrorcondition.
Syntax:BF[.
]Where:Sizeof:Bisan8-bitvalue(thedefault)Wisa16-bitvalueAblock(range)ofmemorydefinedbybeginningandendingaddresses.
Avaluetobestoredinabyteorwordofthespecifiedblock.
Ifisspecifiedtobeabytevalue,thenisan8-bitvalue.
Ifisspecifiedtobeawordvalue,thenisa16-bitvalueandisstoredineachwordoftheblock.
Examples:>BF20020FFFStoreFFhexadecimalinbytesataddresses200to20F.
>BF.
W10011F4143Store4143inwordsataddresses100to11F.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands75BRSetInstructionBreakpointBRTheBRcommandsetsaninstructionbreakpointataspecifiedaddressorrangeofaddresses.
Ifamapfilehasbeenloaded,symbols(orlabels)fromthesourcecodecanbeusedasarguments.
Themaximumnumberofallinstructionbreakpointsis64.
Foralistofallactivebreakpoints,enterthiscommandwithoutanyparametervalue.
Abreakpointoccursonlyonanaddressthatcontainsanopcode(thatis,aninstructionfetchaddress).
Althoughthiscommandsetsbreakpointsateachaddressofarange,breakpointsoccuronlyattheopcodeaddresseswithintherange.
ThesystemdisplaysanerrormessageiftheaddressiswithintherangedefinedbyapreviousBRcommandoriftherangeofanewBRcommandoverlapstherangeofanexistingBRcommand.
Anerrormessagealsoappearsifsettinga65thbreakpointisattempted.
Syntax:BR[||]Where:TheaddressforabreakpointTherangeofaddressesforbreakpoints;abeginningaddressandanendingaddress,separatedbyaspace.
Thelabelofaninstructioninsourcecode.
Examples:>BR100Setabreakpointataddress100.
>BR13013FSet16breakpointsataddresses130through13F.
>BRSTARTSetabreakpointataddresslabelSTARTincode.
>BR1000103FSet64breakpointsataddresses1000through103F.
Notethattryingtosetadditionalbreakpoints,withoutclearingsomeofthesebreakpoints,wouldbringuptheerrormessage:ToomanybreakpointsCommand-LineCommandsMMEVS0508OM/D76Command-LineCommandsMOTOROLACSet/ClearCBitCTheCcommandsetstheCbitoftheconditioncoderegister(CCR)tothespecifiedvalue.
NOTE:TheCCRbitdesignatorsarelocatedatthelowerrightoftheCPUwindow.
TheCCRpatternisV11HINZC(Vistwo'scomplementoverflowforM68HC08MCUonlyandis1forM68HC05MCU,Hishalf-carry,IisIRQinterruptmask,Nisnegative,Ziszero,andCiscarry).
AletterinthesedesignatorsmeansthatthecorrespondingbitoftheCCRisset;aperiodmeansthatthecorrespondingbitisclear.
Syntax:C0|1Where:0ClearstheCbit1SetstheCbitExample:>C0CleartheCbitoftheCCR.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands77CCRSetConditionCodeRegisterCCRTheCCRcommandsetstheconditioncoderegister(CCR)tothespecifiedhexadecimalvalue.
NOTE:TheCCRbitdesignatorsarelocatedatthelowerrightoftheCPUwindow.
TheCCRpatternisV11HINZC(Vistwo'scomplementoverflowforM68HC08MCUonlyandis1forM68HC05MCU,Hishalf-carry,IisIRQinterruptmask,Nisnegative,Ziszero,andCiscarry).
AletterinthesedesignatorsmeansthatthecorrespondingbitoftheCCRisset;aperiodmeansthatthecorrespondingbitisclear.
Syntax:CCRWhere:ThenewhexadecimalvaluefortheCCRExample:>CCRE4SettheCCRtoE4(Nbitset,othersclear).
Command-LineCommandsMMEVS0508OM/D78Command-LineCommandsMOTOROLACHIPINFOChipHelpInformationCHIPINFOTheCHIPINFOcommandaccessesregister,memory-map,vector,andpin-outinformationabouttheemulationMCU.
EnteringthiscommandbringsupthetopicswindowasshowninFigure9.
Selectatopictobringupasubordinatewindow.
(Toselectatopic,clickonit;alternatively,highlightthetopic,thenpress.
)Thesubordinatewindowsandtheircontentsare:REGISTERSRegisteraddressesoftheMCUbeingemulated.
Selectinganaddressopensanothersubordinatewindowthatdisplayseachbitoftheregister.
MEMORYMAPThememorymapfortheMCUbeingemulated.
VECTORSThevectorsfortheMCUbeingemulated.
PINOUTThepinoutsfortheMCUbeingemulated.
Figure9.
TopicsWindowSyntax:CHIPINFOExample:>CHIPINFOAccessemulationMCUinformation.
TopicsREGISTERSMEMORYMAPVECTORSPINOUTCommand-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands79CLEARMAPRemoveSymbolsCLEARMAPTheCLEARMAPcommandremovesthesymboldefinitionsinthehostcomputer.
Ifamapfileisloaded,symbols(orlabels)fromthesourcecodecanbeusedasargumentsformanyothercommands.
Syntax:CLEARMAPExample:>CLEARMAPClearsymbolsandtheiraddressdefinitions.
Command-LineCommandsMMEVS0508OM/D80Command-LineCommandsMOTOROLACOLORSSetScreenColorsCOLORSTheCOLORScommandsetsthescreencolors.
Enteringthiscommandbringsupthecolorswindow.
Thiswindowincludesalistofscreenelementsandamatrixofforeground/backgroundcolorcombinations;eachcolorcombinationhasa2-digithexadecimalnumber.
Apromptasksforthecolorofthefirstscreenelement.
Toacceptthecurrentcolor,press.
Tochangethecolor,enterthenumberofthechoice,thenpress.
Anewpromptasksforthecolorofthenextelement.
Selectthecolorforeachelementinthesameway.
ThecommandendswhenacolorforthelastscreenelementisselectedorwhenESCispressed.
Inthecolormatrix,rowscorrespondtobackgroundcolorsandcolumnscorrespondtoforegroundcolors.
Thismeansthatcolorchoicesfromthesamerowresultindifferentlycoloredlettersandnumbersagainstthesamebackgroundcolor.
Makingthebackgroundofhighlightsandhelpscreensadifferentcolorsetstheseelementsofffromthemainscreen.
ThesoftwarestorescolorselectionsinfileCOLORS.
05orCOLORS.
08;whenMMEVSisexecutedagain,thesoftwareappliesthenewlyselectedcolors.
NOTE:DeletetheCOLORS.
05orCOLORS.
08filefromtheMMEVSsubdirectorytoreturntothedefaultcolors.
Syntax:COLORSCommand-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands81DASMDisassembleInstructionsDASMTheDASMcommanddisassemblesthreeormoremachineinstructions,displayingtheaddressesandthecontentsasdisassembledinstructions.
Disassemblybeginsatthespecifiedaddress.
Thevalidaddressrangeis$0000to$FFFF.
Syntax:DASM[]Where:Thestartingaddressfordisassembly.
mustbeaninstructionopcode.
Ifonlyanvalueisentered,thesystemdisassemblesthreeinstructions.
Theendingaddressfordisassembly.
Ifanvalueisentered,disassemblybeginsatandcontinuesthrough.
Thescreenscrollsupwardasaddressesandtheircontentsaredisplayed,leavingthelastinstructionsintherangedisplayedinthewindow.
Example:Disassembleanddisplaythreeinstructionsbeginningataddress100:>DASM1000100A6E8LDA#0E80102B702STA000201044FCLRANOTE:Forarangelargerthanthreecommands,logfilescanbeusedtostoreDASMresponsestoafile.
Command-LineCommandsMMEVS0508OM/D82Command-LineCommandsMOTOROLAEVALEvaluateArgumentEVALTheEVALcommandperformsmathematicaloperationsontwonumericalarguments.
Itdisplaysthevalueoftheresultinhexadecimal,decimal,octal,andbinaryformatsdenotedbythesuffixesH,T,O,andQ.
(Notethatoctalnumbersarenotvalidasoperandvalues.
Operandvaluesare15bitsorless.
)IfthevalueisequivalenttoanASCIIcharacter,theASCIIcharacterisalsodisplayed.
Thiscommandsupportsaddition(+),subtraction(–),multiplication(*)anddivision(/).
Syntax:EVALWhere:AnumbertobeevaluatedorthefirstoperandofasimpleexpressiontobeevaluatedThearithmeticoperatoror/)ofasimpleexpressiontobeevaluatedThesecondoperandofasimpleexpressiontobeevaluatedExample:Evaluatethesumofhexadecimalnumbers45and32thendisplaytheresultinfourbasesandasanASCIIcharacter:>EVAL45+320077H119T000157O0000000001110111Q"w"NOTE:Thehostwillnotinformofanoperationthatresultedinanoverflow.
Also,theresultofadivisionoperationwillbethequotient.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands83EXITTerminateHostSessionEXITTheEXITcommandterminatesthehostsessionandreturnstoDOS.
TheEXITandQUITcommandsareidentical.
AnotherwaytoendahostsessionistoentertheALT-Xkeyboardcombination.
Syntax:EXITExample:>EXITReturntoDOS.
Command-LineCommandsMMEVS0508OM/D84Command-LineCommandsMOTOROLAGBeginProgramExecutionGTheGcommandstartsexecutionofcodeintheemulatoratthecurrentaddressorataspecifiedaddress.
Ifoneaddressisentered,itisthestartingaddress.
Iftwoaddressesareentered,executionbeginsatthefirstandstopsatthesecond.
Ifamapfilehasbeenloaded,symbols(orlabels)fromthesourcecodecanbeusedasarguments.
TheGandGOcommandsareidentical.
Ifnoaddressoronlyoneaddressisspecified,executioncontinuesuntilaSTOPcommandisentered,abreakpointoccurs,oranerroroccurs.
Syntax:G[|][|]Where:Executionstartingaddress.
Ifanvalueisentered,thesystemloadsthevalueintotheprogramcounter(PC),thenstartsexecutionattheaddressinthePC.
Ifanvalueisnotentered,executionbeginsattheaddressalreadyinthePC.
Executionstopaddress.
Thevaluemustbeaninstructionfetchaddress;ifitisnot,codeexecutioncontinuesasifthecommandhadnovalue.
Thelabelofaninstructioninsourcecode.
NOTE:BecarefulaboutusingtheG,GO,orGOTILcommandsifthecodebranchesintointernalRAM(forinstance,optionRAM)orEEPROM.
Anexecutionstopaddressisinvalidforinternallocations.
Examples:>GBegincodeexecutionatthecurrentPCvalue.
>G145Begincodeexecutionataddress145.
>GSTARTBegincodeexecutionatlabelSTARTinsourcecode.
>G200271Begincodeexecutionataddress200.
Endcodeexecutionjustbeforetheinstructionataddress271.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands85GOBeginProgramExecutionGOTheGOcommandstartsexecutionofcodeintheemulatoratthecurrentaddressorataspecifiedaddress.
Ifoneaddressisentered,itisthestartingaddress.
Iftwoaddressesareentered,executionbeginsatthefirstandstopsatthesecond.
Ifamapfilehasbeenloaded,symbols(orlabels)fromthesourcecodecanbeusedasarguments.
TheGOandGcommandsareidentical.
Ifnoaddressoronlyoneaddressisspecified,executioncontinuesuntilaSTOPcommandisentered,abreakpointoccurs,oranerroroccurs.
Syntax:GO[|][|]Where:Executionstartingaddress.
Ifanvalueisentered,thesystemloadsthevalueintotheprogramcounter(PC),thenstartsexecutionattheaddressinthePC.
Ifanvalueisnotentered,executionbeginsattheaddressalreadyinthePC.
Executionstopaddress.
Thevaluemustbeaninstructionfetchaddress;ifitisnot,codeexecutioncontinuesasifthecommandhadnovalue.
Thelabelofaninstructioninsourcecode.
NOTE:BecarefulaboutusingtheG,GO,orGOTILcommandsifthecodebranchesintointernalRAM(forinstance,optionRAM)orEEPROM.
Anexecutionstopaddressisinvalidforinternallocations.
Examples:>GOBegincodeexecutionatthecurrentPCvalue.
>GO145Begincodeexecutionataddress145.
>GOSTARTBegincodeexecutionatlabelSTARTinsourcecode.
>GO200271Begincodeexecutionataddress200.
Endcodeexecutionjustbeforetheinstructionataddress271.
Command-LineCommandsMMEVS0508OM/D86Command-LineCommandsMOTOROLAGOTILExecuteProgramuntilAddressGOTILTheGOTILcommandexecutestheprogramintheemulator,beginningattheaddressintheprogramcounter(PC).
Executioncontinuesuntiltheprogramcountercontainsthespecifiedaddressduringanopcodefetchcycle.
Ifamapfilehasbeenloaded,symbols(orlabels)fromthesourcecodecanbeusedasarguments.
Syntax:GOTIL|Where:Executionstopaddress.
Thevaluemustbeaninstructionfetchaddress;ifitisnot,codeexecutioncontinuesasifthecommandhadnovalue.
Thelabelofaninstructioninsourcecode.
NOTE:BecarefulaboutusingtheG,GO,orGOTILcommandsifthecodebranchesintointernalRAM(forinstance,optionRAM)orEEPROM.
Anexecutionstopaddressisinvalidforinternallocations.
Example:>GOTIL0FF0Executetheprogramintheemulatoruptoaddress0FF0.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands87HSet/ClearHBitHTheHcommandsetstheHbitoftheconditioncoderegister(CCR)tothespecifiedvalue.
NOTE:TheCCRbitdesignatorsareatthelowerrightoftheCPUwindow.
TheCCRpatternisV11HINZC(Vistwo'scomplementoverflowforM68HC08MCUonlyandis1forM68HC05MCU,Hishalf-carry,IisIRQinterruptmask,Nisnegative,Ziszero,andCiscarry).
AletterinthesedesignatorsmeansthatthecorrespondingbitoftheCCRisset;aperiodmeansthatthecorrespondingbitisclear.
Syntax:H0|1Where:0ClearstheHbit1SetstheHbitExample:>H1SettheHbitoftheCCR.
Command-LineCommandsMMEVS0508OM/D88Command-LineCommandsMOTOROLAHELPDisplayHelpInformationHELPTheHELPcommanddisplaysalistofhelptopicssuchascommandsandfunctionkeys.
Ifcommandsareselected,thesoftwaredisplaysanalphabeticindexofthecommandsetfromwhichacommandcanbeselected.
Toselecthelpforacommand,highlightthecommandusingthepageup/downkeysandthearrowkeys,thenpress.
Thecommanddescriptionscreenshowsthecommandnameanditssyntaxanddescribesthecommand.
Whenappropriate,thedescriptionincludesexamplesandclarifyingnotes.
Selectingkeycommandsbringsupalistofscreensinwhichfunction-keyassignmentsdiffer.
Selectascreentoseeitsfunction-keyassignments.
Usethearrowkeystoscrollwithinthepage;usethepageupandpagedownkeystoseeotherpages.
ToexittheHELPdatabaseandreturntothepreviousscreen,presstheESCkey.
Syntax:HELP[]Where:NameofacommandforwhichadescriptionisneededExamples:>HELPDisplaytheHELPscreens.
>HELPASMDisplaythedescriptionoftheASMcommand.
Relatedkeycommand:Pressingpullsupthemainhelpwindow.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands89HREGSetHRegisterHREGNOTE:ThiscommandisfortheMMEVS08only.
TheHREGcommandsetstheupperbyteoftheindexregistertothespecifiedvalue.
Syntax:HREGWhere:ThenewvaluefortheHregisterExample:>HREGF0SettheHregistervaluetoF0.
Command-LineCommandsMMEVS0508OM/D90Command-LineCommandsMOTOROLAHXSetH:XIndexRegisterHXNOTE:ThiscommandisfortheMMEVS08only.
TheHXcommandsetsbothbytesoftheconcatenatedindexregister(H:X)tothespecifiedvalue.
Syntax:HXWhere:ThenewvaluefortheH:XregisterExample:>HX0400SettheH:Xindexregisterto$400.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands91ISet/ClearIBitITheIcommandsetstheIbitintheconditioncoderegister(CCR)tothespecifiedvalue.
NOTE:TheCCRbitdesignatorsareatthelowerrightoftheCPUwindow.
TheCCRpatternisV11HINZC(Vistwo'scomplementoverflowforM68HC08MCUonlyandis1forM68HC05MCU,Hishalf-carry,IisIRQinterruptmask,Nisnegative,Ziszero,andCiscarry).
AletterinthesedesignatorsmeansthatthecorrespondingbitoftheCCRisset;aperiodmeansthatthecorrespondingbitisclear.
Syntax:I0|1Where:0ClearstheIbit1SetstheIbitExample:>I1SettheIbitoftheCCR.
Command-LineCommandsMMEVS0508OM/D92Command-LineCommandsMOTOROLAINFODisplayLineInformationINFOTheINFOcommanddisplaysinformationaboutthehighlightedlineinthesourcewindow.
Thisinformationincludesthenameofthefilebeingdisplayedinthewindow,thelinenumber,address,correspondingobjectcode,andthedisassembledinstruction.
Syntax:INFOExample:>INFOFilename:05TESTCO.
ASMLinenumber:!
117Address:$0100Disassembly:010099SECIfamapfileisloadedandthehighlightedinstructionhasalabel,thelabelwillbedisplayedinthedisassemblylineinplaceoftheaddress.
Example:>INFOFilename:05TESTCO.
ASMLinenumber:!
117Address:$0100Disassembly:START99SECCommand-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands93LFLogFileLFTheLFcommandstartsorstopsloggingofcommandsandresponsestoanexternalfile.
Ifloggingisnotenabled,enterthiscommandtostartlogging.
Whileloggingremainsineffect,anylinethatisappendedtothecommandlogwindowalsoiswrittentothelogfile.
LoggingcontinuesuntilanotherLFcommandisentered;thissecondcommanddisablesloggingandclosesthelogfile.
Ifthespecifiedfiledoesnotalreadyexist,thiscommandcreatesthefile.
Ifthespecifiedfiledoesexistalready,thecommandpromptsforoverwriteorappend:Fileexists,RewriteorAppend[R]:If(acceptthedefault)ispressed,orRand,thelogentriesoverwritethedataintheexistingfile.
IfAandarepressed,thesystemappendslogentriestothefile.
Syntax:LFWhere:TheDOSfilenameofthelogfile;thecommandinterpreterdoesnotassumeafilenameextension.
Examples:>LFlogfileStartlogging.
Writetofilelogfile(inthecurrentdirectory)alllinesaddedtothecommandlogwindow.
>LFIfloggingisenabled:Disableloggingandclosethelogfile.
Command-LineCommandsMMEVS0508OM/D94Command-LineCommandsMOTOROLALOADLoadS19FileLOADTheLOADcommandloadsafilein.
S19format(andanymapfilewiththesamename)intotheemulator.
Ifnoargumentissupplied,thecommandpopsupafileselectwindow.
Syntax:LOADWhere:ThenameoftheS-recordfiletobeloaded.
Anextensionof.
S19isthedefaultandcanbeomitted.
Theextensionmustbespecifiedforfileswithotherextensions.
Apathnamefollowedbytheasterisk(*)wildcardcharactercanbeentered.
Inthatcase,thecommanddisplaysawindowthatliststhefilesinthespecifieddirectorythathavethe.
S19extension.
Examples:>LOADPROG1.
S19LoadfilePROG1.
S19anditsmapfileintotheemulatorattheloadaddressesinthefile.
>LOADPROG2LoadfilePROG2.
S19anditsmapfileintotheemulatorattheloadaddressesinthefile.
>LOADA:*Displaythenamesofthe.
S19filesonthedisketteindriveA:foruserselectionofafile.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands95LOADMAPLoadSymbolsLOADMAPTheLOADMAPcommandloadsamapfilethatcontainssymbolinformationfromsourcecode.
Ifnoargumentissupplied,thecommandpopsupafileselectwindow.
Syntax:LOADMAPWhere:Thenameofthemapfiletobeloaded.
Anextensionof.
MAPisthedefaultandcanbeomitted.
Theextensionmustbespecifiedforfileswithotherextensions.
Apathnamefollowedbytheasterisk(*)wildcardcharactercanbeentered.
Inthatcase,thecommanddisplaysawindowthatliststhefilesinthespecifieddirectorythathavethe.
MAPextension.
Examples:>LOADMAPPROG1.
MAPLoadmapfilePROG1.
MAPintothehostcomputer.
>LOADMAPPROG2LoadmapfilePROG2.
MAPintothehostcomputer.
>LOADMAPA:*Displaythenamesofthe.
MAPfilesonthedisketteindriveA:,foruserselectionofafile.
Command-LineCommandsMMEVS0508OM/D96Command-LineCommandsMOTOROLALOADMEMLoadPersonalityFileLOADMEMPersonalityfilesareusedtocustomizetheemulationmemorymapforaspecificmicrocontrollerdevice.
Apersonalityfiletobeloadedcouldhavebeenshippedwithanemulationmodule(EM)orcouldhavebeencreatedbypressingtheF6keyintheSETMEMwindow.
TheLOADMEMcommandloadsthememorymapfortheemulatorwiththemapinformationfromthespecifiedfile.
Syntax:LOADMEMWhere:Thenameofthememory-mappingfiletobeloaded.
Anextensionof.
MEMisthedefaultandcanbeomitted.
Ifapathnamefollowedbytheasterisk(*)wildcardcharacterisentered,thecommanddisplaysawindowthatliststhefilesinthespecifieddirectorythathavethe.
MEMextension.
Ifa.
MEMfileisselectedthatisnotappropriateforthecurrentEMinstalled,anerrorwillbegenerated.
Examples:>LOADMEM000P4V01.
MEMMake000P4V01.
MEMthecurrentmemory-mappingfile.
>LOADMEM003FEV01.
MEMMake003FEV01.
MEMthecurrentmemory-mappingfile.
>LOADMEMA:*Displaythenamesofthe.
MEMfilesonthedisketteindriveA:,foruserselectionofafile.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands97MDMemoryDisplayMDTheMDcommanddisplays(inthememoryF3window)thecontentsof32emulationmemorylocations.
Thespecifiedaddressisthefirstofthe32locations.
Ifalogfileisopen,thiscommandalsowritesthefirst16valuestothelogfile.
Syntax:MDWhere:ThestartingmemoryaddressfordisplayinthememorywindowExample:>MD1000Displaythecontentsof32bytesofmemorybeginningataddress1000.
Command-LineCommandsMMEVS0508OM/D98Command-LineCommandsMOTOROLAMMMemoryModifyMMTheMMcommandletstheuserinteractivelyexamineandmodifycontentsofmemorylocations.
Writestomemoryareverifiedanda"writedidnotverify"isdisplayedifthewritecouldnotbeverified.
Notethatthismessagemaybeacceptableinsomesituations,suchaswritingtoregistersthathavewrite-onlybits.
Ifanydataargumentsareenteredwiththiscommand,thesystemstoresthevalues,beginningatthespecifiedaddress.
ThiscommanddoesnotalterthecontentsofCPUregisterssuchastheprogramcounter(PC).
Syntax:MM[][]Where:TheaddressofamemorylocationtobemodifiedThevalue(s)tobestoredatthelocation.
Ifmorethanonedatabyteissupplied,thetwodatabytesarestoredinconsecutivememorylocationsstartingattheaddressargument.
Ifisnotsupplied,thecommandflowwilldisplaythecurrentcontentsofthespecifiedaddressandanentrypromptfordata.
ThesyntaxforentryattheMMdatapromptis:[][]Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands99Where:Thevaluetobestoredattheargument.
Thecommandterminatorcharactercontrolsthenextstepinthecommandflow.
Thefourchoicesare:a.
Ifnoissupplied,addressflowwillsequenceforward.
b.
Iftheequal(=)characterisentered,flowwillstayatthecurrentaddress.
c.
Ifthecarat(^)characterisentered,flowwillsequencebackwardtothepreviousaddress.
d.
Iftheperiod(.
)characterisentered,flowwillterminateandreturntothecommandlineprompt.
Examples:Thefirstexampledoesnothaveavalueinthecommandline,permittingentryofnewvaluesforconsecutiveaddresses.
Enteringaperiodinsteadofanewvaluestopsthecommand:>MM10001000=0F>051001=10>.
Thesecondexampleincludesavalue,sothecommandmodifiesonlyonememorylocation:>MM10000Command-LineCommandsMMEVS0508OM/D100Command-LineCommandsMOTOROLANSet/ClearNBitNTheNcommandsetstheNbitoftheconditioncoderegister(CCR)tothespecifiedvalue.
NOTE:TheCCRbitdesignatorsareatthelowerrightoftheCPUwindow.
TheCCRpatternisV11HINZC(Vistwo'scomplementoverflowforM68HC08MCUonlyandis1forM68HC05MCU,Hishalf-carry,IisIRQinterruptmask,Nisnegative,Ziszero,andCiscarry).
AletterinthesedesignatorsmeansthatthecorrespondingbitoftheCCRisset;aperiodmeansthatthecorrespondingbitisclear.
Syntax:N0|1Where:0ClearstheNbit1SetstheNbitExample:>N1SettheNbitoftheCCR.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands101NOBRClearBreakpointsNOBRTheNOBRcommandclearsoneinstructionbreakpoint,allinstructionbreakpoints,orallinstructionbreakpointswithinanaddressrange.
Ifamapfilehasbeenloaded,symbols(orlabels)fromthesourcecodecanbeusedasarguments.
Ifthiscommandhasonlyoneargument,itclearsthebreakpointatthataddress.
Ifthiscommandhasnoargument,itclearsallcurrentbreakpoints.
Ifthiscommandhastwoaddressvalues,itclearsallinstructionbreakpointsintherangetheaddressesdefine.
Syntax:NOBR[||]Where:TheaddressofasinglebreakpointtoberemovedTherangeofaddressesfromwhichallbreakpointsshouldberemovedThelabelofaninstructioninsourcecode.
Examples:>NOBRClearallcurrentinstructionbreakpoints.
>NOBR120Cleartheinstructionbreakpointataddress120.
>NOBR120140Clearallinstructionbreakpointsintheaddressrange120to140.
>NOBRSTARTClearapreviouslysetbreakpointataddresslabelSTARTinsourcecode.
Command-LineCommandsMMEVS0508OM/D102Command-LineCommandsMOTOROLAOSCSelectEmulatorClockFrequencyOSCTheM68MMPFB0508platformboardcansupplyanoscillatorclocksourcefortheMCU'sOSC1input.
FortheMMEVS05,fourinternallygeneratedclockfrequenciesareavailable:8MHz,4MHz,2MHz,and1MHz.
Enteringemulatorclock(OSC)commandwithoutthedesignatedfrequencybringsupthetemporaryMMEVSemulatorclockfrequencywindownearthecenterofthedebugscreen.
Usetheup/downarrowkeystoselecttheemulatorMCU'sclockfrequencyandpresstocompletetheselection.
Thedefaultemulatorclockrateis2MHz.
FortheMMEVS08,fiveinternallygeneratedclockfrequenciesareavailable:16MHz,8MHz,4MHz,2MHz,and1MHz.
Thedefaultemulatorclockrateis4MHz.
EnteringthiscommandwithouttheargumentbringsuptheEMoscillatorwindow.
Anoscillatorfrequencycanbeselectedviathiswindow.
NOTE:ManyEMsrequireaspecificjumperconfigurationinordertousethisclocksource.
RefertotheEMuser'smanualforEMclocksourceinformation.
Syntax:OSC[]Where:8,4,2,or1.
Examples:>OSC4Usethe4-MHzinternalemulatorclock.
>OSCBringuptheemulatorclockwindow.
Thecurrentoscillatorsettingwillbehighlighted.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands103PCSetProgramCounterPCThePCcommandsetstheprogramcounter(PC)tothespecifiedaddress.
Syntax:PCWhere:ThenewaddressvalueforthePCExample:PC0500SetthePCto0500.
Command-LineCommandsMMEVS0508OM/D104Command-LineCommandsMOTOROLAQUITTerminateHostSessionQUITTheQUITcommandterminatesthehostsessionandreturnstoDOS.
TheQUITandEXITcommandsareidentical.
AnotherwaytoendahostsessionistoentertheALT-Xkeyboardcombination.
Syntax:QUITExample:>QUITReturntoDOS.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands105REGDisplayRegistersREGTheREGcommanddisplaysthecontentsoftheCPUregistersinthedebugF10window.
Thecommandalsowilldisplaytheinstructionpointedtobythecurrentprogramcountervalue.
Syntax:REGExample:>REGPC:1196A:00X:90SP:FFCCR:FA[BRCLR1,0003,119C]Command-LineCommandsMMEVS0508OM/D106Command-LineCommandsMOTOROLAREMAddCommenttoScriptFileREMTheREMcommandaddsadisplaycommenttoascriptfile.
Whenthescriptfileisexecuted,thesystemdisplaysthiscomment.
Syntax:REMWhere:Thedisplaycomment.
Example:>REMProgramexecutingDisplayProgramexecutingonlyduringscriptfileexecution.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands107RESETResetEmulationMCURESETTheRESETcommandresetstheemulationMCUandsetstheprogramcountertothecontentsoftheresetvector.
Thiscommanddoesnotstartexecutionofusercode.
Toresetandexecuteusercode,usetheRESETGOorWAIT4RESETcommand.
Syntax:RESETExample:>RESETResettheMCU.
Command-LineCommandsMMEVS0508OM/D108Command-LineCommandsMOTOROLARESETGOResetandRestartMCURESETGOTheRESETGOcommandresetstheemulationMCU,setstheprogramcounter(PC)tothecontentsoftheresetvector,thenstartsexecutionfromthataddress.
Syntax:RESETGOExample:>RESETGOResettheMCUandgo.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands109RESETINResetInputEnableRESETINTheRESETINcommandmakesitpossibleforthetargetsystemtoresettheemulatingMCU.
EnteringthiscommandtogglestheMMEVSstatewithregardtoaresetsignalfromthetargetsystem.
Ifthisstateisenabled,aresetsignalfromthetargetsystemresetstheemulatingMCU.
Ifthisstateisdisabled,aresetsignalfromthetargetsystemcannotresettheemulatingMCU.
ThewordResetinappearsinthedebugscreenstatusareatoshowtheenabledstate.
ThestatemustbeenabledforproperoperationoftheWAIT4RESETcommand.
NOTE:CertainEMsincludeahardwarejumperthatgovernstargetresets.
SuchajumpermustbeconfiguredcorrectlytousetheRESETINcommand.
ConsulttheEMuser'smanualforadditionalinformation.
Syntax:RESETINExample:>RESETINToggletheMMEVSRESETINstate.
Command-LineCommandsMMEVS0508OM/D110Command-LineCommandsMOTOROLARESETOUTResetOutputEnableRESETOUTTheRESETOUTcommandmakesitpossiblefortheMMEVSRESETcommandtoresetthetargetsystem.
EnteringthiscommandtogglestheMMEVSstatewithregardtoresettingthetargetsystem.
Ifthisstateisenabled,enteringtheRESETcommandresetsboththeemulatingMCUandthetargetsystem.
ThewordResetoutappearsinthedebugscreenstatusareatoshowtheenabledstate.
Ifthisstateisdisabled,enteringtheRESETcommandresetsonlytheemulatingMCU.
TheRESETOUTcommandalsopertainstoresetsdoneviatheRESETGOcommand.
NOTE:CertainEMsincludeahardwarejumperthatgovernstargetresets.
SuchajumpermustbeconfiguredcorrectlytousetheRESETOUTcommand.
ConsultyourEMuser'smanualforadditionalinformation.
Syntax:RESETOUTExample:>RESETOUTToggletheMMEVSRESETOUTstate.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands111SCRIPTExecuteScriptFileSCRIPTTheSCRIPTcommandexecutesascriptfile,whichcontainsasequenceofemulatorcommands.
Executingthescriptfilehasthesameeffectasexecutingtheindividualcommandsoneafteranother.
Thismakesascriptfileconvenientforanysequenceofcommandsthatisneededoften,suchasunittestorinitializationcommandsequences.
TheREMandWAITcommandsareusefulprimarilywithinscriptfiles.
TheREMcommandallowsacommenttobedisplayedwhilethescriptfileexecutes.
TheWAITcommandestablishesadelaybetweentheexecutionofcommandsofthescriptfile.
NOTE:AscriptfilecancontaintheSCRIPTcommand.
Scriptfilescanbenestedasmanyas15levelsdeep.
IfthescriptfilehasthefilenameSTARTUP.
05,thescriptfilewillbeexecutedeachtimetheMMEVSisstarted.
Syntax:SCRIPTWhere:Thenameofthescriptfiletobeexecuted.
Anextensionof.
SCRisthedefaultandcanbeomitted.
Theextensionmustbespecifiedforfileswithotherextensions.
Apathnamefollowedbytheasterisk(*)wildcardcharactercanbeentered.
Inthatcase,thecommanddisplaysawindowthatliststhescriptfilesinthespecifieddirectorythathavethe.
SCRextension.
Afilecanbeselectedfromthelist.
Examples:>SCRIPTINIT.
SCRExecutecommandsinfileINIT.
SCR.
>SCRIPT*Displayall.
SCRfiles,thenexecutetheselectedfile.
>SCRIPTA:*Displayall.
SCRfilesindriveA,thenexecutetheselectedfile.
>SCRIPTB:*.
xyzDisplayalldriveBfilesthathavetheextension.
xyzthenexecutetheselectedfile.
Command-LineCommandsMMEVS0508OM/D112Command-LineCommandsMOTOROLASETMEMCustomizeMemoryMapSETMEMTheSETMEMcommandallowscustomizingofthememorymap.
EnteringthiscommandbringsupthecustommapwindowasshowninFigure10.
ThecurrentRAMandROMconfigurationwillbeshowninthewindow.
Tomodifythemap,enterthedesiredaddressranges.
Towritethemodifiedmaptoafileforfutureuse,pressSave(F6),thenenterthefilenameattheprompt.
Thesystemsavesthenew.
MEMfileunderthespecifiedname.
Ifafilebythespecifiednamealreadyexists,anoticeismadewiththeoptiontooverwrite.
TheemulatorcanloadthisfileusingtheLOADMEMinstructionatafuturetime.
PressingExecute(F7)willusethenewlydefinedmemorymapforthecurrentdebugsessiononly.
Figure10.
CustomMapWindowRAM1XXXXXXXXRAM2XXXXXXXXRAM3XXXXXXXXROM00020004FROM1010008FFROM21FF01FFFROM3XXXXXXXXF6:SAVEF7:EXECUTE:CANCELVector1FFECustomMapRAM0008000FFCommand-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands113TheSETMEMcommandallowsmappingoverundefinedmemoryormemorydefinedasRAMorROM.
DonotmapoversuchinternalresourcesasoptionRAM,I/O,orEEPROM.
TheSETMEMcommandautomaticallymapsaroundinternalresources.
NOTE:TheSETMEMcommandcanbeusedtoexpandthenormalRAMandROMrangestemporarilyduringdebugging.
BesuretorestoretheoriginalsizeandconfigurationoftheMCUmemorybeforefinaldebugging.
Otherwise,thecodecouldfailtofitorruninanMCU'smemoryspace.
TheSETMEMandSHOWMEMcommandsonlyshowMMEVSresources.
Thatismemorythatisresidentonthecontrolboardduringemulation.
UsetheCHIPINFOcommandmemorymapfeaturetoviewinternalI/O,optionRAM,andEEPROMlocations.
Syntax:SETMEMCommand-LineCommandsMMEVS0508OM/D114Command-LineCommandsMOTOROLASHELLAccessDOSSHELLTheSHELLcommandallowsaccesstoDOSinthehostcomputer.
ToreturntoMMEVSfromDOS,enterEXITattheDOSprompt.
MMEVScontinuestorunduringtheshelltoDOS.
Thiscouldmeanthatthememoryforothersoftwareisinsufficient.
Syntax:SHELLExample:>SHELLAccesstheDOSshell.
Toreturntotheemulatorsession,typeEXITattheDOSprompt.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands115SHOWMEMDisplayMemoryMapSHOWMEMTheSHOWMEMcommanddisplaysonlytheMMEVSresources.
Thatismemorythatisresidentonthecontrolboardduringemulation.
UsetheCHIPINFOcommandmemorymapfeaturetoviewinternalI/O,optionRAM,andEEPROMlocations.
Syntax:SHOWMEMExample:>SHOWMEMDisplaycurrentmemorymapblocks.
Command-LineCommandsMMEVS0508OM/D116Command-LineCommandsMOTOROLASNAPSHOTSaveScreenSNAPSHOTTheSNAPSHOTcommandsavesacopyofthemainscreentotheopenlogfile.
Alogfilemustbeopenorthiscommandhasnoeffect.
NOTE:ThemainscreenincludescertainextendedASCIIcharacters.
Whensubsequentlyviewingascreensnapshot,astandardASCIIeditorwilldisplayafewcharactersthatdonotmatchtheoriginalscreen.
Syntax:SNAPSHOTExample:>SNAPSHOTCapturescreen,savetoalogfile.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands117SOURCESourceWindowDisplaySOURCETheSOURCEcommandtogglesbetweensourcecodeanddisassembledcodeinthesource/codeF2window,locatedattheupperrightofthedebugscreen.
OnenteringMMEVSsoftware,thewindowdefaultstodisassembledcode,thewindowtitleisCODEF2,andwindowcontentsareadisassembledrepresentationofMCUmemory.
Inthisobjectcodedisplay,thedisassembledinstructionschangewhencorrespondingbytesofmemorychange.
Toscrollthroughthiswindow,presstheF2key(toselectthewindow),thenusethearrowkeys.
Thecontentsofthesource/codeF2windowchangetosourcecodewhentheSOURCEcommandisexecutedif:1.
Amapfilehasbeenloaded(amapfileisloadedwiththeS-recordLOADcommand)and2.
Theprogramcounter(PC)pointstoamemoryareacoveredbythemapfile.
Oncea.
MAPfilehasbeenloadedandthePCpointstoanareaofusercode,theSOURCEcommandcanbeusedtotogglebetweensourcecodeandobjectcode.
Ifamouseisinstalled,thesymbolsthatappearatthebottomofthewindowcanbeselected.
Usethemouseorarrowkeystoscrollthroughtheinformationinthewindow.
NotethattheF2keydoesnotpertaintothiswindowifitshowssourcecode.
Table5liststhekeycommandsavailableinthiswindowwhenasourcecodeisdisplayed.
NOTE:Whenmemorydatathatwasgeneratedfromasourcefileisaltered,themodifiedcodeappearsinthecodewindowbutnotthesourcefilewindow.
UsetheCLEARMAPcommandtoclearthesourcefilefromthehostsystem.
Syntax:SOURCEExample:>SOURCETogglethedisplayinthesource/codeF2window.
Command-LineCommandsMMEVS0508OM/D118Command-LineCommandsMOTOROLASTSingleStep(Trace)STTheSTcommandexecutesaspecifiedhexadecimalnumberofinstructions,beginningatthecurrentprogramcounter(PC)addressvalue.
Ifanumberisnotspecified,thiscommandexecutesoneinstruction.
TheST,STEP,andTcommandsareidentical.
Syntax:ST[]Where:Thehexadecimalnumberofinstructionstobeexecuted.
Hexadecimal$7FFisthemaximumvalue.
NOTE:Donotuseanystepcommand(ST,STEP,STEPFOR,STEPTIL,orT)ifthePCpointstointernalRAMorEEPROMorifthecodebranchesintointernalRAMorEEPROM.
Thestepcommandsarenotreal-time.
Theyexecuteoneinstructionatatime,thenreturncontroltothemonitor.
Donotrelyontimervalues.
Examples:>STExecutetheinstructionatthecurrentPCaddressvalue.
>ST2Executetwoinstructions,startingatthecurrentPCaddressvalue.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands119STACKDisplayStackSTACKThetemporarystackwindowappearsnearthecenterofthedebugscreenwhentheSTACKcommandisentered.
AsFigure11shows,thiswindowdisplaysthecontentsoftheSPregisteratthetopofthewindow.
The12bytesatthetopofthestackaredisplayedtotheleft.
Theinterpretationofthestackshowntotherightinthewindowisvalidonlyifthelastpushtothestackwascausedbyaninterrupt.
PresstheESCkeytoremovethestackwindowandreturntothedebugwindow.
Syntax:STACKExample:>STACKDisplaythecurrentconfigurationofthestack.
NOTE:Theinterruptstackdatatotherightsideofthewindowisaninterpretationofthetopfivebytesonthestack.
IfthelastpushtothestackwasduetoaBSRorJSRinstruction,fivebyteswerenotpushedtothestackandtheinterruptstackinformationisinvalid.
Figure11.
StackWindowSTACKStackPointer=00F8RawBytes:.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
00FF7D00FE0100FD4400FC0200FB1000FAFF00F9E5SP>00F807InterruptStack:.
.
.
HINZCCCR>11100101A>FFX>10ret>0244Command-LineCommandsMMEVS0508OM/D120Command-LineCommandsMOTOROLASTEPSingleStep(Trace)STEPTheSTEPcommandexecutesaspecifiedhexadecimalnumberofinstructions,beginningatthecurrentprogramcounter(PC)addressvalue.
Ifanumberisnotspecified,thiscommandexecutesoneinstruction.
TheSTEP,ST,andTcommandsareidentical.
Syntax:STEP[]Where:Thehexadecimalnumberofinstructionstobeexecuted.
Hexadecimal$7FFisthemaximumvalue.
NOTE:Donotuseanystepcommand(ST,STEP,STEPFOR,STEPTIL,orT)ifthePCpointstointernalRAMorEEPROMorifthecodebranchesintointernalRAMorEEPROM.
Thestepcommandsarenotreal-time.
Theyexecuteoneinstructionatatime,thenreturncontroltothemonitor.
Donotrelyontimervalues.
Examples:>STEPExecutetheinstructionatthecurrentPCaddressvalue.
>STEP2Executetwoinstructions,startingatthecurrentPCaddressvalue.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands121STEPFORStepForeverSTEPFORTheSTEPFORcommandbeginscontinuousinstructionexecution,beginningatthecurrentprogramcounter(PC)addressvalue.
Executionstopswhenakeyispressed.
Syntax:STEPFORNOTE:Donotuseanystepcommand(ST,STEP,STEPFOR,STEPTIL,orT)ifthePCpointstointernalRAM(forinstance,optionRAM)orEEPROMorifthecodebranchesintointernalRAMorEEPROM.
Thestepcommandsarenotreal-time.
Theyexecuteoneinstructionatatime,thenreturncontroltothemonitor.
Donotrelyontimervalues.
Example:>STEPFORExecuteinstructionscontinuouslyuntiltheuserpressesakey.
Command-LineCommandsMMEVS0508OM/D122Command-LineCommandsMOTOROLASTEPTILSingleSteptoAddressSTEPTILTheSTEPTILcommandcontinuouslyexecutesinstructionsfromthecurrentprogramcounter(PC)addressvalueuntilthePCreachesthespecifiedaddress.
Syntax:STEPTILWhere:Theaddressatwhichinstructionexecutionstops;thislocationmustbeaninstructionaddress.
NOTE:Donotuseanystepcommand(ST,STEP,STEPFOR,STEPTIL,orT)ifthePCpointstointernalRAMorEEPROMorifthecodebranchesintointernalRAMorEEPROM.
Thestepcommandsarenotreal-time.
Theyexecuteoneinstructionatatime,thenreturncontroltothemonitor.
Donotrelyontimervalues.
Example:>STEPTIL0400ExecuteinstructionscontinuouslyuntilthePCvalueis0400duringanopcodefetchcycle.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands123STOPStopProgramExecutionSTOPTheSTOPcommandstopsuserprogramexecutionandupdatesthedebugscreenswithcurrentdata.
Syntax:STOPExample:>STOPStopprogramexecutionandupdatethedebugscreen.
Command-LineCommandsMMEVS0508OM/D124Command-LineCommandsMOTOROLASYSINFOSystemInformationSYSINFOTheSYSINFOcommandcallstoDOSfortheamountofmemoryavailable,thendisplaysthisinformationinthedebugF10window.
Syntax:SYSINFOExample:>SYSINFOShowsysteminformation.
Totalmemoryavailable:187488Largestfreeblock:187488Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands125TSingleStep(Trace)TTheTcommandexecutesaspecifiedhexadecimalnumberofinstructionsbeginningatthecurrentprogramcounter(PC)addressvalue.
Ifanumberisnotspecified,thiscommandexecutesoneinstruction.
TheT,ST,andSTEPcommandsareidentical.
Syntax:T[]Where:Thehexadecimalnumberofinstructionstobeexecuted.
Hexadecimal$7FFisthemaximumvalue.
NOTE:Donotuseanystepcommand(ST,STEP,STEPFOR,STEPTIL,orT)ifthePCpointstointernalRAM(forinstance,optionRAM)orEEPROMorifthecodebranchesintointernalRAMorEEPROM.
Thestepcommandsarenotreal-time.
Theyexecuteoneinstructionatatime,thenreturncontroltothemonitor.
Donotrelyontimervalues.
Examples:>TExecutetheinstructionatthecurrentPCaddressvalue.
>T4ExecutefourinstructionsbeginningatthecurrentPCaddressvalue.
Command-LineCommandsMMEVS0508OM/D126Command-LineCommandsMOTOROLAVSet/ClearVBitVNOTE:ThiscommandisfortheMMEVS08only.
TheVcommandsetstheVbitintheconditioncoderegister(CCR)tothespecifiedvalue.
NOTE:TheCCRbitdesignatorsareatthelowerrightoftheCPUwindow.
TheCCRpatternisV11HINZC(Visoverflow,Hishalf-carry,IisIRQinterruptmask,Nisnegative,ZiszeroandCiscarry).
AletterinthesedesignatorsmeansthatthecorrespondingbitoftheCCRisset;aperiodmeansthatthecorrespondingbitisclear.
Syntax:V0|1Where:0ClearstheVbit1SetstheVbitExample:>V0ClearstheVbitintheCCR.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands127VARDisplayVariableVARTheVARcommanddisplaysthespecifiedaddressanditscontentsinthevariablesF8window.
Ifamapfilehasbeenloaded,symbolsandlabelsfromthesourcecodecanbeusedasarguments.
Asmanyas32variablescanbedeclaredinthevariablesF8window.
Thewindowshows11atatime.
UsingtheVARcommandestablishessuchavariable.
Theargumentenablesdisplayofvariablesinbyte,word,orstringformat.
Abytedisplayishexadecimalandbinary,aworddisplayishexadecimalanddecimal,andastringdisplayisASCII.
ForanASCIIstring,theoptionalargumentspecifiesthenumberofcharacters;thedefaultisthemaximum11characters.
Controlandothernon-printingcharactersappearasperiods(.
).
Syntax:VAR[.
]|[]Where:Thevariabletypetodisplay:B(byte,thedefault),W(word),orS(string)TheaddressofthememoryvariableThenumberofcharacterstobedisplayed.
Usedonlywiththestringtype.
Ifisomitted,11ASCIIcharacterswillbevisibleinthewindow,beginningattheargumentlocation.
Asymbolloadedfroma.
MAPfileExamples:>VAR100Display(inhexadecimalandbinary)thebyteataddress100>VAR.
B110Display(inhexadecimalandbinary)thebyteataddress110>VAR.
W102Display(inhexadecimalanddecimal)thewordataddress102>VAR.
S2005Displaythe5-characterASCIIstringstartingataddress200Command-LineCommandsMMEVS0508OM/D128Command-LineCommandsMOTOROLAVERDisplayVersionVERTheVERcommanddisplaystheversionofthehostsoftwareandofthecurrentpersonality(.
MEM)file.
TheabbreviatedVERisequivalenttotheVERSIONcommand.
Syntax:VERExample:>VERDisplaytheversionnumbersofthehostsoftwareandthecurrentlyloadedpersonalityfile.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands129VERSIONDisplayVersionVERSIONTheVERSIONcommanddisplaystheversionofthehostsoftwareandofthecurrentpersonality(.
MEM)file.
TheabbreviatedVERformofthiscommandalsocanbeused.
Syntax:VERSIONExample:>VERSIONDisplaytheversionnumbersofthehostsoftwareandthecurrentlyloadedpersonalityfile.
Command-LineCommandsMMEVS0508OM/D130Command-LineCommandsMOTOROLAWAITPausebetweenCommandsWAITTheWAITcommandcausesthecommandinterpretertopauseforaspecifiedhexadecimalnumberofseconds.
(Thedefaultisfive.
)Thiscommandisusefulprimarilyinscriptfiles.
Syntax:WAIT[]Where:Thehexadecimalnumberofsecondstopause.
Example:>WAITAPausethecommandinterpreterfor10seconds.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands131WAIT4RESETWaitforTargetResetWAIT4RESETTheWAIT4RESETcommandputstheemulationMCUintotheresetstateuntilthetargetsystemprovidesaresetsignal.
Forthiscommandtofunctionproperly,enablethestateoftheMMEVSwitharesetsignalfromthetargetsystem.
(SeetheexplanationoftheRESETINcommand.
)TorestoretheemulatortotheIDLEstate,entertheRESETcommand.
Syntax:WAIT4RESETExample:>WAIT4RESETWaitforreset.
Command-LineCommandsMMEVS0508OM/D132Command-LineCommandsMOTOROLAWHEREISDisplaySymbolValueWHEREISTheWHEREIScommanddisplaysasymboloraddress.
Iftheargumentisasymbol,thiscommanddisplaysthesymbol'saddress.
Iftheargumentisanaddress,thiscommanddisplaysthecorrespondingsymbol,ifoneisassigned.
Ifthesymbolisthesameasahexadecimaladdress,thecommandshowsthehexadecimaladdress,nottheaddressofthesymbol.
Syntax:WHEREIS|Where:AsymbollistedinthesymboltableAnaddressforwhichasymbolisdesiredExamples:>WHEREISSTARTDisplaythesymbolSTARTanditsvalue.
>WHEREIS0100Displaythevalue0100anditssymbol,ifany.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands133XSetXIndexRegisterXTheXcommandsetstheindexregister(X)tothespecifiedvalue.
TheXcommandisidenticaltotheXREGcommand.
Syntax:XWhere:ThenewvaluefortheXregisterExample:>X05Settheindexregistervalueto05.
Command-LineCommandsMMEVS0508OM/D134Command-LineCommandsMOTOROLAXREGSetXIndexRegisterXREGTheXREGcommandsetstheindexregister(X)tothespecifiedvalue.
TheXREGcommandisidenticaltotheXcommand.
Syntax:XREGWhere:ThenewvaluefortheXregisterExample:>XREGF0SettheindexregistervaluetoF0.
Command-LineCommandsMMEVS0508OM/DMOTOROLACommand-LineCommands135ZSet/ClearZBitZTheZcommandsetstheZbitintheconditioncoderegister(CCR)tothespecifiedvalue.
NOTE:TheCCRbitdesignatorsareatthelowerrightoftheCPUwindow.
TheCCRpatternisV11HINZC(Vistwo'scomplementoverflowforM68HC08MCUonlyandis1forM68HC05MCU,Hishalf-carry,IisIRQinterruptmask,Nisnegative,Ziszero,Visoverflow,andCiscarry).
AletterinthesedesignatorsmeansthatthecorrespondingbitoftheCCRisset;aperiodmeansthatthecorrespondingbitisclear.
Syntax:Z0|1Where:0ClearstheZbit1SetstheZbitExample:>Z0ClearstheZbitintheCCR.
Command-LineCommandsMMEVS0508OM/D136Command-LineCommandsMOTOROLAZOOMResizeSourceWindowZOOMTheZOOMcommandtogglesthesizeofthesourcewindowbetweennormalandenlarged.
Syntax:ZOOMExample:>ZOOMResizethesourcewindow.
MMEVS0508OM/DMOTOROLAS-RecordInformation137S-RecordInformationContentsIntroduction137S-RecordContent138S-RecordTypes139S-RecordCreation140S-RecordExample140IntroductionTheMotorolaS-recordformatwasdevisedforthepurposeofencodingprogramsordatafilesinaprintableformatfortransportationbetweencomputersystems.
ThistransportationprocesscanthereforebemonitoredandtheS-recordscanbeeasilyedited.
S-RecordInformationS-RecordContentMMEVS0508OM/D138S-RecordInformationMOTOROLAS-RecordContentWhenobserved,S-recordsareessentiallycharacterstringsmadeofseveralfieldswhichidentifytherecordtype,recordlength,memoryaddress,code/data,andchecksum.
Eachbyteofbinarydataisencodedasatwo-characterhexadecimalnumber:thefirstcharacterrepresentingthehigh-orderfourbitsandthesecondthelow-orderfourbitsofthebyte.
FivefieldwhichcompriseanS-recordareshownbelow:wherethefieldsarecomposedasshowninTableA-2.
EachrecordmaybeterminatedwithaCR/LF/NULL.
Additionally,anS-recordmayhaveaninitialfieldtoaccommodateotherdatasuchaslinenumbersgeneratedbysometime-sharingsystem.
Accuracyoftransmissionisensuredbytherecordlength(bytecount)andchecksumfields.
TYPERECORDLENGTHADDRESSCODE/DATACHECKSUMTableA-2.
S-RecordFieldDescriptionFieldPrintableCharactersContentsType2S-recordtype—S0,S1,etc.
RecordLength2Characterpaircountintherecord,excludingthetypeandrecordlength.
Address4,6,or82-,3-,or4-byteaddressatwhichthedataeldistobeloadedintomemory.
Code/Data0–2nFrom0tonbytesofexecutablecode,memoryloadabledata,ordescriptiveinformation.
Forcompatibilitywithteletypewriter,someprogramsmaylimitthenumberofbytestoasfewas28(56printablecharactersintheS-record).
Checksum2Leastsignicantbyteoftheone'scomplementofthesumofthevaluesrepresentedbythepairsofcharactersmakinguptherecordlength,address,andthecode/dataelds.
S-RecordInformationS-RecordTypesMMEVS0508OM/DMOTOROLAS-RecordInformation139S-RecordTypesEighttypesofS-recordshavebeendefinedtoaccommodatetheseveralneedsoftheencoding,transportation,anddecodingfunctions.
ThevariousMotorolaupload,download,andotherrecordtransportationcontrolprograms,aswellascrossassemblers,linkers,andotherfile-creatingordebuggingprograms,utilizeonlythoseS-recordswhichservethepurposeoftheprogram.
ForspecificinformationonwhichS-recordsaresupportedbyaparticularprogram,theusermanualforthatprogrammustbeconsulted.
NOTE:TheMMEVSsupportsonlytheS0,S1,andS9recordtypes.
AlldatabeforethefirstS1recordisignored.
Thereafter,allrecordsmustbeS1typeuntiltheS9record,whichterminatesdatatransfer.
AnS-recordformatmaycontainthefollowingrecordtypes:Onlyoneterminationrecordisusedforeachblockofs-records.
Normally,onlyoneheaderrecordisused,althoughitispossibleformultipleheaderrecordstooccur.
S0HeaderrecordforeachblockofS-records.
Thecode/dataeldmaycontainanydescriptiveinformationidentifyingthefollowingblockofS-records.
Theaddresseldisnormallyzeroes.
S1Code/datarecordandthetwo-byteaddressatwhichthecode/dataistoreside.
S2–S8NotapplicabletoMMEVS.
S9TerminationrecordforablockofS1records.
Addresseldmayoptionallycontainthetwo-byteaddressoftheinstructiontowhichcontrolistobepassed.
Ifnotspecied,therstinterplantspecicationencounteredintheinputwillbeused.
Thereisnocode/dataeld.
S-RecordInformationS-RecordCreationMMEVS0508OM/D140S-RecordInformationMOTOROLAS-RecordCreationS-recordformatprogramsmaybeproducedbydumputilities,debuggers,crossassemblers,orcrosslinkers.
SeveralprogramsareavailablefordownloadingafileinS-recordformatfromahostsystemtoan8-bitor16-bitmicroprocessor-basedsystem.
S-RecordExampleShownhereisatypicalS-recordformat,asprintedordisplayed:S00600004844521BS1130000285F245F2212226A000424290008237C2AS11300100002000800082529001853812341001813S113002041E900084#42234300182342000824A952S107003000144ED492S9030000FCTheaboveformatconsistsofanS0headerrecord,fourS1code/datarecords,andanS9terminationrecord.
TheS0headerrecordisdescribedinTableA-3.
TableA-3.
S0RecordDescriptionFieldS-RecordEntryDescriptionTypeS0S-recordtypeS0,indicatingaheaderrecord.
RecordLength06Hexadecimal06(decimal6),indicatingsixcharacterpairs(orASCIIbytes)follow.
Address0000Four-charactertwo-byteaddresseld,zeroes.
Code/Data484452DescriptiveinformationidentiesthefollowingS1records:ASCIIH,D,andR—"HDR"Checksum18ChecksumofS0record.
S-RecordInformationMMEVS0508OM/DMOTOROLAS-RecordInformation141ThefirstS1recordisexplainedinTableA-4.
The16characterpairsshowninthecode/datafieldofTableA-4aretheASCIIbytesoftheactualprogram.
ThesecondandthirdS1code/datarecordseachalsocontain$13(19)characterpairsandareendedwithchecksum13and52,respectively.
ThefourthS1code/datarecordcontains07characterpairsandhasachecksumof92.
TableA-4.
S1RecordDescriptionFieldS-RecordEntryDescriptionTypeS1S-recordtypeS1,indicatingacode/datarecordtobeloaded/veriedatatwo-byteaddress.
RecordLength13Hexadecimal13(decimal19),indicating19characterpairs,representing19bytesofbinarydata,follow.
Address0000Four-charactertwo-byteaddresseld;hexadecimaladdress0000,indicateslocationwherethefollowingdataistobeloaded.
Code/DataOpcodeInstruction285F245F2212226A000424290008237BHCC$0161BCC$0163BHI$0118BHI$0172BRSET0,$04,$012FBHCS$010DBRSET4,$23,$018CChecksum2AChecksumoftherstS1record.
S-RecordInformationS-RecordExampleMMEVS0508OM/D142S-RecordInformationMOTOROLATheS9terminationrecordisexplainedinTableA-5.
EachprintableASCIIcharacterinanS-recordisencodedinbinary.
TableA-6givesanexampleofencodingfortheS1record.
ThebinarydataistransmittedduringadownloadofanS-recordfromahostsystemtoa8-or16-bitmicroprocessor-basedsystem.
TableA-5.
S9RecordDescriptionFieldS-RecordEntryDescriptionTypeS9S-recordtypeS9,indicatingaterminationrecord.
RecordLength03Hexadecimal03,indicatingthreecharacterpairs(threebytes)follow.
Address0000Four-charactertwo-byteaddresseld,zeroes.
Code/DataThereisnocode/datainaS9record.
ChecksumFCChecksumofS9record.
TableA-6.
ExampleofS-RecordEncodingTYPELENGTHADDRESSCODE/DATACHECKSUMS1130000285F.
.
.
2A533131333030303032383546.
.
.
3241010100110011000100110001001100110011000000110000001100000011000000110010001110000011010101000110.
.
.
0011001001000001MMEVS0508OM/DMOTOROLAIndex143IndexAA68ACC69Arguments,Command-LineCommands65ASM70BBAUD47,71BaudRate47BAUDCHK.
47,72BELL73BF74BR75CC76Cables,ConnectingHostComputer18Power18Target18CCR77ChangingScreenColors44CHIPINFO78CLEARMAP79COLORS80Colors,ChangingScreen44,56,80CommandLinesA.
68ACC69ASM50,70BAUD.
40,47,71BAUDCHK47,72BELL53,73BF51,74BR43,58,75C76CCR77CHIPINFO54,78CLEARMAP79COLORS44,56,80Commands64,137DASM50,81EVAL53,82EXIT56,82,83G59,84GO43,59,85GOTIL43,59,86H87HELP54,88HREG89HX90I91INFO43,53,92LF55,93LOAD94LOADMAP95LOADMEM48,96MD57,97MM51,98N100NOBR58,101OSC49,102PC103QUIT56,104REG.
105REM53,106RESET58,107RESETGO58,59,108RESETIN58,109RESETOUT58,110IndexMMEVS0508OM/D144IndexMOTOROLASCRIPT52,111SETMEM39,48,112SHELL56,114SHOWMEM54,115SNAPSHOT55,116SOURCE34,55,117ST59,118STACK.
38,119STEP43,59,120STEPFOR59,121STEPTIL59,122STOP43,123Summary(Table)67Syntax64SYSINFO54,124T.
59,125V.
126VAR35,57VER54,128VERSION.
54,129WAIT52,130WAIT4RESET58,131WHEREIS54,132X.
133XREG.
134Z.
135ZOOM43,56,136CommandTypesDebug57Initialization46System.
52Connector,CablePinAssignments20SignalDescriptions20CPURegistersSetting57DDASM81EEMInstalling17Removing17EVAL.
53,82EXIT83GG84GO85GOTIL86HH87HardwareInstallationConfiguringthePlatformBoard15ConnectingCables18InstallingtheEM17Introduction14PinAssignments,Connector20RemovingtheEM17ResetSwitch19SignalDescriptions,Connector20HELP.
88HostComputerRequirements11HREG89HX.
90II.
91INFO92InitializationandLoading21ClockSpeed21Memory50InitializationCommands46Introduction7IndexMMEVS0508OM/DMOTOROLAIndex145JJumperHeadersFactoryTest(J1)15PortVoltageControl(J2–J4)16KKeyCommandsDebugScreenWindows31MainWindows28Pop-UpWindows37Source/CodeF2Window.
34LLF93LOAD.
94LoadingandInitialization21LOADMAP95MManualOrganization.
8MD.
97MemoryMapping47,48MM98MMEVS05DebugScreen28,29Introduction7Running24MMEVS08DebugScreen28,30HREG.
89HX90Introduction7Running25V.
126MouseOperation.
42NN.
100NOBR.
101OOSC102PPC103PinAssignments,Connector20PlatformBoard,Configuration15PortVoltageControlJumperHeaders(J2–J4)16QQUIT.
104RREG105REM106RESET107RESETGO108RESETIN109RESETOUT110SScreensBaudWindow40CPUWindow.
33DebugF10Window36EmulatorClockFrequencyWindow41EmulatorClockFrequencyWindowMMEVS0541,102EmulatorClockFrequencyWindowMMEVS0841,102Introduction28MemoryF3Window35IndexMMEVS0508OM/D146IndexMOTOROLAMMEVS05DebugScreen29MMEVS08DebugScreen30SetMemoryWindow39Source/CodeF2Window.
33StackWindow38StatusArea32User27VariablesF8Window.
35SCRIPT111ScriptFilesSTARTUP.
0546,52STARTUP.
0846,52SETMEM.
112SHELL.
114SHOWMEM.
115SNAPSHOT.
116SoftwareDistributionFormat.
22Installation22PersonalityFiles.
23Target,Loading49Using23SOURCE.
117ST118STACK53,119STARTUP.
05(ScriptFile)46,52STARTUP.
08(ScriptFile)46,52STEP.
118,120STEPFOR121STEPTIL122STOP123SYSINFO124SystemCommands52Components10Connections.
18TT125VV126VAR.
127VER.
128VERSION129WWAIT.
130WAIT4RESET.
131WHEREIS132WindowsOperation.
23XX133XREG89,90,134ZZ135ZOOM43,136MOTOROLACSICMICROCONTROLLERSMotorolareservestherighttomakechangeswithoutfurthernoticetoanyproductsherein.
Motorolamakesnowarranty,representationorguaranteeregardingthesuitabilityofitsproductsforanyparticularpurpose,nordoesMotorolaassumeanyliabilityarisingoutoftheapplicationoruseofanyproductorcircuit,andspecicallydisclaimsanyandallliability,includingwithoutlimitationconsequentialorincidentaldamages.
"Typical"parameterscananddovaryindifferentapplications.
Alloperatingparameters,including"Typicals"mustbevalidatedforeachcustomerapplicationbycustomer'stechnicalexperts.
Motoroladoesnotconveyanylicenseunderitspatentrightsnortherightsofothers.
Motorolaproductsarenotdesigned,intended,orauthorizedforuseascomponentsinsystemsintendedforsurgicalimplantintothebody,orotherapplicationsintendedtosupportorsustainlife,orforanyotherapplicationinwhichthefailureoftheMotorolaproductcouldcreateasituationwherepersonalinjuryordeathmayoccur.
ShouldBuyerpurchaseoruseMotorolaproductsforanysuchunintendedorunauthorizedapplication,BuyershallindemnifyandholdMotorolaanditsofcers,employees,subsidiaries,afliates,anddistributorsharmlessagainstallclaims,costs,damages,andexpenses,andreasonableattorneyfeesarisingoutof,directlyorindirectly,anyclaimofpersonalinjuryordeathassociatedwithsuchunintendedorunauthorizeduse,evenifsuchclaimallegesthatMotorolawasnegligentregardingthedesignormanufactureofthepart.
MotorolaandareregisteredtrademarksofMotorola,Inc.
Motorola,Inc.
isanEqualOpportunity/AfrmativeActionEmployer.
Howtoreachus:MFAX:RMFAX0@email.
sps.
mot.
com–TOUCHTONE(602)244-6609INTERNET:http://Design-NET.
comUSA/EUROPE:MotorolaLiteratureDistribution;P.
O.
Box20912;Phoenix,Arizona85036.
1-800-441-2447JAPAN:NipponMotorolaLtd.
;Tatsumi-SPD-JLDC,ToshikatsuOtsuki,6FSeibu-Butsuryu-Center,3-14-2TatsumiKoto-Ku,Tokyo135,Japan.
03-3521-8315HONGKONG:MotorolaSemiconductorsH.
K.
Ltd.
;8BTaiPingIndustrialPark,51TingKokRoad,TaiPo,N.
T.
,HongKong.
852-26629298MMEVS0508OM/D