I forgot to say that it also works as a 'VoltageInput' in the Control Panel, showing a varying analog voltage, but I get 'Saturation Detected' errors quite often - don't know why.
Opening the hub port as a VoltageInput will allow you to set your own limits on how sensitive your system is to detecting motion, by detecting if the sensor's voltage is outside of a given threshold.
SATURATION errors occur because the signal from the analog sensor is too large to be accurately quantified by the HUB (e.g. >5V), and should be treated as the sensor detecting motion.
I had no idea to use MOT2002_0 as Digital Sensor, which is great!!
I will use both mode depending on target use cases.
As for its behavior as a Voltage Ratio sensor, I thought it quite similar to
the previous 1111_0 sensor.
As @jdecoux said, if you open it as a 'VoltageInput' then you can set your own threshold, whereas 'DigitalInput' seems to have a fixed threshold of approx. 3.0.
@jdecoux
Many thanks for the info re. the Saturation error. Yes, MOT2002_0 does seem to lack the normal quality of documentation so far.
I will caution against using this sensor with the DigitalInput API, in that the voltage from the sensor can swing up or down, while the DigitalInput will only detect in one direction.
Yes, I will choose either Digital or Voltage mode carefully, depending on the target use case. I look forward to seeing the detailed document, but I am not in a hurry so please take time
