基于S3C2440的嵌入式Linux驱动——AT24C02(EEPROM I2C接口)驱动解读

本文将介绍Linux中AT24C02驱动。AT24C02是一种EEPROM，使用I2C接口来访问。

在开发板中，使用I2C控制器0和AT24C02连接，这里就不给出原理图了，如需要，可以搜索TQ2440开发板的原理图。

目标平台：TQ2440

CPU：s3c2440

内核版本：2.6.32

本文所有的代码均位于内核源码：linux/drivers/misc/eeprom/at24.c中。

staticint__initat24_init(void)

{

/*将io_limit向下圆整到最近的2的幂*/

io_limit=rounddown_pow_of_two(io_limit);

returni2c_add_driver(&at24_driver);/*i2c驱动注册*/

}

module_init(at24_init);

staticvoid__exitat24_exit(void)

{

i2c_del_driver(&at24_driver);

}

module_exit(at24_exit);

MODULE_DESCRIPTION("DriverformostI2CEEPROMs");

MODULE_AUTHOR("DavidBrownellandWolframSang");

MODULE_LICENSE("GPL");

注册函数很简单。io_limit为写入时允许一次写入的最大字节，该参数为驱动模块参数，可由用户设置，默认值为128字节。

首先对io_limit向下圆整到最近的2的幂，接着直接调用了i2c_add_driver来注册一个i2c驱动。

注销函数更简单。注销之前注册的i2c驱动。

熟悉I2C驱动架构的可能会知道I2C驱动的match函数，该函数将使用id表(struct i2c_device_id)和i2c设备（struct i2c_client）进行匹配，判断是否有name字段相同，如果相同则匹配完成，即可完成设备和驱动的绑定，接着便会调用驱动提供的probe方法。我们来看下驱动提供的id表。

staticstructi2c_driverat24_driver={

.driver={

.name="at24",

.owner=THIS_MODULE,

},

.probe=at24_probe,

.remove=__devexit_p(at24_remove),

.id_table=at24_ids,

};

驱动提供的id为at24_ids，如下：

staticconststructi2c_device_idat24_ids[]={

/*needs8addressesasA0-A2areignored*/

{"24c00",AT24_DEVICE_MAGIC(128/8,AT24_FLAG_TAKE8ADDR)},

/*oldvariantscan'tbehandledwiththisgenericentry!*/

{"24c01",AT24_DEVICE_MAGIC(1024/8,0)},

{"24c02",AT24_DEVICE_MAGIC(2048/8,0)},

/*spdisa24c02inmemoryDIMMs*/

{"spd",AT24_DEVICE_MAGIC(2048/8,

AT24_FLAG_READONLY|AT24_FLAG_IRUGO)},

{"24c04",AT24_DEVICE_MAGIC(4096/8,0)},

/*24rf08quirkishandledati2c-core*/

{"24c08",AT24_DEVICE_MAGIC(8192/8,0)},

{"24c16",AT24_DEVICE_MAGIC(16384/8,0)},

{"24c32",AT24_DEVICE_MAGIC(32768/8,AT24_FLAG_ADDR16)},

{"24c64",AT24_DEVICE_MAGIC(65536/8,AT24_FLAG_ADDR16)},

{"24c128",AT24_DEVICE_MAGIC(131072/8,AT24_FLAG_ADDR16)},

{"24c256",AT24_DEVICE_MAGIC(262144/8,AT24_FLAG_ADDR16)},

{"24c512",AT24_DEVICE_MAGIC(524288/8,AT24_FLAG_ADDR16)},

{"24c1024",AT24_DEVICE_MAGIC(1048576/8,AT24_FLAG_ADDR16)},

{"at24",0},

{/*ENDOFLIST*/}

};

结构体成员的第一个参数即为name，表示设备的名字。第二个参数，在该驱动中，为一个幻术（magic），通过AT24_DEVICE_MAGIC宏计算。

宏第一个参数为eeprom的大小，第二参数为一些标志位。我们看下这个宏：

#defineAT24_SIZE_BYTELEN5

#defineAT24_SIZE_FLAGS8

/*createnon-zeromagicvalueforgiveneepromparameters*/

#defineAT24_DEVICE_MAGIC(_len,_flags)

((1<

<

在这个表中，针对这里讲解的24c02，其大小为256字节，标志位为空。

当i2c总线完成设备驱动绑定后，就会调用probe方法了。具体看下这个函数。

staticintat24_probe(structi2c_client*client,conststructi2c_device_id*id)

{

structat24_platform_datachip;

boolwritable;

booluse_smbus=false;

structat24_data*at24;

interr;

unsignedi,num_addresses;

kernel_ulong_tmagic;

/*获取板级设备信息*/

if(client->dev.platform_data){

chip=*(structat24_platform_data*)client->dev.platform_data;

}else{

/*没有板级设备信息，也没有driver_data，直接出错*/

if(!id->driver_data){

err=-ENODEV;

gotoerr_out;

}

magic=id->driver_data;

chip.byte_len=BIT(magic&AT24_BITMASK(AT24_SIZE_BYTELEN));

magic>>=AT24_SIZE_BYTELEN;

chip.flags=magic&AT24_BITMASK(AT24_SIZE_FLAGS);

/*

*Thisisslow,butwecan'tknowalleeproms,sowebetter

*playsafe.Specifyingcustomeeprom-typesviaplatform_data

*isrecommendedanyhow.

*/

chip.page_size=1;

chip.setup=NULL;

chip.context=NULL;

}

/*检查参数，

byte_len和page_size必须为2的幂，不是则打印警告*/

if(!is_power_of_2(chip.byte_len))

dev_warn(&client->dev,

"byte_lenlookssuspicious(nopowerof2)!n");

if(!is_power_of_2(chip.page_size))

dev_warn(&client->dev,

"page_sizelookssuspicious(nopowerof2)!n");

/* Use I2C operations unless we're stuck with SMBus e