industrialio-core.c 32.5 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11
/* The industrial I/O core
 *
 * Copyright (c) 2008 Jonathan Cameron
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 as published by
 * the Free Software Foundation.
 *
 * Based on elements of hwmon and input subsystems.
 */

12 13
#define pr_fmt(fmt) "iio-core: " fmt

14 15 16 17 18 19 20 21
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/idr.h>
#include <linux/kdev_t.h>
#include <linux/err.h>
#include <linux/device.h>
#include <linux/fs.h>
#include <linux/poll.h>
22
#include <linux/sched.h>
23
#include <linux/wait.h>
24
#include <linux/cdev.h>
25
#include <linux/slab.h>
26
#include <linux/anon_inodes.h>
27
#include <linux/debugfs.h>
28
#include <linux/iio/iio.h>
29
#include "iio_core.h"
30
#include "iio_core_trigger.h"
31 32
#include <linux/iio/sysfs.h>
#include <linux/iio/events.h>
33
#include <linux/iio/buffer.h>
34

35
/* IDA to assign each registered device a unique id */
36
static DEFINE_IDA(iio_ida);
37

38
static dev_t iio_devt;
39 40

#define IIO_DEV_MAX 256
41
struct bus_type iio_bus_type = {
42 43
	.name = "iio",
};
44
EXPORT_SYMBOL(iio_bus_type);
45

46 47
static struct dentry *iio_debugfs_dentry;

48 49 50 51 52
static const char * const iio_direction[] = {
	[0] = "in",
	[1] = "out",
};

53
static const char * const iio_chan_type_name_spec[] = {
54
	[IIO_VOLTAGE] = "voltage",
55 56
	[IIO_CURRENT] = "current",
	[IIO_POWER] = "power",
57
	[IIO_ACCEL] = "accel",
58
	[IIO_ANGL_VEL] = "anglvel",
59
	[IIO_MAGN] = "magn",
60 61
	[IIO_LIGHT] = "illuminance",
	[IIO_INTENSITY] = "intensity",
62
	[IIO_PROXIMITY] = "proximity",
63
	[IIO_TEMP] = "temp",
64 65 66
	[IIO_INCLI] = "incli",
	[IIO_ROT] = "rot",
	[IIO_ANGL] = "angl",
67
	[IIO_TIMESTAMP] = "timestamp",
68
	[IIO_CAPACITANCE] = "capacitance",
69
	[IIO_ALTVOLTAGE] = "altvoltage",
70
	[IIO_CCT] = "cct",
71
	[IIO_PRESSURE] = "pressure",
72
	[IIO_HUMIDITYRELATIVE] = "humidityrelative",
73
	[IIO_ACTIVITY] = "activity",
74
	[IIO_STEPS] = "steps",
75 76
};

77
static const char * const iio_modifier_names[] = {
78 79 80
	[IIO_MOD_X] = "x",
	[IIO_MOD_Y] = "y",
	[IIO_MOD_Z] = "z",
81
	[IIO_MOD_ROOT_SUM_SQUARED_X_Y] = "sqrt(x^2+y^2)",
82
	[IIO_MOD_SUM_SQUARED_X_Y_Z] = "x^2+y^2+z^2",
83 84
	[IIO_MOD_LIGHT_BOTH] = "both",
	[IIO_MOD_LIGHT_IR] = "ir",
85 86 87 88
	[IIO_MOD_LIGHT_CLEAR] = "clear",
	[IIO_MOD_LIGHT_RED] = "red",
	[IIO_MOD_LIGHT_GREEN] = "green",
	[IIO_MOD_LIGHT_BLUE] = "blue",
89
	[IIO_MOD_QUATERNION] = "quaternion",
90 91
	[IIO_MOD_TEMP_AMBIENT] = "ambient",
	[IIO_MOD_TEMP_OBJECT] = "object",
92 93 94 95
	[IIO_MOD_NORTH_MAGN] = "from_north_magnetic",
	[IIO_MOD_NORTH_TRUE] = "from_north_true",
	[IIO_MOD_NORTH_MAGN_TILT_COMP] = "from_north_magnetic_tilt_comp",
	[IIO_MOD_NORTH_TRUE_TILT_COMP] = "from_north_true_tilt_comp",
96 97 98 99
	[IIO_MOD_RUNNING] = "running",
	[IIO_MOD_JOGGING] = "jogging",
	[IIO_MOD_WALKING] = "walking",
	[IIO_MOD_STILL] = "still",
100 101 102 103
};

/* relies on pairs of these shared then separate */
static const char * const iio_chan_info_postfix[] = {
104 105
	[IIO_CHAN_INFO_RAW] = "raw",
	[IIO_CHAN_INFO_PROCESSED] = "input",
106 107 108 109 110 111 112 113
	[IIO_CHAN_INFO_SCALE] = "scale",
	[IIO_CHAN_INFO_OFFSET] = "offset",
	[IIO_CHAN_INFO_CALIBSCALE] = "calibscale",
	[IIO_CHAN_INFO_CALIBBIAS] = "calibbias",
	[IIO_CHAN_INFO_PEAK] = "peak_raw",
	[IIO_CHAN_INFO_PEAK_SCALE] = "peak_scale",
	[IIO_CHAN_INFO_QUADRATURE_CORRECTION_RAW] = "quadrature_correction_raw",
	[IIO_CHAN_INFO_AVERAGE_RAW] = "mean_raw",
114 115
	[IIO_CHAN_INFO_LOW_PASS_FILTER_3DB_FREQUENCY]
	= "filter_low_pass_3db_frequency",
116
	[IIO_CHAN_INFO_SAMP_FREQ] = "sampling_frequency",
117 118
	[IIO_CHAN_INFO_FREQUENCY] = "frequency",
	[IIO_CHAN_INFO_PHASE] = "phase",
119
	[IIO_CHAN_INFO_HARDWAREGAIN] = "hardwaregain",
120
	[IIO_CHAN_INFO_HYSTERESIS] = "hysteresis",
121
	[IIO_CHAN_INFO_INT_TIME] = "integration_time",
122
	[IIO_CHAN_INFO_ENABLE] = "en",
123
	[IIO_CHAN_INFO_CALIBHEIGHT] = "calibheight",
124 125
};

