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 DISASSEMBLE 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.


SHOW: Hex Display of Communications

	SHOW value

If "value" is "1", then message communications between NoICE and the target monitor will be displayed in hex in a pop-up window. At the end of each message, the user will be prompted to press any key to continue. When a key is pressed, the pop-up window will be removed and NoICE will continue.

This is primarily useful when debugging a new target monitor, as it allows examination of the hex data exchanged between the host and the target.

If "value" is "0", then communications between NoICE and the target monitor will not be displayed.

Regardless of whether or not hex data is being shown, non-message serial data from the target while the target is running will be displayed as ASCII in the data window.


BRK: generate serial line break

	BRK 1

Allows the user to initiate a break on the NoICE serial port.

	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

	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.


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

Using NoICE - Contact us - NoICE Home