Splitting getRed() from getFIFORed() for better examples. When you call getRed() you now get the immediate environmental reading.

Author: nseidle

Examples/Example1_Basic_Readings/Example1_Basic_Readings.ino

@@ -4,27 +4,26 @@
   Date: October 2nd, 2016
   https://github.com/sparkfun/MAX30105_Breakout
 
-  Outputs all Red/IR/Green values at 25Hz.
+  Outputs all Red/IR/Green values.
 
   Hardware Connections (Breakoutboard to Arduino):
   -5V = 5V (3.3V is allowed)
   -GND = GND
   -SDA = A4 (or SDA)
   -SCL = A5 (or SCL)
   -INT = Not connected
- 
+
   The MAX30105 Breakout can handle 5V or 3.3V I2C logic. We recommend powering the board with 5V
   but it will also run at 3.3V.
+
+  This code is released under the [MIT License](http://opensource.org/licenses/MIT).
 */
 
 #include <Wire.h>
 #include "MAX30105.h"
 
 MAX30105 particleSensor;
 
-long startTime;
-long samplesTaken = 0; //Counter for calculating the Hz or read rate
-
 void setup()
 {
   Serial.begin(115200);
@@ -38,30 +37,17 @@ void setup()
   }
 
   particleSensor.setup(); //Configure sensor. Use 6.4mA for LED drive
-
-  startTime = millis();
 }
 
 void loop()
 {
-  particleSensor.check(); //Check the sensor, read up to 3 samples
-
-  while (particleSensor.available()) //do we have new data?
-  {
-    samplesTaken++;
-
-    Serial.print(" R[");
-    Serial.print(particleSensor.getRed());
-    Serial.print("] IR[");
-    Serial.print(particleSensor.getIR());
-    Serial.print("] G[");
-    Serial.print(particleSensor.getGreen());
-    Serial.print("] Hz[");
-    Serial.print((float)samplesTaken / ((millis() - startTime) / 1000.0), 2);
-    Serial.print("]");
-
-    Serial.println();
-
-    particleSensor.nextSample(); //We're finished with this sample so move to next sample
-  }
+  Serial.print(" R[");
+  Serial.print(particleSensor.getRed());
+  Serial.print("] IR[");
+  Serial.print(particleSensor.getIR());
+  Serial.print("] G[");
+  Serial.print(particleSensor.getGreen());
+  Serial.print("]");
+
+  Serial.println();
 }

Examples/Example2_Presence_Sensing/Example2_Presence_Sensing.ino

@@ -13,7 +13,7 @@
   -SDA = A4 (or SDA)
   -SCL = A5 (or SCL)
   -INT = Not connected
- 
+
   The MAX30105 Breakout can handle 5V or 3.3V I2C logic. We recommend powering the board with 5V
   but it will also run at 3.3V.
 
@@ -24,10 +24,9 @@
 
 MAX30105 particleSensor;
 
-long startTime;
 long samplesTaken = 0; //Counter for calculating the Hz or read rate
-
 long unblockedValue; //Average IR at power up
+long startTime; //Used to calculate measurement rate
 
 void setup()
 {
@@ -58,14 +57,7 @@ void setup()
   unblockedValue = 0;
   for (byte x = 0 ; x < 32 ; x++)
   {
-    //Wait for new readings to come in
-    while (particleSensor.available() == false)
-    {
-      particleSensor.check(); //Check the sensor, read up to 3 samples
-    }
-
     unblockedValue += particleSensor.getIR(); //Read the IR value
-    particleSensor.nextSample(); //We're finished with this sample so move to next sample
   }
   unblockedValue /= 32;
 
@@ -74,31 +66,24 @@ void setup()
 
 void loop()
 {
-  particleSensor.check(); //Check the sensor, read up to 3 samples
-
-  while (particleSensor.available()) //do we have new data?
-  {
-    samplesTaken++;
+  samplesTaken++;
 
-    Serial.print("IR[");
-    Serial.print(particleSensor.getIR());
-    Serial.print("] Hz[");
-    Serial.print((float)samplesTaken / ((millis() - startTime) / 1000.0), 2);
-    Serial.print("]");
+  Serial.print("IR[");
+  Serial.print(particleSensor.getIR());
+  Serial.print("] Hz[");
+  Serial.print((float)samplesTaken / ((millis() - startTime) / 1000.0), 2);
+  Serial.print("]");
 
-    long currentDelta = particleSensor.getIR() - unblockedValue;
+  long currentDelta = particleSensor.getIR() - unblockedValue;
 
-    Serial.print(" delta[");
-    Serial.print(currentDelta);
-    Serial.print("]");
+  Serial.print(" delta[");
+  Serial.print(currentDelta);
+  Serial.print("]");
 
-    if (currentDelta > (long)100)
-    {
-      Serial.print(" Something is there!");
-    }
-
-    Serial.println();
-
-    particleSensor.nextSample(); //We're finished with this sample so move to next sample
+  if (currentDelta > (long)100)
+  {
+    Serial.print(" Something is there!");
   }
+
+  Serial.println();
 }

Examples/Example4_HeartBeat_Plotter/Example4_HeartBeat_Plotter.ino

@@ -14,9 +14,9 @@
   5) Checkout the blips!
   6) Feel the pulse on your neck and watch it mimic the blips
 