126 127 128 129 130
/**
 * iio_find_channel_from_si() - get channel from its scan index
 * @indio_dev:		device
 * @si:			scan index to match
 */
131 132 133 134 135 136 137 138 139 140 141
const struct iio_chan_spec
*iio_find_channel_from_si(struct iio_dev *indio_dev, int si)
{
	int i;

	for (i = 0; i < indio_dev->num_channels; i++)
		if (indio_dev->channels[i].scan_index == si)
			return &indio_dev->channels[i];
	return NULL;
}

142 143 144 145 146 147 148 149 150 151 152 153 154
/* This turns up an awful lot */
ssize_t iio_read_const_attr(struct device *dev,
			    struct device_attribute *attr,
			    char *buf)
{
	return sprintf(buf, "%s\n", to_iio_const_attr(attr)->string);
}
EXPORT_SYMBOL(iio_read_const_attr);

static int __init iio_init(void)
{
	int ret;

155 156
	/* Register sysfs bus */
	ret  = bus_register(&iio_bus_type);
157
	if (ret < 0) {
158
		pr_err("could not register bus type\n");
159 160 161
		goto error_nothing;
	}

162 163
	ret = alloc_chrdev_region(&iio_devt, 0, IIO_DEV_MAX, "iio");
	if (ret < 0) {
164
		pr_err("failed to allocate char dev region\n");
165
		goto error_unregister_bus_type;
166
	}
167

168 169
	iio_debugfs_dentry = debugfs_create_dir("iio", NULL);

170 171
	return 0;

172 173
error_unregister_bus_type:
	bus_unregister(&iio_bus_type);
174 175 176 177 178 179
error_nothing:
	return ret;
}

static void __exit iio_exit(void)
{
180 181
	if (iio_devt)
		unregister_chrdev_region(iio_devt, IIO_DEV_MAX);
182
	bus_unregister(&iio_bus_type);
183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244
	debugfs_remove(iio_debugfs_dentry);
}

#if defined(CONFIG_DEBUG_FS)
static ssize_t iio_debugfs_read_reg(struct file *file, char __user *userbuf,
			      size_t count, loff_t *ppos)
{
	struct iio_dev *indio_dev = file->private_data;
	char buf[20];
	unsigned val = 0;
	ssize_t len;
	int ret;

	ret = indio_dev->info->debugfs_reg_access(indio_dev,
						  indio_dev->cached_reg_addr,
						  0, &val);
	if (ret)
		dev_err(indio_dev->dev.parent, "%s: read failed\n", __func__);

	len = snprintf(buf, sizeof(buf), "0x%X\n", val);

	return simple_read_from_buffer(userbuf, count, ppos, buf, len);
}

static ssize_t iio_debugfs_write_reg(struct file *file,
		     const char __user *userbuf, size_t count, loff_t *ppos)
{
	struct iio_dev *indio_dev = file->private_data;
	unsigned reg, val;
	char buf[80];
	int ret;

	count = min_t(size_t, count, (sizeof(buf)-1));
	if (copy_from_user(buf, userbuf, count))
		return -EFAULT;

	buf[count] = 0;

	ret = sscanf(buf, "%i %i", &reg, &val);

	switch (ret) {
	case 1:
		indio_dev->cached_reg_addr = reg;
		break;
	case 2:
		indio_dev->cached_reg_addr = reg;
		ret = indio_dev->info->debugfs_reg_access(indio_dev, reg,
							  val, NULL);
		if (ret) {
			dev_err(indio_dev->dev.parent, "%s: write failed\n",
				__func__);
			return ret;
		}
		break;
	default:
		return -EINVAL;
	}

	return count;
}

static const struct file_operations iio_debugfs_reg_fops = {
245
	.open = simple_open,
246 247 248 249 250 251 252
	.read = iio_debugfs_read_reg,
	.write = iio_debugfs_write_reg,
};

static void iio_device_unregister_debugfs(struct iio_dev *indio_dev)
{
	debugfs_remove_recursive(indio_dev->debugfs_dentry);
253 254
}

255 256 257 258 259 260 261
static int iio_device_register_debugfs(struct iio_dev *indio_dev)
{
	struct dentry *d;

	if (indio_dev->info->debugfs_reg_access == NULL)
		return 0;

262
	if (!iio_debugfs_dentry)
263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294
		return 0;

	indio_dev->debugfs_dentry =
		debugfs_create_dir(dev_name(&indio_dev->dev),
				   iio_debugfs_dentry);
	if (indio_dev->debugfs_dentry == NULL) {
		dev_warn(indio_dev->dev.parent,
			 "Failed to create debugfs directory\n");
		return -EFAULT;
	}

	d = debugfs_create_file("direct_reg_access", 0644,
				indio_dev->debugfs_dentry,
				indio_dev, &iio_debugfs_reg_fops);
	if (!d) {
		iio_device_unregister_debugfs(indio_dev);
		return -ENOMEM;
	}

	return 0;
}
#else
static int iio_device_register_debugfs(struct iio_dev *indio_dev)
{
	return 0;
}

static void iio_device_unregister_debugfs(struct iio_dev *indio_dev)
{
}
#endif /* CONFIG_DEBUG_FS */

295 296 297 298
static ssize_t iio_read_channel_ext_info(struct device *dev,
				     struct device_attribute *attr,
				     char *buf)
{
L
Lars-Peter Clausen 已提交
299
	struct iio_dev *indio_dev = dev_to_iio_dev(dev);
300 301 302 303 304
	struct iio_dev_attr *this_attr = to_iio_dev_attr(attr);
	const struct iio_chan_spec_ext_info *ext_info;

	ext_info = &this_attr->c->ext_info[this_attr->address];

305
	return ext_info->read(indio_dev, ext_info->private, this_attr->c, buf);
306 307 308 309 310 311 312
}

