Commit 02fa3ec0 authored by Mark Brown's avatar Mark Brown Committed by Liam Girdwood
Browse files

regulator: Add basic trace facilities 



Provide some basic trace facilities to the regulator API. We generate
events on regulator enable, disable and voltage setting over the actual
hardware operations (which are assumed to be the expensive ones which
require interaction with the actual device). This is intended to facilitate
debug of the performance and behaviour with consumers allowing unified
traces to be generated including the regulator operations within the
context of the other components of the system.

For enable we log the explicit delay for the voltage ramp separately to
the interaction with the hardware to highlight the time consumed in I/O.
We should add a similar delay for voltage changes, though there the
relatively small magnitude of the changes in the context of the I/O
costs makes it much less critical for most regulators.

Only hardware interactions are currently traced as the primary focus is
on the performance and synchronisation of actual hardware interactions.
Additional tracepoints for debugging of the logical operations can be
added later if required.

Signed-off-by: default avatarMark Brown <broonie@opensource.wolfsonmicro.com>
Signed-off-by: default avatarLiam Girdwood <lrg@slimlogic.co.uk>
parent 3a93f2a9

drivers/regulator/core.c

+17 −0
Original line number Diff line number Diff line
@@ -25,6 +25,9 @@ 
#include <linux/regulator/driver.h>

#include <linux/regulator/machine.h>



#define CREATE_TRACE_POINTS

#include <trace/events/regulator.h>



#include "dummy.h"



#define REGULATOR_VERSION "0.5"
@@ -1310,6 +1313,8 @@ static int _regulator_enable(struct regulator_dev *rdev) 
				delay = 0;

			}



			trace_regulator_enable(rdev_get_name(rdev));



			/* Allow the regulator to ramp; it would be useful

			 * to extend this for bulk operations so that the

			 * regulators can ramp together.  */
@@ -1317,6 +1322,8 @@ static int _regulator_enable(struct regulator_dev *rdev) 
			if (ret < 0)

				return ret;



			trace_regulator_enable_delay(rdev_get_name(rdev));



			if (delay >= 1000) {

				mdelay(delay / 1000);

				udelay(delay % 1000);
@@ -1324,6 +1331,8 @@ static int _regulator_enable(struct regulator_dev *rdev) 
				udelay(delay);

			}



			trace_regulator_enable_complete(rdev_get_name(rdev));



		} else if (ret < 0) {

			printk(KERN_ERR "%s: is_enabled() failed for %s: %d\n",

			       __func__, rdev_get_name(rdev), ret);
@@ -1379,6 +1388,8 @@ static int _regulator_disable(struct regulator_dev *rdev, 
		/* we are last user */

		if (_regulator_can_change_status(rdev) &&

		    rdev->desc->ops->disable) {

			trace_regulator_disable(rdev_get_name(rdev));



			ret = rdev->desc->ops->disable(rdev);

			if (ret < 0) {

				printk(KERN_ERR "%s: failed to disable %s\n",
@@ -1386,6 +1397,8 @@ static int _regulator_disable(struct regulator_dev *rdev, 
				return ret;

			}



			trace_regulator_disable_complete(rdev_get_name(rdev));



			_notifier_call_chain(rdev, REGULATOR_EVENT_DISABLE,

					     NULL);

		}
@@ -1645,6 +1658,8 @@ int regulator_set_voltage(struct regulator *regulator, int min_uV, int max_uV) 
	regulator->min_uV = min_uV;

	regulator->max_uV = max_uV;



	trace_regulator_set_voltage(rdev_get_name(rdev), min_uV, max_uV);



	ret = rdev->desc->ops->set_voltage(rdev, min_uV, max_uV, &selector);



	if (rdev->desc->ops->list_voltage)
@@ -1652,6 +1667,8 @@ int regulator_set_voltage(struct regulator *regulator, int min_uV, int max_uV) 
	else

		selector = -1;



	trace_regulator_set_voltage_complete(rdev_get_name(rdev), selector);



out:

	_notifier_call_chain(rdev, REGULATOR_EVENT_VOLTAGE_CHANGE, NULL);

	mutex_unlock(&rdev->mutex);

include/trace/events/regulator.h

0 → 100644
+141 −0
Original line number Diff line number Diff line 
#undef TRACE_SYSTEM

#define TRACE_SYSTEM regulator



#if !defined(_TRACE_REGULATOR_H) || defined(TRACE_HEADER_MULTI_READ)

#define _TRACE_REGULATOR_H



#include <linux/ktime.h>

#include <linux/tracepoint.h>



/*

 * Events which just log themselves and the regulator name for enable/disable

 * type tracking.

 */

DECLARE_EVENT_CLASS(regulator_basic,



	TP_PROTO(const char *name),



	TP_ARGS(name),



	TP_STRUCT__entry(

		__string(	name,	name	)

	),



	TP_fast_assign(

		__assign_str(name, name);

	),



	TP_printk("name=%s", __get_str(name))



);



DEFINE_EVENT(regulator_basic, regulator_enable,



	TP_PROTO(const char *name),



	TP_ARGS(name)



);



DEFINE_EVENT(regulator_basic, regulator_enable_delay,



	TP_PROTO(const char *name),



	TP_ARGS(name)



);



DEFINE_EVENT(regulator_basic, regulator_enable_complete,



	TP_PROTO(const char *name),



	TP_ARGS(name)



);



DEFINE_EVENT(regulator_basic, regulator_disable,



	TP_PROTO(const char *name),



	TP_ARGS(name)



);



DEFINE_EVENT(regulator_basic, regulator_disable_complete,



	TP_PROTO(const char *name),



	TP_ARGS(name)



);



/*

 * Events that take a range of numerical values, mostly for voltages

 * and so on.

 */

DECLARE_EVENT_CLASS(regulator_range,



	TP_PROTO(const char *name, int min, int max),



	TP_ARGS(name, min, max),



	TP_STRUCT__entry(

		__string(	name,		name		)

		__field(        int,            min             )

		__field(        int,            max             )

	),



	TP_fast_assign(

		__assign_str(name, name);

		__entry->min  = min;

		__entry->max  = max;

	),



	TP_printk("name=%s (%d-%d)", __get_str(name),

		  (int)__entry->min, (int)__entry->max)

);



DEFINE_EVENT(regulator_range, regulator_set_voltage,



	TP_PROTO(const char *name, int min, int max),



	TP_ARGS(name, min, max)



);





/*

 * Events that take a single value, mostly for readback and refcounts.

 */

DECLARE_EVENT_CLASS(regulator_value,



	TP_PROTO(const char *name, unsigned int val),



	TP_ARGS(name, val),



	TP_STRUCT__entry(

		__string(	name,		name		)

		__field(        unsigned int,   val             )

	),



	TP_fast_assign(

		__assign_str(name, name);

		__entry->val  = val;

	),



	TP_printk("name=%s, val=%u", __get_str(name),

		  (int)__entry->val)

);



DEFINE_EVENT(regulator_value, regulator_set_voltage_complete,



	TP_PROTO(const char *name, unsigned int value),



	TP_ARGS(name, value)



);



#endif /* _TRACE_POWER_H */



/* This part must be outside protection */

#include <trace/define_trace.h>

CRA Git | Maintained and supported by SUSTech CRA and CCSE