Home

SAMBA Documentation Home

The SAMBA IEQ Monitoring System combines ESPHome firmware, custom hardware, and external integrations to capture indoor environmental quality metrics. The repository hosts:

• Firmware configuration in config/ using modular YAML files for each capability (e.g. networking, sampling, sensors).
• External components in components/ for features not yet merged into upstream ESPHome, such as the InfluxDB publisher and the custom sound level meter.
• Pre-built binaries and manifests in firmware/ and firmware.json for streamlined deployments.

SAMBA devices run on ESP32 hardware and are designed for research-grade deployments. Documentation in this wiki dives deeper into how the YAML modules work together:

• Sampling Configuration explains the five-minute capture-and-upload routine that coordinates every measurement.
• Sensor Configuration summarises each onboard sensor, derived metric, and calibration hook.

For setup guidance, flashing instructions, and maintenance procedures, refer back to the root README.md.