static ssize_t iio_write_channel_ext_info(struct device *dev,
				     struct device_attribute *attr,
				     const char *buf,
					 size_t len)
{
L
Lars-Peter Clausen 已提交
313
	struct iio_dev *indio_dev = dev_to_iio_dev(dev);
314 315 316 317 318
	struct iio_dev_attr *this_attr = to_iio_dev_attr(attr);
	const struct iio_chan_spec_ext_info *ext_info;

	ext_info = &this_attr->c->ext_info[this_attr->address];

319 320
	return ext_info->write(indio_dev, ext_info->private,
			       this_attr->c, buf, len);
321 322
}

323 324 325 326 327 328 329 330 331 332 333
ssize_t iio_enum_available_read(struct iio_dev *indio_dev,
	uintptr_t priv, const struct iio_chan_spec *chan, char *buf)
{
	const struct iio_enum *e = (const struct iio_enum *)priv;
	unsigned int i;
	size_t len = 0;

	if (!e->num_items)
		return 0;

	for (i = 0; i < e->num_items; ++i)
334
		len += scnprintf(buf + len, PAGE_SIZE - len, "%s ", e->items[i]);
335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357

	/* replace last space with a newline */
	buf[len - 1] = '\n';

	return len;
}
EXPORT_SYMBOL_GPL(iio_enum_available_read);

ssize_t iio_enum_read(struct iio_dev *indio_dev,
	uintptr_t priv, const struct iio_chan_spec *chan, char *buf)
{
	const struct iio_enum *e = (const struct iio_enum *)priv;
	int i;

	if (!e->get)
		return -EINVAL;

	i = e->get(indio_dev, chan);
	if (i < 0)
		return i;
	else if (i >= e->num_items)
		return -EINVAL;

358
	return snprintf(buf, PAGE_SIZE, "%s\n", e->items[i]);
359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385
}
EXPORT_SYMBOL_GPL(iio_enum_read);

ssize_t iio_enum_write(struct iio_dev *indio_dev,
	uintptr_t priv, const struct iio_chan_spec *chan, const char *buf,
	size_t len)
{
	const struct iio_enum *e = (const struct iio_enum *)priv;
	unsigned int i;
	int ret;

	if (!e->set)
		return -EINVAL;

	for (i = 0; i < e->num_items; i++) {
		if (sysfs_streq(buf, e->items[i]))
			break;
	}

	if (i == e->num_items)
		return -EINVAL;

	ret = e->set(indio_dev, chan, i);
	return ret ? ret : len;
}
EXPORT_SYMBOL_GPL(iio_enum_write);

386 387 388 389 390
/**
 * iio_format_value() - Formats a IIO value into its string representation
 * @buf: The buffer to which the formated value gets written
 * @type: One of the IIO_VAL_... constants. This decides how the val and val2
 *        parameters are formatted.
391
 * @vals: pointer to the values, exact meaning depends on the type parameter.
392
 */
393
ssize_t iio_format_value(char *buf, unsigned int type, int size, int *vals)
394
{
395
	unsigned long long tmp;
396
	bool scale_db = false;
397

398
	switch (type) {
399
	case IIO_VAL_INT:
400
		return sprintf(buf, "%d\n", vals[0]);
401 402 403
	case IIO_VAL_INT_PLUS_MICRO_DB:
		scale_db = true;
	case IIO_VAL_INT_PLUS_MICRO:
404 405 406
		if (vals[1] < 0)
			return sprintf(buf, "-%ld.%06u%s\n", abs(vals[0]),
					-vals[1],
407
				scale_db ? " dB" : "");
408
		else
409
			return sprintf(buf, "%d.%06u%s\n", vals[0], vals[1],
410 411
				scale_db ? " dB" : "");
	case IIO_VAL_INT_PLUS_NANO:
412 413 414
		if (vals[1] < 0)
			return sprintf(buf, "-%ld.%09u\n", abs(vals[0]),
					-vals[1]);
415
		else
416
			return sprintf(buf, "%d.%09u\n", vals[0], vals[1]);
417
	case IIO_VAL_FRACTIONAL:
418 419 420 421
		tmp = div_s64((s64)vals[0] * 1000000000LL, vals[1]);
		vals[1] = do_div(tmp, 1000000000LL);
		vals[0] = tmp;
		return sprintf(buf, "%d.%09u\n", vals[0], vals[1]);
422
	case IIO_VAL_FRACTIONAL_LOG2:
423 424 425 426 427 428 429 430 431 432 433 434 435 436 437
		tmp = (s64)vals[0] * 1000000000LL >> vals[1];
		vals[1] = do_div(tmp, 1000000000LL);
		vals[0] = tmp;
		return sprintf(buf, "%d.%09u\n", vals[0], vals[1]);
	case IIO_VAL_INT_MULTIPLE:
	{
		int i;
		int len = 0;

		for (i = 0; i < size; ++i)
			len += snprintf(&buf[len], PAGE_SIZE - len, "%d ",
								vals[i]);
		len += snprintf(&buf[len], PAGE_SIZE - len, "\n");
		return len;
	}
438
	default:
439
		return 0;
440
	}
441 442
}

443 444 445 446 447 448
static ssize_t iio_read_channel_info(struct device *dev,
				     struct device_attribute *attr,
				     char *buf)
{
	struct iio_dev *indio_dev = dev_to_iio_dev(dev);
	struct iio_dev_attr *this_attr = to_iio_dev_attr(attr);
449 450 451 452 453 454 455 456 457 458 459 460
	int vals[INDIO_MAX_RAW_ELEMENTS];
	int ret;
	int val_len = 2;

	if (indio_dev->info->read_raw_multi)
		ret = indio_dev->info->read_raw_multi(indio_dev, this_attr->c,
							INDIO_MAX_RAW_ELEMENTS,
							vals, &val_len,
							this_attr->address);
	else
		ret = indio_dev->info->read_raw(indio_dev, this_attr->c,
				    &vals[0], &vals[1], this_attr->address);
461 462 463 464

	if (ret < 0)
		return ret;

465
	return iio_format_value(buf, ret, val_len, vals);
466 467
}

