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
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.
<username>/nama_alat/sensorContoh 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: PubSubClientHubungkan ESP32 ke WiFi dan kirim telemetry data sensor secara berkala ke broker Fatahna MQTT.
#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.
# 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/clientKirim perintah saklar atau baca antrean sensor dari script web/backend 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-mqttInstalasi library: pip install paho-mqtt
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()