Û¥-'@-€GÑŸýÔÏê$ê$$ê$ê$ê$ê$ê2êNë:ˆûˆûˆûˆûžû:ˆûØû(üüüüüüüüüüüü!üÀáüáü6ý4jý5ÿü7$êÿüÿüil *MENU PCbug11's command line can be edited using a number of keys on the host computer. In addition there is a recall buffer which holds the last 16 commands entered. The following keys provide the edit and recall features: left arrow - move cursor back 1 character right arrow - move cursor forward 1 character Home - move cursor to first character End - move cursor to last character delete left - delete to left of cursor Del - delete at cursor position CTRL End - delete from cursor position to end of line Ins - insert at cursor positiion (cursor changes to blocke cursor) up arrow - recall last entered command down arrow - recall last command in recall buffer Esc - Clear command line In addition, the Esc key can be used to terminate most commands in progress. e.g. MD, DASM, ASM. The 4 lines above the command line provide a trace of the last 4 commands executed. The next line above this displays break point and last error messages. An error code is returned to MS-DOS, with one of the following meanings: Error Code Meaning ---------- ------- 0 No error 1 VERF error 2 MS or BF error 3 Talker communication failure. In MS-DOS Batch files the error code can be checked with ERRORLEVEL. Monitor Commands The following is a list of all commands available from PCbug11, with a short description of their function. A more detailed description follows. PCbug11 Command Summary ASM addr [mne|dir] - Call symbolic macro line assembler, with option to auto insert mnemonic or directive BAUD [rate] - Display/Set serial baud rate BF addr1 [addr2] byte|word - Block fill memory with byte or word BL - Display breakpoints BR [addr [macroname]] - Display/Set break point [with optional Command Macro execution] CALL addr - Execute the subroutine at addr CLRM - Clear all Command Macros CLS - Clear main window CONTROL [parameter] - Display/Change PCbug11 system parameters DASM addr1 [addr2] - Disassemble from addr1 [to addr2] DB startaddr [endaddr] - Display MCU Memory DEBUG - Reserved word DEFINE symbol value|address - Define a symbol DEFM macrnam|TRACE|AUTOSTART - Define Command,Trace or Autostart Macro DELM macrnam|TRACE|AUTOSTART - Delete Command,Trace or Autostart Macro DIR [mask] - Display Disk Directory DOS [command] - Shell to DOS/Execute DOS command EDITM macrnam - Edit a macro EEPROM [startaddr [endaddr]] - Display/Clear/Set EEPROM Address Range(s) EEPROM DELAY option - Set EEPROM erase/write programming time EEPROM ERASE [option] - Display/Change EEPROM Erase-before-Write EPROM [startaddr [endaddr]] - Display/Clear/Set EPROM Address Range(s) EPROM DELAY option - Set EPROM erase/write programming time FIND byte|word addr1 addr2 - Find all occurrences of byte or word between addr1 & addr2 FIND mnemonic addr1 addr2 - Find all occurrences of mnemonic between addr1 & addr2 G [addr] - Start User Code Execution HELP - Display Help Information KLE - Kill last error message LOADM [filename] [macroname] - Load Macro Definitions from Default/User File LOADS filename [loadaddr] - Load S Record File into MCU Memory LS symbol - Display symbols LSTM [mname|TRACE|AUTOSTART] - Display Macro Names/Definitions MD startaddr [endaddr] - Display MCU Memory MM addr - Modify memory from addr MOVE addr1 addr2 addr3 - Move MCU Memory between addr1 & addr2 to addr3 MS addr byte|word [byte|word] - Set MCU Memory Byte(s) or Word(s) MSG [string] - Display Message in Main Window NOBR [address] - Remove all/specified Break Points PAUSE [ms] - Wait for any Key Press/Delay Time PRINT - Display PCbug11 version number PROTECT [startaddr [endaddr]] - Display/Clear/Set Write Protected Address Range(s) QUIT [Y] - Terminate PCbug11 session [without confirming] RD [T] - Display/Trace MCU Registers RESET [addr] - MCU Hardware Reset with Existing/New Reset Vector. RESTART [option] - Restart PCbug11 with Same/New Option. RM - Modify MCU Registers in window RS register value - Set value of MCU register S - Stop User Code Execution SHELL ["command" ;P] - Shell to DOS/ Execute DOS command SAVEM [filename] - Save Macro Definitions in Default/User File T [addr] - Trace User Code TERM [X1 Y1 X2 Y2] - Simple windowed terminal emulator TYPE filename - Display Disk file in Main Window UNDEF symbol - Undefine a symbol VER - Display version number VERF ERASE addr1 [addr2] - Verify that memory contains $FF VERF SET addr1 addr2 value - Verify that memory contains value VERF filename [memaddr] - Verify S record disk file against memory WAIT [ms] - Wait for ms Special Key operations: CTRL B - Send Break on COM channel CTRL P - Toggle MCU Memory Write Protect/RTS line CTRL R - Attempt to re-synchronise talker EVM Compatible commands These commands operate in a similar manner to the command of the same name on the Motorola 68HC11 EVM systems. ASM, BF, BR, G, HELP, MD, MM, NOBR, RD, RM CDS8 Compatible commands These commands operate in a similar manner to the command of the same name on the Motorola CDS8 system. ASM, BAUD, DB, DEFINE, G, HELP, LS, RD, RS, SHELL, T, UNDEF, VER, WAIT *ASM addr [mne|dir] - Call symbolic macro line assembler, with option to auto insert mnemonic/directive Provides single line assembly/disassembly in main window. The assembler is a single pass version of ASMHC11 2.6 and thus supports the same mnemonics and directives. Symbols can be defined within ASM using the standard Motorola syntax. Alternatively, symbols from an (equate) file may be loaded using the INCL operand. Note that mnemonics must be preceded by at least one space following the '>' prompt, otherwise they are treated as labels The same text editing features are available as on the command line. The following keys provide additional features: up arrow decrement prog counter by one. down arrow increment prog counter by one. enter move prog counter to next instruction boundary. Esc Exit ASM and return to command line. In PCbug11 there is the ability to optionally specify on the command line, a mnemonic or directive. If this is done, the ASM command automatically inserts the mnemonic or directive, and immediately returns to the command line. This allows mnemonic insertion or ASM directives to be executed from within a macro, without any input from the user. Usage: ASM $100 Assemble from memory address $100 ASM $100 INCA Insert INCA instruction at memory address $100 ASM Error messages These are reported in the form of numbers the key to which is shown below Error no. Meaning 1 Memory fault : Memory did not modify as expected 200 Syntax : Illegal character in that context 202 Syntax : Syntax error 204 Syntax : Label required (for EQU or SET) 212 Operand : Improper termination of operand field 213 Operand : Illegal addressing mode for operand 214 Address : Illegal forward reference 223 Address : Invalid addressing mode for 68HC11 234 Symbol : Redefined symbol 235 Symbol : Undefined symbol 238 Symbol : Undefined operation 320 Symbol : Error table overflow 321 Symbol : Symbol table overflow 250 Data : Displacement too large (normally branch) 251 Data : Value out of range 252 Data : Address too large for forced direct 255 Data : Division by zero 501 File : File not found *BAUD [rate] - Display/Set serial baud rate Allows user to change the PC's serial baud rate. This command accesses the PC's hardware directly, to allow a wider range of baud rates than can be selected by the MODE command. After execution, the actual baud rate is displayed. This may be different to the requested baud rate. Values in excess of 9600 are available - with a maximum of 38400 baud. Note 1: To maintain Talker contact, the MCU's baud rate must first be set up to the new value. This can either be done by changing the appropriate talker code, or executing an MS command to dynamically change the MCU's baud rate register. Note 2: The default baud rate for bootstrap download is approxim...
gasma