468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525
/**
 * iio_str_to_fixpoint() - Parse a fixed-point number from a string
 * @str: The string to parse
 * @fract_mult: Multiplier for the first decimal place, should be a power of 10
 * @integer: The integer part of the number
 * @fract: The fractional part of the number
 *
 * Returns 0 on success, or a negative error code if the string could not be
 * parsed.
 */
int iio_str_to_fixpoint(const char *str, int fract_mult,
	int *integer, int *fract)
{
	int i = 0, f = 0;
	bool integer_part = true, negative = false;

	if (str[0] == '-') {
		negative = true;
		str++;
	} else if (str[0] == '+') {
		str++;
	}

	while (*str) {
		if ('0' <= *str && *str <= '9') {
			if (integer_part) {
				i = i * 10 + *str - '0';
			} else {
				f += fract_mult * (*str - '0');
				fract_mult /= 10;
			}
		} else if (*str == '\n') {
			if (*(str + 1) == '\0')
				break;
			else
				return -EINVAL;
		} else if (*str == '.' && integer_part) {
			integer_part = false;
		} else {
			return -EINVAL;
		}
		str++;
	}

	if (negative) {
		if (i)
			i = -i;
		else
			f = -f;
	}

	*integer = i;
	*fract = f;

	return 0;
}
EXPORT_SYMBOL_GPL(iio_str_to_fixpoint);

526 527 528 529 530
static ssize_t iio_write_channel_info(struct device *dev,
				      struct device_attribute *attr,
				      const char *buf,
				      size_t len)
{
L
Lars-Peter Clausen 已提交
531
	struct iio_dev *indio_dev = dev_to_iio_dev(dev);
532
	struct iio_dev_attr *this_attr = to_iio_dev_attr(attr);
533 534
	int ret, fract_mult = 100000;
	int integer, fract;
535 536

	/* Assumes decimal - precision based on number of digits */
537
	if (!indio_dev->info->write_raw)
538
		return -EINVAL;
539 540 541 542 543 544 545 546 547 548 549 550 551 552

	if (indio_dev->info->write_raw_get_fmt)
		switch (indio_dev->info->write_raw_get_fmt(indio_dev,
			this_attr->c, this_attr->address)) {
		case IIO_VAL_INT_PLUS_MICRO:
			fract_mult = 100000;
			break;
		case IIO_VAL_INT_PLUS_NANO:
			fract_mult = 100000000;
			break;
		default:
			return -EINVAL;
		}

553 554 555
	ret = iio_str_to_fixpoint(buf, fract_mult, &integer, &fract);
	if (ret)
		return ret;
556

557
	ret = indio_dev->info->write_raw(indio_dev, this_attr->c,
558
					 integer, fract, this_attr->address);
559 560 561 562 563 564
	if (ret)
		return ret;

	return len;
}

565
static
566 567 568 569 570 571 572 573 574 575
int __iio_device_attr_init(struct device_attribute *dev_attr,
			   const char *postfix,
			   struct iio_chan_spec const *chan,
			   ssize_t (*readfunc)(struct device *dev,
					       struct device_attribute *attr,
					       char *buf),
			   ssize_t (*writefunc)(struct device *dev,
						struct device_attribute *attr,
						const char *buf,
						size_t len),
576
			   enum iio_shared_by shared_by)
577
{
578
	int ret = 0;
579
	char *name = NULL;
580
	char *full_postfix;
581 582
	sysfs_attr_init(&dev_attr->attr);

583
	/* Build up postfix of <extend_name>_<modifier>_postfix */
584
	if (chan->modified && (shared_by == IIO_SEPARATE)) {
585 586 587 588 589 590 591 592 593 594 595 596
		if (chan->extend_name)
			full_postfix = kasprintf(GFP_KERNEL, "%s_%s_%s",
						 iio_modifier_names[chan
								    ->channel2],
						 chan->extend_name,
						 postfix);
		else
			full_postfix = kasprintf(GFP_KERNEL, "%s_%s",
						 iio_modifier_names[chan
								    ->channel2],
						 postfix);
	} else {
597
		if (chan->extend_name == NULL || shared_by != IIO_SEPARATE)
598 599 600 601 602 603 604
			full_postfix = kstrdup(postfix, GFP_KERNEL);
		else
			full_postfix = kasprintf(GFP_KERNEL,
						 "%s_%s",
						 chan->extend_name,
						 postfix);
	}
605 606
	if (full_postfix == NULL)
		return -ENOMEM;
607

608
	if (chan->differential) { /* Differential can not have modifier */
609
		switch (shared_by) {
610
		case IIO_SHARED_BY_ALL:
611
			name = kasprintf(GFP_KERNEL, "%s", full_postfix);
612 613
			break;
		case IIO_SHARED_BY_DIR:
614
			name = kasprintf(GFP_KERNEL, "%s_%s",
615 616 617
						iio_direction[chan->output],
						full_postfix);
			break;
618
		case IIO_SHARED_BY_TYPE:
619
			name = kasprintf(GFP_KERNEL, "%s_%s-%s_%s",
620 621 622 623
					    iio_direction[chan->output],
					    iio_chan_type_name_spec[chan->type],
					    iio_chan_type_name_spec[chan->type],
					    full_postfix);
624 625 626 627 628 629 630
			break;
		case IIO_SEPARATE:
			if (!chan->indexed) {
				WARN_ON("Differential channels must be indexed\n");
				ret = -EINVAL;
				goto error_free_full_postfix;
			}
631
			name = kasprintf(GFP_KERNEL,
632
					    "%s_%s%d-%s%d_%s",
633 634 635 636 637 638
					    iio_direction[chan->output],
					    iio_chan_type_name_spec[chan->type],
					    chan->channel,
					    iio_chan_type_name_spec[chan->type],
					    chan->channel2,
					    full_postfix);
639
			break;
640 641
		}
	} else { /* Single ended */
642
		switch (shared_by) {
643
		case IIO_SHARED_BY_ALL:
644
			name = kasprintf(GFP_KERNEL, "%s", full_postfix);
645 646
			break;
		case IIO_SHARED_BY_DIR:
647
			name = kasprintf(GFP_KERNEL, "%s_%s",
648 649 650
						iio_direction[chan->output],
						full_postfix);
			break;
651
		case IIO_SHARED_BY_TYPE:
652
			name = kasprintf(GFP_KERNEL, "%s_%s_%s",
653 654 655
					    iio_direction[chan->output],
					    iio_chan_type_name_spec[chan->type],
					    full_postfix);
656 657 658 659
			break;

		case IIO_SEPARATE:
			if (chan->indexed)
660
				name = kasprintf(GFP_KERNEL, "%s_%s%d_%s",
661 662 663 664 665
						    iio_direction[chan->output],
						    iio_chan_type_name_spec[chan->type],
						    chan->channel,
						    full_postfix);
			else
666
				name = kasprintf(GFP_KERNEL, "%s_%s_%s",
667 668 669 670 671
						    iio_direction[chan->output],
						    iio_chan_type_name_spec[chan->type],
						    full_postfix);
			break;
		}
672
	}
673
	if (name == NULL) {
674 675 676
		ret = -ENOMEM;
		goto error_free_full_postfix;
	}
677
	dev_attr->attr.name = name;
678 679 680 681 682 683 684 685 686 687

	if (readfunc) {
		dev_attr->attr.mode |= S_IRUGO;
		dev_attr->show = readfunc;
	}

	if (writefunc) {
		dev_attr->attr.mode |= S_IWUSR;
		dev_attr->store = writefunc;
	}
688

689 690
error_free_full_postfix:
	kfree(full_postfix);
691

692 693 694
	return ret;
}

