summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDrashna Jaelre <drashna@live.com>2019-11-15 14:27:46 -0800
committerJoel Challis <git@zvecr.com>2019-11-15 22:27:46 +0000
commitf6b5f6db7665512cece0223ce4d19c5b17455ef4 (patch)
tree0eb1313ba5d706819321b32effd9f5dc6d9fee62 /docs
parent381b73fcac169338a1dcf433694108a29870a57e (diff)
downloadqmk_firmware-f6b5f6db7665512cece0223ce4d19c5b17455ef4.tar.gz
qmk_firmware-f6b5f6db7665512cece0223ce4d19c5b17455ef4.zip
Improvements to Solenoid feature (#7369)
* Error out when Solenid pin is not defined Instead of defaulting to a (literally) random pin, error out instead. Because this pin may be used, or because that pin may not be exposed, or may not exist. * Remove 'SOLENOID_ACTIVE' setting since it's not used * Update documentation
Diffstat (limited to 'docs')
-rw-r--r--docs/feature_haptic_feedback.md14
1 files changed, 9 insertions, 5 deletions
diff --git a/docs/feature_haptic_feedback.md b/docs/feature_haptic_feedback.md
index d9e445de86..2273633227 100644
--- a/docs/feature_haptic_feedback.md
+++ b/docs/feature_haptic_feedback.md
@@ -41,11 +41,15 @@ First you will need a build a circuit to drive the solenoid through a mosfet as
[Wiring diagram provided by Adafruit](https://playground.arduino.cc/uploads/Learning/solenoid_driver.pdf)
-Select a pin that has PWM for the signal pin
-```
-#define SOLENOID_PIN *pin*
-```
+| Settings | Default | Description |
+|--------------------------|---------------|-------------------------------------------------------|
+|`SOLENOID_PIN` | *Not defined* |Configures the pin that the Solenoid is connected to. |
+|`SOLENOID_DEFAULT_DWELL` | `12` ms |Configures the default dwell time for the solenoid. |
+|`SOLENOID_MIN_DWELL` | `4` ms |Sets the lower limit for the dwell. |
+|`SOLENOID_MAX_DWELL` | `100` ms |Sets the upper limit for the dwell. |
+
+?> Dwell time is how long the "plunger" stays activated. The dwell time changes how the solenoid sounds.
Beware that some pins may be powered during bootloader (ie. A13 on the STM32F303 chip) and will result in the solenoid kept in the on state through the whole flashing process. This may overheat and damage the solenoid. If you find that the pin the solenoid is connected to is triggering the solenoid during bootloader/DFU, select another pin.
@@ -151,4 +155,4 @@ This will set what sequence HPT_RST will set as the active mode. If not defined,
### DRV2605L Continuous Haptic Mode
-This mode sets continuous haptic feedback with the option to increase or decrease strength. \ No newline at end of file
+This mode sets continuous haptic feedback with the option to increase or decrease strength.