LXR linux/include/linux/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
  15struct 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 */
  23struct 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
  33ssize_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 */
  43struct 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/**
  78 * IIO_DEV_ATTR_SAMP_FREQ - sets any internal clock frequency
  79 * @_mode: sysfs file mode/permissions
  80 * @_show: output method for the attribute
  81 * @_store: input method for the attribute
  82 **/
  83#define IIO_DEV_ATTR_SAMP_FREQ(_mode, _show, _store)                    \
  84        IIO_DEVICE_ATTR(sampling_frequency, _mode, _show, _store, 0)
  85
  86/**
  87 * IIO_DEV_ATTR_SAMP_FREQ_AVAIL - list available sampling frequencies
  88 * @_show: output method for the attribute
  89 *
  90 * May be mode dependent on some devices
  91 **/
  92#define IIO_DEV_ATTR_SAMP_FREQ_AVAIL(_show)                             \
  93        IIO_DEVICE_ATTR(sampling_frequency_available, S_IRUGO, _show, NULL, 0)
  94/**
  95 * IIO_CONST_ATTR_SAMP_FREQ_AVAIL - list available sampling frequencies
  96 * @_string: frequency string for the attribute
  97 *
  98 * Constant version
  99 **/
 100#define IIO_CONST_ATTR_SAMP_FREQ_AVAIL(_string)                 \
 101        IIO_CONST_ATTR(sampling_frequency_available, _string)
 102
 103#define IIO_DEV_ATTR_TEMP_RAW(_show)                    \
 104        IIO_DEVICE_ATTR(in_temp_raw, S_IRUGO, _show, NULL, 0)
 105
 106#define IIO_CONST_ATTR_TEMP_OFFSET(_string)             \
 107        IIO_CONST_ATTR(in_temp_offset, _string)
 108
 109#define IIO_CONST_ATTR_TEMP_SCALE(_string)              \
 110        IIO_CONST_ATTR(in_temp_scale, _string)
 111
 112#endif /* _INDUSTRIAL_IO_SYSFS_H_ */
 113