Linux Audio

Check our new training course

In-person Linux kernel drivers training

Jun 16-20, 2025
Register
Loading...
v6.8
  1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * Copyright (c) 2012-2015, The Linux Foundation. All rights reserved.
 
 
 
 
 
 
 
 
 
  4 */
  5#include <linux/kernel.h>
  6#include <linux/errno.h>
  7#include <linux/idr.h>
  8#include <linux/slab.h>
  9#include <linux/module.h>
 10#include <linux/of.h>
 11#include <linux/of_device.h>
 12#include <linux/platform_device.h>
 13#include <linux/spmi.h>
 14#include <linux/pm_runtime.h>
 15
 16#include <dt-bindings/spmi/spmi.h>
 17#define CREATE_TRACE_POINTS
 18#include <trace/events/spmi.h>
 19
 20static bool is_registered;
 21static DEFINE_IDA(ctrl_ida);
 22
 23static void spmi_dev_release(struct device *dev)
 24{
 25	struct spmi_device *sdev = to_spmi_device(dev);
 26
 27	kfree(sdev);
 28}
 29
 30static const struct device_type spmi_dev_type = {
 31	.release	= spmi_dev_release,
 32};
 33
 34static void spmi_ctrl_release(struct device *dev)
 35{
 36	struct spmi_controller *ctrl = to_spmi_controller(dev);
 37
 38	ida_free(&ctrl_ida, ctrl->nr);
 39	kfree(ctrl);
 40}
 41
 42static const struct device_type spmi_ctrl_type = {
 43	.release	= spmi_ctrl_release,
 44};
 45
 46static int spmi_device_match(struct device *dev, struct device_driver *drv)
 47{
 48	if (of_driver_match_device(dev, drv))
 49		return 1;
 50
 51	if (drv->name)
 52		return strncmp(dev_name(dev), drv->name,
 53			       SPMI_NAME_SIZE) == 0;
 54
 55	return 0;
 56}
 57
 58/**
 59 * spmi_device_add() - add a device previously constructed via spmi_device_alloc()
 60 * @sdev:	spmi_device to be added
 61 */
 62int spmi_device_add(struct spmi_device *sdev)
 63{
 64	struct spmi_controller *ctrl = sdev->ctrl;
 65	int err;
 66
 67	dev_set_name(&sdev->dev, "%d-%02x", ctrl->nr, sdev->usid);
 68
 69	err = device_add(&sdev->dev);
 70	if (err < 0) {
 71		dev_err(&sdev->dev, "Can't add %s, status %d\n",
 72			dev_name(&sdev->dev), err);
 73		goto err_device_add;
 74	}
 75
 76	dev_dbg(&sdev->dev, "device %s registered\n", dev_name(&sdev->dev));
 77
 78err_device_add:
 79	return err;
 80}
 81EXPORT_SYMBOL_GPL(spmi_device_add);
 82
 83/**
 84 * spmi_device_remove(): remove an SPMI device
 85 * @sdev:	spmi_device to be removed
 86 */
 87void spmi_device_remove(struct spmi_device *sdev)
 88{
 89	device_unregister(&sdev->dev);
 90}
 91EXPORT_SYMBOL_GPL(spmi_device_remove);
 92
 93static inline int
 94spmi_cmd(struct spmi_controller *ctrl, u8 opcode, u8 sid)
 95{
 96	int ret;
 97
 98	if (!ctrl || !ctrl->cmd || ctrl->dev.type != &spmi_ctrl_type)
 99		return -EINVAL;
100
101	ret = ctrl->cmd(ctrl, opcode, sid);
102	trace_spmi_cmd(opcode, sid, ret);
103	return ret;
104}
105
106static inline int spmi_read_cmd(struct spmi_controller *ctrl, u8 opcode,
107				u8 sid, u16 addr, u8 *buf, size_t len)
108{
109	int ret;
110
111	if (!ctrl || !ctrl->read_cmd || ctrl->dev.type != &spmi_ctrl_type)
112		return -EINVAL;
113
114	trace_spmi_read_begin(opcode, sid, addr);
115	ret = ctrl->read_cmd(ctrl, opcode, sid, addr, buf, len);
116	trace_spmi_read_end(opcode, sid, addr, ret, len, buf);
117	return ret;
118}
119
120static inline int spmi_write_cmd(struct spmi_controller *ctrl, u8 opcode,
121				 u8 sid, u16 addr, const u8 *buf, size_t len)
122{
123	int ret;
124
125	if (!ctrl || !ctrl->write_cmd || ctrl->dev.type != &spmi_ctrl_type)
126		return -EINVAL;
127
128	trace_spmi_write_begin(opcode, sid, addr, len, buf);
129	ret = ctrl->write_cmd(ctrl, opcode, sid, addr, buf, len);
130	trace_spmi_write_end(opcode, sid, addr, ret);
131	return ret;
132}
133
134/**
135 * spmi_register_read() - register read
136 * @sdev:	SPMI device.
137 * @addr:	slave register address (5-bit address).
138 * @buf:	buffer to be populated with data from the Slave.
139 *
140 * Reads 1 byte of data from a Slave device register.
141 */
142int spmi_register_read(struct spmi_device *sdev, u8 addr, u8 *buf)
143{
144	/* 5-bit register address */
145	if (addr > 0x1F)
146		return -EINVAL;
147
148	return spmi_read_cmd(sdev->ctrl, SPMI_CMD_READ, sdev->usid, addr,
149			     buf, 1);
150}
151EXPORT_SYMBOL_GPL(spmi_register_read);
152
153/**
154 * spmi_ext_register_read() - extended register read
155 * @sdev:	SPMI device.
156 * @addr:	slave register address (8-bit address).
157 * @buf:	buffer to be populated with data from the Slave.
158 * @len:	the request number of bytes to read (up to 16 bytes).
159 *
160 * Reads up to 16 bytes of data from the extended register space on a
161 * Slave device.
162 */
163int spmi_ext_register_read(struct spmi_device *sdev, u8 addr, u8 *buf,
164			   size_t len)
165{
166	/* 8-bit register address, up to 16 bytes */
167	if (len == 0 || len > 16)
168		return -EINVAL;
169
170	return spmi_read_cmd(sdev->ctrl, SPMI_CMD_EXT_READ, sdev->usid, addr,
171			     buf, len);
172}
173EXPORT_SYMBOL_GPL(spmi_ext_register_read);
174
175/**
176 * spmi_ext_register_readl() - extended register read long
177 * @sdev:	SPMI device.
178 * @addr:	slave register address (16-bit address).
179 * @buf:	buffer to be populated with data from the Slave.
180 * @len:	the request number of bytes to read (up to 8 bytes).
181 *
182 * Reads up to 8 bytes of data from the extended register space on a
183 * Slave device using 16-bit address.
184 */
185int spmi_ext_register_readl(struct spmi_device *sdev, u16 addr, u8 *buf,
186			    size_t len)
187{
188	/* 16-bit register address, up to 8 bytes */
189	if (len == 0 || len > 8)
190		return -EINVAL;
191
192	return spmi_read_cmd(sdev->ctrl, SPMI_CMD_EXT_READL, sdev->usid, addr,
193			     buf, len);
194}
195EXPORT_SYMBOL_GPL(spmi_ext_register_readl);
196
197/**
198 * spmi_register_write() - register write
199 * @sdev:	SPMI device
200 * @addr:	slave register address (5-bit address).
201 * @data:	buffer containing the data to be transferred to the Slave.
202 *
203 * Writes 1 byte of data to a Slave device register.
204 */
205int spmi_register_write(struct spmi_device *sdev, u8 addr, u8 data)
206{
207	/* 5-bit register address */
208	if (addr > 0x1F)
209		return -EINVAL;
210
211	return spmi_write_cmd(sdev->ctrl, SPMI_CMD_WRITE, sdev->usid, addr,
212			      &data, 1);
213}
214EXPORT_SYMBOL_GPL(spmi_register_write);
215
216/**
217 * spmi_register_zero_write() - register zero write
218 * @sdev:	SPMI device.
219 * @data:	the data to be written to register 0 (7-bits).
220 *
221 * Writes data to register 0 of the Slave device.
222 */
223int spmi_register_zero_write(struct spmi_device *sdev, u8 data)
224{
225	return spmi_write_cmd(sdev->ctrl, SPMI_CMD_ZERO_WRITE, sdev->usid, 0,
226			      &data, 1);
227}
228EXPORT_SYMBOL_GPL(spmi_register_zero_write);
229
230/**
231 * spmi_ext_register_write() - extended register write
232 * @sdev:	SPMI device.
233 * @addr:	slave register address (8-bit address).
234 * @buf:	buffer containing the data to be transferred to the Slave.
235 * @len:	the request number of bytes to read (up to 16 bytes).
236 *
237 * Writes up to 16 bytes of data to the extended register space of a
238 * Slave device.
239 */
240int spmi_ext_register_write(struct spmi_device *sdev, u8 addr, const u8 *buf,
241			    size_t len)
242{
243	/* 8-bit register address, up to 16 bytes */
244	if (len == 0 || len > 16)
245		return -EINVAL;
246
247	return spmi_write_cmd(sdev->ctrl, SPMI_CMD_EXT_WRITE, sdev->usid, addr,
248			      buf, len);
249}
250EXPORT_SYMBOL_GPL(spmi_ext_register_write);
251
252/**
253 * spmi_ext_register_writel() - extended register write long
254 * @sdev:	SPMI device.
255 * @addr:	slave register address (16-bit address).
256 * @buf:	buffer containing the data to be transferred to the Slave.
257 * @len:	the request number of bytes to read (up to 8 bytes).
258 *
259 * Writes up to 8 bytes of data to the extended register space of a
260 * Slave device using 16-bit address.
261 */
262int spmi_ext_register_writel(struct spmi_device *sdev, u16 addr, const u8 *buf,
263			     size_t len)
264{
265	/* 4-bit Slave Identifier, 16-bit register address, up to 8 bytes */
266	if (len == 0 || len > 8)
267		return -EINVAL;
268
269	return spmi_write_cmd(sdev->ctrl, SPMI_CMD_EXT_WRITEL, sdev->usid,
270			      addr, buf, len);
271}
272EXPORT_SYMBOL_GPL(spmi_ext_register_writel);
273
274/**
275 * spmi_command_reset() - sends RESET command to the specified slave
276 * @sdev:	SPMI device.
277 *
278 * The Reset command initializes the Slave and forces all registers to
279 * their reset values. The Slave shall enter the STARTUP state after
280 * receiving a Reset command.
281 */
282int spmi_command_reset(struct spmi_device *sdev)
283{
284	return spmi_cmd(sdev->ctrl, SPMI_CMD_RESET, sdev->usid);
285}
286EXPORT_SYMBOL_GPL(spmi_command_reset);
287
288/**
289 * spmi_command_sleep() - sends SLEEP command to the specified SPMI device
290 * @sdev:	SPMI device.
291 *
292 * The Sleep command causes the Slave to enter the user defined SLEEP state.
293 */
294int spmi_command_sleep(struct spmi_device *sdev)
295{
296	return spmi_cmd(sdev->ctrl, SPMI_CMD_SLEEP, sdev->usid);
297}
298EXPORT_SYMBOL_GPL(spmi_command_sleep);
299
300/**
301 * spmi_command_wakeup() - sends WAKEUP command to the specified SPMI device
302 * @sdev:	SPMI device.
303 *
304 * The Wakeup command causes the Slave to move from the SLEEP state to
305 * the ACTIVE state.
306 */
307int spmi_command_wakeup(struct spmi_device *sdev)
308{
309	return spmi_cmd(sdev->ctrl, SPMI_CMD_WAKEUP, sdev->usid);
310}
311EXPORT_SYMBOL_GPL(spmi_command_wakeup);
312
313/**
314 * spmi_command_shutdown() - sends SHUTDOWN command to the specified SPMI device
315 * @sdev:	SPMI device.
316 *
317 * The Shutdown command causes the Slave to enter the SHUTDOWN state.
318 */
319int spmi_command_shutdown(struct spmi_device *sdev)
320{
321	return spmi_cmd(sdev->ctrl, SPMI_CMD_SHUTDOWN, sdev->usid);
322}
323EXPORT_SYMBOL_GPL(spmi_command_shutdown);
324
325static int spmi_drv_probe(struct device *dev)
326{
327	const struct spmi_driver *sdrv = to_spmi_driver(dev->driver);
328	struct spmi_device *sdev = to_spmi_device(dev);
329	int err;
330
331	pm_runtime_get_noresume(dev);
332	pm_runtime_set_active(dev);
333	pm_runtime_enable(dev);
334
335	err = sdrv->probe(sdev);
336	if (err)
337		goto fail_probe;
338
339	return 0;
340
341fail_probe:
342	pm_runtime_disable(dev);
343	pm_runtime_set_suspended(dev);
344	pm_runtime_put_noidle(dev);
345	return err;
346}
347
348static void spmi_drv_remove(struct device *dev)
349{
350	const struct spmi_driver *sdrv = to_spmi_driver(dev->driver);
351
352	pm_runtime_get_sync(dev);
353	if (sdrv->remove)
354		sdrv->remove(to_spmi_device(dev));
355	pm_runtime_put_noidle(dev);
356
357	pm_runtime_disable(dev);
358	pm_runtime_set_suspended(dev);
359	pm_runtime_put_noidle(dev);
360}
361
362static void spmi_drv_shutdown(struct device *dev)
363{
364	const struct spmi_driver *sdrv = to_spmi_driver(dev->driver);
365
366	if (sdrv && sdrv->shutdown)
367		sdrv->shutdown(to_spmi_device(dev));
368}
369
370static int spmi_drv_uevent(const struct device *dev, struct kobj_uevent_env *env)
371{
372	int ret;
373
374	ret = of_device_uevent_modalias(dev, env);
375	if (ret != -ENODEV)
376		return ret;
377
378	return 0;
379}
380
381static struct bus_type spmi_bus_type = {
382	.name		= "spmi",
383	.match		= spmi_device_match,
384	.probe		= spmi_drv_probe,
385	.remove		= spmi_drv_remove,
386	.shutdown	= spmi_drv_shutdown,
387	.uevent		= spmi_drv_uevent,
388};
389
390/**
391 * spmi_find_device_by_of_node() - look up an SPMI device from a device node
392 *
393 * @np:		device node
394 *
395 * Takes a reference to the embedded struct device which needs to be dropped
396 * after use.
397 *
398 * Returns the struct spmi_device associated with a device node or NULL.
399 */
400struct spmi_device *spmi_find_device_by_of_node(struct device_node *np)
401{
402	struct device *dev = bus_find_device_by_of_node(&spmi_bus_type, np);
403
404	if (dev)
405		return to_spmi_device(dev);
406	return NULL;
407}
408EXPORT_SYMBOL_GPL(spmi_find_device_by_of_node);
409
410/**
411 * spmi_device_alloc() - Allocate a new SPMI device
412 * @ctrl:	associated controller
413 *
414 * Caller is responsible for either calling spmi_device_add() to add the
415 * newly allocated controller, or calling spmi_device_put() to discard it.
416 */
417struct spmi_device *spmi_device_alloc(struct spmi_controller *ctrl)
418{
419	struct spmi_device *sdev;
420
421	sdev = kzalloc(sizeof(*sdev), GFP_KERNEL);
422	if (!sdev)
423		return NULL;
424
425	sdev->ctrl = ctrl;
426	device_initialize(&sdev->dev);
427	sdev->dev.parent = &ctrl->dev;
428	sdev->dev.bus = &spmi_bus_type;
429	sdev->dev.type = &spmi_dev_type;
430	return sdev;
431}
432EXPORT_SYMBOL_GPL(spmi_device_alloc);
433
434/**
435 * spmi_controller_alloc() - Allocate a new SPMI controller
436 * @parent:	parent device
437 * @size:	size of private data
438 *
439 * Caller is responsible for either calling spmi_controller_add() to add the
440 * newly allocated controller, or calling spmi_controller_put() to discard it.
441 * The allocated private data region may be accessed via
442 * spmi_controller_get_drvdata()
443 */
444struct spmi_controller *spmi_controller_alloc(struct device *parent,
445					      size_t size)
446{
447	struct spmi_controller *ctrl;
448	int id;
449
450	if (WARN_ON(!parent))
451		return ERR_PTR(-EINVAL);
452
453	ctrl = kzalloc(sizeof(*ctrl) + size, GFP_KERNEL);
454	if (!ctrl)
455		return ERR_PTR(-ENOMEM);
456
457	device_initialize(&ctrl->dev);
458	ctrl->dev.type = &spmi_ctrl_type;
459	ctrl->dev.bus = &spmi_bus_type;
460	ctrl->dev.parent = parent;
461	ctrl->dev.of_node = parent->of_node;
462	spmi_controller_set_drvdata(ctrl, &ctrl[1]);
463
464	id = ida_alloc(&ctrl_ida, GFP_KERNEL);
465	if (id < 0) {
466		dev_err(parent,
467			"unable to allocate SPMI controller identifier.\n");
468		spmi_controller_put(ctrl);
469		return ERR_PTR(id);
470	}
471
472	ctrl->nr = id;
473	dev_set_name(&ctrl->dev, "spmi-%d", id);
474
475	dev_dbg(&ctrl->dev, "allocated controller 0x%p id %d\n", ctrl, id);
476	return ctrl;
477}
478EXPORT_SYMBOL_GPL(spmi_controller_alloc);
479
480static void of_spmi_register_devices(struct spmi_controller *ctrl)
481{
482	struct device_node *node;
483	int err;
484
485	if (!ctrl->dev.of_node)
486		return;
487
488	for_each_available_child_of_node(ctrl->dev.of_node, node) {
489		struct spmi_device *sdev;
490		u32 reg[2];
491
492		dev_dbg(&ctrl->dev, "adding child %pOF\n", node);
493
494		err = of_property_read_u32_array(node, "reg", reg, 2);
495		if (err) {
496			dev_err(&ctrl->dev,
497				"node %pOF err (%d) does not have 'reg' property\n",
498				node, err);
499			continue;
500		}
501
502		if (reg[1] != SPMI_USID) {
503			dev_err(&ctrl->dev,
504				"node %pOF contains unsupported 'reg' entry\n",
505				node);
506			continue;
507		}
508
509		if (reg[0] >= SPMI_MAX_SLAVE_ID) {
510			dev_err(&ctrl->dev, "invalid usid on node %pOF\n", node);
 
 
511			continue;
512		}
513
514		dev_dbg(&ctrl->dev, "read usid %02x\n", reg[0]);
515
516		sdev = spmi_device_alloc(ctrl);
517		if (!sdev)
518			continue;
519
520		sdev->dev.of_node = node;
521		sdev->usid = (u8)reg[0];
522
523		err = spmi_device_add(sdev);
524		if (err) {
525			dev_err(&sdev->dev,
526				"failure adding device. status %d\n", err);
527			spmi_device_put(sdev);
528		}
529	}
530}
531
532/**
533 * spmi_controller_add() - Add an SPMI controller
534 * @ctrl:	controller to be registered.
535 *
536 * Register a controller previously allocated via spmi_controller_alloc() with
537 * the SPMI core.
538 */
539int spmi_controller_add(struct spmi_controller *ctrl)
540{
541	int ret;
542
543	/* Can't register until after driver model init */
544	if (WARN_ON(!is_registered))
545		return -EAGAIN;
546
547	ret = device_add(&ctrl->dev);
548	if (ret)
549		return ret;
550
551	if (IS_ENABLED(CONFIG_OF))
552		of_spmi_register_devices(ctrl);
553
554	dev_dbg(&ctrl->dev, "spmi-%d registered: dev:%p\n",
555		ctrl->nr, &ctrl->dev);
556
557	return 0;
558};
559EXPORT_SYMBOL_GPL(spmi_controller_add);
560
561/* Remove a device associated with a controller */
562static int spmi_ctrl_remove_device(struct device *dev, void *data)
563{
564	struct spmi_device *spmidev = to_spmi_device(dev);
565
566	if (dev->type == &spmi_dev_type)
567		spmi_device_remove(spmidev);
568	return 0;
569}
570
571/**
572 * spmi_controller_remove(): remove an SPMI controller
573 * @ctrl:	controller to remove
574 *
575 * Remove a SPMI controller.  Caller is responsible for calling
576 * spmi_controller_put() to discard the allocated controller.
577 */
578void spmi_controller_remove(struct spmi_controller *ctrl)
579{
 
 
580	if (!ctrl)
581		return;
582
583	device_for_each_child(&ctrl->dev, NULL, spmi_ctrl_remove_device);
 
584	device_del(&ctrl->dev);
585}
586EXPORT_SYMBOL_GPL(spmi_controller_remove);
587
588/**
589 * __spmi_driver_register() - Register client driver with SPMI core
590 * @sdrv:	client driver to be associated with client-device.
591 * @owner:	module owner
592 *
593 * This API will register the client driver with the SPMI framework.
594 * It is typically called from the driver's module-init function.
595 */
596int __spmi_driver_register(struct spmi_driver *sdrv, struct module *owner)
597{
598	sdrv->driver.bus = &spmi_bus_type;
599	sdrv->driver.owner = owner;
600	return driver_register(&sdrv->driver);
601}
602EXPORT_SYMBOL_GPL(__spmi_driver_register);
603
604static void __exit spmi_exit(void)
605{
606	bus_unregister(&spmi_bus_type);
607}
608module_exit(spmi_exit);
609
610static int __init spmi_init(void)
611{
612	int ret;
613
614	ret = bus_register(&spmi_bus_type);
615	if (ret)
616		return ret;
617
618	is_registered = true;
619	return 0;
620}
621postcore_initcall(spmi_init);
622
623MODULE_LICENSE("GPL v2");
624MODULE_DESCRIPTION("SPMI module");
625MODULE_ALIAS("platform:spmi");
v4.10.11
 
  1/*
  2 * Copyright (c) 2012-2015, The Linux Foundation. All rights reserved.
  3 *
  4 * This program is free software; you can redistribute it and/or modify
  5 * it under the terms of the GNU General Public License version 2 and
  6 * only version 2 as published by the Free Software Foundation.
  7 *
  8 * This program is distributed in the hope that it will be useful,
  9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 11 * GNU General Public License for more details.
 12 */
 13#include <linux/kernel.h>
 14#include <linux/errno.h>
 15#include <linux/idr.h>
 16#include <linux/slab.h>
 17#include <linux/module.h>
 18#include <linux/of.h>
 19#include <linux/of_device.h>
 20#include <linux/platform_device.h>
 21#include <linux/spmi.h>
 22#include <linux/pm_runtime.h>
 23
 24#include <dt-bindings/spmi/spmi.h>
 25#define CREATE_TRACE_POINTS
 26#include <trace/events/spmi.h>
 27
 28static bool is_registered;
 29static DEFINE_IDA(ctrl_ida);
 30
 31static void spmi_dev_release(struct device *dev)
 32{
 33	struct spmi_device *sdev = to_spmi_device(dev);
 
 34	kfree(sdev);
 35}
 36
 37static const struct device_type spmi_dev_type = {
 38	.release	= spmi_dev_release,
 39};
 40
 41static void spmi_ctrl_release(struct device *dev)
 42{
 43	struct spmi_controller *ctrl = to_spmi_controller(dev);
 44	ida_simple_remove(&ctrl_ida, ctrl->nr);
 
 45	kfree(ctrl);
 46}
 47
 48static const struct device_type spmi_ctrl_type = {
 49	.release	= spmi_ctrl_release,
 50};
 51
 52static int spmi_device_match(struct device *dev, struct device_driver *drv)
 53{
 54	if (of_driver_match_device(dev, drv))
 55		return 1;
 56
 57	if (drv->name)
 58		return strncmp(dev_name(dev), drv->name,
 59			       SPMI_NAME_SIZE) == 0;
 60
 61	return 0;
 62}
 63
 64/**
 65 * spmi_device_add() - add a device previously constructed via spmi_device_alloc()
 66 * @sdev:	spmi_device to be added
 67 */
 68int spmi_device_add(struct spmi_device *sdev)
 69{
 70	struct spmi_controller *ctrl = sdev->ctrl;
 71	int err;
 72
 73	dev_set_name(&sdev->dev, "%d-%02x", ctrl->nr, sdev->usid);
 74
 75	err = device_add(&sdev->dev);
 76	if (err < 0) {
 77		dev_err(&sdev->dev, "Can't add %s, status %d\n",
 78			dev_name(&sdev->dev), err);
 79		goto err_device_add;
 80	}
 81
 82	dev_dbg(&sdev->dev, "device %s registered\n", dev_name(&sdev->dev));
 83
 84err_device_add:
 85	return err;
 86}
 87EXPORT_SYMBOL_GPL(spmi_device_add);
 88
 89/**
 90 * spmi_device_remove(): remove an SPMI device
 91 * @sdev:	spmi_device to be removed
 92 */
 93void spmi_device_remove(struct spmi_device *sdev)
 94{
 95	device_unregister(&sdev->dev);
 96}
 97EXPORT_SYMBOL_GPL(spmi_device_remove);
 98
 99static inline int