695
static void __iio_device_attr_deinit(struct device_attribute *dev_attr)
696 697 698 699 700 701 702 703 704 705 706 707 708
{
	kfree(dev_attr->attr.name);
}

int __iio_add_chan_devattr(const char *postfix,
			   struct iio_chan_spec const *chan,
			   ssize_t (*readfunc)(struct device *dev,
					       struct device_attribute *attr,
					       char *buf),
			   ssize_t (*writefunc)(struct device *dev,
						struct device_attribute *attr,
						const char *buf,
						size_t len),
709
			   u64 mask,
710
			   enum iio_shared_by shared_by,
711 712 713 714 715 716
			   struct device *dev,
			   struct list_head *attr_list)
{
	int ret;
	struct iio_dev_attr *iio_attr, *t;

S
Sachin Kamat 已提交
717
	iio_attr = kzalloc(sizeof(*iio_attr), GFP_KERNEL);
718 719
	if (iio_attr == NULL)
		return -ENOMEM;
720 721
	ret = __iio_device_attr_init(&iio_attr->dev_attr,
				     postfix, chan,
722
				     readfunc, writefunc, shared_by);
723 724 725 726 727 728 729
	if (ret)
		goto error_iio_dev_attr_free;
	iio_attr->c = chan;
	iio_attr->address = mask;
	list_for_each_entry(t, attr_list, l)
		if (strcmp(t->dev_attr.attr.name,
			   iio_attr->dev_attr.attr.name) == 0) {
730
			if (shared_by == IIO_SEPARATE)
731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746
				dev_err(dev, "tried to double register : %s\n",
					t->dev_attr.attr.name);
			ret = -EBUSY;
			goto error_device_attr_deinit;
		}
	list_add(&iio_attr->l, attr_list);

	return 0;

error_device_attr_deinit:
	__iio_device_attr_deinit(&iio_attr->dev_attr);
error_iio_dev_attr_free:
	kfree(iio_attr);
	return ret;
}

747 748 749 750
static int iio_device_add_info_mask_type(struct iio_dev *indio_dev,
					 struct iio_chan_spec const *chan,
					 enum iio_shared_by shared_by,
					 const long *infomask)
751
{
752
	int i, ret, attrcount = 0;
753

754
	for_each_set_bit(i, infomask, sizeof(infomask)*8) {
755 756
		if (i >= ARRAY_SIZE(iio_chan_info_postfix))
			return -EINVAL;
757 758 759 760 761
		ret = __iio_add_chan_devattr(iio_chan_info_postfix[i],
					     chan,
					     &iio_read_channel_info,
					     &iio_write_channel_info,
					     i,
762
					     shared_by,
763 764
					     &indio_dev->dev,
					     &indio_dev->channel_attr_list);
765
		if ((ret == -EBUSY) && (shared_by != IIO_SEPARATE))
766
			continue;
767 768
		else if (ret < 0)
			return ret;
769 770
		attrcount++;
	}
771

772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796
	return attrcount;
}

static int iio_device_add_channel_sysfs(struct iio_dev *indio_dev,
					struct iio_chan_spec const *chan)
{
	int ret, attrcount = 0;
	const struct iio_chan_spec_ext_info *ext_info;

	if (chan->channel < 0)
		return 0;
	ret = iio_device_add_info_mask_type(indio_dev, chan,
					    IIO_SEPARATE,
					    &chan->info_mask_separate);
	if (ret < 0)
		return ret;
	attrcount += ret;

	ret = iio_device_add_info_mask_type(indio_dev, chan,
					    IIO_SHARED_BY_TYPE,
					    &chan->info_mask_shared_by_type);
	if (ret < 0)
		return ret;
	attrcount += ret;

797 798 799 800 801 802 803 804 805 806 807 808 809 810
	ret = iio_device_add_info_mask_type(indio_dev, chan,
					    IIO_SHARED_BY_DIR,
					    &chan->info_mask_shared_by_dir);
	if (ret < 0)
		return ret;
	attrcount += ret;

	ret = iio_device_add_info_mask_type(indio_dev, chan,
					    IIO_SHARED_BY_ALL,
					    &chan->info_mask_shared_by_all);
	if (ret < 0)
		return ret;
	attrcount += ret;

811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828
	if (chan->ext_info) {
		unsigned int i = 0;
		for (ext_info = chan->ext_info; ext_info->name; ext_info++) {
			ret = __iio_add_chan_devattr(ext_info->name,
					chan,
					ext_info->read ?
					    &iio_read_channel_ext_info : NULL,
					ext_info->write ?
					    &iio_write_channel_ext_info : NULL,
					i,
					ext_info->shared,
					&indio_dev->dev,
					&indio_dev->channel_attr_list);
			i++;
			if (ret == -EBUSY && ext_info->shared)
				continue;

			if (ret)
829
				return ret;
830 831 832 833 834

			attrcount++;
		}
	}

835
	return attrcount;
836 837
}

