Source code for adafruit_circuitplayground.bluefruit

# SPDX-FileCopyrightText: 2019 Kattni Rembor for Adafruit Industries
# SPDX-License-Identifier: MIT


CircuitPython helper for Circuit Playground Bluefruit.

* Author(s): Kattni Rembor

Implementation Notes


* `Circuit Playground Bluefruit <>`_

    import typing  # pylint: disable=unused-import
except ImportError:

import array
import math
import digitalio
import board
import audiopwmio
import audiomp3
import audiobusio
from adafruit_circuitplayground.circuit_playground_base import CircuitPlaygroundBase

__version__ = "0.0.0+auto.0"
__repo__ = ""

[docs] class Bluefruit(CircuitPlaygroundBase): """Represents a single CircuitPlayground Bluefruit.""" _audio_out = audiopwmio.PWMAudioOut def __init__(self) -> None: # Only create the cpb module member when we aren't being imported by Sphinx if ( "__module__" in dir(digitalio.DigitalInOut) and digitalio.DigitalInOut.__module__ == "sphinx.ext.autodoc" ): return super().__init__() self._sample = None # Define mic/sound sensor: self._mic = audiobusio.PDMIn( board.MICROPHONE_CLOCK, board.MICROPHONE_DATA, sample_rate=16000, bit_depth=16, ) self._samples = None @staticmethod def _normalized_rms(values) -> float: mean_values = int(sum(values) / len(values)) return math.sqrt( sum( float(sample - mean_values) * (sample - mean_values) for sample in values ) / len(values) ) @property def sound_level(self) -> float: """Obtain the sound level from the microphone (sound sensor). .. image :: ../docs/_static/microphone.jpg :alt: Microphone (sound sensor) This example prints the sound levels. Try clapping or blowing on the microphone to see the levels change. .. code-block:: python from adafruit_circuitplayground.bluefruit import cpb while True: print(cpb.sound_level) """ if self._sample is None: self._samples = array.array("H", [0] * 160) self._mic.record(self._samples, len(self._samples)) return self._normalized_rms(self._samples)
[docs] def loud_sound(self, sound_threshold: int = 200) -> bool: """Utilise a loud sound as an input. :param int sound_threshold: Threshold sound level must exceed to return true (Default: 200) .. image :: ../docs/_static/microphone.jpg :alt: Microphone (sound sensor) This example turns the LEDs red each time you make a loud sound. Try clapping or blowing onto the microphone to trigger it. .. code-block:: python from adafruit_circuitplayground.bluefruit import cpb while True: if cpb.loud_sound(): cpb.pixels.fill((50, 0, 0)) else: cpb.pixels.fill(0) You may find that the code is not responding how you would like. If this is the case, you can change the loud sound threshold to make it more or less responsive. Setting it to a higher number means it will take a louder sound to trigger. Setting it to a lower number will take a quieter sound to trigger. The following example shows the threshold being set to a higher number than the default. .. code-block:: python from adafruit_circuitplayground.bluefruit import cpb while True: if cpb.loud_sound(sound_threshold=300): cpb.pixels.fill((50, 0, 0)) else: cpb.pixels.fill(0) """ return self.sound_level > sound_threshold
[docs] def play_mp3(self, file_name: str) -> None: """Play a .mp3 file using the onboard speaker. :param file_name: The name of your .mp3 file in quotation marks including .mp3 .. image :: ../docs/_static/speaker.jpg :alt: Onboard speaker To use with the Circuit Playground Bluefruit: .. code-block:: python from adafruit_circuitplayground import cp while True: if cp.button_a: cp.play_mp3("laugh.mp3") elif cp.button_b: cp.play_mp3("rimshot.mp3") """ if file_name.lower().endswith(".mp3"): # Play a specified file. self.stop_tone() self._speaker_enable.value = True with self._audio_out(board.SPEAKER) as audio, audiomp3.MP3Decoder( open(file_name, "rb") ) as mp3file: # pylint: disable=not-callable while audio.playing: pass self._speaker_enable.value = False else: raise ValueError("Filetype must be mp3")
cpb = Bluefruit() # pylint: disable=invalid-name """Object that is automatically created on import. To use, simply import it from the module: .. code-block:: python from adafruit_circuitplayground.bluefruit import cpb """