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
37 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 Coutada d190530697 docs(hardware): add savearth PCB BOMs, netlists, knowledge base 
- v2.5, v2.6, v2.7, v2.8, v2.9 parsed BOMs and netlists
- v2.8/v2.9 knowledge base (component data, supply chain)
- v2.8 README with pinout documentation
- v2.9 EasyEDA project file
- Hardware all-versions knowledge base
2026-07-16 23:21:10 +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(hardware): add savearth PCB BOMs, netlists, knowledge base 2026-07-16 23:21:10 +01:00
infotainment-mvp feat(ioc-bootloader): import Traveo II boot manager (dev_bm — newer) 2026-07-16 23:14:52 +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(agents): update AGENTS.md and README for local Aurelio workspace 2026-07-05 20:24:26 +01:00
README.md docs(agents): update AGENTS.md and README for local Aurelio workspace 2026-07-05 20:24:26 +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

Aurelio workspace

This repository includes a local .aurelio/ workspace for the flow-meter-pcb realm. It connects the hardware repo to savearth-mcp, savearth-workspace, and the electrical MCP servers. See .aurelio/README.md for setup, sync commands, and tracked files.

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.