??配置向导是一个集成的编辑器实用程序,用于在汇编、C/ c++或初始化文件中生成类似gui的配置控件。使用源代码中的配置向导注释来生成控件。
名称含义
单击“配置向导”选项卡,通过图形控件设置设备选项。单击“文本编辑器”选项卡以查看或更改源代码。
以下是上述向导的注释性代码
//*** <<< 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";
//*** <<< end of configuration section >>> ***
注释在代码中被写成注释。
默认情况下,修改注释后面的下一个数字
或字符串
。标记为 § 的项可以后跟一个跳过值。跳过值跳过许多项。该示例修改了注释后面的第二个数字。
<o1>
修饰语项后面可以跟一个文本。
项目或修饰符中的空白字符将被忽略。
在描述前面使用设备数据表中的符号名称是一种良好的做法。
使用文件配置导向代码的开头和结尾,分别加上这两句。配置向导部分必须在前100行代码中开始,并且必须以以下注释行开始:
// <<< Use Configuration Wizard in Context Menu >>>
// <<< end of configuration section >>>
<c>...</c>
,<!c>...</c>
?描述:创建一个复选框来取消注释或注释代码。<c>是勾上复选框时,代码启用,<!c>则相反,勾上时,代码注释。
//<c> 选框名称
#define DEMO 1
//</C>
扩展:可以用<C#>,#代表数字,如<C1>,<C2>。代表着,代码从第几行受<C#>控制,行数从0行开始计数,如<C1>下所列,它在配置中只能控制第一行和后面的启用或注释。而第0行不受控制。
//<C1> 选框名称
#define DEMO 1 // 第0行
#define DEMO 2 // 第1行
//</c>
<h>...</h>
?描述:以下选项属于一个组。一般内部嵌套着<c>之类的。
//<h> 标签名称
//<c> 选框名称
#define DEMO 1
//</C>
//<c> 选框名称
#define DEMO 2
//</C>
//</h>
<e>...</e>
?描述:以下选项属于一个组,可以通过复选框启用。勾选复选框时,第一个数据变成1,取消时恢复为0。有多个数据时,也只会修改第一个。还有就是<e>标签内的,例如<c>复选框,只有<e>这个上级的复选框勾选上了,才能控制勾选内部的<c>复选框,否者显灰色,无法勾选。
//<e> 选框名称1
#define NUM_DEMO 0x00
//<c> 选框名称2
#define Num 1
///c>
//</e>
扩展:可以用<e#1.#2>,#1,#2分别代表着数据,如:<e0.2>,<e1.3>,#1处数字,代表着第几个数据(从0开始算),#2处数字代表着,数据的第几位。
//<e0.2> 选框名称
#define NUM_DEMO (0x10,0x20)//第0个数据 第1个数据
//</e>
//<e1.3> 选框名称
#define NUM_DEMO1 0x00 //第0个数据
#define NUM_DEMO2 0x00 //第1个数据
//</e>
在上述程序中
当<e0.2>复选选框被勾选时,第0个数据,也就是NUM_DEMO,的数据0x10的第3为置1,也就是被改变成0x14。
当<e1.3>复选选框被勾选时,第1个数据,也就是NUM_DEMO2,的数据0x00的第3为置1,也就是被改变成0x08。
当取消勾选时对应的为会被置回为0
<i>
?描述:上一项的工具提示帮助文本。在程序的案例中,<i>在<h>下面,所以到时候在配置向导
时,除了<h>的名称外,还会有<i>的详细描述。
//<h> 标签名称
//<i> 标签的具体描述,此处省略100字...
// 代码主体
//</h>
<o>
?描述:往下的第1个数据在配置向导
中可直接输入改变0x00000000(4字节),可控制数值的。并不是上面标签一样只能控制复选框的是否勾选。
//<o> 数值框名称
#define NUM_DEMO 0x00000000
扩展:
<s>
?描述:选项,包含ASCII字符串条目。往下的第1个字符串数据在,在向导配置
为文中框形式,可以直接修改字符串。
//<s> 文字框名称
#define STR_DEMO "demostr"
在下面中十进制和十六进制都可以使用
<0-31>
?描述:选项字段的取值范围。超过最大范围值的,强制取最大值。如程序举例:
//<o> 限定数值 <0x00-0x0F>
#define NUM 0x00
<0-30:10>
?描述:选项字段的取值范围,规定了指定的步进量。不按步进量输入的,回退上一个合规的数值。
//<o> 限定数值 <0x00-0x0F:0x3>
#define NUM 0x06
<0=> 选项描述
?描述:值和用于选择的文本,用于<u>组成下拉框<u>。当选择右边的文字下拉框后,就赋值等号左边的值,给第一个数据。
//<o> 下拉数值 <0x00=> 1M Byte <0x01=> 4M Bytes <0x02=> 16M Bytes <0x03=> 64M Bytes
#define NUM 0x00
<#+1> <#-1>
<#*8> <#/3>
?描述:在将数字合并到字段之前修改值(add, sub, mul, div)。就是对可以对在向导配置
中输入的做一个偏移之类的计算。
//<o> 偏移数值 <0x00-0x08> <#-0x01>
#define NUM 0x00000000
在上面的程序中,在向导配置
中允许用户输入的0x00~0x08后,在减去0x01,就输入给第一个数据也就是NUM定义。
如果还是不太了解的,也可以查看Keil中,原文讲解。在图中所在位置。不过“Configuration Wizard”的标签要出来,文件内容里要有下面的注释代码。
// <<< Use Configuration Wizard in Context Menu >>>