Motorola USB08 Instructions d'exploitation

Xplor8 - Version 1Manual

102 MISCELLANEOUS2.1 InstallingDouble click on the self-installing exe file, named something like ‘Install-Xplor8-xyz.exe’ which youhave downloaded fr

100APPENDIX J - Xplor8 REVISION HISTORY & KNOWN BUGSRevision HistoryKnown Bugs: Does not display correctly on operating systems, such as Micros

112.5 Supporting FilesTo be fully operational, Xplor8 needs access to various supporting files of information. These are:1. A configuration file for e

12talker to transmit the required bytes of MCU memory to Xplor8 where they will be stored in thecorresponding address locations in the local memory ar

133 MON08 MONITOR FIRMWARE3.1 IntroductionThe HC908 series of micro controllers come with a small monitor program (MON08) alreadyprogrammed into ROM.

143.2 Utility FilesThe on-chip monitor program has only basic commands which have to be used as the building blocksfor more complex functions. In part

15This viewer may be launched either from the View Menu menu or from Settings>Security Bytes (page38).The default log is limited to 100 records, an

164 MEMORY MANAGEMENT4.1 Writing to RAMThe monitor ROM routines on the MCU are able to write directly to RAM, including the I/O registers.4.2 Writing

175 DEBUGGING5.1 BreakpointsTracing, and running programs to breakpoints, requires that breakpoints can be established at the rightplaces in the MCU p

186 PROGRAM FEATURES6.1 Screen Layout

196.2 Main MenuThe main menu provides access the various facilities in Xplor8. For more details see the individualmenu descriptions later in this chap

2This page intentionally left blank

20The division between the output and command history windows is a moveable splitter bar, allowingone window to be enlarged or reduced at the expense

212. The command is copied to the command history list and to the output window, where itappears in green type.3. If the command is correctly formatte

226.8.2 T/G, L/U and BR addresses• T/G The T/G address show where Tracing and Running will next begin in the absence ofa specific address• L/U The L/U

23Add... Click to open the Add to Watch dialog for adding an address to watch (see below).Delete Deletes an item selected in the Watch display.Clear A

24Save Project... Saves the current configuration to a project file. If the file exists, it will besilently updated, if not, a file save dialog will a

256.12 Actions MenuMenu to simplify the issuing of commands that involve the loading and saving of files to and from theMCU. Such commands all need a

26Load S19 to Local... As though the 'LDL' command had been issued - see the Load MemorycommandSave Local to S19... As though the 'SVL&

27Contents Opens Help Topics at the Contents tab. Shortcut is Shift+F1.Getting Started Opens Help at ‘Getting Started’ - see Appendix G.Error Report.

28Ctrl+C Copy to ClipboardCtrl+V Paste from ClipboardCtrl+X Cut to ClipboardCtrl+Y Delete the line containing the insertion point (caret).Keyboard Sho

296.19 Security Bytes Log ViewerThis window displays a log of security bytes. It may be used to view the default log, or one of thecopies saved by the

3CONTENTS1 INTRODUCTION ... 71.1 The Program ... 71.2

30Xplor8 after the write operation and are not simply the bytes which the user sent to programmemory.New The user has successfully attempted an Unlock

317 CONFIGURATION7.1 Settings DialogThe six tabs of the Settings Dialog contain various editable fields for the customization of Xplor8. Allthe config

32E Clock FrequencySelect the E clock frequency at which the MCU is working. See the HC908 data sheet for the chip thatyou are using. Those chips with

337.3 Settings>COM PortTab for configuring the RS232 port which will be used to communicate with the target board. Notethe caveats in USB-to-Serial

34PC controls resetTick this box if the host PC is able to control the reset cycle on the target board.Using DTR/RTSSelect whichever signal is used fo

357.4 Settings>MacrosTab for editing the boot script and for settings affecting macro library files.Run this script on bootTick this check box and

36Command line format errorTick this box to cause a playing macro to stop if a command within the macro is format ted incorrectly,causing an error mes

37Such spaces can improve the readability of disassembled code by highlighting the places wheresequential code execution is not possible.Run/Trace Dis

387.6 Settings>Security BytesTab for working with the security bytes needed to unlock FLASH memory. See Security Bytes(page 14) for a full explanat

39View Saved Copy Log...Click for a file-open dialog to select a previously-saved copy of the security byte log. The selected fileis then displayed in

46.4 Output Window ... 196.5 Command History Window ... 206.6 Command E

408 COMMANDS8.1 General informationCommands to Xplor8 to carry out monitoring, debugging and loading operations are typed in to theCommand Edit Box at