838 839 840 841 842 843 844 845 846
/**
 * iio_free_chan_devattr_list() - Free a list of IIO device attributes
 * @attr_list: List of IIO device attributes
 *
 * This function frees the memory allocated for each of the IIO device
 * attributes in the list. Note: if you want to reuse the list after calling
 * this function you have to reinitialize it using INIT_LIST_HEAD().
 */
void iio_free_chan_devattr_list(struct list_head *attr_list)
847
{
848 849 850 851 852 853
	struct iio_dev_attr *p, *n;

	list_for_each_entry_safe(p, n, attr_list, l) {
		kfree(p->dev_attr.attr.name);
		kfree(p);
	}
854 855
}

856 857 858 859
static ssize_t iio_show_dev_name(struct device *dev,
				 struct device_attribute *attr,
				 char *buf)
{
L
Lars-Peter Clausen 已提交
860
	struct iio_dev *indio_dev = dev_to_iio_dev(dev);
861
	return snprintf(buf, PAGE_SIZE, "%s\n", indio_dev->name);
862 863 864 865
}

static DEVICE_ATTR(name, S_IRUGO, iio_show_dev_name, NULL);

866
static int iio_device_register_sysfs(struct iio_dev *indio_dev)
867
{
868
	int i, ret = 0, attrcount, attrn, attrcount_orig = 0;
869
	struct iio_dev_attr *p;
870
	struct attribute **attr;
871

872
	/* First count elements in any existing group */
873 874
	if (indio_dev->info->attrs) {
		attr = indio_dev->info->attrs->attrs;
875 876
		while (*attr++ != NULL)
			attrcount_orig++;
877
	}
878
	attrcount = attrcount_orig;
879 880
	/*
	 * New channel registration method - relies on the fact a group does
P
Peter Meerwald 已提交
881
	 * not need to be initialized if its name is NULL.
882
	 */
883 884 885 886
	if (indio_dev->channels)
		for (i = 0; i < indio_dev->num_channels; i++) {
			ret = iio_device_add_channel_sysfs(indio_dev,
							   &indio_dev
887 888 889
							   ->channels[i]);
			if (ret < 0)
				goto error_clear_attrs;
890
			attrcount += ret;
891
		}
892

893
	if (indio_dev->name)
894 895
		attrcount++;

896 897 898
	indio_dev->chan_attr_group.attrs = kcalloc(attrcount + 1,
						   sizeof(indio_dev->chan_attr_group.attrs[0]),
						   GFP_KERNEL);
899
	if (indio_dev->chan_attr_group.attrs == NULL) {
900 901
		ret = -ENOMEM;
		goto error_clear_attrs;
902
	}
903
	/* Copy across original attributes */
904 905 906 907
	if (indio_dev->info->attrs)
		memcpy(indio_dev->chan_attr_group.attrs,
		       indio_dev->info->attrs->attrs,
		       sizeof(indio_dev->chan_attr_group.attrs[0])
908 909 910
		       *attrcount_orig);
	attrn = attrcount_orig;
	/* Add all elements from the list. */
911 912 913 914
	list_for_each_entry(p, &indio_dev->channel_attr_list, l)
		indio_dev->chan_attr_group.attrs[attrn++] = &p->dev_attr.attr;
	if (indio_dev->name)
		indio_dev->chan_attr_group.attrs[attrn++] = &dev_attr_name.attr;
915

916 917
	indio_dev->groups[indio_dev->groupcounter++] =
		&indio_dev->chan_attr_group;
918

919
	return 0;
920

921
error_clear_attrs:
922
	iio_free_chan_devattr_list(&indio_dev->channel_attr_list);
923

924
	return ret;
925 926
}

927
static void iio_device_unregister_sysfs(struct iio_dev *indio_dev)
928
{
929

930
	iio_free_chan_devattr_list(&indio_dev->channel_attr_list);
931
	kfree(indio_dev->chan_attr_group.attrs);
932 933 934 935
}

static void iio_dev_release(struct device *device)
{
L
Lars-Peter Clausen 已提交
936
	struct iio_dev *indio_dev = dev_to_iio_dev(device);
937 938 939 940
	if (indio_dev->modes & INDIO_BUFFER_TRIGGERED)
		iio_device_unregister_trigger_consumer(indio_dev);
	iio_device_unregister_eventset(indio_dev);
	iio_device_unregister_sysfs(indio_dev);
941

942 943
	iio_buffer_put(indio_dev->buffer);

944 945
	ida_simple_remove(&iio_ida, indio_dev->id);
	kfree(indio_dev);
946 947
}

G
Guenter Roeck 已提交
948
struct device_type iio_device_type = {
949 950 951 952
	.name = "iio_device",
	.release = iio_dev_release,
};

953 954 955 956
/**
 * iio_device_alloc() - allocate an iio_dev from a driver
 * @sizeof_priv:	Space to allocate for private structure.
 **/
957
struct iio_dev *iio_device_alloc(int sizeof_priv)
958
{
959 960 961 962 963 964 965 966 967 968 969 970
	struct iio_dev *dev;
	size_t alloc_size;

	alloc_size = sizeof(struct iio_dev);
	if (sizeof_priv) {
		alloc_size = ALIGN(alloc_size, IIO_ALIGN);
		alloc_size += sizeof_priv;
	}
	/* ensure 32-byte alignment of whole construct ? */
	alloc_size += IIO_ALIGN - 1;

	dev = kzalloc(alloc_size, GFP_KERNEL);
971 972

	if (dev) {
973
		dev->dev.groups = dev->groups;
G
Guenter Roeck 已提交
974
		dev->dev.type = &iio_device_type;
975
		dev->dev.bus = &iio_bus_type;
976 977 978
		device_initialize(&dev->dev);
		dev_set_drvdata(&dev->dev, (void *)dev);
		mutex_init(&dev->mlock);
979
		mutex_init(&dev->info_exist_lock);
980
		INIT_LIST_HEAD(&dev->channel_attr_list);
981 982 983 984

		dev->id = ida_simple_get(&iio_ida, 0, 0, GFP_KERNEL);
		if (dev->id < 0) {
			/* cannot use a dev_err as the name isn't available */
985
			pr_err("failed to get device id\n");
986 987 988 989
			kfree(dev);
			return NULL;
		}
		dev_set_name(&dev->dev, "iio:device%d", dev->id);
990
		INIT_LIST_HEAD(&dev->buffer_list);
991 992 993 994
	}

	return dev;
}
995
EXPORT_SYMBOL(iio_device_alloc);
996

