Kalau anda menggunakan Radiosonde Auto-RX bersama KA9Q dan Airspy Mini, proses update sepatutnya dibuat dengan berhati-hati. Update Docker secara generik boleh menyebabkan sistem yang sebelum ini stabil tiba-tiba hilang spectrum, gagal scan, atau memaparkan error seperti:

ka9q powers call failed with return code 124
SDR produced no output

Dalam pengalaman setup ini, masalah tersebut bukan berpunca daripada Airspy Mini yang rosak. Airspy masih boleh dikesan, ditune dan melakukan direct IQ capture dengan baik. Punca sebenar lebih kepada kombinasi container Auto-RX, mount KA9Q, versi software dan konfigurasi yang berubah selepas update.

Objektif Panduan Ini

Kita akan bina satu Safe Update Script yang melakukan semuanya secara automatik:

· Backup fail station.cfg sebelum update.

· Simpan Docker image lama sebagai rollback image.

· Pull image Auto-RX terbaru.

· Recreate container dengan mount DBus dan Avahi yang diperlukan KA9Q.

· Buat health check selepas update.

· Rollback secara automatik jika scanner menunjukkan error utama.

Nota penting: Panduan ini ditulis untuk setup KA9Q + Airspy Mini. Jika anda menggunakan RTL-SDR biasa tanpa KA9Q, command Docker mungkin berbeza.

Golden Configuration Yang Sudah Stabil

Untuk setup yang sudah pulih dan stabil, konfigurasi rujukan ialah:

SDR        : Airspy Mini
KA9Q       : sonde.local
Auto-RX    : Docker
Docker tag : testing
KA9Q freq : 405.6 MHz
Scan range : 400.05 - 405.0 MHz

Bahagian Airspy dalam konfigurasi KA9Q:

[airspy]
device = airspy
description = "auto_rx"
frequency = 405m6
gainstep = 17

Julat scan Auto-RX:

min_freq = 400.05
max_freq = 405.0

1. Elakkan update dengan command Docker generik

Untuk setup KA9Q, jangan sekadar pull image dan recreate container tanpa mount tambahan. Container KA9Q memerlukan akses DBus dan Avahi supaya nama seperti sonde.local boleh digunakan dengan betul.

docker pull ghcr.io/projecthorus/radiosonde_auto_rx:latest
docker stop radiosonde_auto_rx
docker rm radiosonde_auto_rx
docker run ...

Untuk KA9Q, gunakan kaedah safe update di bawah.

2. Buat folder backup

Folder ini akan menyimpan setiap salinan station.cfg sebelum update.

mkdir -p ~/radiosonde_auto_rx/backups

3. Bina Safe Update Script

Script di bawah akan backup config, simpan image lama, pull image baru, recreate container, semak log dan rollback jika perlu.

nano ~/update_autorx_safe.sh

Paste keseluruhan script berikut:

#!/bin/bash
set -e

IMAGE="ghcr.io/projecthorus/radiosonde_auto_rx:testing"
NAME="radiosonde_auto_rx"
CFG="$HOME/radiosonde_auto_rx/station.cfg"
LOGDIR="$HOME/radiosonde_auto_rx/log"
BACKUPDIR="$HOME/radiosonde_auto_rx/backups"

echo
echo "=========================================="
echo " Radiosonde Auto-RX SAFE UPDATE"
echo "=========================================="
echo

mkdir -p "$BACKUPDIR"

echo "[1/6] Backup station.cfg..."
STAMP=$(date +%Y%m%d_%H%M%S)
cp -a "$CFG" "$BACKUPDIR/station.cfg.$STAMP"
echo "Backup: $BACKUPDIR/station.cfg.$STAMP"
echo

echo "[2/6] Saving current Docker image..."
OLD_IMAGE=$(docker inspect -f '{{.Image}}' "$NAME" 2>/dev/null || true)

if [ -n "$OLD_IMAGE" ]; then
    docker tag "$OLD_IMAGE" radiosonde_auto_rx:rollback
    echo "Rollback image created: radiosonde_auto_rx:rollback"
else
    echo "No existing Auto-RX container found."
fi

echo
echo "[3/6] Pulling latest Auto-RX testing image..."
docker pull "$IMAGE"

echo
echo "[4/6] Recreating Auto-RX container..."
docker stop "$NAME" 2>/dev/null || true
docker rm "$NAME" 2>/dev/null || true

docker run \
-d \
--name "$NAME" \
--restart=always \
--device=/dev/bus/usb \
--network=host \
-v "$CFG":/opt/auto_rx/station.cfg:ro \
-v "$LOGDIR":/opt/auto_rx/log/ \
-v /var/run/dbus:/var/run/dbus \
-v /var/run/avahi-daemon/socket:/var/run/avahi-daemon/socket \
"$IMAGE"

echo
echo "Waiting for Auto-RX to start..."
sleep 35

echo
echo "[5/6] Checking Auto-RX health..."

ERRORS=$(docker logs --since 40s "$NAME" 2>&1 | \
grep -E 'return code 124|Could not contact KA9Q|SDR produced no output|Scanner Thread Closed' || true)

