Coma FW-C2800 User's Guide download pdf (Page 80)

Instrumentation APIs

3-18

You can enable and disable these trace bits in the following ways:

❏ From the host, use the RTA Control Panel as shown in Figure 3-8. This

panel allows you to adjust the balance between information gathering

and time intrusion at run time. By disabling various implicit instrumenta-

tion types, you lose information but reduce the overhead of processing.

You can control the refresh rate for trace state information by right-

clicking on the Property Page of the RTA Control Panel. If you set the

refresh rate to 0, the host does not poll the target for trace state

information unless you right-click on the RTA Control Panel and choose

Refresh Window from the pop-up menu. Initially, all boxes on the RTA

Control Panel are checked by default.

Figure 3-8. RTA Control Panel Dialog Box.

❏ From the target code, enable and disable trace bits using the

TRC_enable and TRC_disable operations, respectively. For example,

the following C code disables tracing of log information for software

interrupts and periodic functions:

TRC_disable(TRC_LOGSWI | TRC_LOGPRD);

For example, in an overnight run you might be looking for a specific

circumstance. When it occurs, your program can perform the following

statement to turn off all tracing so that the current instrumentation

information is preserved:

TRC_disable(TRC_GBLTARG);

Any changes made by the target program to the trace bits are reflected in the

RTA Control Panel. For example, you could cause the target program to

disable the tracing of information when an event occurs. On the host, you can

simply wait for the global target enable check box to be cleared and then

examine the log.

1 2 ... 75 76 77 78 79 80 81 82 83 84 85 ... 275 276

No comments

Coma FW-C2800 User's Guide Page 80