Skip to main content

IAR Embedded Workbench for RL78 5.20

Start/Stop Function Settings dialog box

In this section:

The Start/Stop Function Settings dialog box is available from the C-SPY Driver menu.

StartStopFunctionSettings_RX.png

Use this dialog box to configure the emulator to execute specific routines of your application immediately before the execution starts and/or after it halts. This is useful if you want to control your system in synchronization with starting and stopping the execution of your application.

Requirements

One of these alternatives:

  • The C-SPY E2 emulator

  • The C-SPY E2 Lite emulator

  • The C-SPY E2 On-Board emulator

  • The C-SPY EZ-CUBE2 emulator

Restrictions on using start/stop routines

Some restrictions apply:

  • If the start/stop routines write to the CPU registers, the registers are restored when the routines finish executing.

  • The execution of the start/stop routines cannot be single-stepped.

  • Breakpoints cannot be used in start/stop routines.

    Note! This means that library functions that use an internal breakpoint in the default debugging support implementation cannot be used, for instance printf and scanf (see Breakpoint consumers). Such functions can only be used with a custom debugging support implementation.

  • When your application starts executing from an address where a software breakpoint has been set, the instruction at the breakpoint is single-stepped, then the start routine is executed.

  • If you have specified and enabled a start routine and your application starts executing from an address where you have set an event breakpoint, the breakpoint is triggered if the condition is satisfied and the start routine will be executed. If the start routine is disabled, the event breakpoint will not be triggered. To trigger the event breakpoint without executing the start routine, you must single-step the instruction in the Disassembly window before you execute the rest of your application, or disable the start routine.

  • If you intend to use a stop routine, specify one that returns normally. If the routine does not return normally, the emulator debugger cannot control execution. To restore control, reset the debugger.

  • Hot plug-in is disabled when the start/stop feature is enabled.

Enable start routine

Enables the execution of a routine immediately before your application starts executing.

Start routine location

Specifies the routine to be executed immediately before your application starts executing. Type a label or an address, or click the browse button to open the Select Label dialog box, see Select Label dialog box.

Enable stop routine

Enables the execution of a routine immediately after your application stops executing.

Stop routine location

Specifies the routine to be executed immediately after your application stops executing. Type a label or an address, or click the browse button to open the Select Label dialog box, see Select Label dialog box.