i2c-old.h
上传用户:lgb322
上传日期:2013-02-24
资源大小:30529k
文件大小:6k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. #ifndef I2C_H
  2. #define I2C_H
  3. /*
  4.  * linux i2c interface.  Works a little bit like the scsi subsystem.
  5.  * There are:
  6.  *
  7.  *     i2c          the basic control module        (like scsi_mod)
  8.  *     bus driver   a driver with a i2c bus         (hostadapter driver)
  9.  *     chip driver  a driver for a chip connected
  10.  *                  to a i2c bus                    (cdrom/hd driver)
  11.  *
  12.  * A device will be attached to one bus and one chip driver.  Every chip
  13.  * driver gets a unique ID.
  14.  *
  15.  * A chip driver can provide a ioctl-like callback for the
  16.  * communication with other parts of the kernel (not every i2c chip is
  17.  * useful without other devices, a TV card tuner for example). 
  18.  *
  19.  * "i2c internal" parts of the structs: only the i2c module is allowed to
  20.  * write to them, for others they are read-only.
  21.  *
  22.  */
  23. #include <linux/version.h>
  24. #define I2C_BUS_MAX       4    /* max # of bus drivers  */
  25. #define I2C_DRIVER_MAX    8    /* max # of chip drivers */
  26. #define I2C_DEVICE_MAX    8    /* max # if devices per bus/driver */
  27. struct i2c_bus;
  28. struct i2c_driver;
  29. struct i2c_device;
  30. #define I2C_DRIVERID_MSP3400      1
  31. #define I2C_DRIVERID_TUNER        2
  32. #define I2C_DRIVERID_VIDEOTEXT  3
  33. #define I2C_DRIVERID_VIDEODECODER  4
  34. #define I2C_DRIVERID_VIDEOENCODER  5
  35. #define I2C_BUSID_BT848 1 /* I2C bus on a BT848 */
  36. #define I2C_BUSID_PARPORT 2 /* Bit banging on a parallel port */
  37. #define I2C_BUSID_BUZ 3
  38. #define I2C_BUSID_ZORAN 4
  39. #define I2C_BUSID_CYBER2000 5
  40. /*
  41.  * struct for a driver for a i2c chip (tuner, soundprocessor,
  42.  * videotext, ... ).
  43.  *
  44.  * a driver will register within the i2c module.  The i2c module will
  45.  * callback the driver (i2c_attach) for every device it finds on a i2c
  46.  * bus at the specified address.  If the driver decides to "accept"
  47.  * the, device, it must return a struct i2c_device, and NULL
  48.  * otherwise.
  49.  *
  50.  * i2c_detach = i2c_attach ** -1
  51.  * 
  52.  * i2c_command will be used to pass commands to the driver in a
  53.  * ioctl-line manner.
  54.  *
  55.  */
  56. struct i2c_driver 
  57. {
  58.     char           name[32];         /* some useful label         */
  59.     int            id;               /* device type ID            */
  60.     unsigned char  addr_l, addr_h;   /* address range of the chip */
  61.     int (*attach)(struct i2c_device *device);
  62.     int (*detach)(struct i2c_device *device);
  63.     int (*command)(struct i2c_device *device,unsigned int cmd, void *arg);
  64.     /* i2c internal */
  65.     struct i2c_device   *devices[I2C_DEVICE_MAX];
  66.     int                 devcount;
  67. };
  68. /*
  69.  * this holds the informations about a i2c bus available in the system.
  70.  * 
  71.  * a chip with a i2c bus interface (like bt848) registers the bus within
  72.  * the i2c module. This struct provides functions to access the i2c bus.
  73.  * 
  74.  * One must hold the spinlock to access the i2c bus (XXX: is the irqsave
  75.  * required? Maybe better use a semaphore?). 
  76.  * [-AC-] having a spinlock_irqsave is only needed if we have drivers wishing
  77.  *   to bang their i2c bus from an interrupt.
  78.  * 
  79.  * attach/detach_inform is a callback to inform the bus driver about
  80.  * attached chip drivers.
  81.  *
  82.  */
  83. /* needed: unsigned long flags */
  84. #if LINUX_VERSION_CODE >= 0x020100
  85. # if 0
  86. #  define LOCK_FLAGS unsigned long flags;
  87. #  define LOCK_I2C_BUS(bus)    spin_lock_irqsave(&(bus->bus_lock),flags);
  88. #  define UNLOCK_I2C_BUS(bus)  spin_unlock_irqrestore(&(bus->bus_lock),flags);
  89. # else
  90. #  define LOCK_FLAGS
  91. #  define LOCK_I2C_BUS(bus)    spin_lock(&(bus->bus_lock));
  92. #  define UNLOCK_I2C_BUS(bus)  spin_unlock(&(bus->bus_lock));
  93. # endif
  94. #else
  95. # define LOCK_FLAGS unsigned long flags;
  96. # define LOCK_I2C_BUS(bus)    { save_flags(flags); cli(); }
  97. # define UNLOCK_I2C_BUS(bus)  { restore_flags(flags);     }
  98. #endif
  99. struct i2c_bus 
  100. {
  101. char  name[32];         /* some useful label */
  102. int   id;
  103. void  *data;            /* free for use by the bus driver */
  104. #if LINUX_VERSION_CODE >= 0x020100
  105. spinlock_t bus_lock;
  106. #endif
  107. /* attach/detach inform callbacks */
  108. void    (*attach_inform)(struct i2c_bus *bus, int id);
  109. void    (*detach_inform)(struct i2c_bus *bus, int id);
  110. /* Software I2C */
  111. void    (*i2c_setlines)(struct i2c_bus *bus, int ctrl, int data);
  112. int     (*i2c_getdataline)(struct i2c_bus *bus);
  113. /* Hardware I2C */
  114. int     (*i2c_read)(struct i2c_bus *bus, unsigned char addr);
  115. int     (*i2c_write)(struct i2c_bus *bus, unsigned char addr,
  116.  unsigned char b1, unsigned char b2, int both);
  117. /* internal data for i2c module */
  118. struct i2c_device   *devices[I2C_DEVICE_MAX];
  119. int                 devcount;
  120. };
  121. /*
  122.  * This holds per-device data for a i2c device
  123.  */
  124. struct i2c_device 
  125. {
  126. char           name[32];         /* some useful label */
  127. void           *data;            /* free for use by the chip driver */
  128. unsigned char  addr;             /* chip addr */
  129. /* i2c internal */
  130. struct i2c_bus     *bus;
  131. struct i2c_driver  *driver;
  132. };
  133. /* ------------------------------------------------------------------- */
  134. /* i2c module functions                                                */
  135. /* register/unregister a i2c bus */
  136. int i2c_register_bus(struct i2c_bus *bus);
  137. int i2c_unregister_bus(struct i2c_bus *bus);
  138. /* register/unregister a chip driver */
  139. int i2c_register_driver(struct i2c_driver *driver);
  140. int i2c_unregister_driver(struct i2c_driver *driver);
  141. /* send a command to a chip using the ioctl-like callback interface */
  142. int i2c_control_device(struct i2c_bus *bus, int id,
  143.        unsigned int cmd, void *arg);
  144. /* i2c bus access functions */
  145. void    i2c_start(struct i2c_bus *bus);
  146. void    i2c_stop(struct i2c_bus *bus);
  147. void    i2c_one(struct i2c_bus *bus);
  148. void    i2c_zero(struct i2c_bus *bus);
  149. int     i2c_ack(struct i2c_bus *bus);
  150. int     i2c_sendbyte(struct i2c_bus *bus,unsigned char data,int wait_for_ack);
  151. unsigned char i2c_readbyte(struct i2c_bus *bus,int last);
  152. /* i2c (maybe) hardware functions */
  153. int     i2c_read(struct i2c_bus *bus, unsigned char addr);
  154. int     i2c_write(struct i2c_bus *bus, unsigned char addr,
  155.   unsigned char b1, unsigned char b2, int both);
  156. int i2c_init(void);
  157. #endif /* I2C_H */