Source code for audiodev.pwm_tone

# SPDX-FileCopyrightText: 2026 Brad Barnett
#
# SPDX-License-Identifier: MIT

"""PWM / buzzer adapter for `audiodev.ToneOutput`."""

from audiodev import ToneOutput


def _resolve(value):
    return value() if callable(value) else value


[docs] class PWMToneOutput(ToneOutput): """Tone output around a PWM pin or an object with ``play`` / ``stop``.""" def __init__(self, pwm, *, session=None, power=None): super().__init__(session=session, power=power) self._pwm_factory = pwm self._pwm = None @property def pwm(self): return self._pwm def _open(self): self._pwm = _resolve(self._pwm_factory) if hasattr(self._pwm, "open"): self._pwm.open() def _close(self): pwm = self._pwm self._pwm = None if pwm is None: return if hasattr(pwm, "close"): pwm.close() elif hasattr(pwm, "deinit"): pwm.deinit() def _play(self, frequency, level): pwm = self._pwm if hasattr(pwm, "play"): pwm.play(frequency, level) return pwm.freq(int(frequency)) duty = level * 32768 // 100 if hasattr(pwm, "duty_u16"): pwm.duty_u16(duty) else: pwm.duty(level * 512 // 100) def _stop(self): pwm = self._pwm if hasattr(pwm, "stop"): pwm.stop() elif hasattr(pwm, "duty_u16"): pwm.duty_u16(0) else: pwm.duty(0)
[docs] def tone_out(pwm, *, session=None, power=None): """Build a `PWMToneOutput` around *pwm* (instance or factory).""" return PWMToneOutput(pwm, session=session, power=power)