summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorThomas Schmucker <ts@its1.de>2026-07-25 15:22:10 +0200
committerThomas Schmucker <ts@its1.de>2026-07-25 15:22:10 +0200
commit85929231fae3ae797f3a34f6b5d928d2341fc1e1 (patch)
tree6da38f31e5e023c3caa4f4b9b5c7b417f7248df4 /docs
downloadgmc-300e-monitor-85929231fae3ae797f3a34f6b5d928d2341fc1e1.tar.gz
gmc-300e-monitor-85929231fae3ae797f3a34f6b5d928d2341fc1e1.tar.bz2
gmc-300e-monitor-85929231fae3ae797f3a34f6b5d928d2341fc1e1.zip
erster import
Diffstat (limited to 'docs')
-rw-r--r--docs/GQ-RFC1201.txt351
1 files changed, 351 insertions, 0 deletions
diff --git a/docs/GQ-RFC1201.txt b/docs/GQ-RFC1201.txt
new file mode 100644
index 0000000..6f096c1
--- /dev/null
+++ b/docs/GQ-RFC1201.txt
@@ -0,0 +1,351 @@
1***************************************************
2GQ-RFC1201
3
4GQ Geiger Counter Communication Protocol
5***************************************************
6Ver 1.40 Jan-2015
7
8
9Status of this Memo
10
11 This document specifies a GQ GMC Geiger Counter Communication Protocol for the
12 communication between GQ GMC Geiger Counter and a computer host via serial port, and requests discussion and suggestions for
13 improvements. Distribution of this memo is unlimited.
14
15Copyright Notice
16
17 Copyright (C) GQ Electronics LLC (2012). All Rights Reserved.
18
19Abstract
20
21 This document defines a GQ GMC Geiger Counter Communication Protocol
22 to support communication between GMC Geiger Counter and a computer host via serial port. The protocol allows to send data request command from a computer host to a GQ GMC geiger counter.
23
24
25**************************
26Serial Port configuration
27**************************
28
29For the GMC-300 V3.xx and earlier version, the serial port communication is based on a fixed baud rate.
30
31Baud: 57600
32Data bit: 8
33Parity: None
34Stop bit: 1
35Control: None
36
37For the GMC-300 Plus V4.xx and later version firmware, 115200 BPS is used.
38
39For GMC-320, the serial port communication baud rate is variable. It should be one of the followings:
40
411200,2400,4800,9600,14400,19200,28800,38400,57600,115200 BPS. The factory default is 115200 BPS.
42
43
44**************************
45Command format
46**************************
47
48A valid command start with ASCII '<' and ended with ASCII '>>'. Both command and parameters are in between '<' and '>>'.
49
50Command is a ASCII string. All parameters of command are true value in hexadecimal.
51
52
53Direction: All commands are initiated from computer(HOST).
54
55
56**************************
57Commands
58**************************
59
601. Get hardware model and version
61
62Command: <GETVER>>
63
64
65Return: total 14 bytes ASCII chars from GQ GMC unit. It includes 7 bytes hardware model and 7 bytes firmware version.
66
67 e.g.: GMC-300Re 2.10
68
69Firmware supported: GMC-280, GMC-300 Re.2.0x, Re.2.10 or later
70
71
722. Get current CPM value
73
74
75Command: <GETCPM>>
76
77Return: A 16 bit unsigned integer is returned. In total 2 bytes data return from GQ GMC unit. The first byte is MSB byte data and second byte is LSB byte data.
78
79 e.g.: 00 1C the returned CPM is 28.
80
81Firmware supported: GMC-280, GMC-300 Re.2.0x, Re.2.10 or later
82
83
84
853. Turn on the GQ GMC heartbeat
86
87Note: This command enable the GQ GMC unit to send count per second data to host every second automatically.
88
89Command: <HEARTBEAT1>>
90
91Return: A 16 bit unsigned integer is returned every second automatically. Each data package consist of 2 bytes data from GQ GMC unit. The first byte is MSB byte data and second byte is LSB byte data.
92
93
94 e.g.: 10 1C the returned 1 second count is 28. Only lowest 14 bits are used for the valid data bit. The highest bit 15 and bit 14 are reserved data bits.
95
96
97
98Firmware supported: GMC-280, GMC-300 Re.2.10 or later
99
100
1014. Turn off the GQ GMC heartbeat
102
103
104Command: <HEARTBEAT0>>
105
106Return: None
107
108Firmware supported: Re.2.10 or later
109
110
1115. Get battery voltage status
112
113
114Command: <GETVOLT>>
115
116Return: one byte voltage value of battery (X 10V)
117
118 e.g.: return 62(hex) is 9.8V
119
120Firmware supported: GMC-280, GMC-300 Re.2.0x, Re.2.10 or later
121
122
1236. Request history data from internal flash memory
124
125Command: <SPIR[A2][A1][A0][L1][L0]>>
126
127 A2,A1,A0 are three bytes address data, from MSB to LSB. The L1,L0 are the data length requested. L1 is high byte of 16 bit integer and L0 is low byte.
128
129 The length normally not exceed 4096 bytes in each request.
130
131Return: The history data in raw byte array.
132
133Comment: The minimum address is 0, and maximum address value is the size of the flash memory of the GQ GMC Geiger count. Check the user manual for particular model flash size.
134
135Firmware supported: GMC-300 Re.2.0x, Re.2.10 or later
136
137
1387. Get configuration data
139
140Command: <GETCFG>>
141
142Return: The configuration data. Total 256 bytes will be returned.
143
144
145Firmware supported: GMC-280, GMC-300 Re.2.10 or later
146
147
148
1498. Erase all configuration data
150
151Command: <ECFG>>
152
153Return: 0xAA
154
155Firmware supported: GMC-280, GMC-300 Re.2.10 or later
156
157
1589. Write configuration data
159
160Command: <WCFG[A0][D0]>>
161
162 A0 is the address and the D0 is the data byte(hex).
163
164Return: 0xAA
165
166Firmware supported: GMC-280, GMC-300 Re.2.10 or later
167
168
169
17010. send a key
171
172Command: <key[D0]>>
173
174 D0 is the key value from 0 to 3. It represents software key S1~S4.
175Return: none
176
177Firmware supported: GMC-280, GMC-300 Re.2.0x, Re.2.10 or later
178
179Note: for Re.2.11 or later, each key can be a ASCII string: <KEY0>>,<KEY1>>,<KEY2>>,<KEY3>>
180
181
182
18311. get serial number
184
185Command: <GETSERIAL>>
186
187Return: serial number in 7 bytes.
188
189Firmware supported: GMC-280, GMC-300 Re.2.11 or later
190
191
192
19312. Power OFF
194
195Command: <POWEROFF>>
196
197Return: none
198
199Firmware supported: GMC-280, GMC-300 Re.2.11 or later
200
201
20213. Reload/Update/Refresh Configuration
203
204
205Command: <CFGUPDATE>>
206
207Return: 0xAA
208
209Firmware supported: GMC-280, GMC-300 Re.2.20 or later
210
211
21214. Set realtime clock year
213
214command: <SETDATEYY[D0]>>
215
216 D0 is the year value in hexdecimal
217
218Return: 0xAA
219
220Firmware supported: GMC-280, GMC-300 Re.2.23 or later
221
222
22315. Set realtime clock month
224
225command: <SETDATEMM[D0]>>
226
227 D0 is the month value in hexdecimal
228
229Return: 0xAA
230
231Firmware supported: GMC-280, GMC-300 Re.2.23 or later
232
233
23416. Set realtime clock day
235
236command: <SETDATEDD[D0]>>
237
238 D0 is the day of the month value in hexdecimal
239
240Return: 0xAA
241
242Firmware supported: GMC-280, GMC-300 Re.2.23 or later
243
24417. Set realtime clock hour
245
246command: <SETTIMEHH[D0]>>
247
248 D0 is the hourvalue in hexdecimal
249
250Return: 0xAA
251
252Firmware supported: GMC-280, GMC-300 Re.2.23 or later
253
25418. Set realtime clock minute
255
256command: <SETTIMEMM[D0]>>
257
258 D0 is the minute value in hexdecimal
259
260Return: 0xAA
261
262Firmware supported: GMC-280, GMC-300 Re.2.23 or later
263
264
265
26619. Set realtime clock second
267
268command: <SETTIMESS[D0]>>
269
270 D0 is the second value in hexdecimal
271
272Return: 0xAA
273
274Firmware supported: GMC-280, GMC-300 Re.2.23 or later
275
276
27720. Reset unit to factory default
278
279command: <FACTORYRESET>>
280
281
282Return: 0xAA
283
284Firmware supported: GMC-280, GMC-300 Re.3.00 or later
285
286
28721. Reboot unit
288
289command: <REBOOT>>
290
291
292Return: None
293
294Firmware supported: GMC-280, GMC-300 Re.3.00 or later
295
296
29722. Set year date and time
298
299command: <SETDATETIME[YYMMDDHHMMSS]>>
300
301
302Return: 0xAA
303
304Firmware supported: GMC-280, GMC-300 Re.3.00 or later
305
306
307
30823. Get year date and time
309
310command: <GETDATETIME>>
311
312
313Return: Seven bytes data: YY MM DD HH MM SS 0xAA
314
315Firmware supported: GMC-280, GMC-300 Re.3.00 or later
316
317
318
31924. Get temperature
320
321command: <GETTEMP>>
322
323Return: Four bytes celsius degree data in hexdecimal: BYTE1,BYTE2,BYTE3,BYTE4
324 Here: BYTE1 is the integer part of the temperature.
325 BYTE2 is the decimal part of the temperature.
326 BYTE3 is the negative signe if it is not 0. If this byte is 0, the then current temperture is greater than 0, otherwise the temperature is below 0.
327` BYTE4 always 0xAA
328
329Firmware supported: GMC-320 Re.3.01 or later
330
331
33225. Get gyroscope data
333
334command: <GETGYRO>>
335
336Return: Seven bytes gyroscope data in hexdecimal: BYTE1,BYTE2,BYTE3,BYTE4,BYTE5,BYTE6,BYTE7
337 Here: BYTE1,BYTE2 are the X position data in 16 bits value. The first byte is MSB byte data and second byte is LSB byte data.
338 BYTE3,BYTE4 are the Y position data in 16 bits value. The first byte is MSB byte data and second byte is LSB byte data.
339 BYTE5,BYTE6 are the Z position data in 16 bits value. The first byte is MSB byte data and second byte is LSB byte data.
340 BYTE7 always 0xAA
341
342Firmware supported: GMC-320 Re.3.01 or later
343
344
34526. Power ON
346
347Command: <POWERON>>
348
349Return: none
350
351Firmware supported: GMC-280, GMC-300, GMC-320 Re.3.10 or later