feat(audio): add protocol-agnostic message prompt tones for pager and tdeck

Author: vicliu624

src/app/app_context.cpp

@@ -294,6 +294,7 @@ void AppContext::update()
             {
                 APP_EVENT_LOG("[AppContext::update] Triggering haptic feedback...\n");
                 board_->vibrator();
+                board_->playMessageTone();
                 APP_EVENT_LOG("[AppContext::update] Haptic feedback triggered\n");
             }
             else
@@ -311,6 +312,7 @@ void AppContext::update()
             if (board_)
             {
                 board_->vibrator();
+                board_->playMessageTone();
             }
             std::string notice = "Team: ";
             const auto& msg = team_event->data.msg;

src/board/BoardBase.h

@@ -37,6 +37,9 @@ class BoardBase
     // 触觉反馈
     virtual void vibrator() = 0;
     virtual void stopVibrator() = 0;
+
+    // 收到消息提示音（默认空实现，具体板级按需覆盖）
+    virtual void playMessageTone() {}
 };
 
 // 全局板实例（与原来的 instance 等价，用于解耦调用方类型）

src/board/TDeckBoard.cpp

@@ -1,6 +1,9 @@
 #include "board/TDeckBoard.h"
 #include "board/sd_utils.h"
 #include "display/drivers/ST7789TDeck.h"
+#include <AudioFileSourcePROGMEM.h>
+#include <AudioGeneratorRTTTL.h>
+#include <AudioOutputI2S.h>
 #include <SD.h>
 #include <Wire.h>
 #include <ctime>
@@ -872,6 +875,57 @@ RotaryMsg_t TDeckBoard::getRotary()
     return msg;
 }
 
+void TDeckBoard::playMessageTone()
+{
+#if defined(DAC_I2S_BCK) && defined(DAC_I2S_WS) && defined(DAC_I2S_DOUT)
+    static bool s_playing = false;
+    static uint32_t s_last_play_ms = 0;
+
+    if (s_playing)
+    {
+        return;
+    }
+
+    const uint32_t now = millis();
+    if ((now - s_last_play_ms) < 240)
+    {
+        return;
+    }
+
+    s_playing = true;
+    s_last_play_ms = now;
+
+    static const char kMessageToneRtttl[] = "MsgRcv:d=4,o=6,b=200:32e,32g,32b,16c7";
+
+    AudioOutputI2S audio_out(1, AudioOutputI2S::EXTERNAL_I2S);
+#if defined(DAC_I2S_MCLK)
+    audio_out.SetPinout(DAC_I2S_BCK, DAC_I2S_WS, DAC_I2S_DOUT, DAC_I2S_MCLK);
+#else
+    audio_out.SetPinout(DAC_I2S_BCK, DAC_I2S_WS, DAC_I2S_DOUT);
+#endif
+    audio_out.SetGain(0.18f);
+
+    AudioFileSourcePROGMEM song(kMessageToneRtttl, sizeof(kMessageToneRtttl) - 1);
+    AudioGeneratorRTTTL generator;
+
+    if (generator.begin(&song, &audio_out))
+    {
+        const uint32_t deadline = millis() + 1600;
+        while (generator.isRunning() && millis() < deadline)
+        {
+            if (!generator.loop())
+            {
+                break;
+            }
+            delay(1);
+        }
+        generator.stop();
+    }
+    audio_out.stop();
+    s_playing = false;
+#endif
+}
+
 namespace
 {
 TDeckBoard& getInstanceRef()

src/board/TDeckBoard.h

@@ -65,6 +65,7 @@ class TDeckBoard : public BoardBase,
 
     void vibrator() override {}
     void stopVibrator() override {}
+    void playMessageTone() override;
 
     // LilyGo_Display
     void setRotation(uint8_t rotation) override;

src/board/TLoRaPagerBoard.cpp

@@ -7,6 +7,7 @@
 #include "freertos/task.h"
 #include "freertos/timers.h"
 
+#include <cmath>
 #include <cstring>
 #include <driver/gpio.h>
 #include <esp_sleep.h>
@@ -859,6 +860,119 @@ void TLoRaPagerBoard::stopVibrator()
     log_d("[stopVibrator] Power disabled, function completed");
 }
 
