本帖最后由 Simon21ic 于 2016-3-22 04:33 编辑
应用举例：app_blink，此模块功能为注册一个命令行界面的命令，可以通过这个命令来控制一个IO口以设置的间隔反转，类似LED的blink效果。
- #include "vsf.h"
- #include "../../vsfos/vsfos.h"
- struct app_blink_t
- {
- struct interface_gpio_pin_t pin;
- uint32_t interval;
- };
首先需要include基本的系统头文件，并且定义blink需要的结构：一个GPIO引脚和一个时间间隔属性。
下面我们先掠过应用代码，说明一下模块的载入和退出代码：
- vsf_err_t app_blink_modexit(struct vsf_module_t *module)
- {
- vsf_bufmgr_free(module->ifs);
- module->ifs = NULL;
- return VSFERR_NONE;
- }
- vsf_err_t app_blink_modinit(struct vsf_module_t *module,
- struct app_hwcfg_t const *cfg)
- {
- struct vsfshell_handler_t *handlers;
- handlers = vsf_bufmgr_malloc(2 * sizeof(struct vsfshell_handler_t));
- if (!handlers) return VSFERR_FAIL;
- memset(handlers, 0, sizeof(*handlers));
- handlers[0] = (struct vsfshell_handler_t){"blink", app_blink};
- vsfshell_register_handlers(&vsfos->shell, handlers);
- module->ifs = handlers;
- return VSFERR_NONE;
- }
模块的载入，就是动态分配模块的内存，并且设置为模块的接口(module->ifs)。
app_blink里，没有专用的模块接口，只是使用了vsfshell_handler_t的数组，动态分配内存并且初始化handlers之后，就调用vsfshell_register_handlers注册blink命令。
当在命令行界面中，运行blink后，就会调用到执行的命令处理函数app_blink：
- static vsf_err_t app_blink(struct vsfsm_pt_t *pt, vsfsm_evt_t evt)
- {
- struct vsfshell_handler_param_t *param =
- (struct vsfshell_handler_param_t *)pt->user_data;
- struct vsfsm_pt_t *outpt = param->output_pt;
- struct app_blink_t *blink = (struct app_blink_t *)param->priv;
- vsfsm_pt_begin(pt);
- if (param->argc != 4)
- {
- vsfshell_printf(outpt, "format: %s PORT PIN INTERVAL"VSFSHELL_LINEEND,
- param->argv[0]);
- goto end;
- }
- param->priv = vsf_bufmgr_malloc(sizeof(struct app_blink_t));
- if (NULL == param->priv)
- {
- vsfshell_printf(outpt, "not enough resources"VSFSHELL_LINEEND);
- goto end;
- }
- blink = (struct app_blink_t *)param->priv;
- blink->pin.port = strtoul(param->argv[1], NULL, 0);
- blink->pin.pin = strtoul(param->argv[2], NULL, 0);
- blink->interval = strtoul(param->argv[3], NULL, 0);
- vsfshell_printf(outpt, "blinking on GPIO%d.%d"VSFSHELL_LINEEND,
- blink->pin.port, blink->pin.pin);
- // switch to background thread
- vsfshell_handler_release_io(param);
- vsfhal_gpio_init(blink->pin.port);
- vsfhal_gpio_config_pin(blink->pin.port, blink->pin.pin, GPIO_OUTPP);
- while (1)
- {
- vsfhal_gpio_clear(blink->pin.port, 1 << blink->pin.pin);
- vsfsm_pt_delay(pt, blink->interval);
- vsfhal_gpio_set(blink->pin.port, 1 << blink->pin.pin);
- vsfsm_pt_delay(pt, blink->interval);
- }
- end:
- vsfshell_handler_exit(param);
- vsfsm_pt_end(pt);
- return VSFERR_NONE;
- }
这里就是blink的功能函数了。命令处理函数基本都类似，先得到vsfshell_handler_param_t的参数指针param，并且从这个结构中，得到outpt用于信息输出。param->argc和param->argv就是命令行中输入的参数，参数以空格分开，也可以使用双引号把带空格的字符串作为一个参数。vsfshell_printf就是类似printf的功能，只是第一个参数需要是outpt。检查完毕后，就分配app_blink_t，并且解析参数得到需要控制的IO口以及翻转的毫秒间隔。之后调用vsfshell_handler_release_io后，本任务转入后台运行，命令行界面可以继续输入命令。后台运行的任务就是初始化IO口后，在while(1)中，以设置的毫秒间隔翻转IO口。最后，如果命令处理函数退出的话，要调用一次vsfshell_handler_exit。
在之前的那个任务运行的时候，还可以再次运行blink命令，控制其他的IO口翻转，vsfshell中的命令处理函数，都是动态分配的独立任务，返回会释放资源，不返回则可以一直独立运行。
VSFOS内置的命令都在vsf\example\appldr\module\vsfos\vsfos_busybox.c中，这里有更多的示例代码。
如果模块可以提供接口给其他模块使用，最简单的可以参考vsf\tool\crc中的CRC模块的代码。
如果模块依赖某个硬件接口库，那么需要在使用这个硬件接口之前，判断硬件接口是否可用：
- if (!vsfhal_hcd_if)
- {
- vsfshell_printf(outpt, "hcd interface not available"VSFSHELL_LINEEND);
- goto end;
- }
如果模块依赖其他模块，那么在模块的入口函数里，需要调用vsf_module_get来判断依赖的模块是否存在：
- if (vsf_module_get(VSFIP_MODNAME) != NULL)
- {
- handlers[idx++] = (struct vsfshell_handler_t){"ipconfig", vsfos_busybox_ipconfig, ctx};
- handlers[idx++] = (struct vsfshell_handler_t){"arp", vsfos_busybox_arp, ctx};
- handlers[idx++] = (struct vsfshell_handler_t){"ping", vsfos_busybox_ping, ctx};
- if (vsf_module_get(VSFIP_HTTPD_MODNAME) != NULL)
- {
- handlers[idx++] = (struct vsfshell_handler_t){"httpd", vsfos_busybox_httpd, ctx};
- }
- if (vsf_module_get(VSFIP_DNSC_MODNAME) != NULL)
- {
- handlers[idx++] = (struct vsfshell_handler_t){"dns", vsfos_busybox_dns, ctx};
- vsfip_dnsc_init();
- }
- }
| 
楼主
你这个真的好先进，应该大多数人一下子搞不清。 问题理论上都能通过读代码知道，不过还是有说明和框图比较能让人很快了解大概。 对一个陌生东西应该大家最开始想入手还是怎么加自己的功能代码，以及怎么添加一个新的模块。虽然看不太懂，非常感谢楼主让我们大开眼界，了解这种先进的开发方式。
