A library to read the distance, in cm, from an hc-sr04 proximity sensor using Tessel
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.
npm install proximity-hcsr04
var tessel = require'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 = require'prox-hcsr04';var proximity = proximityLibusetriggerPin echoPin;proximitygetDistanceif err throw err;console.log"Distance: " distance "cm away.";printDistance;;printDistance;
use(triggerPin, echoPin, [callback]): must be called in order to create a
Proximity object. It returns the
Proximity object and also calls the optional callback with
proximity.getDistance(callback): used to make a reading, in centimeters, from the distance sensor. It calls the callback upon completion with
"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.
MIT or Apache 2.0, at your option