SylixOS字符设备驱动开发(四)
SylixOS注册驱动和创建设备文件
上一节我们完成了驱动中的open和close函数功能,并使用这两个函数初始化了demo_fops 这个数据结构,现在我们将驱动注册到系统中,在SylixOS中这是通过调用iosDrvInstallEx 接口来实现的,这个接口其实就是API_IosDrvInstallEx 接口的宏定义,用宏重定义为iosDrvInstallEx 是为了和VxWorks的驱动相兼容,在SylixOS中,所有原生接口都是API_xxx 这种格式。
API_IosDrvInstallEx接口的函数原型:
INT API_IosDrvInstallEx (struct file_operations *pfileop);
成功返回一个驱动索引号,失败返回PX_ERROR。在SylixOS中,所有注册的驱动都是存放在一张全局的驱动表(数组)中,每次注册驱动时,都会在当前表中找到一个可用的位置给注册的驱动使用,并返回这个位置在表中的索引(数组下标)。 调用此接口默认创建的是ORIG型驱动。
一般在驱动中会定义一个全局变量用来保存驱动索引号:
int drv_index;
int module_init (void)
{
int ret = 0;
drv_index = iosDrvInstallEx(&demo_fops);
if (drv_index < 0) {
printk("driver install fail.\r\n");
return -1;
}
return 0;
}
这个驱动索引号会在驱动卸载的时候用到,卸载驱动所使用的接口是iosDrvRemove,iosDrvRemove 是API_IosDrvRemove 的宏定义,函数原型:
ULONG API_IosDrvRemove (INT iDrvNum, BOOL bForceClose);
iDrvNum就是驱动注册时的索引号,bForceClose表示是否强制删除驱动。成功返回ERROR_NONE,失败返回错误号。
在linux驱动中我们需要填写驱动所遵守的开源协议以及驱动的作者等信息,同样的,在SylixOS中也可以填入这些信息:
DRIVER_LICENSE(drv_index, "GPL->Ver 2.0");
DRIVER_AUTHOR(drv_index, "GeWenBin");
DRIVER_DESCRIPTION(drv_index, "demo driver.");
驱动注册完成之后,我们就可以创建设备文件,这是通过iosDevAdd 接口实现的,iosDevAdd 是API_IosDevAdd 的宏定义,函数原型:
ULONG API_IosDevAdd (PLW_DEV_HDR pdevhdrHdr,
CPCHAR pcName,
INT iDrvNum);
pdevhdrHdr就是设备实例变量的地址,pcName是设备文件的名称,比如“/dev/demo”,iDrvNum就是注册驱动时返回的索引号。成功返回ERROR_NONE,失败返回错误码。
删除设备文件使用iosDevDelete接口,iosDevDelete是API_IosDevDelete 的宏定义,函数原型:
VOID API_IosDevDelete (PLW_DEV_HDR pdevhdrHdr);
这个接口只有一个入参,就是设备实例变量的地址。
在驱动模块卸载时,一般是先删除设备文件再卸载设备驱动:
void module_exit (void)
{
iosDevDelete(&demo_dev);
iosDrvRemove(drv_index, TRUE);
}
附源码
driver_demo4源码:
#define __SYLIXOS_KERNEL
#include <SylixOS.h>
#include <module.h>
int drv_index;
LW_DEV_HDR demo_dev;
static long demo_open(LW_DEV_HDR *dev, char *name, int flag, int mode)
{
printk("%s %s.\r\n", __func__, name);
if ((flag & O_ACCMODE) == O_RDONLY) {
printk("open read only.\r\n");
} else if ((flag & O_ACCMODE) == O_WRONLY) {
printk("open write only.\r\n");
} else {
printk("open read/write.\r\n");
}
printk("file permission: %o.\r\n", mode);
return (long)dev;
}
static int demo_close(LW_DEV_HDR *dev)
{
printk("%s.\r\n", __func__);
return ERROR_NONE;
}
static struct file_operations demo_fops = {
.owner = THIS_MODULE,
.fo_open = demo_open,
.fo_close = demo_close,
};
int module_init (void)
{
int ret = 0;
drv_index = iosDrvInstallEx(&demo_fops);
if (drv_index < 0) {
printk("driver install fail.\r\n");
return -1;
}
DRIVER_LICENSE(drv_index, "GPL->Ver 2.0");
DRIVER_AUTHOR(drv_index, "GeWenBin");
DRIVER_DESCRIPTION(drv_index, "demo driver.");
ret = iosDevAdd(&demo_dev, "/dev/demo", drv_index);
if (ret != ERROR_NONE) {
printk("device add fail.\r\n");
iosDrvRemove(drv_index, TRUE);
return -1;
}
return 0;
}
void module_exit (void)
{
iosDevDelete(&demo_dev);
iosDrvRemove(drv_index, TRUE);
}