997 998 999 1000
/**
 * iio_device_free() - free an iio_dev from a driver
 * @dev:		the iio_dev associated with the device
 **/
1001
void iio_device_free(struct iio_dev *dev)
1002
{
1003 1004
	if (dev)
		put_device(&dev->dev);
1005
}
1006
EXPORT_SYMBOL(iio_device_free);
1007

1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022
static void devm_iio_device_release(struct device *dev, void *res)
{
	iio_device_free(*(struct iio_dev **)res);
}

static int devm_iio_device_match(struct device *dev, void *res, void *data)
{
	struct iio_dev **r = res;
	if (!r || !*r) {
		WARN_ON(!r || !*r);
		return 0;
	}
	return *r == data;
}

1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036
/**
 * devm_iio_device_alloc - Resource-managed iio_device_alloc()
 * @dev:		Device to allocate iio_dev for
 * @sizeof_priv:	Space to allocate for private structure.
 *
 * Managed iio_device_alloc. iio_dev allocated with this function is
 * automatically freed on driver detach.
 *
 * If an iio_dev allocated with this function needs to be freed separately,
 * devm_iio_device_free() must be used.
 *
 * RETURNS:
 * Pointer to allocated iio_dev on success, NULL on failure.
 */
1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057
struct iio_dev *devm_iio_device_alloc(struct device *dev, int sizeof_priv)
{
	struct iio_dev **ptr, *iio_dev;

	ptr = devres_alloc(devm_iio_device_release, sizeof(*ptr),
			   GFP_KERNEL);
	if (!ptr)
		return NULL;

	iio_dev = iio_device_alloc(sizeof_priv);
	if (iio_dev) {
		*ptr = iio_dev;
		devres_add(dev, ptr);
	} else {
		devres_free(ptr);
	}

	return iio_dev;
}
EXPORT_SYMBOL_GPL(devm_iio_device_alloc);

1058 1059 1060 1061 1062 1063 1064
/**
 * devm_iio_device_free - Resource-managed iio_device_free()
 * @dev:		Device this iio_dev belongs to
 * @iio_dev:		the iio_dev associated with the device
 *
 * Free iio_dev allocated with devm_iio_device_alloc().
 */
1065 1066 1067 1068 1069 1070 1071 1072 1073 1074
void devm_iio_device_free(struct device *dev, struct iio_dev *iio_dev)
{
	int rc;

	rc = devres_release(dev, devm_iio_device_release,
			    devm_iio_device_match, iio_dev);
	WARN_ON(rc);
}
EXPORT_SYMBOL_GPL(devm_iio_device_free);

1075
/**
1076
 * iio_chrdev_open() - chrdev file open for buffer access and ioctls
1077 1078 1079
 **/
static int iio_chrdev_open(struct inode *inode, struct file *filp)
{
1080
	struct iio_dev *indio_dev = container_of(inode->i_cdev,
1081
						struct iio_dev, chrdev);
1082 1083 1084 1085

	if (test_and_set_bit(IIO_BUSY_BIT_POS, &indio_dev->flags))
		return -EBUSY;

1086 1087
	iio_device_get(indio_dev);

1088
	filp->private_data = indio_dev;
1089

1090
	return 0;
1091 1092 1093
}

/**
1094
 * iio_chrdev_release() - chrdev file close buffer access and ioctls
1095 1096 1097
 **/
static int iio_chrdev_release(struct inode *inode, struct file *filp)
{
1098 1099 1100
	struct iio_dev *indio_dev = container_of(inode->i_cdev,
						struct iio_dev, chrdev);
	clear_bit(IIO_BUSY_BIT_POS, &indio_dev->flags);
1101 1102
	iio_device_put(indio_dev);

1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113
	return 0;
}

/* Somewhat of a cross file organization violation - ioctls here are actually
 * event related */
static long iio_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
	struct iio_dev *indio_dev = filp->private_data;
	int __user *ip = (int __user *)arg;
	int fd;

1114 1115 1116
	if (!indio_dev->info)
		return -ENODEV;

1117 1118 1119 1120 1121 1122 1123 1124 1125
	if (cmd == IIO_GET_EVENT_FD_IOCTL) {
		fd = iio_event_getfd(indio_dev);
		if (copy_to_user(ip, &fd, sizeof(fd)))
			return -EFAULT;
		return 0;
	}
	return -EINVAL;
}

1126 1127
static const struct file_operations iio_buffer_fileops = {
	.read = iio_buffer_read_first_n_outer_addr,
1128 1129
	.release = iio_chrdev_release,
	.open = iio_chrdev_open,
1130
	.poll = iio_buffer_poll_addr,
1131 1132 1133 1134 1135 1136
	.owner = THIS_MODULE,
	.llseek = noop_llseek,
	.unlocked_ioctl = iio_ioctl,
	.compat_ioctl = iio_ioctl,
};

1137 1138
static const struct iio_buffer_setup_ops noop_ring_setup_ops;

1139 1140 1141 1142
/**
 * iio_device_register() - register a device with the IIO subsystem
 * @indio_dev:		Device structure filled by the device driver
 **/
