Batear

<div align="center"> <img src="icon.png" alt="Batear Logo" width="200"/> <h1>Batear</h1> <p><strong>A ultra-low-cost, edge-only acoustic drone detector on ESP32-S3 with encrypted LoRa alerting.</strong></p> <p align="center"> <a href="https://hackaday.com/2026/03/23/acoustic-drone-detection-on-the-cheap-with-esp32/"><img src="https://img.shields.io/badge/Featured%20on-Hackaday-black?logo=hackaday" alt="Featured on Hackaday" style="display:inline-block;"></a><a href="https://github.com/TN666/batear/stargazers"><img src="https://img.shields.io/github/stars/TN666/batear?style=flat-square" alt="Stars" style="display:inline-block;"></a><a href="https://github.com/TN666/batear/blob/main/LICENSE"><img src="https://img.shields.io/github/license/TN666/batear?style=flat-square" alt="License" style="display:inline-block;"></a> </p> <p align="center"> <a href="https://github.com/batear-io/batear/actions/workflows/esp-idf-build.yml"><img src="https://github.com/batear-io/batear/actions/workflows/esp-idf-build.yml/badge.svg" alt="Firmware Build"></a><a href="https://github.com/batear-io/batear/actions/workflows/cppcheck.yml"><img src="https://github.com/batear-io/batear/actions/workflows/cppcheck.yml/badge.svg" alt="Static Analysis"></a><a href="https://github.com/batear-io/batear/actions/workflows/size_report.yml"><img src="https://github.com/batear-io/batear/actions/workflows/size_report.yml/badge.svg" alt="Firmware Size"></a> </p>

<br><br>

<p><em>"Built for defense, hoping it becomes unnecessary. We believe in a world where no one needs to fear the sky."</em></p> </div> <br><br> <div align="center"> <a href="https://youtu.be/_OXP_MpExm8?si=sbgMLhAHPr7uCMk2"> <img src="https://img.youtube.com/vi/_OXP_MpExm8/0.jpg" alt="Batear Demo Video" width="600"> </a> <br><br> <em>▶️ Click to watch the bench test demo</em> </div> <br>

---

Drones are an increasing threat to homes, farms, and communities — and effective detection has traditionally required expensive radar or camera systems. Batear changes that.

For ultra-low-cost hardware, Batear turns a tiny ESP32-S3 microcontroller and a MEMS microphone into an always-on acoustic drone detector. It runs entirely at the edge — no cloud subscription, no internet connection, no ongoing cost. Deploy one at a window, a fence line, or a rooftop and it will alert you the moment drone rotor harmonics are detected nearby.

The same codebase builds as a Detector (mic + LoRa TX) or a Gateway (LoRa RX + OLED + LED), selectable at build time.

---

📖 Documentation

Full documentation is available at batear.io.

| | | |:---|:---| | Getting Started | Prerequisites and supported boards | | Hardware | Parts list, wiring diagrams, pin map | | Build & Flash | Compile and flash the firmware | | Configuration | Encryption keys, frequencies, device IDs | | How It Works | FFT harmonic detection algorithm | | Calibration | Tuning detection thresholds | | Adding a Board | Porting to new hardware |

---

🏗️ System Architecture

┌──────────────────────┐        LoRa 915 MHz          ┌──────────────────────┐
│    DETECTOR (×N)     │ ───────────────────────────► │     GATEWAY (×1)     │
│                      │  AES-128-GCM encrypted       │                      │
│  ICS-43434 mic       │  28-byte packets             │  SSD1306 OLED display│
│  FFT harmonic detect │                              │  LED alarm indicator │
│  SX1262 LoRa TX      │                              │  SX1262 LoRa RX      │
└──────────────────────┘                              └──────────────────────┘
   Heltec WiFi LoRa 32 V3                               Heltec WiFi LoRa 32 V3

---

⚡ Quick Start

# Clone
git clone https://github.com/batear-io/batear.git && cd batear

# Build detector
idf.py -B build_detector \
  -DSDKCONFIG=build_detector/sdkconfig \
  -DSDKCONFIG_DEFAULTS="sdkconfig.defaults;sdkconfig.detector" \
  set-target esp32s3
idf.py -B build_detector -DSDKCONFIG=build_detector/sdkconfig build

# Flash (replace PORT)
idf.py -B build_detector -DSDKCONFIG=build_detector/sdkconfig -p PORT flash monitor

See the full build guide for gateway setup and detailed instructions.

---

👤 Author

<a href="https://github.com/TN666"> <img src="https://images.weserv.nl/?url=https://github.com/TN666.png?v=4&w=200&h=200&fit=cover&mask=circle&maxage=7d" width="100"> </a>