MTD 設備驅動 和 NAND Flash 驅動程序分析

硬件環境： 飛凌OK6410，256MB DDR，2GB NAND Flash、   NAND Flash 型號：K9G8G08U9A   、     分析源碼：Linux 2.6.36.2 內核源碼。

一、 MTD 設備驅動。

1、先來簡單介紹一下MTD

在Linux 系統中， 提供了MTD（Memory Technology Device , 內存技術設備）系統來建立 Flash 針對 Linux 的系統、抽象的接口， MTD 將文件系統 與 底層的Flash

存儲器進行了隔離， 使 Flash 驅動工程師 無需關心Flash 作為字符設備和 塊 設備與 LInux內核的接口。

2、在引入MTD 後Linux 系統中的Flash  設備及接口可分為4層, 從上到下依次是：設備節點、MTD 設備層、MTD原始設備層 和 硬件驅動層。  這 4 層的作用定義如下：

1-> 硬件驅動層： Flash 硬件驅動層負責 Flash 硬件設備的讀、寫、擦除， LInux MTD 設備的 NOR Flash 芯片驅動位於 drivers/mtd/chips 子目錄下，  NAND Flash

的驅動程序則 位於 drivers/mtd/nand 子目錄下。

2->MTD 原始設備層： MTD原始設備層由兩部分組成， 一部分是MTD 原始設備的通用代碼， 另一部分是各個特定 Flash 的數據，例如分區。

3->MTD設備層： 基於MTD 原始設備，Linux 系統可以定義出 MTD 的塊設備的結構(主設備號 31) 和 字符設備 （設備號 90） ，構成MTD 設備層， MTD 字符設備定義

在mtdchar.c 中實現，MTD 塊設備則是定義在一個描述MTD 塊設備的結構 mtdblk_dev ，並聲明了一個名為 mtdblks 的指針數組，這個數組 中的每個mtdblk_dev

和 mtd_table 中的每一個mtd_info 一一對應。

4->設備節點： 通過mknod 在/dev 子目錄下建立MTD字符設備節點 和 塊設備節點，用戶通過訪問此此設備節點即可訪問 MTD 字符設備和塊設備。

3、分析Linux MTD 系統接口 mtd_info 結構體代碼分析  此結構體定義在 ./include/linux/mtd/mtd.h 中

關鍵詞詞解析：

XIP ：XIP eXecute In Place，即芯片內執行，指應用程序可以直接在flash閃存內運行，不必再把代碼讀到系統RAM中。flash內執行

是指nor flash 不需要初始化，可以直接在flash內執行代碼。但往往只執行部分代碼，比如初始化RAM.

OOB ：Out Of Brower 傳輸層協議使用帶外數據(out-of-band,OOB)來發送一些重要的數據,如果通信一方有重要的數據需要通知對方時,協議能夠將這些數據

快速地發送到對方.為了發送這些數據

iovec-base : iovec 結構體基礎。struct iovec定義了一個向量元素。通常，這個結構用作一個多元素的數組。對於每一個傳輸的元素，指針成員iov_base指向

一個緩沖區，這個緩沖區是存放的是readv所接收的數據或是writev將要發送的數據。成員iov_len在各種情況下分別確定了接收的最大長度以及實際寫入的長度。

Sync : 函數，　函數說明：此函數負責將系統緩沖區的內容寫回磁盤，以確保數據同步。

