Added Buzzer Controls

Author: 4tronix

bitbot.ts

@@ -362,6 +362,16 @@ enum BBirNoAny
     Go=56
 }
 
+/**
+  * Volume settings for Buzzer
+  */
+enum BBBuzzVolume
+{
+  Off=0,
+  Quiet=130,
+  Medium=160,
+  Loud=200
+}
 
 /**
  * Custom blocks
@@ -1388,14 +1398,14 @@ namespace bitbot
 	}
     }
 
-// Power Management Block
+// General Blocks that don't quite fit anywhere else
     /**
       * Read the battery voltage
       */
     //% blockId="BBBattery" block="battery voltage"
     //% weight=100
     //% subcategory="BitBot PRO"
-    //% group="Power"
+    //% group="General"
     export function batteryVoltage(): number
     {
 	if(isPRO())
@@ -1407,6 +1417,24 @@ namespace bitbot
 	    return 0
     }
 
+    /**
+      * Set the buzzer volume
+      */
+    //% blockId="BBVolume"
+    //% block="set buzzer volume%volume"
+    //% weight=90
+    //% subcategory="BitBot PRO"
+    //% group="General"
+    export function setVolume(volume: BBBuzzVolume): void
+    {
+	if(isPRO())
+	{
+	    music.setVolume(volume)
+	    if(control.hardwareVersion() == '1')
+		music.stopAllSounds()
+	}
+    }
+
 
 // Built-in Infrared Receiver Blocks - BitBot PRO Only
 
@@ -1863,7 +1891,7 @@ namespace bitbot
 // Built-in Sensors - Inputs and Outputs
 
     /**
-      * Sound a buzz.
+      * Turn On/Off buzzer
       * @param flag state of buzzer (On or Off)
       */
     //% blockId="bitbot_buzz" block="turn buzzer%flag"
@@ -1886,6 +1914,20 @@ namespace bitbot
 	}
     }
 
+    /**
+      * Sound buzzer for selected time
+      * @param duration time for buzzer to sound in ms eg: 400
+      */
+    //% blockId="bitbot_sound" block="sound buzzer for%duration|ms"
+    //% weight=95
+    //% subcategory="Inputs & Outputs"
+    export function buzzTime(duration: number): void
+    {
+        buzz(true)
+	basic.pause(duration)
+	buzz(false)
+    }
+
     /**
     * Read distance from sonar module connected to accessory connector.
     * @param unit desired conversion unit

pxt.json

@@ -1,6 +1,6 @@
 {
     "name": "BitBot",
-    "version": "2.1.3",
+    "version": "2.1.4",
     "description": "MakeCode package for 4tronix BitBot PRO, BitBot XL & BitBot robots",
     "license": "MIT",
     "dependencies": {