Come collegare qualsiasi sismografo SeedLink a ZejfSeis

Software Seedlink_ZejfSeis. Un demone leggero in C che trasmette dati in tempo reale da un server SeedLink al software di visualizzazione ZejfSeis, decodificando i record MiniSEED nel formato del protocollo ZejfSeis.

[ lunedì 15 giugno 2026 ] Tempo di lettura: 4 minuti

Se ti sei mai immerso nel mondo della sismologia amatoriale o open-source, sai che una delle sfide più grandi non è solo catturare le vibrazioni della terra, ma visualizzare questi dati in modo chiaro, intuitivo e in tempo reale.

È qui che brilla ZejfSeis, uno straordinario software di visualizzazione che elabora i segnali sismici con una facilità sorprendente. Tuttavia, il progetto originale è nato con una limitazione importante: è stato progettato specificamente per funzionare con un hardware molto concreto (Arduino e i chip ADS1256/1263) tramite un proprio protocollo di comunicazione personalizzato. Il problema? Rimaneva completamente isolato da SeedLink, lo standard assoluto e indiscusso del settore nella sismologia professionale a livello mondiale.

Per risolvere questa mancanza di compatibilità e unire il meglio di entrambi i mondi, è appena nato Seedlink_ZejfSeis V.1.0.0.

Il ponte tecnico: Dalla sismologia professionale al tuo schermo

Seedlink_ZejfSeis è un daemon leggero scritto in C che agisce come un "traduttore" in tempo reale. Si connette come client a qualsiasi server SeedLink remoto, riceve e decodifica i record MiniSEED standard del settore e li ritrasmette istantaneamente nel formato del protocollo nativo di ZejfSeis.

┌─────────────────────┐         SeedLink v2          ┌───────────────────┐
│   Server SeedLink   │ ◄──────────────────────────► │   seedlink_zejf   │
│       remoto        │  HELLO/STATION/SELECT/       │  (questo programma)│
│  (es. EqCitizen)    │  DATA/END → MiniSEED v2      │                   │
└─────────────────────┘                              └────────┬──────────┘
                                                                      │ Protocollo ZejfSeis
                                                                      │ (TCP, porta 6222)
                                                             ┌────────▼──────────┐
                                                             │  Client ZejfSeis  │
                                                             │  (Java, desktop)  │
                                                             └───────────────────┘

Grazie a questo approccio, non hai più bisogno dell'hardware esatto per cui ZejfSeis è stato originariamente sviluppato. Ora puoi goderti la sua potente grafica e i suoi strumenti di documentazione visiva utilizzando qualsiasi sismografo o rete basata su SeedLink.

Caratteristiche principali del progetto

Per garantire che il flusso di dati rimanga costante e non interferisca con le prestazioni del sistema, il software è stato progettato con un'architettura robusta ed efficiente:

Prestazioni ultraleggere in C: Sviluppato in un ambiente multithread nativo (POSIX threads) per garantire una latenza minima nella trasmissione delle onde sismiche.
Decodifica standard: Integra la libreria ufficiale libmseed (versione >= 3.x) per analizzare i record MiniSEED v2 e v3 senza alcuno sforzo.
Consumo di archiviazione zero: Risponde in modo intelligente alle richieste di dati storici da parte dei client con blocchi vuoti. Tutta l'elaborazione avviene interamente nella memoria viva; non richiede alcuno spazio su disco.
Supporto multi-client massivo: Capace di alimentare fino a 32 client ZejfSeis simultaneamente da un'unica sorgente SeedLink.
Resilienza della rete: Dispone di un sistema di riconnessione automatica di 5 secondi se il server SeedLink remoto subisce micro-interruzioni, oltre a inviare proattivamente heartbeat dinamici ogni 2 secondi per evitare timeout di lettura dei socket sul lato client.
Configurazione esterna tramite JSON: Dimentica di dover ricompilare il codice ogni volta che desideri cambiare stazione. I parametri come host, porta, rete, stazione e canale sono facilmente gestibili da un file ranges.json.

Pronto per la produzione e ambienti sicuri

Un dettaglio critico che distingue questo progetto da altri sviluppi amatoriali è la sua forte attenzione alla sicurezza e alla stabilità del deployment. Quando si espone un servizio su una rete, la resilienza è fondamentale. Pertanto, il progetto documenta e integra linee guida per l'indurimento (hardening) dell'infrastruttura fin dall'inizio:

Utilizzo di Nginx come Reverse Proxy: Invece di esporre direttamente la porta nativa del binario in C a Internet pubblica, è fortemente consigliato l'uso di Nginx in modalità stream (TCP). Questo aiuta a mitigare gli abusi e gli attacchi DoS limitando le connessioni simultanee per IP (limit_conn) e isola il servizio in C in modo che rimanga in ascolto esclusivamente sull'ambiente locale (127.0.0.1).

Inoltre, è incluso uno strato di mitigazione contro gli abusi automatizzati tramite Fail2ban. Monitorando i log di connessione generati da Nginx, il sistema è in grado di rilevare i client che aprono connessioni in modo ciclico e anomalo o che effettuano scansioni brute-force dannose, bloccandoli temporaneamente tramite regole di firewall a livello di sistema operativo.

Conclusione: Democratizzare l'accesso ai dati sismici

Il vero valore di Seedlink_ZejfSeis risiede nella sua accessibilità. Rompendo un ecosistema chiuso di protocolli personalizzati, qualsiasi appassionato di sismologia, stazione educativa o nodo di rete di monitoraggio cittadino (come il progetto EqCitizen) può sfruttare appieno il potenziale dell'interfaccia di ZejfSeis.

Il progetto è già stato testato con successo in ambienti Linux sotto Ubuntu 24.04.4 LTS. Se desideri distribuirlo sul tuo server o rivedere il codice sorgente, puoi trovare tutta la documentazione tecnica, i passaggi di compilazione e gli esempi di configurazione testualmente nel file seedlink_zejf_README.md all'interno del repository.

https://github.com/vivesweb/Seedlink_ZejfSeis