drivers/staging/iio/sysfs.h

   1 /* The industrial I/O core
   2  *
   3  *Copyright (c) 2008 Jonathan Cameron
   4  *
   5  * This program is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 as published by
   7  * the Free Software Foundation.
   8  *
   9  * General attributes
  10  */
  11
  12 #ifndef _INDUSTRIAL_IO_SYSFS_H_
  13 #define _INDUSTRIAL_IO_SYSFS_H_
  14
  15 struct iio_chan_spec;
  16
  17 /**
  18  * struct iio_dev_attr - iio specific device attribute
  19  * @dev_attr:   underlying device attribute
  20  * @address:    associated register address
  21  * @l:          list head for maintaining list of dynamically created attrs.
  22  */
  23 struct iio_dev_attr {
  24         struct device_attribute dev_attr;
  25         u64 address;
  26         struct list_head l;
  27         struct iio_chan_spec const *c;
  28 };
  29
  30 #define to_iio_dev_attr(_dev_attr)                              \
  31         container_of(_dev_attr, struct iio_dev_attr, dev_attr)
  32
  33 ssize_t iio_read_const_attr(struct device *dev,
  34                             struct device_attribute *attr,
  35                             char *len);
  36
  37 /**
  38  * struct iio_const_attr - constant device specific attribute
  39  *                         often used for things like available modes
  40  * @string:     attribute string
  41  * @dev_attr:   underlying device attribute
  42  */
  43 struct iio_const_attr {
  44         const char *string;
  45         struct device_attribute dev_attr;
  46 };
  47
  48 #define to_iio_const_attr(_dev_attr) \
  49         container_of(_dev_attr, struct iio_const_attr, dev_attr)
  50
  51 /* Some attributes will be hard coded (device dependent) and not require an
  52    address, in these cases pass a negative */
  53 #define IIO_ATTR(_name, _mode, _show, _store, _addr)            \
  54         { .dev_attr = __ATTR(_name, _mode, _show, _store),      \
  55           .address = _addr }
  56
  57 #define IIO_DEVICE_ATTR(_name, _mode, _show, _store, _addr)     \
  58         struct iio_dev_attr iio_dev_attr_##_name                \
  59         = IIO_ATTR(_name, _mode, _show, _store, _addr)
  60
  61 #define IIO_DEVICE_ATTR_NAMED(_vname, _name, _mode, _show, _store, _addr) \
  62         struct iio_dev_attr iio_dev_attr_##_vname                       \
  63         = IIO_ATTR(_name, _mode, _show, _store, _addr)
  64
  65 #define IIO_CONST_ATTR(_name, _string)                                  \
  66         struct iio_const_attr iio_const_attr_##_name                    \
  67         = { .string = _string,                                          \
  68             .dev_attr = __ATTR(_name, S_IRUGO, iio_read_const_attr, NULL)}
  69
  70 #define IIO_CONST_ATTR_NAMED(_vname, _name, _string)                    \
  71         struct iio_const_attr iio_const_attr_##_vname                   \
  72         = { .string = _string,                                          \
  73             .dev_attr = __ATTR(_name, S_IRUGO, iio_read_const_attr, NULL)}
  74
  75 /* Generic attributes of onetype or another */
  76 /**
  77  * IIO_DEV_ATTR_RESET: resets the device
  78  **/
  79 #define IIO_DEV_ATTR_RESET(_store)                      \
  80         IIO_DEVICE_ATTR(reset, S_IWUSR, NULL, _store, 0)
  81
  82 /**
  83  * IIO_DEV_ATTR_SAMP_FREQ - sets any internal clock frequency
  84  * @_mode: sysfs file mode/permissions
  85  * @_show: output method for the attribute
  86  * @_store: input method for the attribute
  87  **/
  88 #define IIO_DEV_ATTR_SAMP_FREQ(_mode, _show, _store)                    \
  89         IIO_DEVICE_ATTR(sampling_frequency, _mode, _show, _store, 0)
  90
  91 /**
  92  * IIO_DEV_ATTR_SAMP_FREQ_AVAIL - list available sampling frequencies
  93  * @_show: output method for the attribute
  94  *
  95  * May be mode dependent on some devices
  96  **/
  97 #define IIO_DEV_ATTR_SAMP_FREQ_AVAIL(_show)                             \
  98         IIO_DEVICE_ATTR(sampling_frequency_available, S_IRUGO, _show, NULL, 0)
  99 /**
 100  * IIO_CONST_ATTR_AVAIL_SAMP_FREQ - list available sampling frequencies
 101  * @_string: frequency string for the attribute
 102  *
 103  * Constant version
 104  **/
 105 #define IIO_CONST_ATTR_SAMP_FREQ_AVAIL(_string)                 \
 106         IIO_CONST_ATTR(sampling_frequency_available, _string)
 107
 108 #define IIO_DEV_ATTR_TEMP_RAW(_show)                    \
 109         IIO_DEVICE_ATTR(in_temp_raw, S_IRUGO, _show, NULL, 0)
 110
 111 #define IIO_CONST_ATTR_TEMP_OFFSET(_string)             \
 112         IIO_CONST_ATTR(in_temp_offset, _string)
 113
 114 #define IIO_CONST_ATTR_TEMP_SCALE(_string)              \
 115         IIO_CONST_ATTR(in_temp_scale, _string)
 116
 117 enum iio_event_type {
 118         IIO_EV_TYPE_THRESH,
 119         IIO_EV_TYPE_MAG,
 120         IIO_EV_TYPE_ROC,
 121         IIO_EV_TYPE_THRESH_ADAPTIVE,
 122         IIO_EV_TYPE_MAG_ADAPTIVE,
 123 };
 124
 125 enum iio_event_direction {
 126         IIO_EV_DIR_EITHER,
 127         IIO_EV_DIR_RISING,
 128         IIO_EV_DIR_FALLING,
 129 };
 130
 131 #define IIO_EVENT_CODE(chan_type, diff, modifier, direction,            \
 132                        type, chan, chan1, chan2)                        \
 133         (((u64)type << 56) | ((u64)diff << 55) |                        \
 134          ((u64)direction << 48) | ((u64)modifier << 40) |               \
 135          ((u64)chan_type << 32) | (chan2 << 16) | chan1 | chan)
 136
 137 #define IIO_EV_DIR_MAX 4
 138 #define IIO_EV_BIT(type, direction)                     \
 139         (1 << (type*IIO_EV_DIR_MAX + direction))
 140
 141 #define IIO_MOD_EVENT_CODE(channelclass, number, modifier,              \
 142                            type, direction)                             \
 143         IIO_EVENT_CODE(channelclass, 0, modifier, direction, type, number, 0, 0)
 144
 145 #define IIO_UNMOD_EVENT_CODE(channelclass, number, type, direction)     \
 146         IIO_EVENT_CODE(channelclass, 0, 0, direction, type, number, 0, 0)
 147
 148 #define IIO_EVENT_CODE_EXTRACT_TYPE(mask) ((mask >> 56) & 0xFF)
 149
 150 #define IIO_EVENT_CODE_EXTRACT_DIR(mask) ((mask >> 48) & 0xCF)
 151
 152 #define IIO_EVENT_CODE_EXTRACT_CHAN_TYPE(mask) ((mask >> 32) & 0xFF)
 153
 154 /* Event code number extraction depends on which type of event we have.
 155  * Perhaps review this function in the future*/
 156 #define IIO_EVENT_CODE_EXTRACT_NUM(mask) (mask & 0xFFFF)
 157
 158 #define IIO_EVENT_CODE_EXTRACT_MODIFIER(mask) ((mask >> 40) & 0xFF)
 159
 160 #endif /* _INDUSTRIAL_IO_SYSFS_H_ */