Keil Logo

Configuration Wizard

The µVision3 Configuration Wizard enables menu driven configuration of assembler, C, or debugger initialization files. The Configuration Wizard uses control items that are embedded into the comments of the configuration file.

A file that contains items for the Configuration Wizard must include the following text within the first 100 text lines. When this text appears the Editor will open the file in Configuration Wizard view.

<<< Use Configuration Wizard in Context Menu >>>

The following optional text marks the end of the Configuration Wizard section.

<<< end of configuration section >>>

Configuration Menu

The configuration menu is controlled by items and modifiers. The various control items and modifiers for the menu of the Configuration Wizard are described below:

Item Text Description
<h> yes Heading: following options are within a group.
<e>§ yes Heading with Enable: following options are within a group that can be enabled via a Checkbox. 
<e.4>§ yes Heading with Enable: modifies a specific bits (example bit 4)
</h> or </e> yes Heading or Enable end.
<i> yes Tool tip help for previous item.
<q>§ yes Option for bit values with displays a checkbox
<o>§ yes Option with selection or number entry
<o.4..5>§ yes modify bits in number (example bit 4 and bit 5)
<o.4>§ yes modify a single bit in number
<s>§ yes Option with string entry
<s.10>§ yes Option with string entry and size limit (10 characters)
Modifier   Description
<0-31> no value range for options field
<0-100:10> no value range for options field with step 10
<0x40-0x1000:0x10> no value range in hex format
<0=> yes value and text for selection
<#+1>   <#-1>
<#*8>   <#/3>
no value modification (add, sub, mul, div) before number is merged into field

Notes

  • By default, the next number or string is modified that follows the comment section. Items marked with § can be followed by a skip value, for example:
    <o1>
    
    The skip value is used to skip a number of items. The example above modifies therefore the second number that follows the comment.
  • Items of Modifiers can be followed by a text. 
  • White space characters are ignored in item or modifiers. 
  • As a guideline use symbol name from the device data sheets in front of the description.

Example

//*** <<< Use Configuration Wizard in Context Menu >>> ***


FUNC void Setup (void) {

// <h> External Bus Interface (EBI)

//   <e1.13> Enable Chip Select 0 (CSR0)
//     <o1.20..31> BA: Base Address <0x0-0xFFF00000:0x100000><#/0x100000>
//                 <i> Start Address for Chip Select Signal
//     <o1.7..8>   PAGES: Page Size      <0=> 1M Byte    <1=> 4M Bytes
//                                       <2=> 16M Bytes  <3=> 64M Bytes
//                 <i> Selects Active Bits in Base Address
//     <o1.0..1>   DBW: Data Bus Width   <1=> 16-bit     <2=> 8-bit
//     <o1.12>     BAT: Byte Access Type <0=> Byte-write
//                                       <1=> Byte-select
//     <e1.5>      WSE: Enable Wait State Generation
//       <o1.2..4>   NWS: Number of Standard Wait States <1-8><#-1>
//     </e>
//     <o1.9..11>  TDF: Data Float Output Time <0-7>
//                 <i> Number of Cycles Added after the Transfer
//   </e>
  _WDWORD(0xFFE00000, 0x010024A9);   // EBI_CSR0: Flash

//   <e1.13> Enable Chip Select 1 (CSR1)
//     <o1.20..31> BA: Base Address <0x0-0xFFF00000:0x100000><#/0x100000>
//                 <i> Start Address for Chip Select Signal
//     <o1.7..8>   PAGES: Page Size      <0=> 1M Byte    <1=> 4M Bytes
//                                       <2=> 16M Bytes  <3=> 64M Bytes
//                 <i> Selects Active Bits in Base Address
//     <o1.0..1>   DBW: Data Bus Width   <1=> 16-bit     <2=> 8-bit
//     <o1.12>     BAT: Byte Access Type <0=> Byte-write
//                                       <1=> Byte-select
//     <e1.5>      WSE: Enable Wait State Generation
//       <o1.2..4>   NWS: Number of Standard Wait States <1-8><#-1>
//     </e>
//     <o1.9..11>  TDF: Data Float Output Time <0-7>
//                 <i> Number of Cycles Added after the Transfer
//   </e>
  _WDWORD(0xFFE00004, 0x040034A5);   // EBI_CSR1: RAM

//   <q1.4>        DRP: Data Read Protocol
//                      <0=> Standard Read
//                      <1=> Early Read
  _WDWORD(0xFFE00024, 0x00000010);   // EBI_MCR:  Data Read Protocol

  _WDWORD(0xFFE00020, 0x00000001);   // EBI_RCR:  Remap Command

// </h>

// <o> Program Entry Point
  PC = 0x04000000;

}

// <s> Change ID
// <s1.30> Change Password String
#define ID  "My User ID"
char pw[] = "My Password";

When you open this example it generates the following dialogs:

Configuration Wizard Example Dialog

  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.