Kurikintons Firmware¶
kurikintons is a firmware for OSECHI, an ESP32-based cosmic ray detector. It detects cosmic ray muons across three independent scintillator channels and outputs real-time data for analysis.
Quick Start¶
git clone https://gitlab.com/osechi/kurikintons.git
cd kurikintons
task env:setup
task v2:build
task v2:upload
task monitor # Serial output at 115200 baud
Press S for status, U for uptime.
See Getting Started for detailed setup instructions.
Documentation¶
| Guide | For | Description |
|---|---|---|
| Getting Started | All users | Setup, installation, and first build |
| Hardware Guide | All users | Components, pin layout, and measurement flow |
| Software Guide | All users | PlatformIO build, serial communication |
| Commands Reference | All users | All available text commands |
| Developer Guide | Developers | Build flags, code quality tools |
| API Reference | Developers | V2 protocol and data format reference |
What Can You Do?¶
Detect Cosmic Rays¶
- 3-channel detection with adjustable sensitivity
- Temperature, pressure, humidity monitoring
- Precise timestamps for data synchronization
Configure & Monitor¶
- Text commands for easy configuration
- WiFi AP mode (
ENABLE_WIFI=1) - 10+ adjustable parameters
Export Data¶
- JSON format for easy data analysis
- Timestamp every detection for multi-device sync
- Reliable buffering prevents data loss