drivers/staging/iio/adc/ad7606.h

   1 /*
   2  * AD7606 ADC driver
   3  *
   4  * Copyright 2011 Analog Devices Inc.
   5  *
   6  * Licensed under the GPL-2.
   7  */
   8
   9 #ifndef IIO_ADC_AD7606_H_
  10 #define IIO_ADC_AD7606_H_
  11
  12 /*
  13  * TODO: struct ad7606_platform_data needs to go into include/linux/iio
  14  */
  15
  16 /**
  17  * struct ad7606_platform_data - platform/board specific information
  18  * @default_os:         default oversampling value {0, 2, 4, 8, 16, 32, 64}
  19  * @default_range:      default range +/-{5000, 10000} mVolt
  20  * @gpio_convst:        number of gpio connected to the CONVST pin
  21  * @gpio_reset:         gpio connected to the RESET pin, if not used set to -1
  22  * @gpio_range:         gpio connected to the RANGE pin, if not used set to -1
  23  * @gpio_os0:           gpio connected to the OS0 pin, if not used set to -1
  24  * @gpio_os1:           gpio connected to the OS1 pin, if not used set to -1
  25  * @gpio_os2:           gpio connected to the OS2 pin, if not used set to -1
  26  * @gpio_frstdata:      gpio connected to the FRSTDAT pin, if not used set to -1
  27  * @gpio_stby:          gpio connected to the STBY pin, if not used set to -1
  28  */
  29
  30 struct ad7606_platform_data {
  31         unsigned int                    default_os;
  32         unsigned int                    default_range;
  33         unsigned int                    gpio_convst;
  34         unsigned int                    gpio_reset;
  35         unsigned int                    gpio_range;
  36         unsigned int                    gpio_os0;
  37         unsigned int                    gpio_os1;
  38         unsigned int                    gpio_os2;
  39         unsigned int                    gpio_frstdata;
  40         unsigned int                    gpio_stby;
  41 };
  42
  43 /**
  44  * struct ad7606_chip_info - chip specific information
  45  * @name:               identification string for chip
  46  * @channels:           channel specification
  47  * @num_channels:       number of channels
  48  */
  49
  50 struct ad7606_chip_info {
  51         const struct iio_chan_spec      *channels;
  52         unsigned int                    num_channels;
  53 };
  54
  55 /**
  56  * struct ad7606_state - driver instance specific data
  57  */
  58
  59 struct ad7606_state {
  60         struct device                   *dev;
  61         const struct ad7606_chip_info   *chip_info;
  62         struct ad7606_platform_data     *pdata;
  63         struct regulator                *reg;
  64         struct work_struct              poll_work;
  65         wait_queue_head_t               wq_data_avail;
  66         const struct ad7606_bus_ops     *bops;
  67         unsigned int                    range;
  68         unsigned int                    oversampling;
  69         bool                            done;
  70         void __iomem                    *base_address;
  71
  72         /*
  73          * DMA (thus cache coherency maintenance) requires the
  74          * transfer buffers to live in their own cache lines.
  75          */
  76
  77         unsigned short                  data[8] ____cacheline_aligned;
  78 };
  79
  80 struct ad7606_bus_ops {
  81         /* more methods added in future? */
  82         int (*read_block)(struct device *, int, void *);
  83 };
  84
  85 struct iio_dev *ad7606_probe(struct device *dev, int irq,
  86                               void __iomem *base_address,
  87                               const char *name, unsigned int id,
  88                               const struct ad7606_bus_ops *bops);
  89 int ad7606_remove(struct iio_dev *indio_dev, int irq);
  90 int ad7606_reset(struct ad7606_state *st);
  91
  92 enum ad7606_supported_device_ids {
  93         ID_AD7606_8,
  94         ID_AD7606_6,
  95         ID_AD7606_4
  96 };
  97
  98 int ad7606_register_ring_funcs_and_init(struct iio_dev *indio_dev);
  99 void ad7606_ring_cleanup(struct iio_dev *indio_dev);
 100
 101 #ifdef CONFIG_PM_SLEEP
 102 extern const struct dev_pm_ops ad7606_pm_ops;
 103 #define AD7606_PM_OPS (&ad7606_pm_ops)
 104 #else
 105 #define AD7606_PM_OPS NULL
 106 #endif
 107
 108 #endif /* IIO_ADC_AD7606_H_ */