Chinaunix首页 | 论坛 | 博客
  • 博客访问: 58806
  • 博文数量: 20
  • 博客积分: 1415
  • 博客等级: 上尉
  • 技术积分: 225
  • 用 户 组: 普通用户
  • 注册时间: 2010-01-29 01:11
文章分类
文章存档

2011年(1)

2010年(19)

我的朋友

分类: LINUX

2010-02-02 18:01:45

Linux终端设备驱动

本章导读

Linux系统中,终端设备非常重要,没有终端设备,系统将无法向用户反馈信息,Linux中包含控制台、串口和伪终端3类终端设备。
14.1
节阐述了终端设备的概念及分类,14.2节给出了Linux终端设备驱动的框架结构,重点描述tty_driver结构体及其成员。14.3~14.5节在14.2节的基础上,分别给出了Linux终端设备驱动模块加载/卸载函数和open()close()函数,数据读写流程及tty设备线路设置的编程方法。在Linux中,串口驱动完全遵循tty驱动的框架结构,但是进行了底层操作的再次封装,14.6节描述了Linux针对串口tty驱动的这一封装,14.7节则具体给出了串口tty驱动的实现方法。14.8节基于14.614.7节的讲解给出了串口tty驱动的设计实例,即S3C2410集成UART的驱动。


14.1
终端设备
   
