How novafang23/fpga-accelerated-personal-health-companion-edge-disaster-monitor works
VALOR is an offline-first health and disaster-risk companion, with Zynq and ShrikeFi firmware platforms. Its main user-to-result path acquires physiological and environmental readings, derives clinical biomarkers, assesses clinical and disaster risk, then presents local status and can optionally publish telemetry. The README also documents FPGA-assisted PPG timing, TinyML inference, and a desktop dashboard. The sampled excerpts establish algorithms and some module references, but do not expose every runtime call; undocumented subsystem links are omitted or marked unverified.
Main entry points: main_shrikefi.c ShrikeFi firmware · main_simulation.c Zynq simulation · shrikefi_link_driver.c FPGA link driver · shrikefi_dashboard.c Desktop dashboard
Components 22
Device Platforms
- ShrikeFi firmware
firmware/shrikefi/main_shrikefi.c - Zynq simulation
firmware/zynq/main_simulation.c - MAX30102 driver
firmware/shrikefi/max30102.c - Environmental drivers
firmware/shrikefi/bme280.c - Particulate drivers
firmware/shrikefi/pms5003.c - FPGA link driver
firmware/shrikefi/shrikefi_link_driver.c - FPGA bitstream
firmware/shrikefi/forgefpga_bitstream.h
Vital Processing
- HRV analysis
firmware/core/hrv_analysis.h - SpO2 estimation
firmware/core/spo2_engine.c - PPG respiratory rate
firmware/core/ppg_respiratory_rate.c - PPG signal quality
firmware/core/ppg_sqi.c - PM2.5 calibration
firmware/core/pm25_calibration_int8.c
Risk Assessment
- Clinical triage
firmware/core/clinical_vitals_engine.c - Disaster risk engine
firmware/core/disaster_risk_engine.c - INT8 risk model
firmware/core/nn_risk_model_int8.c
User Interfaces
- Desktop dashboard
firmware/shrikefi/shrikefi_dashboard.c - Device display
firmware/shrikefi/ssd1306.c - Web status
firmware/shrikefi/web_status.c - WiFi and MQTT
firmware/shrikefi/wifi_mqtt_manager.c
Other components
- Rescue user
- Health and environment sensors
- MQTT broker
Connections 26
- Health and environment sensors → ShrikeFi firmware: supply readings
README.md - ShrikeFi firmware → MAX30102 driver: reads PPG
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → Environmental drivers: reads environment
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → Particulate drivers: reads particulates
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → FPGA link driver: uses link
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → FPGA bitstream: loads at boot
README.md - FPGA link driver → Rescue user: provides acceleration
- ShrikeFi firmware → HRV analysis: computes HRV
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → SpO2 estimation: estimates SpO2
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → PPG respiratory rate: estimates respiration
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → PPG signal quality: checks signal quality
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → PM2.5 calibration: calibrates PM2.5
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → Clinical triage: assesses vitals
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → Disaster risk engine: assesses disaster risk
firmware/shrikefi/main_shrikefi.c - ShrikeFi firmware → INT8 risk model: runs inference
firmware/shrikefi/main_shrikefi.c - Zynq simulation → HRV analysis: computes HRV
firmware/zynq/main_simulation.c - Zynq simulation → Disaster risk engine: assesses scenarios
firmware/zynq/main_simulation.c - Zynq simulation → INT8 risk model: runs inference
firmware/zynq/main_simulation.c - ShrikeFi firmware → Desktop dashboard: streams telemetry
README.md - ShrikeFi firmware → Device display: updates display
- ShrikeFi firmware → Web status: serves status
- ShrikeFi firmware → WiFi and MQTT: publishes telemetry
README.md - WiFi and MQTT → MQTT broker: optional publish
firmware/shrikefi/wifi_mqtt_manager.c - Desktop dashboard → Rescue user: shows assessments
README.md - Device display → Rescue user: shows status
- Web status → Rescue user: shows status