device_driver include/linux/device.h struct device_driver {
const char * name; /* 驱动名称 */
struct bus_type * bus; /* 总线类型 */
struct completion unloaded; /* 卸载事件通知机制 */ struct kobject kobj; /* sys 中的对象 */
struct klist klist_devices; /* 设备列表 */ struct klist_node knode_bus; /* 总线结点列表 */
struct module * owner;/* 所有者 */
/* 设备驱动通用方法 */
int (*probe) (struct device * dev); /* 探测设备 */ int (*remove) (struct device * dev); /* 移除设备 */ void (*shutdown) (struct device * dev); /* 关闭设备 */
/* 挂起设备 */
int (*suspend) (struct device * dev, pm_message_t state, u32 level); int (*resume) (struct device * dev, u32 level); /* 恢复 */
};
platform_device include/linux/device.h struct platform_device {
const char * name; /* 名称 */
u32 id; /* 设备编号, -1 表示不支持同类多个设备 */ struct device dev; /* 设备 */
u32 num_resources; /* 资源数 */ struct resource * resource; /* 资源列表 */
};
3. resource struct resource {
const char name; /*
资源名称 */
unsigned
long start, end; /* 开始位置和结束位置 */ unsigned long flags; /* 资源类型 */
/* 资源在资源树中的父亲,兄弟和孩子
*/ struct resource *parent, *sibling, *child;
};
4. device include/linux/device.h
struct device {
struct klist klist_children;
/* 在设备列表中的孩子列表 */ struct klist_node knode_parent; /* 兄弟结点 */
struct
klist_node knode_driver; /* 驱动结点 */ struct klist_node knode_bus; /* 总线结点 */ struct device parent; /* 父亲 */
struct kobject kobj; /* sys结点 */ char
bus_id[BUS_ID_SIZE];
struct semaphore
sem; /* 同步驱动的信号量 */
struct bus_type * bus; /* 总线类型 */
struct device_driver *driver; /* 设备驱动 */ void *driver_data;
/* 驱动的私有数据 */
void *platform_data; /* 平台指定的数据,为 device
核心驱动保留 */ void *firmware_data; /* 固件指定的数据,为 device
核心驱动保留 */ struct dev_pm_info
power; /* 设备电源管理信息 */
u64 *dma_mask; /* DMA掩码 */
u64 coherent_dma_mask;
struct
list_head dma_pools; /* DMA缓冲池 */
struct dma_coherent_mem *dma_mem; /* 连续 DMA 内存的起始位置
*/
void (*release)(struct device * dev); /*
释放设置方法 */
};
nand_hw_control
include/linux/mtd/nand.h struct nand_hw_control {
spinlock_t lock; /* 自旋锁,用于硬件控制 */ struct nand_chip *active; /* 正在处理 MTD 设备
*/ wait_queue_head_t wq; /* 等待队列 */
};
nand_chip
include/linux/mtd/nand.h struct nand_chip {
void iomem *IO_ADDR_R; /* 读地址 */ void iomem *IO_ADDR_W; /* 写地址 */
/* 字节操作 */
u_char (*read_byte)(struct mtd_info *mtd); /*
读一个字节 */
void (*write_byte)(struct mtd_info *mtd, u_char byte); /* 写一个字节 */
/*
双字节操作 */
u16 (*read_word)(struct mtd_info mtd); /* 读一个字 */
void (*write_word)(struct mtd_info *mtd, u16 word); /* 写一个字 */
/*
buffer 操作 */
void (*write_buf)(struct mtd_info *mtd, const u_char *buf, int len); void (*read_buf)(struct mtd_info
*mtd, u_char *buf, int len);
int (*verify_buf)(struct
mtd_info *mtd, const u_char
*buf, int len);
/*
选择一个操作芯片 */
void (*select_chip)(struct
mtd_info *mtd, int chip);
/*
坏块检查操作 */
int (*block_bad)(struct
mtd_info *mtd, loff_t ofs, int getchip);
/*
坏块标记操作 */
int (*block_markbad)(struct
mtd_info *mtd, loff_t ofs);
/*
硬件控制操作 */
void (*hwcontrol)(struct
mtd_info *mtd, int cmd);
/*
设备准备操作 */
int (*dev_ready)(struct
mtd_info *mtd);
/*
命令发送操作 */
void (*cmdfunc)(struct mtd_info *mtd, unsigned command, int column, int
page_addr);
/*
等待命令完成 */
int (*waitfunc)(struct mtd_info
*mtd, struct nand_chip
*this, int state);
/*
计算 ECC 码操作 */
int (*calculate_ecc)(struct
mtd_info *mtd, const u_char *dat,
u_char
*ecc_code);
/*
数据纠错操作 */
int (*correct_data)(struct mtd_info *mtd, u_char *dat, u_char *read_ecc,
u_char *calc_ecc);
/*
开启硬件 ECC */
void (*enable_hwecc)(struct
mtd_info *mtd, int mode);
/* 擦除操作 */
void (*erase_cmd)(struct
mtd_info *mtd, int page);
/* 检查坏块表 */
int (*scan_bbt)(struct
mtd_info *mtd);
int eccmode; /* ECC 模式 */
int eccsize; /* ECC 计算时使用的字节数 */
int eccbytes; /*
ECC 码的字节数 */
int eccsteps; /*
ECC 码计算的步骤数 */
int chip_delay;
/* 芯片的延迟时间 */ spinlock_t chip_lock; /*
芯片访问的自旋锁 */ wait_queue_head_t wq; /* 芯片访问的等待队列 */ nand_state_t state; /*
Nand Flash 状态 */
int page_shift; /* 页右移的位数,即 column
地址位数 */
int phys_erase_shift; /* 块右移的位数, 即 column 和页一共的地址位数 */ int bbt_erase_shift; /* 坏块页表的位数 */
int chip_shift; /* 该芯片总共的地址位数 */
u_char *data_buf; /*
数据缓冲区 */
u_char *oob_buf; /*
oob 缓冲区 */
int oobdirty; /*
oob 缓冲区是否需要重新初始化 */
u_char *data_poi; /* 数据缓冲区指针 */ unsigned int options; /*
芯片专有选项 */
int badblockpos;/* 坏块标示字节在 OOB 中的位置 */
int numchips; /* 芯片的个数 */
unsigned
long
chipsize;
/*
在多个芯片组中, 一个芯片的大小 */
int
pagemask;
/* 每个芯片页数的屏蔽字, 通过它取出每个芯片包含多少个页 */
int
pagebuf;
/*
在页缓冲区中的页号 */
struct nand_oobinfo *autooob; /* oob 信息 */ uint8_t *bbt; /* 坏块页表 */
struct nand_bbt_descr *bbt_td;
/* 坏块表描述 */
struct nand_bbt_descr *bbt_md; /*
坏块表镜像描述 */
struct nand_bbt_descr *badblock_pattern; /* 坏块检测模板 */
struct nand_hw_control *controller; /* 硬件控制 */
void *priv;
/* 私有数据结构 */
/*
进行附加错误检查 */
int (*errstat)(struct mtd_info *mtd, struct nand_chip *this, int state, int status, int page);
};
mtd_info include/linux/mtd/mtd.h struct mtd_info {
u_char type; /* 设备类型 */ u_int32_t flags; /* 设备标志位组 */ u_int32_t
size; /* 总共设备的大小 */ u_int32_t
erasesize; /* 擦除块的大小 */
u_int32_t
oobblock; /* OOB 块的大小,如：512 个字节有一个 OOB */ u_int32_t oobsize; /* OOB数据的大小,如:一个 OOB 块有 16 个字节
*/ u_int32_t ecctype; /* ECC 校验的类型 */
u_int32_t eccsize; /* ECC 码的大小 */
char
*name; /* 设备名称 */
int
index; /* 设备编号 */
/* oobinfo
信息,它可以通过 MEMSETOOBINFO ioctl 命令来设置 */ struct nand_oobinfo oobinfo;
u_int32_t
oobavail; /* OOB区的有效字节数,为文件系统提供 */
/* 数据擦除边界信息 */
int numeraseregions;
struct mtd_erase_region_info *eraseregions;
u_int32_t
bank_size; /* 保留 */
/*
擦除操作 */
int (*erase) (struct mtd_info *mtd,
struct erase_info *instr);
/* 指向某个执行代码位置 */
int (*point) (struct mtd_info *mtd,
loff_t from,
size_t len, size_t *retlen, u_char **mtdbuf);
/*
取消指向 */
void (*unpoint)
(struct mtd_info *mtd, u_char *
addr, loff_t from, size_t len);
/*
读/写操作 */
int (*read) (struct
mtd_info *mtd, loff_t
from, size_t len, size_t *retlen, u_char *buf); int (*write) (struct mtd_info
*mtd, loff_t to, size_t
len,
size_t *retlen, const u_char *buf);
/* 带 ECC 码的读/写操作 */
int
(*read_ecc) (struct mtd_info
*mtd, loff_t from, size_t len,
size_t *retlen, u_char *buf,
u_char *eccbuf, struct nand_oobinfo *oobsel);
int (*write_ecc) (struct mtd_info
*mtd, loff_t to, size_t len, size_t *retlen,
const u_char *buf, u_char *eccbuf, struct
nand_oobinfo *oobsel);
/* 带 OOB 码的读/写操作 */
int
(*read_oob) (struct mtd_info
*mtd, loff_t from, size_t len,
size_t *retlen, u_char *buf);
int
(*write_oob) (struct mtd_info
*mtd, loff_t to, size_t
len, size_t *retlen, const u_char *buf);
/* 提供访问保护寄存器区的方法 */
int (*get_fact_prot_info) (struct
mtd_info *mtd, struct
otp_info *buf, size_t
len); int (*read_fact_prot_reg) (struct
mtd_info *mtd, loff_t
from, size_t len,
size_t *retlen, u_char *buf);
int (*get_user_prot_info) (struct
mtd_info *mtd, struct
otp_info *buf, size_t
len); int (*read_user_prot_reg) (struct
mtd_info *mtd, loff_t
from, size_t len,
size_t *retlen, u_char *buf);
int (*write_user_prot_reg) (struct
mtd_info *mtd, loff_t from, size_t len,
size_t *retlen, u_char *buf);
int (*lock_user_prot_reg) (struct
mtd_info *mtd, loff_t from, size_t len);
/* 提供 readv
和 writev 方法 */
int
(*readv) (struct mtd_info
*mtd, struct kvec *vecs, unsigned long count, loff_t from, size_t *retlen);
int
(*readv_ecc) (struct mtd_info
*mtd, struct kvec *vecs, unsigned long count, loff_t from, size_t *retlen, u_char *eccbuf,
struct nand_oobinfo *oobsel);
int (*writev) (struct mtd_info *mtd, const struct kvec *vecs, unsigned long count, loff_t to, size_t *retlen);
int (*writev_ecc) (struct mtd_info
*mtd, const struct kvec *vecs,
unsigned long count, loff_t to, size_t *retlen, u_char *eccbuf, struct
nand_oobinfo *oobsel);
/*
同步操作 */
void (*sync) (struct mtd_info *mtd);
/* 芯片级支持的加/解锁操作 */
int (*lock) (struct mtd_info *mtd, loff_t ofs, size_t len);
int (*unlock) (struct mtd_info *mtd, loff_t ofs, size_t len);
/* 电源管理操作 */
int (*suspend) (struct mtd_info *mtd); void (*resume) (struct mtd_info *mtd);
/* 坏块管理操作 */
int (*block_isbad) (struct mtd_info *mtd, loff_t ofs); int (*block_markbad) (struct mtd_info *mtd, loff_t ofs);
/* 重启前的通知事件 */
struct
notifier_block reboot_notifier; void *priv; /* 私有数据结构 */
struct module
*owner; /* 模块所有者 */ int usecount; /* 使用次数 */
};
模型及几种扩展之二)