-  It is best to attach the sensor to your finger using a rubber band or other tightening 
-  device. Humans are generally bad at applying constant pressure to a thing. When you 
-  press your finger against the sensor it varies enough to cause the blood in your 
+  It is best to attach the sensor to your finger using a rubber band or other tightening
+  device. Humans are generally bad at applying constant pressure to a thing. When you
+  press your finger against the sensor it varies enough to cause the blood in your
   finger to flow differently which causes the sensor readings to go wonky.
 
   Hardware Connections (Breakoutboard to Arduino):
@@ -25,7 +25,7 @@
   -SDA = A4 (or SDA)
   -SCL = A5 (or SCL)
   -INT = Not connected
- 
+
   The MAX30105 Breakout can handle 5V or 3.3V I2C logic. We recommend powering the board with 5V
   but it will also run at 3.3V.
 */
@@ -47,7 +47,15 @@ void setup()
     while (1);
   }
 
-  particleSensor.setup(); //Configure sensor. Use 6.4mA for LED drive
+  //Setup to sense a nice looking saw tooth on the plotter
+  byte ledBrightness = 0x1F; //Options: 0=Off to 255=50mA
+  byte sampleAverage = 8; //Options: 1, 2, 4, 8, 16, 32
+  byte ledMode = 3; //Options: 1 = Red only, 2 = Red + IR, 3 = Red + IR + Green
+  byte sampleRate = 100; //Options: 50, 100, 200, 400, 800, 1000, 1600, 3200
+  int pulseWidth = 411; //Options: 69, 118, 215, 411
+  int adcRange = 4096; //Options: 2048, 4096, 8192, 16384
+
+  particleSensor.setup(ledBrightness, sampleAverage, ledMode, sampleRate, pulseWidth, adcRange); //Configure sensor with these settings
 
   //Arduino plotter auto-scales annoyingly. To get around this, pre-populate
   //the plotter with 500 of an average reading from the sensor
@@ -57,29 +65,16 @@ void setup()
   long baseValue = 0;
   for (byte x = 0 ; x < avgAmount ; x++)
   {
-    //Wait for new readings to come in
-    while (particleSensor.available() == false)
-    {
-      particleSensor.check(); //Check the sensor, read up to 3 samples
-    }
-
     baseValue += particleSensor.getIR(); //Read the IR value
-    particleSensor.nextSample(); //We're finished with this sample so move to next sample
   }
   baseValue /= avgAmount;
 
+  //Pre-populate the plotter so that the Y scale is close to IR values
   for (int x = 0 ; x < 500 ; x++)
     Serial.println(baseValue);
 }
 
 void loop()
 {
-  particleSensor.check(); //Check the sensor, read up to 3 samples
-
-  while (particleSensor.available()) //do we have new data?
-  {
-    Serial.println(particleSensor.getIR());
-
-    particleSensor.nextSample(); //We're finished with this sample so move to next sample
-  }
+  Serial.println(particleSensor.getIR()); //Send raw data to plotter
 }

Examples/Example5_HeartRate/Example5_HeartRate.ino

@@ -18,7 +18,7 @@
   -SDA = A4 (or SDA)
   -SCL = A5 (or SCL)
   -INT = Not connected
- 
+
   The MAX30105 Breakout can handle 5V or 3.3V I2C logic. We recommend powering the board with 5V
   but it will also run at 3.3V.
 */
@@ -58,47 +58,40 @@ void setup()
 
 void loop()
 {
-  particleSensor.check(); //Check the sensor often
+  long irValue = particleSensor.getIR();
 
-  if (particleSensor.available()) //do we have new data?
+  if (checkForBeat(irValue) == true)
   {
-    long irValue = particleSensor.getIR();
-    
-    if (checkForBeat(irValue) == true)
+    //We sensed a beat!
+    long delta = millis() - lastBeat;
+    lastBeat = millis();
+
+    beatsPerMinute = 60 / (delta / 1000.0);
+
+    if (beatsPerMinute < 255 && beatsPerMinute > 20)
     {
-      //We sensed a beat!
-      long delta = millis() - lastBeat;
-      lastBeat = millis();
-
-      beatsPerMinute = 60 / (delta / 1000.0);
-
-      if (beatsPerMinute < 255 && beatsPerMinute > 20)
-      {
-        rates[rateSpot++] = (byte)beatsPerMinute; //Store this reading in the array
-        rateSpot %= RATE_SIZE; //Wrap variable
-
-        //Take average of readings
-        beatAvg = 0;
-        for (byte x = 0 ; x < RATE_SIZE ; x++)
-          beatAvg += rates[x];
-        beatAvg /= RATE_SIZE;
-      }
+      rates[rateSpot++] = (byte)beatsPerMinute; //Store this reading in the array
+      rateSpot %= RATE_SIZE; //Wrap variable
+
+      //Take average of readings
+      beatAvg = 0;
+      for (byte x = 0 ; x < RATE_SIZE ; x++)
+        beatAvg += rates[x];
+      beatAvg /= RATE_SIZE;
     }
+  }
 
-    particleSensor.nextSample(); //We're finished with this sample so move to next sample
+  Serial.print("IR=");
+  Serial.print(irValue);
+  Serial.print(", BPM=");
+  Serial.print(beatsPerMinute);
+  Serial.print(", Avg BPM=");
+  Serial.print(beatAvg);
 
-    Serial.print("IR=");
-    Serial.print(irValue);
-    Serial.print(", BPM=");
-    Serial.print(beatsPerMinute);
-    Serial.print(", Avg BPM=");
-    Serial.print(beatAvg);
+  if (irValue < 50000)
+    Serial.print(" No finger?");
 
-    if(irValue < 50000)
-      Serial.print(" No finger?");
-      
-    Serial.println();
-  }
+  Serial.println();
 }