From 69491e2dab77b2446fe13f6df1ab80b62d405192 Mon Sep 17 00:00:00 2001
From: Arksine <arksine.code@gmail.com>
Date: Sat, 9 Feb 2019 19:40:03 -0500
Subject: [PATCH] filament_switch_sensor: update documentation

Signed-off-by:  Eric Callahan <arksine.code@gmail.com>
---
 config/example-extras.cfg | 21 +++++++++++++++++++++
 docs/G-Codes.md           |  8 ++++++++
 2 files changed, 29 insertions(+)

diff --git a/config/example-extras.cfg b/config/example-extras.cfg
index 2645c6cb6..134ac66bc 100644
--- a/config/example-extras.cfg
+++ b/config/example-extras.cfg
@@ -1368,3 +1368,24 @@
 #recover_velocity: 50.
 #  When capture/restore is enabled, the speed at which to return to
 #  the captured position (in mm/s).  Default is 50.0 mm/s.
+
+# Filament Switch Sensor.  Support for filament insert and runout detection
+# using a switch sensor, such as an endstop switch.
+#[filament_switch_sensor my_sensor]
+#pause_on_runout: True
+#  When set to True, a PAUSE will execute immediately after a runout is
+#  detected. Note that if pause_on_runout is False and the runout_gcode is
+#  omitted then runout detection is disabled. Default is True.
+#runout_gcode:
+#  The gcode to run after a filament runout is detected.  If pause_on_runout
+#  is set to True this gcode will run after the PAUSE is complete.  The default
+#  is not to run any gcode commands.
+#insert_gcode:
+#  The gcode to run after a filament insert is detected.  The default is not to
+#  run any gcode commands, which disables insert detection.
+#event_delay: 3.0
+#  The minimum amount of time in seconds to delay between events. Events
+#  triggered during this time period will be silently ignored. The default
+#  is 3 seconds.
+#switch_pin:
+#  The pin on which the switch is connected.  This parameter must be provided.
diff --git a/docs/G-Codes.md b/docs/G-Codes.md
index b9db71c78..197ec3e23 100644
--- a/docs/G-Codes.md
+++ b/docs/G-Codes.md
@@ -357,3 +357,11 @@ is enabled:
   - `RESUME [VELOCITY=<value>]`: Resumes the print from a pause, first restoring
   the previously captured position.  The VELOCITY parameter determines the speed
   at which the tool should return to the original captured position.
+
+## Filament Sensor
+
+The following command is available when the "filament_switch_sensor" config
+section is enabled.
+ - `QUERY_FILAMENT_SENSOR SENSOR=<sensor_name>`: Queries the current status of
+  the filament sensor.  The data displayed on the terminal will depend on the
+  sensor type defined in the confguration.