🐧 e-QSO ORARI Linux Appliance

Apa itu Linux Appliance?

e-QSO ORARI Linux Appliance v4.1.5 adalah versi gateway yang berjalan di berbagai perangkat Linux — dari STB Android TV Box bekas hingga Raspberry Pi dan PC/Server.

1. Hardware yang Diperlukan

2. Persiapan OS

3. Instalasi — Satu Perintah

Download dan jalankan installer di terminal SSH:

curl https://orari.id/repo/installer.sh > /tmp/installer.sh
bash /tmp/installer.sh

Installer akan otomatis:

1. ✅ Deteksi arsitektur (ARM64 / x86_64) dan distro Linux
2. ✅ Install dependensi (Nginx, PHP, libsodium, libopus, Qt5, alsa-utils)
3. ✅ Auto-detect versi PHP (support PHP 8.1 s/d 8.4)
4. ✅ Download binary e-QSO ORARI v4.1.5
5. ✅ Verifikasi integritas (SHA256)
6. ✅ Setup Nginx + PHP-FPM (dengan SSE pool terpisah)
7. ✅ Setup systemd service (journal logging + DNS wait)
8. ✅ Setup permission journald untuk Web UI
9. ✅ Start appliance

4. Setelah Instalasi — Akses Web UI

Buka browser dari smartphone atau PC di jaringan yang sama:

http://<IP-ADDRESS-STB>

Jika lupa IP address:

hostname -I

Di Web UI, lakukan:

1. Register — daftarkan gateway baru (jika belum punya akun)
2. Login — dengan callsign gateway (YH...)
3. Settings — konfigurasi audio device dan serial PTT

5. Mengenal Web UI

6. Arduino Nano — Sketch COS/PTT Controller

Arduino Nano berfungsi sebagai interface antara sinyal radio (COS/PTT) dan appliance Linux via USB Serial.

// ============================================================
// e-QSO ORARI Linux Appliance — Arduino Sketch
// Versi: 2.1
// Developer: YB8RSE - OM FRANKIE

const int COS_PIN = 2;      // COS normal
const int COS_INV_PIN = 4;  // COS terbalik (LOW = aktif)
const int PTT_PIN = 13;

void setup() {
    Serial.begin(9600);
    pinMode(COS_PIN, INPUT);
    pinMode(COS_INV_PIN, INPUT);
    pinMode(PTT_PIN, OUTPUT);
    digitalWrite(PTT_PIN, LOW);
    Serial.println("ARDUINO:READY");
    delay(2000);
}

void loop() {
    int readingD2 = digitalRead(COS_PIN);
    int readingD4 = digitalRead(COS_INV_PIN);

    static bool lastD2 = HIGH, lastD4 = LOW;
    
    // D2: HIGH = COS aktif
    if (readingD2 != lastD2) {
        lastD2 = readingD2;
        bool cosActive = (readingD2 == HIGH);
        Serial.print("COS:");
        Serial.println(cosActive ? "1" : "0");
    }

    // D4: LOW = COS aktif (invert)
    if (readingD4 != lastD4) {
        lastD4 = readingD4;
        bool cosActive = (readingD4 == LOW);
        Serial.print("COS:");
        Serial.println(cosActive ? "1" : "0");
    }

    if (Serial.available()) {
        String cmd = Serial.readStringUntil('\n');
        cmd.trim();
        if (cmd == "PTT:1") digitalWrite(PTT_PIN, HIGH);
        if (cmd == "PTT:0") digitalWrite(PTT_PIN, LOW);
        if (cmd == "PING") Serial.println("PONG");
    }

    delay(10);
}

7. Keamanan TX — Hardware Only

Proteksi berlapis memastikan TX hanya dari sinyal COS radio fisik:

• 🔒 Layer 1: Tidak ada tombol PTT di Web UI
• 🔒 Layer 2: API endpoint TX mengembalikan HTTP 403
• 🔒 Layer 3: C++ binary tidak memiliki handler TX manual
• 🔒 Layer 4: TX Watchdog — otomatis TX_STOP setelah 3 menit
• 🔒 Layer 5: PTT OFF otomatis saat koneksi terputus

8. Troubleshooting

Perintah Berguna

# Lihat log appliance realtime
journalctl -u eqso-appliance -f

# Lihat 50 baris log terakhir
journalctl -u eqso-appliance -n 50 --no-pager

# Restart service
systemctl restart eqso-appliance

# Cek status
systemctl status eqso-appliance

# Cek audio devices
aplay -l && arecord -l

# Cek serial/Arduino
ls /dev/ttyUSB*

# Cek IP address
hostname -I

Spesifikasi Teknis