ESPGeiger ESPGeiger
ESPGeiger is a free, open-source firmware allowing you to transform any compatible Geiger counter into a real-time, IoT-enabled radiation monitoring system using ESP8266 or ESP32 microcontrollers.
Features
Data Display & Analysis:
- ๐ด Real-time Readings: Live CPM and ฮผSv/h with 1, 5 and 15-minute smoothed averages.
- ๐ Web-based Graphing: Built-in web portal with live charts and 24-hour history.
- ๐ฅ๏ธ Local Display: SSD1306, SH1106 and SSD1309 OLEDs with runtime auto-detect.
- ๐ฐ๏ธ Lifetime Tracking: Persistent total clicks, lifetime ยตSv and install age, surviving reboots.
Connectivity & Data Sharing:
- ๐ Online Data Export: Radmon.org, GMCMAP, ThingSpeak, generic Webhook and GeigerLog.
- ๐ Local Network: MQTT with Home Assistant auto-discovery, and a Prometheus
/metricsendpoint. - ๐ก UDP / OSC Broadcast: Multicast clicks and telemetry over OSC to any tool on the LAN (Pure Data, TouchDesigner, Node-RED, etc).
- ๐ฐ๏ธ UDP-Receiver Mode: A tubeless ESP can mirror another ESPGeiger over the air for fleet displays or aggregation.
- ๐พ Local Data Logging: SD card export for offline analysis.
- ๐ Offline Mode: Hold the onboard button at startup to disable all network functionality.
Hardware & Compatibility:
- โ Wide Counter Compatibility: Pulse-output and serial-based Geiger counters.
- ๐ Accurate Counting: Interrupt-driven and non-blocking, with ESP32 PCNT hardware counter support.
- ๐๏ธ Noise Control: Configurable filtering and debounce.
- ๐ก Visual Feedback: WS2812X NeoPixel with rate-scaled flash and z-score trend colour.
Ease of Use & Development:
- ๐ Easy Setup: Captive-portal WiFi onboarding, friendly device naming, optional web password.
- ๐๏ธ Config Backup & Restore: Portable backup blob of every editable setting, transferable between devices.
- ๐ง Emulation Tools: Test builds for emulating pulse and serial counters.
ESPGeiger-HW
ESPGeiger is used to power ESPGeiger-HW - the fully featured IoT Geiger Counter from the creator of ESPGeiger.
ESPGeiger-HW is almost ready for release!
Disclaimer
The creators of ESPGeiger make no claims about the suitability of the firmware or hardware for measuring radiation in any serious or life threatening situation. ESPGeiger is created as an educational resource for hobbyists and makers a-like.
Safety First: Always avoid the high voltage elements on any Geiger Counter, many of which have exposed circuitry.
Please use extreme caution and safe practice when handling and storing known radioactive sources.
Stay safe!