https://github.com/klumw/gqmqtt

GQ GMC-500+ USB serial to MQTT bridge
https://github.com/klumw/gqmqtt

geiger-counter geiger-muller geiger-muller-device home-automation openhab openhab3 raspberry-pi

Last synced: 4 days ago
JSON representation

GQ GMC-500+ USB serial to MQTT bridge

• Host: GitHub
• URL: https://github.com/klumw/gqmqtt
• Owner: klumw
• License: apache-2.0
• Created: 2022-11-08T07:14:53.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-04-14T11:38:49.000Z (over 1 year ago)
• Last Synced: 2023-10-13T11:58:36.649Z (about 1 year ago)
• Topics: geiger-counter, geiger-muller, geiger-muller-device, home-automation, openhab, openhab3, raspberry-pi
• Language: Go
• Homepage:
• Size: 3.73 MB
• Stars: 2
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## USB serial to MQTT bridge for GQ GMC-500+ Geiger Counter

The aim of this project is to enable easy integration of the [GQ GMC-500+](https://www.gqelectronicsllc.com/comersus/store/comersus_viewItem.asp?idProduct=5631) Geiger Counter device into home automation systems (e.g. [openHAB](https://www.openhab.org/)).  

The software reads data from the device via USB and transfers the data to a MQTT host.  

Since most home automation systems support the MQTT protocol, sensor integration should be straightforward. 

The bridge software can be compiled for Windows and Linux.

See also the installation section for [Raspberry PI](https://www.raspberrypi.org/) 3 and 4. You can also download a ready to use [executable for Raspberry PI OS](https://github.com/klumw/gqmqtt/releases).

For compiling the software the installation of the latest version of the [GO](golang.org) programming language is necessary. 

## Installation on Raspberry Pi 3 and 4

1. Get the [latest version](https://www.raspberrypi.com/software/operating-systems/) of [Pi OS](https://www.raspberrypi.com/software/).

2. Run *sudo apt update* then *sudo apt upgrade*

3. Follow the [GO installation instructions](https://shores.dev/install-go-language-on-raspberry-pi-3-and-4/)

4. Run *go build* inside the source folder.

 If everything went well you will get a **gqmqtt** executable in the src folder.

5. Make sure the Geiger Counter device is switched on and is connected to your Raspberry Pi via USB. Use only the supplied USB cable if possible.

6. In the device settings the option **Third party output** must be switched off. Baud rate should be set to the default value (115200).

7. Make sure user is member or group "dialout"

8. For a quick test start your software with the command *./gqmqtt -v*, this will start the bridge in verbose mode. Type *--help* to get an overview of all available command line flags.

9. If your mqtt broker runs on another host you will need to set up the host url with the -h flag

   (e.g. *-h tcp://192.168.178.25:1883*)

9. You can also [install the software as a service](https://domoticproject.com/creating-raspberry-pi-service/) for automatic start and restart.