xref: /linux/tools/iio/iio_event_monitor.c (revision ca55b2fef3a9373fcfc30f82fd26bc7fccbda732)
1 /* Industrialio event test code.
2  *
3  * Copyright (c) 2011-2012 Lars-Peter Clausen <lars@metafoo.de>
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  * This program is primarily intended as an example application.
10  * Reads the current buffer setup from sysfs and starts a short capture
11  * from the specified device, pretty printing the result after appropriate
12  * conversion.
13  *
14  * Usage:
15  *	iio_event_monitor <device_name>
16  */
17 
18 #include <unistd.h>
19 #include <stdlib.h>
20 #include <stdbool.h>
21 #include <stdio.h>
22 #include <errno.h>
23 #include <string.h>
24 #include <poll.h>
25 #include <fcntl.h>
26 #include <sys/ioctl.h>
27 #include "iio_utils.h"
28 #include <linux/iio/events.h>
29 #include <linux/iio/types.h>
30 
31 static const char * const iio_chan_type_name_spec[] = {
32 	[IIO_VOLTAGE] = "voltage",
33 	[IIO_CURRENT] = "current",
34 	[IIO_POWER] = "power",
35 	[IIO_ACCEL] = "accel",
36 	[IIO_ANGL_VEL] = "anglvel",
37 	[IIO_MAGN] = "magn",
38 	[IIO_LIGHT] = "illuminance",
39 	[IIO_INTENSITY] = "intensity",
40 	[IIO_PROXIMITY] = "proximity",
41 	[IIO_TEMP] = "temp",
42 	[IIO_INCLI] = "incli",
43 	[IIO_ROT] = "rot",
44 	[IIO_ANGL] = "angl",
45 	[IIO_TIMESTAMP] = "timestamp",
46 	[IIO_CAPACITANCE] = "capacitance",
47 	[IIO_ALTVOLTAGE] = "altvoltage",
48 	[IIO_CCT] = "cct",
49 	[IIO_PRESSURE] = "pressure",
50 	[IIO_HUMIDITYRELATIVE] = "humidityrelative",
51 	[IIO_ACTIVITY] = "activity",
52 	[IIO_STEPS] = "steps",
53 	[IIO_ENERGY] = "energy",
54 	[IIO_DISTANCE] = "distance",
55 	[IIO_VELOCITY] = "velocity",
56 };
57 
58 static const char * const iio_ev_type_text[] = {
59 	[IIO_EV_TYPE_THRESH] = "thresh",
60 	[IIO_EV_TYPE_MAG] = "mag",
61 	[IIO_EV_TYPE_ROC] = "roc",
62 	[IIO_EV_TYPE_THRESH_ADAPTIVE] = "thresh_adaptive",
63 	[IIO_EV_TYPE_MAG_ADAPTIVE] = "mag_adaptive",
64 	[IIO_EV_TYPE_CHANGE] = "change",
65 };
66 
67 static const char * const iio_ev_dir_text[] = {
68 	[IIO_EV_DIR_EITHER] = "either",
69 	[IIO_EV_DIR_RISING] = "rising",
70 	[IIO_EV_DIR_FALLING] = "falling"
71 };
72 
73 static const char * const iio_modifier_names[] = {
74 	[IIO_MOD_X] = "x",
75 	[IIO_MOD_Y] = "y",
76 	[IIO_MOD_Z] = "z",
77 	[IIO_MOD_X_AND_Y] = "x&y",
78 	[IIO_MOD_X_AND_Z] = "x&z",
79 	[IIO_MOD_Y_AND_Z] = "y&z",
80 	[IIO_MOD_X_AND_Y_AND_Z] = "x&y&z",
81 	[IIO_MOD_X_OR_Y] = "x|y",
82 	[IIO_MOD_X_OR_Z] = "x|z",
83 	[IIO_MOD_Y_OR_Z] = "y|z",
84 	[IIO_MOD_X_OR_Y_OR_Z] = "x|y|z",
85 	[IIO_MOD_LIGHT_BOTH] = "both",
86 	[IIO_MOD_LIGHT_IR] = "ir",
87 	[IIO_MOD_ROOT_SUM_SQUARED_X_Y] = "sqrt(x^2+y^2)",
88 	[IIO_MOD_SUM_SQUARED_X_Y_Z] = "x^2+y^2+z^2",
89 	[IIO_MOD_LIGHT_CLEAR] = "clear",
90 	[IIO_MOD_LIGHT_RED] = "red",
91 	[IIO_MOD_LIGHT_GREEN] = "green",
92 	[IIO_MOD_LIGHT_BLUE] = "blue",
93 	[IIO_MOD_QUATERNION] = "quaternion",
94 	[IIO_MOD_TEMP_AMBIENT] = "ambient",
95 	[IIO_MOD_TEMP_OBJECT] = "object",
96 	[IIO_MOD_NORTH_MAGN] = "from_north_magnetic",
97 	[IIO_MOD_NORTH_TRUE] = "from_north_true",
98 	[IIO_MOD_NORTH_MAGN_TILT_COMP] = "from_north_magnetic_tilt_comp",
99 	[IIO_MOD_NORTH_TRUE_TILT_COMP] = "from_north_true_tilt_comp",
100 	[IIO_MOD_RUNNING] = "running",
101 	[IIO_MOD_JOGGING] = "jogging",
102 	[IIO_MOD_WALKING] = "walking",
103 	[IIO_MOD_STILL] = "still",
104 	[IIO_MOD_ROOT_SUM_SQUARED_X_Y_Z] = "sqrt(x^2+y^2+z^2)",
105 };
106 
107 static bool event_is_known(struct iio_event_data *event)
108 {
109 	enum iio_chan_type type = IIO_EVENT_CODE_EXTRACT_CHAN_TYPE(event->id);
110 	enum iio_modifier mod = IIO_EVENT_CODE_EXTRACT_MODIFIER(event->id);
111 	enum iio_event_type ev_type = IIO_EVENT_CODE_EXTRACT_TYPE(event->id);
112 	enum iio_event_direction dir = IIO_EVENT_CODE_EXTRACT_DIR(event->id);
113 
114 	switch (type) {
115 	case IIO_VOLTAGE:
116 	case IIO_CURRENT:
117 	case IIO_POWER:
118 	case IIO_ACCEL:
119 	case IIO_ANGL_VEL:
120 	case IIO_MAGN:
121 	case IIO_LIGHT:
122 	case IIO_INTENSITY:
123 	case IIO_PROXIMITY:
124 	case IIO_TEMP:
125 	case IIO_INCLI:
126 	case IIO_ROT:
127 	case IIO_ANGL:
128 	case IIO_TIMESTAMP:
129 	case IIO_CAPACITANCE:
130 	case IIO_ALTVOLTAGE:
131 	case IIO_CCT:
132 	case IIO_PRESSURE:
133 	case IIO_HUMIDITYRELATIVE:
134 	case IIO_ACTIVITY:
135 	case IIO_STEPS:
136 	case IIO_ENERGY:
137 	case IIO_DISTANCE:
138 	case IIO_VELOCITY:
139 		break;
140 	default:
141 		return false;
142 	}
143 
144 	switch (mod) {
145 	case IIO_NO_MOD:
146 	case IIO_MOD_X:
147 	case IIO_MOD_Y:
148 	case IIO_MOD_Z:
149 	case IIO_MOD_X_AND_Y:
150 	case IIO_MOD_X_AND_Z:
151 	case IIO_MOD_Y_AND_Z:
152 	case IIO_MOD_X_AND_Y_AND_Z:
153 	case IIO_MOD_X_OR_Y:
154 	case IIO_MOD_X_OR_Z:
155 	case IIO_MOD_Y_OR_Z:
156 	case IIO_MOD_X_OR_Y_OR_Z:
157 	case IIO_MOD_LIGHT_BOTH:
158 	case IIO_MOD_LIGHT_IR:
159 	case IIO_MOD_ROOT_SUM_SQUARED_X_Y:
160 	case IIO_MOD_SUM_SQUARED_X_Y_Z:
161 	case IIO_MOD_LIGHT_CLEAR:
162 	case IIO_MOD_LIGHT_RED:
163 	case IIO_MOD_LIGHT_GREEN:
164 	case IIO_MOD_LIGHT_BLUE:
165 	case IIO_MOD_QUATERNION:
166 	case IIO_MOD_TEMP_AMBIENT:
167 	case IIO_MOD_TEMP_OBJECT:
168 	case IIO_MOD_NORTH_MAGN:
169 	case IIO_MOD_NORTH_TRUE:
170 	case IIO_MOD_NORTH_MAGN_TILT_COMP:
171 	case IIO_MOD_NORTH_TRUE_TILT_COMP:
172 	case IIO_MOD_RUNNING:
173 	case IIO_MOD_JOGGING:
174 	case IIO_MOD_WALKING:
175 	case IIO_MOD_STILL:
176 	case IIO_MOD_ROOT_SUM_SQUARED_X_Y_Z:
177 		break;
178 	default:
179 		return false;
180 	}
181 
182 	switch (ev_type) {
183 	case IIO_EV_TYPE_THRESH:
184 	case IIO_EV_TYPE_MAG:
185 	case IIO_EV_TYPE_ROC:
186 	case IIO_EV_TYPE_THRESH_ADAPTIVE:
187 	case IIO_EV_TYPE_MAG_ADAPTIVE:
188 	case IIO_EV_TYPE_CHANGE:
189 		break;
190 	default:
191 		return false;
192 	}
193 
194 	switch (dir) {
195 	case IIO_EV_DIR_EITHER:
196 	case IIO_EV_DIR_RISING:
197 	case IIO_EV_DIR_FALLING:
198 	case IIO_EV_DIR_NONE:
199 		break;
200 	default:
201 		return false;
202 	}
203 
204 	return true;
205 }
206 
207 static void print_event(struct iio_event_data *event)
208 {
209 	enum iio_chan_type type = IIO_EVENT_CODE_EXTRACT_CHAN_TYPE(event->id);
210 	enum iio_modifier mod = IIO_EVENT_CODE_EXTRACT_MODIFIER(event->id);
211 	enum iio_event_type ev_type = IIO_EVENT_CODE_EXTRACT_TYPE(event->id);
212 	enum iio_event_direction dir = IIO_EVENT_CODE_EXTRACT_DIR(event->id);
213 	int chan = IIO_EVENT_CODE_EXTRACT_CHAN(event->id);
214 	int chan2 = IIO_EVENT_CODE_EXTRACT_CHAN2(event->id);
215 	bool diff = IIO_EVENT_CODE_EXTRACT_DIFF(event->id);
216 
217 	if (!event_is_known(event)) {
218 		fprintf(stderr, "Unknown event: time: %lld, id: %llx\n",
219 			event->timestamp, event->id);
220 
221 		return;
222 	}
223 
224 	printf("Event: time: %lld, type: %s", event->timestamp,
225 	       iio_chan_type_name_spec[type]);
226 
227 	if (mod != IIO_NO_MOD)
228 		printf("(%s)", iio_modifier_names[mod]);
229 
230 	if (chan >= 0) {
231 		printf(", channel: %d", chan);
232 		if (diff && chan2 >= 0)
233 			printf("-%d", chan2);
234 	}
235 
236 	printf(", evtype: %s", iio_ev_type_text[ev_type]);
237 
238 	if (dir != IIO_EV_DIR_NONE)
239 		printf(", direction: %s", iio_ev_dir_text[dir]);
240 
241 	printf("\n");
242 }
243 
244 int main(int argc, char **argv)
245 {
246 	struct iio_event_data event;
247 	const char *device_name;
248 	char *chrdev_name;
249 	int ret;
250 	int dev_num;
251 	int fd, event_fd;
252 
253 	if (argc <= 1) {
254 		fprintf(stderr, "Usage: %s <device_name>\n", argv[0]);
255 		return -1;
256 	}
257 
258 	device_name = argv[1];
259 
260 	dev_num = find_type_by_name(device_name, "iio:device");
261 	if (dev_num >= 0) {
262 		printf("Found IIO device with name %s with device number %d\n",
263 		       device_name, dev_num);
264 		ret = asprintf(&chrdev_name, "/dev/iio:device%d", dev_num);
265 		if (ret < 0)
266 			return -ENOMEM;
267 	} else {
268 		/*
269 		 * If we can't find an IIO device by name assume device_name is
270 		 * an IIO chrdev
271 		 */
272 		chrdev_name = strdup(device_name);
273 		if (!chrdev_name)
274 			return -ENOMEM;
275 	}
276 
277 	fd = open(chrdev_name, 0);
278 	if (fd == -1) {
279 		ret = -errno;
280 		fprintf(stderr, "Failed to open %s\n", chrdev_name);
281 		goto error_free_chrdev_name;
282 	}
283 
284 	ret = ioctl(fd, IIO_GET_EVENT_FD_IOCTL, &event_fd);
285 	if (ret == -1 || event_fd == -1) {
286 		ret = -errno;
287 		fprintf(stderr, "Failed to retrieve event fd\n");
288 		if (close(fd) == -1)
289 			perror("Failed to close character device file");
290 
291 		goto error_free_chrdev_name;
292 	}
293 
294 	if (close(fd) == -1)  {
295 		ret = -errno;
296 		goto error_free_chrdev_name;
297 	}
298 
299 	while (true) {
300 		ret = read(event_fd, &event, sizeof(event));
301 		if (ret == -1) {
302 			if (errno == EAGAIN) {
303 				fprintf(stderr, "nothing available\n");
304 				continue;
305 			} else {
306 				ret = -errno;
307 				perror("Failed to read event from device");
308 				break;
309 			}
310 		}
311 
312 		if (ret != sizeof(event)) {
313 			fprintf(stderr, "Reading event failed!\n");
314 			ret = -EIO;
315 			break;
316 		}
317 
318 		print_event(&event);
319 	}
320 
321 	if (close(event_fd) == -1)
322 		perror("Failed to close event file");
323 
324 error_free_chrdev_name:
325 	free(chrdev_name);
326 
327 	return ret;
328 }
329