FatahnaLabs Docs

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
Host / Server: broker.fatahna.id
Port Standar (TCP): 1883 (Tanpa Enkripsi / Plaintext)
Port Aman (TLS / MQTTS): 8883 (Enkripsi SSL/TLS)
Port WebSocket (WSS): 8084 (Path: /mqtt)
Aturan Topik (ACL): Semua topik wajib diawali dengan nama akun username Anda: <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
Terminal / Shell
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.

publish_mqtt.php
<?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)
subscribe_listener.php
<?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
  1. Tarik node mqtt out ke canvas flow Node-RED Anda.
  2. Klik ganda node tersebut, lalu pada kolom Server pilih Add new mqtt-broker... (ikon pensil).
  3. Pada tab Connection:
    • Server: broker.fatahna.id
    • Port: 1883
  4. Pada tab Security:
    • Username: Masukkan username akun MQTT Fatahna Anda
    • Password: Masukkan password akun MQTT Fatahna Anda
  5. Klik Add dan Done.
2Contoh Kirim Data: Single Value vs Multi Data (JSON)
  • Single Value: Masukkan nilai langsung (misal: angka 28.5 atau string ON) pada msg.payload menuju topik USERNAME/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.

fatahna_nodered_flow.json (Klik tombol Copy Flow JSON)
[
  {
    "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):

MikroTik Terminal / WinBox CLI
# 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.

System -> Scripts -> fatahna-telemetry
# ====================================================================
# 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):

MikroTik Terminal
# 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"