











{"author":"Faiq Najib Al-Aziz","body":"\nWaktu pertama kali dipercaya menangani backend untuk ratusan GPS tracker, saya kira kerjaannya cuma bikin REST API biasa: device kirim `POST /api/location` pakai JSON, server simpan ke database, selesai. Gampang, kan? Hahaha.\n\nTernyata saya keliru. Backend itu akhirnya dimigrasikan dari Laravel ke Go, mencakup lebih dari 370 endpoint. Kisah lengkapnya saya tulis di [seri naratif Hijrah Backend](/writing/2026/hijrah-backend-01/). Seri yang sedang kamu baca ini versi tutorialnya: membangun ulang backend dari nol, dengan kode yang bisa kamu ikuti.\n\nGPS tracker itu tidak kenal HTTP. Tidak ada JSON. Data yang masuk lewat koneksi TCP berupa byte mentah seperti `\\x00\\x00\\x00\\x2f\\x8e\\x01\\x04\\x01\\x03...`, tanpa header, content-type, atau petunjuk apa pun. Tiap brand pun punya cara sendiri menyusun byte-byte itu.\n\nDi artikel ini saya cerita dulu soal cara GPS tracker ngobrol dengan server. Belum tutorial decode ya, itu ada di [Part 3](/writing/2026/decode-packet-gt06-teltonika/). Kita mulai dari konsep yang perlu dipahami sebelum menulis kode.\n\n## Apa Itu GPS Tracker, Sebenarnya?\n\nGPS tracker adalah embedded device dengan dua modul inti:\n\n1. **GPS module**: menerima sinyal dari satelit untuk menentukan posisi (latitude, longitude, altitude, speed, heading).\n2. **GSM/LTE module**: mengirim data posisi itu ke server lewat jaringan seluler.\n\nSelain itu, device biasanya punya:\n\n- **Digital I/O**: sensor pintu terbuka/tutup, ignition (mesin menyala), SOS button\n- **Analog input**: sensor bahan bakar, suhu\n- **Accelerometer**: deteksi kejutan (tabrakan atau rem mendadak)\n- **Internal battery**: cadangan kalau power utama terputus\n\nData dari semua sensor ini dikemas dalam satu packet dan dikirim ke server secara periodik, biasanya tiap 10-30 detik saat device bergerak dan lebih jarang saat diam supaya hemat kuota.\n\n## Kenapa TCP, Bukan HTTP?\n\nAwalnya saya juga bertanya-tanya: kenapa device tidak pakai HTTP REST API saja?\n\nAda empat alasan.\n\n### 1. Efisiensi Bandwidth\n\nHTTP request punya overhead besar. Header saja bisa 500+ bytes (`Host`, `Content-Type`, `Accept`, `Authorization`, dll), sedangkan satu packet GPS binary biasanya cuma 40-60 bytes. Dengan koneksi 2G/3G yang tidak stabil dan kuota SIM card yang berbayar, setiap byte itu dihitung.\n\n### 2. Persistent Connection\n\nDevice tracker perlu menjaga koneksi tetap aktif supaya server bisa kirim command kapan saja, misalnya \"matikan mesin\" (engine cut), \"update interval reporting\", atau \"minta lokasi sekarang\". HTTP itu pola request-response. Untuk mengirim command saat device tidak sedang request, perlu mekanisme lain seperti polling atau kanal terpisah.\n\n### 3. Kontrol Penuh atas Format Data\n\nHTTP memaksa struktur tertentu (method, headers, body, status code). Protokol GPS binary membebaskan produsen device merancang format seefisien mungkin. Satu byte bisa berarti 3-4 field sekaligus pakai bitmask.\n\n### 4. Kompatibilitas Hardware\n\nBanyak GPS tracker memakai microcontroller dengan resource terbatas (RAM 64KB, clock 48MHz). HTTP stack (parsing headers, TLS handshake, JSON encoding) kemakan resource terlalu banyak. Raw TCP socket jauh lebih ringan.\n\n## Cara Kerja Komunikasi GPS Device\n\nAlurnya begini:\n\n```\nDevice                          Server\n  │                               │\n  │──── Connect (TCP) ───────────→│\n  │                               │\n  │──── Login packet (IMEI) ─────→│\n  │                               │\n  │←─── ACK / Login response ─────│\n  │                               │\n  │──── Location data ───────────→│  (loop, setiap N detik)\n  │←─── ACK ──────────────────────│\n  │                               │\n  │←─── Command (optional) ───────│  (server → device)\n  │──── Command response ────────→│\n  │                               │\n  │──── Heartbeat (keep-alive) ──→│  (jika idle)\n  │←─── Heartbeat ACK ────────────│\n  │                               │\n```\n\n### Fase 1: Connection \u0026 Login\n\nDevice membuka koneksi TCP ke IP:port server. Setelah tersambung, device mengirim **login packet** yang biasanya berisi IMEI (International Mobile Equipment Identity), nomor unik 15 digit yang jadi identitas device.\n\nServer membalas dengan ACK (acknowledge). Kalau IMEI tidak dikenal, server bisa menutup koneksi atau mengabaikan datanya.\n\n### Fase 2: Data Reporting\n\nSetelah login berhasil, device mulai mengirim location data secara periodik. Beberapa protokol juga mengirim data saat ada event:\n\n- Saat device bergerak (motion detected)\n- Saat melewati jarak tertentu dari titik sebelumnya (distance-based)\n- Saat ignition dinyalakan/dimatikan\n- Saat SOS button ditekan\n- Saat geofence dilanggar\n\nSetiap location data packet minimal berisi timestamp, latitude, dan longitude. Biasanya ada juga speed, heading/azimuth, altitude, status I/O (ignition, door, alarm), dan battery level.\n\n### Fase 3: Server Commands\n\nServer bisa mengirim command ke device yang sedang online. Contohnya:\n\n- **Reboot device**: berguna kalau device hang\n- **Set reporting interval**: ubah frekuensi kirim data\n- **Engine cut**: matikan starter mesin (anti-maling)\n- **Listen-in**: aktifkan mikrofon untuk monitoring audio\n- **Request current location**: minta posisi sekarang juga\n\n### Fase 4: Heartbeat / Keep-Alive\n\nSaat device idle (tidak bergerak), dia tetap menjaga koneksi TCP dengan mengirim packet heartbeat tiap 2-5 menit. Ini mencegah NAT timeout dan memastikan koneksi tetap \"hidup\".\n\n## Anatomi Packet GPS\n\nMeski format tiap brand beda, sebagian besar protokol GPS binary mengikuti pola umum ini:\n\n```\n┌──────────┬──────────┬────────────┬─────────────┬──────────┬──────────┐\n│  Start   │  Length  │  Protocol  │   Payload   │   CRC    │   End    │\n│  Marker  │  Bytes   │    ID      │   (Data)    │  Check   │  Marker  │\n└──────────┴──────────┴────────────┴─────────────┴──────────┴──────────┘\n```\n\n- **Start marker**: byte tetap penanda awal packet (misal `\\x78\\x78` untuk GT06, atau 4 byte nol `\\x00\\x00\\x00\\x00` untuk Teltonika)\n- **Length**: jumlah byte payload (supaya server tahu kapan packet selesai)\n- **Protocol ID / Codec ID**: identifier jenis data (location, alarm, heartbeat, response command)\n- **Payload**: data sebenarnya (IMEI, koordinat, status I/O, dll)\n- **CRC**: checksum untuk validasi integritas data\n- **End marker**: byte tetap penanda akhir packet (misal `\\x0d\\x0a` untuk GT06)\n\n### Contoh: Struktur Packet GT06 (Concox)\n\nGT06 termasuk protokol yang umum di Indonesia karena device-nya murah dan gampang dicari. Strukturnya:\n\n```\n78 78      Start bit (2 byte)\n0D         Length (1 byte, dari protocol number sampai CRC, inklusif)\n01         Protocol number (login = 0x01)\n01 23 45 67 89 01 23 45    IMEI (8 byte, BCD encoded)\n00 01      Serial number (2 byte)\n8C DD      CRC-ITU (2 byte)\n0D 0A      Stop bit (2 byte)\n```\n\nContoh di atas adalah packet login dari datasheet Concox GT06 v1.8.1 untuk terminal ID `123456789012345` (IMEI 15 digit; 8 byte BCD memuat 16 digit, digit pertama dibuang). CRC-ITU dihitung dari byte _length_ sampai _serial number_ (inklusif). Detail varian CRC kita bedah di [Part 3](/writing/2026/decode-packet-gt06-teltonika/). Angka `0x7878` di awal dan `0x0D0A` di akhir itu semacam \"tanda tangan\" GT06. Begitu lihat byte itu di log TCP, kamu langsung tahu ini keluarga Concox/GT06.\n\n### Contoh: Struktur Packet Teltonika\n\nTeltonika (seri FMB, FMTC) pakai pendekatan yang agak beda. Strukturnya lebih teratur dan memakai konsep \"codec\":\n\n```\n0000 0000        Preamble (4 byte nol)\n0000 0039         Data field length (4 byte)\n08               Codec ID (1 byte: 0x08 = codec8, 0x0E = codec8 extended)\n01               Number of data (1 byte, jumlah AVL records)\n...              AVL data (records saja; IMEI dikirim terpisah saat handshake)\n...              Number of data (repeat)\n0000 0XXX         CRC-16 (4 byte)\n```\n\nTeltonika pakai 4-byte length prefix dan CRC-16, sedangkan GT06 pakai 1-byte length, CRC-ITU 2 byte, plus serial number untuk mencocokkan ACK. Perbedaan ini bakal penting waktu kita menulis decoder di Part 3.\n\n## Protokol Populer di Indonesia\n\nDari pengalaman saya menangani GPS tracking di Indonesia, ini brand/protokol yang sering ketemu:\n\n| Protokol       | Brand Umum                           | Format         | Keterangan                                  |\n| -------------- | ------------------------------------ | -------------- | ------------------------------------------- |\n| **GT06**       | Concox, Coban, Xexun, berbagai \"OEM\" | Binary         | Paling murah, paling banyak varian clone    |\n| **Teltonika**  | Teltonika FMB/FMTC/FM                | Binary         | Premium, dokumentasi lengkap, codec system  |\n| **Meitrack**   | Meitrack MVT/MST                     | Binary         | Cukup umum di fleet enterprise              |\n| **Wialon IPS** | Berbagai brand (Universal)           | Text (ASCII)   | Comma-separated, lebih mudah dibaca manusia |\n| **H02**        | H02/GPS103                           | Text (ASCII)   | Sederhana, sering di device murah           |\n| **MQTT**       | Berbagai brand modern                | JSON over MQTT | Tren baru: device 4G yang pakai JSON        |\n\n### Binary vs Text Protocol\n\nProtokol GPS terbagi dua kubu besar.\n\n**Binary protocol** (Teltonika, GT06, Meitrack):\n\n- Setiap byte punya arti presisi dan bisa berisi beberapa field\n- Lebih hemat bandwidth (1 byte = 8 bit = bisa 8 boolean flag)\n- Lebih sulit dibaca manusia (`\\x8e\\x01\\x04` vs `lat=-6.2,lng=106.8`)\n- Butuh dokumentasi protocol yang lengkap\n\n**Text protocol** (Wialon, H02):\n\n- Format ASCII yang bisa langsung dibaca: `#L#359769030123456;NA`\n- Lebih gampang di-debug\n- Lebih boros bandwidth\n- Cocok untuk device dengan resource terbatas atau testing cepat\n\n### Tren: MQTT dan JSON\n\nBelakangan saya mulai ketemu tracker generasi baru (4G/LTE, Cat-M1, NB-IoT) yang memakai MQTT dengan payload JSON:\n\n```json\n{\n  \"imei\": \"359769030123456\",\n  \"lat\": -6.2,\n  \"lng\": 106.816666,\n  \"speed\": 42,\n  \"course\": 180,\n  \"ignition\": true,\n  \"timestamp\": \"2026-09-08T10:30:00Z\"\n}\n```\n\nJSON lebih mudah di-parse, lebih human-readable, dan tidak butuh protocol manual khusus. Tapi di Indonesia perangkat 2G/3G masih banyak dipakai dan tetap menggunakan binary TCP. Dua pendekatan ini kemungkinan akan hidup berdampingan beberapa tahun ke depan.\n\n## Kesalahpahaman yang Pernah Saya Alami\n\n### \"Cukup baca dokumentasi satu brand\"\n\nSalah. GT06 punya puluhan varian protocol karena banyak clone/OEM yang sedikit memodifikasi format. Concox GT06, Coban GPS103, dan \"GT06 generic\" punya perbedaan kecil yang bikin decoder-mu crash kalau edge case-nya tidak ditangani.\n\n### \"IMEI unik per device\"\n\nSecara teori, ya. Praktiknya, banyak device murah memiliki IMEI duplikat atau tidak valid. Tambahkan kolom `device_id` sendiri di database dan jangan pakai IMEI sebagai primary key tanpa normalisasi.\n\n### \"TCP connection = device online\"\n\nTidak selalu. NAT timeout, TCP reset di level carrier, dan device hang bisa bikin koneksi kelihatan \"hidup\" di sisi server padahal device sudah mati. Makanya heartbeat/keep-alive mechanism wajib ada.\n\n### \"Semua device kirim data dalam UTC\"\n\nMayoritas, tapi ada beberapa brand yang mengirim timestamp dalam timezone lokal (UTC+7 untuk Indonesia). Cek dokumentasi protocol, atau lebih baik jangan berasumsi dan uji dengan device asli.\n\n## Tools untuk Inspect Packet\n\nSebelum menulis decoder, saya \"mengintip\" dulu data yang masuk dengan beberapa tools.\n\n### 1. TCP Packet Logger\n\nUntuk melihat struktur packet, pakai handler koneksi TCP sederhana yang mencatat byte masuk. Contoh ini hanya menerima dan menampilkan data, tidak meneruskannya ke server lain:\n\n```go\n// Minimal TCP logger: log semua byte yang masuk\nfunc handleConn(conn net.Conn) {\n    defer conn.Close()\n    buf := make([]byte, 1024)\n    for {\n        n, err := conn.Read(buf)\n        if err != nil {\n            break\n        }\n        fmt.Printf(\"%x\\n\", buf[:n]) // print sebagai hex\n    }\n}\n```\n\nOutput hex membantu melihat struktur packet dan mencocokkannya dengan dokumentasi protocol.\n\n### 2. Wireshark\n\nKalau bisa capture traffic langsung di interface server, pakai filter `tcp.port == 5094` (atau port yang kamu pakai) di Wireshark untuk melihat detail tiap packet. Fitur \"Follow TCP Stream\" menampilkan percakapan device-server secara lengkap.\n\n### 3. Device Simulator\n\nBeberapa brand menyediakan simulator. Kalau tidak ada, rekam packet dari device asli lalu replay untuk testing. Jadi kamu tidak perlu selalu debug pakai device fisik waktu mengembangkan decoder untuk banyak protocol.\n\n## Bekal Sebelum Lanjut\n\nSebelum lanjut, pastikan sudah paham:\n\n- **Kenapa GPS device pakai TCP socket, bukan HTTP**: efisiensi, koneksi persisten, dan kontrol format\n- **Alur komunikasi device-server**: connect → login → data reporting → commands → heartbeat\n- **Anatomi packet binary**: start marker, length, payload, CRC, end marker\n- **Beda protokol tiap brand**: binary vs text, GT06 vs Teltonika vs MQTT\n- **Kesalahpahaman umum**: IMEI duplikat, TCP \"hidup\" tapi device mati, timezone tidak konsisten\n\n## Selanjutnya dalam Seri Ini\n\nArtikel ini bagian dari seri **Membangun GPS Backend dari Nol**.\n\nSelanjutnya: [Part 2: Membangun TCP Listener untuk GPS Device di Go](/writing/2026/tcp-listener-gps-go/). Di sana kita bikin TCP server yang menerima koneksi dari ratusan device secara concurrent pakai goroutine.\n\nKalau mau langsung ke urusan baca packet, [Part 3](/writing/2026/decode-packet-gt06-teltonika/) membahas detail parsing GT06 dan Teltonika binary.\n\nKalau ada yang ingin didiskusikan soal protokol GPS, mampir ke [Contact](/contact/). Mau ikut artikel berikutnya? Subscribe [RSS](/writing/index.xml).\n\nSekian. Salam.\n","body_clean":"Waktu pertama kali dipercaya menangani backend untuk ratusan GPS tracker, saya kira kerjaannya cuma bikin REST API biasa: device kirim POST /api/location pakai JSON, server simpan ke database, selesai. Gampang, kan? Hahaha.\nTernyata saya keliru. Backend itu akhirnya dimigrasikan dari Laravel ke Go, mencakup lebih dari 370 endpoint. Kisah lengkapnya saya tulis di seri naratif Hijrah Backend. Seri yang sedang kamu baca ini versi tutorialnya: membangun ulang backend dari nol, dengan kode yang bisa kamu ikuti.\nGPS tracker itu tidak kenal HTTP. Tidak ada JSON. Data yang masuk lewat koneksi TCP berupa byte mentah seperti \\x00\\x00\\x00\\x2f\\x8e\\x01\\x04\\x01\\x03..., tanpa header, content-type, atau petunjuk apa pun. Tiap brand pun punya cara sendiri menyusun byte-byte itu.\nDi artikel ini saya cerita dulu soal cara GPS tracker ngobrol dengan server. Belum tutorial decode ya, itu ada di Part 3. Kita mulai dari konsep yang perlu dipahami sebelum menulis kode.\nApa Itu GPS Tracker, Sebenarnya? #GPS tracker adalah embedded device dengan dua modul inti:\nGPS module: menerima sinyal dari satelit untuk menentukan posisi (latitude, longitude, altitude, speed, heading). GSM/LTE module: mengirim data posisi itu ke server lewat jaringan seluler. Selain itu, device biasanya punya:\nDigital I/O: sensor pintu terbuka/tutup, ignition (mesin menyala), SOS button Analog input: sensor bahan bakar, suhu Accelerometer: deteksi kejutan (tabrakan atau rem mendadak) Internal battery: cadangan kalau power utama terputus Data dari semua sensor ini dikemas dalam satu packet dan dikirim ke server secara periodik, biasanya tiap 10-30 detik saat device bergerak dan lebih jarang saat diam supaya hemat kuota.\nKenapa TCP, Bukan HTTP? #Awalnya saya juga bertanya-tanya: kenapa device tidak pakai HTTP REST API saja?\nAda empat alasan.\n1. Efisiensi Bandwidth #HTTP request punya overhead besar. Header saja bisa 500+ bytes (Host, Content-Type, Accept, Authorization, dll), sedangkan satu packet GPS binary biasanya cuma 40-60 bytes. Dengan koneksi 2G/3G yang tidak stabil dan kuota SIM card yang berbayar, setiap byte itu dihitung.\n2. Persistent Connection #Device tracker perlu menjaga koneksi tetap aktif supaya server bisa kirim command kapan saja, misalnya \u0026ldquo;matikan mesin\u0026rdquo; (engine cut), \u0026ldquo;update interval reporting\u0026rdquo;, atau \u0026ldquo;minta lokasi sekarang\u0026rdquo;. HTTP itu pola request-response. Untuk mengirim command saat device tidak sedang request, perlu mekanisme lain seperti polling atau kanal terpisah.\n3. Kontrol Penuh atas Format Data #HTTP memaksa struktur tertentu (method, headers, body, status code). Protokol GPS binary membebaskan produsen device merancang format seefisien mungkin. Satu byte bisa berarti 3-4 field sekaligus pakai bitmask.\n4. Kompatibilitas Hardware #Banyak GPS tracker memakai microcontroller dengan resource terbatas (RAM 64KB, clock 48MHz). HTTP stack (parsing headers, TLS handshake, JSON encoding) kemakan resource terlalu banyak. Raw TCP socket jauh lebih ringan.\nCara Kerja Komunikasi GPS Device #Alurnya begini:\nDevice Server │ │ │──── Connect (TCP) ───────────→│ │ │ │──── Login packet (IMEI) ─────→│ │ │ │←─── ACK / Login response ─────│ │ │ │──── Location data ───────────→│ (loop, setiap N detik) │←─── ACK ──────────────────────│ │ │ │←─── Command (optional) ───────│ (server → device) │──── Command response ────────→│ │ │ │──── Heartbeat (keep-alive) ──→│ (jika idle) │←─── Heartbeat ACK ────────────│ │ │ Fase 1: Connection \u0026amp; Login #Device membuka koneksi TCP ke IP:port server. Setelah tersambung, device mengirim login packet yang biasanya berisi IMEI (International Mobile Equipment Identity), nomor unik 15 digit yang jadi identitas device.\nServer membalas dengan ACK (acknowledge). Kalau IMEI tidak dikenal, server bisa menutup koneksi atau mengabaikan datanya.\nFase 2: Data Reporting #Setelah login berhasil, device mulai mengirim location data secara periodik. Beberapa protokol juga mengirim data saat ada event:\nSaat device bergerak (motion detected) Saat melewati jarak tertentu dari titik sebelumnya (distance-based) Saat ignition dinyalakan/dimatikan Saat SOS button ditekan Saat geofence dilanggar Setiap location data packet minimal berisi timestamp, latitude, dan longitude. Biasanya ada juga speed, heading/azimuth, altitude, status I/O (ignition, door, alarm), dan battery level.\nFase 3: Server Commands #Server bisa mengirim command ke device yang sedang online. Contohnya:\nReboot device: berguna kalau device hang Set reporting interval: ubah frekuensi kirim data Engine cut: matikan starter mesin (anti-maling) Listen-in: aktifkan mikrofon untuk monitoring audio Request current location: minta posisi sekarang juga Fase 4: Heartbeat / Keep-Alive #Saat device idle (tidak bergerak), dia tetap menjaga koneksi TCP dengan mengirim packet heartbeat tiap 2-5 menit. Ini mencegah NAT timeout dan memastikan koneksi tetap \u0026ldquo;hidup\u0026rdquo;.\nAnatomi Packet GPS #Meski format tiap brand beda, sebagian besar protokol GPS binary mengikuti pola umum ini:\n┌──────────┬──────────┬────────────┬─────────────┬──────────┬──────────┐ │ Start │ Length │ Protocol │ Payload │ CRC │ End │ │ Marker │ Bytes │ ID │ (Data) │ Check │ Marker │ └──────────┴──────────┴────────────┴─────────────┴──────────┴──────────┘ Start marker: byte tetap penanda awal packet (misal \\x78\\x78 untuk GT06, atau 4 byte nol \\x00\\x00\\x00\\x00 untuk Teltonika) Length: jumlah byte payload (supaya server tahu kapan packet selesai) Protocol ID / Codec ID: identifier jenis data (location, alarm, heartbeat, response command) Payload: data sebenarnya (IMEI, koordinat, status I/O, dll) CRC: checksum untuk validasi integritas data End marker: byte tetap penanda akhir packet (misal \\x0d\\x0a untuk GT06) Contoh: Struktur Packet GT06 (Concox) #GT06 termasuk protokol yang umum di Indonesia karena device-nya murah dan gampang dicari. Strukturnya:\n78 78 Start bit (2 byte) 0D Length (1 byte, dari protocol number sampai CRC, inklusif) 01 Protocol number (login = 0x01) 01 23 45 67 89 01 23 45 IMEI (8 byte, BCD encoded) 00 01 Serial number (2 byte) 8C DD CRC-ITU (2 byte) 0D 0A Stop bit (2 byte) Contoh di atas adalah packet login dari datasheet Concox GT06 v1.8.1 untuk terminal ID 123456789012345 (IMEI 15 digit; 8 byte BCD memuat 16 digit, digit pertama dibuang). CRC-ITU dihitung dari byte length sampai serial number (inklusif). Detail varian CRC kita bedah di Part 3. Angka 0x7878 di awal dan 0x0D0A di akhir itu semacam \u0026ldquo;tanda tangan\u0026rdquo; GT06. Begitu lihat byte itu di log TCP, kamu langsung tahu ini keluarga Concox/GT06.\nContoh: Struktur Packet Teltonika #Teltonika (seri FMB, FMTC) pakai pendekatan yang agak beda. Strukturnya lebih teratur dan memakai konsep \u0026ldquo;codec\u0026rdquo;:\n0000 0000 Preamble (4 byte nol) 0000 0039 Data field length (4 byte) 08 Codec ID (1 byte: 0x08 = codec8, 0x0E = codec8 extended) 01 Number of data (1 byte, jumlah AVL records) ... AVL data (records saja; IMEI dikirim terpisah saat handshake) ... Number of data (repeat) 0000 0XXX CRC-16 (4 byte) Teltonika pakai 4-byte length prefix dan CRC-16, sedangkan GT06 pakai 1-byte length, CRC-ITU 2 byte, plus serial number untuk mencocokkan ACK. Perbedaan ini bakal penting waktu kita menulis decoder di Part 3.\nProtokol Populer di Indonesia #Dari pengalaman saya menangani GPS tracking di Indonesia, ini brand/protokol yang sering ketemu:\nProtokol Brand Umum Format Keterangan GT06 Concox, Coban, Xexun, berbagai \u0026ldquo;OEM\u0026rdquo; Binary Paling murah, paling banyak varian clone Teltonika Teltonika FMB/FMTC/FM Binary Premium, dokumentasi lengkap, codec system Meitrack Meitrack MVT/MST Binary Cukup umum di fleet enterprise Wialon IPS Berbagai brand (Universal) Text (ASCII) Comma-separated, lebih mudah dibaca manusia H02 H02/GPS103 Text (ASCII) Sederhana, sering di device murah MQTT Berbagai brand modern JSON over MQTT Tren baru: device 4G yang pakai JSON Binary vs Text Protocol #Protokol GPS terbagi dua kubu besar.\nBinary protocol (Teltonika, GT06, Meitrack):\nSetiap byte punya arti presisi dan bisa berisi beberapa field Lebih hemat bandwidth (1 byte = 8 bit = bisa 8 boolean flag) Lebih sulit dibaca manusia (\\x8e\\x01\\x04 vs lat=-6.2,lng=106.8) Butuh dokumentasi protocol yang lengkap Text protocol (Wialon, H02):\nFormat ASCII yang bisa langsung dibaca: #L#359769030123456;NA Lebih gampang di-debug Lebih boros bandwidth Cocok untuk device dengan resource terbatas atau testing cepat Tren: MQTT dan JSON #Belakangan saya mulai ketemu tracker generasi baru (4G/LTE, Cat-M1, NB-IoT) yang memakai MQTT dengan payload JSON:\n{ \u0026#34;imei\u0026#34;: \u0026#34;359769030123456\u0026#34;, \u0026#34;lat\u0026#34;: -6.2, \u0026#34;lng\u0026#34;: 106.816666, \u0026#34;speed\u0026#34;: 42, \u0026#34;course\u0026#34;: 180, \u0026#34;ignition\u0026#34;: true, \u0026#34;timestamp\u0026#34;: \u0026#34;2026-09-08T10:30:00Z\u0026#34; } JSON lebih mudah di-parse, lebih human-readable, dan tidak butuh protocol manual khusus. Tapi di Indonesia perangkat 2G/3G masih banyak dipakai dan tetap menggunakan binary TCP. Dua pendekatan ini kemungkinan akan hidup berdampingan beberapa tahun ke depan.\nKesalahpahaman yang Pernah Saya Alami #\u0026ldquo;Cukup baca dokumentasi satu brand\u0026rdquo; #Salah. GT06 punya puluhan varian protocol karena banyak clone/OEM yang sedikit memodifikasi format. Concox GT06, Coban GPS103, dan \u0026ldquo;GT06 generic\u0026rdquo; punya perbedaan kecil yang bikin decoder-mu crash kalau edge case-nya tidak ditangani.\n\u0026ldquo;IMEI unik per device\u0026rdquo; #Secara teori, ya. Praktiknya, banyak device murah memiliki IMEI duplikat atau tidak valid. Tambahkan kolom device_id sendiri di database dan jangan pakai IMEI sebagai primary key tanpa normalisasi.\n\u0026ldquo;TCP connection = device online\u0026rdquo; #Tidak selalu. NAT timeout, TCP reset di level carrier, dan device hang bisa bikin koneksi kelihatan \u0026ldquo;hidup\u0026rdquo; di sisi server padahal device sudah mati. Makanya heartbeat/keep-alive mechanism wajib ada.\n\u0026ldquo;Semua device kirim data dalam UTC\u0026rdquo; #Mayoritas, tapi ada beberapa brand yang mengirim timestamp dalam timezone lokal (UTC+7 untuk Indonesia). Cek dokumentasi protocol, atau lebih baik jangan berasumsi dan uji dengan device asli.\nTools untuk Inspect Packet #Sebelum menulis decoder, saya \u0026ldquo;mengintip\u0026rdquo; dulu data yang masuk dengan beberapa tools.\n1. TCP Packet Logger #Untuk melihat struktur packet, pakai handler koneksi TCP sederhana yang mencatat byte masuk. Contoh ini hanya menerima dan menampilkan data, tidak meneruskannya ke server lain:\n// Minimal TCP logger: log semua byte yang masuk func handleConn(conn net.Conn) { defer conn.Close() buf := make([]byte, 1024) for { n, err := conn.Read(buf) if err != nil { break } fmt.Printf(\u0026#34;%x\\n\u0026#34;, buf[:n]) // print sebagai hex } } Output hex membantu melihat struktur packet dan mencocokkannya dengan dokumentasi protocol.\n2. Wireshark #Kalau bisa capture traffic langsung di interface server, pakai filter tcp.port == 5094 (atau port yang kamu pakai) di Wireshark untuk melihat detail tiap packet. Fitur \u0026ldquo;Follow TCP Stream\u0026rdquo; menampilkan percakapan device-server secara lengkap.\n3. Device Simulator #Beberapa brand menyediakan simulator. Kalau tidak ada, rekam packet dari device asli lalu replay untuk testing. Jadi kamu tidak perlu selalu debug pakai device fisik waktu mengembangkan decoder untuk banyak protocol.\nBekal Sebelum Lanjut #Sebelum lanjut, pastikan sudah paham:\nKenapa GPS device pakai TCP socket, bukan HTTP: efisiensi, koneksi persisten, dan kontrol format Alur komunikasi device-server: connect → login → data reporting → commands → heartbeat Anatomi packet binary: start marker, length, payload, CRC, end marker Beda protokol tiap brand: binary vs text, GT06 vs Teltonika vs MQTT Kesalahpahaman umum: IMEI duplikat, TCP \u0026ldquo;hidup\u0026rdquo; tapi device mati, timezone tidak konsisten Selanjutnya dalam Seri Ini #Artikel ini bagian dari seri Membangun GPS Backend dari Nol.\nSelanjutnya: Part 2: Membangun TCP Listener untuk GPS Device di Go. Di sana kita bikin TCP server yang menerima koneksi dari ratusan device secara concurrent pakai goroutine.\nKalau mau langsung ke urusan baca packet, Part 3 membahas detail parsing GT06 dan Teltonika binary.\nKalau ada yang ingin didiskusikan soal protokol GPS, mampir ke Contact. Mau ikut artikel berikutnya? Subscribe RSS.\nSekian. Salam.\n","canonical":"https://najib.id/writing/2026/memahami-gps-protocol/","description":"GPS tracker mengirim data posisi lewat TCP socket dengan protokol binary yang beda-beda tiap brand. Catatan saya soal cara kerjanya, format packet Teltonika dan GT06, dan kenapa bukan HTTP.","language":"id","lastmod":"2026-11-11T23:31:00Z","publishedAt":"2026-09-08T00:00:00Z","readingTime":9,"section":"writing","series":["gps-backend-series"],"tags":["gps","iot","tcp","networking"],"title":"Memahami GPS Protocol: Cara Komunikasi Device Tracker","type":"writing","url":"https://najib.id/writing/2026/memahami-gps-protocol/","wordCount":1738}
