How to redirect – Freescale Semiconductor Microcontrollers User Manual

Page 628

Advertising
background image

ColdFire V1 Full Chip Simulation Connection

FCS Visualization Utilities

628

Microcontrollers Debugger Manual

Use Escape sequences to handle redirection of the output data stream.

Table 28.14

illustrates the different possible redirections and associated escape sequences where
filename

is a sequence of characters terminated by a control character (e.g., CR) and is

a valid filename.

ESC is the ESC character (ASCII code 27 decimal).

Use these commands anywhere in the output stream.

How to Redirect

By default, an output redirection is set to the TestTerm component window.

The debugger uses the Term_Direct function declared in terminal.h to redirect an
output.

Listing 28.2

gives the source code in terminal.c.

Listing 28.2 Term_Direct Source Code

void Term_Direct(int what, char *fileName)
{
if (what < 1 && what > FROM_FILE) return;
Write(ESC); Write('h');
Write(what + '0');
if (what != TO_WINDOW && what != FROM_KEYS) {
PutString(fileName); Write(CR);
}
}

In this case, what is one of the following items:

Table 28.14 Redirections and Associated Escape Sequences

Escape Sequence

Function

ESC “h” “1”

Output to Terminal window only.

ESC “h” “2” filename

Output to both Terminal window and file.

ESC “h” “3” filename

Output to file only.

ESC “h” “4”

Read from keyboard

ESC “h” “5” filename

Read input from file fileName

ESC “h” “6” filename

Output to Terminal window and append to file

ESC “h” “7” filename

Append to file only

Advertising