# im-tomu/tomu-hardware architecture

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

- Interactive diagram: https://gitdiagram.com/im-tomu/tomu-hardware
- Repository: https://github.com/im-tomu/tomu-hardware

## Overview

Tomu Hardware is an open hardware design for a tiny USB-plug ARM device with two buttons and two LEDs. Its main user workflow is to obtain the PCB design and parts information, build the board, and fit it in its protective case for use in a USB port. The repository also includes board documentation and manufacturing outputs. Relationships below are limited to those stated in the README; source files were not sampled, so implementation-level connections are not asserted.

Main entry points: [`pcb/tomu.kicad_pcb`](https://github.com/im-tomu/tomu-hardware/blob/master/pcb/tomu.kicad_pcb) (PCB design), [`case/tomu_0.4_case.stl`](https://github.com/im-tomu/tomu-hardware/blob/master/case/tomu_0.4_case.stl) (Protective case), [`pcb/tomu.sch`](https://github.com/im-tomu/tomu-hardware/blob/master/pcb/tomu.sch) (Circuit schematic), [`kitspace.yaml`](https://github.com/im-tomu/tomu-hardware/blob/master/kitspace.yaml) (Kitspace listing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_board["Board design"]
  node_pcb["PCB design<br/>[tomu.kicad_pcb]"]
  node_schematic["Circuit schematic<br/>[tomu.sch]"]
  node_mcu["EFM32HG309 MCU<br/>[tomu.sch]"]
  node_controls["Buttons and LEDs<br/>[tomu.sch]"]
end

subgraph group_build["Build resources"]
  node_bom["Parts list<br/>[bom-digikey.csv]"]
  node_kitspace["Kitspace listing<br/>[kitspace.yaml]"]
  node_gerbers["Fabrication outputs<br/>[gerber]"]
end

subgraph group_mechanical["Enclosure and docs"]
  node_case["Protective case<br/>[tomu_0.4_case.stl]"]
  node_docs["Board documentation"]
end

node_builder(("Hardware builder"))
node_usb["USB port"]

node_builder -->|"builds from"| node_pcb
node_builder -->|"sources parts"| node_bom
node_builder -->|"fits board"| node_case
node_schematic -.->|"describes circuit"| node_pcb
node_usb -->|"connects through"| node_pcb
node_pcb -->|"contains MCU"| node_mcu
node_pcb -->|"has controls"| node_controls
node_pcb -->|"protected by"| node_case
node_kitspace -->|"offers downloads"| node_gerbers
node_docs -->|"documents board"| node_builder

click node_pcb "https://github.com/im-tomu/tomu-hardware/blob/master/pcb/tomu.kicad_pcb"
click node_schematic "https://github.com/im-tomu/tomu-hardware/blob/master/pcb/tomu.sch"
click node_mcu "https://github.com/im-tomu/tomu-hardware/blob/master/pcb/tomu.sch"
click node_controls "https://github.com/im-tomu/tomu-hardware/blob/master/pcb/tomu.sch"
click node_bom "https://github.com/im-tomu/tomu-hardware/blob/master/bom-digikey.csv"
click node_kitspace "https://github.com/im-tomu/tomu-hardware/blob/master/kitspace.yaml"
click node_gerbers "https://github.com/im-tomu/tomu-hardware/tree/master/releases/v0.4.6/gerber"
click node_case "https://github.com/im-tomu/tomu-hardware/blob/master/case/tomu_0.4_case.stl"
click node_docs "https://github.com/im-tomu/tomu-hardware/tree/master/docs"

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_pcb,node_schematic,node_mcu,node_controls toneBlue
class node_bom,node_kitspace,node_gerbers toneAmber
class node_case,node_docs toneMint
class node_builder,node_usb toneIndigo
```

## Components

### Board design

- [PCB design](https://github.com/im-tomu/tomu-hardware/blob/master/pcb/tomu.kicad_pcb): `pcb/tomu.kicad_pcb`
- [Circuit schematic](https://github.com/im-tomu/tomu-hardware/blob/master/pcb/tomu.sch): `pcb/tomu.sch`
- [EFM32HG309 MCU](https://github.com/im-tomu/tomu-hardware/blob/master/pcb/tomu.sch): `pcb/tomu.sch`
- [Buttons and LEDs](https://github.com/im-tomu/tomu-hardware/blob/master/pcb/tomu.sch): `pcb/tomu.sch`

### Build resources

- [Parts list](https://github.com/im-tomu/tomu-hardware/blob/master/bom-digikey.csv): `bom-digikey.csv`
- [Kitspace listing](https://github.com/im-tomu/tomu-hardware/blob/master/kitspace.yaml): `kitspace.yaml`
- [Fabrication outputs](https://github.com/im-tomu/tomu-hardware/tree/master/releases/v0.4.6/gerber): `releases/v0.4.6/gerber`

### Enclosure and docs

- [Protective case](https://github.com/im-tomu/tomu-hardware/blob/master/case/tomu_0.4_case.stl): `case/tomu_0.4_case.stl`
- [Board documentation](https://github.com/im-tomu/tomu-hardware/tree/master/docs): `docs`

### Other components

- **Hardware builder**
- **USB port**

## Connections

- Hardware builder → PCB design: builds from (evidence: `README.md`)
- Hardware builder → Parts list: sources parts (evidence: `README.md`)
- Hardware builder → Protective case: fits board (evidence: `README.md`)
- Circuit schematic → PCB design: describes circuit
- USB port → PCB design: connects through (evidence: `README.md`)
- PCB design → EFM32HG309 MCU: contains MCU (evidence: `README.md`)
- PCB design → Buttons and LEDs: has controls (evidence: `README.md`)
- PCB design → Protective case: protected by (evidence: `README.md`)
- Kitspace listing → Fabrication outputs: offers downloads (evidence: `README.md`)
- Board documentation → Hardware builder: documents board (evidence: `README.md`)
