【MiCOKit试用体验】+ 如何扩展MICO中的cli命令

GalaIO 当前离线 经验 38 窥视卡 雷达卡

GalaIO ( 楼主 ) 2015-11-8 19:42:53  只看该作者 3120 | 1 倒序浏览

       大家好~我又回来了，最近在学习TCP/IP协议栈所以时间拉下了，3288的板子研究进度比较慢，但是掌握简单的操作还是没问题的，现在我跟搭建分享下如何扩展MicoKit的命令，上一帖子我提到对于MicoKit的例子中，在配置文件里默认打开cli功能，可以让大家能使用命令来操作3288的板子，我们可以把常用功能加入其中，来简便我们的开发和测试。
       幸好，在cli命令中，mico的工程师做了一个开源的命令工具，而且在分析源代码后，我也发现其实特别好给cli工具扩展命令，工程师早就留好了接口，我还以为需要自己写接口呢。
. ^; u' {" j' V/ w        好了现在我们要进入正题了，说点干货，mico的cli工具存放在MicoKitSDK_MiCO_v2.3.0MICOsystemcommand_console相对目录下，有两个文件，一个是mico_cli.c，这个是源文件包含了cli的主线程、串口配置、IO捕获、命令解析，还有一些内建命令的定义，当然并不是所有功能和内容都在这，还有一些通过二进制链接库提供，估计是保全版权吧，给闭源了，在这里不多说了，大家要想仔细分析源码，学学技巧呢，自己研究哦。

( j" Q4 M4 D0 a  q
2 P2 e$ g! r/ m5 d- u8 G7 \- m- L. _       这里说一下cli的内置命令的注册过程，首先用户程序调用的mico_system_init()函数，执行了cli_init()，然后执行cli_register_commands（）函数，传入内建命令列表，实现了列表的初始化，然后就不用担心了，其他的代码吧cli工具处理的很好咱们直接使用即可。
1 S7 U5 C; ^- H
6 ?  W2 G2 k2 W* M8 u8 P$ u7 x
       所以我们添加新的命令也是需要类似注册的东东，然后呢我们在cli的接口中发现了这样的函数。

1. 
   

/** Register a CLI command

*

* This function registers a command with the command-line interface.

*

* param[in] command The structure to register one CLI command

* return 0 on success

* return 1 on failure

*/

int cli_register_command(const struct cli_command *command);

复制代码

4 I) i- ^/ t0 A" g" I; h% V
: {0 f  l5 ^  m8 r1 \2 f这个函数表示我们可以注册一个新的命令道cli中，但是必须的满足cli_command的接口格式。
& h$ o9 H' T2 k/ ~4 W
/ z8 E8 l& ?8 W' {$ s

1. 
   2 }0 F+ @% g, u' h) G

/** Structure for registering CLI commands */

struct cli_command {

        /** The name of the CLI command */

        const char *name;

        /** The help text associated with the command */

        const char *help;

        /** The function that should be invoked for this command. */

        void (*function) (char *pcWriteBuffer, int xWriteBufferLen, int argc, char **argv);

};

复制代码
1 L6 K9 V) a/ k+ N* [
4 W" h' v6 {# V8 }" u       就是这个，只要我们编写了一个正确的cli命令函数，然后创建一个cli_command的结构体，在你的程序中，注册他就可以了。就是这么简单，这是我注册了3个命令的结构。
3 _* O- D/ H& i( m! o; q

      可以看到，最后的三个命令是我新添加的，在下一节中我会说明，这三个命令的实现原理。
" a" i+ ~3 ]* `: n2 C/ i

沙发

micolover 发表于 2015-11-9 11:43:05

感谢楼主的分享！