FatahnaLabs Docs MQTT 5.0
Dashboard SCADA Akun & Billing

Panduan Koneksi Broker Fatahna MQTT

FatahnaLabs menyediakan layanan Enterprise MQTT Broker (EMQX Enterprise) berkecepatan tinggi, latensi rendah, serta terintegrasi langsung dengan SCADA GUI Dashboard. Panduan ini merangkum cara menghubungkan perangkat IoT, router mikrotik, dan aplikasi backend Anda.

Parameter Koneksi Broker Utama
Host / Server:
broker.fatahna.id
Protokol Didukung:
MQTT TCP, MQTTS (TLS/SSL), WS, WSS
Kredensial Autentikasi:
Username & Password dari mqtt.fatahnalabs.com
Root Topic Prefix:
<username>/#

Port & Protokol

Protokol Port Enkripsi (SSL/TLS) Rekomendasi Penggunaan
MQTT TCP 1883 Standar (Plaintext) ESP32, ESP8266, MikroTik di jaringan lokal/hemat CPU
MQTTS TLS 8883 TLS / SSL (Port Aman) Perangkat IoT di jaringan publik atau transmisi data sensor sensitif
WSS (WebSocket) 8084 WSS (SSL) Path: /mqtt Dashboard browser web, React, Vue, SCADA Live Dashboard
WS (WebSocket) 8083 WS Path: /mqtt Pengujian internal WebSocket lokal tanpa HTTPS

Hak Akses & Aturan Topik (ACL)

Setiap akun broker di FatahnaLabs memiliki isolasi keamanan (ACL) yang ketat. Klien hanya berhak mem-publish dan men-subscribe topik yang diawali dengan username akun Anda.

Format Topik Wajib: <username>/nama_alat/sensor
Contoh jika username Anda adalah petani_01, topik yang sah adalah: petani_01/greenhouse/suhu atau petani_01/pompa/saklar.

Contoh Kode: ESP32 (Arduino IDE)

Library: PubSubClient

Hubungkan ESP32 ke WiFi dan kirim telemetry data sensor secara berkala ke broker Fatahna MQTT.

ESP32_PubSubClient.ino
#include <WiFi.h>
#include <PubSubClient.h>

// 1. Konfigurasi WiFi
const char* ssid = "NAMA_WIFI_ANDA";
const char* password = "PASSWORD_WIFI";

// 2. Konfigurasi Fatahna MQTT Broker
const char* mqtt_server = "broker.fatahna.id";
const int mqtt_port = 1883;
const char* mqtt_user = "USERNAME_AKUN_ANDA";      // Contoh: user_demo
const char* mqtt_pass = "PASSWORD_AKUN_ANDA";

// 3. Topik (Wajib diawali dengan Username)
const char* topic_telemetry = "USERNAME_AKUN_ANDA/sensor/suhu";

WiFiClient espClient;
PubSubClient client(espClient);
unsigned long lastMsg = 0;

void setup_wifi() {
  delay(10);
  Serial.print("Menghubungkan WiFi: ");
  Serial.println(ssid);
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println("\nWiFi Terhubung! IP: " + WiFi.localIP().toString());
}

void reconnect() {
  while (!client.connected()) {
    Serial.print("Mencoba koneksi ke Fatahna MQTT...");
    String clientId = "ESP32Client-" + String(random(0xffff), HEX);
    if (client.connect(clientId.c_str(), mqtt_user, mqtt_pass)) {
      Serial.println(" Berhasil terhubung!");
      // Subscribe perintah jika diperlukan
      // client.subscribe("USERNAME_AKUN_ANDA/saklar/#");
    } else {
      Serial.print(" Gagal, rc=");
      Serial.print(client.state());
      Serial.println(" Coba lagi dalam 5 detik...");
      delay(5000);
    }
  }
}

void setup() {
  Serial.begin(115200);
  setup_wifi();
  client.setServer(mqtt_server, mqtt_port);
}

