changed how on() and configureBuzzer() work

-on() no longer takes settings arguments. It soley sets the buzzerActiveRegister to turn on the buzzer
-configureBuzzer must be called separately in examples to configure the buzzer
-removed silentConfiguration example 9 - because this is done in most other examples already. That is, when you call configureBuzzer(), this does not cause the buzzer to buzz, and so is "silent".

Author: lewispg228

examples/Example_02_Buzz_Frequency/Example_02_Buzz_Frequency.ino

@@ -39,13 +39,17 @@ void setup() {
 }
 
 void loop() {
-  buzzer.on(2730); // resonant frequency is 2.73KHz
+  // Configure with desired settings
+  // Resonant frequency is 2.73KHz
+  buzzer.configureBuzzer(SFE_QWIIC_BUZZER_RESONANT_FREQUENCY); 
+  buzzer.on(); 
   delay(100);
 
   buzzer.off();
   delay(1000);
 
-  buzzer.on(1000); // try out 1KHz for fun
+  buzzer.configureBuzzer(1000); // set frequency to 1KHz
+  buzzer.on(); 
   delay(100);
 
   buzzer.off();

examples/Example_03_Buzz_Duration/Example_03_Buzz_Duration.ino

@@ -39,10 +39,12 @@ void setup() {
 }
 
 void loop() {
-  buzzer.on(2730, 100); // frequency: 2.73KHz, duration: 100ms
+  buzzer.configureBuzzer(2730, 100); // frequency: 2.73KHz, duration: 100ms
+  buzzer.on();
   delay(1000);
 
-  buzzer.on(1000, 500); // frequency: 1K, duration: 500ms
+  buzzer.configureBuzzer(1000, 500); // frequency: 1K, duration: 500ms
+  buzzer.on();
   delay(1000);
 
   // Note, we dont' have to call buzzer.off(), because it will automatically turn

examples/Example_04_Buzz_Volume/Example_04_Buzz_Volume.ino

@@ -3,10 +3,10 @@
 
   This example shows how to control the buzzer to sound at different volumes.
 
-  Note, the "on()" function accepts three arguments, and you must send all three
+  Note, the "configureBuzzer()" function accepts three arguments, and you must send all three
   in order to access the volume control.
 
-  on(frequency, duration, volume);
+  configureBuzzer(frequency, duration, volume);
 
   It turns the buzzer on and off.
   Much like the classic "blink LED sketch" this will buzz
@@ -45,19 +45,23 @@ void setup() {
 
 void loop() {
   Serial.println("Volume: MIN (1)");
-  buzzer.on(2730, 100, SFE_QWIIC_BUZZER_VOLUME_MIN); // frequency: 2.73KHz, duration: 100ms, volume: MIN
+  buzzer.configureBuzzer(2730, 100, SFE_QWIIC_BUZZER_VOLUME_MIN); // frequency: 2.73KHz, duration: 100ms, volume: MIN
+  buzzer.on();
   delay(1000);
 
   Serial.println("Volume: LOW (2)");
-  buzzer.on(2730, 100, SFE_QWIIC_BUZZER_VOLUME_LOW); // frequency: 2.73KHz, duration: 100ms, volume: LOW
+  buzzer.configureBuzzer(2730, 100, SFE_QWIIC_BUZZER_VOLUME_LOW); // frequency: 2.73KHz, duration: 100ms, volume: LOW
+  buzzer.on();
   delay(1000);
 
   Serial.println("Volume: MID (3)");
-  buzzer.on(2730, 100, SFE_QWIIC_BUZZER_VOLUME_MID); // frequency: 2.73KHz, duration: 100ms, volume: MID
+  buzzer.configureBuzzer(2730, 100, SFE_QWIIC_BUZZER_VOLUME_MID); // frequency: 2.73KHz, duration: 100ms, volume: MID
+  buzzer.on();
   delay(1000);
 
   Serial.println("Volume: MAX (4)");
-  buzzer.on(2730, 100, SFE_QWIIC_BUZZER_VOLUME_MAX); // frequency: 2.73KHz, duration: 100ms, volume: MAX
+  buzzer.configureBuzzer(2730, 100, SFE_QWIIC_BUZZER_VOLUME_MAX); // frequency: 2.73KHz, duration: 100ms, volume: MAX
+  buzzer.on();
   delay(1000);
 
   // Note, we dont' have to use buzzer.off(), because it will automatically turn

examples/Example_06_SaveSettings/Example_06_SaveSettings.ino

@@ -23,8 +23,8 @@
   Qwiic buzzer up. Then you can use the TRIGGER header to cause the buzzer to 
   buzz at your saved settings.
 
-  Note, the "on()" function accepts three arguments:
-  on(frequency, duration, volume);
+  Note, the "configureBuzzer()" function accepts three arguments:
+  configureBuzzer(frequency, duration, volume);
 
   By Pete Lewis @ SparkFun Electronics
   December 2023
@@ -61,11 +61,12 @@ void setup() {
   // Comment/Un-Comment the following "buzzer.on()" example lines to try different settings:
 
   // "MOMENTARY" SETUP
-  buzzer.on(1000, 0, SFE_QWIIC_BUZZER_VOLUME_MID); // frequency: 1KHz, duration: 0 (aka forever), volume: MID
+  buzzer.configureBuzzer(1000, 0, SFE_QWIIC_BUZZER_VOLUME_MID); // frequency: 1KHz, duration: 0 (aka forever), volume: MID
 
   // "ONE-SHOT" Setup (aka adding in a duration amount).
-  // buzzer.on(1000, 100, SFE_QWIIC_BUZZER_VOLUME_MID); // frequency: 1KHz, duration: 100ms, volume: MID
+  // buzzer.configureBuzzer(1000, 100, SFE_QWIIC_BUZZER_VOLUME_MID); // frequency: 1KHz, duration: 100ms, volume: MID
 
+  buzzer.on();
   delay(1000);
 
   Serial.println("Buzzer OFF");

examples/Example_07_Melody/Example_07_Melody.ino

@@ -71,7 +71,8 @@ void play_melody()
     // to calculate the note duration, take one second divided by the note type.
     //e.g. quarter note = 1000 / 4, eighth note = 1000/8, etc.
     int noteDuration = 1000 / noteDurations[thisNote];
-    buzzer.on(melody[thisNote], noteDuration, SFE_QWIIC_BUZZER_VOLUME_MAX);
+    buzzer.configureBuzzer(melody[thisNote], noteDuration, SFE_QWIIC_BUZZER_VOLUME_MAX);
+    buzzer.on();
 
     // to distinguish the notes, set a minimum time between them.
     // the note's duration + 30% seems to work well:

examples/Example_08_Sound_Effects/Example_08_Sound_Effects.ino

@@ -76,8 +76,8 @@
 #include <SparkFun_Qwiic_Buzzer_Arduino_Library.h>
 QwiicBuzzer buzzer;
 
-#define kBuzzerVolume 4 // loudest!!
-//#define kBuzzerVolume 3 // pretty good volume for most things
+#define BUZZER_VOLUME 4 // loudest!!
+//#define BUZZER_VOLUME 3 // pretty good volume for most things
 sfeTkError_t err; // used for checking for errors
 
 void setup() {
@@ -97,7 +97,7 @@ void setup() {
   {
     Serial.print("Sound Effect: ");
     Serial.println(i);
-    err = buzzer.playSoundEffect(i, kBuzzerVolume);
+    err = buzzer.playSoundEffect(i, BUZZER_VOLUME);
 
     // Check whether the playSoundEffect() was successful
     if (err != kSTkErrOk)

examples/Example_09_SilentConfiguration/Example_09_SilentConfiguration.ino

@@ -18,8 +18,6 @@ configureBuzzer   				    KEYWORD2
 on  					            KEYWORD2
 off   					            KEYWORD2
 saveSettings   				        KEYWORD2
-setBuzzerActiveReg   				KEYWORD2
-clearBuzzerActiveReg   				KEYWORD2
 playSoundEffect                     KEYWORD2
 
 #########################################################