ESPGeiger

ESPGeiger is an open-source project that makes it easy to monitor radiation levels in your environment. It can collect, calculate, and report radiation levels from a range of Geiger counters with pulse and serial outputs. ESPGeiger supports the GC10/GC10next and MightyOhm counters, with additional support possible. The firmware is written to be installed onto the common esp8266 and esp32 boards.

• 😃 Easy to install and configure - contribute to monitoring!
• ✅ Compatible with all generic Geiger counters with Pulse output and a range of serial based - GC10, GC10next, MightyOhm
• 📈 Built in webserver with graphing
• 🖥️ SD1306 Display support
• 🔴 Live CPM and μSv/h readings
• 🔢 Smoothed and averaged values over 1, 5 and 15 minutes
• 🎛️ Configurable filtering/debounce and noise control
• 📟 Accurate counting via interrupt and non-blocking functions (accuracy tested up to 100k CPM), with optional hardware counter (ESP32 only - PCNT)
• ⏲️ No dead time due to waiting for 3rd party services
• 🌐 Upload and share statistics to services online and locally via MQTT and Home Assistant automatic discovery
• 🚧 Test builds for emulating pulse and serial based counters

Outputs

• MQTT
• Home Assistant (Autodiscovery)
• ThingSpeak
• Radmon.org
• gmcmap.com

MQTT Output

Automatically output every minute:

ESPGeiger-129e0c/tele/lwt Online
ESPGeiger-129e0c/tele/status {"uptime":"2T01:45:10","board":"ESP32","model":"GC10next","free_mem":191552,"ssid":"Wifi","ip":"192.168.1.123","rssi":-24}
ESPGeiger-129e0c/stat/CPM 26.00
ESPGeiger-129e0c/stat/uSv 0.10
ESPGeiger-129e0c/stat/CPM5 25.00
ESPGeiger-129e0c/stat/CPM15 25.00
...
ESPGeiger-129e0c/tele/lwt Offline

Home Assistant MQTT Autodiscovery

https://www.home-assistant.io/integrations/mqtt/#mqtt-discovery

Planned:

• ESPGeiger API
• Async Webserver/MQTT
• Configurable alarms

Installation

Web Installer

On your Chrome or Edge browser, visit our web installer here: https://install.espgeiger.com/

Pre-built image

Select an image - the images are in the format <esp_device>_<geiger_device>

There are builds for both ESP32 and ESP8266 boards, both with builds for:

• Generic Pulse Counters (pulse)
• GC10 (gc10)
• GC10next (gc10next)
• MightyOhm (mightyohm)

For example, if you have an esp8266 and a generic pulse counter, use esp8266_pulse-firmware.bin - an ESP32 with a GC10 - esp32_gc10-firmware.bin

Use a tool such as esptool.py to flash the firmware to your ESP device.

Building your own image

The project should build automatically with Platformio - it can be built with the Arduino IDE but will require you to satify the requirements by installing the libraries.

The environments.ini file defines some pre-built environments and examples of how the build can be configured. You can pick a combination of target board (esp32/esp8266) and geiger type (pulse/serial/GC10 etc)

1. Open the PlatformIO IDE and open the ESPGeiger project.
2. Edit the platformio.ini file to change default_envs to match the environment you want to build.
3. Click on the Build button in the PlatformIO IDE.
4. The PlatformIO IDE will build the project.
5. Once the project is built, you can upload it to your microcontroller.
6. To upload the project to your microcontroller, click on the Upload button in the PlatformIO IDE.
7. The PlatformIO IDE will upload the project to your microcontroller.

Hardware

Pulse counter

By default GEIGER_RXPIN is set to GPIO13. This is the pin you need to connect the Geiger pulse output to. Don't forget to connect ground as well!

Serial counter

By default GEIGER_RXPIN is set to GPIO13. This is the pin on the ESP you need to connect the Geiger counter serial TX pin to. Don't forget to have a common ground, as well!

The GEIGER_TXPIN is not currently in use for communication to the Geiger Counter.

ESPGeiger-HW

Currently ESPGeiger-HW is in development testing, watch this space!

Test/Emulation mode counter

Note: Publishing to public sites is disabled whilst ESPGeiger is in test mode.

By default GEIGER_RXPIN is set to GPIO13. By default GEIGER_TXPIN is set to GPIO12.

In either Test Pulse or Test Serial modes you can connect PIN 12 and 13 together with a jumper wire, to emulate a Geiger counter from ESPGeiger itself.

Setup and Config

1. Once installed, connect to the built-in Wifi on the ESP to set up your access point. The SSID will look like ESPGeiger-<alpha-num>
2. When you connect a window show pop up asking for Wifi Configuration, if not browse to http://192.168.4.1/
3. Select the SSID and insert the password for the network you'd like to connect to.
4. Once connected to the network you can browse to the ESPGeiger IP address directly or enter http://<name of the device>.local into your browser, for example http://ESPGeiger-83e6a4.local

Counters

Annoucing ESPGeiger-HW

The project is compatible with Generic Pulse-based geiger counters and the GC10next serial based counters.

• DIY GeigerKit
• NetIO GC10
• RHElectronics
• GeigerHV
• GGreg20
• MightyOhm Kit
• DiY-GDC
• CAJOE (and other clones) RadiationD-v1.1

Serial Compatibility

Currently the serial integration is untested against some units until I can gain access to a device.

Other Serial based should in theory be supportable with small changes to the codebase.

If you own or can offer a device below for testing and support, please get in touch!

• GC10
• MightyOhm
• GMC-320
• GGreg20

Contributions

Contributions are welcomed, please feel free to raise a Pull Request for this. I am a new Arduino/C coder, so please feel free to suggest improvements to the code here to make it better for everyone!

Thanks 🙏

Thanks for supporting libraries goes to:

• https://github.com/tzapu/WiFiManager
• https://github.com/khoih-prog/AsyncHTTPRequest_Generic
• https://github.com/gmag11/ESPNtpClient
• https://github.com/MattFryer/Smoothed
• https://github.com/knolleary/pubsubclient/
• https://github.com/bblanchon/ArduinoJson

And inspiration:

• https://github.com/1technophile/OpenMQTTGateway
• https://github.com/G4lile0/tinyGS/
• https://github.com/kapraran/FreqCountESP