Differences

This shows you the differences between two versions of the page.

--- supported_hardware:maxsonar [2019/02/21 19:58] – James Sentman
+++ supported_hardware:maxsonar [2019/02/21 21:15] – James Sentman
@@ Line 28: / Line 28: @@
 ===Initial Input Filtering:===
-{{:supported_hardware:maxsonar_initial.png?direct&400 |}} These options are identical to what they were in the older plugin. Since the value of the reading can jump around quite a bit it can be useful to do some initial filtering on it. The Hysteresis Buffer Size...
+{{:supported_hardware:maxsonar_initial.png?direct&400 |}} These options are identical to what they were in the older plugin. Since the value of the reading can jump around quite a bit it can be useful to do some initial filtering on it.
-(unfinished, have to go pick the child up from school, back momentarily)
+The **Hysteresis Buffer Size** is the number of readings that are held and averaged together before either sending the value on or passing it through to the next set of filters. Larger values will reduce jitter but also tend to make the values gently approach the new distance reading rather than jump from one to the other. **Significant Change** won’t send an update to the unit until the change from the last update is more than this amount.
+===Glitch Filter===
+{{:supported_hardware:maxsonar_glitchfilter.png?direct&400 |}} The **Glitch Filter** won’t send an update until the last “Stable Count” readings were all within the “Stable Range” of each other. This is the best way to catch smaller movements but filter out the jittering that is common with such sensors. With the glitch filter active the value won’t change immediately when the distance to the object being sensed changes, but a few moments late when the readings have settled down and stopped moving then the new value will be sent through.
+===Schmitt Trigger===
+{{:supported_hardware:maxsonar_schmitt.png?direct&400 |}} The **Schmitt Trigger** settings differ from the other filters in that you need to turn off the Dimmable checkbox in order to use this. You set an On Threshold and an Off Threshold. The unit will be on as long as the value is smaller than the On Threshold, but it will not turn off until it crosses the off threshold. This lets you measure the presence or absence of something while absorbing the noise and jittering that might occur in that middle space. This also takes care of one of the more common uses for these sensors without having to constantly process each reading inside XTension and execute a script saving CPU and log space. For more info on what exactly a Schmitt Trigger is and why it’s perfect for this sort of application see the [[https://en.wikipedia.org/wiki/Schmitt_trigger|Wikipedia Article]]
+====History:====
+The original Max Sonar plugin was part of XTension as early as 2008. This new MaxSonar plugin replaced it in XTension 9.4.16 in Feb of 2019.