233 lines
5.2 KiB
Markdown
233 lines
5.2 KiB
Markdown
# MQTT Integration Guide
|
|
|
|
## Arsitektur
|
|
|
|
```
|
|
ESP32 (Publisher)
|
|
│
|
|
│ MQTT Publish (broker.hivemq.com:1883)
|
|
▼
|
|
HiveMQ Broker
|
|
│
|
|
│ MQTT Subscribe → HTTP Forward
|
|
▼
|
|
MQTT Bridge (Node-RED / Python / MQTTx Webhook)
|
|
│
|
|
│ HTTP POST /api/mqtt/ingest
|
|
▼
|
|
Laravel Backend → Database
|
|
```
|
|
|
|
Karena PHP/Laravel tidak bisa subscribe MQTT secara native, kita butuh **MQTT Bridge** yang:
|
|
1. Subscribe ke topic di HiveMQ
|
|
2. Forward setiap pesan ke endpoint `/api/mqtt/ingest`
|
|
|
|
---
|
|
|
|
## Endpoint Backend
|
|
|
|
### 1. Terima data dari MQTT Bridge
|
|
```
|
|
POST /api/mqtt/ingest
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"topic": "keamanan/pir",
|
|
"payload": "{\"device_id\":1,\"node\":\"NODE_001\",\"type\":\"PIR\",\"motion\":true}"
|
|
}
|
|
```
|
|
|
|
### 2. Terima batch data
|
|
```
|
|
POST /api/mqtt/ingest-batch
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"messages": [
|
|
{"topic": "keamanan/pir", "payload": "{...}"},
|
|
{"topic": "keamanan/vibration", "payload": "{...}"}
|
|
]
|
|
}
|
|
```
|
|
|
|
### 3. Publish command ke ESP32
|
|
```
|
|
POST /api/mqtt/command
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"node_id": "NODE_001",
|
|
"command": "REBOOT",
|
|
"params": {}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Cara Setup MQTT Bridge
|
|
|
|
### Opsi A: Node-RED (Paling Mudah)
|
|
|
|
1. Install Node-RED: `npm install -g node-red`
|
|
2. Buka `http://localhost:1880`
|
|
3. Tambah node: **mqtt in** → **function** → **http request**
|
|
|
|
Node **mqtt in**:
|
|
- Server: `broker.hivemq.com:1883`
|
|
- Topic: `keamanan/#` (subscribe semua topic keamanan)
|
|
|
|
Node **function** (transform payload):
|
|
```javascript
|
|
msg.url = "https://keamanan-rak-barang-production.up.railway.app/api/mqtt/ingest";
|
|
msg.method = "POST";
|
|
msg.headers = { "Content-Type": "application/json" };
|
|
msg.payload = JSON.stringify({
|
|
topic: msg.topic,
|
|
payload: typeof msg.payload === 'string' ? msg.payload : JSON.stringify(msg.payload)
|
|
});
|
|
return msg;
|
|
```
|
|
|
|
Node **http request**:
|
|
- Method: POST
|
|
- URL: (dari msg.url)
|
|
|
|
---
|
|
|
|
### Opsi B: Python Script (Ringan, bisa di-deploy di server)
|
|
|
|
```python
|
|
# mqtt_bridge.py
|
|
import paho.mqtt.client as mqtt
|
|
import requests
|
|
import json
|
|
|
|
BACKEND_URL = "https://keamanan-rak-barang-production.up.railway.app/api/mqtt/ingest"
|
|
BROKER = "broker.hivemq.com"
|
|
PORT = 1883
|
|
TOPICS = [
|
|
"keamanan/pir",
|
|
"keamanan/reed",
|
|
"keamanan/vibration",
|
|
"keamanan/heartbeat",
|
|
]
|
|
|
|
def on_connect(client, userdata, flags, rc):
|
|
print(f"Connected to MQTT broker, rc={rc}")
|
|
for topic in TOPICS:
|
|
client.subscribe(topic)
|
|
print(f"Subscribed to: {topic}")
|
|
|
|
def on_message(client, userdata, msg):
|
|
topic = msg.topic
|
|
payload = msg.payload.decode("utf-8")
|
|
print(f"[{topic}] {payload}")
|
|
|
|
try:
|
|
response = requests.post(BACKEND_URL, json={
|
|
"topic": topic,
|
|
"payload": payload
|
|
}, timeout=10)
|
|
print(f" → Backend: {response.status_code}")
|
|
except Exception as e:
|
|
print(f" → Error: {e}")
|
|
|
|
client = mqtt.Client(client_id=f"bridge-{__import__('random').randint(1000,9999)}")
|
|
client.on_connect = on_connect
|
|
client.on_message = on_message
|
|
|
|
client.connect(BROKER, PORT, 60)
|
|
client.loop_forever()
|
|
```
|
|
|
|
Install dependency: `pip install paho-mqtt requests`
|
|
Jalankan: `python mqtt_bridge.py`
|
|
|
|
---
|
|
|
|
### Opsi C: MQTTx CLI (Untuk Testing)
|
|
|
|
MQTTx bisa subscribe dan forward ke webhook. Atau gunakan untuk test manual:
|
|
|
|
```bash
|
|
# Subscribe dan lihat pesan
|
|
mqttx sub -h broker.hivemq.com -p 1883 -t "keamanan/#" -v
|
|
|
|
# Publish test (simulasi ESP32)
|
|
mqttx pub -h broker.hivemq.com -p 1883 \
|
|
-t "keamanan/pir" \
|
|
-m '{"device_id":1,"node":"NODE_001","type":"PIR","motion":true}'
|
|
```
|
|
|
|
---
|
|
|
|
## Format Payload dari ESP32
|
|
|
|
ESP32 mengirim dua format tergantung dari mana datanya:
|
|
|
|
### Format 1: buildPayload (MQTT publish dari ESP32)
|
|
```json
|
|
{
|
|
"device_id": 1,
|
|
"node": "NODE_001",
|
|
"type": "PIR",
|
|
"motion": true
|
|
}
|
|
```
|
|
|
|
### Format 2: Raw LoRa JSON (dikirim langsung via HTTP)
|
|
```json
|
|
{
|
|
"node_id": "NODE_001",
|
|
"gateway_id": "GATEWAY_001",
|
|
"type": "PIR",
|
|
"motion_detected": true,
|
|
"device_id": 1
|
|
}
|
|
```
|
|
|
|
Backend mendukung **kedua format** ini secara otomatis.
|
|
|
|
---
|
|
|
|
## Topic Mapping
|
|
|
|
| Topic MQTT | Tipe Sensor | Endpoint HTTP Alternatif |
|
|
|---------------------|-------------|--------------------------|
|
|
| `keamanan/pir` | PIR | `POST /api/pir/data` |
|
|
| `keamanan/reed` | Reed Switch | `POST /api/door-access/data` |
|
|
| `keamanan/vibration`| Vibration | `POST /api/vibration/data` |
|
|
| `keamanan/heartbeat`| Heartbeat | `POST /api/lora/receive` |
|
|
|
|
---
|
|
|
|
## Troubleshooting: Data Tidak Masuk Database
|
|
|
|
### Cek 1: Device ada di database?
|
|
```sql
|
|
SELECT id, name, device_id, is_active FROM devices;
|
|
```
|
|
Jika kosong, jalankan seeder:
|
|
```bash
|
|
php artisan db:seed --class=DeviceSeeder
|
|
```
|
|
|
|
### Cek 2: Test endpoint langsung
|
|
```bash
|
|
curl -X POST https://keamanan-rak-barang-production.up.railway.app/api/pir/data \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"device_id":1,"motion_detected":true}'
|
|
```
|
|
|
|
### Cek 3: Test MQTT ingest
|
|
```bash
|
|
curl -X POST https://keamanan-rak-barang-production.up.railway.app/api/mqtt/ingest \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"topic":"keamanan/pir","payload":"{\"device_id\":1,\"node\":\"NODE_001\",\"type\":\"PIR\",\"motion\":true}"}'
|
|
```
|
|
|
|
### Cek 4: Lihat Laravel logs
|
|
```bash
|
|
tail -f storage/logs/laravel.log
|
|
```
|