41• Some commands can be limited to affecting only the local, Xplor8, copy of the MCU memoryspace (see local memory on page 11). All the sample L(List

42The tokenized forms are also used within project files to store file information. This simplifies thebackup and transfer of projects to another comp

438.4 Clear Local Memory CLMFormat:CLMThis command only clears the local memory held within Xplor8. It does not affect the CPU or itsmemory at all.8.5

448.7 Edit Flash Byte EFBFormat:EFB Address NewByteCommand to change a single byte of FLASH memory. 'Address' is an address in FLASH memor

458.8 Fill Memory FFormat:F StartAddress EndAddress|+Length ByteString|CharacterStringorFL StartAddress EndAddress|+Length ByteString|Character

468.9 Find Bytes FINDFormat:FIND StartAddress EndAddress|+Length ByteString|CharacterStringorFINDL StartAddress EndAddress|+Length ByteString|Chara

478.10 Find Next NEXTFormat:NEXTTo find the next occurrence of a string of bytes previously specified with a FIND command. Thiscommand actually search

488.11 Go (Run) GFormat:G [StartAddress|* [Breakpoint] ]Command to run a program on the MCU. If StartAddress is not specified, or an asterisk is use

498.12 List Macros LMFormat:LMCommand to list the names of the macros in the currently loaded macro library file. See Macros onpage 68 for more inform

58.20 Register Display and Change ... 558.21 Reset ... 568.22 S

508.13 List Memory LFormat:L [StartAddress|* [EndAddress|+Length]]orLL [StartAddress|* [EndAddress|+Length]]Command to list memory. If no end add

518.14 Load Memory LDFormat:LD Path&Filename.rec|.s19LDL Path&Filename.rec|.s19orLD Path&Filename.obj|bin StartAddressLDL Path&

528.15 Mass Erase MEFormat:ME [Address]Command to mass erase all of FLASH memory. 'Address' is optional; if it is not included, or has any

538.17 Modify Memory M, MMFormat:M StartAddressorMM StartAddressCommand to modify random access memory byte by byte. An explicit start address mu

54leads to: 8010 30.This co mmand cannot write t o FLASH memory.8.18 Page Erase PEFormat:PE StartAddress [EndAddr|+Length]Command to erase one or m

558.20 Register Display and Change RFormat:R I/OReg|CtrlRegorR I/OReg|CtrlReg=NewValueCommand to display and modify the MCU Input/Output registers

568.21 Reset RESETFormatRESETThis command, which is only available when 'PC controls reset' is checked on the Settings>COM Porttab, and t

578.22 Save Memory SVFormat:SV StartAddress EndAddress|+Length Path&Filename.rec|.s19SVL StartAddress EndAddress|+Length Path&Filename.r

588.23 Send Bytes SENDFormat:Send BaudRate InterCharDelay ByteStringBaudRate to suit the on-chip program. This baud rate applies only to the Sen

598.24 Launch Terminal Window TERMFormat:TERMThis command opens the Terminal Window (see page 74). It is included so that a macro can put theuser in d

6APPENDIX F - RS232 COMMUNICATIONS ... 89APPENDIX G - GETTING STARTED and QUICK TOUR ...

608.25 Trace TFormat:T[Repeats] [StartAddress|*]Command to trace a program in MCU controlled memory. If no explicit start address is specified, thent

618.26 Step Over OFormat:O[Repeats] [StartAddress|*]Command to step over a program in MCU controlled memory, that is to jump over subroutine calls.If

628.27 Unassemble UFormats:U[Repeats] [StartAddress|*]orUL[Repeats] [StartAddress|*]orU [StartAddress|*] [EndAddress|+Length]orUL [StartAddress|*]

63The readability of disassembly listings may be enhanced by checking 'UnAsm: add spaces at codebreaks' on the Settings>Debug tab. This w

64One or two factors have to be borne in mind when using a symbol table:• Labels are partially case-sensitive. When looking-up the symbol table, Xplor

658.29 Unlock UNLOCKFormat:UNLOCK [SecurityBytes]Use the unlock command to send the eight security bytes to unlock FLASH memory. 'SecurityBytes

668.30 Verify VFormat:V Path&Filename.rec|.s19orVL Path&Filename.rec|.s19Command to verify memory by comparing it with an S19 format file.

678.31 Verify Erase VEFormat:VE StartAddress [EndAddress|+Length]Command to verify that MCU memory is erased (bytes = $FF). If no arguments are supp

689 AUTOMATION9.1 IntroductionIt is possible to automate the action of Xplor8 in four ways:1. Three commonly-used commands can be issued automatically

69 Definition of a macro begins with the word 'DEFM' (Define Macro) followed by the name of themacro. The name may in turn be followed by up

71 INTRODUCTION1.1 The ProgramXplor8 is a simple loader/de-bugger/monitor interface for the Freescale (Motorola) HC908 microcontroller units. I develo

70then FF will be written to FLBPR immediately after unlocking - see Register Display and Change(page 55) for more details of the 'R' comman

71BEGINMACRO3 "[Xplor8]\Samples\Looptest.S19"END Playing MACRO4 in the above example thus:Macro4 is equivalent to:LD "[Xplor8]\Samples\

72or the speedbuttons. Recorded command lines are appended to the end of whatever library script isopen in the macro editor.9.6.3 Stopping Playing or

73Delete Line Delete the line containing the insertion point. Shortcut: Ctrl+YMake into Macro If a line or lines have been selected in the editor, th

7410 TERMINAL WINDOW10.1 IntroductionXplor8 has an integrated terminal window which allows the user to send and receive bytes with aconnected MCU, pro

7510.3 Interaction with the Monitoring/Debugging FunctionsIt is basically only possible to use either the main Xplor8 monitor program or the terminal

76Word Wrap Check t o wrap text in the display.SettingsTerminal Settings... Click to open the Terminal Window Settings dialog.HelpIndex Opens Help Top

77Delay (in milliseconds) between characters when sending a fileEnter a time in milliseconds which will be inserted between the sending of each charac

7811 ERRORS11.1 Communication and Echo ErrorsWhen Xplor8 sends a byte to the monitor firmware it usually expects to receive an echoed byte. Bycomparin

7911.2 DiagnosticsWhen an error dialog is displayed, diagnostic information is added to the Output Window.In the following example, I added the line 7

81.4 Xplor8 Source CodeXplor8 is written in Object Pascal as implemented by Borland, in my case in Delphi versions 4 and 7.Two additional components a

80APPENDIX A - ACKNOWLEDGMENTSMotorola/FreescaleFor their flexible design of the HC908 micro controllers and for their good documentationBorlandFor

81APPENDIX B - HARDWAREThis diagram shows the basic set-up needed for Xplor8 to communicate with the MCU, to allowXplor8 to reset the MCU remotely,

823. Relay RL1 performs the power-on reset. A relay is likely to be particularly inappropriate herebecause of contact bounce.4. Relay RL2 provides the

83APPENDIX C - COMMAND SUMMARYCLMClear the local, Xplor8, copy of memoryCLSClear output windowCONNECT / DISCONNECTOpen or close the COM portCRC

84R IOReg|CtrlReg [=NewValue]Display and modify registersRESETRemotely reset the target MCUSV StartAddr EndAddr|+Length Path&Filename.E

85APPENDIX D - SETUP FOR DIFFERENT MCU’sUsing Xplor8 with different members of the HC908 family.Utility FilesThese are in S19 format and vary with M

86APPENDIX E - COMMAND-LINE ERROR MESSAGE SUMMARYCommand Line ErrorsThere are numerous ways in which what is typed on the command line may not b

87Address(es) overlap FLASH Command arguments, or the loadingaddresses in an S19 file, overlap FLASH.Some commands cannot write to FLASHAddress(es) o

88BEGIN not found The 'BEGIN' directive was not found in amacro invoked from the command lineNo library macros foundFile not foundUnrecogniz

89APPENDIX F - RS232 COMMUNICATIONSIntroductionThe RS232 standard, now more correctly the EIA232 standard, first appeared in the 1960's. It w

91.7 Getting StartedFor those simply wishing to get started as soon as possible, I’ve put the basic installation and operatinginstructions in Appendix

90The pins are labeled with a functional description as follows. 'IN' and 'OUT' refer to the signaldirections as they apply to the

91Logic LevelsIt is this aspect which causes the most bewilderment among users, largely because of the counter-intuitive naming conventions used. The

92Break SignalThe RS232 standard also specifies a signal called a Break, which is the sending of continuous Space(logic 0) values (no Start or Stop bi

93APPENDIX G - GETTING STARTED and QUICK TOURInstallationDouble click on the self-installing exe file, named something like ‘Install-Xplor8-xyz

94• Move to the ‘Security Bytes’ tab. Enter the sequence of bytes needed to unlock FLASHmemory on the MCU. If you are using a brand new chip these wil

95QUICK TOURA quick introduction to the capabilities of Xplor8.The tour assumes that you are able to unlock FLASH memory on the MCU you are using - e

96LD "[Xplor8]\Samples\LOOPTEST.S19"Writing FB00..FB23Loading complete4. Unassembling MemoryConfirm that you have loaded the 'Looptest

978. Tracing a ProgramType:T FB00 <enter>Depending on the selections in Settings>Debug, the output window will display information on theinst

98APPENDIX H - DISTRIBUTION FILESThe installation file Install-Xplor8-xyz.exe sets up the following files, in the sub-directories listedbelow. Not

99GP32_UT3.ASMJB8_UT1.ASMJKL_UT1.ASMJKL_UT2.ASMQTY_UT1.ASMQTY_UT2.ASMSub-folder ..\Projects\ Default location for project files.Sub-folder ..\Register