keil 的 配置向导 configuration wizard

以前发现keil 的很棒的功能 今天终于会用了。  分享给大家。转载的。 一 前言           很多人使用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.标题命令字 和          和必须成对出现，表示一个段落（组）开始，表示段落（组）结束，如果只有没有系统就会报错。      我们继续扩充我们的测试代码： //<<< Use Configuration Wizard in Context Menu >>> // this is a heading // //<<< end of configuration section >>> 2.使能组和          和类似，但是确是有更大的功能，Enable。举个例子：           //<<< Use Configuration Wizard in Context Menu >>> //    this is a heading  //    //  this is an options //     //<<< end of configuration section >>> 这里需要说明的是只是一个单选的，enable or disable ，因此这里开始我们就想怎么跟我们的程序结合起来了。于是我在的后面定义了一个8bit的tmp变量并且把他的值赋为0。 //<<< Use Configuration Wizard in Context Menu >>> //    this is a heading  //    //     this is an options //    uint8 tmp = 0;  //<<< end of configuration section >>> 当我把this is an options 打上勾勾的时候， 就自动变成了tmp=1： 这就是我们想要的。通过配置菜单，进行一些配置就可以改变到编译的c文件的内容 那么如果我只想设置tmp的某一位，比如第三位，怎么办？ 通过 命令，n表示第几位。 选择前： //<<< Use Configuration Wizard in Context Menu >>> //    this is a heading  //    //     this is an options //    uint8 tmp=1;  //<<< end of configuration section >>> 选择后： //<<< Use Configuration Wizard in Context Menu >>> //    this is a heading  //    //     this is an options //    uint8 tmp=9;  //<<< end of configuration section >>> 我们再来扩充下视野：假设我的8bit的数据分成8个enable选项，应该怎么做呢？ //<<< Use Configuration Wizard in Context Menu >>> //    this is a heading  //    //     this is an options bit 3 //    //     this is an options bit 2 //    //     this is an options bit 0 //    uint8 tmp=9;  //<<< end of configuration section >>> 3.infomations命令   当鼠标停留在当前的条目的时候可以显示提示信息。我们继续代码说明：   //<<< Use Configuration Wizard in Context Menu >>> //    this is a heading  //       head start form here! //    //  this is an options //     //<<< end of configuration section >>> 4.位允许   和不同，只是一个单选项，没有段落(组)的概念。 //    this is a heading  //       head start form here! //       this is single bitenable //    #define  BitEnalbe 1 同样也可以指定具体的某一位 //    this is a heading  //       head start form here! //       this is single bitenable bit 0 //       this is single bitenable bit 1 //       this is single bitenable bit 7 //    #define  BitEnalbe 0x83 5.选择或者输入数字           //         this is a 32bit input uint32 tmp32=0x2000; 数字输入涉及的问题就很多啦。比如我要限制啊，只能是一定范围啊，咋办？ //         this is a 32bit input   //         <2-30>      uint32 tmp32=0x02; 只能选择到极限值以内了。如果主动输入限制范围以外的数值呢？那可能会导致崩溃！ 后面还可以跟一个步进：,比如： //         this is a 32bit input   //         <2-30:4>          uint32 tmp32=0x10; 步进就变成了4了，每次点击上或者下，变化的步进就是4 那么这个数字能不能做成下拉菜单呢？当然是可以的。 //         this is a 32bit input   //         <0=> 1      <1=> 2 uint32 tmp32=0x01; 当选择2的时候把1赋给了后面的tmp32 那么指定位置呢？ 当然也是可以的。 uint32 tmp32=0x01; //         this is a 32bit input bit0  //         <0=> 1      <1=> 2 uint32 tmp32=0x01; //         this is a 32bit input bit0-7  //         <0=> 1      <1=> 2  <255=> 3 uint32 tmp32=0xFF; 6．字符串输入      //          this is a string input uint32 buf[]="hello"; 如果要想要限制字符串输入的长度可以用： //          this is a string input uint32 buf[]="hello12345"; 这个基本功能就介绍完了，下面有个重点功能要介绍：        7.整合所有的配置项          我们说，配置项多的时候是需要整合的。整合的过程当中，我们必须看清楚一个功能，那就是怎么跟多个配置项的配对起来。          在一个段落中，keil是只会把数值赋给随后的第一个定义，为了区分一个段落中的不同配置项，要用后缀来区分。上例子：           //    for multi-configuarations  //       this is single bit enable bit 0 //       this is single bit enable bit 0 //         this is a 32bit input   //         <2-30:4>               //         this is a 32bit input   //         <0=> 1      <1=> 2 //         this is a 32bit input bit0  //         <0=> 1      <1=> 2 //         this is a 32bit input bit0-7  //         <0=> 1      <1=> 2  <255=> 3 //          this is a string input //          this is a string input //    #define Q0  1 #define Q1  1 uint32 tmp32=0x15; uint32 tmp32=0x00; uint32 tmp32=0x01; uint32 tmp32=0xFF; uint32 buf[]="hello";                  uint32 buf[]="hello12345";