if [ -n "$ERRORS" ]; then
    echo
    echo "=========================================="
    echo " UPDATE FAILED - AUTO ROLLBACK STARTED"
    echo "=========================================="
    echo "$ERRORS"

    docker stop "$NAME" 2>/dev/null || true
    docker rm "$NAME" 2>/dev/null || true

    if docker image inspect radiosonde_auto_rx:rollback >/dev/null 2>&1; then
        echo "Restoring previous working image..."

        docker run \
        -d \
        --name "$NAME" \
        --restart=always \
        --device=/dev/bus/usb \
        --network=host \
        -v "$CFG":/opt/auto_rx/station.cfg:ro \
        -v "$LOGDIR":/opt/auto_rx/log/ \
        -v /var/run/dbus:/var/run/dbus \
        -v /var/run/avahi-daemon/socket:/var/run/avahi-daemon/socket \
        radiosonde_auto_rx:rollback

        echo "Rollback complete."
    else
        echo "ERROR: No rollback image available!"
        exit 1
    fi
else
    echo
    echo "=========================================="
    echo " UPDATE SUCCESSFUL"
    echo "=========================================="
    docker ps --filter name="$NAME"
    echo
    echo "Latest Auto-RX logs:"
    docker logs --tail 25 "$NAME"
fi

echo
echo "[6/6] Finished."
echo

4. Simpan script

Dalam Nano, tekan Ctrl+O, Enter dan Ctrl+X.

5. Jadikan script executable

Selepas simpan, beri permission supaya script boleh dijalankan terus.

chmod +x ~/update_autorx_safe.sh

6. Cara update selepas ini

Selepas script siap, setiap kali mahu update Auto-RX anda hanya perlu satu command.

~/update_autorx_safe.sh

Apa Yang Script Ini Buat?

Antara error yang dicari secara automatik:

return code 124

Could not contact KA9Q

SDR produced no output

Scanner Thread Closed

Kenapa Guna Image testing?

Dalam setup KA9Q ini, gunakan image:

ghcr.io/projecthorus/radiosonde_auto_rx:testing

Container juga perlu mount:

/var/run/dbus
/var/run/avahi-daemon/socket

Ini membolehkan Auto-RX berkomunikasi dengan KA9Q melalui hostname seperti sonde.local.

Jangan Update KA9Q Serentak Dengan Auto-RX

Kalau tujuan anda hanya mahu update Radiosonde Auto-RX, jangan terus buat update source KA9Q pada masa yang sama. Elakkan command seperti:

cd ~/ka9q-radio
git checkout main
git pull
make clean
make
sudo make install

Update satu komponen pada satu masa. Jika Auto-RX sudah stabil, biarkan KA9Q pada versi yang sedang berfungsi. Update KA9Q hanya apabila dokumentasi versi Auto-RX memang memerlukan perubahan tersebut.

Command Pantas Selepas Update

Semak container

docker ps

Pastikan radiosonde_auto_rx berstatus Up.

Semak log Auto-RX

docker logs --tail 50 radiosonde_auto_rx

Log yang sihat biasanya mengandungi mesej seperti Running frequency scan dan tidak berulang-ulang dengan return code 124.

Semak KA9Q

control sonde.local

Jika keluar senarai SSRC, preset, sample rate, frequency dan SNR, KA9Q sedang berkomunikasi.

Semak Spectrum Dalam Web UI

Buka web Auto-RX melalui:

http://IP-RASPBERRY-PI:5000

Spectrum yang normal sepatutnya mempunyai noise floor, signal peaks, frequency scan dan peak detection. Jika hanya garis kosong dengan No scan data yet dan log menunjukkan return code 124, jangan terus anggap Airspy rosak.

Ujian Airspy Jika Ragu-Ragu

Semak dahulu dongle:

airspy_info

Untuk direct IQ capture, hentikan radiod sementara:

sudo systemctl stop radiod@airspymini-autorx

Kemudian jalankan:

rm -f /tmp/airspy-test.iq

airspy_rx \
-r /tmp/airspy-test.iq \
-f 405.0 \
-a 6000000 \
-g 17 \
-n 3000000 \
-d

Semak hasil:

ls -lh /tmp/airspy-test.iq

Jika fail beberapa MB terhasil tanpa USB/streaming error, Airspy masih boleh tune, sample dan stream data. Selepas ujian:

sudo systemctl start radiod@airspymini-autorx

Kesimpulan

Prinsip paling penting untuk setup Radiosonde Auto-RX + KA9Q + Airspy Mini ialah: jangan update semua benda serentak.

Dengan update_autorx_safe.sh, proses update selepas ini hanya memerlukan satu command:

~/update_autorx_safe.sh

Jika image baru bermasalah, sistem masih mempunyai working image lama untuk rollback tanpa perlu mengusik KA9Q, FFTW wisdom atau konfigurasi Airspy Mini yang sudah stabil. Semoga bermanfaat de 9m2zak.