GK-B5 Software

This page provides links to downloading the software for the GK-B5 kit. and also describes uploading new software.

DIY Geiger invests a lot time and resources, not only in providing this open source code, but in its documentation. Please support it by considering the original DIY Geiger Kit on this site, rather than knock-off versions that link to this page.

Changing the Software

If you're familiar with Arduino then you probably know all of this.

The program ("sketch") that is pre-loaded on the Geiger kit's microprocessor has evolved to provide good functionality for most users. However, you may want to load the latest software on your kit, or even enhance or modify the default sketch.

The software is based on the Arduino. This is a development environment for microprocessors. The Arduino environment makes it easy to program the Atmega328 microprocessor that is on the Geiger board. It includes an "IDE" that lets you write, compile and upload your code to the chip from your computer. Best of all, the whole thing is free, open source. You will find tons of information on this, but you should start here.

I have made step by step instructions on installing the Arduino IDE and uploading new software on the GK-B5 kit. You can get it here.

USB to Serial Adapter (aka FTDI adapter):

The connection between your computer and the Geiger kit is made through a USB to serial adapter (dongle). These are sometimes referred to as an "FTDI breakout, board, or cable". One end plugs into USB on your computer and the other end plugs into the FTDI connector on the kit. On the computer side it makes a virtual serial port, and on the kit side it is TTL level serial (not RS232 level serial). Drivers must be loaded for your OS. On Windows they are generally installed automatically.

These adapters allow you to do two things:

  • You can connect the kit to a PC and get real-time readings into the PC for logging, graphing, etc.
  • You can use the Arduino IDE to upload your program just like any other Arduino board.

There are a lot places to get these. Sparkfun and Adafruit make popular FTDI boards. There are also many on eBay but you should be cautioned that many of the low priced boards that use the FTDI chip have a counterfeit chip. These may work on older Windows OS's but may not on newer machines. (A genuine FTDI chip costs ~$4 in quantity so it's unlikely the $3 FTDI breakouts on eBay are genuine.)

There are other low priced Serial Adaptors on eBay that use a CP2102 chip instead of an FTDI chip. These will work, but may have a different pinout so they won't plug into the kit directly. You will have to adapt the pin out.

Bottom line is that it's best to buy a USB to Serial Adaptor from a local supplier with a genuine FTDI chip or one from eBay with a CP2102 (or similar) chip. Searching eBay for genuine FTDI adaptors or writing the seller is also an option. If you are in doubt you can write me.

Note: When you use a USB to serial device it will usually supply 5V to the kit. It's not a good idea to also power the kit with batteries at the same time. However, I've done this often with no harm.

Download the latest GK-B5 Software

The kit comes preloaded with the latest version of software. However you can use this section to upgrade your software to the most current version.

General Info:

  • The Geiger kit sketches below are supplied for Arduino IDE version 1.6.x and above.
  • The "optiboot" bootloader is installed on the ATmega328. Therefore the Tools / Board setting in the Arduino IDE should be "Arduino Uno".
  • The header and comments in the sketch will tell you more about the features of the program.
  • See the Archive page details on previous releases.
  • A User Guide provides a general description of the features in the current release - see the GK-B5 Downloads page.

Current Version:

Geiger Kit Version 12.0

This version compiles with newer versions of the Arduino IDE. (i.e. v1.8.x)

New in this version:

  • No longer need to set a #define to use an external tone pot.
  • No tone while in menu.
  • Enter while out of menu sets the null point for tone.
  • An asterisk shows on line 2 when muted.
  • Re-evaluated global dose averages used when setting beginning null point in Tone Mode.
  • Only the included NEC IR remote is now supported.

Geiger Kit Library package (supplies all the libraries you need for the Geiger Kit sketch)

Last Previous Version:

Previous versions of the Geiger kit software may be found on the Archive Page.

Geiger Kit Customers: If you want to upgrade to the v12.0 software and above, and you'd like to use the mini-remote supported by this version, you can get the remote here. If you are in the US you can also get one through me. Just write for information.

Disclaimer

This is about as far as I'd like to go regarding the subject of software. My sense is, that for some, the Geiger board may be an introduction into the whole world of microprocessors. I am truly happy about this, but if you need answers to questions about programming, adding new devices (WiFi, SD cards, etc.), and the like, your best bet is to use the Arduino forum.

Finally my apologies to the AVR Freaks out there, many of whom are sick about hearing about Arduino. (Although you're too smart to be reading this far anyway!) Just to say there are other ways to work with the Atmega328 on the Geiger board besides Arduino.

Here's a really old video that shows communication between the Geiger board and the computer . . .