# Kolom dalam File CSV

Alat gudang data memungkinkan Anda mengekspor file data mentah yang berisi semua paket yang diterima dari perangkat Anda, tanpa penyaringan atau perhitungan apa pun yang dilakukan di sisi platform. Parameter ini merepresentasikan informasi yang awalnya didekode dari paket perangkat Anda dalam format terkait protokol, disajikan secara dapat dibaca manusia. Anda tidak perlu mengetahui protokol untuk membaca dan memeriksa informasi dalam paket-paket ini.

{% hint style="info" %}
Untuk mempelajari cara mengunduh informasi ini, Anda dapat merujuk ke [artikel sebelumnya](https://www.navixy.com/docs/expert-center/id/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file). Di sini, kami bertujuan untuk mengeksplorasi lebih jauh cara membaca file ini dan menginterpretasikan berbagai kolom di dalamnya.
{% endhint %}

## Membuka sebuah file

Nama file selalu berisi hal-hal berikut:

* Device ID: Nomor ID perangkat, sering kali merepresentasikan IMEI-nya.
* Label perangkat di platform: Label untuk mempermudah pencarian file.
* Waktu dari dan sampai: Mewakili awal dan akhir file dalam format day\_month\_year\_hours\_minutes\_AM/PM.
* Zona waktu dalam format UTC.

Anda dapat membuka file data mentah dengan editor teks apa pun, seperti WordPad, Notepad++, atau Sublime Text. Format ini mudah dipahami oleh program dan mesin tetapi mungkin tidak sejelas bagi manusia. Untuk menyederhanakan pembacaan file, kami merekomendasikan menggunakan editor tabel. Cukup buka file CSV dengan Excel, Google Sheets, atau editor tabel lainnya. Dalam editor tabel, semua parameter akan berada di kolom masing-masing. Selain itu, Anda dapat membekukan baris pertama untuk melihat nama kolom sepanjang file.

## Parameter data mentah

File akan menyertakan parameter terpilih dalam kolom, bersama dengan satu entri yang konsisten - msg\_time.

![](https://4135011106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-2f5edca71dd9b788133c28403e6c7f4d95373331%2Fimage-20240209-073506.png?alt=media)

Parameter-parameter ini dapat dikategorikan sebagai sederhana atau kompleks.

### Kolom sederhana

Parameter sederhana menyediakan nama lengkap dan terutama merepresentasikan informasi pelacakan tertentu.

* `msg_time`: Waktu ketika pelacak merekam sebuah titik. Selalu disertakan dalam output CSV. Ditunjukkan menurut zona waktu yang dipilih.
* `server_time`: Waktu penerimaan pesan oleh server. Ditunjukkan menurut zona waktu yang dipilih.
* `gps_fix_type`
  * NO\_FIX: Pelacak GPS menandai lokasi sebagai tidak valid.
  * HAS\_FIX: Pelacak GPS menandai lokasi sebagai valid.
  * LAST\_KNOWN\_POSITION: Dalam kasus pelacak menyediakan input saat ini dan status lain di dalam lokasi terakhir yang diketahui.
  * UNKNOWN: Jika perangkat tidak dapat memberikan informasi tersebut atau tidak menentukan tipe fix GPS untuk paket ini.
* `lat`: Lintang lokasi.
* `lng`: Bujur lokasi.
* `speed`: Kecepatan yang ditentukan oleh pelacak dalam km/jam. Dalam kebanyakan kasus, ini adalah kecepatan yang ditentukan oleh GPS perangkat.
* `alt`: Ketinggian lokasi dalam meter.
* `satellites`: Jumlah satelit yang tersambung pada saat itu; `-1` berarti tidak diketahui dan, dalam banyak kasus, merepresentasikan titik lokasi LBS.
* `heading`: Arah objek dalam derajat dimana 0 mewakili Utara.
* `precision`: Presisi lokasi dalam meter.
* `hdop`: Horizontal dilution of precision - merepresentasikan akurasi estimasi posisi horizontal pelacak GPS. Nilai berkisar dari 1 (sangat baik) hingga di atas 20 (buruk). Nilai antara 1 dan 2 dianggap baik untuk sebagian besar tujuan navigasi. `-1` berarti tidak diketahui.
* `pdop`: Position dilution of precision - menunjukkan akurasi posisi pelacak GPS berdasarkan geometri satelit terkait pelacak. Nilai PDOP yang lebih rendah berarti pemposisian satelit yang lebih baik, sehingga menghasilkan data lokasi yang lebih akurat, tetapi `-1` berarti tidak diketahui.
* `mn_name`: Nama jaringan seluler. Ditentukan oleh perangkat.
* `mn_roaming`: Status roaming. Ditentukan oleh perangkat.
  * `0` berarti tidak roaming,
  * `1` berarti titik ini dihasilkan oleh perangkat yang sedang roaming,
  * Jika perangkat tidak dapat memberikan data tersebut atau tidak dapat melakukannya untuk pesan tertentu ini, maka nilainya akan `-1` (unknown).
* `mn_code`: Kode operator jaringan seluler. Ditentukan oleh perangkat.
* `mn_csq`: Kekuatan sinyal jaringan seluler, CSQ, nilai dari 0 hingga 31. Ditentukan oleh perangkat. Jika perangkat tidak dapat memberikan data tersebut atau tidak dapat melakukannya untuk pesan tertentu ini, nilainya akan `99` (unknown).
* `mn_type`: Tipe jaringan seluler. Ditentukan oleh perangkat.
  * Jika perangkat tidak dapat memberikan data tersebut atau tidak dapat melakukannya untuk pesan tertentu ini, maka nilainya akan `UNKNOWN`
  * `GSM`: Jika perangkat menentukan tipe GSM.
  * `CDMA`: Jika perangkat menentukan tipe CDMA.
  * `WCDMA`: Jika perangkat menentukan tipe WCDMA.
  * `LTE`: Jika perangkat menentukan tipe LTE.
  * `NR`: Jika perangkat menentukan tipe NR.
* `event_id`: ID event di platform. Temukan daftar semua kode ID event di bawah ini.

<details>

<summary>ID kode event dan definisinya di Platform</summary>

Dalam paket perangkat, berbagai kode event dapat didefinisikan, masing-masing menandakan kejadian tertentu.

| **Event ID** | **Definisi**                                               |
| ------------ | ---------------------------------------------------------- |
| 2            | Track. Tidak ada event spesifik, hanya titik pelacakan     |
| 4            | Nomor kontak darurat dipanggil                             |
| 5            | Peristiwa gerakan tidak sah yang ditentukan oleh perangkat |
| 11           | Perubahan status Input 1                                   |
| 12           | Perubahan status Input 2                                   |
| 13           | Perubahan status Input 3                                   |
| 14           | Perubahan status Input 4                                   |
| 15           | Perubahan status Input 5                                   |
| 16           | Perubahan status Input 6                                   |
| 17           | Perubahan status Input 7                                   |
| 18           | Perubahan status Input 8                                   |
| 34           | Perangkat bangun dari mode tidur                           |
| 37           | Mulai mode tidur                                           |
| 40           | Daya utama rendah                                          |
| 41           | Daya hilang atau pemutusan daya eksternal                  |
| 42           | Tombol Power On ditekan                                    |
| 43           | Daya pulih atau daya eksternal tersambung                  |
| 44           | OBD dicabut dari konektor mobil                            |
| 45           | OBD disambungkan                                           |
| 46           | Baterai cadangan perangkat lemah                           |
| 50           | Akhir idle (terkait perangkat keras)                       |
| 51           | Mulai idle (terkait perangkat keras)                       |
| 71           | Mulai tidur idle                                           |
| 72           | Mulai tidur karena baterai cadangan rendah                 |
| 73           | Bangun oleh pengatur waktu                                 |
| 74           | Bangun karena gerakan                                      |
| 75           | Bangun oleh daya eksternal                                 |
| 76           | Peringatan tidur oleh pengatur waktu                       |
| 81           | Mode keamanan aktif                                        |
| 82           | Event pengguna                                             |
| 83           | Event tombol SOS ditekan                                   |
| 84           | Mode keamanan nonaktif                                     |
| 90           | Kopling antena terlepas                                    |
| 100          | Perangkat terlepas dari objek                              |
| 111          | Perubahan status Output 1                                  |
| 112          | Perubahan status Output 2                                  |
| 113          | Perubahan status Output 3                                  |
| 114          | Perubahan status Output 4                                  |
| 115          | Perubahan status Output 5                                  |
| 116          | Perubahan status Output 6                                  |
| 117          | Perubahan status Output 7                                  |
| 118          | Perubahan status Output 8                                  |
| 797          | Check-in dikirim dari aplikasi seluler                     |
| 798          | Pengiriman formulir tugas                                  |
| 799          | Perubahan status kerja                                     |
| 800          | Titik LBS GSM ditentukan oleh perangkat                    |
| 802          | Titik pelacakan berdasarkan waktu                          |
| 803          | Titik pelacakan berdasarkan jarak                          |
| 804          | Titik pelacakan berdasarkan sudut                          |
| 811          | Mulai pergerakan pelacakan                                 |
| 812          | Akhir pergerakan pelacakan                                 |
| 813          | Akhir gerakan tidak sah                                    |
| 814          | Pesan non-tracking                                         |
| 900          | Perubahan jalur cepat akibat mengemudi kasar               |
| 901          | Pengacakan GPS                                             |
| 928          | Dicabut dari objek yang dilacak                            |
| 929          | Perubahan jalur yang sering                                |
| 930          | Perangkat tidak dapat mendeteksi wajah manusia             |
| 931          | Sabuk pengaman terlepas                                    |
| 932          | Minum                                                      |
| 933          | Mata tertutup                                              |
| 934          | Pasang perangkat ke objek yang dilacak                     |
| 935          | MDSM 7 terputus                                            |
| 936          | MDSM 7 tersambung                                          |
| 937          | Laporkan pengemudi baru                                    |
| 938          | Pengemudi memasuki kabin                                   |
| 939          | Mulai ketidakhadiran pengemudi                             |
| 940          | Pengemudi berhenti merokok (Gangguan pengemudi)            |
| 941          | Tombol matikan daya ditekan                                |
| 942          | Pengemudi mulai merokok (Gangguan pengemudi)               |
| 943          | Pengemudi selesai menggunakan telepon (Gangguan pengemudi) |
| 944          | Pengemudi mulai menggunakan telepon (Gangguan pengemudi)   |
| 945          | Mengantuk (Mengemudi lelah)                                |
| 946          | Pengemudi berhenti terganggu (Gangguan pengemudi)          |
| 947          | Pengemudi mulai terganggu (Gangguan pengemudi)             |
| 948          | Pengemudi berhenti mengantuk (Mengemudi lelah)             |
| 949          | Pengemudi mulai mengantuk (Mengemudi lelah)                |
| 950          | Melampaui kecepatan oleh event perangkat keras             |
| 951          | Cruise control diaktifkan                                  |
| 952          | Cruise control dimatikan                                   |
| 953          | Mulai pergerakan tak terduga                               |
| 954          | Akhir pergerakan tak terduga                               |
| 955          | Alarm mobil                                                |
| 956          | Pejalan kaki di zona berbahaya (ADAS)                      |
| 957          | Pengenalan rambu lalu lintas (ADAS)                        |
| 958          | Peringatan tabrakan pejalan kaki (ADAS)                    |
| 959          | Lampu cek mesin                                            |
| 960          | Mengantuk saat mengemudi                                   |
| 961          | Peringatan jarak (Headway) (ADAS)                          |
| 962          | Keluar jalur kanan (ADAS)                                  |
| 963          | Keluar jalur kiri (ADAS)                                   |
| 964          | Keluar jalur (ADAS)                                        |
| 965          | Peringatan tabrakan depan (ADAS)                           |
| 966          | Pelacak memasuki geofence otomatis                         |
| 967          | Pelacak keluar dari geofence otomatis                      |
| 968          | Memaksa respons lokasi lewat SMS dari UI                   |
| 969          | Alarm pintu                                                |
| 970          | Ignition Off                                               |
| 971          | Ignition On                                                |
| 972          | Pengemudi tidak teridentifikasi                            |
| 973          | Pengemudi teridentifikasi                                  |
| 974          | Kunci tertutup                                             |
| 975          | Kunci dibuka                                               |
| 976          | Daya perangkat Mati                                        |
| 977          | Daya perangkat Menyala                                     |
| 978          | Case tertutup                                              |
| 979          | Case dibuka                                                |
| 980          | Tombol panggil ditekan                                     |
| 981          | Sensor cahaya menentukan gelap                             |
| 982          | Sensor cahaya menentukan terang                            |
| 983          | Akhir getaran                                              |
| 984          | Mulai getaran                                              |
| 985          | Baut tali dimasukkan                                       |
| 986          | Baut tali dipotong                                         |
| 987          | Percepatan dan belokan keras saat mengemudi                |
| 988          | Pengereman dan belokan keras saat mengemudi                |
| 989          | Belokan keras saat mengemudi                               |
| 990          | Percepatan keras saat mengemudi                            |
| 991          | Pengereman keras saat mengemudi                            |
| 992          | Sinyal GPS pulih                                           |
| 993          | Sinyal GPS hilang                                          |
| 994          | Alarm kecelakaan                                           |
| 995          | Alarm pelemahan sinyal GSM                                 |
| 996          | Berkendara keras                                           |
| 997          | Gelang terbuka                                             |
| 998          | Gelang tertutup                                            |
| 999          | Peringatan sensor G                                        |

</details>

### Parameter kompleks

Parameter kompleks mencakup nama grup dan nama spesifik. Mereka dikategorikan sebagai berikut:

* `flags`: Sebuah bitmap flag yang merepresentasikan validitas lokasi dan LBS:
  * Bit 0 (location\_valid): Menunjukkan status validitas lokasi. Nilainya `0` jika lokasi tidak valid, dan `1` jika lokasi valid.
  * Bit 1 (lbs): Menunjukkan status LBS dari titik tersebut. Jika `0`, titik diterima oleh GPS; jika `1`, titik diterima oleh LBS.
  * Bit 2 (soft\_lbs): Menunjukkan sumber titik LBS. Jika `0`, titik ditentukan oleh LBS perangkat; jika `1`, oleh LBS platform.
* `discrete_inputs`: Mewakili informasi dari setiap input diskret. Setiap input diskret disajikan dalam kolom terpisah, dinomori mulai dari 1. Nilai yang mungkin adalah 1 dan 0, dimana 0 menandakan dimatikan, dan 1 menandakan dinyalakan.
* `discrete_outputs` : Menunjukkan hal yang sama seperti discrete inputs tetapi untuk output diskret. Setiap output diskret berada di kolom terpisah, dinomori mulai dari 1.
* `inputs`: Mewakili data dari berbagai sensor, seperti bahan bakar atau berbagai sensor pengukur. Setiap input berada di kolom terpisah, dan daftar input bergantung pada model perangkat.
* `states`: Menampilkan nilai dari parameter status. Sebagian besar dari mereka dapat bernilai 1 atau 0, tetapi beberapa memiliki nilai teks spesifik seperti kode DTC.

Dengan definisi-definisi ini, kami berharap Anda akan mudah membaca informasi dalam file data mentah dan memanfaatkannya dalam pemecahan masalah perangkat serta dalam program untuk pelanggan Anda.
