Linux i2c 经典驱动模型 和必要的注释 （rtc驱动为例）

#include <linux/init.h>
#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/i2c.h>
#include <linux/input.h>
#include <linux/interrupt.h>
#include <linux/time.h>
#include <linux/types.h>
#include <linux/seq_file.h>
#include <linux/list.h>
#include <linux/proc_fs.h> 
#include <linux/delay.h>

#include <mach/mt_gpio.h>
#include <mach/mt_reg_base.h>
#include <mach/mt_typedefs.h>

#include <mach/board.h>
#include <mach/irqs.h>
#include <mach/eint.h>

#include <asm/uaccess.h>

#include <asm/io.h>
#include <linux/platform_device.h>
#include <linux/autoconf.h>
#include <linux/kobject.h>
#include <linux/earlysuspend.h>

#include <mach/upmu_common.h>
#include <linux/regulator/consumer.h>

#include <linux/types.h>
#include <mach/mt_typedefs.h>
#include <mach/mt_pm_ldo.h>

#include "rtc.h"
#include "cust_gpio_usage.h"

//定义设备名
#define RTC_NAME "rtc1"

//日期数据的长度

#define D_RTC_DATETIME_LENGTH 0x07

//闹钟数据的长度
#define D_RTC_DATETIME_ALARM_LENGTH 0x05

//i2c address 是A2>>1  0x51
#define D_RTC_DEVICE_ADDR 0x51 //0xA2
#define D_RTC_REGISTER_LENGTH 0x12

//RTC 寄存器宏定义

#define RTC_REG_CTRL_1 0x00
#define RTC_REG_CTRL_2 0x01 
#define RTC_REG_OFFSET 0x02
#define RTC_REG_RAM_BYTE 0x03
#define RTC_REG_SECONDS 0x04
#define RTC_REG_MINUTES 0x05
#define RTC_REG_HOURS 0x06
#define RTC_REG_DAYS 0x07
#define RTC_REG_WEEKDAYS 0x08
#define RTC_REG_MONTHS 0x09
#define RTC_REG_YEARS 0x0a
#define RTC_REG_SECOND_ALARM 0x0b
#define RTC_REG_MINUTE_ALARM 0x0c
#define RTC_REG_HOUR_ALARM 0x0d
#define RTC_REG_DAY_ALARM 0x0e
#define RTC_REG_WEEKDAYS_ALARM 0x0f
#define RTC_REG_TIMER_VALUE 0x10
#define RTC_REG_TIMER_MODE 0x11

 

static struct i2c_client *rtc_client = NULL;

// 16进制转成BCD码（4个二机制位表示一位10进制）
static void HexToBcd(uint8_t *cHex, uint8_t length);

//BCD码转成16进制码
static void BcdToHex(uint8_t *cBcd, uint8_t length);

 

//rtc 向寄存器reg中写writedata[]数据

//I2c 设备写函数

static int RTC_WriteByte(u8 reg, u8 *writedata)
{ 
// msleep(5);
u8 databuf[2] = {0};
int ret = 0;
databuf[0] = reg;
databuf[1] = *writedata;
// 向I2C设备发送数据
ret = i2c_master_send(rtc_client, databuf, 0x2);
if(ret < 0)
{
printk("rtc : rtc_i2c_write send data failed !\n");
return -1;
}

return ret;
}

//读寄存器reg的数据，保存到readdata[]

//12c 设备读函数，譬如要读取设备寄存器A里面的值，得先由主机向设备写A地址，然后从A中读取A里面的值，故有写读操作

static int RTC_ReadByte(u8 reg, u8 *readdata)
{