Game (examples/MissileCommand): - Classic Missile Command: 6 cities, 3 batteries x 10 missiles, escalating waves, smart bombs, score multiplier, session high score - Trackball aims, press/tap fires, keyboard A/S/D selects battery, screen tap aims+fires - Rendering: incremental TFT_eSPI drawing (persistent enemy trails that vanish on death, no AA-rocket trails, explosion circles that repair terrain, ghost-free crosshair) - Sound (sound_engine.cpp): non-blocking I2S task on core 0; wave-start alarm of four falling tones (like the original), sweeps/noise effects, U/V/M keyboard volume control with OSD, master volume scaling Emulator (emulator/): - SDL2 host that compiles the unmodified sketch against shim headers (Arduino, TFT_eSPI->framebuffer, GT911 touch, I2C keyboard, I2S->SDL audio); arrow keys emulate the trackball, --autoplay/--frames/--dump flags for headless smoke tests
55 lines
1.6 KiB
C++
55 lines
1.6 KiB
C++
/**
|
|
* @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 <Arduino.h>
|
|
|
|
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
|
|
};
|