100spmi_cmd(struct spmi_controller *ctrl, u8 opcode, u8 sid)
101{
102	int ret;
103
104	if (!ctrl || !ctrl->cmd || ctrl->dev.type != &spmi_ctrl_type)
105		return -EINVAL;
106
107	ret = ctrl->cmd(ctrl, opcode, sid);
108	trace_spmi_cmd(opcode, sid, ret);
109	return ret;
110}
111
112static inline int spmi_read_cmd(struct spmi_controller *ctrl, u8 opcode,
113				u8 sid, u16 addr, u8 *buf, size_t len)
114{
115	int ret;
116
117	if (!ctrl || !ctrl->read_cmd || ctrl->dev.type != &spmi_ctrl_type)
118		return -EINVAL;
119
120	trace_spmi_read_begin(opcode, sid, addr);
121	ret = ctrl->read_cmd(ctrl, opcode, sid, addr, buf, len);
122	trace_spmi_read_end(opcode, sid, addr, ret, len, buf);
123	return ret;
124}
125
126static inline int spmi_write_cmd(struct spmi_controller *ctrl, u8 opcode,
127				 u8 sid, u16 addr, const u8 *buf, size_t len)
128{
129	int ret;
130
131	if (!ctrl || !ctrl->write_cmd || ctrl->dev.type != &spmi_ctrl_type)
132		return -EINVAL;
133
134	trace_spmi_write_begin(opcode, sid, addr, len, buf);
135	ret = ctrl->write_cmd(ctrl, opcode, sid, addr, buf, len);
136	trace_spmi_write_end(opcode, sid, addr, ret);
137	return ret;
138}
139
140/**
141 * spmi_register_read() - register read
142 * @sdev:	SPMI device.
143 * @addr:	slave register address (5-bit address).
144 * @buf:	buffer to be populated with data from the Slave.
145 *
146 * Reads 1 byte of data from a Slave device register.
147 */
148int spmi_register_read(struct spmi_device *sdev, u8 addr, u8 *buf)
149{
150	/* 5-bit register address */
151	if (addr > 0x1F)
152		return -EINVAL;
153
154	return spmi_read_cmd(sdev->ctrl, SPMI_CMD_READ, sdev->usid, addr,
155			     buf, 1);
156}
157EXPORT_SYMBOL_GPL(spmi_register_read);
158
159/**
160 * spmi_ext_register_read() - extended register read
161 * @sdev:	SPMI device.
162 * @addr:	slave register address (8-bit address).
163 * @buf:	buffer to be populated with data from the Slave.
164 * @len:	the request number of bytes to read (up to 16 bytes).
165 *
166 * Reads up to 16 bytes of data from the extended register space on a
167 * Slave device.
168 */
169int spmi_ext_register_read(struct spmi_device *sdev, u8 addr, u8 *buf,
170			   size_t len)
171{
172	/* 8-bit register address, up to 16 bytes */
173	if (len == 0 || len > 16)
174		return -EINVAL;
175
176	return spmi_read_cmd(sdev->ctrl, SPMI_CMD_EXT_READ, sdev->usid, addr,
177			     buf, len);
178}
179EXPORT_SYMBOL_GPL(spmi_ext_register_read);
180
181/**
182 * spmi_ext_register_readl() - extended register read long
183 * @sdev:	SPMI device.
184 * @addr:	slave register address (16-bit address).
185 * @buf:	buffer to be populated with data from the Slave.
186 * @len:	the request number of bytes to read (up to 8 bytes).
187 *
188 * Reads up to 8 bytes of data from the extended register space on a
189 * Slave device using 16-bit address.
190 */
191int spmi_ext_register_readl(struct spmi_device *sdev, u16 addr, u8 *buf,
192			    size_t len)
193{
194	/* 16-bit register address, up to 8 bytes */
195	if (len == 0 || len > 8)
196		return -EINVAL;
197
198	return spmi_read_cmd(sdev->ctrl, SPMI_CMD_EXT_READL, sdev->usid, addr,
199			     buf, len);
200}
201EXPORT_SYMBOL_GPL(spmi_ext_register_readl);
202
203/**
204 * spmi_register_write() - register write
205 * @sdev:	SPMI device
206 * @addr:	slave register address (5-bit address).
207 * @data:	buffer containing the data to be transferred to the Slave.
208 *
209 * Writes 1 byte of data to a Slave device register.
210 */
211int spmi_register_write(struct spmi_device *sdev, u8 addr, u8 data)
212{
213	/* 5-bit register address */
214	if (addr > 0x1F)
215		return -EINVAL;
216
217	return spmi_write_cmd(sdev->ctrl, SPMI_CMD_WRITE, sdev->usid, addr,
218			      &data, 1);
219}
220EXPORT_SYMBOL_GPL(spmi_register_write);
221
222/**
223 * spmi_register_zero_write() - register zero write
224 * @sdev:	SPMI device.
225 * @data:	the data to be written to register 0 (7-bits).
226 *
227 * Writes data to register 0 of the Slave device.
228 */
229int spmi_register_zero_write(struct spmi_device *sdev, u8 data)
230{
231	return spmi_write_cmd(sdev->ctrl, SPMI_CMD_ZERO_WRITE, sdev->usid, 0,
232			      &data, 1);
233}
234EXPORT_SYMBOL_GPL(spmi_register_zero_write);
235
236/**
237 * spmi_ext_register_write() - extended register write
238 * @sdev:	SPMI device.
239 * @addr:	slave register address (8-bit address).
240 * @buf:	buffer containing the data to be transferred to the Slave.
241 * @len:	the request number of bytes to read (up to 16 bytes).
242 *
243 * Writes up to 16 bytes of data to the extended register space of a
244 * Slave device.
245 */
246int spmi_ext_register_write(struct spmi_device *sdev, u8 addr, const u8 *buf,
247			    size_t len)
248{
249	/* 8-bit register address, up to 16 bytes */
250	if (len == 0 || len > 16)
251		return -EINVAL;
252
253	return spmi_write_cmd(sdev->ctrl, SPMI_CMD_EXT_WRITE, sdev->usid, addr,
254			      buf, len);
255}
256EXPORT_SYMBOL_GPL(spmi_ext_register_write);
257
258/**
259 * spmi_ext_register_writel() - extended register write long
260 * @sdev:	SPMI device.
261 * @addr:	slave register address (16-bit address).
262 * @buf:	buffer containing the data to be transferred to the Slave.
263 * @len:	the request number of bytes to read (up to 8 bytes).
264 *
265 * Writes up to 8 bytes of data to the extended register space of a
266 * Slave device using 16-bit address.
267 */
268int spmi_ext_register_writel(struct spmi_device *sdev, u16 addr, const u8 *buf,
269			     size_t len)
270{
271	/* 4-bit Slave Identifier, 16-bit register address, up to 8 bytes */
272	if (len == 0 || len > 8)
273		return -EINVAL;
274
275	return spmi_write_cmd(sdev->ctrl, SPMI_CMD_EXT_WRITEL, sdev->usid,
276			      addr, buf, len);
277}
278EXPORT_SYMBOL_GPL(spmi_ext_register_writel);
279
280/**
281 * spmi_command_reset() - sends RESET command to the specified slave
282 * @sdev:	SPMI device.
283 *
284 * The Reset command initializes the Slave and forces all registers to
285 * their reset values. The Slave shall enter the STARTUP state after
286 * receiving a Reset command.
287 */
288int spmi_command_reset(struct spmi_device *sdev)
289{
290	return spmi_cmd(sdev->ctrl, SPMI_CMD_RESET, sdev->usid);
291}
292EXPORT_SYMBOL_GPL(spmi_command_reset);
293
294/**
295 * spmi_command_sleep() - sends SLEEP command to the specified SPMI device
296 * @sdev:	SPMI device.
297 *
298 * The Sleep command causes the Slave to enter the user defined SLEEP state.
299 */
300int spmi_command_sleep(struct spmi_device *sdev)
301{
302	return spmi_cmd(sdev->ctrl, SPMI_CMD_SLEEP, sdev->usid);
303}
304EXPORT_SYMBOL_GPL(spmi_command_sleep);
305
306/**
307 * spmi_command_wakeup() - sends WAKEUP command to the specified SPMI device
308 * @sdev:	SPMI device.
309 *
310 * The Wakeup command causes the Slave to move from the SLEEP state to
311 * the ACTIVE state.
312 */
313int spmi_command_wakeup(struct spmi_device *sdev)
314{
315	return spmi_cmd(sdev->ctrl, SPMI_CMD_WAKEUP, sdev->usid);
316}
317EXPORT_SYMBOL_GPL(spmi_command_wakeup);
318
319/**
320 * spmi_command_shutdown() - sends SHUTDOWN command to the specified SPMI device
321 * @sdev:	SPMI device.
322 *
323 * The Shutdown command causes the Slave to enter the SHUTDOWN state.
324 */
325int spmi_command_shutdown(struct spmi_device *sdev)
326{
327	return spmi_cmd(sdev->ctrl, SPMI_CMD_SHUTDOWN, sdev->usid);
328}
329EXPORT_SYMBOL_GPL(spmi_command_shutdown);
330
331static int spmi_drv_probe(struct device *dev)
332{
333	const struct spmi_driver *sdrv = to_spmi_driver(dev->driver);
334	struct spmi_device *sdev = to_spmi_device(dev);
335	int err;
336
337	pm_runtime_get_noresume(dev);
338	pm_runtime_set_active(dev);
339	pm_runtime_enable(dev);
340
341	err = sdrv->probe(sdev);
342	if (err)
343		goto fail_probe;
344
345	return 0;
346
347fail_probe:
348	pm_runtime_disable(dev);
349	pm_runtime_set_suspended(dev);
350	pm_runtime_put_noidle(dev);
351	return err;
352}
353
354static int spmi_drv_remove(struct device *dev)
355{
356	const struct spmi_driver *sdrv = to_spmi_driver(dev->driver);
357
358	pm_runtime_get_sync(dev);
359	sdrv->remove(to_spmi_device(dev));
 
360	pm_runtime_put_noidle(dev);
361
362	pm_runtime_disable(dev);
363	pm_runtime_set_suspended(dev);
364	pm_runtime_put_noidle(dev);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
365	return 0;
366}
367
368static struct bus_type spmi_bus_type = {
369	.name		= "spmi",
370	.match		= spmi_device_match,
371	.probe		= spmi_drv_probe,
372	.remove		= spmi_drv_remove,
 
 
373};
374
375/**
376 * spmi_controller_alloc() - Allocate a new SPMI device
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
377 * @ctrl:	associated controller
378 *
379 * Caller is responsible for either calling spmi_device_add() to add the
380 * newly allocated controller, or calling spmi_device_put() to discard it.
381 */
382struct spmi_device *spmi_device_alloc(struct spmi_controller *ctrl)
383{
384	struct spmi_device *sdev;
385
386	sdev = kzalloc(sizeof(*sdev), GFP_KERNEL);
387	if (!sdev)
388		return NULL;
389
390	sdev->ctrl = ctrl;
391	device_initialize(&sdev->dev);
392	sdev->dev.parent = &ctrl->dev;
393	sdev->dev.bus = &spmi_bus_type;
394	sdev->dev.type = &spmi_dev_type;
395	return sdev;
396}
397EXPORT_SYMBOL_GPL(spmi_device_alloc);
398
399/**
400 * spmi_controller_alloc() - Allocate a new SPMI controller
401 * @parent:	parent device
402 * @size:	size of private data
403 *
404 * Caller is responsible for either calling spmi_controller_add() to add the
405 * newly allocated controller, or calling spmi_controller_put() to discard it.
406 * The allocated private data region may be accessed via
407 * spmi_controller_get_drvdata()
408 */
409struct spmi_controller *spmi_controller_alloc(struct device *parent,
410					      size_t size)
411{
412	struct spmi_controller *ctrl;
413	int id;
414
415	if (WARN_ON(!parent))
416		return NULL;
417
418	ctrl = kzalloc(sizeof(*ctrl) + size, GFP_KERNEL);
419	if (!ctrl)
420		return NULL;
421
422	device_initialize(&ctrl->dev);
423	ctrl->dev.type = &spmi_ctrl_type;
424	ctrl->dev.bus = &spmi_bus_type;
425	ctrl->dev.parent = parent;
426	ctrl->dev.of_node = parent->of_node;
427	spmi_controller_set_drvdata(ctrl, &ctrl[1]);
428
429	id = ida_simple_get(&ctrl_ida, 0, 0, GFP_KERNEL);
430	if (id < 0) {
431		dev_err(parent,
432			"unable to allocate SPMI controller identifier.\n");
433		spmi_controller_put(ctrl);
434		return NULL;
435	}
436
437	ctrl->nr = id;
438	dev_set_name(&ctrl->dev, "spmi-%d", id);
439
440	dev_dbg(&ctrl->dev, "allocated controller 0x%p id %d\n", ctrl, id);
441	return ctrl;
442}
443EXPORT_SYMBOL_GPL(spmi_controller_alloc);
444
445static void of_spmi_register_devices(struct spmi_controller *ctrl)
446{
447	struct device_node *node;
448	int err;
449
450	if (!ctrl->dev.of_node)
451		return;
452
453	for_each_available_child_of_node(ctrl->dev.of_node, node) {
454		struct spmi_device *sdev;
455		u32 reg[2];
456
457		dev_dbg(&ctrl->dev, "adding child %s\n", node->full_name);
458
459		err = of_property_read_u32_array(node, "reg", reg, 2);
460		if (err) {
461			dev_err(&ctrl->dev,
462				"node %s err (%d) does not have 'reg' property\n",
463				node->full_name, err);
464			continue;
465		}
466
467		if (reg[1] != SPMI_USID) {
468			dev_err(&ctrl->dev,
469				"node %s contains unsupported 'reg' entry\n",
470				node->full_name);
471			continue;
472		}
473
474		if (reg[0] >= SPMI_MAX_SLAVE_ID) {
475			dev_err(&ctrl->dev,
476				"invalid usid on node %s\n",
477				node->full_name);
478			continue;
479		}
480
481		dev_dbg(&ctrl->dev, "read usid %02x\n", reg[0]);
482
483		sdev = spmi_device_alloc(ctrl);
484		if (!sdev)
485			continue;
486
487		sdev->dev.of_node = node;
488		sdev->usid = (u8) reg[0];
489
490		err = spmi_device_add(sdev);
491		if (err) {
492			dev_err(&sdev->dev,
493				"failure adding device. status %d\n", err);
494			spmi_device_put(sdev);
495		}
496	}
497}
498
499/**
500 * spmi_controller_add() - Add an SPMI controller
501 * @ctrl:	controller to be registered.
502 *
503 * Register a controller previously allocated via spmi_controller_alloc() with
504 * the SPMI core.
505 */
506int spmi_controller_add(struct spmi_controller *ctrl)
507{
508	int ret;
509
510	/* Can't register until after driver model init */
511	if (WARN_ON(!is_registered))
512		return -EAGAIN;
513
514	ret = device_add(&ctrl->dev);
515	if (ret)
516		return ret;
517
518	if (IS_ENABLED(CONFIG_OF))
519		of_spmi_register_devices(ctrl);
520
521	dev_dbg(&ctrl->dev, "spmi-%d registered: dev:%p\n",
522		ctrl->nr, &ctrl->dev);
523
524	return 0;
525};
526EXPORT_SYMBOL_GPL(spmi_controller_add);
527
528/* Remove a device associated with a controller */
529static int spmi_ctrl_remove_device(struct device *dev, void *data)
530{
531	struct spmi_device *spmidev = to_spmi_device(dev);
 
532	if (dev->type == &spmi_dev_type)
533		spmi_device_remove(spmidev);
534	return 0;
535}
536
537/**
538 * spmi_controller_remove(): remove an SPMI controller
539 * @ctrl:	controller to remove
540 *
541 * Remove a SPMI controller.  Caller is responsible for calling
542 * spmi_controller_put() to discard the allocated controller.
543 */
544void spmi_controller_remove(struct spmi_controller *ctrl)
545{
546	int dummy;
547
548	if (!ctrl)
549		return;
550
551	dummy = device_for_each_child(&ctrl->dev, NULL,
552				      spmi_ctrl_remove_device);
553	device_del(&ctrl->dev);
554}
555EXPORT_SYMBOL_GPL(spmi_controller_remove);
556
557/**
558 * spmi_driver_register() - Register client driver with SPMI core
559 * @sdrv:	client driver to be associated with client-device.
 
560 *
561 * This API will register the client driver with the SPMI framework.
562 * It is typically called from the driver's module-init function.
563 */
564int __spmi_driver_register(struct spmi_driver *sdrv, struct module *owner)
565{
566	sdrv->driver.bus = &spmi_bus_type;
567	sdrv->driver.owner = owner;
568	return driver_register(&sdrv->driver);
569}
570EXPORT_SYMBOL_GPL(__spmi_driver_register);
571
572static void __exit spmi_exit(void)
573{
574	bus_unregister(&spmi_bus_type);
575}
576module_exit(spmi_exit);
577
578static int __init spmi_init(void)
579{
580	int ret;
581
582	ret = bus_register(&spmi_bus_type);
583	if (ret)
584		return ret;
585
586	is_registered = true;
587	return 0;
588}
589postcore_initcall(spmi_init);
590
591MODULE_LICENSE("GPL v2");
592MODULE_DESCRIPTION("SPMI module");
593MODULE_ALIAS("platform:spmi");