node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Node library for the PulseSensor, designed to interact with Tessel.

The PulseSensor is an open source pulse sensor. It shines green light through your skin, then reads the intensity of light back. This light intensity changes based on the action in your capillaries, so the analog value read back correlates with your pulse.



Connect the PulseSensor to Tessel as follows:

  1. Black wire to GND (there's one on the GPIO port)
  2. Red wire to 5V (Vin on the GPIO port)
  3. Purple wire (signal) to one of the Analog pins on the GPIO port. I use A1.

Connect the PulseSensor to your finger:

Put the heart side of the PulseSensor to your fingertip, then wrap it securely with the provided velcro strip. You should feel your pulse in your fingertip.

It would be a good idea to also peruse this pdf from the manufacturers, which shows you how to seal and attach the sensor.


npm install pulsesensor


The PulseSensor collects some pulse samples.
When it has enough samples to determine BPM
(beats per minute), it declares ready. It
then logs an updated BPM estimate at each
heartbeat and toggles the blue LED in time.
var tessel = require('tessel');
var PulseSensor = require('pulsesensor');
var pulse = PulseSensor.use(tessel.port['GPIO'].pin['A1']);
pulse.on('ready', function () {
  pulse.on('beat', function (time) {


# pulse.readRaw( [callback(data)] )
Reads the value of the analog pin. Returns the value and sends value to callback.


# pulse.on( 'error', callback(error) )
Emitted on error connecting

# pulse.on( 'ready', callback(err, pulse) )
Emitted when the pulse object is created and there are enough samples to determine BPM

# pulse.on( 'beat', callback(time) )
Emitted at each heartbeat sensed. Beat emission begins before ready event is emitted.


# pulse.BPM
The BPM, calculated as an average over the last 3 beats.


Copyright Kelsey Breseman, Apache 2.0 Licensed.