QH302R Error with GT06 Location Data

Hi All,

I am having an issue with my QH302R on pulling in the location data. The problem seems to be the device is sending the Terminal ID in the Location Data Packet and causing a decode error. Is there anyway around this or is a different protocol required?

2026-02-12 21:46:49  INFO: [Td13ba1b6] connected
2026-02-12 21:46:51  INFO: [Td13ba1b6: gt06 < 202.88.79.251] 78780d0108667030665022970074510c0d0a
2026-02-12 21:46:51  INFO: [Td13ba1b6: gt06 > 202.88.79.251] 787805010074fdf60d0a
2026-02-12 21:46:51  INFO: Event id: 866703066502297, time: 2026-02-12 21:46:51, type: deviceOnline, notifications: 0
2026-02-12 21:46:53  INFO: [Td13ba1b6: gt06 < 202.88.79.251] 78781213086670306650229781060400010075bb9e0d0a
2026-02-12 21:46:53  INFO: [Td13ba1b6: gt06 > 202.88.79.251] 787805130075dc520d0a
2026-02-12 21:46:54  INFO: [Td13ba1b6: gt06 < 202.88.79.251] 7878271208667030665022971a020c0a2334c60172919a0f8914703314ec01366e00010001200076a01d0d0a
2026-02-12 21:46:54  WARN: [Td13ba1b6] error - Latitude out of range - IllegalArgumentException (Position:240 < Gt06ProtocolDecoder:327 < *:282 < *:822 < *:1591 < ExtendedObjectDecoder:73 < ... < WrapperContext:102 < ...)
2026-02-12 21:46:54  INFO: [Td13ba1b6] disconnected

Decoding the information from the protocol datasheet looks correct except that the device is sending the Terminal ID in the Location Data Packet. https://www.traccar.org/protocol/5023-gt06/GT06_GPS_Tracker_Communication_Protocol_v1.8.1.pdf

For example, Login data looks good:
78780d010866703066502297003faddb0d0a

Location Data however is like this:
7878271208667030665022971a020c0a1e32c601727c1c0f89af002c14fa01366e000100010c003c1fdd0d0a

7878 - Start Bit
27 - Packet Length
12 - Location Data
0866703066502297 - Terminal ID
1a - Year
02 - Month
0c - Day
0a - Hour
1e - Minute
32 - Second
c6 - Quantity of GPS information satellites
01727c1c = 24280092 = 13º29.3364
0f89af00 = 260681472 = 144º49.3824
2c - Speed
14fa - Course,Status
0136 - MCC
6e - MNC
0001 - LAC
00010c - Cell ID
003c - Serial Number
1fdd - Error Check
0d0a - Stop Bit

Where do you see the terminal ID in the doc? Or are you saying the documentation is incorrect?

We can do something like this:

https://github.com/traccar/traccar/commit/2e5ef5cf1746c3bbefe361926c52bf825f1f5309

No the documentation is fine, I was using it to decode the data to understand what the error I was seeing in the debug logs. It's just this particular model on how it is sending the GPS data. That would work on setting a model and having it filter from there, thank you.

The documentation doesn't match your sample, so it's not fine.

You are absolutely correct that the document I referenced does not match the provided sample. This is my first time using a GPS device like this and Traccar. I do not have the manufacture protocol documentation for this unit and was trying my best to understand why it was not working with Traccar. I saw that it was using GT06 based on the Traccar identify-protocol and read through some of the GT06 documents. I was trying to do some due diligence to understand the protocol data and what the possible error was before asking here.

I will try reaching out to the manufacture, Qianfeng (based on searching) for the protocol documentation for their model QH302R 4G.