以前从未写过nand相关代码,也没了解过nand的工作方式,理解可能有所偏差,各位请不吝指正。
针对soc片上nand控制器而言,硬件初始化应该包含一下几个方面:
1、nand模块使用的时钟设置
2、既然接了一颗芯片,那么相关几个引脚需要初始化成支持nand的功能
3、nand控制寄存器的配置,例如中断、DMA模式等等
这是简单的一些想法,下面看看u-boot内的代码流程
一、流程分析
假设定义了nand驱动,上电时就会调用下面一段代码
...........
#if defined(CONFIG_CMD_NAND)
puts("NAND: ");
nand_init(); /* go init the NAND */
#endif
............
这段代码在文件\u-boot-sunxi-sunxi\arch\arm\lib\board.c内
可见想要使用nand驱动,得定义宏 CONFIG_CMD_NAND
调用了一个函数 nand_init(),在文件\u-boot-sunxi-sunxi\drivers\mtd\nand\nand.c内:
void nand_init(void)这个函数用了一个宏CONFIG_SYS_MAX_NAND_DEVICE,很明显,表示板子上有几颗nand芯片,
cubieboard当然是一颗,这个宏需要自己定义,值为1
一般来说,这个函数都将调用nand_init_chip(),在来看看这个函数,也在这个文件内:
static void nand_init_chip(int i)
{
struct mtd_info *mtd = &nand_info[i];
struct nand_chip *nand = &nand_chip[i];
ulong base_addr = base_address[i];
int maxchips = CONFIG_SYS_NAND_MAX_CHIPS;
if (maxchips < 1) // 防止错误的数据
maxchips = 1;
mtd->priv = nand;
nand->IO_ADDR_R = nand->IO_ADDR_W = (void __iomem *)base_addr;
if (board_nand_init(nand)) // 硬件初始化
return;
if (nand_scan(mtd, maxchips)) // 接口函数初始化
return;
nand_register(i); //设备注册
}
这个函数调用了三个函数,完成初始化工作
board_nand_init()函数就是跟板子相关的初始化,就是自己需要实现的代码。
nand_scan()函数,我的理解就是接口的初始化,就是将MTD模块使用的部分函数初始化到用户自己实现的代码上
nand_register()注册驱动,这个代码不需要用户实现
这里有一个代码细节
mtd->priv = nand;
mtd模块的私有数据就是nand这个结构体,初始化时实现nand结构体的初始化就能把操作传递到mtd层去了
这个后面在分析一下。
再来看看这三个函数,board_nand_init()不存在,就是需要用户自己实现
例如,在\u-boot-sunxi-sunxi\drivers\mtd\nand\创建自己的驱动代码文件sunxi_nand.c
里面就需要定义这个函数
int board_nand_init(struct nand_chip *nand)
这个函数有两部分:
1、就是开始提到的三个方面
nand模块使用的时钟设置
相关几个引脚需要初始化成支持nand的功能
nand控制寄存器的配置,例如中断、DMA模式等等
2、相关结构体数据的初始化sunxi_nand.c内还需要实现其他部分代码,这个要根据实际的CPU来确定
到这里就需要说说编程模式了,nand驱动的编写也是采用面向对象的方式,而board_nand_init的作用就是将一个nand类实例化
这里操作了一个结构体
struct nand_chip {
void __iomem *IO_ADDR_R;
void __iomem *IO_ADDR_W;
uint8_t (*read_byte)(struct mtd_info *mtd);
u16 (*read_word)(struct mtd_info *mtd);
void (*write_buf)(struct mtd_info *mtd, const uint8_t *buf, int len);
void (*read_buf)(struct mtd_info *mtd, uint8_t *buf, int len);
int (*verify_buf)(struct mtd_info *mtd, const uint8_t *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 (*cmd_ctrl)(struct mtd_info *mtd, int dat, unsigned int ctrl);
int (*init_size)(struct mtd_info *mtd, struct nand_chip *this,
u8 *id_data);
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);
void (*erase_cmd)(struct mtd_info *mtd, int page);
int (*scan_bbt)(struct mtd_info *mtd);
int (*errstat)(struct mtd_info *mtd, struct nand_chip *this, int state,
int status, int page);
int (*write_page)(struct mtd_info *mtd, struct nand_chip *chip,
const uint8_t *buf, int page, int cached, int raw);
int chip_delay;
unsigned int options;
int page_shift;
int phys_erase_shift;
int bbt_erase_shift;
int chip_shift;
int numchips;
uint64_t chipsize;
int pagemask;
int pagebuf;
int subpagesize;
uint8_t cellinfo;
int badblockpos;
int badblockbits;
int onfi_version;
#ifdef CONFIG_SYS_NAND_ONFI_DETECTION
struct nand_onfi_params onfi_params;
#endif
int state;
uint8_t *oob_poi;
struct nand_hw_control *controller;
struct nand_ecclayout *ecclayout;
struct nand_ecc_ctrl ecc;
struct nand_buffers *buffers;
struct nand_hw_control hwcontrol;
struct mtd_oob_ops ops;
uint8_t *bbt;
struct nand_bbt_descr *bbt_td;
struct nand_bbt_descr *bbt_md;
struct nand_bbt_descr *badblock_pattern;
void *priv;
};
这个结构体就是一个“类”,所有的nand都可以这样实现,用户只要实现其中的一些“方法”就可以了
这些“方法“都已经有了默认的实现,在文件\u-boot-sunxi-sunxi\drivers\mtd\nand\nand_base.c内都已经写好了
例如比较老的芯片s3c2440,s3c6410都可以直接使用这些库函数,不需要在另外写,很遗憾,cubieboard的A10不在此列。
针对A10,在board_nand_init函数内,如下初始化是必要的:
......
/* initialize nand_chip data structure */
nand->IO_ADDR_R = (void *)&nand_reg->io_data; // 读写寄存器,这个初始化还需要斟酌,没有资料就是苦B啊
nand->IO_ADDR_W = (void *)&nand_reg->io_data;
nand->select_chip = sunxi_select_chip; // 片选函数,任何一款CPU都要实现这个功能
/* hwcontrol always must be implemented */
nand->dev_ready = sunxi_dev_ready; // 读取芯片就绪状态
nand->cmdfunc = sunxi_nand_command; //命令操作函数,有了这个就不需要 nand->cmd_ctrl 啦
#ifdef CONFIG_SUNXI_NAND_HWECC
nand->ecc.hwctl = sunxi_nand_enable_hwecc; //这些差错控制都没实现,先留下接口,等进一步改进,使用默认的实现
nand->ecc.calculate = sunxi_nand_calculate_ecc;
nand->ecc.correct = sunxi_nand_correct_data;
nand->ecc.mode = NAND_ECC_HW;
nand->ecc.size = CONFIG_SYS_NAND_ECCSIZE;
nand->ecc.bytes = CONFIG_SYS_NAND_ECCBYTES;
#else
nand->ecc.mode = NAND_ECC_SOFT;
#endif
#ifdef CONFIG_SUNXI_NAND_BBT
nand->options = NAND_USE_FLASH_BBT;
#else
nand->options = 0; /* 8bit */ // flash的操作位宽,看看芯片资料8位的
#endif
nand->priv = nand_cs + chip_n++; // 这个相当于是C++的私有数据了,我存了芯片的编号,只有一片nand,就是0
....
这里nand指针就是前面说的细节
mtd->priv = nand;
这是后相当部分mtd内容也已经初始化了。
再来看看nand_scan()函数,\u-boot-sunxi-sunxi\drivers\mtd\nand\nand_base.c内
int nand_scan(struct mtd_info *mtd, int maxchips)
{
int ret;
ret = nand_scan_ident(mtd, maxchips, NULL);
if (!ret)
ret = nand_scan_tail(mtd);
return ret;
}
这个函数的调用关系分析下去,可以看出,根据前面的初始化,读取nand的信息,就是id,厂商,名字,页大小,容量等等;
初始化用户未实现的部分,这些代码使用如下形式,举例如下:
/* check for proper chip_delay setup, set 20us if not */
if (!chip->chip_delay)
chip->chip_delay = 20; //如果没有定义芯片延时,则默认20ns,这个值要看具体的芯片手册了
/* check, if a user supplied command function given */
if (chip->cmdfunc == NULL)
chip->cmdfunc = nand_command; // 如果没有实现chip->cmdfunc,那么使用默认的命令操作函数
// 而默认的不合适A10,board_nand_init函数定义了nand->cmdfunc = sunxi_nand_command
// 所以这个不会被再次初始化
/* check, if a user supplied wait function given */
if (chip->waitfunc == NULL)
chip->waitfunc = nand_wait; //这个没有被定义,将使用默认函数nand_wait
诸如此类的一大堆调用,当然,用户也可以完全将所有函数都自己实现一遍,但如果有合适的就没有必要啦,站在别人肩膀上,才能看得更远
二、总结
通过分析,假设自己需要实现初始化工作,从代码角度来看,需要实现一下几项:
1、定义相关的宏,例如
CONFIG_CMD_NAND
CONFIG_SYS_MAX_NAND_DEVICE
这不是全部宏,请参考其他芯片定义,如s3c2440
2、实现自己的int board_nand_init(struct nand_chip *nand)函数
这个函数内初始化cpu的寄存器,IO脚功能,设置模块时钟
设置用户自己的硬件操作函数
片选操作、命令操作或硬件控制操作、芯片就绪等等,具体情况根据不同CPU而不同
有的芯片还要自己实现读写操作。
3、没有详细CPU用户手册情况下,写驱动就是一苦B事