瀏覽代碼

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>
Jarkko Nikula 11 年之前
父節點
當前提交
83ad152d03
共有 1 個文件被更改,包括 4 次插入2 次删除
  1. 4 2
      include/sound/soc.h

+ 4 - 2
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
  * struct snd_soc_jack_gpio - Describes a gpio pin for jack detection
  *
  *
  * @gpio:         legacy gpio number
  * @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
  * @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
  * @report:       value to report when jack detected
  * @invert:       report presence in low state
  * @invert:       report presence in low state
  * @debouce_time: debouce time in ms
  * @debouce_time: debouce time in ms