Skip to content

Home

Jump to bottom
GiZano edited this page Sep 3, 2026 · 8 revisions

🌋 QuakeGuard Technical Wiki

Welcome to the official technical documentation for the QuakeGuard project (Release v2.0.1 — Hybrid Infrastructure & GNSS Automation).

QuakeGuard is a distributed, high-throughput Earthquake Early Warning (EEW) system built on commodity IoT hardware and a Zero-Trust cloud architecture. The wiki is organized into focused topic pages below.

Table of Contents

  1. System Architecture & Overview — updated v2.0.1: Cloudflare HTTPS tunnel
  2. Hardware & Edge Computing (ESP32-C3) — updated v1.2.2: FreeRTOS dispatcher, RetentionRing, offline wall clock & GNSS-ready
  3. Cryptographic Security & Provisioning — updated v1.2.2/v2.0.1: identical ECDSA on MQTT/serial, re-sign on drain, 300s anti-replay window
  4. Data Plane & Message Broker (MQTT) — updated v1.2.2: Host Serial Bridge as second ingestion path
  5. Backend Services & Event Processing — updated v1.2.1/v1.2.2: Redis Streams, TimescaleDB, per-area cooldown
  6. Mobile Client & Live Telemetry
  7. Deployment & Operations Guide
  8. AI Emergency Report Service (new in v1.2.0)
  9. Epicenter Triangulation Algorithm (new in v2.0.0)

Related Pages

Project & Licensing Information

  • Software License: QuakeGuard software (backend, mobile, firmware) is open-source and released under the GNU Affero General Public License v3.0 (AGPL-3.0).
  • Hardware License: The QuakeGuard Printed Circuit Board (PCB) and related hardware designs are released under the CERN Open Hardware Licence (CERN-OHL).
  • Data Availability & Archival: Stable releases of the project, including this whitepaper and the associated source code, are permanently archived on Zenodo and citable via the authoritative DOI identifier.

Clone this wiki locally