|
 
- UID
- 864567
|
一 前言
很多人使用keil的时候感觉keil的configuration wizard 很神奇，用起来特别方便，但是苦于不知道怎么去编写自己的configuration wizard，其实keil的help文档就有，只是很多人用着感觉英文不方便，又或者看了没理解，为此，特写了一个教程，希望大家能从中学到一些知识。
二 基本介绍
Configuration wizard 只能在keil中使用，能够可以通过菜单的方式对一些预设值进行设置，修改，配置。
三．基本使用方法
在文档中写入 标记开始
<<< Use Configuration Wizard in Context Menu >>>
当检测到以上关键字，keil就会认为这个文档里面存着Configuration Wizard，并开始搜索内容中的其他关键字。当检测到以下内容的时候，停止搜索
<<< end of configuration section >>>
注意： <<< Use Configuration Wizard in Context Menu >>>和<<< end of configuration section >>> 必须被“//”屏蔽 或者“；”。因为是额外的信息不能影响到文档的编译所以，必须屏蔽，但是屏蔽不可以用批量屏蔽如“/* 。。。。 */，即使“/* ”和“*/”在同一行也不可以。并且“//”或者“；”必须在行首。
下面我们来一步步完善这个例子：
新建一个test.c文档作为测试文档。
在文档中输入：
//<<< Use Configuration Wizard in Context Menu >>>
//<<< end of configuration section >>>
保存并且关闭，再打开
就可以看到Configuration Wizard 的选项了。点击进去可以看到选项已经出来了，只是里面的内容还是空的。
命令字
1.标题命令字 <h>和</h>
<h>和</h>必须成对出现，<h>表示一个段落（组）开始，</h>表示段落（组）结束，如果只有<h>没有</h>系统就会报错。
我们继续扩充我们的测试代码：
//<<< Use Configuration Wizard in Context Menu >>>
//<h> this is a heading
//</h>
//<<< end of configuration section >>>
2.使能组<e>和</e>
和<h>类似，但是<e>确是有更大的功能，Enable。举个例子：
//<<< Use Configuration Wizard in Context Menu >>>
// <h> this is a heading
// </h>
// <e>this is an options
// </e>
//<<< end of configuration section >>>
这里需要说明的是<e>只是一个单选的，enable or disable ，因此这里开始我们就想怎么跟我们的程序结合起来了。于是我在</e>的后面定义了一个8bit的tmp变量并且把他的值赋为0。
//<<< Use Configuration Wizard in Context Menu >>>
// <h> this is a heading
// </h>
// <e>this is an options
// </e>
uint8 tmp = 0;
//<<< end of configuration section >>>
当我把this is an options 打上勾勾的时候，
就自动变成了tmp=1：
这就是我们想要的。通过配置菜单，进行一些配置就可以改变到编译的c文件的内容
那么如果我只想设置tmp的某一位，比如第三位，怎么办？
通过<e.n> 命令，n表示第几位。
选择前：
//<<< Use Configuration Wizard in Context Menu >>>
// <h> this is a heading
// </h>
// <e.3>this is an options
// </e>
uint8 tmp=1;
//<<< end of configuration section >>>
选择后：
//<<< Use Configuration Wizard in Context Menu >>>
// <h> this is a heading
// </h>
// <e.3>this is an options
// </e>
uint8 tmp=9;
//<<< end of configuration section >>>
我们再来扩充下视野：假设我的8bit的数据分成8个enable选项，应该怎么做呢？
//<<< Use Configuration Wizard in Context Menu >>>
// <h> this is a heading
// </h>
// <e.3>this is an options bit 3
// </e>
// <e.2>this is an options bit 2
// </e>
// <e.0>this is an options bit 0
// </e>
uint8 tmp=9;
//<<< end of configuration section >>>
3.infomations命令<i>
当鼠标停留在当前的条目的时候可以显示提示信息。我们继续代码说明：
//<<< Use Configuration Wizard in Context Menu >>>
// <h> this is a heading
// <i> head start form here!
// </h>
// <e>this is an options
// </e>
//<<< end of configuration section >>>
4.位允许<q>
和<e>不同，<q>只是一个单选项，没有段落(组)的概念。
// <h> this is a heading
// <i> head start form here!
// <q> this is single bitenable
// </h>
#define BitEnalbe 1
同样也可以指定具体的某一位
// <h> this is a heading
// <i> head start form here!
// <q.0> this is single bitenable bit 0
// <q.1> this is single bitenable bit 1
// <q.7> this is single bitenable bit 7
// </h>
#define BitEnalbe 0x83
5.<o>选择或者输入数字
// <o> this is a 32bit input
uint32 tmp32=0x2000;
数字输入涉及的问题就很多啦。比如我要限制啊，只能是一定范围啊，咋办？
<min-max>
// <o> this is a 32bit input
// <2-30>
uint32 tmp32=0x02;
只能选择到极限值以内了。如果主动输入限制范围以外的数值呢？那可能会导致崩溃！
<min-max>后面还可以跟一个步进：<min-max:step>,比如：
// <o> this is a 32bit input
// <2-30:4>
uint32 tmp32=0x10;
步进就变成了4了，每次点击上或者下，变化的步进就是4
那么这个数字能不能做成下拉菜单呢？当然是可以的。
// <o> this is a 32bit input
// <0=> 1 <1=> 2
uint32 tmp32=0x01;
当选择2的时候把1赋给了后面的tmp32
那么指定位置呢？
当然也是可以的。
uint32 tmp32=0x01;
// <o.0> this is a 32bit input bit0
// <0=> 1 <1=> 2
uint32 tmp32=0x01;
// <o.0..7> this is a 32bit input bit0-7
// <0=> 1 <1=> 2 <255=> 3
uint32 tmp32=0xFF;
6．字符串输入<s>
// <s> this is a string input
uint32 buf[]="hello";
如果要想要限制字符串输入的长度可以用：<s:limt>
// <s.10> this is a string input
uint32 buf[]="hello12345";
这个基本功能就介绍完了，下面有个重点功能要介绍：
7.整合所有的配置项
我们说，配置项多的时候是需要整合的。整合的过程当中，我们必须看清楚一个功能，那就是怎么跟多个配置项的配对起来。
在一个段落中，keil是只会把数值赋给随后的第一个定义，为了区分一个段落中的不同配置项，要用后缀来区分。上例子：
// <h> for multi-configuarations
// <q.0> this is single bit enable bit 0
// <q1.0> this is single bit enable bit 0
// <o> this is a 32bit input
// <2-30:4>
// <o1> this is a 32bit input
// <0=> 1 <1=> 2
// <o2.0> this is a 32bit input bit0
// <0=> 1 <1=> 2
// <o3.0..7> this is a 32bit input bit0-7
// <0=> 1 <1=> 2 <255=> 3
// <s> this is a string input
// <s1.10> this is a string input
// </h>
#define Q0 1
#define Q1 1
uint32 tmp32=0x15;
uint32 tmp32=0x00;
uint32 tmp32=0x01;
uint32 tmp32=0xFF;
uint32 buf[]="hello";
uint32 buf[]="hello12345"; |
|
