Keil Logo


Toolbox Button

The Toolbox contains user-configurable buttons. Click on a Toolbox button to execute the associated debug command or debug function. Toolbox buttons may be executed at any time, even while running the test program.

Toolbox buttons are define the Output Window — Command page with the DEFINE BUTTON command.

The general syntax is:

>DEFINE BUTTON "button_label", "command"
button_label is the name to display on the button in the Toolbox.
command is the µVision3 command to execute when the button is pressed.

Toolbox Dialog

The following examples show the define commands used to create the buttons in the Toolbox shown above:

>DEFINE BUTTON "Decimal Output", "radix=0x0A">DEFINE BUTTON "Hex Output", "radix=0x10"
>DEFINE BUTTON "My Status Info", "MyStatus ()" /* call debug function */
>DEFINE BUTTON "Analog0..5V", "analog0 ()" /* call signal function */
>DEFINE BUTTON "Show R15", "printf (\"R15=%04XH\\n\")"


  • The printf command defined in the last button definition shown above introduces nested strings. The double quote (") and backslash (\) characters of the format string must be escaped with \ to avoid syntax errors.

You may remove a Toolbox button with the KILL BUTTON command and the button number. For example:

>Kill Button 5 /* Remove Show R15 button */


  • The Update Windows button in the Toolbox is created automatically and cannot be removed. The Update Windows button updates several debug windows during program execution.
  Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.

Change Settings

Privacy Policy Update

Arm’s Privacy Policy has been updated. By continuing to use our site, you consent to Arm’s Privacy Policy. Please review our Privacy Policy to learn more about our collection, use and transfers
of your data.