NOTE: Build 14 of the Console contains a beta version of an opcode-level TEA program debugger.

This console command compiles a TEA file into an object file that can be run on any TEA Virtual Machine implementation.  It runs the TEA file in debug mode and launches a debugging GUI using the default Web Browser on the host machine.

filename

The name of the file to compile and debug.  Typically this is a file with a .tea extension.  If no extension is specified, a ".tea" is appended to this command parameter.  If the file has already been compiled then compilation will be skipped.

module

The module where the file is to be loaded and debugged.  A value of 2-126 denotes an external module.  If the module is host then the debugger will execute code within the Console's VM emulator.  The Console VM fakes most IO operations.

data

Any data byte values required as input by the TEA program.

Example:

debug "test" host 1

This would execute the TEA compiler on a file named "test.tea" in the aUser File Area .  The result would be stored as an object file with a ".cup" extension in the aObject File Area.  The Console (host) VM emulator will execute the instructions.  A byte with a value of 1 will be passed as input data.  The Console will launch the default Web Browser and display the debugging GUI.  The GUI has 6 functions for controlling program flow: go, step in, step out of subroutine, step over subroutine, stop, and kill.

Related:

load, launch, steep, TEA Grammar