











{"author":"Faiq Najib Al-Aziz","body":"\nDi [Part 2](/writing/2026/tcp-listener-gps-go/) kita sudah punya listener yang merapikan _stream_ TCP menjadi frame utuh. Nah, sekarang saatnya baca isinya. Byte `0x78 0x78 0x0D 0x01 ...` perlu diterjemahkan jadi informasi seperti `IMEI 123456789012345, posisi -7.2575, 112.7521, arah 180°`.\n\nWaktu menulis artikel ini, saya sempat yakin contoh packet login dari datasheet GT06 adalah `... 6C 00 01 8C ...` dan CRC-nya cukup pakai CRC-CCITT standar. **Dua-duanya salah**, hahaha. Saya baru sadar setelah kode saya sendiri menolak contoh dari datasheet. Pelajarannya: untuk protokol binary, lebih baik uji pakai vektor daripada percaya ingatan sendiri.\n\nKita bedah GT06 dulu, lalu lihat Teltonika dan bedanya di mana. Semua kode di bawah sudah diuji terhadap contoh resmi datasheet Concox GT06 v1.8.1 dan struktur decoder [Traccar](https://www.traccar.org/)[^traccar] yang sudah dipakai di production bertahun-tahun.\n\n## Jebakan #1: \"CRC-ITU\" GT06 Bukan CRC-CCITT yang Kamu Kirim\n\nDatasheet GT06 cuma bilang: field CRC berisi _CRC-ITU value_. Referensi paling umum soal CRC-ITU adalah CRC-16/CCITT dengan polynomial 0x1021. Nah, di sinilah jebakannya: ada belasan varian CRC dengan polynomial yang sama, dan bedanya ada di nilai awal (_init_), arah pemrosesan (_reflected_), dan XOR akhir.\n\nSaya brute-force semua varian 0x1021 yang umum terhadap contoh resmi datasheet. Packet login `78 78 0D 01 01 23 45 67 89 01 23 45 00 01 8C DD 0D 0A` punya CRC `0x8CDD`:\n\n| Varian (poly 0x1021) | Init   | Reflected | XOR out    | Hasil           |\n| -------------------- | ------ | --------- | ---------- | --------------- |\n| CCITT-FALSE          | 0xFFFF | tidak     | 0x0000     | `0x81F6` ❌     |\n| XMODEM               | 0x0000 | tidak     | 0x0000     | `0x55F9` ❌     |\n| X25                  | 0xFFFF | **ya**    | **0xFFFF** | **`0x8CDD` ✅** |\n\nJawabannya: **varian X25**, diproses _reflected_ dan di-XOR `0xFFFF` di akhir. CRC dihitung bukan dari protocol number, tapi **dari byte _length_ sampai _serial number_ (inklusif)**, sesuai redaksi datasheet WD-209: _\"from packet length to information serial number (including)\"_.\n\nImplementasinya di Go:\n\n```go\n// crcITU = \"CRC-ITU\" GT06: varian CRC-16/X25\n// (poly 0x1021, init 0xFFFF, reflected, xor-out 0xFFFF).\n// Scope: byte LENGTH sampai SERIAL (inklusif).\nfunc crcITU(data []byte) uint16 {\n    crc := uint16(0xFFFF)\n    for _, b := range data {\n        crc ^= uint16(b)\n        for i := 0; i \u003c 8; i++ {\n            if crc\u00261 != 0 {\n                crc = (crc \u003e\u003e 1) ^ 0x8408 // 0x1021 versi reflected\n            } else {\n                crc \u003e\u003e= 1\n            }\n        }\n    }\n    return crc ^ 0xFFFF\n}\n```\n\nDi sisi produksi, Traccar (server GPS open source yang paling banyak dipakai) ternyata **tidak memvalidasi CRC masukan untuk GT06**. Pasarnya penuh klon/OEM GT06 dengan perhitungan CRC yang sedikit beda. Di artikel ini kita tetap memvalidasi CRC dan membuang paket cacat sesuai anjuran datasheet. Konsekuensinya, perangkat klon yang CRC-nya nyeleneh bisa saja ikut ditolak.\n\n## Parser Frame dengan Validasi CRC\n\nMelengkapi `readFrame` dari Part 2, sekarang kita bongkar frame yang sudah utuh:\n\n```go\ntype GT06Frame struct {\n    Protocol byte\n    Data     []byte   // isi payload\n    Serial   uint16   // untuk pencocokan ACK\n}\n\nfunc parseGT06(frame []byte) (*GT06Frame, error) {\n    if len(frame) \u003c 9 || frame[0] != 0x78 || frame[1] != 0x78 {\n        return nil, fmt.Errorf(\"bukan frame GT06\")\n    }\n    length := int(frame[2])\n    body := frame[2 : 3+length] // length..crc, scope CRC!\n\n    got := binary.BigEndian.Uint16(body[len(body)-2:])\n    want := crcITU(body[:len(body)-2])\n    if got != want {\n        return nil, fmt.Errorf(\"CRC beda: packet=0x%04X hitung=0x%04X\", got, want)\n    }\n\n    return \u0026GT06Frame{\n        Protocol: body[1],\n        Data:     body[2 : len(body)-4],\n        Serial:   binary.BigEndian.Uint16(body[len(body)-4 : len(body)-2]),\n    }, nil\n}\n```\n\nTes pertama yang wajib lolos: contoh login datasheet tadi harus lolos validasi, dan CRC hasil hitung ulang harus sama persis dengan `0x8CDD`.\n\n## Login: IMEI BCD dan ACK yang Wajib Dibalas\n\nPacket login (protocol `0x01`) berisi **IMEI dalam format BCD**. Delapan byte menyimpan 16 digit desimal, padahal IMEI cuma 15 digit. Digit pertama adalah padding `0` dan harus dibuang:\n\n```go\n// IMEI: 8 byte BCD → 16 digit hex → buang digit pertama → 15 digit\nfunc decodeIMEI(data []byte) string {\n    return fmt.Sprintf(\"%X\", data)[1:]\n}\n```\n\nContoh datasheet: `01 23 45 67 89 01 23 45` → `\"0123456789012345\"` → IMEI `123456789012345`.\n\nSetelah IMEI dikenali, wajib dibalas. Ingat Part 1: device yang tidak di-ACK akan kirim ulang terus sampai ngambek. Format balasan login: `78 78 05 \u003cprotocol\u003e \u003cserial\u003e \u003ccrc\u003e 0D 0A`:\n\n```go\n// buildAck: 78 78 05 \u003cprotocol\u003e \u003cserial\u003e \u003ccrc\u003e 0D 0A\n// CRC dihitung dari byte length (05) sampai serial.\nfunc buildAck(f *GT06Frame) []byte {\n    body := []byte{0x05, f.Protocol, byte(f.Serial \u003e\u003e 8), byte(f.Serial)}\n    crc := crcITU(body)\n    out := []byte{0x78, 0x78}\n    out = append(out, body...)\n    out = append(out, byte(crc\u003e\u003e8), byte(crc), 0x0D, 0x0A)\n    return out\n}\n```\n\nVektor ujinya: untuk serial `0001`, balasan yang benar adalah `78 78 05 01 00 01 D9 DC 0D 0A`, dan implementasi di atas menghasilkan nilai yang sama. (`D9 DC` itu lahir dari CRC X25 dengan scope `05 01 00 01`, jadi byte length ikut dihitung.)\n\n## Location: Dari Byte Menjadi Koordinat\n\nPacket posisi yang paling umum adalah protocol `0x12`. Isi bagian GPS-nya:\n\n| Offset | Ukuran | Field          | Catatan                              |\n| ------ | ------ | -------------- | ------------------------------------ |\n| +0     | 6      | Datetime       | BCD: YY MM DD HH MM SS               |\n| +6     | 1      | Satelit        | _low nibble_ saja                    |\n| +7     | 4      | Latitude       | big-endian, satuan **menit × 30000** |\n| +11    | 4      | Longitude      | big-endian, satuan menit × 30000     |\n| +15    | 1      | Speed          | km/jam                               |\n| +16    | 2      | Course + flags | lihat bawah                          |\n\nAda dua hal yang gampang kelewat:\n\n1. **Koordinatnya bukan derajat.** Nilainya harus dibagi `60 × 30000 = 1.800.000`. Contoh: Surabaya di -7.2575° tersimpan sebagai `7.2575 × 60 × 30000 = 13.063.500` → `00 C7 55 4C`.\n2. **Tanda (selatan/barat) tidak tersimpan di angkanya:** semua nilai positif. Tandanya ada di bit _flags_ byte course.\n\nLayout _flags_ (2 byte): bit 0 sampai 9 = arah (0 sampai 359°), bit 10 = arah lintang (**1 = utara/positif, 0 = selatan**), bit 11 = arah bujur (**1 = barat/negatif**), bit 12 = fix GPS valid. (Nomor bit ini saya ikuti dari perilaku decoder Traccar yang teruji production, karena redaksi datasheet beda-beda antar versi. Tetap uji dengan device asli ya.)\n\n```go\nfunc decodeLocation(data []byte, tz *time.Location) Location {\n    t := time.Date(\n        bcd(data[0])+2000, time.Month(bcd(data[1])), bcd(data[2]),\n        bcd(data[3]), bcd(data[4]), bcd(data[5]), 0, tz)\n\n    sat := int(data[6] \u0026 0x0F)\n    lat := float64(binary.BigEndian.Uint32(data[7:11])) / 60.0 / 30000.0\n    lng := float64(binary.BigEndian.Uint32(data[11:15])) / 60.0 / 30000.0\n    speed := int(data[15])\n\n    flags := binary.BigEndian.Uint16(data[16:18])\n    course := int(flags \u0026 0x3FF)\n    if flags\u0026(1\u003c\u003c10) == 0 { // bit 10: 0 = selatan\n        lat = -lat\n    }\n    if flags\u0026(1\u003c\u003c11) != 0 { // bit 11: 1 = barat\n        lng = -lng\n    }\n    valid := flags\u0026(1\u003c\u003c12) != 0\n\n    return Location{t, sat, lat, lng, speed, course, valid}\n}\n\nfunc bcd(b byte) int { return int(b\u003e\u003e4)*10 + int(b\u00260x0F) }\n```\n\nCara mengujinya tanpa device asli: saya bangun packet 0x12 di kode uji (Surabaya, 12 satelit, 42 km/jam, arah 180°, fix valid), lalu decode lagi. Hasilnya `-7.2575, 112.7521, arah 180, fix valid`. Frame lengkapnya `78 78 17 12 26 09 12 14 30 00 0C 00 C7 55 4C 0C 18 D4 34 2A 10 B4 00 01 00 A2 0D 0A` bisa kamu replay lewat `/dev/tcp` seperti di Part 2.\n\n\u003e Catatan: setelah blok GPS, packet `0x12` asli masih berisi data seluler (LBS) untuk fallback posisi saat GPS mati, plus terminal info. Bagian itu menyusul nanti kalau sudah dibutuhkan. Untuk membangun _core tracking_, blok GPS sudah cukup.\n\n## Teltonika: Desain Paket yang Berbeda\n\nTeltonika mengurus kebutuhan yang sama dengan format paket dan alur yang lain dari GT06. Bedanya terasa di handshake, pengiriman data, koordinat, dan ACK:\n\n**1. Handshake dulu, data kemudian.** Koneksi baru diawali packet identifikasi: 2 byte panjang (`00 0F`) + IMEI 15 digit ASCII + `\\r\\n`. Server membalas satu byte: `01` (IMEI dikenal) atau `00` (tolak):\n\n```go\nfunc decodeIMEITeltonika(b []byte) (string, bool) {\n    n := int(binary.BigEndian.Uint16(b[0:2]))\n    if n != 15 || len(b) \u003c 2+n {\n        return \"\", false\n    }\n    imei := string(b[2 : 2+n])\n    for _, c := range imei {\n        if c \u003c '0' || c \u003e '9' {\n            return \"\", false\n        }\n    }\n    return imei, true // balas: 0x01 = terima, 0x00 = tolak\n}\n```\n\n**2. Batch, bukan kirim satu-satu.** Satu packet AVL berisi banyak record sekaligus. Struktur codec 8:\n\n```text\n00 00 00 00        preamble (4 byte nol)\n00 00 00 39        data length (4 byte, codec sampai num2)\n08                 codec ID (0x08 = codec8)\n01                 jumlah record\n... record AVL ...   (timestamp 8B, prioritas 1B, GPS element, IO element)\n01                 jumlah record (ulang, untuk validasi)\n00 00 0X XX        CRC-16 (4 byte, nilai 16-bit di byte rendah)\n```\n\n**3. Koordinat derajat × 10.000.000:** longitude dan latitude masing-masing 4 byte big-endian bertanda, lalu dibagi 10.000.000 untuk mendapat derajat. GPS element satu record: longitude 4B, latitude 4B, altitude 2B, angle 2B, satelit 1B, speed 2B.\n\n**4. CRC-16 IBM** (poly 0x8005, init 0, reflected; varian CRC-16/ARC), dihitung dari codec ID sampai _number of data 2_:\n\n```go\nfunc crc16IBM(data []byte) uint16 {\n    crc := uint16(0x0000)\n    for _, b := range data {\n        crc ^= uint16(b)\n        for i := 0; i \u003c 8; i++ {\n            if crc\u00261 != 0 {\n                crc = (crc \u003e\u003e 1) ^ 0xA001\n            } else {\n                crc \u003e\u003e= 1\n            }\n        }\n    }\n    return crc\n}\n```\n\nUntuk konfirmasi penerimaan, server membalas **jumlah record yang diterima** sebagai integer 4 byte. Kalau menerima 1 record, kirim `00 00 00 01`. Device akan mengirim ulang kalau jumlahnya tidak cocok, jadi tidak perlu serial number per paket.\n\n## Hasil Uji\n\nSemua kode di artikel ini lolos 13 asersi[^uji]:\n\n| Skenario                                                         | Hasil |\n| ---------------------------------------------------------------- | ----- |\n| Login datasheet GT06 (`8C DD`) lolos validasi CRC                | ✓     |\n| CRC hitung ulang = `8CDD`; ACK serial 1 = `D9 DC`                | ✓     |\n| IMEI BCD → `123456789012345` (15 digit)                          | ✓     |\n| Round-trip location 0x12: koordinat, arah, speed, satelit, waktu | ✓     |\n| Handshake Teltonika `356307042441013`                            | ✓     |\n| AVL codec8: CRC valid, koordinat \u0026 speed benar                   | ✓     |\n\n## Catatan Buat yang Mau Menguji\n\n- **Cocokkan varian dan cakupan CRC dengan vektor datasheet.** Di GT06, dua-duanya menentukan validasi lolos atau tidak.\n- **Uji IMEI dan ACK dari contoh login.** Pastikan hasil BCD dan byte balasan sesuai serial packet.\n- **Uji konversi koordinat dengan round-trip.** GT06 pakai menit×30000, Teltonika pakai derajat×10⁷.\n- **Putuskan sikap soal validasi CRC.** Traccar tidak memvalidasi CRC masukan GT06/Teltonika karena firmware klon beragam. Tentukan sendiri apakah paket yang tidak cocok ditolak atau cuma dicatat.\n\nBerikutnya adalah menyimpan posisi yang sudah didekode. Kalau 500 device mengirim posisi tiap 10 detik, jumlahnya 4,3 juta titik per hari. Tabel PostgreSQL biasa bakal kewalahan tanpa optimasi, jadi Part 4 membahas TimescaleDB.\n\n## Selanjutnya dalam Seri Ini\n\nArtikel ini bagian dari seri **Membangun GPS Backend dari Nol**.\n\n- Sebelumnya: [Part 2: Membangun TCP Listener untuk GPS Device di Go](/writing/2026/tcp-listener-gps-go/)\n- Selanjutnya: [Part 4: Menyimpan Data GPS dengan PostgreSQL + TimescaleDB](/writing/2026/gps-data-postgresql-timescaledb/)\n\nKalau hasil ujimu berbeda saat mencoba packet GT06 atau Teltonika, ngobrol saja lewat [Contact](/contact/). Mau ikut artikel berikutnya? Subscribe [RSS](/writing/index.xml).\n\nSekian. Salam.\n\n[^traccar]: Source code decoder Traccar untuk [GT06](https://github.com/traccar/traccar/blob/master/src/main/java/org/traccar/protocol/Gt06ProtocolDecoder.java) dan [Teltonika](https://github.com/traccar/traccar/blob/master/src/main/java/org/traccar/protocol/TeltonikaProtocolDecoder.java) adalah referensi perilaku yang teruji production. Saya pakai untuk memverifikasi layout field dan satuan koordinat.\n\n[^uji]: Contoh datasheet Concox GT06 v1.8.1 (login + balasan) dipakai sebagai vektor eksternal; packet location dan AVL diuji lewat round-trip encoding-decoding dengan nilai koordinat Surabaya yang diverifikasi manual.\n","body_clean":"Di Part 2 kita sudah punya listener yang merapikan stream TCP menjadi frame utuh. Nah, sekarang saatnya baca isinya. Byte 0x78 0x78 0x0D 0x01 ... perlu diterjemahkan jadi informasi seperti IMEI 123456789012345, posisi -7.2575, 112.7521, arah 180°.\nWaktu menulis artikel ini, saya sempat yakin contoh packet login dari datasheet GT06 adalah ... 6C 00 01 8C ... dan CRC-nya cukup pakai CRC-CCITT standar. Dua-duanya salah, hahaha. Saya baru sadar setelah kode saya sendiri menolak contoh dari datasheet. Pelajarannya: untuk protokol binary, lebih baik uji pakai vektor daripada percaya ingatan sendiri.\nKita bedah GT06 dulu, lalu lihat Teltonika dan bedanya di mana. Semua kode di bawah sudah diuji terhadap contoh resmi datasheet Concox GT06 v1.8.1 dan struktur decoder Traccar1 yang sudah dipakai di production bertahun-tahun.\nJebakan #1: \u0026ldquo;CRC-ITU\u0026rdquo; GT06 Bukan CRC-CCITT yang Kamu Kirim #Datasheet GT06 cuma bilang: field CRC berisi CRC-ITU value. Referensi paling umum soal CRC-ITU adalah CRC-16/CCITT dengan polynomial 0x1021. Nah, di sinilah jebakannya: ada belasan varian CRC dengan polynomial yang sama, dan bedanya ada di nilai awal (init), arah pemrosesan (reflected), dan XOR akhir.\nSaya brute-force semua varian 0x1021 yang umum terhadap contoh resmi datasheet. Packet login 78 78 0D 01 01 23 45 67 89 01 23 45 00 01 8C DD 0D 0A punya CRC 0x8CDD:\nVarian (poly 0x1021) Init Reflected XOR out Hasil CCITT-FALSE 0xFFFF tidak 0x0000 0x81F6 ❌ XMODEM 0x0000 tidak 0x0000 0x55F9 ❌ X25 0xFFFF ya 0xFFFF 0x8CDD ✅ Jawabannya: varian X25, diproses reflected dan di-XOR 0xFFFF di akhir. CRC dihitung bukan dari protocol number, tapi dari byte length sampai serial number (inklusif), sesuai redaksi datasheet WD-209: \u0026ldquo;from packet length to information serial number (including)\u0026rdquo;.\nImplementasinya di Go:\n// crcITU = \u0026#34;CRC-ITU\u0026#34; GT06: varian CRC-16/X25 // (poly 0x1021, init 0xFFFF, reflected, xor-out 0xFFFF). // Scope: byte LENGTH sampai SERIAL (inklusif). func crcITU(data []byte) uint16 { crc := uint16(0xFFFF) for _, b := range data { crc ^= uint16(b) for i := 0; i \u0026lt; 8; i++ { if crc\u0026amp;1 != 0 { crc = (crc \u0026gt;\u0026gt; 1) ^ 0x8408 // 0x1021 versi reflected } else { crc \u0026gt;\u0026gt;= 1 } } } return crc ^ 0xFFFF } Di sisi produksi, Traccar (server GPS open source yang paling banyak dipakai) ternyata tidak memvalidasi CRC masukan untuk GT06. Pasarnya penuh klon/OEM GT06 dengan perhitungan CRC yang sedikit beda. Di artikel ini kita tetap memvalidasi CRC dan membuang paket cacat sesuai anjuran datasheet. Konsekuensinya, perangkat klon yang CRC-nya nyeleneh bisa saja ikut ditolak.\nParser Frame dengan Validasi CRC #Melengkapi readFrame dari Part 2, sekarang kita bongkar frame yang sudah utuh:\ntype GT06Frame struct { Protocol byte Data []byte // isi payload Serial uint16 // untuk pencocokan ACK } func parseGT06(frame []byte) (*GT06Frame, error) { if len(frame) \u0026lt; 9 || frame[0] != 0x78 || frame[1] != 0x78 { return nil, fmt.Errorf(\u0026#34;bukan frame GT06\u0026#34;) } length := int(frame[2]) body := frame[2 : 3+length] // length..crc, scope CRC! got := binary.BigEndian.Uint16(body[len(body)-2:]) want := crcITU(body[:len(body)-2]) if got != want { return nil, fmt.Errorf(\u0026#34;CRC beda: packet=0x%04X hitung=0x%04X\u0026#34;, got, want) } return \u0026amp;GT06Frame{ Protocol: body[1], Data: body[2 : len(body)-4], Serial: binary.BigEndian.Uint16(body[len(body)-4 : len(body)-2]), }, nil } Tes pertama yang wajib lolos: contoh login datasheet tadi harus lolos validasi, dan CRC hasil hitung ulang harus sama persis dengan 0x8CDD.\nLogin: IMEI BCD dan ACK yang Wajib Dibalas #Packet login (protocol 0x01) berisi IMEI dalam format BCD. Delapan byte menyimpan 16 digit desimal, padahal IMEI cuma 15 digit. Digit pertama adalah padding 0 dan harus dibuang:\n// IMEI: 8 byte BCD → 16 digit hex → buang digit pertama → 15 digit func decodeIMEI(data []byte) string { return fmt.Sprintf(\u0026#34;%X\u0026#34;, data)[1:] } Contoh datasheet: 01 23 45 67 89 01 23 45 → \u0026quot;0123456789012345\u0026quot; → IMEI 123456789012345.\nSetelah IMEI dikenali, wajib dibalas. Ingat Part 1: device yang tidak di-ACK akan kirim ulang terus sampai ngambek. Format balasan login: 78 78 05 \u0026lt;protocol\u0026gt; \u0026lt;serial\u0026gt; \u0026lt;crc\u0026gt; 0D 0A:\n// buildAck: 78 78 05 \u0026lt;protocol\u0026gt; \u0026lt;serial\u0026gt; \u0026lt;crc\u0026gt; 0D 0A // CRC dihitung dari byte length (05) sampai serial. func buildAck(f *GT06Frame) []byte { body := []byte{0x05, f.Protocol, byte(f.Serial \u0026gt;\u0026gt; 8), byte(f.Serial)} crc := crcITU(body) out := []byte{0x78, 0x78} out = append(out, body...) out = append(out, byte(crc\u0026gt;\u0026gt;8), byte(crc), 0x0D, 0x0A) return out } Vektor ujinya: untuk serial 0001, balasan yang benar adalah 78 78 05 01 00 01 D9 DC 0D 0A, dan implementasi di atas menghasilkan nilai yang sama. (D9 DC itu lahir dari CRC X25 dengan scope 05 01 00 01, jadi byte length ikut dihitung.)\nLocation: Dari Byte Menjadi Koordinat #Packet posisi yang paling umum adalah protocol 0x12. Isi bagian GPS-nya:\nOffset Ukuran Field Catatan +0 6 Datetime BCD: YY MM DD HH MM SS +6 1 Satelit low nibble saja +7 4 Latitude big-endian, satuan menit × 30000 +11 4 Longitude big-endian, satuan menit × 30000 +15 1 Speed km/jam +16 2 Course + flags lihat bawah Ada dua hal yang gampang kelewat:\nKoordinatnya bukan derajat. Nilainya harus dibagi 60 × 30000 = 1.800.000. Contoh: Surabaya di -7.2575° tersimpan sebagai 7.2575 × 60 × 30000 = 13.063.500 → 00 C7 55 4C. Tanda (selatan/barat) tidak tersimpan di angkanya: semua nilai positif. Tandanya ada di bit flags byte course. Layout flags (2 byte): bit 0 sampai 9 = arah (0 sampai 359°), bit 10 = arah lintang (1 = utara/positif, 0 = selatan), bit 11 = arah bujur (1 = barat/negatif), bit 12 = fix GPS valid. (Nomor bit ini saya ikuti dari perilaku decoder Traccar yang teruji production, karena redaksi datasheet beda-beda antar versi. Tetap uji dengan device asli ya.)\nfunc decodeLocation(data []byte, tz *time.Location) Location { t := time.Date( bcd(data[0])+2000, time.Month(bcd(data[1])), bcd(data[2]), bcd(data[3]), bcd(data[4]), bcd(data[5]), 0, tz) sat := int(data[6] \u0026amp; 0x0F) lat := float64(binary.BigEndian.Uint32(data[7:11])) / 60.0 / 30000.0 lng := float64(binary.BigEndian.Uint32(data[11:15])) / 60.0 / 30000.0 speed := int(data[15]) flags := binary.BigEndian.Uint16(data[16:18]) course := int(flags \u0026amp; 0x3FF) if flags\u0026amp;(1\u0026lt;\u0026lt;10) == 0 { // bit 10: 0 = selatan lat = -lat } if flags\u0026amp;(1\u0026lt;\u0026lt;11) != 0 { // bit 11: 1 = barat lng = -lng } valid := flags\u0026amp;(1\u0026lt;\u0026lt;12) != 0 return Location{t, sat, lat, lng, speed, course, valid} } func bcd(b byte) int { return int(b\u0026gt;\u0026gt;4)*10 + int(b\u0026amp;0x0F) } Cara mengujinya tanpa device asli: saya bangun packet 0x12 di kode uji (Surabaya, 12 satelit, 42 km/jam, arah 180°, fix valid), lalu decode lagi. Hasilnya -7.2575, 112.7521, arah 180, fix valid. Frame lengkapnya 78 78 17 12 26 09 12 14 30 00 0C 00 C7 55 4C 0C 18 D4 34 2A 10 B4 00 01 00 A2 0D 0A bisa kamu replay lewat /dev/tcp seperti di Part 2.\nCatatan: setelah blok GPS, packet 0x12 asli masih berisi data seluler (LBS) untuk fallback posisi saat GPS mati, plus terminal info. Bagian itu menyusul nanti kalau sudah dibutuhkan. Untuk membangun core tracking, blok GPS sudah cukup.\nTeltonika: Desain Paket yang Berbeda #Teltonika mengurus kebutuhan yang sama dengan format paket dan alur yang lain dari GT06. Bedanya terasa di handshake, pengiriman data, koordinat, dan ACK:\n1. Handshake dulu, data kemudian. Koneksi baru diawali packet identifikasi: 2 byte panjang (00 0F) + IMEI 15 digit ASCII + \\r\\n. Server membalas satu byte: 01 (IMEI dikenal) atau 00 (tolak):\nfunc decodeIMEITeltonika(b []byte) (string, bool) { n := int(binary.BigEndian.Uint16(b[0:2])) if n != 15 || len(b) \u0026lt; 2+n { return \u0026#34;\u0026#34;, false } imei := string(b[2 : 2+n]) for _, c := range imei { if c \u0026lt; \u0026#39;0\u0026#39; || c \u0026gt; \u0026#39;9\u0026#39; { return \u0026#34;\u0026#34;, false } } return imei, true // balas: 0x01 = terima, 0x00 = tolak } 2. Batch, bukan kirim satu-satu. Satu packet AVL berisi banyak record sekaligus. Struktur codec 8:\n00 00 00 00 preamble (4 byte nol) 00 00 00 39 data length (4 byte, codec sampai num2) 08 codec ID (0x08 = codec8) 01 jumlah record ... record AVL ... (timestamp 8B, prioritas 1B, GPS element, IO element) 01 jumlah record (ulang, untuk validasi) 00 00 0X XX CRC-16 (4 byte, nilai 16-bit di byte rendah) 3. Koordinat derajat × 10.000.000: longitude dan latitude masing-masing 4 byte big-endian bertanda, lalu dibagi 10.000.000 untuk mendapat derajat. GPS element satu record: longitude 4B, latitude 4B, altitude 2B, angle 2B, satelit 1B, speed 2B.\n4. CRC-16 IBM (poly 0x8005, init 0, reflected; varian CRC-16/ARC), dihitung dari codec ID sampai number of data 2:\nfunc crc16IBM(data []byte) uint16 { crc := uint16(0x0000) for _, b := range data { crc ^= uint16(b) for i := 0; i \u0026lt; 8; i++ { if crc\u0026amp;1 != 0 { crc = (crc \u0026gt;\u0026gt; 1) ^ 0xA001 } else { crc \u0026gt;\u0026gt;= 1 } } } return crc } Untuk konfirmasi penerimaan, server membalas jumlah record yang diterima sebagai integer 4 byte. Kalau menerima 1 record, kirim 00 00 00 01. Device akan mengirim ulang kalau jumlahnya tidak cocok, jadi tidak perlu serial number per paket.\nHasil Uji #Semua kode di artikel ini lolos 13 asersi2:\nSkenario Hasil Login datasheet GT06 (8C DD) lolos validasi CRC ✓ CRC hitung ulang = 8CDD; ACK serial 1 = D9 DC ✓ IMEI BCD → 123456789012345 (15 digit) ✓ Round-trip location 0x12: koordinat, arah, speed, satelit, waktu ✓ Handshake Teltonika 356307042441013 ✓ AVL codec8: CRC valid, koordinat \u0026amp; speed benar ✓ Catatan Buat yang Mau Menguji # Cocokkan varian dan cakupan CRC dengan vektor datasheet. Di GT06, dua-duanya menentukan validasi lolos atau tidak. Uji IMEI dan ACK dari contoh login. Pastikan hasil BCD dan byte balasan sesuai serial packet. Uji konversi koordinat dengan round-trip. GT06 pakai menit×30000, Teltonika pakai derajat×10⁷. Putuskan sikap soal validasi CRC. Traccar tidak memvalidasi CRC masukan GT06/Teltonika karena firmware klon beragam. Tentukan sendiri apakah paket yang tidak cocok ditolak atau cuma dicatat. Berikutnya adalah menyimpan posisi yang sudah didekode. Kalau 500 device mengirim posisi tiap 10 detik, jumlahnya 4,3 juta titik per hari. Tabel PostgreSQL biasa bakal kewalahan tanpa optimasi, jadi Part 4 membahas TimescaleDB.\nSelanjutnya dalam Seri Ini #Artikel ini bagian dari seri Membangun GPS Backend dari Nol.\nSebelumnya: Part 2: Membangun TCP Listener untuk GPS Device di Go Selanjutnya: Part 4: Menyimpan Data GPS dengan PostgreSQL + TimescaleDB Kalau hasil ujimu berbeda saat mencoba packet GT06 atau Teltonika, ngobrol saja lewat Contact. Mau ikut artikel berikutnya? Subscribe RSS.\nSekian. Salam.\nSource code decoder Traccar untuk GT06 dan Teltonika adalah referensi perilaku yang teruji production. Saya pakai untuk memverifikasi layout field dan satuan koordinat.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nContoh datasheet Concox GT06 v1.8.1 (login + balasan) dipakai sebagai vektor eksternal; packet location dan AVL diuji lewat round-trip encoding-decoding dengan nilai koordinat Surabaya yang diverifikasi manual.\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n","canonical":"https://najib.id/writing/2026/decode-packet-gt06-teltonika/","description":"Mengurai packet binary GPS tracker di Go: CRC-ITU GT06 yang ternyata bukan CCITT biasa, IMEI BCD, koordinat, sampai AVL Teltonika. Semuanya dicocokkan dengan datasheet.","language":"id","lastmod":"2026-11-11T23:31:00Z","publishedAt":"2026-10-14T00:00:00Z","readingTime":9,"section":"writing","series":"gps-backend-series","tags":["golang","gps","protocol","binary"],"title":"Decode Packet: GT06 \u0026 Teltonika Protocol","type":"writing","url":"https://najib.id/writing/2026/decode-packet-gt06-teltonika/","wordCount":1736}
