feat: create burst measurement example

add documentation for the default scale on burst read

Author: cdonate

examples/Example11_BurstRead/Example11_BurstRead.ino

@@ -0,0 +1,68 @@
+/*
+  Get environmental readings as a burst from the BME280
+  By: Claudio Donaté
+  Date: December 30th, 2020
+  License: This code is public domain but you buy me a beer if you use this and we meet someday (Beerware license).
+
+  Feel like supporting our work? Buy a board from SparkFun!
+  https://www.sparkfun.com/products/14348 - Qwiic Combo Board
+  https://www.sparkfun.com/products/13676 - BME280 Breakout Board
+  
+  This example shows how to read humidity, pressure, and current temperature from the BME280 over I2C reading all registers at once.
+  Please check BME280 Datasheet, section 4, Data readout for detail explanations on why.
+
+  Hardware connections:
+  BME280 -> Arduino
+  GND -> GND
+  3.3 -> 3.3
+  SDA -> A4
+  SCL -> A5
+*/
+
+#include <Wire.h>
+
+#include "SparkFunBME280.h"
+
+#define CELSIUS_SCALE 0 //Default
+#define FAHRENHEIT_SCALE 1
+
+BME280 mySensor;
+BME280_SensorMeasurements measurements;
+
+void setup()
+{
+  Serial.begin(9600);
+  Serial.println("Reading basic values from BME280 as a Burst");
+
+  Wire.begin();
+
+  if (mySensor.beginI2C() == false) //Begin communication over I2C
+  {
+    Serial.println("The sensor did not respond. Please check wiring.");
+    while(1); //Freeze
+  }
+}
+
+void loop()
+{
+  while (mySensor.isMeasuring()) // Wait for sensor to finish measuring
+  {
+      Serial.print("."); 
+  };
+    
+  mySensor.readAllMeasurements(&measurements); // Return temperature in Celsius
+  // mySensor.readAllMeasurements(&measurements, FAHRENHEIT_SCALE);
+  
+  Serial.print("\nHumidity: ");
+  Serial.print(measurements.humidity, 0);
+
+  Serial.print(" Pressure: ");
+  Serial.print(measurements.pressure, 0);
+
+  Serial.print(" Temp: ");
+  Serial.print(measurements.temperature, 2);
+
+  Serial.println();
+
+  delay(50);
+}

src/SparkFunBME280.cpp

@@ -362,7 +362,7 @@ void BME280::reset( void )
 //****************************************************************************//
 
 //Read all sensor registers as a burst. See BME280 Datasheet section 4. Data readout
-//tempScale = 0 for Celsius scale
+//tempScale = 0 for Celsius scale (default setting)
 //tempScale = 1 for Fahrenheit scale
 void BME280::readAllMeasurements(BME280_SensorMeasurements *measurements, byte tempScale){