🛠️ Guida all’Installazione di HamClock

HamClock è un’applicazione sviluppata da WB0OEW pensata per radioamatori, visualizzabile su monitor, PC, Raspberry Pi, tablet o anche come dashboard da inserire in un sito web.

📌 1. Prerequisiti

🖥️ Su PC con Linux (Ubuntu/Debian/Mint):

sudo apt update
sudo apt install git build-essential libsdl2-dev libsdl2-net-dev \
libsdl2-image-dev libcurl4-openssl-dev

🍓 Su Raspberry Pi (Raspberry Pi OS):

sudo apt update
sudo apt install git build-essential libsdl2-dev libsdl2-net-dev \
libsdl2-image-dev libcurl4-openssl-dev

🪟 Su Windows

Puoi usare WSL (Linux su Windows) oppure direttamente VirtualBox con una distribuzione Linux.
Oppure usare hamclock.exe precompilato (solo schermo 800×480).

📥 2. Scaricare HamClock

Da terminale (Linux/Raspberry Pi):

git clone https://github.com/hamclock/hamclock.git
cd hamclock

⚙️ 3. Compilazione

Puoi compilare HamClock scegliendo la risoluzione dello schermo.

Esempi:

Risoluzione	Comando
800×480	`make 800x480`
1024×600	`make 1024x600`
1920×1080 (Full HD)	`make 1920x1080`

💡 Suggerimento: per Raspberry Pi con piccolo display, usa 800×480.

🚀 4. Avviare HamClock

Dopo la compilazione, esegui:

./hamclock

Se vuoi avviarlo in full screen:

./hamclock -f

🌐 5. Avviare HamClock come Dashboard Web

HamClock può anche funzionare come server web, accessibile da browser!

./hamclock -w

Poi, apri nel browser (su un altro PC/smartphone):

http://IP_del_dispositivo:8080

🛠️ 6. Avvio automatico all’accensione (Raspberry Pi)

1️⃣ Apri l’editor:

nano /etc/rc.local

2️⃣ Aggiungi prima di exit 0:

sudo -u pi /home/pi/hamclock/hamclock -f &

3️⃣ Salva con CTRL + X → Y → Invio

🗺️ 7. Prima Configurazione

Al primo avvio ti verrà chiesto di inserire:

CALLSIGN (indicativo)
Città / Latitudine / Longitudine
Locator Maidenhead
Formato orario (locale o UTC)
Informazioni su sole, luna, satelliti, WX, propagazione, DX Cluster

💡 Puoi modificare successivamente tutto premendo SETUP sul display.

🔧 8. Problemi comuni e soluzioni

Problema	Soluzione
Schermo nero	Verifica risoluzione corretta in compilazione
Errore SDL	Manca libreria → reinstallare `libsdl2-dev`
Nessun dato Wx/DX/Prop	Controlla connessione internet
GPS non rilevato	Usa HamClock con modulo GPS esterno NMEA

👍 Consigli d’uso

✔ Ideale da usare su monitor dedicato in stazione radio
✔ Perfetto come dashboard web su tablet o smart TV
✔ Puoi montarlo su display 7″ Raspberry Pi
✔ Molto usato come cruscotto nei club radioamatoriali

GUIDA HAMCLOCK