This repository is the single source of truth for OpenVVVF product documentation, shared hardware data, and documentation tooling.
It is organized by hardware and software domain:
- Control Assembly: the reusable inverter control module (user hardware manual and software manual).
- Power Stages: physical chassis/inverter assemblies, each with a user manual and an assembly guide (currently documented for C2 only).
- Safety and Compliance: HARA, compliance mappings, and standards references; includes Testing — formal test reports and validation evidence.
Hardware designs remain in ../InverterGen5. Firmware and host software live in the OpenVVVF/RTE repository. This repo pulls together the documentation for all of them.
├── Docs/ # All documentation
├── Data/ # Shared part database and pricing data
├── Tools/ # Documentation and fabrication tooling
│ ├── BOMManager/ # Generalized BOM / fabrication package manager
│ ├── DocGen/ # Document validation and static site generator
│ └── HWRelease/ # Hardware release exporter (InverterGen5 tags -> Data/Releases)
├── Config/ # Repo-level configuration (product registry)
├── README.md
└── pyproject.toml
# Install tool dependencies
pip install -e Tools/BOMManager
pip install -e Tools/DocGen
# Run tests
pytest Tools/BOMManager/tests Tools/DocGen/tests
# Validate cross-references
python -m docgen validate
# Build the static site
python -m docgen site --output-dir site| Area | Path |
|---|---|
| Control assembly | Docs/Hardware/Control-Assembly/ |
| Power stages | Docs/Hardware/Power-Stages/ |
| Safety and compliance | Docs/Safety-and-Compliance/ |
| Testing and validation | Docs/Safety-and-Compliance/Testing/ |
| Part database | Data/Parts/ |
See AGENTS.md and Docs/Agents.md for conventions used by contributors and AI agents.
A special thank you to our sponsors for helping make this project possible:
