NetAudio.h

#pragma once
#include <Arduino.h>
#include "AudioLink.h"

// ---------------------------------------------------------------------------
// NetAudio (Core2): receives the StickS3 wireless-mic stream over ESP-NOW,
// decodes the IMA-ADPCM frames into a PSRAM ring buffer, and hands samples to
// the AudioEngine. Also sends deck status back to the stick.
//
// Producer = ESP-NOW receive callback (Wi-Fi task); consumer = main loop.
// Single-producer / single-consumer ring with volatile head/tail.
// ---------------------------------------------------------------------------
class NetAudio {
 public:
  bool begin();

  // Stick has sent any frame (audio or idle heartbeat) recently.
  bool connected() const;
  // Stick is currently streaming a recording (KEY1 held).
  bool remoteRecActive() const;

  // Drain up to maxSamples decoded samples into dst. Returns count copied.
  size_t pull(int16_t* dst, size_t maxSamples);

  // Heartbeat / mirror to the stick display.
  void sendStatus(uint8_t deckState, uint8_t selTrack, bool remoteRec);

  // Called from the static ESP-NOW receive callback.
  void onRecvPacket(const uint8_t* data, int len);

 private:
  void push(const int16_t* s, size_t n);
  void pushSilence(size_t n);

  static constexpr uint32_t RING_SAMPLES = 16384;  // ~1 s at 16 kHz, PSRAM

  int16_t* _ring = nullptr;
  volatile uint32_t _head = 0;   // producer
  volatile uint32_t _tail = 0;   // consumer

  volatile uint32_t _lastFrameMs = 0;
  volatile uint32_t _lastRecMs   = 0;
  volatile uint16_t _lastSeq     = 0;
  volatile bool     _haveSeq     = false;
  volatile bool     _lastWasRec  = false;
};

extern NetAudio Net;