Watch Window


The watch window monitors data on the target board, and it updates itself as often as the debugger link will permit. It can call any Forth word with a known data type. A word can be assigned a data type with the DATATYPE directive.


A word with an associated data type can be added to the watch window by clicking on its datatype field in the token browser window. In the example below, I clicked on the datatype fields of COUNTER@ and HERE.

Forth word watching:

ADDWATCH ( <name> -- ) Adds a word to the watch list
CLEARWATCH ( -- ) Clears the watch list

Generic memory watching:

WATCHDATA" ( addr format string" -- ) Adds watch parameter for data memory
WATCHCODE" ( addr format string" -- ) Adds watch parameter for code memory
WATCHREG" ( addr format string" -- ) Adds watch parameter for register space
WATCHEE" ( addr format string" -- ) Adds watch parameter for EEPROM
CLEARWATCH ( -- ) Clears the watch list

Addr = address of data to watch

Format is two bytes: the upper byte is the display format and the lower byte is the byte count.

Formats:
0 byte value
1 16-bit little-endian
2 16-bit big-endian
3 32-bit little-endian
4 32-bit big-endian
5 ASCII

Example: 0xC000 0x102 WATCHDATA" Location C000 = "
adds an item to the watch list that fetches 2 bytes from data memory location
0xC000 and displays the data as a 16-bit little-endian number.