第一次写Nuttx系统的驱动,用惯了rt-thread、FreeRTOS等RTOS或裸机的驱动编写。写Nuttx驱动感觉好蹩脚,顺便记录一下(by the way: 先完成,再完善)
Nuttx驱动分类
Nuttx作为类linux的RTOS,驱动结构、风格与linux很相似
1. 字符驱动
例如串口设备、ADC、DAC、CAN、Timer、PWM、编码器、RTC、看门狗、按键等等
2. 块设备驱动
3. 特殊设备驱动
例如网卡、SPI、IIC、LCD、SDIO、USB、MIPI等
Nuttx驱动简介
1. 数据结构
Nuttx通过驱动注册接口,将驱动注册到文件系统中,并实现file_operations
操作函数,应用层只需通过标准系统调用,即可调用底层驱动。
底层驱动有分为上半部分(upper_half)和下半部分(lower_half)
本质理解:驱动 = 总线 + 功能
总线:GPIO、SPI、IIC、CAN、USB、串口等;
功能:读写数据、存储、使能、传输等;
struct file_operations
在fs.h
struct file_operations
{
int (*open)(FAR struct file *filep);
int (*close)(FAR struct file *filep);
ssize_t (*read)(FAR struct file *filep, FAR char *buffer, size_t buflen);
ssize_t (*write)(FAR struct file *filep, FAR const char *buffer,
size_t buflen);
off_t (*seek)(FAR struct file *filep, off_t offset, int whence);
int (*ioctl)(FAR struct file *filep, int cmd, unsigned long arg);
int (*poll)(FAR struct file *filep, struct pollfd *fds, bool setup);
#ifndef CONFIG_DISABLE_PSEUDOFS_OPERATIONS
int (*unlink)(FAR struct inode *inode);
#endif
};
struct file
{
int f_oflags;
off_t f_pos;
FAR struct inode *f_inode;
FAR void *f_priv;
};
struct pollfd
{
int fd;
short int events;
short int revents;
};
struct inode
{
FAR struct inode *i_parent;
FAR struct inode *i_peer;
FAR struct inode *i_child;
int16_t i_crefs;
uint16_t i_flags;
union inode_ops_u u;
#ifdef CONFIG_PSEUDOFS_ATTRIBUTES
mode_t i_mode;
uid_t i_owner;
gid_t i_group;
struct timespec i_atime;
struct timespec i_mtime;
struct timespec i_ctime;
#endif
FAR void *i_private;
char i_name[1];
};
1.1. open
要操作设备,第一步就是要打开相应的设备文件,即使用open()
打开设备,其返回一个文件描述符fd。打开设备号之后对该设备的操作可以通过fd来完成。
应用中open()
以设备的节点路径和操作权限为参数,操作进入VFS,调用fs_open.c
中的open()
函数,通过设备路径找到对应的inode
节点,在进程的文件描述符链表中寻找并分配空闲可用的描述符fd
和文件file
,最后调用设备节点inode
中的文件操作file_operation
中的函数open()
。应用程序调用成功时,返回本次分配的文件描述符fd
,发生错误时,返回-1,错误码记录在errno
中。
1.2. close
关闭设备文件,调用file_operations
的close()
函数,释放设备文件、文件描述符fd
。
1.3. read
从设备读取数据。
- 参数1:文件file指针
- 参数2:数据buffer
- 参数3:读取的buffer长度
1.4. write
往设备写数据。
参数同read
1.5. seek
查找或调整文件读写位置。
- 参数1:文件file指针
- 参数2:文件位置相对偏移
- 参数3:设置位置起始点
1.6. ioctl
用于执行设备特定命令,如设置设备属性、配置设备寄存器等。
- 参数1:文件file指针
- 参数2: 控制命令
- 参数3:命令参数
1.7. poll
查询指定的一组文件是否可读或可写。
首先初始化信号量,用于实现阻塞,直到文件可读或可写(亦可设置超时时间)
file_operation
的poll()
函数设计中,如果文件可读、写:
- 修改对应的pollfd中的返回事件标志为对应的事件;
- 释放信号量。
- 参数1: poll_fd数组指针
- 参数2:查询的文件数量
- 参数3:等待时间
- 返回正数:可读写的文件数量
- 返回0:超时
- 返回-1:错误
1.8. unlink
用于已挂载的设备或文件卸载,字符设备一般不涉及;常见于块设备。
2. 字符设备驱动注册、注销
Nuttx将驱动设备文件化,即VFS。
struct file_operations
设备文件操作的方法,通过register_driver接口
将驱动设备挂到对应的struct inode
节点中,struct inode
描述 了每个设备节点的位置和数据。当系统调用操作设备文件时,根据对应文件的inode
就能索引到对应的函数。
int register_driver(FAR const char *path,
FAR const struct file_operations *fops,
mode_t mode, FAR void *priv)
{
FAR struct inode *node;
int ret;
ret = inode_semtake();
if (ret < 0)
{
return ret;
}
ret = inode_reserve(path, mode, &node);
if (ret >= 0)
{
INODE_SET_DRIVER(node);
node->u.i_ops = fops;
node->i_private = priv;
ret = OK;
}
inode_semgive();
return ret;
}
- 参数1:设备路径,例如注册一个key驱动到
/dev/key
- 参数2:设备的文件操作指针,指向文件操作实例
- 参数3:预算的设备访问权限
- 参数4:为设备驱动传递的私有参数
- 返回0:注册成功
- 返回负数:注册失败,错误码
int unregister_driver(FAR const char *path)
{
int ret;
ret = inode_semtake();
if (ret >= 0)
{
ret = inode_remove(path);
inode_semgive();
}
return ret;
}
Nuttx驱动实例请看下一篇文章
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)