portugalfuturista/sistemas-cibernetico-fisicos
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Portugal Futurista Cyber-Physical Systems — CAD/EDA hardware, PCB designs, mechanical engineering, IoT device development
33 commits 2 branches 0 tags 590 MiB
C 83%
C++ 8.3%
HTML 4.8%
Python 1.9%
TeX 0.7%
Other 0.9%
Find a file
Fábio Cunha 31c9baede3 feat(aurelio): bootstrap flow-meter-pcb realm workspace 
- Add .aurelio/config.toml, mcp_config.json, sync.py, README.md

- Seed .aurelio/realm/AGENTS.md and memory/index.md
2026-07-05 20:24:26 +01:00
.aurelio feat(aurelio): bootstrap flow-meter-pcb realm workspace 2026-07-05 20:24:26 +01:00
docs docs(sync): add README/AGENTS.md, fix hardware docs, sync central brain 2026-07-05 18:21:00 +01:00
hardware docs(sync): add README/AGENTS.md, fix hardware docs, sync central brain 2026-07-05 18:21:00 +01:00
.gitattributes feat(hw): restructure repo with hardware/ layout and EasyEDA Pro exports (v2.3–v2.8) 2026-04-21 07:18:46 +01:00
.gitignore chore(aurelio): allow tracked .aurelio workspace files 2026-07-05 20:24:26 +01:00
AGENTS.md docs(sync): add README/AGENTS.md, fix hardware docs, sync central brain 2026-07-05 18:21:00 +01:00
README.md docs(sync): add README/AGENTS.md, fix hardware docs, sync central brain 2026-07-05 18:21:00 +01:00

README.md

Savearth Hardware Repository

WHY

This repository is the canonical hardware design home for the Savearth smart-shower flow-meter device. It holds every PCB revision from early prototypes through the current production design and the next mitigation spin. Keeping hardware sources, manufacturing outputs, and analysis docs in one place lets firmware, manufacturing, and field-support teams work from the same truth.

HOW

The repository is organised by hardware version under hardware/. Each version contains its native EDA project, extracted BOM, parsed schematic data, and manufacturing outputs. Shared component libraries and Python automation scripts live in hardware/common/. Design decisions and post-mortems live in docs/.

Supported PCB versions: v2.3, v2.4, v2.5, v2.6, v2.7, v2.8, v2.9.

WHAT

Key documents

Document Purpose
PCB v2.8 Hardware Analysis & Fixes Brick/recovery root causes and the GPIO0 bodge-wire fix
PCB v2.9 Mitigation Plan Architectural changes for the next spin
Hardware Meeting Agenda — v2.8/v2.9 Discussion points and decision checklist
EasyEDA Pro → KiCad Guide Migration procedure
Supply-Chain Risk Mitigation v2.8 component risks and replacements
Hardware Automation Scripts extract_bom.py, generate_jlcpcb_bom.py, convert_to_kicad.py, extract_easyeda_db.py

Related repositories

Repository Role
aws-iot-core-poc ESP32-S3 firmware, BSP, drivers, and test firmware
savearth-iot-infrastructure AWS IoT rules, Lambdas, DynamoDB, InfluxDB
hardware-devicesFirmwareTest Assembly-house test station and pre-built binaries

Quick start

  1. Open the active design: hardware/v2.8/easyeda/Savearth GBT.eprj (EasyEDA Pro).
  2. Read the v2.8 analysis if you are debugging brick/recovery issues.
  3. Read the v2.9 mitigation plan before starting the next schematic spin.
  4. Use the scripts in hardware/common/scripts/ to regenerate BOMs or convert libraries.