Panduan Penggunaan Broker MQTT FatahnaLabs
Dokumentasi ini menyediakan panduan integrasi pengiriman dan penerimaan data ke broker MQTT FatahnaLabs menggunakan PHP, Node-RED, dan MikroTik RouterOS v7.
Parameter Koneksi Broker
/mqtt)
<username>/#.Contoh: jika username Anda adalah
kantor_utama, maka topik yang sah: kantor_utama/router/telemetry atau kantor_utama/sensor/suhu.
1. Panduan Koneksi PHP (Backend / Script)
Integrasi PHP menggunakan pustaka standar industri php-mqtt/client yang stabil dan mendukung protokol MQTT 3.1, 3.1.1, dan 5.0.
1Instalasi Library via Composer
composer require php-mqtt/client
2Script Publish Data (Single Value & JSON Multi Data)
Contoh script PHP lengkap untuk menghubungkan ke broker.fatahna.id dan mengirim data tunggal serta data format JSON.
<?php
require __DIR__ . '/vendor/autoload.php';
use PhpMqtt\Client\MqttClient;
use PhpMqtt\Client\ConnectionSettings;
// 1. Parameter Koneksi Broker FatahnaLabs
$server = 'broker.fatahna.id';
$port = 1883; // Port 1883 untuk TCP standar
$clientId = 'PHP_Client_' . uniqid();
$username = 'USERNAME_AKUN_ANDA'; // Ganti dengan username MQTT Anda
$password = 'PASSWORD_AKUN_ANDA'; // Ganti dengan password MQTT Anda
// 2. Inisialisasi Klien MQTT
$mqtt = new MqttClient($server, $port, $clientId);
$settings = (new ConnectionSettings)
->setUsername($username)
->setPassword($password)
->setKeepAliveInterval(60)
->setConnectTimeout(10)
->setUseTls(false); // Set true jika menggunakan port 8883 (MQTTS)
try {
// 3. Hubungkan ke Broker
$mqtt->connect($settings, true);
echo "[OK] Berhasil terhubung ke broker.fatahna.id\n";
// A. CONTOH 1: Publish Single Data (Angka/String Sederhana)
$singleTopic = "{$username}/mesin/kecepatan";
$singleValue = "1450"; // Contoh angka RPM
$mqtt->publish($singleTopic, $singleValue, 0);
echo "[PUBLISH SINGLE] Topik: {$singleTopic} → {$singleValue}\n";
// B. CONTOH 2: Publish Multi Data dalam Format JSON
$jsonTopic = "{$username}/sensor/ruangan";
$payloadData = [
'suhu' => 28.75,
'kelembapan' => 64.2,
'tegangan' => 220.5,
'status' => 'NORMAL',
'updated_at' => date('Y-m-d H:i:s')
];
$jsonPayload = json_encode($payloadData);
$mqtt->publish($jsonTopic, $jsonPayload, 0);
echo "[PUBLISH JSON] Topik: {$jsonTopic} → {$jsonPayload}\n";
// 4. Putuskan Koneksi Bersih
$mqtt->disconnect();
echo "[OK] Koneksi selesai dan diputuskan rapi.\n";
} catch (\Throwable $e) {
echo "[ERROR] Gagal koneksi atau publish: " . $e->getMessage() . "\n";
}
3Script Subscribe / Mendengarkan Pesan Masuk (Listener)
<?php
require __DIR__ . '/vendor/autoload.php';
use PhpMqtt\Client\MqttClient;
use PhpMqtt\Client\ConnectionSettings;
$server = 'broker.fatahna.id';
$port = 1883;
$clientId = 'PHP_Listener_' . uniqid();
$username = 'USERNAME_AKUN_ANDA';
$password = 'PASSWORD_AKUN_ANDA';
$mqtt = new MqttClient($server, $port, $clientId);
$settings = (new ConnectionSettings)->setUsername($username)->setPassword($password);
$mqtt->connect($settings, true);
echo "[LISTENING] Menunggu data masuk di topik: {$username}/#\n";
// Subscribe seluruh sub-topik akun Anda
$mqtt->subscribe("{$username}/#", function ($topic, $message) {
echo sprintf("[%s] Pesan diterima di '%s': %s\n", date('H:i:s'), $topic, $message);
}, 0);
// Jalankan loop listener
$mqtt->loop(true);
2. Panduan Penggunaan di Node-RED
Node-RED memungkinkan pengiriman telemetry, otomasi industri, dan integrasi IoT secara visual berbasis drag-and-drop flow.
1Konfigurasi Node MQTT Broker di Node-RED
- Tarik node mqtt out ke canvas flow Node-RED Anda.
- Klik ganda node tersebut, lalu pada kolom Server pilih Add new mqtt-broker... (ikon pensil).
- Pada tab Connection:
- Server:
broker.fatahna.id - Port:
1883
- Server:
- Pada tab Security:
- Username: Masukkan username akun MQTT Fatahna Anda
- Password: Masukkan password akun MQTT Fatahna Anda
- Klik Add dan Done.
2Contoh Kirim Data: Single Value vs Multi Data (JSON)
- Single Value: Masukkan nilai langsung (misal: angka
28.5atau stringON) padamsg.payloadmenuju topikUSERNAME/pompa/saklar. - JSON Multi Data: Gunakan Function node dengan payload objek JavaScript:
msg.payload = { suhu: 28.5, kelembapan: 62.0, tegangan: 220, status: "RUNNING" }; return msg;
3File Flow JSON Siap Import ke Node-RED
Salin (*copy*) kode JSON berikut, lalu buka Node-RED Anda: klik menu pojok kanan atas → Import → tempel (*paste*) kode di bawah → klik Import.
[
{
"id": "fatahna_tab",
"type": "tab",
"label": "Fatahna MQTT Demo",
"disabled": false,
"info": "Demo pengiriman data single dan JSON ke broker.fatahna.id"
},
{
"id": "fatahna_broker",
"type": "mqtt-broker",
"name": "Fatahna Broker",
"broker": "broker.fatahna.id",
"port": "1883",
"clientid": "",
"autoConnect": true,
"usetls": false,
"protocolVersion": "4",
"keepalive": "60",
"cleansession": true
},
{
"id": "inject_single",
"type": "inject",
"z": "fatahna_tab",
"name": "Trigger Single Data (Angka 28.5)",
"props": [
{
"p": "payload"
}
],
"repeat": "",
"crontab": "",
"once": false,
"payload": "28.5",
"payloadType": "num",
"x": 210,
"y": 120,
"wires": [
[
"mqtt_out_single"
]
]
},
{
"id": "mqtt_out_single",
"type": "mqtt out",
"z": "fatahna_tab",
"name": "Publish Single Data",
"topic": "USERNAME_AKUN_ANDA/sensor/suhu",
"qos": "0",
"retain": "false",
"broker": "fatahna_broker",
"x": 510,
"y": 120,
"wires": []
},
{
"id": "inject_timer_json",
"type": "inject",
"z": "fatahna_tab",
"name": "Trigger Otomatis Tiap 5 Detik",
"props": [
{
"p": "payload"
}
],
"repeat": "5",
"crontab": "",
"once": true,
"onceDelay": "1",
"payload": "",
"payloadType": "date",
"x": 200,
"y": 240,
"wires": [
[
"func_build_json"
]
]
},
{
"id": "func_build_json",
"type": "function",
"z": "fatahna_tab",
"name": "Susun Payload JSON Multi Field",
"func": "// Contoh simulasi data sensor telemetri multi field\nmsg.payload = {\n temperature: parseFloat((25 + Math.random() * 8).toFixed(2)),\n humidity: parseFloat((55 + Math.random() * 20).toFixed(2)),\n voltage: 220,\n status: \"RUNNING\",\n timestamp: new Date().toISOString()\n};\nreturn msg;",
"outputs": 1,
"x": 480,
"y": 240,
"wires": [
[
"mqtt_out_json",
"debug_monitor"
]
]
},
{
"id": "mqtt_out_json",
"type": "mqtt out",
"z": "fatahna_tab",
"name": "Publish Multi JSON",
"topic": "USERNAME_AKUN_ANDA/sensor/telemetry",
"qos": "0",
"retain": "false",
"broker": "fatahna_broker",
"x": 760,
"y": 220,
"wires": []
},
{
"id": "debug_monitor",
"type": "debug",
"z": "fatahna_tab",
"name": "Debug Output",
"active": true,
"tosidebar": true,
"console": false,
"complete": "payload",
"x": 740,
"y": 280,
"wires": []
}
]
3. Panduan Penggunaan di MikroTik RouterOS v7
RouterOS v7 dilengkapi paket native iot yang mendukung protokol MQTT. Fitur ini memungkinkan router mempublikasikan status performa hardware (CPU, RAM) dan traffic port ethernet secara real-time langsung ke broker MQTT.
1Setting Broker MQTT di MikroTik
Jalankan perintah ini di New Terminal MikroTik Anda (atau via menu WinBox: IoT → MQTT → Brokers → Add):
# Menambahkan broker Fatahna MQTT ke RouterOS v7
# Catatan: parameter keep-alive menggunakan tanda strip (-), atau gunakan auto-connect=yes
/iot mqtt brokers add name="fatahna-broker" address="broker.fatahna.id" port=1883 \
username="USERNAME_AKUN_ANDA" password="PASSWORD_AKUN_ANDA" \
client-id="MikroTik-Router" auto-connect=yes keep-alive=60
2Script Telemetry: Monitoring ether1 s/d ether7, CPU & RAM
Script ini secara otomatis membaca status ether1 hingga ether7 (status up/running, rx MB, tx MB, link-downs), serta penggunaan CPU Load (%) dan Free RAM (MB), lalu membungkusnya ke dalam satu format JSON yang ringkas dan mempublikasikannya ke broker.
# ====================================================================
# SCRIPT TELEMETRI MIKROTIK KE BROKER.FATAHNA.ID
# Pasang di menu: /system script add name=fatahna-telemetry source=...
# ====================================================================
:local username "USERNAME_AKUN_ANDA"
:local topic ($username . "/mikrotik/telemetry")
# 1. Ambil Data Resource Hardware
:local cpu [/system resource get cpu-load]
:local freeMem ([/system resource get free-memory] / 1048576)
:local totalMem ([/system resource get total-memory] / 1048576)
:local uptime [/system resource get uptime]
:local board [/system resource get board-name]
# 2. Ambil Status & Traffic Seluruh Ethernet (ether1 s/d ether7)
:local ethJson ""
:for i from=1 to=7 do={
:local ifaceName ("ether" . $i)
:local ifaceId [/interface find where name=$ifaceName]
:if ([:len $ifaceId] > 0) do={
:local isRunning [/interface get $ifaceId running]
:local rxBytes [/interface get $ifaceId rx-byte]
:local txBytes [/interface get $ifaceId tx-byte]
:local linkDowns [/interface get $ifaceId link-downs]
# Konversi ke Megabyte (MB) dengan pembagian 1048576
:local rxMB ($rxBytes / 1048576)
:local txMB ($txBytes / 1048576)
:local runStr "false"
:if ($isRunning = true) do={ :set runStr "true" }
:local item ("\"" . $ifaceName . "\":{\"running\":" . $runStr . ",\"rx_mb\":" . $rxMB . ",\"tx_mb\":" . $txMB . ",\"link_downs\":" . $linkDowns . "}")
:if ($ethJson = "") do={
:set ethJson $item
} else={
:set ethJson ($ethJson . "," . $item)
}
}
}
# 3. Susun Full Payload JSON
:local payload ("{\"board\":\"" . $board . "\",\"cpu\":" . $cpu . ",\"free_ram_mb\":" . $freeMem . ",\"total_ram_mb\":" . $totalMem . ",\"uptime\":\"" . $uptime . "\",\"ethernets\":{" . $ethJson . "}}")
# 4. Kirim Data ke Fatahna Broker
/iot mqtt publish broker="fatahna-broker" topic=$topic message=$payload
3Menjadwalkan Pengiriman Otomatis via Scheduler
Jalankan perintah ini di Terminal MikroTik agar script telemetry di atas dieksekusi berkala secara otomatis (misal setiap 10 detik):
# Menjalankan script fatahna-telemetry setiap 10 detik
/system scheduler add name="fatahna-scheduler" interval=10s start-time=startup \
on-event="/system script run fatahna-telemetry"