/** * @file sound_engine.h * @brief Tiny non-blocking I2S sound engine for the T-Deck speaker. * * A FreeRTOS task owns the I2S peripheral (speaker, I2S_NUM_0) and renders * queued sound events one after another. The game only ever pushes events, * so it never blocks. Event types: * * SND_TONE fixed square-wave beep * SND_SWEEP square wave gliding from freq down/up to freq2 (sirens, booms) * SND_NOISE white-noise burst with linear decay (explosions) */ #pragma once #include enum SndType : uint8_t { SND_TONE = 0, // fixed square wave SND_SWEEP, // square wave gliding freq -> freq2 SND_NOISE, // white noise burst }; struct SndEvent { SndType type; uint16_t freq; // Hz (tone, or sweep start) uint16_t freq2; // Hz (sweep end; ignored for tone/noise) uint16_t dur; // duration in ms uint16_t amp; // peak amplitude 0..32767 }; class SoundEngine { public: static const uint8_t VOL_MAX = 8; bool begin(); void play(const SndEvent &e); // Master volume, applied to every rendered sound void volumeUp(); void volumeDown(); void toggleMute(); uint8_t volume() const { return vol_; } private: static void trampoline(void *arg); void task(); void renderTone(uint16_t freq, uint16_t durMs, uint16_t amp); void renderSweep(uint16_t freq0, uint16_t freq1, uint16_t durMs, uint16_t amp); void renderNoise(uint16_t durMs, uint16_t amp); QueueHandle_t q_ = nullptr; uint8_t vol_ = 5; // default: moderate uint8_t lastVol_ = 5; // remembered for mute toggle };