Skip to content

raleighlittles/GQ_Geiger_Counter_Comm_Protocol

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

build-badge

Background

A company called GQ makes "smart" nuclear radiation detecting devices aka "geiger counters". These devices come with a USB port which provides a serial interface to the device, intended for data logging usage.

geiger counter photo

GQ published their "RFC" which provides the serial port interface specifications. See RFC1801.txt.

About

This project consists of helper tools for using your GQ GMC.

There's 3 main functionalities provided:

  1. A simple GUI application for controlling system parameters and device buttons:

GUI screenshot

This is particularly useful if your device is out of reach or if the physical buttons no longer work for whatever reason.

  1. A "timesync" feature, allowing you to synchronize your geiger counter with your host PC's time. This is useful since these devices don't have any kind of NTP functionality.

  2. A CSV logging feature. This logs the geiger counter's readings directly to a CSV file, and is useful when you need to take long-running measurements that would exceed the geiger counter's on-device storage.

csv example

  1. A config dump feature. 🚧 This lets you see a parsed version of the device's configuration memory and take backups of it.

Usage

Run the binary providing the first and second arguments as the serial device name and baud rate, and then thirdly, the option you wish to use, e.g.:

$ ./gq_gmc /dev/ttyUSB0 115200 --gui

to launch the GUI

$ ./gq_gmc /dev/ttyUSB0 115200 --timesync

to do the time synchronization

$ ./gq_gmc /dev/ttyUSB0 115200 --log <CSV_FILENAME>

to store records to CSV file.

About

[WIP] A Rust implementation of the GQ Geiger Communication Protocol

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages