Miscellaneous Commands


QUIT: Exit NoICE

    QUIT

Exits NoICE.

"Q" is an abbreviation of "QUIT".


OPEN file

    OPEN file.ext

This command is used to "open" a file. The meaning of "open" is determined by the extension of the file. The extension is compared to the extension specified for the various file dialogs in this order:

  1. LOAD
  2. PLAY
  3. VIEW

If a match is found, then the appropriate command is issued to deal with the file. If no match is found, the file is VIEWed.

If you specify a file as a parameter in a Windows Shortcut to NoICE, that file will be OPENed.

If you associate a file type with NoICE in Windows Explorer, double-clicking on a file of that type will cause NoICE to run, and the file to be OPENed.


VALUE: Show value of expression

    VALUE expr

This command displays the value of the expression "expr" in hex and in decimal. One use of this command is to perform hex to decimal conversion, or hex arithmetic.

Since any NoICE expression can contain symbol or register names, this command may also be used to show the value of a symbol.

"VAL" is an abbreviation of "VALUE".


VIEW file

    VIEW file.ext

This command is used to view a file in the View or Source window. If there is source line number information for the file, it will be displayed in the Source window, and the address of each code-producing line will be shown in the left margin. If there is no source line information for the file, then it will be displayed in the View window. If no file name is specified, then the File dialog will be shown.

Two switches affect the operation of VIEW. If the file name is followed by a "V",

    VIEW file.ext V
the file will be displayed in the View window even if source line information is available. If the file name is followed by an "X",
    VIEW file.ext X
the contents of the file will be displayed in the View window in hexadecimal and in ASCII. This is useful when viewing binary files.

In addition to the VIEW command, NoICE will automatically open files for viewing if source line number information is available. This will occur when the SOURCE command is executed, or when the source window is refreshed after a STEP, NEXT, or GO command.

"V" is an abbreviation of "VIEW".


FIND string in viewer

    FIND string

This command searches the current window from the current position for a match to the entered string. If the string is found, it is displayed on the top line of the window.

The default search direction is forward. If the string is prefixed with a minus ("-"), the search will be backward. If the string is prefixed with a plus ("+"), the search will be forward.

    FIND

Repeats the previous search, in the previously defined direction, beginning at the current position.

The commands "FIND +" or "FIND -" can be used to search for the previously defined string in a particular direction. F3 is a shortcut for "FIND +", and Shift + F3 is a shortcut for "FIND - ".


LINE: View file at line number

    LINE linenumber

If the viewer is open, this command causes the viewer to display beginning with the specified line of the current view file. The LINE command is also used to define information for source-level debugging.


CAPTURE to file

    CAPTURE file.ext

Begins recording output from the DUMP and UNASM commands, and characters received from the target which are not part of responses to NoICE messages, to the specified text file. If the file already exists, it is deleted and a new file of the same name is created. Capture continues until the CAPTURE command is entered without a file name.

CAPTURE has two major uses:

NOTE: use of a disassembler in this fashion may be subject to local and national laws. Use of NoICE for any illegal purpose is a violation of the NoICE license agreement.

The CAPTURE command may be found on the FILE menu.


VERSION: Display host and target versions

    VERSION

Displays the software version number and other information for the PC host and for the target.

If the processor type of the target does not match that expected by NoICE, an error will be displayed. If there is a mismatch, the register and execution commands will be locked out. Memory manipulation commands, such as EDIT, DUMP, LOAD, and all other NoICE commands will function properly regardless of target type.


BRK: generate serial line break

    BRK 1

If NoICE is using the serial monitor, allows the user to initiate a break on the NoICE serial port. If NoICE is not useing the serial monitor, this command is ignored.

    BRK 0

Ends the break condition. The BRK command will most often be used in conjunction with the WAIT command to generate a timed break.

The effect, if any, of break on the target will depend on target hardware and software. One possible application would connect a pulse-width detector to the serial line. If a break longer than some interval (perhaps a second or two) were detected, the target would be reset.


DTR and RTS: control serial port control lines

If NoICE is using the serial monitor, the DTR and RTS commands control the DTR and RTS lines of the NoICE serial port. If NoICE is not useing the serial monitor, these commands are ignored.

    DTR 1

Turns on the DTR line of the NoICE serial port.

    DTR 0

Turns off the DTR line of the NoICE serial port. The RTS command performs the same actions for the RTS line.

In most cases, DTR and RTS will be off when NoICE is not running. When NoICE opens the serial port, it sets RTS and DTR to the states you specify in the Target Communications dialog. When NoICE exits, it restores RTS and DTR to their original condition. Any use of the RTS and DTR commands is in addition to these automatic actions.

The effect, if any, of DTR and RTS on the target will depend on target hardware and software. Some users connect RTS or DTR to the target's RESET line, and use the RTS or DTR command to reset their target.


PAGENAME: define a name for memory space/page

    PAGENAME name low high

Defines "name" as a string to be used during display and entry of addresses in NoICE. "Low" is a hex integer that defines the first page to be given the "name". "High" is a hex integer that defines the last page to be given the "name". In most cases, "low" and "high" will be equal. If they are not, the pages in the range between "low" and "high" will be displayed as "name+NN", where "NN" is the offset from "low".

You may delete a definition by placing a "-" before the name:

    PAGENAME -name

You may delete all definitions by specifying "-" alone:

    PAGENAME -

You may list the current definitions by entering PAGENAME with no parameters:

    PAGENAME

This command is primarily intended for the 8051, which uses NoICE's address pages to support multiple memory spaces. However, it may be used with any target processor.

As an example, consider an 8051 system using the SDCC compiler. As described in our discussion of 3-byte generic pointers, SDCC uses page 0x80 for "code, page 0x40 for "data", page 0x00 for "xdata", and page 0x60 for "pdata". Thus, we would issue the commands

    PAGENAME code 0x80 0x80
    PAGENAME data 0x40 0x40
    PAGENAME xdata 0x00 0x00
    PAGENAME pdata 0x60 0x60

Thereafter, a pointer-to-code would be displayed as "code:1234" rather than as "80:1234"

In most cases, the PAGENAME commands would be in a NoICE command file, rather than being entered manually. For example, the 8051-specific symbol processing utilities CDB2NOI.EXE and OMF51NOI.EXE will include these definitions in the NoICE command files that they generate.


NoICE (tm) Debugger, Copyright © 2019 by John Hartman

Using NoICE - Contact us - NoICE Home