Linux系统中,终端是一种字符型设备,它有多种类型,通常使用tty来简称各种类型的终端设备。ttyTeletype的缩写,Teletype是最早出现的一种终端设备,很像电传打字机,是由Teletype公司生产的。Linux中包含如下几类终端设备:
1
、串行端口终端(/dev/ttySn
    串行端口终端(Serial Port Terminal)是使用计算机串行端口连接的终端设备。计算机把每个串行端口都看作是一个字符设备。这些串行端口所对应的设备名称是 /dev/ttyS0(或/dev/tts/0)、/dev/ttyS1(或/dev/tts/1等,设备号分别是4,0)、(4,1等。
   
在命令行上把标准输出重定向到端口对应的设备文件名上就可以通过该端口发送数据,例如,在命令行提示符下键入: echo test > /dev/ttyS1会把单词“test”发送到连接在ttyS1端口的设备上。
2.
伪终端(/dev/pty/
   
伪终端(Pseudo Terminal)是成对的逻辑终端设备,并存在成对的设备文件,如/dev/ptyp3/dev/ttyp3,它们与实际物理设备并不直接相关。如果一个程序把ttyp3看作是一个串行端口设备,则它对该端口的读/写操作会反映在该逻辑终端设备对应的ptyp3上,而ptyp3则是另一个程序用于读写操作的逻辑设备。这样,两个程序就可以通过这种逻辑设备进行互相交流,使用ttyp3的程序会认为自己正在与一个串行端口进行通信。
   
telnet 为例,如果某人在使用telnet程序连接到Linux系统,则telnet程序就可能会开始连接到设备ptyp2上,而此时一个getty程序会运行在对应的ttyp2端口上。当telnet从远端获取了一个字符时,该字符就会通过ptyp2ttyp2传递给 getty程序,而getty程序则会通过ttyp2ptyp2telnet程序返回“login:”字符串信息。这样,登录程序与telnet程序 就通过伪终端进行通信。通过使用适当的软件,可以把2个或多个伪终端设备连接到同一个物理串行端口上。
3.
控制台终端/dev/ttyn, /dev/console
   
如果当前进程有控制终端(Controlling Terminal)的话,那么/dev/tty就是当前进程的控制终端的设备特殊文件。可以使用命令ps –ax来查看进程与哪个控制终端相连使用命令tty可以查看它具体对应哪个实际终端设备。/dev/tty有些类似于到实际所使用终端设备的一个联接。
   
UNIX系统中,计算机显示器通常被称为控制台终端(Console)。它仿真了类型为Linux的一种终端(TERM=Linux),并且有一些设备特殊文件与之相关联:tty0tty1tty2等。当用户在控制台上登录时,使用的是tty1。使用Alt+[F1—F6]组合键时,我们就可以切换到tty2tty3等上面去。tty1–tty6等称为虚拟终端,而tty0则是当前所使用虚拟终端的一个别名,系统所产生的信息会发送到该终端上。因此不管当前正在使用哪个虚拟终端,系统信息都会发送到控制台终端上。用户可以登录到不同的虚拟终端上去,因而可以让系统同时有几个不同的会话期存在。只有系统或超级用户root可以向/dev/tty0进行写操作。
Linux 中,可以在系统启动命令行里指定当前的输出终端,格式如下:
console=device, options
device
指代的是终端设备,可以是tty0(前台的虚拟终端)、ttyX(第X个虚拟终端)、ttySX(第X个串口)、lp0(第一个并口)等。options指代对device进行的设置,它取决于具体的设备驱动。对于串口设备,参数用来定义为:波特率、校验位、位数,格式为BBBBPN,其中BBBB表示波特率,P表示校验(n/o/e),N表示位数,默认options9600n8
   
用户可以在内核命令行中同时设定多个终端,这样输出将会在所有的终端上显示,而当用户调用open()打开/dev/console时,最后一个终端将会返回作为当前值。例如:
console=ttyS1, 9600 console=tty0
定义了2个终端,而调用open()打开/dev/console时,将使用虚拟终端tty0。但是内核消息会在tty0 VGA虚拟终端和串口ttyS1上同时显示。
   
通过查看/proc/tty/drivers文件可以获知什么类型的tty设备存在以及什么驱动被加载到内核,这个文件包括一个当前存在的不同 tty 驱动的列表,包括驱动名、缺省的节点名、驱动的主编号、这个驱动使用的次编号范围,以及 tty 驱动的类型。例如,下面给出了一个/proc/tty/drivers文件的例子:
 
14.2
终端设备驱动结构
   
Linux内核中 tty的层次结构如图14.1所示,包含tty核心、tty线路规程和tty驱动tty 线路规程的工作是以特殊的方式格式化从一个用户或者硬件收到的数据,这种格式化常常采用一个协议转换的形式,例如 PPP Bluetoothtty设备发送数据的流程为:tty核心从一个用户获取将要发送给一个 tty设备的数据,tty核心将数据传递给tty线路规程驱动,接着数据被传递到tty驱动,tty驱动将数据转换为可以发送给硬件的格式。接收数据的流程为: 从tty硬件接收到的数据向上交给tty驱动,进入tty线路规程驱动,再进入 tty 核心,在这里它被一个用户获取。尽管大多数时候tty核心和tty之间的数据传输会经历tty线路规程的转换,但是tty驱动与tty核心之间也可以直接传输数据。
                
                           14.1 tty分层结构
    14.2显示了与tty相关的主要源文件及数据的流向。tty_io.c定义了tty 设备通用的file_operations结构体并实现了接口函数tty_register_driver()用于注册tty设备,它会利用 fs/char_dev.c提供的接口函数注册字符设备,与具体设备对应的tty驱动将实现tty_driver结构体中的成员函数。同时 tty_io.c也提供了tty_register_ldisc()接口函数用于注册线路规程,n_tty.c文件则实现了tty_disc结构体中的成员。
                 

14.2 tty主要源文件关系及数据流向

从图14.2可以看出,特定tty设备驱动的主体工作是填充tty_driver结构体中的成员,实现其中的成员函数,tty_driver结构体的定义如代码清单14.1
代码清单14.1 tty_driver结构体
1  struct tty_driver                                                            
2  {                                                                            
3    int magic;                                                                 
4    struct cdev cdev; /*
对应的字符设备cdev */                                                          
5    struct module *owner;   /*
这个驱动的模块拥有者 */                                                   
6    const char *driver_name;                                                   
7    const char *devfs_name;                                                    
8    const char *name;   /*
设备名 */                                                       
9    int name_base; /* offset of printed name */                    
10   int major; /*
主设备号 */                                                  
11   int minor_start; /*
开始次设备号 */                     
12   int minor_num; /*
设备数量 */                                              
13   int num; /*
被分配的设备数量 */                                            
14   short type; /* tty
驱动的类型 */                        
15   short subtype; /* tty
驱动的子类型 */             
16   struct termios init_termios; /*
初始线路设置 */             
17   int flags; /* tty
驱动标志 */                          
18   int refcount; /*
引用计数(针对可加载的tty驱动) */                   
19   struct proc_dir_entry *proc_entry; /* /proc
文件系统入口 */         
20   struct tty_driver *other; /*
仅对PTY驱动有意义 */          
21   ...                                                                        
22   /*
接口函数 */                                                             
23   int(*open)(struct tty_struct *tty, struct file *filp);      
24   void(*close)(struct tty_struct *tty, struct file *filp);     
25   int(*write)(struct tty_struct *tty, const unsigned char *buf, int count);  
26   void(*put_char)(struct tty_struct *tty, unsigned char ch);       
27   void(*flush_chars)(struct tty_struct *tty);                    
28   int(*write_room)(struct tty_struct *tty);                        
29   int(*chars_in_buffer)(struct tty_struct *tty);                  
30   int(*ioctl)(struct tty_struct *tty, struct file *file, unsigned int cmd,   
31     unsigned long arg);                                                      
32   void(*set_termios)(struct tty_struct *tty, struct termios *old);    
33   void(*throttle)(struct tty_struct *tty);                       
34   void(*unthrottle)(struct tty_struct *tty);                   
35   void(*stop)(struct tty_struct *tty);                            
36   void(*start)(struct tty_struct *tty);                     
37   void(*hangup)(struct tty_struct *tty);               
38   void(*break_ctl)(struct tty_struct *tty, int state);                   
39   void(*flush_buffer)(struct tty_struct *tty);                       
40   void(*set_ldisc)(struct tty_struct *tty);                     
41   void(*wait_until_sent)(struct tty_struct *tty, int timeout);        
42   void(*send_xchar)(struct tty_struct *tty, char ch);                  
43   int(*read_proc)(char *page, char **start, off_t off, int count, int *eof,  
44     void *data);                                                             
45   int(*write_proc)(struct file *file, const char __user *buffer, unsigned long
46     count, void *data);                                                      
47   int(*tiocmget)(struct tty_struct *tty, struct file *file);           
48   int(*tiocmset)(struct tty_struct *tty, struct file *file, unsigned int set,
49     unsigned int clear);                                                     
50                                                                              
51   struct list_head tty_drivers;                          
52 };   
    tty_driver
结构体中的magic表示给这个结构体的幻数,设为 TTY_DRIVER_MAGIC,在 alloc_tty_driver()函数中被初始化。namedriver_name的不同在于后者表示驱动的名字,用在 /proc/tty sysfs中,而前者表示驱动的设备节点名type subtype描述tty驱动的类型和子类型,subtype的值依赖于typetype成员的可能值为 TTY_DRIVER_TYPE_SYSTEM(由tty子系统内部使用,subtype 应当设为 SYSTEM_TYPE_TTYSYSTEM_TYEP_CONSOLESYSTEM_TYPE_SYSCONS SYSTEM_TYPE_SYSPTMX,这个类型不应当被任何常规tty驱动使用)、TTY_DRIVER_TYPE_CONSOLE(仅被控制台驱动使用)、TTY_DRIVER_TYPE_SERIAL(被任何串行类型驱动使用,subtype 应当设为 SERIAL_TYPE_NORMAL SERIAL_TYPE_CALLOUT)、TTY_DRIVER_TYPE_PTY(被伪控制台接口pty使用,此时subtype需要被设置为 PTY_TYPE_MASTER PTY_TYPE_SLAVE)。init_termios 为初始线路设置,为一个termios结构体,这个成员被用来提供一个线路设置集合。termios 用于保存当前的线路设置,这些线路设置控制当前波特率、数据大小、数据流控设置等,这个结构体包含tcflag_t c_iflag(输入模式标志)、tcflag_t c_oflag(输出模式标志)、tcflag_t c_cflag(控制模式标志)、tcflag_t c_lflag(本地模式标志)、cc_t c_line(线路规程类型)、cc_t c_cc[NCCS](一个控制字符数组)等成员。驱动会使用一个标准的数值集初始化这个成员,它拷贝自tty_std_termios变量,tty_std_termostty核心中的定义如代码清单14.2
代码清单14.2 tty_std_termios变量
1  struct termios tty_std_termios =
2  {
3   .c_iflag = ICRNL | IXON, /*
输入模式 */
4   .c_oflag = OPOST | ONLCR, /*
输出模式 */
5   .c_cflag = B38400 | CS8 | CREAD | HUPCL, /*
控制模式 */
6   .c_lflag = ISIG | ICANON | ECHO | ECHOE | ECHOK |
7   ECHOCTL | ECHOKE | IEXTEN,  /*
本地模式 */
8   .c_cc = INIT_C_CC  /*
控制字符,用来修改终端的特殊字符映射 */
9  };
     tty_driver
结构体中的majorminor_startminor_num表示主设备号、次设备号及可能的次设备数,name表示设备名(如ttyS),第 2349行的函数指针实际和tty_operations结构体等同,它们通常需在特定设备tty驱动模块初始化函数中被赋值。put_char()为单字节写函数,当单个字节被写入设备时这个函数被 tty 核心调用,如果一个 tty 驱动没有定义这个函数,将使用count参数为1write()函数。flush_chars()wait_until_sent()函数都用于刷新数据到硬件。write_room()指示有多少缓冲区空闲,chars_in_buffer()指示缓冲区中包含的数据数。当 ioctl(2)在设备节点上被调用时,ioctl()函数将被 tty核心调用。当设备的 termios 设置被改变时,set_termios()函数将被tty核心调用。throttle ()unthrottle()stop()start()为数据抑制函数,这些函数用来帮助控制 tty 核心的输入缓存。 tty 核心的输入缓冲满时,throttle()函数将被调用,tty驱动试图通知设备不应当发送字符给它。当 tty 核心的输入缓冲已被清空时,unthrottle()函数将被调用暗示设备可以接收数据。stop()start()函数非常像throttle() unthrottle()函数,但它们表示 tty 驱动应当停止发送数据给设备以及恢复发送数据。
    
tty驱动挂起 tty设备时,hangup()函数被调用,在此函数中进行相关的硬件操作。当tty 驱动要在 RS-232 端口上打开或关闭线路的 BREAK 状态时,break_ctl()线路中断控制函数被调用。如果state状态设为-1BREAK 状态打开,如果状态设为 0BREAK 状态关闭。如果这个函数由 tty 驱动实现,而tty核心将处理TCSBRKTCSBRKPTIOCSBRK TIOCCBRK这些ioctl命令。flush_buffer()函数用于刷新缓冲区并丢弃任何剩下的数据。set_ldisc()函数用于设置线路规程,当 tty 核心改变tty驱动的线路规程时这个函数被调用,这个函数通常不需要被驱动定义。send_xchar()X-类型字符发送函数,这个函数用来发送一个高优先级 XON 或者 XOFF 字符给 tty设备,要被发送的字符在第2个参数ch中指定。read_proc()write_proc()/proc 读和写函数。tiocmget()函数用于获得tty 设备的线路设置,对应的tiocmset()用于设置tty设备的线路设置,参数setclear包含了要设置或者清除的线路设置。
    Linux
内核提供了一组函数用于操作tty_driver结构体及tty设备,包括:
• 
分配tty驱动
struct tty_driver *alloc_tty_driver(int lines);
这个函数返回tty_driver指针,其参数为要分配的设备数量,line会被赋值给tty_drivernum成员,例如:
xxx_tty_driver = alloc_tty_driver(XXX_TTY_MINORS);
if (!xxx_tty_driver) //
分配失败
 return -ENOMEM; 
• 
注册tty驱动
int tty_register_driver(struct tty_driver *driver);
注册tty驱动成功时返回0,参数为由alloc_tty_driver ()分配的tty_driver结构体指针,例如:
retval = tty_register_driver(xxx_tty_driver);
if (retval) //
注册失败
{
  printk(KERN_ERR "failed to register tiny tty driver");
  put_tty_driver(xxx_tty_driver);
  return retval;
}
• 
注销tty驱动
int tty_unregister_driver(struct tty_driver *driver);
这个函数与tty_register_driver ()对应,tty驱动最终会调用上述函数注销tty_driver
• 
注册tty设备
void tty_register_device(struct tty_driver *driver, unsigned index,
    struct device *device);
仅有tty_driver是不够的,驱动必须依附于设备,tty_register_device()函数用于注册关联于tty_driver的设备,index为设备的索引(范围是0driver->num),如:
for (i = 0; i < XXX_TTY_MINORS; ++i)
tty_register_device(xxx_tty_driver, i, NULL);
• 
注销tty设备
void tty_unregister_device(struct tty_driver *driver, unsigned index);
上述函数与tty_register_device()对应,用于注销tty设备,其使用方法如:
for (i = 0; i < XXX_TTY_MINORS; ++i)
tty_unregister_device(xxx_tty_driver, i);
• 
设置tty驱动操作
void tty_set_operations(struct tty_driver *driver, struct tty_operations *op);
上述函数会将tty_operations结构体中的函数指针拷贝给tty_driver对应的函数指针,在具体的tty驱动中,通常会定义1个设备特定的 tty_operationstty_operations的定义如代码清单14.3tty_operations中的成员函数与 tty_driver中的同名成员函数意义完全一致,因此,这里不再赘述。
代码清单14.3 tty_operations结构体
struct tty_operations
2  {
3     int  (*open)(struct tty_struct * tty, struct file * filp);
4     void (*close)(struct tty_struct * tty, struct file * filp);
5     int  (*write)(struct tty_struct * tty,
6                   const unsigned char *buf, int count);
7     void (*put_char)(struct tty_struct *tty, unsigned char ch);
8     void (*flush_chars)(struct tty_struct *tty);
9     int  (*write_room)(struct tty_struct *tty);
10    int  (*chars_in_buffer)(struct tty_struct *tty);
11    int  (*ioctl)(struct tty_struct *tty, struct file * file,
12                unsigned int cmd, unsigned long arg);
13    void (*set_termios)(struct tty_struct *tty, struct termios * old);
14    void (*throttle)(struct tty_struct * tty);
15    void (*unthrottle)(struct tty_struct * tty);
16    void (*stop)(struct tty_struct *tty);
17    void (*start)(struct tty_struct *tty);
18    void (*hangup)(struct tty_struct *tty);
19    void (*break_ctl)(struct tty_struct *tty, int state);
20    void (*flush_buffer)(struct tty_struct *tty);
21    void (*set_ldisc)(struct tty_struct *tty);
22    void (*wait_until_sent)(struct tty_struct *tty, int timeout);
23    void (*send_xchar)(struct tty_struct *tty, char ch);
24    int (*read_proc)(char *page, char **start, off_t off,
25                      int count, int *eof, void *data);
26    int (*write_proc)(struct file *file, const char __user *buffer,
27                      unsigned long count, void *data);
28    int (*tiocmget)(struct tty_struct *tty, struct file *file);
29    int (*tiocmset)(struct tty_struct *tty, struct file *file,
30                         unsigned int set, unsigned int clear);
31 };
   
终端设备驱动都围绕tty_driver结构体而展开,一般而言,终端设备驱动应包含如下组成:
• 
终端设备驱动模块加载函数和卸载函数,完成注册和注销tty_driver,初始化和释放终端设备对应的tty_driver结构体成员及硬件资源。
• 
实现tty_operations结构体中的一系列成员函数,主要是实现open()close()write()tiocmget()tiocmset()等函数。


14.3
终端设备驱动初始化与释放
14.3.1
模块加载与卸载函数
    tty
驱动的模块加载函数中通常需要分配、初始化tty_driver结构体并申请必要的硬件资源,代码清单14.4tty驱动的模块卸载函数完成与模块加载函数完成相反的工作。
代码清单14.4 终端设备驱动模块加载函数范例
1  /* tty
驱动模块加载函数 */
2  static int __init xxx_init(void)
3  {
4    ...
5    /*
分配tty_driver结构体 */
6    xxx_tty_driver = alloc_tty_driver(XXX_PORTS);
7    /*
初始化tty_driver结构体 */
8    xxx_tty_driver->owner = THIS_MODULE;
9    xxx_tty_driver->devfs_name = "tts/";
10   xxx_tty_driver->name = "ttyS";
11   xxx_tty_driver->major = TTY_MAJOR;
12   xxx_tty_driver->minor_start = 64;
13   xxx_tty_driver->type = TTY_DRIVER_TYPE_SERIAL;
14   xxx_tty_driver->subtype = SERIAL_TYPE_NORMAL;
15   xxx_tty_driver->init_termios = tty_std_termios;
16   xxx_tty_driver->init_termios.c_cflag = B9600 | CS8 | CREAD | HUPCL | CLOCAL;
17   xxx_tty_driver->flags = TTY_DRIVER_REAL_RAW;
18   tty_set_operations(xxx_tty_driver, &xxx_ops);
19
20   ret = tty_register_driver(xxx_tty_driver);
21   if (ret)
22   {
23     printk(KERN_ERR "Couldn't register xxx serial driver\n");
24     put_tty_driver(xxx_tty_driver);
25     return ret;
26   }
27
28   ...
29   ret = request_irq(...); /*
硬件资源申请 */
30   ...
31 } 
14.3.2
打开与关闭函数
   
当用户对tty驱动所分配的设备节点进行open()系统调用时,tty_driver中的open()成员函数将被tty核心调用。tty 驱动必须设置open()成员,否则,-ENODEV将被返回给调用open()的用户。open()成员函数的第1个参数为一个指向分配给这个设备的 tty_struct 结构体的指针,第2个参数为文件指针。
tty_struct
结构体被 tty核心用来保存当前tty端口的状态,它的大多数成员只被 tty核心使用。tty_struct中的几个重要成员如下:
•  flags
标示tty 设备的当前状态,包括TTY_THROTTLEDTTY_IO_ERRORTTY_OTHER_CLOSEDTTY_EXCLUSIVE TTY_DEBUGTTY_DO_WRITE_WAKEUPTTY_PUSHTTY_CLOSINGTTY_DONT_FLIP TTY_HW_COOK_OUTTTY_HW_COOK_INTTY_PTY_LOCKTTY_NO_WRITE_SPLIT等。
•  ldisc
为给 tty 设备的线路规程。
•  write_wait
read_wait为给tty/读函数的等待队列,tty驱动应当在合适的时机唤醒对应的等待队列。
•  termios
为指向 tty 设备的当前 termios 设置的指针。
•  stopped:1
指示是否停止tty设备,tty 驱动可以设置这个值;hw_stopped:1指示是否tty设备已经被停止,tty 驱动可以设置这个值;flow_stopped:1指示是否 tty 设备数据流停止。
•  driver_data
disc_data为数据指针,用于存储tty驱动和线路规程的私有数据。
驱动中可以定义1个设备相关的结构体,并在open()函数中将其赋值给tty_structdriver_data成员,如代码清单14.5
代码清单14.5 tty驱动打开函数中赋值tty_structdriver_data成员
1  /*
设备私有数据结构体 */
2  struct xxx_tty
3  {
4    struct tty_struct *tty; /* tty_struct
指针 */
5    int open_count; /*
打开次数 */
6    struct semaphore sem; /*
结构体锁定信号量 */
7    int xmit_buf; /*
传输缓冲区 */
8    ...
9  }
10
11 /*
打开函数 */
12 static int xxx_open(struct tty_struct *tty, struct file *file)
13 {
14   struct xxx_tty *xxx;
15
16   /*
分配xxx_tty */
17   xxx = kmalloc(sizeof(*xxx), GFP_KERNEL);
18   if (!xxx)
19     return  - ENOMEM;
20   /*
初始化xxx_tty中的成员 */
21   init_MUTEX(&xxx->sem);
22   xxx->open_count = 0;
23   ...
24   /*
tty_struct中的driver_data指向xxx_tty */
25   tty->driver_data = xxx;
26   xxx->tty = tty;
27   ...
28   return 0;
29 }
   
在用户对前面使用 open()系统调用而创建的文件句柄进行close()系统调用时,tty_driver中的close()成员函数将被tty核心调用。


14.4
数据发送和接收
   
14.3给出了终端设备数据发送和接收过程中的数据流以及函数调用关系。用户在有数据发送给终端设备时,通过“write()系统调用――tty核心――线路规程的层层调用,最终调用tty_driver结构体中的write()函数完成发送
   
因为速度和tty硬件缓冲区容量的原因,不是所有的写程序要求的字符都可以在调用写函数时被发送,因此写函数应当返回能够发送给硬件的字节数以便用户程序检查是否所有的数据被真正写入。如果在 wirte()调用期间发生任何错误,一个负的错误码应当被返回。
                      
                        14.3 终端设备数据发送和接收过程中的数据流和函数调用关系
   
tty_driver write()函数接受3个参数tty_struct、发送数据指针及要发送的字节数,一般首先会通过tty_structdriver_data成员得到设备私有信息结构体,然后依次进行必要的硬件操作开始发送,代码清单14.6给出了tty_driverwrite()函数范例。
代码清单14.6 tty_driver结构体的write()成员函数范例
1  static int xxx_write(struct tty_struct *tty, const unsigned char *buf, int count)
2  {
3    /*
获得tty设备私有数据 */
4    struct xxx_tty *xxx = (struct xxx_tty*)tty->driver_data;
5    ...
6    /*
开始发送 */
7    while (1)
8    {
9      local_irq_save(flags);
10     c = min_t(int, count, min(SERIAL_XMIT_SIZE - xxx->xmit_cnt - 1,
11       SERIAL_XMIT_SIZE - xxx->xmit_head));

12     if (c <= 0)
13     {
14       local_irq_restore(flags);
15       break;
16     }
17     //
拷贝到发送缓冲区
18     memcpy(xxx->xmit_buf + xxx->xmit_head, buf, c);
19     xxx->xmit_head = (xxx->xmit_head + c) &(SERIAL_XMIT_SIZE - 1);
20     xxx->xmit_cnt += c;
21     local_irq_restore(flags);
22
23     buf += c;
24     count -= c;
25     total += c;
26   }
27
28   if (xxx->xmit_cnt && !tty->stopped && !tty->hw_stopped)
29   {
30     start_xmit(xxx);//
开始发送
31   }
32   return total; //
返回发送的字节数
33 }     
   
tty子系统自己需要发送数据到 tty 设备时,如果没有实现 put_char()函数,write()函数将被调用,此时传入的count参数为1,通过对代码清单14.7的分析即可获知。
代码清单14.7 put_char()函数的write()替代
1  int tty_register_driver(struct tty_driver *driver)
2  {
3    ...
4    if (!driver->put_char)//
没有定义put_char()函数
5      driver->put_char = tty_default_put_char;
6    ...
7  }
8  static void tty_default_put_char(struct tty_struct *tty, unsigned char ch)
9  {
10   tty->driver->write(tty, &ch, 1);//
调用tty_driver.write()函数
11 }
   
读者朋友们可能注意到了,tty_driver结构体中没有提供 read()函数。因为发送是用户主动的,而接收即用户调read()则是读一片缓冲区中已放好的数据。tty 核心在一个称为 struct tty_flip_buffer 的结构体中缓冲数据直到它被用户请求。因为tty核心提供了缓冲逻辑,因此每个 tty 驱动并非一定要实现它自身的缓冲逻辑。
    tty
驱动不必过于关心tty_flip_buffer 结构体的细节,如果其count字段大于或等于TTY_FLIPBUF_SIZE,这个flip缓冲区就需要被刷新到用户,刷新通过对 tty_flip_buffer_push()函数的调用来完成,代码清单代码清单14.8给出了范例。
代码清单14.8 tty_flip_buffer_push()范例
1 for (i = 0; i < data_size; ++i)
2 {
3   if (tty->flip.count >= TTY_FLIPBUF_SIZE)
4      tty_flip_buffer_push(tty);//
数据填满向上层
5   tty_insert_flip_char(tty, data[i], TTY_NORMAL);//
把数据插入缓冲区
6 }
7 tty_flip_buffer_push(tty);
   
tty 驱动接收到字符通过tty_insert_flip_char()函数被插入到flip缓冲区。该函数的第1个参数是数据应当保存入的 tty_struct结构体,第 2 个参数是要保存的字符,第3个参数是应当为这个字符设置的标志,如果字符是一个接收到的常规字符,则设为TTY_NORMAL,如果是一个特殊类型的指示错误的字符,依据具体的错误类型,应当设为TTY_BREAK TTY_PARITYTTY_OVERRUN


14.5 TTY
线路设置
14.5.1线路设置用户空间接口
 
用户可用如下2种方式改变tty设备的线路设置或者获取当前线路设置:
 1
、调用用户空间的termios库函数
     
用户空间的应用程序需引用termios.h头文件,该头文件包含了终端设备的I/O接口,实际是由POSIX定义的标准方法。对终端设备操作模式的描述由termios结构体完成,从代码清单14.2可以看出,这个结构体包含c_iflagc_oflagc_cflagc_lflagc_cc []几个成员。
    termios
c_cflag主要包含如下位域信息:CSIZE(字长)、CSTOPB2个停止位)、 PARENB(奇偶校验位使能)、PARODD (奇校验位,当PARENB被使能时)、 CREAD(字符接收使能,如果没有置位,仍然从端口接收字符,但这些字符都要被丢弃)、 CRTSCTS (如果被置位,使能CTS状态改变报告)、CLOCAL (如果没有置位,使能调制解调器状态改变报告)。
    termios
c_iflag主要包含如下位域信息:INPCK (使能帧和奇偶校验错误检查)、BRKINTbreak将清除终端输入/输出队列,向该终端上前台的程序发出SIGINT信号)、 PARMRK (奇偶校验和帧错误被标记,在INPCK被设置且IGNPAR未被设置的情况下才有意义)、IGNPAR (忽略奇偶校验和帧错误)、IGNBRK (忽略break)。
   
通过tcgetattr()tcsetattr()函数即可完成对终端设备的操作模式的设置和获取,这2个函数的原型如下:
int tcgetattr (int fd, struct termios *termios_p);
int tcsetattr (int fd, int optional_actions, struct termios *termios_p);
例如,Raw模式的线路设置为:
非正规模式
关闭回显
禁止 CR NL 的映射(ICRNL)、输入奇偶校验、输入第 8 位的截取(ISTRIP)以及输出流控制
8位字符(CS8),奇偶校验被禁止
禁止所有的输出处理
每次一个字节 (c_cc [VMIN] = 1c_cc [VTIME] = 0
则对应的对termios结构体的设置就为:
termios_p->c_iflag &= ~(IGNBRK | BRKINT | PARMRK | ISTRIP
                                   | INLCR | IGNCR | ICRNL | IXON);
termios_p->c_oflag &= ~OPOST;
termios_p->c_lflag &= ~(ECHO | ECHONL | ICANON | ISIG | IEXTEN);
termios_p->c_cflag &= ~(CSIZE | PARENB);
termios_p->c_cflag |= CS8;
通过如下一组函数可完成输入/输出波特率的获取和设置:
speed_t cfgetospeed (struct termios *termios_p); //
获得输出波特率
speed_t cfgetispeed (struct termios *termios_p); //
获得输入波特率

int cfsetospeed (struct termios *termios_p, speed_t speed); //设置输出波特率
int cfsetispeed (struct termios *termios_p, speed_t speed); //
设置输入波特率
如下一组函数则完成线路控制:
int tcdrain (int fd); //
等待所有输出都被发送
int tcflush (int fd, int queue_selector); //flush
输入/输出缓存
int tcflow (int fd, int action); //
对输入和输出流进行控制
int tcsendbreak (int fd, int duration);//
发送break
    tcflush
函数刷清(抛弃)输入缓存(终端驱动程序已接收到,但用户程序尚未读取)或输出缓存(用户程序已经写,但驱动尚未发送),queue参数可取TCIFLUSH(刷清输入队列)、TCOFLUSH(刷清输出队列)或TCIOFLUSH(刷清输入、输出队列)。
    tcflow()
对输入输出进行流控制,action参数可取TCOOFF(输出被挂起)、TCOON(重新启动以前被挂起的输出)、TCIOFF(发送1STOP字符,使终端设备暂停发送数据)、TCION(发送1START字符,使终端恢复发送数据)。
   tcsendbreak()
函数在一个指定的时间区间内发送连续的0二进位流。若duration参数为0,则此种发送延续0.25-0.5秒之间。POSIX.1说明若duration0,则发送时间依赖于实现。
2
、对tty设备节点进行ioctl()调用
    
大部分termios库函数会被转化为对tty设备节点的ioctl()调用,例如tcgetattr()tcsetattr()函数对应着TCGETSTCSETS IO控制命令。TIOCMGET (获得MODEM状态位)、TIOCMSET(设置MODEM状态位)、TIOCMBIC       (清除指示MODEM位)、TIOCMBIS(设置指示MODEM位)这4IO控制命令用于获取和设置MODEM握手,如RTSCTSDTR DSRRICD等。
14.5.2 tty
驱动set_termios函数
   
大部分 termios 用户空间函数被库转换为对驱动节点的 ioctl()调用,而tty ioctl中的大部分命令会被tty核心转换为对tty驱动的set_termios()函数的调用。set_termios()函数需要根据用户对 termios的设置(termios设置包括字长、奇偶校验位、停止位、波特率等)完成实际的硬件设置。
tty_operations
中的set_termios()函数原型为:
void(*set_termios)(struct tty_struct *tty, struct termios *old);
   
新的设置被保存在tty_struct中,旧的设置被保存在old参数中,若新旧参数相同,则什么都不需要做,对于被改变的设置,需完成硬件上的设置,代码清单14.9给出了set_termios()函数的例子。
代码清单14.9 tty驱动程序set_termios()函数范例
1  static void xxx_set_termios(struct tty_struct *tty, struct termios *old_termios)
2  {
3    struct xxx_tty *info = (struct cyclades_port*)tty->driver_data;
4    /*
新设置等同于老设置,什么也不做 */
5    if (tty->termios->c_cflag == old_termios->c_cflag)
6      return ;
7    ...

9    /*
关闭CRTSCTS硬件流控制 */
10   if ((old_termios->c_cflag &CRTSCTS) && !(cflag &CRTSCTS))
11   {
12     ...
13   }
14
15   /*
打开CRTSCTS硬件流控制 */
16   if (!(old_termios->c_cflag &CRTSCTS) && (cflag &CRTSCTS))
17   {
18     ...
19   }
20
21   /*
设置字节大小 */
22   switch (tty->termios->c_cflag &CSIZE)
23   {
24
25     case CS5:
26     ...
27     case CS6:
28     ...
29     case CS7:
30     ...
31     case CS8:
32     ...
33   }
34
35   /*
设置奇偶校验 */
36   if (tty->termios->c_cflag &PARENB)
37     if (tty->termios->c_cflag &PARODD)  //
奇校验
38     ...
39     else  //
偶校验
40     ...
41   else //
无校验
42   ...
43 }
14.5.3 tty
驱动 tiocmgettiocmset函数
TIOCMGET TIOCMSETTIOCMBICTIOCMBIS IO控制命令的调用将被tty核心转换为对tty驱动tiocmget()函数和tiocmset()函数的调用,TIOCMGET对应tiocmget ()函数,TIOCMSETTIOCMBICTIOCMBIS 对应tiocmset()函数,分别用于读取Modem控制的设置和进行Modem的设置。代码清单14.10给出了tiocmget()函数的范例,代 码清单14.11则给出了tiocmset()函数的范例。
代码清单14.10 tty驱动程序tiocmget()函数范例
1  static int xxx_tiocmget(struct tty_struct *tty, struct file *file)
2  {
3    struct xxx_tty *info = tty->driver_ data;
4    unsigned int result = 0;
5    unsigned int msr = info->msr;
6    unsigned int mcr = info->mcr;
7    result = ((mcr &MCR_DTR) ? TIOCM_DTR : 0) |  /* DTR
被设置 */
8    ((mcr &MCR_RTS) ? TIOCM_RTS : 0) |  /* RTS
被设置 */
9    ((mcr &MCR_LOOP) ? TIOCM_LOOP : 0) |  /* LOOP
被设置 */
10   ((msr &MSR_CTS) ? TIOCM_CTS : 0) |  /* CTS
被设置 */
11   ((msr &MSR_CD) ? TIOCM_CAR : 0) |  /* CD
被设置*/
12   ((msr &MSR_RI) ? TIOCM_RI : 0) |  /*
振铃指示被设置 */
13   ((msr &MSR_DSR) ? TIOCM_DSR : 0); /* DSR
被设置 */
14   return result;
15 }
代码清单14.11 tty驱动程序tiocmset()函数范例
1  static int xxx_tiocmset(struct tty_struct *tty, struct file *file, unsigned
2    int set, unsigned int clear)
3  {
4    struct xxx_tty *info = tty->driver_data;
5    unsigned int mcr = info->mcr;

7    if (set &TIOCM_RTS) /*
设置RTS */
8      mcr |= MCR_RTS;
9    if (set &TIOCM_DTR) /*
设置DTR */
10     mcr |= MCR_RTS;
11
12   if (clear &TIOCM_RTS) /*
清除RTS */
13     mcr &= ~MCR_RTS;
14   if (clear &TIOCM_DTR) /*
清除DTR */
15     mcr &= ~MCR_RTS;
16
17   /*
设置设备新的MCR */
18   tiny->mcr = mcr;
19   return 0;
20 }
tiocmget()
函数会访问MODEM状态寄存器(MSR),而tiocmset()函数会访问MODEM控制寄存器(MCR)。
14.5.3 tty
驱动ioctl函数
   
当用户在tty设备节点上进行ioctl(2) 调用时,tty_operations中的 ioctl()函数会被tty核心调用。如果 tty 驱动不知道如何处理传递给它的 ioctl 值,它返回 –ENOIOCTLCMD,之后tty 核心会执行一个通用的操作。
驱动中常见的需处理 的IO控制命令包括TIOCSERGETLSR(获得这个 tty 设备的线路状态寄存器LSR 的值)、TIOCGSERIAL(获得串口线信息)、TIOCMIWAIT(等待 MSR 改变)、TIOCGICOUNT(获得中断计数)等。代码清单14.12给出了tty驱动程序ioctl()函数的范例。
代码清单14.12 tty驱动程序ioctl()函数范例
1  static int xxx_ioctl(struct tty_struct *tty, struct file *filp, unsigned int
2    cmd, unsigned long arg)
3  {
4    struct xxx_tty *info = tty->driver_data;
5    ...
6    /*
处理各种命令 */
7    switch (cmd)
8    {
9      case TIOCGSERIAL:
10       ...
11     case TIOCSSERIAL:
12       ...
13     case TIOCSERCONFIG:
14       ...
15     case TIOCMIWAIT:
16     ...
17     case TIOCGICOUNT:
18     ...
19     case TIOCSERGETLSR:
20     ...
21   }
22   ...
23 }


14.6 UART
设备驱动
   
尽管一个特定的UART设备驱动完全可以遵循14.2~14.5的方法来设计,即定义tty_driver并实现其中的成员函数,但是Linux已经在文件 serial_core.c中实现了UART设备的通用tty驱动层(姑且称其为串口核心层),这样,UART驱动的主要任务演变成实现serial- core.c中定义的一组uart_xxx接口而非tty_xxx接口,如图14.5所示。
    serial_core.c
串口核心层完全可以被当作14.214.5tty设备驱动的实例,它实现了UART设备的tty驱动。
   
提示:Linux驱动的这种分层思想在许多类型的设备驱动中都得到了体现,例如上一章IDE设备驱动中,内核实现了通用的IDE层用于处理块设备I/O请求,而具体的IDE则只需使用ide_xxx这样的接口,甚至不必理会复杂的块设备驱动结构。
             
                       
14.5 串口核心层

串口核心层为串口设备驱动提供了如下3个结构体:
1
uart_driver
uart_driver
包含串口设备的驱动名、设备名、设备号等信息,它封装了tty_driver,使得底层的UART驱动无需关心tty_driver,其定义如代码清单14.13
代码清单14.13 uart_driver结构体
1  struct uart_driver
2  {
3    struct module *owner;
4    const char *driver_name; //
驱动名
5    const char *dev_name;    //
设备名
6    const char *devfs_name;  //
设备文件系统名
7    int major;  //
主设备号
8    int minor;   //
次设备号
9    int nr;
10   struct console *cons;
11
12   /*
私有的,底层驱动不应该访问这些成员,应该被初始化为NULL */
13   struct uart_state *state;
14   struct tty_driver *tty_driver;
15 };
一个tty驱动必须注册/注销tty_driver,而一个UART驱动则演变为注册/注销uart_driver,使用如下接口:
int uart_register_driver(struct uart_driver *drv);
void uart_unregister_driver(struct uart_driver *drv);
实际上,uart_register_driver()uart_unregister_driver()中分别包含了tty_register_driver()tty_unregister_driver()的操作,如代码清单14.14所示。
代码清单14.14 uart_register_driver()uart_unregister_driver()函数
1  int uart_register_driver(struct uart_driver *drv)
2  {
3   struct tty_driver *normal = NULL;
4   int i, retval;
5   ...
6    /*
分配tty_driver */
7   normal  = alloc_tty_driver(drv->nr);
8   if (!normal)
9    goto out;
10  drv->tty_driver = normal;
11   /*
初始化tty_driver */
12  normal->owner  = drv->owner;
13  normal->driver_name = drv->driver_name;
14  normal->devfs_name = drv->devfs_name;
15  normal->name  = drv->dev_name;
16  normal->major  = drv->major;
17  normal->minor_start = drv->minor;
18  normal->type  = TTY_DRIVER_TYPE_SERIAL;
19  normal->subtype  = SERIAL_TYPE_NORMAL;
20  normal->init_termios = tty_std_termios;
21  normal->init_termios.c_cflag = B9600 | CS8 | CREAD | HUPCL | CLOCAL;
22  normal->flags = TTY_DRIVER_REAL_RAW | TTY_DRIVER_NO_DEVFS;
23  normal->driver_state    = drv;
24  tty_set_operations(normal, &uart_ops);
25
26  ...
27  /*
注册tty驱动 */
28  retval = tty_register_driver(normal);
29  out:
30  if (retval < 0) {
31   put_tty_driver(normal);
32   kfree(drv->state);
33  }
34  return retval;
35 }
36
37 void uart_unregister_driver(struct uart_driver *drv)
38 {
39  struct tty_driver *p = drv->tty_driver;
40  tty_unregister_driver(p);  /*
注销tty驱动 */
41  put_tty_driver(p);
42  kfree(drv->state);
43  drv->tty_driver = NULL;
44 }
2
uart_port
uart_port
用于描述一个UART端口(直接对应于一个串口)的I/O端口或I/O内存地址、FIFO大小、端口类型等信息,其定义如代码清单14.15
代码清单14.15 uart_port结构体
1  struct uart_port
2  {
3    spinlock_t lock; /*
端口锁 */
4    unsigned int iobase; /* IO
端口基地址 */
5    unsigned char __iomem *membase; /* IO
内存基地址 */
6    unsigned int irq; /*
中断号 */
7    unsigned int uartclk; /* UART
时钟 */
8    unsigned char fifosize; /*
传输fifo大小 */
9    unsigned char x_char; /* xon/xoff
字符 */
10   unsigned char regshift; /*
寄存器位移 */
11   unsigned char iotype; /* IO
存取类型 */
12
13   #define UPIO_PORT  (0)  /* IO
端口*/
14   #define UPIO_HUB6  (1)
15   #define UPIO_MEM  (2)  /* IO
内存*/
16   #define UPIO_MEM32  (3)
17   #define UPIO_AU   (4)   /* Au1x00
类型IO */
18
19   unsigned int read_status_mask; /*
驱动相关的 */
20   unsigned int ignore_status_mask; /*
驱动相关的 */
21   struct uart_info *info; /*
指向parent信息 */
22   struct uart_icount icount; /*
计数 */
23
24   struct console *cons; /* console
结构体 */
25   #ifdef CONFIG_SERIAL_CORE_CONSOLE
26     unsigned long sysrq; /* sysrq
超时 */
27   #endif
28
29   upf_t flags;
30
31   #define UPF_FOURPORT  ((__force upf_t) (1 << 1))
32   #define UPF_SAK   ((__force upf_t) (1 << 2))
33   #define UPF_SPD_MASK  ((__force upf_t) (0x1030))
34   #define UPF_SPD_HI  ((__force upf_t) (0x0010))
35   #define UPF_SPD_VHI  ((__force upf_t) (0x0020))
36   #define UPF_SPD_CUST  ((__force upf_t) (0x0030))
37   #define UPF_SPD_SHI  ((__force upf_t) (0x1000))
38   #define UPF_SPD_WARP  ((__force upf_t) (0x1010))
39   #define UPF_SKIP_TEST  ((__force upf_t) (1 << 6))
40   #define UPF_AUTO_IRQ  ((__force upf_t) (1 << 7))
41   #define UPF_HARDPPS_CD  ((__force upf_t) (1 << 11))
42   #define UPF_LOW_LATENCY  ((__force upf_t) (1 << 13))
43   #define UPF_BUGGY_UART  ((__force upf_t) (1 << 14))
44   #define UPF_MAGIC_MULTIPLIER ((__force upf_t) (1 << 16))
45   #define UPF_CONS_FLOW  ((__force upf_t) (1 << 23))
46   #define UPF_SHARE_IRQ  ((__force upf_t) (1 << 24))
47   #define UPF_BOOT_AUTOCONF ((__force upf_t) (1 << 28))
48   #define UPF_IOREMAP  ((__force upf_t) (1 << 31))
49
50   #define UPF_CHANGE_MASK  ((__force upf_t) (0x17fff))
51   #define UPF_USR_MASK  ((__force upf_t)
52       (UPF_SPD_MASK|UPF_LOW_LATENCY))
53   unsigned int mctrl; /*
目前modem控制设置 */
54   unsigned int timeout; /*
基于字符的超时 */
55   unsigned int type; /*
端口类型 */
56   const struct uart_ops *ops; /* UART
操作集 */
57   unsigned int custom_divisor;
58   unsigned int line; /*
端口索引 */
59   unsigned long mapbase; /* ioremap
后基地址 */
60   struct device *dev; /* parent
设备 */
61   unsigned char hub6;
62   unsigned char unused[3];
63 };
串口核心层提供如下函数来添加1个端口:
int uart_add_one_port(struct uart_driver *drv, struct uart_port *port);
   
对上述函数的调用应该发生在uart_register_driver()之后,uart_add_one_port()的一个最重要作用是封装了tty_register_device()
    uart_add_one_port()
反函数uart_remove_one_port(),其中会调用tty_unregister_device(),原型为:
int uart_remove_one_port(struct uart_driver *drv, struct uart_port *port);
   
驱动中虽然不需要处理uart_portuart_info成员,但是在发送时,从用户来的数据被保存在xmit(被定义为circ_buf,即环形缓冲 区)中,因此UART驱动在发送数据时(一般在发送中断处理函数中),需要从这个circ_buf获取上层传递下来的字符。
3
uart_ops
     uart_ops
定义了针对UART的一系列操作,包括发送、接收及线路设置等,如果说tty_driver中的tty_operations对于串口还较为抽象,那么 uart_ops则直接面向了串口的UART,其定义如代码清单14.16Linux驱动的这种层次非常类似于面向对象编程中基类、派生类的关系,派生类针对特定的事物会更加具体,而基类则站在更高的抽象层次上。
代码清单14.16 uart_ops结构体
1  struct uart_ops
2  {
3    unsigned int(*tx_empty)(struct uart_port*);
4    void(*set_mctrl)(struct uart_port *, unsigned int mctrl);
5    unsigned int(*get_mctrl)(struct uart_port*);
6    void(*stop_tx)(struct uart_port*);    //
停止发送
7    void(*start_tx)(struct uart_port*);   //
开始发送
8    void(*send_xchar)(struct uart_port *, char ch); //
发送xchar
9    void(*stop_rx)(struct uart_port*);   //
停止接收
10   void(*enable_ms)(struct uart_port*);
11   void(*break_ctl)(struct uart_port *, int ctl);
12   int(*startup)(struct uart_port*);
13   void(*shutdown)(struct uart_port*);
14   void(*set_termios)(struct uart_port *, struct termios *new, struct termios
15     *old);        //
设置termios
16   void(*pm)(struct uart_port *, unsigned int state, unsigned int oldstate);
17   int(*set_wake)(struct uart_port *, unsigned int state);
18
19   /*
返回1个描述端口类型的字符串 */
20   const char *(*type)(struct uart_port*);
21
22   /*
释放端口使用的IO和内存资源,必要的情况下,应该进行iounmap操作 */
23   void(*release_port)(struct uart_port*);
24   /*
申请端口使用的IO和内存资源 */
25   int(*request_port)(struct uart_port*);
26  
27   void(*config_port)(struct uart_port *, int);
28   int(*verify_port)(struct uart_port *, struct serial_struct*);
29   int(*ioctl)(struct uart_port *, unsigned int, unsigned long);
30 };
    serial_core.c
中定义了tty_operations的实例,包含uart_open()uart_close()uart_write() uart_send_xchar()等成员函数(如代码清单14.17),这些函数会借助uart_ops结构体中的成员函数来完成具体的操作,代码清单 14.18给出了tty_operationsuart_send_xchar()成员函数利用uart_opsstart_tx() send_xchar()成员函数的例子。
代码清单14.17 串口核心层的tty_operations实例
1  static struct tty_operations uart_ops =
2  {
3   .open  = uart_open,//
串口打开
4   .close  = uart_close,//
串口关闭
5   .write  = uart_write,//
串口发送
6   .put_char = uart_put_char,//...
7   .flush_chars = uart_flush_chars,
8   .write_room = uart_write_room,
9   .chars_in_buffer= uart_chars_in_buffer,
10  .flush_buffer = uart_flush_buffer,
11  .ioctl  = uart_ioctl,
12  .throttle = uart_throttle,
13  .unthrottle = uart_unthrottle,
14  .send_xchar = uart_send_xchar,
15  .set_termios = uart_set_termios,
16  .stop  = uart_stop,
17  .start  = uart_start,
18  .hangup  = uart_hangup,
19  .break_ctl = uart_break_ctl,
20  .wait_until_sent= uart_wait_until_sent,
21 #ifdef CONFIG_PROC_FS
22  .read_proc = uart_read_proc, //proc
入口读函数
23 #endif
24  .tiocmget = uart_tiocmget,
25  .tiocmset = uart_tiocmset,
26 };
代码清单14.18 串口核心层的tty_operationsuart_ops关系
1  static void uart_send_xchar(struct tty_struct *tty, char ch)
2  {
3    struct uart_state *state = tty->driver_data;
4    struct uart_port *port = state->port;
5    unsigned long flags;
6    //
如果uart_ops中实现了send_xchar成员函数
7    if (port->ops->send_xchar)
8      port->ops->send_xchar(port, ch)
9    else //uart_ops
中未实现send_xchar成员函数
10   {
11     port->x_char = ch; //xchar
赋值
12     if (ch)
13     {
14       spin_lock_irqsave(&port->lock, flags);
15       port->ops->start_tx(port);  //
发送xchar
16       spin_unlock_irqrestore(&port->lock, flags);
17     }
18   }
19 }

注意整个调用流程为系统调用write()->uart_write()(tty_driver)->port->ops->start_tx();
 
在使用串口核心层这个通用串口tty驱动层的接口后,一个串口驱动要完成的主要工作将包括:
• 
定义uart_driveruart_opsuart_port等结构体的实例并在适当的地方根据具体硬件和驱动的情况初始化它们,当然具体设备 xxx的驱动可以将这些结构套在新定义的xxx_uart_driverxxx_uart_opsxxx_uart_port之内。
• 
在模块初始化时调用uart_register_driver()uart_add_one_port()以注册UART驱动并添加端口,在模块卸载时 调用uart_unregister_driver()uart_remove_one_port()以注销UART驱动并移除端口。
• 
根据具体硬件的datasheet实现uart_ops中的成员函数,这些函数的实现成为UART驱动的主体工作。

阅读(497) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~