How doppalapudinagavenkatasai/aqua-pulse works
AQUAPULSE combines an embedded adaptive sonar payload with a browser-based ground station and a Python telemetry/RAG service. The payload workflow samples environmental sensors, selects sonar parameters with TinyML, transmits a synthesized chirp, classifies echoes, and emits telemetry; the console visualizes acoustic propagation and mission data. The backend exposes telemetry, persistence, simulation, and mission-rationale endpoints. Several UI capabilities are documented or indexed but their wiring is not fully shown, so relationships are limited to visible imports, calls, or README statements.
Main entry points: App.tsx Ground station app · server.py Ground station API · main.cpp Payload runtime · oceanAcoustics.ts Ocean acoustics model
Components 24
Embedded payload
- Payload runtime
firmware/src/main.cpp - Environmental sensing
firmware/src/sensor_adc.c - TinyML policy
firmware/src/tinyml_policy.cpp - DMA chirp engine
firmware/src/dma_dac_engine.c - Channel configuration
firmware/include/config.h - Analog front end
hardware/simulation
Ground station
- Ground station app
src/App.tsx - Mode and scenario controls
src/components/common/Navbar.tsx - Boot sequence
src/components/common/BootSequence.tsx - Ocean propagation view
src/components/simulations/OceanCanvas.tsx - Sonar comparison
src/components/simulations/ComparisonView.tsx - Bathymetry mapping
src/components/simulations/BathymetryMap.tsx - Telemetry visualizations
src/components/telemetry - Hardware bridge
src/components/telemetry/LiveHardwareBridge.tsx - RAG assistant UI
src/components/common/RagAssistantModal.tsx
Telemetry services
- Ground station API
backend/server.py - Telemetry persistence
backend/database.py - Telemetry simulator
backend/simulator.py - Oceanographic RAG
backend/rag_engine.py
Acoustic modeling
- Sonar data types
src/types/sonar.ts - Ocean acoustics model
src/physics/oceanAcoustics.ts - Scenario presets
src/physics/presets.ts
Other components
- Console operator
- AUV and sonar environment
Connections 26
- Console operator → Ground station app: uses
README.md - Ground station app → Mode and scenario controls: renders
src/App.tsx - Ground station app → Boot sequence: renders
src/App.tsx - Ground station app → Ocean propagation view: renders
src/App.tsx - Ground station app → Sonar comparison: renders
src/App.tsx - Ground station app → Bathymetry mapping: renders
src/App.tsx - Ground station app → Telemetry visualizations: renders
src/App.tsx - Ground station app → RAG assistant UI: renders
src/App.tsx - Ground station app → Hardware bridge: renders
src/App.tsx - Ocean propagation view → Ocean acoustics model: uses
src/components/simulations/OceanCanvas.tsx - Bathymetry mapping → Ocean acoustics model: uses
src/components/simulations/BathymetryMap.tsx - Telemetry visualizations → Ocean acoustics model: uses
src/components/telemetry/PhysicsPanel.tsx - Telemetry visualizations → Sonar data types: uses
src/components/telemetry/PhysicsPanel.tsx - Ocean acoustics model → Sonar data types: uses
src/physics/oceanAcoustics.ts - Scenario presets → Sonar data types: uses
src/physics/presets.ts - Payload runtime → Environmental sensing: reads
firmware/src/main.cpp - Payload runtime → TinyML policy: invokes
firmware/src/main.cpp - Payload runtime → DMA chirp engine: initializes
firmware/src/main.cpp - DMA chirp engine → Channel configuration: uses
- Payload runtime → AUV and sonar environment: streams telemetry
README.md - DMA chirp engine → Analog front end: drives signal
README.md - Hardware bridge → Ground station API: exchanges telemetry
README.md - Ground station API → Telemetry persistence: reads and writes
backend/server.py - Ground station API → Telemetry simulator: requests samples
backend/server.py - Ground station API → Oceanographic RAG: requests rationale
backend/server.py - RAG assistant UI → Ground station API: submits questions