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/**
104 * IIO_DEV_ATTR_INT_TIME_AVAIL - list available integration times
105 * @_show: output method for the attribute
106 **/
107#define IIO_DEV_ATTR_INT_TIME_AVAIL(_show)		\
108	IIO_DEVICE_ATTR(integration_time_available, S_IRUGO, _show, NULL, 0)
109/**
110 * IIO_CONST_ATTR_INT_TIME_AVAIL - list available integration times
111 * @_string: frequency string for the attribute
112 *
113 * Constant version
114 **/
115#define IIO_CONST_ATTR_INT_TIME_AVAIL(_string)		\
116	IIO_CONST_ATTR(integration_time_available, _string)
117
118#define IIO_DEV_ATTR_TEMP_RAW(_show)			\
119	IIO_DEVICE_ATTR(in_temp_raw, S_IRUGO, _show, NULL, 0)
120
121#define IIO_CONST_ATTR_TEMP_OFFSET(_string)		\
122	IIO_CONST_ATTR(in_temp_offset, _string)
123
124#define IIO_CONST_ATTR_TEMP_SCALE(_string)		\
125	IIO_CONST_ATTR(in_temp_scale, _string)
126
127#endif /* _INDUSTRIAL_IO_SYSFS_H_ */
128