# bitdump/blheli architecture

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

- Interactive diagram: https://gitdiagram.com/bitdump/blheli
- Repository: https://github.com/bitdump/blheli

## Overview

This repository is a collection of BLHeli sensorless brushless ESC firmware families, not the flashing/configuration application. The documented user path is to obtain firmware here and use BLHeliSuite or the BLHeli_32 app for flashing and configuration on an ESC. The tree distinguishes legacy Atmel and SiLabs BLHeli, BLHeli_S, and BLHeli_32, plus board-specific profiles and firmware artifacts. Source excerpts were unavailable, so internal calls and build relationships are not inferred; documented family capabilities and the visible artifact organization inform this map.

Main entry points: [`Atmel/BLHeli.asm`](https://github.com/bitdump/blheli/blob/master/Atmel/BLHeli.asm) (Atmel firmware), [`BLHeli_S SiLabs/BLHeli_S.asm`](https://github.com/bitdump/blheli/blob/master/BLHeli_S%20SiLabs/BLHeli_S.asm) (SiLabs assembly), [`SiLabs`](https://github.com/bitdump/blheli/tree/master/SiLabs) (SiLabs firmware), [`Atmel`](https://github.com/bitdump/blheli/tree/master/Atmel) (Board profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_legacy["Legacy BLHeli"]
  node_atmel["Atmel firmware<br/>[BLHeli.asm]"]
  node_silabs["SiLabs firmware"]
  node_legacytypes["Motor variants"]
  node_legacyprofiles["Board profiles"]
  node_legacydocs["Legacy manuals"]
end

subgraph group_s["BLHeli_S"]
  node_sasm["SiLabs assembly<br/>[BLHeli_S.asm]"]
  node_sprofiles["MCU profiles"]
  node_shex["BLHeli_S images"]
  node_sdocs["BLHeli_S manual"]
end

subgraph group_v32["BLHeli_32"]
  node_arm["BLHeli_32 firmware"]
  node_armspec["Digital command spec"]
  node_armdocs["BLHeli_32 manual"]
end

subgraph group_artifacts["Firmware Artifacts"]
  node_atmele["Atmel firmware images"]
  node_eeprom["ESC configuration data"]
  node_silabimages["SiLabs images"]
end

node_user(("ESC maintainer"))
node_suite["BLHeliSuite"]
node_suite32["BLHeli_32 app"]
node_esc["ESC board"]
node_readme["Project overview<br/>[README.md]"]

node_user -->|"learns variants"| node_readme
node_user -->|"flashes/configures"| node_suite
node_user -->|"uses for BLHeli_32"| node_suite32
node_suite -->|"flashes/configures"| node_esc
node_suite32 -->|"flashes/configures"| node_esc
node_atmel -->|"variant support"| node_legacyprofiles
node_atmel -->|"firmware images"| node_atmele
node_atmel -->|"configuration files"| node_eeprom
node_silabs -->|"firmware images"| node_silabimages
node_sasm -->|"variant support"| node_sprofiles
node_sasm -->|"firmware images"| node_shex

click node_atmel "https://github.com/bitdump/blheli/blob/master/Atmel/BLHeli.asm"
click node_silabs "https://github.com/bitdump/blheli/tree/master/SiLabs"
click node_legacytypes "https://github.com/bitdump/blheli/tree/master/Atmel"
click node_legacyprofiles "https://github.com/bitdump/blheli/tree/master/Atmel"
click node_legacydocs "https://github.com/bitdump/blheli/blob/master/Atmel/BLHeli%20manual%20Atmel%20Rev14.x.pdf"
click node_sasm "https://github.com/bitdump/blheli/blob/master/BLHeli_S%20SiLabs/BLHeli_S.asm"
click node_sprofiles "https://github.com/bitdump/blheli/tree/master/BLHeli_S%20SiLabs"
click node_shex "https://github.com/bitdump/blheli/tree/master/BLHeli_S%20SiLabs/Hex%20files"
click node_sdocs "https://github.com/bitdump/blheli/blob/master/BLHeli_S%20SiLabs/BLHeli_S%20manual%20SiLabs%20Rev16.x.pdf"
click node_arm "https://github.com/bitdump/blheli/tree/master/BLHeli_32%20ARM"
click node_armspec "https://github.com/bitdump/blheli/blob/master/BLHeli_32%20ARM/BLHeli_32%20Firmware%20specs/Digital_Cmd_Spec.txt"
click node_armdocs "https://github.com/bitdump/blheli/blob/master/BLHeli_32%20ARM/BLHeli_32%20manual%20ARM%20Rev32.x.pdf"
click node_atmele "https://github.com/bitdump/blheli/tree/master/Atmel/Hex%20files"
click node_eeprom "https://github.com/bitdump/blheli/tree/master/Atmel/Eeprom%20files"
click node_silabimages "https://github.com/bitdump/blheli/tree/master/SiLabs/Hex%20files"
click node_readme "https://github.com/bitdump/blheli/blob/master/README.md"

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_atmel,node_silabs,node_legacytypes,node_legacyprofiles,node_legacydocs,node_readme toneBlue
class node_sasm,node_sprofiles,node_shex,node_sdocs toneAmber
class node_arm,node_armspec,node_armdocs toneMint
class node_atmele,node_eeprom,node_silabimages toneRose
class node_user,node_suite,node_suite32,node_esc toneIndigo
```

## Components

### Legacy BLHeli

- [Atmel firmware](https://github.com/bitdump/blheli/blob/master/Atmel/BLHeli.asm): `Atmel/BLHeli.asm`
- [SiLabs firmware](https://github.com/bitdump/blheli/tree/master/SiLabs): `SiLabs`
- [Motor variants](https://github.com/bitdump/blheli/tree/master/Atmel): `Atmel`
- [Board profiles](https://github.com/bitdump/blheli/tree/master/Atmel): `Atmel`
- [Legacy manuals](https://github.com/bitdump/blheli/blob/master/Atmel/BLHeli%20manual%20Atmel%20Rev14.x.pdf): `Atmel/BLHeli manual Atmel Rev14.x.pdf`

### BLHeli_S

- [SiLabs assembly](https://github.com/bitdump/blheli/blob/master/BLHeli_S%20SiLabs/BLHeli_S.asm): `BLHeli_S SiLabs/BLHeli_S.asm`
- [MCU profiles](https://github.com/bitdump/blheli/tree/master/BLHeli_S%20SiLabs): `BLHeli_S SiLabs`
- [BLHeli_S images](https://github.com/bitdump/blheli/tree/master/BLHeli_S%20SiLabs/Hex%20files): `BLHeli_S SiLabs/Hex files`
- [BLHeli_S manual](https://github.com/bitdump/blheli/blob/master/BLHeli_S%20SiLabs/BLHeli_S%20manual%20SiLabs%20Rev16.x.pdf): `BLHeli_S SiLabs/BLHeli_S manual SiLabs Rev16.x.pdf`

### BLHeli_32

- [BLHeli_32 firmware](https://github.com/bitdump/blheli/tree/master/BLHeli_32%20ARM): `BLHeli_32 ARM`
- [Digital command spec](https://github.com/bitdump/blheli/blob/master/BLHeli_32%20ARM/BLHeli_32%20Firmware%20specs/Digital_Cmd_Spec.txt): `BLHeli_32 ARM/BLHeli_32 Firmware specs/Digital_Cmd_Spec.txt`
- [BLHeli_32 manual](https://github.com/bitdump/blheli/blob/master/BLHeli_32%20ARM/BLHeli_32%20manual%20ARM%20Rev32.x.pdf): `BLHeli_32 ARM/BLHeli_32 manual ARM Rev32.x.pdf`

### Firmware Artifacts

- [Atmel firmware images](https://github.com/bitdump/blheli/tree/master/Atmel/Hex%20files): `Atmel/Hex files`
- [ESC configuration data](https://github.com/bitdump/blheli/tree/master/Atmel/Eeprom%20files): `Atmel/Eeprom files`
- [SiLabs images](https://github.com/bitdump/blheli/tree/master/SiLabs/Hex%20files): `SiLabs/Hex files`

### Other components

- **ESC maintainer**
- **BLHeliSuite**
- **BLHeli_32 app**
- **ESC board**
- [Project overview](https://github.com/bitdump/blheli/blob/master/README.md): `README.md`

## Connections

- ESC maintainer → Project overview: learns variants
- ESC maintainer → BLHeliSuite: flashes/configures
- ESC maintainer → BLHeli_32 app: uses for BLHeli_32
- BLHeliSuite → ESC board: flashes/configures
- BLHeli_32 app → ESC board: flashes/configures
- Atmel firmware → Board profiles: variant support
- Atmel firmware → Atmel firmware images: firmware images
- Atmel firmware → ESC configuration data: configuration files
- SiLabs firmware → SiLabs images: firmware images
- SiLabs assembly → MCU profiles: variant support
- SiLabs assembly → BLHeli_S images: firmware images
