Document Wired Detector in README and INMP441 mic option

README.md was still describing the project as "Detector or Gateway" and
showing only the LoRa architecture. Update the tagline, intro, web flasher
blurb, and Quick Start to also cover the Wired Detector role, and split
the architecture diagram into a Wireless (LoRa) and a Wired (Ethernet/PoE
+ REST/OTA) block. Also correct the stale 28-byte LoRa packet figure to
match the 36-byte format already used in docs/architecture.md.

docs/hardware.md now lists INMP441 as a drop-in alternative to ICS-43434
on both the Heltec V3/V4 detector and the T-ETH-Lite S3 wired detector
wiring tables (same pinout, same I2S protocol), with a short note on the
sensitivity (-38 vs -26 dBFS) and AOP (130 vs 120 dB SPL) trade-offs so
users can pick informedly between the two mics.

Made-with: Cursor

Author: TN666

README.md

@@ -2,7 +2,7 @@
   <img src="icon.png" alt="Batear Logo" width="200"/>
 
   <h1>Batear</h1>
-  <p><strong>An ultra-low-cost, edge-only acoustic drone detector on ESP32-S3 with encrypted LoRa alerting.</strong></p>
+  <p><strong>An ultra-low-cost, edge-only acoustic drone detector on ESP32-S3 with encrypted LoRa or wired Ethernet/PoE alerting.</strong></p>
 
 <p align="center">
   <a href="https://opencollective.com/batear"><img src="https://img.shields.io/opencollective/all/batear?label=Sponsors&color=blue" alt="Sponsors"></a>
@@ -48,7 +48,7 @@ Drones are an increasing threat to homes, farms, and communities — and effecti
 
 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 + MQTT), selectable at build time. The gateway forwards alerts to **Home Assistant** via MQTT with automatic device discovery.
+The same codebase builds as a **Detector** (mic + LoRa TX), a **Gateway** (LoRa RX + OLED + LED + MQTT), or a **Wired Detector** (mic + Ethernet/PoE + MQTT), selectable at build time. The gateway forwards alerts to **Home Assistant** via MQTT with automatic device discovery; the wired detector publishes directly over Ethernet — no LoRa or gateway required, ideal for permanent installations.
 
 ---
 
