Added speaker tones to Circuit Playground Express CircuitPython API.

adafruit_circuitplayground/express.py

@@ -1,10 +1,13 @@
-import math
-
-import board
+import adafruit_thermistor
 import analogio
+import array
+import audioio
+import board
 import digitalio
+import math
 import neopixel
-import adafruit_thermistor
+import time
+
 
 class Photocell:
     def __init__(self, pin):
@@ -63,6 +66,10 @@ def __init__(self):
         self._temp = adafruit_thermistor.Thermistor(board.TEMPERATURE, 10000, 10000, 25, 3950)
         self._light = Photocell(board.LIGHT)
 
+        # Define audio:
+        self.speaker_enable = digitalio.DigitalInOut(board.SPEAKER_ENABLE)
+        self.speaker_enable.switch_to_output(value=False)
+
     @property
     def button_a(self):
         """``True`` when Button A is pressed. ``False`` if not.
@@ -184,6 +191,40 @@ def red_led(self):
     def red_led(self, value):
         self._led.value = value
 
+    def play_tone(self, frequency, duration):
+        """ Produce a tone using the speaker.
+
+        :param int frequency: The frequency of the tone in Hz
+        :param float duration: The duration of the tone in seconds
+
+        .. image :: /_static/speaker.jpg
+
+            The two numbers are frequency and duration. Duration is how long it
+            plays in seconds. Try changing frequency to change the pitch of the
+            tone.
+
+        ..code-block:python
+
+            from adafruit_circuitplayground.express import circuit
+
+            circuit.play_tone(440, 1)
+        """
+        length = 8000 // frequency
+        sine_wave = array.array("H", [0] * length)
+        for i in range(length):
+            sine_wave[i] = int(math.sin(math.pi * 2 * i / 18) * (2 ** 15) + 2 ** 15)
+
+        sample = audioio.AudioOut(board.SPEAKER, sine_wave)
+
+        self.speaker_enable.value = True
+
+        sample.play(loop=True)
+        time.sleep(duration)
+        sample.stop()
+
+        self.speaker_enable.value = False
+
+
 circuit = Express()
 """Object that is automatically created on import.