Introduction to "serial device driver"     （My study note）

                                                                                                             膜拜大神的作品. 

                                                                                                             Standing on the shoulder of the gaints.

                                                                                                                            ——题记

用什么眼光去看待串口设备

            当谈到软件对于串口的抽象实现的时候，人们第一反应可能是设备/dev/ttyS0,这个众所周知的串行设备通信的接口文件(至少在PC端是这种). 因为/dev/ttyS0 是一个char类型的文件，于是一个串口设备通常被觉得是一个char driver 驱动着. 非常傻非常天真。不是这样滴~

              其实“char driver”的抽象并不能全然正确的对设备进行抽象描写叙述，    

because there is not specific major number associated to each of them. (这句话不是非常懂~)

                你能够写新的driver。不要尝试为串口设备加入新的major number (主设备号)

             当我们查看串口设备ttyS*   ( ‘ * ‘  通配符) ，我们会发现。这厮的major number都是4 有木有！

问题来了----什么让串口设备驱动和普通的字符设备驱动不同捏？

           Since a serial communication channel can be used to plug an alphanumeric terminal, a serial device driver must be integrated in the terminal emulator layer, called the ``tty‘‘ abstraction, from the name of ancient tele-type devices (still in wide use when Unix was being written)

俯瞰 tty 设备管理

              灵活有力的 tty handling 由几个模块组成。毕竟tty设备太多了，并且都非常重要。

上图给出了tty core 和 tty driver之间的关系

 大多数文件都是放置在 drivers/char 以下。假设不是。这里的文件夹就放在相关的根文件夹下咯   

下图给出了和串行设备管理的相关文件拓扑图

一些相关的数据结构

这里有三种和tty 管理相关的基本的数据结构 

• struct tty_struct 
• struct tty_driver: this is the low level hardware handling. At open time, the function get_tty_driver retrieves the driver for the current tty an places it into the driver field of tty_struct, where it is further accessed.

• struct tty_driver {
  	
  	    /* the driver states which range of devices it supports */
  	    short major;         /* major device number */
  	    short minor_start;   /* start of minor device number*/
  	    short   num;         /* number of devices */
  	
  	    /* and has its own operations */
  	    int  (*open)();
  	    void (*close)();
  	    int  (*write)();
  	    int  (*ioctl)();  /* device-specific control */
  	
  	    /* return information on buffer state */
  	    int  (*write_room)();      /* how much can be written */
  	    int  (*chars_in_buffer)(); /* how much is there to read */
  	
  	    /* flow control, input and output */
  	    void (*throttle)();
  	    void (*unthrottle)();
  	    void (*stop)();
  	    void (*start)();
  	
  	    /* and callbacks for /proc/tty/driver/ */
  	    int (*read_proc)();
  	    int (*write_proc)();
  	};

  
  
  
• struct tty_ldisc: the structure is referenced by the ldisc field of tty_struct. At open time the field is initialized to reference n_tty, and user programs can change the current line discipline via ioctl, as explained in a while.

• 	struct tty_ldisc {
  	
  	    /* routines called from above */
  	    int     (*open)();
  	    void    (*close)();
  	    ssize_t (*read)();
  	    ssize_t (*write)();
  	    int     (*ioctl)();
  	
  	    /* routines called from below */
  	    void    (*receive_buf)();
  	    int     (*receive_room)();
  	    void    (*write_wakeup)();
  	};
  	

  
  
  

                这些数据结构在三个不同的文件中面定义。  tty_struct 这个复杂的大家伙在 include/linux/tty.h 里面，相比另外两个结构体，事实上这个东东用的少~.

                 include/linux/tty_driver.h and include/linux/tty_ldisc.h 定义了另外两个结构体.   不像tty_struct,   tty_driver 和 tty_ldisc 都是module 作者经常使用的东东~

对于数据流的读写

           向串口写数据的时候。是非常直接的，中间没有buffer。可是从串口读数据就麻烦点了，并且这个时候中间是有buffer的。  数据被储存在buffer里面，知道用户空间的程序需求他们的时候，这个buffer里的数据就会传递到用户空间.

无论什么时候，当用户程序要从串口读数据的时候，这个时候buffer是空的，那么此时用户程序陷入休眠，直到buffer被填充。 

           注意到，write buffer 实际上也是存在的。仅仅是实现的非常直接，  由于write操作的每一步都由上一级驱动（注意图中的箭头是左边write操作是单向的。而右边read操作是双向的）。

           read buffer 是放在struct tty 里面的。因为是动态分配的。所以不存在内存的浪费.   

              实际上，tty相关的buffer被分做两级管理: kernel developers chose to provide both a ``conventional‘‘ buffer, where data is waiting to be eaten by the line discipline (i.e., in the default case, being transferred to user space), and a ``flip‘‘ buffer, used by hardware routines to store incoming data as quickly as possible, without the need to synchronize for concurrent access: flip buffers are exclusive ownership of the hardware device, which eventually calls tty_flip_buffer_push to deliver data to the tty buffer, where the line discipline pulls it from.

It‘s interesting to note that the flip buffer is laid out as two physical buffers that are alternatively written to. This allows more reliable operation, as the interrupt handler will always have a whole buffer available for writing. The function flush_to_ldisc, called by the low-level driver and part of the tty layer (i.e., tty_io.c), arranges for the flip buffer to be flipped, before the interrupt handler returns. This layout, by the way, is why the flip buffer is called so.

register_serial  扮演的角色

假设你注意到 drivers/char/serial.c  导出了一个叫 register_serial 的函数，你会琢磨这家伙在 tty 构架中扮演什么角色呢？ 

 其实，这个功能不过为了更便利easy的在执行时去加入标准的串口设备tty 驱动。