void loop() {
  if (!client.connected()) {
    reconnect();
  }
  client.loop();

  // Kirim data setiap 5 detik
  unsigned long now = millis();
  if (now - lastMsg > 5000) {
    lastMsg = now;
    float suhuDummy = 28.5 + (random(0, 50) / 10.0);
    
    // Kirim pesan dalam format JSON atau numeric
    String payload = "{\"suhu\": " + String(suhuDummy, 2) + ", \"kelembapan\": 65.2}";
    client.publish(topic_telemetry, payload.c_str());
    Serial.println("Pesan terkirim ke: " + String(topic_telemetry) + " → " + payload);
  }
}

Contoh Konfigurasi: MikroTik RouterOS v7

RouterOS v7.1+

RouterOS v7 mendukung fitur native MQTT untuk monitoring resource router (CPU, RAM, Voltage, Traffic) langsung ke SCADA.

mikrotik_terminal.rsc
# 1. Tambahkan Broker Fatahna MQTT ke RouterOS
/iot mqtt brokers add name="fatahna-broker" address="broker.fatahna.id" port=1883 \
    username="USERNAME_AKUN_ANDA" password="PASSWORD_AKUN_ANDA" \
    client-id="Mikrotik-RB750Gr3" keepalive=60

# 2. Publish Data Status CPU & RAM via CLI Script MikroTik
/iot mqtt publish broker="fatahna-broker" \
    topic="USERNAME_AKUN_ANDA/router/telemetry" \
    message="{\"cpu_load\": $[/system resource get cpu-load], \"free_ram_mb\": ($[/system resource get free-memory] / 1048576)}"

# 3. Jadwalkan Pengiriman Otomatis via Scheduler (Setiap 10 Detik)
/system scheduler add name="mqtt-heartbeat" interval=10s on-event={
    :local cpu [/system resource get cpu-load];
    :local ram ([/system resource get free-memory] / 1048576);
    /iot mqtt publish broker="fatahna-broker" topic="USERNAME_AKUN_ANDA/router/telemetry" message="{\"cpu\": $cpu, \"ram\": $ram}"
}

Contoh Kode: PHP Backend

php-mqtt/client

Kirim perintah saklar atau baca antrean sensor dari script web/backend PHP.

publish_sensor.php
<?php
require __DIR__ . '/vendor/autoload.php';

use PhpMqtt\Client\MqttClient;
use PhpMqtt\Client\ConnectionSettings;

$server   = 'broker.fatahna.id';
$port     = 1883;
$clientId = 'PHP_Publisher_' . uniqid();
$username = 'USERNAME_AKUN_ANDA';
$password = 'PASSWORD_AKUN_ANDA';

$mqtt = new MqttClient($server, $port, $clientId);

$connectionSettings = (new ConnectionSettings)
    ->setUsername($username)
    ->setPassword($password)
    ->setKeepAliveInterval(60);

$mqtt->connect($connectionSettings, true);

// Publish Perintah Saklar ON
$topic = "{$username}/pompa/saklar";
$payload = json_encode(['status' => 'ON', 'power' => 100]);
$mqtt->publish($topic, $payload, 0);

echo "Berhasil mengirim pesan ke topik: {$topic}\n";
$mqtt->disconnect();

Contoh Kode: Python

paho-mqtt

Instalasi library: pip install paho-mqtt

mqtt_client.py
import time
import json
import paho.mqtt.client as mqtt

BROKER = "broker.fatahna.id"
PORT = 1883
USERNAME = "USERNAME_AKUN_ANDA"
PASSWORD = "PASSWORD_AKUN_ANDA"
TOPIC = f"{USERNAME}/raspberry/sensor"

def on_connect(client, userdata, flags, rc):
    if rc == 0:
        print("[OK] Terhubung ke Fatahna MQTT Broker!")
    else:
        print(f"[FAIL] Gagal konek, error code: {rc}")

client = mqtt.Client(client_id="PythonAppClient")
client.username_pw_set(USERNAME, PASSWORD)
client.on_connect = on_connect

client.connect(BROKER, PORT, keepalive=60)
client.loop_start()

try:
    while True:
        data = {"suhu": 31.2, "status": "ONLINE", "timestamp": int(time.time())}
        client.publish(TOPIC, json.dumps(data))
        print(f"Pesan terkirim ke {TOPIC}: {data}")
        time.sleep(3)
except KeyboardInterrupt:
    client.loop_stop()
    client.disconnect()