summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJarkko Nikula <jarkko.nikula@linux.intel.com>2014-05-27 13:54:18 +0300
committerMark Brown <broonie@linaro.org>2014-05-27 12:03:44 +0100
commit83ad152d03b594b6a3fb9f3d313622b491cd6168 (patch)
tree9568ec68b09ba1e750a31a87fa3ef88fdd9161e3
parentf025d3b9c64e1f7feb75a559d4a12f5f8c6a4a25 (diff)
downloadop-kernel-dev-83ad152d03b594b6a3fb9f3d313622b491cd6168.zip
op-kernel-dev-83ad152d03b594b6a3fb9f3d313622b491cd6168.tar.gz
ASoC: jack: Clarify GPIO descriptor lookup in struct snd_soc_jack_gpio doc
Clarify struct snd_soc_jack_gpio documentation for the idx and name fields. Because name is passed as connection ID to gpiod_get_index() when using GPIO descriptor defined jack pins it is not only used as a label in debugfs but also as function name lookup in systems that support functions names for GPIOs. Clarify also idx since the index is within the function of the GPIO consumer device and not within the device itself only. Signed-off-by: Jarkko Nikula <jarkko.nikula@linux.intel.com> Signed-off-by: Mark Brown <broonie@linaro.org>
-rw-r--r--include/sound/soc.h6
1 files changed, 4 insertions, 2 deletions
diff --git a/include/sound/soc.h b/include/sound/soc.h
index 61bea88..a2408a5 100644
--- a/include/sound/soc.h
+++ b/include/sound/soc.h
@@ -597,9 +597,11 @@ struct snd_soc_jack_zone {
* struct snd_soc_jack_gpio - Describes a gpio pin for jack detection
*
* @gpio: legacy gpio number
- * @idx: gpio descriptor index within the GPIO consumer device
+ * @idx: gpio descriptor index within the function of the GPIO
+ * consumer device
* @gpiod_dev GPIO consumer device
- * @name: gpio name
+ * @name: gpio name. Also as connection ID for the GPIO consumer
+ * device function name lookup
* @report: value to report when jack detected
* @invert: report presence in low state
* @debouce_time: debouce time in ms
OpenPOWER on IntegriCloud