Como ligar qualquer sismógrafo SeedLink ao ZejfSeis

Software Seedlink_ZejfSeis. Um daemon leve em C que transmite dados em tempo real de um servidor SeedLink para o software de visualização ZejfSeis, decodificando registos MiniSEED para o formato do protocolo ZejfSeis.

[ segunda-feira, 15 de junho de 2026 ] Tempo de leitura: 5 minutos

Se alguma vez mergulhou no mundo da sismologia amadora ou de código aberto, sabe que um dos maiores desafios não é apenas capturar o tremor da terra, mas visualizar esses dados de forma clara, intuitiva e em tempo real.

É aqui que brilha o ZejfSeis — um excelente software de visualização que processa sinais sísmicos com uma facilidade surpreendente. No entanto, o projeto original nasceu com uma limitação significativa: foi especificamente concebido para funcionar com hardware muito concreto (Arduino e os chips ADS1256/1263) através do seu próprio protocolo de comunicação personalizado. O problema? Ficava completamente isolado do SeedLink, o padrão absoluto e indiscutível da sismologia profissional a nível mundial.

Para resolver esta falta de compatibilidade e unir o melhor de dois mundos, acaba de nascer o Seedlink_ZejfSeis V.1.0.0.

A Ponte Técnica: Da Sismologia Profissional para o seu Ecrã

O Seedlink_ZejfSeis é um daemon (demónio) leve escrito em C que atua como um "tradutor" em tempo real. Conecta-se como cliente a qualquer servidor SeedLink remoto, recebe e descodifica os registos MiniSEED padrão do setor, e retransmite-os instantaneamente no formato do protocolo nativo do ZejfSeis.

┌─────────────────────┐         SeedLink v2          ┌───────────────────┐
│  Servidor SeedLink  │ ◄──────────────────────────► │   seedlink_zejf   │
│       Remoto        │  HELLO/STATION/SELECT/       │  (este programa)  │
│  (ex. EqCitizen)    │  DATA/END → MiniSEED v2      │                   │
└─────────────────────┘                              └────────┬──────────┘
                                                                      │ Protocolo ZejfSeis
                                                                      │ (TCP, porta 6222)
                                                             ┌────────▼──────────┐
                                                             │  Cliente ZejfSeis │
                                                             │  (Java, desktop)  │
                                                             └───────────────────┘

Graças a esta abordagem, já não precisa do hardware exato para o qual o ZejfSeis foi originalmente desenvolvido. Agora pode desfrutar dos seus potentes gráficos e ferramentas de documentação visual utilizando qualquer sismógrafo ou rede baseada em SeedLink.

Principais Características do Projeto

Para garantir que o fluxo de dados permanece constante e não interfere com o desempenho do sistema, o software foi desenhado sob uma arquitetura robusta e eficiente:

Desempenho Ultraleve em C: Desenvolvido num ambiente multithread nativo (POSIX threads) para garantir uma latência mínima na entrega das ondas sísmicas.
Descodificação Padrão: Integra a biblioteca oficial libmseed (versão >= 3.x) para analisar registos MiniSEED v2 e v3 sem esforço.
Consumo de Armazenamento Zero: Responde de forma inteligente a pedidos de dados históricos por parte dos clientes com blocos vazios. Todo o processamento ocorre inteiramente em memória viva; não requer qualquer espaço em disco.
Suporte Multi-Cliente Massivo: Capaz de alimentar até 32 clientes ZejfSeis em simultâneo a partir de uma única fonte SeedLink.
Resiliência de Rede: Possui um sistema de reconexão automática de 5 segundos caso o servidor SeedLink remoto sofra microcortes, além de enviar proativamente heartbeats dinâmicos a cada 2 segundos para evitar tempos de espera (timeouts) de leitura dos sockets no lado do cliente.
Configuração Externa via JSON: Esqueça a recompilação do código sempre que quiser mudar de estação. Os parâmetros como o host, porta, rede, estação e canal são facilmente geridos a partir de um ficheiro ranges.json.

Preparado para Produção e Ambientes Seguros

Um detalhe crítico que distingue este projeto de outros desenvolvimentos caseiros é o seu forte foco na segurança e na estabilidade de implantação. Ao expor qualquer serviço numa rede, a resiliência é fundamental. Por isso, o projeto documenta e integra diretrizes de endurecimento (hardening) da infraestrutura desde o início:

Utilização do Nginx como Proxy Inverso: Em vez de expor diretamente a porta nativa do binário em C à Internet pública, a utilização do Nginx em modo stream (TCP) é altamente recomendada. Isto ajuda a mitigar abusos e ataques DoS, limitando as ligações simultâneas por IP (limit_conn) e isola o serviço em C para que escute exclusivamente no ambiente local (127.0.0.1).

Adicionalmente, está incluída uma camada de mitigação contra abusos automatizados através do Fail2ban. Ao monitorizar os registos (logs) de ligação gerados pelo Nginx, o sistema consegue detetar clientes que ciclam ligações de forma anómala ou que realizam varrimentos (scans) maliciosos de força bruta, bloqueando-os temporariamente através de regras de firewall ao nível do sistema operativo.

Conclusão: Democratizar o Acesso aos Dados Sísmicos

O verdadeiro valor do Seedlink_ZejfSeis reside na sua acessibilidade. Ao quebrar um ecossistema fechado de protocolos personalizados, qualquer entusiasta de sismologia, estação educativa ou nó de rede de monitorização cidadã (como o projeto EqCitizen) pode tirar partido de todo o potencial da interface do ZejfSeis.

O projeto já foi testado com sucesso em ambientes Linux sob o Ubuntu 24.04.4 LTS. Se pretender implantá-lo no seu próprio servidor ou rever o código fonte, pode encontrar toda a documentação técnica, os passos de compilação e os exemplos de configuração textualmente no ficheiro seedlink_zejf_README.md no repositório.

https://github.com/vivesweb/Seedlink_ZejfSeis