1143
int iio_device_register(struct iio_dev *indio_dev)
1144 1145 1146
{
	int ret;

G
Guenter Roeck 已提交
1147 1148 1149 1150
	/* If the calling driver did not initialize of_node, do it here */
	if (!indio_dev->dev.of_node && indio_dev->dev.parent)
		indio_dev->dev.of_node = indio_dev->dev.parent->of_node;

1151
	/* configure elements for the chrdev */
1152
	indio_dev->dev.devt = MKDEV(MAJOR(iio_devt), indio_dev->id);
1153

1154 1155 1156 1157
	ret = iio_device_register_debugfs(indio_dev);
	if (ret) {
		dev_err(indio_dev->dev.parent,
			"Failed to register debugfs interfaces\n");
1158
		return ret;
1159
	}
1160 1161 1162 1163 1164 1165 1166 1167

	ret = iio_buffer_alloc_sysfs_and_mask(indio_dev);
	if (ret) {
		dev_err(indio_dev->dev.parent,
			"Failed to create buffer sysfs interfaces\n");
		goto error_unreg_debugfs;
	}

1168
	ret = iio_device_register_sysfs(indio_dev);
1169
	if (ret) {
1170
		dev_err(indio_dev->dev.parent,
1171
			"Failed to register sysfs interfaces\n");
1172
		goto error_buffer_free_sysfs;
1173
	}
1174
	ret = iio_device_register_eventset(indio_dev);
1175
	if (ret) {
1176
		dev_err(indio_dev->dev.parent,
1177
			"Failed to register event set\n");
1178 1179
		goto error_free_sysfs;
	}
1180 1181
	if (indio_dev->modes & INDIO_BUFFER_TRIGGERED)
		iio_device_register_trigger_consumer(indio_dev);
1182

1183 1184 1185 1186
	if ((indio_dev->modes & INDIO_ALL_BUFFER_MODES) &&
		indio_dev->setup_ops == NULL)
		indio_dev->setup_ops = &noop_ring_setup_ops;

1187 1188
	cdev_init(&indio_dev->chrdev, &iio_buffer_fileops);
	indio_dev->chrdev.owner = indio_dev->info->driver_module;
1189
	indio_dev->chrdev.kobj.parent = &indio_dev->dev.kobj;
1190
	ret = cdev_add(&indio_dev->chrdev, indio_dev->dev.devt, 1);
1191
	if (ret < 0)
1192
		goto error_unreg_eventset;
1193

1194 1195 1196 1197 1198 1199 1200
	ret = device_add(&indio_dev->dev);
	if (ret < 0)
		goto error_cdev_del;

	return 0;
error_cdev_del:
	cdev_del(&indio_dev->chrdev);
1201
error_unreg_eventset:
1202
	iio_device_unregister_eventset(indio_dev);
1203
error_free_sysfs:
1204
	iio_device_unregister_sysfs(indio_dev);
1205 1206
error_buffer_free_sysfs:
	iio_buffer_free_sysfs_and_mask(indio_dev);
1207 1208
error_unreg_debugfs:
	iio_device_unregister_debugfs(indio_dev);
1209 1210 1211 1212
	return ret;
}
EXPORT_SYMBOL(iio_device_register);

1213 1214 1215 1216
/**
 * iio_device_unregister() - unregister a device from the IIO subsystem
 * @indio_dev:		Device structure representing the device.
 **/
1217
void iio_device_unregister(struct iio_dev *indio_dev)
1218
{
1219
	mutex_lock(&indio_dev->info_exist_lock);
1220 1221 1222

	device_del(&indio_dev->dev);

1223 1224
	if (indio_dev->chrdev.dev)
		cdev_del(&indio_dev->chrdev);
1225
	iio_device_unregister_debugfs(indio_dev);
1226

1227 1228
	iio_disable_all_buffers(indio_dev);

1229
	indio_dev->info = NULL;
1230 1231 1232 1233

	iio_device_wakeup_eventset(indio_dev);
	iio_buffer_wakeup_poll(indio_dev);

1234
	mutex_unlock(&indio_dev->info_exist_lock);
1235 1236

	iio_buffer_free_sysfs_and_mask(indio_dev);
1237 1238
}
EXPORT_SYMBOL(iio_device_unregister);
1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297

static void devm_iio_device_unreg(struct device *dev, void *res)
{
	iio_device_unregister(*(struct iio_dev **)res);
}

/**
 * devm_iio_device_register - Resource-managed iio_device_register()
 * @dev:	Device to allocate iio_dev for
 * @indio_dev:	Device structure filled by the device driver
 *
 * Managed iio_device_register.  The IIO device registered with this
 * function is automatically unregistered on driver detach. This function
 * calls iio_device_register() internally. Refer to that function for more
 * information.
 *
 * If an iio_dev registered with this function needs to be unregistered
 * separately, devm_iio_device_unregister() must be used.
 *
 * RETURNS:
 * 0 on success, negative error number on failure.
 */
int devm_iio_device_register(struct device *dev, struct iio_dev *indio_dev)
{
	struct iio_dev **ptr;
	int ret;

	ptr = devres_alloc(devm_iio_device_unreg, sizeof(*ptr), GFP_KERNEL);
	if (!ptr)
		return -ENOMEM;

	*ptr = indio_dev;
	ret = iio_device_register(indio_dev);
	if (!ret)
		devres_add(dev, ptr);
	else
		devres_free(ptr);

	return ret;
}
EXPORT_SYMBOL_GPL(devm_iio_device_register);

/**
 * devm_iio_device_unregister - Resource-managed iio_device_unregister()
 * @dev:	Device this iio_dev belongs to
 * @indio_dev:	the iio_dev associated with the device
 *
 * Unregister iio_dev registered with devm_iio_device_register().
 */
void devm_iio_device_unregister(struct device *dev, struct iio_dev *indio_dev)
{
	int rc;

	rc = devres_release(dev, devm_iio_device_unreg,
			    devm_iio_device_match, indio_dev);
	WARN_ON(rc);
}
EXPORT_SYMBOL_GPL(devm_iio_device_unregister);

1298 1299 1300
subsys_initcall(iio_init);
module_exit(iio_exit);

1301
MODULE_AUTHOR("Jonathan Cameron <jic23@kernel.org>");
1302 1303
MODULE_DESCRIPTION("Industrial I/O core");
MODULE_LICENSE("GPL");