@@ -58,7 +58,7 @@ Flash firmware directly from your browser — no toolchain needed:
 
 **[Open Web Flasher](https://docs.batear.io/flasher/)**
 
-> Requires Chrome or Edge on desktop. Just connect your Heltec V3 or V4 via USB-C and click Install.
+> Requires Chrome or Edge on desktop. Connect a Heltec V3/V4 (Detector or Gateway) or a LILYGO T-ETH-Lite S3 (Wired Detector) via USB-C and click Install.
 
 ---
 
@@ -96,11 +96,15 @@ Full documentation is available at **[batear.io](https://docs.batear.io)**.
 
 ## 🏗️ System Architecture
 
+Batear supports two deployment models — pick whichever fits the site:
+
+### Wireless (LoRa Detector → Gateway → MQTT)
+
 ```
 ┌──────────────────────┐        LoRa 915 MHz          ┌──────────────────────┐
 │    DETECTOR (×N)     │ ───────────────────────────► │     GATEWAY (×1)     │
 │                      │  AES-128-GCM encrypted       │                      │
-│  ICS-43434 mic       │  28-byte packets             │  SSD1306 OLED display│
+│  ICS-43434 mic       │  36-byte packets             │  SSD1306 OLED display│
 │  FFT harmonic detect │                              │  LED alarm indicator │
 │  SX1262 LoRa TX      │                              │  SX1262 LoRa RX      │
 └──────────────────────┘                              │  WiFi + MQTT TX      │
@@ -114,6 +118,19 @@ Full documentation is available at **[batear.io](https://docs.batear.io)**.
                                                       └──────────────────────┘
 ```
 
+### Wired (Ethernet/PoE Detector → MQTT, no gateway)
+
+```
+┌──────────────────────┐
+│  WIRED DETECTOR (×N) │       Ethernet (PoE)
+│                      │ ───────────────────────────► ┌──────────────────────┐
+│  ICS-43434 mic       │       MQTT / JSON            │   HOME ASSISTANT     │
+│  FFT harmonic detect │       + REST API / OTA       │   (auto-discovery)   │
+│  W5500 Ethernet      │                              └──────────────────────┘
+└──────────────────────┘
+   LILYGO T-ETH-Lite S3
+```
+
 ---
 
 ## ⚡ Quick Start (Build from Source)
@@ -122,7 +139,8 @@ Full documentation is available at **[batear.io](https://docs.batear.io)**.
 # Clone
 git clone https://github.com/batear-io/batear.git && cd batear
 
-# Build detector
+# Build detector  (swap sdkconfig.detector → sdkconfig.gateway or
+# sdkconfig.wired_detector for the other roles)
 idf.py -B build_detector \
   -DSDKCONFIG=build_detector/sdkconfig \
   -DSDKCONFIG_DEFAULTS="sdkconfig.defaults;sdkconfig.detector" \
@@ -133,7 +151,7 @@ idf.py -B build_detector -DSDKCONFIG=build_detector/sdkconfig build
 idf.py -B build_detector -DSDKCONFIG=build_detector/sdkconfig -p PORT flash monitor
 ```
 
-See the [full build guide](https://docs.batear.io/build-flash/) for gateway setup and detailed instructions.
+See the [full build guide](https://docs.batear.io/build-flash/) for gateway and wired-detector setup and detailed instructions.
 
 ---
 

docs/hardware.md

@@ -5,11 +5,11 @@
 | Component | Notes |
 |:---|:---|
 | Heltec WiFi LoRa 32 V3 / V4 | ESP32-S3 + SX1262 on-board |
-| ICS-43434 I2S MEMS microphone | 3.3 V, L/R → GND (left channel) |
+| ICS-43434 **or** INMP441 I2S MEMS microphone | 3.3 V, L/R → GND (left channel) |
 
-### Wiring (ICS-43434 → Heltec V3 / V4)
+### Wiring (ICS-43434 / INMP441 → Heltec V3 / V4)
 
-| ICS-43434 | GPIO | Function |
+| Mic pin | GPIO | Function |
 |:---|:---|:---|
 | VDD | 3.3V | Power |
 | GND | GND | Ground |
@@ -18,6 +18,13 @@
 | SD | 6 | I2S data input (DIN) |
 | L/R | GND | Left channel select |
 
+!!! note "ICS-43434 vs INMP441"
+    Both mics share the same pinout and I2S protocol, so they're drop-in
+    interchangeable on this wiring. ICS-43434 is preferred for drone detection
+    (higher sensitivity at −38 dBFS, 130 dB SPL AOP); INMP441 is cheaper and
+    easier to source, but has lower sensitivity (−26 dBFS) and a 120 dB SPL
+    AOP, which can clip on close, loud sources.
+
 ### Battery monitoring (optional)
 
 Heltec V3 / V4 ship with an on-board LiPo jack, charger, and a resistor divider that taps VBAT onto **GPIO1 (ADC1_CH0)**, gated by **GPIO37 (ADC_Ctrl, active low)**. The firmware drives the gate low only during a ~2 ms measurement window on every LoRa TX, so the divider's ~100 µA current drain is effectively eliminated between reads.
@@ -29,11 +36,11 @@ No extra wiring is required — plug a 1S LiPo into the JST connector and the de
 | Component | Notes |
 |:---|:---|
 | LILYGO T-ETH-Lite S3 | ESP32-S3 + W5500 Ethernet on-board, optional PoE expansion |
-| ICS-43434 I2S MEMS microphone | 3.3 V, L/R → GND (left channel) |
+| ICS-43434 **or** INMP441 I2S MEMS microphone | 3.3 V, L/R → GND (left channel) |
 
-### Wiring (ICS-43434 → T-ETH-Lite S3)
+### Wiring (ICS-43434 / INMP441 → T-ETH-Lite S3)
 
-| ICS-43434 | GPIO | Function |
+| Mic pin | GPIO | Function |
 |:---|:---|:---|
 | VDD | 3.3V | Power |
 | GND | GND | Ground |
@@ -42,6 +49,9 @@ No extra wiring is required — plug a 1S LiPo into the JST connector and the de
 | SD | 40 | I2S data input (DIN) |
 | L/R | GND | Left channel select |
 
+See the [ICS-43434 vs INMP441 note above](#detector) for sensitivity / AOP
+differences when choosing between the two mics.
+
 !!! tip
     GPIO 38/39/40 are on the extension headers of the T-ETH-Lite S3. These pins avoid conflicts with the on-board W5500 Ethernet (GPIO 9–14) and SD card (GPIO 5–7, 42).