教你使用 MDK（keil）实现可视化配置向导

最近在开发 BMS 项目中，由于需要兼容很多电芯参数模型，同时还需要软件算法可以应对不同电芯以及应用场景，给用户提供高可配置型的功能，因此提供一个好的界面，让用户可以快速的配置基本模型和算法参数变得非常重要，今天来介绍一下我用 MDK 实现的方法。

一、MDK 的Configuration Wizard

Configuration Wizard翻译成中文可以叫做配置向导，它是由一些特殊规则的语法构成的，可以解释成图形化的配置菜单，在图形化界面中，可以很清晰的配置程序相关参数，而不需要在具体的代码中修改。

Configuration Wizard有点类似于Markdown原理，可以实现所见即所写，它采用注释的形式来构建菜单，在 MDK 中，它支持汇编、C/C++以及初始化文件（如.s文件）。如下图，先展示一张直观的配置界面，再从源码上来详细地介绍它的实现方法。

实现上图的源码：

/***************************************************                                    PACK 参数***************************************************/#if (1) /**Pack Information*///   Pack Infomation /************BATTERY_PACK_INFO*****************///  Pack Cell Series Counts <4=> 4 <5=> 5 <6=> 6 <7=> 7 <8=> 8 <9=> 9 <10=> 10#define PACK_SERIES_COUNT      (10) //Pack串数=电压采样点数//  Pack Cell Parallel Counts <1=> 1 <2=> 2  <3=> 3 <4=> 4#define NUM_PARALLEL           (2)  //Pack并数//  Pack Temp Sensors Counts <1=> 1 <2=> 2  #define NUM_CELL_TEMP_SENSORS  (2)  //电芯温度采样点数
/********CURRENT SENSOR TYPE******************///  Pack Current Sensors Resister(mR)  <1=> 1 <2=> 2  <4=> 4 <8=> 8#define DIVER_RESISTER         (4)  //电流采样电阻传感器mΩ
/*********AFE TYPE***************************/#define AFE_TYPE               (AFE_CG861XX_TYPE) //当前PCB使用的AFE的型号//   

二、如何在 MDK 中启用Configuration Wizard

一般情况下，我们在.c或.h文件中的头部，使用注释的方式增加如下代码，就可以使用配置向导了，当然，我们只需要保证这段开启向导的注释语句在代码文件的前 100 行之内就可以。

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

下面的注释代码可以告诉解释器，结束配置向导的解释，不过这不是必须的。

// <<< end of configuration section >>>

在前面的示例代码中，配置向导我写在 bms_config.h中，当我们添加了以上注释代码启用配置向导后，需要重新打开一下 bms_config.h文件，这时，在文件的左下角就会出现Text Editor和Configuration Wizard两个界面选项，它们分别对应程序源码和配置界面。

三、Configuration Wizard的语法规则

大家如果有使用过HTML语法，这里就非常容易理解了，它和 HTML一样，使用成对的标签来代表不同的功能，如<*>和，其中 * 代表不同的功能标签。

标签h

通过使用和来设置一个分组，它可以在配置向导中进行折叠。

//  分组标题// …// 

‍

标签i

使用+提示内容来设置对上一个配置项的提示，可以配置多行。

//  提示内容 如 Select the cell type for calcu the soc

//  使能分组标题// …// 

//    Enable Chip Select 0 (CSR0)//           WSE: Enable Wait State Generation//          NWS: Number of Standard Wait States <1-8><#-1>//     //       TDF: Data Float Output Time <0-7>//                  Number of Cycles Added after the Transfer//   #define A1 (0xFFE00000)#define A2 (0x010024A9)   // EBI_CSR0: Flash

//  标题内容

//  标题内容 <最小值-最大值:步进>

//  标题内容 <0=> 选项0  <1=> 选项1   选项n

//  标题内容

// //#define DEBUG_FLAG// 
// #define DEBUG_FLAG//