+void TLoRaPagerBoard::playMessageTone()
+{
+#ifndef USING_AUDIO_CODEC
+    return;
+#else
+    if (!(devices_probe & HW_CODEC_ONLINE))
+    {
+        return;
+    }
+
+    static bool s_playing = false;
+    static uint32_t s_last_play_ms = 0;
+
+    if (s_playing)
+    {
+        return;
+    }
+
+    const uint32_t now = millis();
+    if ((now - s_last_play_ms) < 240)
+    {
+        return;
+    }
+
+    s_playing = true;
+    s_last_play_ms = now;
+
+    struct ToneStep
+    {
+        uint16_t freq_hz;
+        uint16_t duration_ms;
+    };
+
+    static constexpr ToneStep kTone[] = {
+        {1319, 55},
+        {1568, 55},
+        {1976, 90},
+    };
+    static constexpr uint16_t kGapMs = 18;
+    static constexpr uint32_t kSampleRate = 16000;
+    static constexpr uint8_t kChannels = 2;
+    static constexpr size_t kFramesPerChunk = 128;
+    static constexpr float kAmplitude = 0.16f;
+    static constexpr float kTwoPi = 6.28318530718f;
+
+    int prev_volume = codec.getVolume();
+    if (prev_volume < 0 || prev_volume > 100)
+    {
+        prev_volume = 50;
+    }
+    bool prev_out_mute = codec.getOutMute();
+
+    bool opened = (codec.open(16, kChannels, kSampleRate) == 0);
+    if (!opened)
+    {
+        s_playing = false;
+        return;
+    }
+
+    codec.setOutMute(false);
+    codec.setVolume(static_cast<uint8_t>(prev_volume < 45 ? 45 : prev_volume));
+
+    int16_t pcm[kFramesPerChunk * kChannels];
+    auto write_silence = [&](uint32_t ms)
+    {
+        uint32_t remaining = (kSampleRate * ms) / 1000;
+        while (remaining > 0)
+        {
+            size_t frames = remaining > kFramesPerChunk ? kFramesPerChunk : static_cast<size_t>(remaining);
+            memset(pcm, 0, frames * kChannels * sizeof(int16_t));
+            codec.write(reinterpret_cast<uint8_t*>(pcm), frames * kChannels * sizeof(int16_t));
+            remaining -= static_cast<uint32_t>(frames);
+        }
+    };
+
+    for (size_t i = 0; i < (sizeof(kTone) / sizeof(kTone[0])); ++i)
+    {
+        const ToneStep& step = kTone[i];
+        uint32_t remaining = (kSampleRate * step.duration_ms) / 1000;
+        float phase = 0.0f;
+        const float phase_step = (kTwoPi * static_cast<float>(step.freq_hz)) / static_cast<float>(kSampleRate);
+
+        while (remaining > 0)
+        {
+            size_t frames = remaining > kFramesPerChunk ? kFramesPerChunk : static_cast<size_t>(remaining);
+            for (size_t n = 0; n < frames; ++n)
+            {
+                int16_t sample = static_cast<int16_t>(sinf(phase) * (32767.0f * kAmplitude));
+                pcm[n * 2] = sample;
+                pcm[n * 2 + 1] = sample;
+                phase += phase_step;
+                if (phase >= kTwoPi)
+                {
+                    phase -= kTwoPi;
+                }
+            }
+            codec.write(reinterpret_cast<uint8_t*>(pcm), frames * kChannels * sizeof(int16_t));
+            remaining -= static_cast<uint32_t>(frames);
+        }
+
+        if (i + 1 < (sizeof(kTone) / sizeof(kTone[0])))
+        {
+            write_silence(kGapMs);
+        }
+    }
+
+    codec.setVolume(static_cast<uint8_t>(prev_volume));
+    codec.setOutMute(prev_out_mute);
+    codec.close();
+    s_playing = false;
+#endif
+}
+
 void TLoRaPagerBoard::setHapticEffects(uint8_t effects)
 {
     if (effects > 127) effects = 127;

src/board/TLoRaPagerBoard.h

@@ -216,6 +216,11 @@ class TLoRaPagerBoard : public BoardBase,
      */
     void stopVibrator() override;
 
+    /**
+     * @brief Play incoming-message prompt tone
+     */
+    void playMessageTone() override;
+
     /**
      * @brief Set haptic effect waveform
      * @param effects Effect number (0-127, see DRV2605 documentation)

variants/tdeck/pins_arduino.h

@@ -29,6 +29,12 @@ static const uint8_t SCK = 40;
 // Board power enable (required very early on T-Deck)
 #define BOARD_POWERON (10)
 
+// T-Deck I2S speaker/amp pins (aligned with Meshtastic T-Deck reference).
+#define DAC_I2S_BCK (7)
+#define DAC_I2S_WS (5)
+#define DAC_I2S_DOUT (6)
+#define DAC_I2S_MCLK (21)
+
 // Display pins (aligned with LilyGo T-Deck examples)
 #define DISP_MOSI (MOSI)
 #define DISP_MISO (MISO)