1. struct mtd_info {  
2.     u_char type;     // 內存技術的類型   
3.     uint32_t flags;  // 標志位   
4.     uint64_t size;   // Total size of the MTD 、mtd 設備的大小   
5.   
6.     /* "Major" erase size for the device. Na茂ve users may take this 
7.      * to be the only erase size available, or may use the more detailed 
8.      * information below if they desire 
9.      */  
10.     uint32_t erasesize;    // 主要的擦除塊大小 erase size of main block   
11.     /* Minimal writable flash unit size. In case of NOR flash it is 1 (even 
12.      * though individual bits can be cleared), in case of NAND flash it is 
13.      * one NAND page (or half, or one-fourths of it), in case of ECC-ed NOR 
14.      * it is of ECC block size, etc. It is illegal to have writesize = 0. 
15.      * Any driver registering a struct mtd_info must ensure a writesize of 
16.      * 1 or larger. 
17.      */  
18.     uint32_t writesize;           // 最小的可寫單元的字節數   
19.   
20.     uint32_t oobsize;   // Amount of OOB data per block (e.g. 16) OOB 字節數   
21.     uint32_t oobavail;  // Available OOB bytes per block   可用OBB 字節數   
22.   
23.     /* 
24.      * If erasesize is a power of 2 then the shift is stored in 
25.      * erasesize_shift otherwise erasesize_shift is zero. Ditto writesize. 
26.      */  
27.     unsigned int erasesize_shift;  
28.     unsigned int writesize_shift;  
29.     /* Masks based on erasesize_shift and writesize_shift */  
30.     unsigned int erasesize_mask;  
31.     unsigned int writesize_mask;  
32.   
33.     // Kernel-only stuff starts here.   
34.     const char *name;  
35.     int index;  
36.   
37.     /* ecc layout structure pointer - read only ! */  
38.     struct nand_ecclayout *ecclayout;  // ECC 布局結構體指針   
39.   
40.     /* Data for variable erase regions. If numeraseregions is zero, 
41.      * it means that the whole device has erasesize as given above. 
42.      */   
43.     int numeraseregions;              // 不同的erasesize 的區域   數目通常是1   
44.     struct mtd_erase_region_info *eraseregions;  
45.   
46.     /* 
47.      * Erase is an asynchronous operation.  Device drivers are supposed 
48.      * to call instr->callback() whenever the operation completes, even 
49.      * if it completes with a failure. 
50.      * Callers are supposed to pass a callback function and wait for it 
51.      * to be called before writing to the block. 
52.      */  
53.     int (*erase) (struct mtd_info *mtd, struct erase_info *instr);  
54.   
55.     /* This stuff for eXecute-In-Place */  
56.     /* phys is optional and may be set to NULL */  
57.     int (*point) (struct mtd_info *mtd, loff_t from, size_t len,            // 針對 eXecute-In- Place   
58.             size_t *retlen, void **virt, resource_size_t *phys);  
59.   
60.     /* We probably shouldn't allow XIP if the unpoint isn't a NULL */  
61.     void (*unpoint) (struct mtd_info *mtd, loff_t from, size_t len);        // 如果unpoint 為空，不允許 XIP   
62.   
63.     /* Allow NOMMU mmap() to directly map the device (if not NULL) 
64.      * - return the address to which the offset maps 
65.      * - return -ENOSYS to indicate refusal to do the mapping 
66.      */  
67.     unsigned long (*get_unmapped_area) (struct mtd_info *mtd,  
68.                         unsigned long len,  
69.                         unsigned long offset,  
70.                         unsigned long flags);  
71.   
72.     /* Backing device capabilities for this device 
73.      * - provides mmap capabilities 
74.      */  
75.     struct backing_dev_info *backing_dev_info;  
76.   
77.   
78.     int (*read) (struct mtd_info *mtd, loff_t from, size_t len, size_t *retlen, u_char *buf);        // 讀 flash   
79.     int (*write) (struct mtd_info *mtd, loff_t to, size_t len, size_t *retlen, const u_char *buf);   // 寫 flash   
80.   
81.     /* In blackbox flight recorder like scenarios we want to make successful 
82.        writes in interrupt context. panic_write() is only intended to be 
83.        called when its known the kernel is about to panic and we need the 
84.        write to succeed. Since the kernel is not going to be running for much 
85.        longer, this function can break locks and delay to ensure the write 
86.        succeeds (but not sleep). */  
87.   
88.     int (*panic_write) (struct mtd_info *mtd, loff_t to, size_t len, size_t *retlen, const u_char *buf);   // Kernel panic 時序讀寫   
89.   
90.     int (*read_oob) (struct mtd_info *mtd, loff_t from,           // 讀 out-of-band   
91.              struct mtd_oob_ops *ops);  
92.     int (*write_oob) (struct mtd_info *mtd, loff_t to,            // 寫 out-of-band   
93.              struct mtd_oob_ops *ops);  
94.   
95.     /* 
96.      * Methods to access the protection register area, present in some 
97.      * flash devices. The user data is one time programmable but the 
98.      * factory data is read only. 
99.      */  
100.     int (*get_fact_prot_info) (struct mtd_info *mtd, struct otp_info *buf, size_t len);  
101.     int (*read_fact_prot_reg) (struct mtd_info *mtd, loff_t from, size_t len, size_t *retlen, u_char *buf);  
102.     int (*get_user_prot_info) (struct mtd_info *mtd, struct otp_info *buf, size_t len);  
103.     int (*read_user_prot_reg) (struct mtd_info *mtd, loff_t from, size_t len, size_t *retlen, u_char *buf);  
104.     int (*write_user_prot_reg) (struct mtd_info *mtd, loff_t from, size_t len, size_t *retlen, u_char *buf);  
105.     int (*lock_user_prot_reg) (struct mtd_info *mtd, loff_t from, size_t len);  
106.   
107.     /* kvec-based read/write methods. 
108.        NB: The 'count' parameter is the number of _vectors_, each of 
109.        which contains an (ofs, len) tuple. 
110.     */  
111.     int (*writev) (struct mtd_info *mtd, const struct kvec *vecs, unsigned long count, loff_t to, size_t *retlen); // iovec-based 讀寫函數   
112.   
113.     /* Sync */    
114.     void (*sync) (struct mtd_info *mtd);                             // Sync    
115.   
116.     /* Chip-supported device locking */  
117.     int (*lock) (struct mtd_info *mtd, loff_t ofs, uint64_t len);    // 設備鎖   
118.     int (*unlock) (struct mtd_info *mtd, loff_t ofs, uint64_t len);  
119.     int (*is_locked) (struct mtd_info *mtd, loff_t ofs, uint64_t len);  
120.   
121.     /* Power Management functions */   
122.     int (*suspend) (struct mtd_info *mtd);                          // 電源管理函數   
123.     void (*resume) (struct mtd_info *mtd);  
124.   
125.     /* Bad block management functions */  
126.     int (*block_isbad) (struct mtd_info *mtd, loff_t ofs);          // 壞塊管理函數   
127.     int (*block_markbad) (struct mtd_info *mtd, loff_t ofs);  
128.   
129.     struct notifier_block reboot_notifier;  /* default mode before reboot */  
130.   
131.     /* ECC status information */  
132.     struct mtd_ecc_stats ecc_stats;  
133.     /* Subpage shift (NAND) */  
134.     int subpage_sft;  
135.   
136.     void *priv;                                                   // 私有函數   
137.   
138.     struct module *owner;  
139.     struct device dev;  
140.     int usecount;  
141.   
142.     /* If the driver is something smart, like UBI, it may need to maintain 
143.      * its own reference counting. The below functions are only for driver. 
144.      * The driver may register its callbacks. These callbacks are not 
145.      * supposed to be called by MTD users */  
146.     int (*get_device) (struct mtd_info *mtd);  
147.     void (*put_device) (struct mtd_info *mtd);  
148. };  

mtd_info 中的 read(). write(). read_oob(). write_oob(). erase() 是 MTD 設備驅動主要實現的函數。在在後面我將要介紹的nand flahs 驅動中幾乎看不到mtd_info

 的成員函數（也就是說這些函數對於Flash 芯片來說是透明的），這是因為在Linux MTD 下層實現了針對 NOR、NAND Flsh 的同游mtd_info 成員函數。

Flash 驅動中使用如下兩個函數來注冊 和注銷MTD 設備：

int add_mtd_device(struct mtd_info *mtd);

int del_mtd_device (struct mtd_info *mtd)