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 [2023/02/13 14:52] (current) – external edit 127.0.0.1
@@ Line 20: / Line 20: @@
 ====Connect via Server:====
-{{:supported_hardware:maxsonar_listen.png?direct&400 |}}Lastly you can select the “Listen For Incoming TCP Connections” from the port popup and the plugin will start a server on the entered port. The Wiznet cards and most other TCP/Serial adaptors can also be run in client mode. Meaning they will make a connection to the pre-programmed server address. Use the above mentioned Wiznet Configurator to setup the serial port settings the same as in the Connect Via TCP example, but in this case set the networking options to connect as a Client. You will also have to enter the IP address of your XTension machine and the port that you are running your server on.
+{{:supported_hardware:maxsonar_listen.png?direct&400 |}}Lastly you can select the “Listen For Incoming TCP Connections” from the port popup and the plugin will start a server on the entered port. The Wiznet cards and most other TCP/Serial adaptors can also be run in client mode. Meaning they will make a connection to the pre-programmed server address. Use the above mentioned Wiznet Configurator to setup the serial port settings the same as in the Connect Via TCP example, but in this case set the networking options to connect as a Client. You will also have to enter the IP address of your XTension machine and the port that you are running your server on. Even though the popup says TCP Connections, you need to set the connection type in the Wiznet configuration to UDP.
 When running a server, any reasonable number of max sonar devices can connect to the plugin. When a client first connects XTension will look up it’s MAC address and create a new Distance unit for you automatically and use the MAC address as the Address of the unit so that they will all be unique. In this way you can support multiple devices with a single interface instance.
@@ 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.