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 int (*i2c_slave_initfn)(i2c_slave *dev);
  26
  27 typedef struct {
  28     DeviceInfo qdev;
  29
  30     /* Callbacks provided by the device.  */
  31     i2c_slave_initfn init;
  32     i2c_event_cb event;
  33     i2c_recv_cb recv;
  34     i2c_send_cb send;
  35 } I2CSlaveInfo;
  36
  37 struct i2c_slave
  38 {
  39     DeviceState qdev;
  40     I2CSlaveInfo *info;
  41
  42     /* Remaining fields for internal use by the I2C code.  */
  43     uint8_t address;
  44 };
  45
  46 i2c_bus *i2c_init_bus(DeviceState *parent, const char *name);
  47 void i2c_set_slave_address(i2c_slave *dev, uint8_t address);
  48 int i2c_bus_busy(i2c_bus *bus);
  49 int i2c_start_transfer(i2c_bus *bus, uint8_t address, int recv);
  50 void i2c_end_transfer(i2c_bus *bus);
  51 void i2c_nack(i2c_bus *bus);
  52 int i2c_send(i2c_bus *bus, uint8_t data);
  53 int i2c_recv(i2c_bus *bus);
  54
  55 #define I2C_SLAVE_FROM_QDEV(dev) DO_UPCAST(i2c_slave, qdev, dev)
  56 #define FROM_I2C_SLAVE(type, dev) DO_UPCAST(type, i2c, dev)
  57
  58 void i2c_register_slave(I2CSlaveInfo *type);
  59
  60 DeviceState *i2c_create_slave(i2c_bus *bus, const char *name, uint8_t addr);
  61
  62 /* wm8750.c */
  63 void wm8750_data_req_set(DeviceState *dev,
  64                 void (*data_req)(void *, int, int), void *opaque);
  65 void wm8750_dac_dat(void *opaque, uint32_t sample);
  66 uint32_t wm8750_adc_dat(void *opaque);
  67 void *wm8750_dac_buffer(void *opaque, int samples);
  68 void wm8750_dac_commit(void *opaque);
  69 void wm8750_set_bclk_in(void *opaque, int new_hz);
  70
  71 /* tmp105.c */
  72 void tmp105_set(i2c_slave *i2c, int temp);
  73
  74 /* lm832x.c */
  75 void lm832x_key_event(DeviceState *dev, int key, int state);
  76
  77 extern const VMStateDescription vmstate_i2c_slave;
  78
  79 #define VMSTATE_I2C_SLAVE(_field, _state) {                          \
  80     .name       = (stringify(_field)),                               \
  81     .size       = sizeof(i2c_slave),                                 \
  82     .vmsd       = &vmstate_i2c_slave,                                \
  83     .flags      = VMS_STRUCT,                                        \
  84     .offset     = vmstate_offset_value(_state, _field, i2c_slave),   \
  85 }
  86
  87 #endif