Barrier Gate atau Palang Parkir: Integrasi SDK & API Open Gate

Dalam pengembangan sistem parkir modern—seperti Automatic Number Plate Recognition (ANPR), RFID, QR Code, atau tiket berbasis cloud—integrasi antara perangkat lunak dengan perangkat keras palang parkir (barrier gate) seringkali menjadi tantangan tersendiri.

Techdock M Gate (Powered by MSM Parking) hadir sebagai jembatan solusi yang menyederhanakan integrasi tersebut. Melalui Open Gate SDK & API, developer pihak ketiga dapat membuka palang parkir hanya dengan satu perintah logis, tanpa perlu lagi berurusan dengan komunikasi serial raw, pengaturan timing mikro-detik, atau manajemen port COM yang rumit.

Artikel ini akan membahas bagaimana cara kerja, arsitektur, dan panduan integrasi SDK serta API untuk barrier gate menggunakan Techdock.

1. Konsep Utama: Abstraksi Perangkat Keras

Masalah umum dalam integrasi barrier gate adalah developer harus mengirimkan perintah byte-level serial ke relay dan mengatur durasi pulse secara manual.

Techdock mengubah paradigma ini. Alih-alih memanipulasi perintah relay ON/OFF secara langsung, Techdock mengekspos operasi logis OpenGate(). Sistem ini meniru gaya trigger dry-contact (seperti tombol tekan fisik) dengan durasi default 800 ms.

Penting Trigger release (pelepasan trigger) tidak diartikan sebagai perintah fisik “tutup palang”. Melepaskan trigger hanya berarti menyelesaikan permintaan OPEN sesaat (momentary). Perilaku penutupan fisik palang tetap dikendalikan oleh controller bawaan palang, loop detector, atau sensor keamanan di lapangan.

2. Arsitektur Sistem

Techdock mengisolasi aplikasi pihak ketiga dari kompleksitas hardware. Alur kerjanya adalah sebagai berikut

Aplikasi Pihak Ketiga ➔ Techdock SDK / Local REST API ➔ Techdock M Gate Core ➔ CH34x USB Serial (COM Port) ➔ Barrier Gate Controller

Dengan arsitektur ini, aplikasi Anda cukup memanggil API/SDK, dan Techdock yang akan menangani

• Pembukaan dan penggunaan ulang koneksi serial.
• Konversi ke protokol serial (9600 baud, 8N1).
• Penentuan waktu (timing) assert dan release (800 ms).
• Logika reconnection jika perangkat sempat disconnect.

3. Integrasi via REST API

Untuk integrasi lintas bahasa pemrograman (PHP, Python, Node.js, Java, dll), Techdock menyediakan Local REST API.

Endpoint Utama

http1: POST http://127.0.0.1:8787/api/v1/mgate/open

Tidak memerlukan request body untuk perangkat lokal yang sudah dikonfigurasi.

Contoh Respons JSON Sukses

json {
 "success": true,
 "device": "M Gate",
 "action": "OPEN_GATE",
 "port": "COM4",
 "pulse_ms": 800,
 "status": "GATE_TRIGGERED"
}

Contoh Pemanggilan (Python)

python: import requests
response = requests.post("http://127.0.0.1:8787/api/v1/mgate/open", timeout=3)
print(response.json())

4. Integrasi via C# SDK

Bagi pengembang yang menggunakan ekosistem.NET / C#, Techdock menyediakan SDK yang sangat mudah diimplementasikan.

using Techdock.MGate.SDK;

var gate = new MGateClient();
gate.Port = “AUTO”; // Atau tentukan COM Port secara eksplisit, misal “COM4”
gate.PulseMilliseconds = 800;

var result = gate.OpenGate();

if (!result.Success) {
Console.WriteLine($”Gagal membuka gate: {result.Message}”);
}

Catatan: Untuk deployment produksi dengan banyak perangkat serial, sangat disarankan untuk memvalidasi dan memilih COM Port secara eksplisit daripada menggunakan mode AUTO.

5. Workflow Rekomendasi

Agar sistem parkir Anda berjalan optimal dan aman, ikuti alur kerja berikut

1. Validasi Bisnis Aplikasi Anda memverifikasi izin akses (Tiket valid, plat nomor terdaftar, member aktif, dll).
2. Panggil OpenGate Aplikasi mengirim permintaan ke Techdock API/SDK.
3. Eksekusi Hardware Techdock memvalidasi antarmuka, mengirim trigger (A0 01 01 A2), menahan selama 800 ms, lalu melepasnya (A0 01 00 A1).
4. Pencatatan Aplikasi Anda mencatat hasil transaksi (Sukses/Gagal) ke dalam database log.

6. Keamanan dan Keselamatan (Sangat Penting)

Mengingat API ini mengontrol akses fisik, ada beberapa aturan baku yang wajib diperhatikan oleh System Integrator

🔒 Keamanan Siber

• Bind ke Localhost Secara default, API harus di-bind ke 127.0.0.1. Jangan pernah mengekspose endpoint OpenGate langsung ke internet publik.
• Akses LAN Jika diperlukan akses dari jaringan lokal (LAN), gunakan autentikasi/API Key, IP allowlisting, dan firewall.
• Log & Rate Limiting Selalu catat caller, timestamp, dan hasil transaksi. Terapkan proteksi duplicate-request agar palang tidak terbuka berkali-kali karena kesalahan retry dari aplikasi.

🛑 Keselamatan Operasional

• Jangan Bypass Sensor Fisik Integrasi SDK/API tidak boleh mem-bypass fitur keamanan bawaan barrier gate seperti vehicle loop detector, photocell, atau sistem anti-crush.
• Deteksi Perangkat Pasif Fitur device detection (/detect) harus bersifat pasif. Jangan pernah mengirimkan perintah OPEN saat sistem sedang melakukan scanning port COM.

7. Penanganan Error (Error Handling)

Aplikasi pihak ketiga harus siap menghadapi kondisi berikut

• DEVICE_NOT_FOUND Tidak ada COM port yang terdeteksi. Jangan memaksakan membuka gate.
• PORT_BUSY Port serial sedang digunakan. Berikan jeda dan lakukan retry terkontrol.
• TRIGGER_FAILED Write timeout. Jangan berasumsi palang sudah terbuka; berikan notifikasi error kepada operator.

Kesimpulan

Techdock M Gate Open Gate SDK & API adalah standar integrasi yang direkomendasikan untuk vendor perangkat lunak parkir. Dengan memisahkan logika bisnis (validasi tiket/ANPR) dari logika perangkat keras (komunikasi serial), developer dapat fokus menciptakan pengalaman user yang mulus, aman, dan andal.

Powered by MSM Parking
Professional parking system integration and barrier gate technology.
🌐 msmparking.com