hw/i2c.h

   1 #ifndef QEMU_I2C_H
   2 #define QEMU_I2C_H
   3
   4 #include "qdev.h"
   5
   6 /* The QEMU I2C implementation only supports simple transfers that complete
   7    immediately.  It does not support slave devices that need to be able to
   8    defer their response (eg. CPU slave interfaces where the data is supplied
   9    by the device driver in response to an interrupt).  */
  10
  11 enum i2c_event {
  12     I2C_START_RECV,
  13     I2C_START_SEND,
  14     I2C_FINISH,
  15     I2C_NACK /* Masker NACKed a receive byte.  */
  16 };
  17
  18 /* Master to slave.  */
  19 typedef int (*i2c_send_cb)(i2c_slave *s, uint8_t data);
  20 /* Slave to master.  */
  21 typedef int (*i2c_recv_cb)(i2c_slave *s);
  22 /* Notify the slave of a bus state change.  */
  23 typedef void (*i2c_event_cb)(i2c_slave *s, enum i2c_event event);
  24
  25 typedef void (*i2c_slave_initfn)(i2c_slave *dev);
  26
  27 typedef struct {
  28     /* Callbacks provided by the device.  */
  29     i2c_slave_initfn init;
  30     i2c_event_cb event;
  31     i2c_recv_cb recv;
  32     i2c_send_cb send;
  33 } I2CSlaveInfo;
  34
  35 struct i2c_slave
  36 {
  37     DeviceState qdev;
  38     I2CSlaveInfo *info;
  39     /* FIXME: These 3 should go away once all devices have been converted.  */
  40     i2c_event_cb event;
  41     i2c_recv_cb recv;
  42     i2c_send_cb send;
  43
  44     /* Remaining fields for internal use by the I2C code.  */
  45     int address;
  46     void *next;
  47     i2c_bus *bus;
  48 };
  49
  50 i2c_bus *i2c_init_bus(void);
  51 i2c_slave *i2c_slave_init(i2c_bus *bus, int address, int size);
  52 void i2c_set_slave_address(i2c_slave *dev, int address);
  53 int i2c_bus_busy(i2c_bus *bus);
  54 int i2c_start_transfer(i2c_bus *bus, int address, int recv);
  55 void i2c_end_transfer(i2c_bus *bus);
  56 void i2c_nack(i2c_bus *bus);
  57 int i2c_send(i2c_bus *bus, uint8_t data);
  58 int i2c_recv(i2c_bus *bus);
  59 void i2c_slave_save(QEMUFile *f, i2c_slave *dev);
  60 void i2c_slave_load(QEMUFile *f, i2c_slave *dev);
  61
  62 #define I2C_SLAVE_FROM_QDEV(dev) DO_UPCAST(i2c_slave, qdev, dev)
  63 #define FROM_I2C_SLAVE(type, dev) DO_UPCAST(type, i2c, dev)
  64
  65 void i2c_register_slave(const char *name, int size, I2CSlaveInfo *type);
  66
  67 DeviceState *i2c_create_slave(i2c_bus *bus, const char *name, int addr);
  68
  69 /* max111x.c */
  70 typedef struct MAX111xState MAX111xState;
  71 uint32_t max111x_read(void *opaque);
  72 void max111x_write(void *opaque, uint32_t value);
  73 MAX111xState *max1110_init(qemu_irq cb);
  74 MAX111xState *max1111_init(qemu_irq cb);
  75 void max111x_set_input(MAX111xState *s, int line, uint8_t value);
  76
  77 /* max7310.c */
  78 void max7310_reset(i2c_slave *i2c);
  79 qemu_irq *max7310_gpio_in_get(i2c_slave *i2c);
  80 void max7310_gpio_out_set(i2c_slave *i2c, int line, qemu_irq handler);
  81
  82 /* wm8750.c */
  83 i2c_slave *wm8750_init(i2c_bus *bus);
  84 void wm8750_reset(i2c_slave *i2c);
  85 void wm8750_data_req_set(i2c_slave *i2c,
  86                 void (*data_req)(void *, int, int), void *opaque);
  87 void wm8750_dac_dat(void *opaque, uint32_t sample);
  88 uint32_t wm8750_adc_dat(void *opaque);
  89 void *wm8750_dac_buffer(void *opaque, int samples);
  90 void wm8750_dac_commit(void *opaque);
  91 void wm8750_set_bclk_in(void *opaque, int new_hz);
  92
  93 /* twl92230.c */
  94 i2c_slave *twl92230_init(i2c_bus *bus, qemu_irq irq);
  95 qemu_irq *twl92230_gpio_in_get(i2c_slave *i2c);
  96 void twl92230_gpio_out_set(i2c_slave *i2c, int line, qemu_irq handler);
  97
  98 /* tmp105.c */
  99 struct i2c_slave *tmp105_init(i2c_bus *bus, qemu_irq alarm);
 100 void tmp105_reset(i2c_slave *i2c);
 101 void tmp105_set(i2c_slave *i2c, int temp);
 102
 103 /* lm832x.c */
 104 struct i2c_slave *lm8323_init(i2c_bus *bus, qemu_irq nirq);
 105 void lm832x_key_event(struct i2c_slave *i2c, int key, int state);
 106
 107 #endif