summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAseda Aboagye <aaboagye@google.com>2020-09-29 11:09:17 -0700
committerCommit Bot <commit-bot@chromium.org>2020-09-29 22:58:57 +0000
commit86f58bd95f42f1afad046ce65e5c68b7d813c8f5 (patch)
tree476ada212b08ceb6d412c2869c333ac08bfb640f
parent133c6096ffd81cf5e7d62334ccc12d67e14e7830 (diff)
downloadchrome-ec-86f58bd95f42f1afad046ce65e5c68b7d813c8f5.tar.gz
cleanup: button: Reword comments
This commit is just a clean up CL to clean up some of the comments introduced with the new ADC detected buttons feature. BUG=b:167319238 BRANCH=None TEST=None Signed-off-by: Aseda Aboagye <aaboagye@google.com> Change-Id: Ie08a8ca26ceaec26dae2d55f3493f28f1e4a414c Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform/ec/+/2438676 Reviewed-by: Diana Z <dzigterman@chromium.org> Commit-Queue: Aseda Aboagye <aaboagye@chromium.org> Tested-by: Aseda Aboagye <aaboagye@chromium.org>
-rw-r--r--include/button.h10
-rw-r--r--include/config.h4
2 files changed, 8 insertions, 6 deletions
diff --git a/include/button.h b/include/button.h
index ec0a7afdc2..3ab5892083 100644
--- a/include/button.h
+++ b/include/button.h
@@ -88,16 +88,18 @@ int button_disable_gpio(enum button button_type);
void button_interrupt(enum gpio_signal signal);
/*
- * determined which buttons connected ADC
+ * Is this button using ADC voltages to detect state?
*
- * @param signal Signal which triggered the interrupt.
+ * @param gpio The GPIO of interest.
+ * Returns 1 if button state is detected by ADC, 0 if not.
*/
int button_is_adc_detected(enum gpio_signal gpio);
/*
- * distinct which buttons determined by ADC voltage
+ * Sample the ADC voltage and convert to a physical pressed/not pressed state.
*
- * @param signal Signal which triggered the interrupt.
+ * @param gpio ADC detected GPIO.
+ * Returns the physical state of the button.
*/
int adc_to_physical_value(enum gpio_signal gpio);
diff --git a/include/config.h b/include/config.h
index 0d5d10ac90..0e343ec419 100644
--- a/include/config.h
+++ b/include/config.h
@@ -771,8 +771,8 @@
#undef CONFIG_VOLUME_BUTTONS
/*
- * The board has volume up and volume down buttons, that are connected to ADC
- * pins which pressed and released values are determined by the analog voltage
+ * The board has buttons that are connected to ADC pins which pressed and
+ * released values are determined by the analog voltage
*/
#undef CONFIG_ADC_BUTTONS