Proximity
Driver for the hc-sr04 ultrasound sensor. It returns the distance, in cm, to the nearest object using ultrasound.
NOTE: This branch relies on a Tessel flash with the kn-pulsein
branch of firmware. At the time of this writing, it hadn't yet been merged into master.
This driver was tested on Tessel. When using Tessel, you must use G3 on the GPIO bank as the echo pin and you can use any other GPIO as the trigger pin.
The module works by pulling the trigger pin high for 10ms to signal to the proximity sensor that it should take a reading. Then the sensor pulls the echo pin high for an amount of time proportional to the distance to the nearest detected object.
Installation
npm install proximity-hcsr04
Example
var tessel = ;var gpio = tesselportGPIO;// The trigger pin can be any GPIOvar triggerPin = gpiodigital1;// The echo pin MUST be G3 on the GPIO bankvar echoPin = gpiodigital2; var proximityLib = ;var proximity = proximityLib; { proximity;} ;
Methods
-
use(triggerPin, echoPin, [callback])
: must be called in order to create aProximity
object. It returns theProximity
object and also calls the optional callback with(err, proximity
). -
proximity.getDistance(callback)
: used to make a reading, in centimeters, from the distance sensor. It calls the callback upon completion with(err, distance)
.
Events
-
"ready"
: called when the proximity sensor is ready to receive commands. It's not really necessary at the moment and doesn't need to be used. -
"data"
: called when a distance reading is made.
License
MIT or Apache 2.0, at your option