atmosmesh

Public

Loading files…

README

AtmosMesh

Local air sensing, connected as a mesh.

AtmosMesh is a family of local air-sensing firmware products, now spanning several product variants (v1, Grove v1.5, Aqua, Room, Spot); none supersedes another.

Firmware products

Product	Product ID	Product variant	Controller	Sensor/display scope	Canonical build
AtmosMesh v1 — ARCHIVED (D-034; physical station disassembled 2026-08-31)	`atmosmesh-v1`	`esp32-full-station`	ESP32-WROOM-32	Full station: SSD1306, BMP280, AM2302, SDS011, MQ135, PIR/beeper, optional VEML7700, MQTT	`task build-v1` (not part of `task build-all`)
AtmosMesh Grove v1.5

Comments

Sensor	Quantity	Notes
SDS011	PM2.5, PM10	UART2 only (GPIO16/17). 5 V heater, 3.3 V UART
AM2302 / DHT22	Temperature, humidity	GPIO18, 3V3
BMP280	Pressure, temperature	I²C 0x76 on GPIO21/19, 3V3
Mini OLED (D-001)	Local live page	I²C 0x3C, SDA GPIO5, SCL GPIO4, 3V3 only
MQ135	Relative gas trend	Analog GPIO34 through a divider. Never labelled CO₂ or ppm
VEML7700	Illuminance	Optional, I²C 0x10 on the BMP280 bus. Not fitted yet
PIR + beeper	Occupancy cue	GPIO33 / GPIO25

SDS011 ─┐
AM2302 ─┤
BMP280 ─┼─> ESP32 ── OLED (local)
MQ135  ─┤       └─ MQTT (planned) ──> Mosquitto ──> Home Assistant
VEML   ─┘                         └─ metrics ─> Prometheus ─> Grafana

task bootstrap-agent-python   # creates .venv with pyserial + esptool
task test                     # native Unity tests (no hardware)
task build-all                # both first-class product images
task build-v1                 # AtmosMesh v1 / ESP32
task build-v1-5               # AtmosMesh Grove v1.5 / ESP8266

Path	What
`docs/hardware/inventory.md`	Confirmed parts and open questions
`docs/elektronik-inventar.md`	Full electronics stock inventory, including parts not currently assigned to a product
`docs/hardware/datasheets/`	Manufacturer datasheets and retained kit manuals
`docs/hardware/power.md`	5 V / 3.3 V domains
`docs/hardware/oscilloscope-hantek-dso2d15.md`	Bench scope: panel, probe setup, and the ripple / I²C / UART / rail recipes
`hardware/kicad/`	Bench carrier (KiCad 10): OLED, sensors, extras strip, fully routed. Do not fabricate until DevKit pin order is photographed

Path	Purpose
`firmware/`	One PlatformIO project, explicit product roots, shared core and native tests
`docs/adr/`	Architecture decision records
`docs/history/`	Superseded project notes and concept artifacts retained for provenance
`hardware/kicad/`	Bench-station carrier schematic and PCB
`docs/`	Architecture, hardware facts, datasheets
`deploy/`	Kubernetes / home-automation config (not packaged yet)
`tests/`	Host-side checks
`agent-context/`	Stories, decisions, and live session notes
`AGENTS.md`	Safety boundaries and workflow for humans and agents

atmosmesh

Share atmosmesh

AtmosMesh

Firmware products

Sign in to BoardRepo

AtmosMesh

Firmware products

AtmosMesh v1 measurements

Safety (read this first)

Quick start

Hardware

Repository layout

Status

License and contributors