MSS代码解读-SRR_MSS_CLIInit(三)

摘要：在这篇文章中，我们主要讲解SRR_MSS_CLIInit函数，这个函数包含了SDK软件包中的CLI实用程序，这个CLI程序包是TI外部定义的命令行接口任务，这个命令行接口任务提供了一个简化的“shell”接口，允许通过mmWave接口(MMWave_config)配置BSS。 它解析输入的CLI配置命令，如chirp profile和GUI配置。 在解析传感器启动CLI命令时，将执行与启动传感器和启动数据路径处理相关的所有动作。 解析传感器停止CLI命令时，将执行所有与停止传感器、停止数据路径处理相关的操作 

1.参数声明并初始化

进入SRR_MSS_CLIInit函数我们首先可以看到上图中的两行代码，第一行代码是声明了一个命令行接口（CLI）配置参数,参数用于提前对CLI进行设定，例如设定它的串行端口号，以及输入basicCfg命令时，对应执行SRR_MSS_CLIBasicCfg回调函数等。参数声明完成后，紧接着就是对参数进行进行初始化，这个过程是由 memset 完成的。

2.CLI配置参数设定

在声明并且对CLI配置参数初始化完成后，紧接着就是对参数的设定，在下面的代码片段中，就包含了此CLI的一些设定。现在将对这些参数属性进行阐述说明。

cliCfg.cliPrompt                    = "SrrTIDesign:/>";    //CLI提示字符串(如果有的话就提示SrrTIDesign:/>)

cliCfg.cliUartHandle             =  gSrrMSSMCB.commandUartHandle;  //这是给CLI指定串行端口号，其中是通过控制句柄来传递的

cliCfg.taskPriority                 = 3;     //指定外部CLI任务线程的优先级

cliCfg.mmWaveHandle       = gSrrMSSMCB.ctrlHandle;   //传递mmWave控制模块句柄给CLI,使得CLI可以控制传感器

cliCfg.enableMMWaveExtension        = 0U;  //CLI有一个mmWave扩展，可以通过这个字段启用。 为了使用该扩展，应用程序应该已经初始化和设置了mmWave，其中0-disenable  ,1-enable

cliCfg.usePolledMode = true;  //决定CLI Write是否应该在polled或blocking模式下使用UART的标志。

//定义CLI命令1

cliCfg.tableEntry[0].cmd            = "basicCfg";  //定义CLI命令为'basicCfg'

cliCfg.tableEntry[0].helpString     = "Basic Cfg [Hardcoded Parameters]";//CLI命令帮助字符串

cliCfg.tableEntry[0].cmdHandlerFxn  = SRR_MSS_CLIBasicCfg; //回调函数，即当CLI输入命令basicCfg时，将调用这个回调函数，用于配置BSS

//定义CLI命令2

cliCfg.tableEntry[1].cmd            = "advFrameCfg";  //定义CLI命令为'basicCfg'

cliCfg.tableEntry[1].helpString     = "Advanced Frame Cfg [Hardcoded Parameters]";//CLI命令帮助字符串

cliCfg.tableEntry[1].cmdHandlerFxn  = SRR_MSS_CLIAdvancedFrameCfg;//回调函数，即当CLI输入命令advFrameCfg时，将调用这个回调函数用配置BSS

 

3.启动CLI任务线程

在对配置参数填充完成之后，接下来就是启动CLI任务线程,这个过程是由CLI_open完成的。

找到CLI_open源码的结尾处，可以看到在CLI_open中创建了一个外部的任务线程，这时程序将会运行在这个线程中，并等待上位机输入命令对mmWave传感器进行控制，

补充：

可能初学者不太清楚什么叫CLI，通俗来说其实就是在MSS也用程序中创建类似于CMD命令提示符的终端程序，并定义有自己的命令代码用于计算机控制传感器的配置、开始、结束等操作，值得注意的是这个CLI是由SDK软件包提供的任务线程，虽然MSS应用程序最终运行在这个CLI线程中，但是我们在前边定义一个MMWave_execute任务线程拥有更高的优先级，所以当BSS运行出现任何异常事件时，都会优先执行MMWave_execute任务线程而先暂停运行CLI线程。

总结

到这里MSS应用程序主线已经清楚非常清晰了，在后面的文章中将会画出主线流程图。相关的回调函数将会在后续文章中讲解。