Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/andkom/zxcounter

Just another Arduino-based software for DIYGeigerCounter
https://github.com/andkom/zxcounter

arduino arduino-sketch geiger-counter radiation-counter radiation-level

Last synced: about 6 hours ago
JSON representation

Just another Arduino-based software for DIYGeigerCounter

Awesome Lists containing this project

README 

        
ZX Counter

==========



**ZX Counter** is an alternative software for the [Arduino](http://en.wikipedia.org/wiki/Arduino)-based [Geiger counter](http://en.wikipedia.org/wiki/Geiger_counter) [DIYGeigerCounter](https://sites.google.com/site/diygeigercounter/). The software uses the same pin layout as the [default sketch](https://sites.google.com/site/diygeigercounter/software), so it can be used without changing the hardware.



Features

--------



 * Displays the average [CPM](http://en.wikipedia.org/wiki/Counts_per_minute) and the [equivalent radiation dose](http://en.wikipedia.org/wiki/Equivalent_dose) each second

 * Automatic and manual [averaging interval](http://en.wikipedia.org/wiki/Moving_average)

 * The automatic averaging interval depends on the current radiation level

 * Two custom averaging intervals can be set to: 1s, 5s, 10s, 30s, 1m, 5m and 10m

 * Analog bar emulation

 * Displays the total measuring time

 * Displays the total CPM and the accumulated equivalent radiation dose within the measuring time

 * Displays the maximal CPM and the maximal equivalent radiation dose reached within the measuring time

 * CPM, equivalent radiation dose, total measuring time auto-ranging

 * The equivalent radiation dose unit, the CPM to [uSv/h](http://en.wikipedia.org/wiki/Sievert) ratio, the alarm threshold and the bar scale can be changed in settings

 * Settings stored in EEPROM

 * Debug info: the current CPU voltage and the available memory can be shown at startup

 * The current CPM, uSv/h, Vcc logging to serial each minute

 * Low battery check



Display Modes

-------------



The display mode can be switched forward by pressing the **MODE** button or backwards by pressing the **ALT** button:



Auto (default) -> Custom period 1 -> Custom period 2 -> ALL -> MAX -> DOSE



The following display modes are currently available:



**Auto (default)** - The automatic averaging interval. It is based on the current radiation level. Displays the average CPM, the equivalent radiation dose and the analog bar.



**Custom period 1** - The custom averaging interval. It can be set to: 1s, 5s, 10s, 30s, 1m, 5m, 10m in the settings mode. Displays the average CPM, the equivalent radiation dose, the total measuring time, the current averaging interval.



**Custom period 2** - See **Custom period 1**.



**ALL** - The averaging interval equals the total measuring time. Displays the average CPM, the equivalent radiation dose and the total measuring time.



**MAX** - Displays the maximal CPM, the maximal equivalent radiation dose reached within measuring time and the total measuring time.



**DOSE** - Displays the total CPM, the accumulated equivalent radiation dose and the total measuring time.



Auto averaging

--------------



In the auto mode the software uses the automatic averaging algorithm that depends on the average CPM within the last 5 seconds: 

 * 1m if CPM < 60

 * 30s if CPM >= 60 and < 300

 * 10s if CPM >= 300 and < 1500

 * 5s if CPM >= 1500 and CPM < 7500

 * 1s if CPM >= 7500



The current equivalent radiation dose value is blinking while the total measuring time is less than the current averaging interval.



Settings

--------



The following settings can be changed during startup:

 * The equivalent radiation dose unit: [Sieverts](http://en.wikipedia.org/wiki/Sievert) "Sv" or [Roentgens](http://en.wikipedia.org/wiki/Roentgen) "R"

 * The alarm threshold: Off, from 0.1 to 100 uSv/h

 * The bar scale: from 0.5 to 100 uSv/h

 * The [CPM to uSv/h conversion ratio](http://gmcounter.org.ua/calc/): from 1 to 2000, defaults to 175 for the [SBM-20](https://sites.google.com/site/diygeigercounter/gm-tubes-supported) [tube](http://en.wikipedia.org/wiki/Geiger-M%C3%BCller_tube)

 * Custom period 1 and Custom period 2: custom averaging intervals

 * Reset settings to defaults option



Use the **MODE** button to increase the value and the **ALT** button to decrease.



Debug info

----------



If the **MODE** button or the **ALT** button was pressed while the startup banner is shown, the current CPU voltage and the available memory will be shown at the display.



Pin configuration

-----------------



 * PIN 9 - not used (the tube switch in the default sketch)

 * PIN 10 - MODE button

 * PIN 11 - ALT button (optional)

 * PIN 15 - outputs HIGH (5v) when the alarm threshold is reached



Note: currently, the **ALT** button is optional. All features will be still available without the **ALT** button connected.



Change Log

----------



**1.7**

 * print bar fixed



**1.6**

 * fast response analog bar



**1.5**

 * settings fixes



**1.4**

 * decreased number of display modes: removed 1s, 5s, 10s, 30s, 1m, 5m, 10m stats display modes

 * added two new display modes: custom period 1 and custom period 2

 * custom period 1 and custom period 2 intervals can be set to: 1s, 5s, 10s, 30s, 1m, 5m, 10m in the settings mode

 * added bar scale setting

 * added logging to serial

 * reset settings to defaults option

 * improvements and bug fix



**1.31**

 * debug info fixed



**1.3**

 * unit setting

 * ratio setting

 * settings mode

 * better button push feedback

 * low battery check

 * analog bar symbols changed

 * bug fix and improvements



**1.2**

 * debug info

 * ALT button support

 * alarm threshold setting

 * bug fix and improvements



**1.1**

The initial version with basic features



**1.0**

Test version