Protokol Komunikasi SR226 V3.26
Panduan Pengguna API
Wuhan Lakeda Science And Technology Co., Ltd.
Daftar Isi
1. Ikhtisar
Protokol Komunikasi SR226 mendefinisikan antarmuka berbasis UDP antara Radar dan Terminal PC untuk seri radar keamanan “XW/SR226-6000XP”.
Mencakup:
- Perintah tautan
- Kontrol parameter
- Data pelacakan
- Paket detak jantung
- Data parameter
2. Protokol Komunikasi
- Radar dan PC harus berada pada subnet yang sama.
- Protokol datagram UDP digunakan dengan urutan byte Little Endian.
- Alur komunikasi:
- PC mengirim Perintah Tautan.
- Radar memperoleh IP/Port PC.
- Radar melaporkan Data Pelacakan dan Paket Detak Jantung.
Dua jenis pesan:
- PC → Radar: Perintah kontrol (Tautan, Kontrol Parameter)
- Radar → PC: Pesan laporan (Data Pelacakan, Detak Jantung, Data Parameter)
2.1 Perintah Kontrol (PC → Radar)
2.1.1 Perintah Tautan
- PC mengirim perintah tautan tetap 10 byte.
- Radar merespons dengan Data Pelacakan dan Paket Detak Jantung.
- IP bawaan radar:
192.168.0.100, Port:12580. - Kirim sekali per menit.
Format Perintah Tautan (10 byte):
| Offset Byte | Bidang | Panjang | Format | Deskripsi |
|---|---|---|---|---|
| 0–9 | FrameHead | 10 | char | Tetap: 0xAA 0xAA 0xAA 0xAA 0xAA 0xAA 0xAA 0xAA 0xAA 0xAA |
2.1.2 Kontrol Parameter
Digunakan untuk menanyakan atau memodifikasi parameter radar.
Format Pesan Umum (32 byte):
| Offset Byte | Bidang | Panjang | Format | Deskripsi |
|---|---|---|---|---|
| 0–3 | FrameHead | 4 | uint | Tetap 0xAA 0xAA 0xAA 0xAA |
| 4 | InfoType | 1 | byte | Tetap 0x0B |
| 5–7 | Reserved | 3 | byte | Default 0x00 |
| 8 | ParameterType | 1 | byte | 1–255 (lihat daftar di bawah) |
| 9 | DeviceType | 1 | byte | Tetap 0x01 |
| 10 | FaceID | 1 | byte | Tetap 0x00 |
| 11 | Checksum | 1 | byte | Jumlah byte 9–24 |
| 12–15 | Reserved | 4 | byte | Default 0x00 |
| 16–19 | Parameter1 | 4 | bervariasi | Tergantung jenis |
| 20–23 | Parameter2 | 4 | bervariasi | Tergantung jenis |
| 24–27 | Parameter3 | 4 | bervariasi | Tergantung jenis |
| 28–31 | Parameter4 | 4 | bervariasi | Tergantung jenis |
Daftar Jenis Parameter:
1 – Kueri Status
- Param1: Jenis perangkat (tetap
0x01) - Param2: Jenis status (0–255, lihat Bagian 2.2.3 Tabel 5-1)
- Param3/4: Default
0
- Param1: Jenis perangkat (tetap
2 – GPS & Orientasi
- Param1: Lintang (float, -90° hingga +90°)
- Param2: Bujur (float, -180° hingga +180°)
- Param3: Ketinggian (float, -500m hingga +10.000m)
- Param4: Arah Azimut (float, 0–360°)
11 – Pengaturan Ambang Batas
- Param1: Ambang Deteksi (float, 11.0–40.0 dB)
- Param2: Ambang Kecepatan Tinggi (float, 1.0–40.0 m/s)
- Param3: Ambang Kecepatan Rendah (float, 0.0–10.0 m/s)
- Param4: Cadangan
20 – Perintah Bingkai Tunggal
- Param1: Header Perintah (0xA5), ID (0x10), Jenis (0x01), Alamat + Data1–4
- Param2: Data5–8
- Param3: ID Bingkai
- Param4: Checksum
21 – Parameter Sektor
- Param1: Sudut Awal (byte, 0–255, unit 1.4063°)
- Param2: Sudut Akhir (byte, 0–255)
22 – Parameter Zona Hening
- Param1–2: Menentukan hingga 4 zona hening sudut (sudut awal/akhir, 0–255)
2.2 Pesan Laporan (Radar → PC)
2.2.1 Data Pelacakan
Radar terus mengirim laporan pelacakan setelah menerima perintah tautan.
Format Data Pelacakan (per paket, ukuran bervariasi):
| Offset Byte | Bidang | Panjang | Format | Deskripsi |
|---|---|---|---|---|
| 0–3 | FrameHead | 4 | uint | Tetap 0xAA 0xAA 0xAA 0xAA |
| 4 | InfoType | 1 | byte | 0x01 |
| 5–6 | Reserved | 2 | byte | / |
| 7 | DeviceType | 1 | byte | Tetap 0x01 |
| 8–9 | TrackCount | 2 | ushort | Jumlah trek (0–999) |
| 10–11 | Reserved | 2 | byte | / |
Lalu, per target (79 byte masing-masing):
| Bidang | Panjang | Format | Deskripsi |
|---|---|---|---|
| Batch ID | 4 | uint | Nomor batch pelacakan |
| Azimuth | 4 | float | 0–360°, ° |
| Range | 4 | float | meter |
| Latitude | 4 | float | -90° hingga +90° |
| Longitude | 4 | float | -180° hingga +180° |
| Radial Velocity | 4 | float | m/s |
| Exist Flag | 2 | byte | 0 = hilang, 1 = ada |
| Elevation | 4 | float | ° |
| Heading | 4 | float | ° |
| Speed | 4 | float | m/s |
| Altitude | 4 | float | m (relatif) |
| Timestamp | 4 | uint | ms sejak awal hari |
| Amplitude | 2 | ushort | 0.1 dB |
| Category | 1 | byte | 0=kapal, 10=pejalan kaki, 20=UAV, 30=mobil, 40=burung, 99=tidak diketahui |
| Noise Amplitude | 2 | ushort | 0.1 dB |
| Reserved | 21 | byte | / |
| Checksum | 1 | byte | Jumlah data segmen |
2.2.2 Paket Detak Jantung
Format (16 byte):
| Offset Byte | Bidang | Panjang | Format | Deskripsi |
|---|---|---|---|---|
| 0–3 | FrameHead | 4 | uint | 0xAA 0xAA 0xAA 0xAA |
| 4 | InfoType | 1 | byte | 0x04 |
| 5–6 | Reserved | 2 | byte | / |
| 7 | DeviceType | 1 | byte | 0x01 |
| 8–9 | Reserved | 2 | ushort | / |
| 10 | AzimuthCode | 1 | byte | 0–255 → 0–360° |
| 11–14 | Timestamp | 4 | uint | ms sejak awal hari |
2.2.3 Data Parameter
Dikembalikan saat status radar diminta.
Format (32 byte):
| Offset Byte | Bidang | Panjang | Format | Deskripsi |
|---|---|---|---|---|
| 0–3 | FrameHead | 4 | uint | 0xAA 0xAA 0xAA 0xAA |
| 4 | InfoType | 1 | byte | 0x03 |
| 5–7 | Reserved | 3 | byte | / |
| 8 | StatusType | 1 | byte | 1–255 |
| 9 | DeviceType | 1 | byte | 0x01 |
| 10 | FaceID | 1 | byte | 0x00 |
| 11 | Checksum | 1 | byte | Jumlah byte 9–24 |
| 12–15 | Reserved | 4 | byte | / |
| 16–19 | Status1 | 4 | bervariasi | Tergantung jenis |
| 20–23 | Status2 | 4 | bervariasi | Tergantung jenis |
| 24–27 | Status3 | 4 | bervariasi | Tergantung jenis |
| 28–31 | Status4 | 4 | bervariasi | Tergantung jenis |
Contoh Jenis Status:
1: Status BIT (kesehatan saluran penerima/pemancar)2: GPS & Orientasi (Lintang, Bujur, Ketinggian, Azimut)3: Parameter kerja (mode, frekuensi, ID muka)11: Ambang batas (nilai dB/m/s)12: ID Firmware (ID perangkat, nomor versi)21: Parameter Sektor (sudut awal/akhir)22: Parameter Zona Hening (definisi multi-zona)
Catatan
- Interval minimum antar perintah kontrol: 100ms.
- Checksum: Dihitung sebagai jumlah byte dari bidang tertentu.
- Sektor & Zona Hening: Hanya berlaku untuk radar pemindaian mekanis.
- Elevasi/Ketinggian: Default ke 0 jika radar tidak memiliki pengukuran ketinggian.