# ESP32-C6 RTSP Audio Streamer für BirdNET-Go

Dieses Repository enthält die Firmware für einen autarken RTSP-Audiostreamer auf Basis des **Seeed Studio XIAO ESP32-C6** und eines I2S-MEMS-Mikrofons (**ICS-43434**).

Der Streamer erfasst Audio mit 48 kHz / 16 Bit Mono und stellt es als standardkonformen RTSP/RTP-Stream bereit, der direkt von **BirdNET-Go** (z. B. im Docker-Container auf einem NAS) oder VLC verarbeitet werden kann.

---

## Features

* **Direktes I2S-DMA-Sampling:** Nutzt den Treiber `driver/i2s_std.h` (ESP-IDF 5.x) für unterbrechungsfreie Audioaufnahme ohne CPU-Spikes.
* **RFC 3550 L16 Standard:** Skalierung von 32-Bit-I2S-Rohdaten auf 16-Bit-PCM inklusive Konvertierung in Big-Endian (Network Byte Order).
* **TCP-Interleaved RTP:** Erzwingt RTSP-Streaming über TCP (Port 8554), wodurch Verbindungsprobleme durch Docker-NAT-Bridges oder blockierte UDP-Ports umgangen werden.
* **Low-Latency Wi-Fi:** Deaktivierter Modem-Sleep (`WiFi.setSleep(false)`) verhindert zyklische Ping-Latenzen und Pufferüberläufe.

---

## Hardware & Pinbelegung

### Komponenten
* **MCU:** Seeed Studio XIAO ESP32-C6 (mit externer 2,4-GHz-Stabantenne)
* **Mikrofon:** TDK InvenSense ICS-43434 (I2S MEMS, Bottom-Port)

### Verdrahtung

| Mikrofon | XIAO ESP32-C6 Pin | GPIO | Beschreibung |
| :--- | :--- | :--- | :--- |
| **VDD** | **3V3** | – | Versorgungsspannung (3,3 V – **niemals an 5 V!**) |
| **GND** | **GND** | – | Masse |
| **L/R** | **GND** | – | Kanalwahl (GND = linker Slot / `I2S_STD_SLOT_LEFT`) |
| **SCK / BCLK** | **D0** | GPIO 0 | I2S Bit Clock |
| **WS / LRCLK** | **D1** | GPIO 1 | I2S Word Select (Sample-Takt 48 kHz) |
| **SD / DOUT** | **D2** | GPIO 2 | I2S Serial Data Out -> DIN |

> **Wichtig:** Die externe 2,4-GHz-Antenne am U.FL-Anschluss des XIAO ESP32-C6 muss zwingend aufgesteckt sein, um Paketverlust und Verbindungsabbrüche im WLAN zu vermeiden.

---

## Konfiguration & Flashen

### Voraussetzungen
* **Arduino IDE** (mit installiertem ESP32-Boardpaket >= 3.0.0) oder **PlatformIO**
* **Boardauswahl:** `Seeed Studio XIAO ESP32-C6` (oder `ESP32C6 Dev Module`)
* **USB-CDC On Boot:** Aktiviert (`Enabled`)

### Anpassung
Passe vor dem Kompilieren in `main.cpp` die WLAN-Zugangsdaten an:

```cpp
const char* ssid     = "DEINE_SSID";
const char* password = "DEIN_WLAN_PASSWORT";
```

Nach dem erfolgreichen Flashen gibt der serielle Monitor (115200 Baud) die RTSP-URL aus:

```text
RTSP URL: rtsp://<ESP32-IP>:8554/stream
```

---

## Einbindung in BirdNET-Go

1. Web-Dashboard von **BirdNET-Go** öffnen (`http://<NAS-IP>:5069`).
2. Unter **Settings** -> **Audio / Input** einen neuen Stream anlegen:
   * **Stream-Name:** `ESP32-C6 Mikrofon`
   * **Stream-URL:** `rtsp://<ESP32-IP>:8554/stream`
   * **Stream-Typ:** `RTSP`
   * **Protokoll:** `TCP`
3. Auf **Stream testen** klicken und speichern.

---

## Lokaler Test (VLC Media Player)

Um den Stream unabhängig von BirdNET-Go zu verifizieren:

1. VLC öffnen -> `Strg + N` (Netzwerkstream öffnen).
2. URL eingeben: `rtsp://<ESP32-IP>:8554/stream`.
3. Auf **Wiedergabe** klicken. Das Mikrofon überträgt die Umgebungsgeräusche in Echtzeit.