# opulo-inc/lumenpnp architecture

> Architecture diagram of the GitHub repository opulo-inc/lumenpnp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/opulo-inc/lumenpnp
- Repository: https://github.com/opulo-inc/lumenpnp

## Overview

LumenPnP is an open-source pick-and-place machine project: its repository primarily contains mechanical CAD, electrical schematics and PCB layouts, and machine-control configuration, rather than a software application runtime. A builder or maintainer uses these designs to assemble and operate the machine. The README also identifies compatible powered feeders, whose source lives elsewhere. The two sampled scripts support machine-configuration documentation and vacuum-sensor testing; evidence for links among the broader design files is limited to README descriptions and the tree.

Main entry points: [`pnp/pcb`](https://github.com/opulo-inc/lumenpnp/tree/main/pnp/pcb) (PCB designs), [`pnp/cad`](https://github.com/opulo-inc/lumenpnp/tree/main/pnp/cad) (Mechanical CAD), [`openpnp/scripts/TestVacuumSensors.py`](https://github.com/opulo-inc/lumenpnp/blob/main/openpnp/scripts/TestVacuumSensors.py) (Vacuum sensor test), [`pnp`](https://github.com/opulo-inc/lumenpnp/tree/main/pnp) (Pick-and-place system)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_design["Machine design"]
  node_machine["LumenPnP machine"]
  node_mechanical["Mechanical CAD"]
  node_assembly["Assembly model<br/>[assembly.FCStd]"]
  node_pickplace["Pick-and-place system"]
  node_feeders["Powered feeders"]
end

subgraph group_electronics["Electronics"]
  node_pcb["PCB designs"]
  node_mainboard["Mainboard"]
  node_bladeboards["Blade boards"]
  node_auxboards["Auxiliary boards"]
  node_kicadlib["KiCad libraries"]
end

subgraph group_control["Machine control"]
  node_machineconfig["OpenPnP configuration<br/>[machine.xml]"]
  node_configdocs["Configuration docs"]
  node_vacuumtest["Vacuum sensor test"]
  node_controller["Machine controller"]
end

subgraph group_support["Build support"]
  node_bom["Bill of materials<br/>[bom.csv]"]
  node_exports["Design exports<br/>[workflows]"]
end

node_builder(("Builder / operator"))

node_builder -->|"uses to build"| node_mechanical
node_builder -->|"uses to assemble"| node_pcb
node_mechanical -.->|"includes model"| node_assembly
node_mechanical -->|"defines machine"| node_pickplace
node_builder -.->|"may add"| node_feeders
node_pcb -.->|"includes"| node_mainboard
node_pcb -.->|"includes"| node_bladeboards
node_pcb -.->|"includes"| node_auxboards
node_kicadlib -.->|"supports designs"| node_pcb
node_machineconfig -->|"parsed by"| node_configdocs
node_builder -.->|"configures"| node_machineconfig
node_vacuumtest -->|"sends G-code"| node_controller
node_controller -->|"returns readings"| node_vacuumtest
node_builder -->|"runs test"| node_vacuumtest
node_builder -.->|"consults"| node_bom
node_builder -.->|"retrieves exports"| node_exports
node_pickplace -.->|"is"| node_machine

click node_mechanical "https://github.com/opulo-inc/lumenpnp/tree/main/pnp/cad"
click node_assembly "https://github.com/opulo-inc/lumenpnp/blob/main/pnp/cad/assembly.FCStd"
click node_pickplace "https://github.com/opulo-inc/lumenpnp/tree/main/pnp"
click node_pcb "https://github.com/opulo-inc/lumenpnp/tree/main/pnp/pcb"
click node_mainboard "https://github.com/opulo-inc/lumenpnp/tree/main/pnp/pcb/mobo"
click node_bladeboards "https://github.com/opulo-inc/lumenpnp/tree/main/pnp/pcb/blade12"
click node_auxboards "https://github.com/opulo-inc/lumenpnp/tree/main/pnp/pcb"
click node_kicadlib "https://github.com/opulo-inc/lumenpnp/tree/main/lib/kicad"
click node_machineconfig "https://github.com/opulo-inc/lumenpnp/blob/main/openpnp/machine.xml"
click node_configdocs "https://github.com/opulo-inc/lumenpnp/blob/main/openpnp/scripts/DocumentOpenPNPMachineXML.py"
click node_vacuumtest "https://github.com/opulo-inc/lumenpnp/blob/main/openpnp/scripts/TestVacuumSensors.py"
click node_bom "https://github.com/opulo-inc/lumenpnp/blob/main/bom.csv"
click node_exports "https://github.com/opulo-inc/lumenpnp/tree/main/.github/workflows"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_machine,node_mechanical,node_assembly,node_pickplace,node_feeders toneBlue
class node_pcb,node_mainboard,node_bladeboards,node_auxboards,node_kicadlib toneAmber
class node_machineconfig,node_configdocs,node_vacuumtest,node_controller toneMint
class node_bom,node_exports toneRose
class node_builder toneIndigo
```

## Components

### Machine design

- **LumenPnP machine**
- [Mechanical CAD](https://github.com/opulo-inc/lumenpnp/tree/main/pnp/cad): `pnp/cad`
- [Assembly model](https://github.com/opulo-inc/lumenpnp/blob/main/pnp/cad/assembly.FCStd): `pnp/cad/assembly.FCStd`
- [Pick-and-place system](https://github.com/opulo-inc/lumenpnp/tree/main/pnp): `pnp`
- **Powered feeders**

### Electronics

- [PCB designs](https://github.com/opulo-inc/lumenpnp/tree/main/pnp/pcb): `pnp/pcb`
- [Mainboard](https://github.com/opulo-inc/lumenpnp/tree/main/pnp/pcb/mobo): `pnp/pcb/mobo`
- [Blade boards](https://github.com/opulo-inc/lumenpnp/tree/main/pnp/pcb/blade12): `pnp/pcb/blade12`
- [Auxiliary boards](https://github.com/opulo-inc/lumenpnp/tree/main/pnp/pcb): `pnp/pcb`
- [KiCad libraries](https://github.com/opulo-inc/lumenpnp/tree/main/lib/kicad): `lib/kicad`

### Machine control

- [OpenPnP configuration](https://github.com/opulo-inc/lumenpnp/blob/main/openpnp/machine.xml): `openpnp/machine.xml`
- [Configuration docs](https://github.com/opulo-inc/lumenpnp/blob/main/openpnp/scripts/DocumentOpenPNPMachineXML.py): `openpnp/scripts/DocumentOpenPNPMachineXML.py`
- [Vacuum sensor test](https://github.com/opulo-inc/lumenpnp/blob/main/openpnp/scripts/TestVacuumSensors.py): `openpnp/scripts/TestVacuumSensors.py`
- **Machine controller**

### Build support

- [Bill of materials](https://github.com/opulo-inc/lumenpnp/blob/main/bom.csv): `bom.csv`
- [Design exports](https://github.com/opulo-inc/lumenpnp/tree/main/.github/workflows): `.github/workflows`

### Other components

- **Builder / operator**

## Connections

- Builder / operator → Mechanical CAD: uses to build (evidence: `README.md`)
- Builder / operator → PCB designs: uses to assemble (evidence: `README.md`)
- Mechanical CAD → Assembly model: includes model
- Mechanical CAD → Pick-and-place system: defines machine (evidence: `README.md`)
- Builder / operator → Powered feeders: may add (evidence: `README.md`)
- PCB designs → Mainboard: includes
- PCB designs → Blade boards: includes
- PCB designs → Auxiliary boards: includes
- KiCad libraries → PCB designs: supports designs
- OpenPnP configuration → Configuration docs: parsed by (evidence: `openpnp/scripts/DocumentOpenPNPMachineXML.py`)
- Builder / operator → OpenPnP configuration: configures
- Vacuum sensor test → Machine controller: sends G-code (evidence: `openpnp/scripts/TestVacuumSensors.py`)
- Machine controller → Vacuum sensor test: returns readings (evidence: `openpnp/scripts/TestVacuumSensors.py`)
- Builder / operator → Vacuum sensor test: runs test (evidence: `openpnp/scripts/TestVacuumSensors.py`)
- Builder / operator → Bill of materials: consults
- Builder / operator → Design exports: retrieves exports (evidence: `README.md`)
- Pick-and-place system → LumenPnP machine: is
