Skip to the content
4 layers66.4 × 163.6 mmDucker Charger, the printed circuit board in 3D

an open source custom power bank

Size
66.4 × 163.6 mm
Copper layers
4
Thickness
1.6 mm
Parts
278
Nets
231
Pads
952
Tracks, vias
2,195, 876
Pours
59
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
14 May 2025
Updated
15 Jul 2026

Overview

Ducker Charger is an open-source printed circuit board by Angelussss, from the Angelussss/Ducker-Charger repository on GitHub. It is a 4-layer board of 66.4 × 163.6 mm with 278 parts on 231 nets, routed with 2,195 tracks and 876 vias.

It is built around the TPS54302, BSC040N08NS5 and AO3400A, with the AO4407A, TYPE-C-31-M-12 and USBLC6-4SC6 among its other parts. Its parts include 86 capacitors, 68 resistors, 14 transistors, 6 inductors and 5 diodes. It belongs with the power boards of this library.

Main components

6

README

README.md

⚡ Ducker-Charger

A fully custom, open-source smart power bank, designed from scratch.

4S3P Li-Ion pack · bidirectional USB-PD · bench-supply output · TFT telemetry UI

Project Status License KiCad MCU

Enclosure renderUI demo
Enclosure (prototype 3, lid off)Live telemetry UI

[!WARNING] Work in progress: the design is not yet validated. This project involves Li-Ion batteries, which can overheat, catch fire, or explode if mishandled. Take any information here at your own risk and read the safety note below.

🌟 Highlights

  • 115 Wh: 12× 18650 cells (Sony Murata VTC5, 4S3P), 14.4 V nominal / 16.8 V max
  • 2× USB-C PD: primary port is bidirectional (charges the pack and powers loads)
  • 2× USB-A: fixed 5 V, individually switchable, current-monitored
  • Lab output: banana-jack rail that behaves like a bench power supply
  • Hardware-autonomous BMS: BQ77915 protection works even if all firmware fails
  • STM32F401 supervisor: power-state FSM, charge management, TFT + rotary-encoder UI
  • On-device gauge calibration: guided 9-step wizard on the display; a multimeter is the only tool needed (no bqStudio / EV2400)
  • Develop without hardware: full-PCB emulator, desktop UI simulator, host-side unit tests

⚠️ Safety & Disclaimer

  • I assume no liability for any damage to property, people, or components resulting from the construction or use of this project.
  • Always double-check polarity before connecting the batteries.
  • Do not attempt to assemble this circuit if you are not experienced in handling lithium batteries.

🛠️ Requirements

Hardware

  • Assembled mainboard + Sensing-Board (PCB/)
  • 12× 18650 Li-Ion cells, 4S3P (e.g. Sony/Murata VTC5)
  • ST-Link V2 (or compatible SWD probe) to flash the STM32F401RBT6
  • A USB-PD charger for the primary port, plus USB-C/USB-A cables to exercise the outputs

Software

  • arm-none-eabi-gcc: the firmware builds via the CubeMX-generated Makefile in firmware/cubeMX/, no IDE required
  • st-flash (stlink-tools) or STM32CubeProgrammer, to flash over SWD
  • gcc + SDL2: only needed for firmware/emulator/ and firmware/interface-tester/ (no hardware required to run these)
  • Optional: STM32CubeIDE / STM32CubeMX, only to regenerate peripheral init code from cubeMX.ioc

🧩 Architecture

Distributed design: cell safety, power conversion, PD negotiation and gauging each live in a dedicated IC; the STM32 supervises, aggregates telemetry and drives the UI. Block diagram in PCB/README.md.

Full IC breakdown (10 subsystems)
SubsystemPartRole
Safety / ProtectionTI BQ77915 + N-ch MOSFETsAutonomous, software-independent cell OV/UV/SC/OC cutoff (4S, always-on)
ChargerTI BQ25713Buck-boost NVDC battery charger (driven by the TPS25750 on a private I²C bus)
Main USB-C PDTI TPS25750Primary PD port controller; patch bundle streamed by the MCU at every boot
Aux USB-C PDInfineon CYPD3175 (CCG3PA)Secondary PD port negotiation (replaced the EOL STUSB4710)
Aux programmable railST STPD01I²C-programmable supply for the secondary USB-C / lab output
Fuel gaugeTI BQ34Z100-R2Impedance Track™ State-of-Charge / Time-to-Empty
TelemetryTI INA32213-channel voltage/current monitoring
Step-downTI TPS54302 / TPS54202Auxiliary rails
ESD / I²C isolationUSBLC6, ISO1540Port ESD protection, isolated I²C to the battery-referenced gauge
HostSTM32F401RBT6I²C master, power-state FSM, thermal manager, HMI / supervisor

📂 Repository

PathContents
PCB/KiCad projects: main board + cell sensing board
firmware/STM32 firmware, PD controller configs, emulator, UI simulator, tests
docs/Documentation, start here
powerbank_enclosure/3D-printable enclosure (F3D, STEP, STL, renders)
Full tree
text
Ducker-Charger/
├── PCB/
│   ├── Ducker-Charger/         # Main charger board (schematics, layout, datasheets)
│   └── Sensing-Board/          # Cell sensing board
├── firmware/
│   ├── cubeMX/                 # STM32F401 firmware (FSM, charge mgmt, UI, drivers)
│   ├── TPS25750/               # Primary PD controller config (JSON project + .bin)
│   ├── CYPD3175/               # Secondary PD controller firmware (hex, patches, LED driver)
│   ├── emulator/               # Full-PCB emulator: real firmware vs IC models (SDL)
│   ├── interface-tester/       # Desktop UI simulator (SDL)
│   └── tests/                  # Host-side unit tests (FSM, charge, HPI, math)
├── powerbank_enclosure/        # 3D-printable enclosure (F3D, STEP, STL, renders)
└── docs/
    ├── hardware/               # Power architecture, pin map / BSP reference
    ├── firmware/               # Architecture, FSM, charge mgmt, boot, UI
    └── assets/                 # UI demo gif

📖 Documentation

Start from docs/README.md: full system overview and a walkthrough of how the firmware works, with links to:

🎮 User Guide

Boots to MAIN (battery %, voltage/current, live current graph). Rotate the encoder to cycle MAIN → DETAILS → GRAPH → PORTS → STATS; press to open SETTINGS (per-port toggles, Lab output voltage/current, USB-C2 output ceiling, lock-all, brightness/auto-sleep, gauge calibration wizard, shutdown). A long press (or SETTINGS → Shutdown) puts the device into deep sleep; a short press wakes it back up if a charger is attached. Fault conditions open a dedicated FAULT screen automatically, naming the cause.

Full screen-by-screen reference: docs/firmware/UI_and_Display.md.

🎥 Presentation & Demo

👥 Team & Contributions

The project is split by layer, one owner per layer end-to-end (design, implementation, docs, tests):

MemberLayer owned
Angelo PerottiHardware (PCB/KiCad), CubeMX project bring-up, boot & IC provisioning
Francesco BrunelliCharge management: sensors, actuators, fault detection
Michelangelo CaliaPower-state FSM & fault handling
MayaDisplay/UI stack: driver, widgets, screens, navigation

🤝 Contributing

Issues, suggestions, and pull requests are momentarily suspended, as this is a university course project.

📜 License

Released under the Creative Commons Attribution-NonCommercial 4.0 Internationalç License (CC BY-NC 4.0). © 2026 Angelo Perotti.

You are free to use, modify, and build upon this work for non-commercial purposes, as long as you credit the author. See NOTICE for attribution details.

Parts

278
QtyValueFootprintReferences
18100nCapacitor_SMD:C_0603_1608MetricC242, C246, C306, C307, C401, C402, C403, C405, C406, C407, C410, C411, C415, C420, C505, C506 +2
1810kResistor_SMD:R_0603_1608MetricR202, R206, R213, R216, R305, R306, R309, R310, R401, R403, R404, R407, R415, R417, R419, RCDC301 +2
151kResistor_SMD:R_0603_1608MetricR_VDD501, R223, R301, R302, R318, R408, R416, R418, R502, R503, R504, R505, R506, RCHG501, RDSG501
111uCapacitor_SMD:C_0805_2012MetricC_VDD501, C_VDD502, C201, C202, C241, C404, C501, C502, C503, C504, C509
1010u 25VCapacitor_SMD:C_1206_3216MetricC232, C235, C236, C237, C238, C239, C240, C303, C304, C413
9100kResistor_SMD:R_0603_1608MetricR224, R303, R304, R307, R308, R312, R314, R507, Ron301
710u 35VCapacitor_SMD:C_1206_3216MetricC203, C204, C206, C208, C209, C210, C212
74k7Resistor_SMD:R_0603_1608MetricR409, R410, R411, R412, R420, R514, R516
622uCapacitor_SMD:C_0805_2012MetricC310, C311, C312, C313, C417, C418
6BSC040N08NS5EasyEDA:PG-TDSON-8_L5.9-W5.1-P1.27-LS6.2-BLQ201, Q202, Q203, Q204, Q501, Q502
5AO3400AEasyEDA:SOT-23-3_L2.9-W1.3-P1.90-LS2.4-BRQ301, Q302, Q303, Q304, Q401
410u 5AInductor_SMD:L_7.3x7.3_H4.5L202, L301, L302, L303
422u 35VCapacitor_SMD:C_1210_3225MetricC213, C216, Cout301, Cout302
44.7uCapacitor_SMD:C_0805_2012MetricC219, C247, C248, C510
310Resistor_SMD:R_0603_1608MetricR201, R220, R222
3100nResistor_SMD:R_0603_1608MetricC309, C391, CVBAT401
3100u 16VCapacitor_SMD:C_1210_3225MetricC220, C223, C225
313.3kResistor_SMD:R_0603_1608MetricR225, R313, R315
31MResistor_SMD:R_0603_1608MetricR208, RGS501, RGS502
3AO4407AEasyEDA:SOIC-8_L4.9-W3.9-P1.27-LS6.0-BLQ205, Q305, Q306
3LEDLED_SMD:LED_0603_1608MetricD202, D302, D401
3TPS54302Package_TO_SOT_SMD:SOT-23-6U203, U303, U304
2100Resistor_SMD:R_0603_1608MetricR508, R509
2100pCapacitor_SMD:C_0603_1608MetricC224, C227
210mResistor_SMD:R_1206_3216MetricRshunt301, Rshunt302
210mEasyEDA:R3920R212, R221
210nCapacitor_SMD:C_0603_1608MetricC222, C249
210uCapacitor_SMD:C_0805_2012MetricC228, C230
210u 16VCapacitor_SMD:C_0603_1608MetricC207, C226
218pCapacitor_SMD:C_0603_1608MetricC409, C412
22.2uCapacitor_SMD:C_0805_2012MetricC327, C408
2220kResistor_SMD:R_0603_1608MetricR204, R511
222u 16VCapacitor_SMD:C_0805_2012MetricC244, C245
2330pCapacitor_SMD:C_0603_1608MetricC233, C234
2390pResistor_SMD:R_0603_1608MetricC305, C308
24.7u 50VCapacitor_SMD:C_0805_2012MetricC301, C302
24.99Resistor_SMD:R_0603_1608MetricR210, R214
247nCapacitor_SMD:C_0603_1608MetricC229, C231
2DebugEagle_Connectors:SAMTEC_FTSH-107-01-L-DV-K-TRJ304, J401
2LOGOLOGOG***, G***
2TYPE-C-31-M-12EasyEDA:USB-C_SMD-TYPE-C-31-M-12_1USBC201, USBC301
2USBLC6-4SC6EasyEDA:SOT-23-6_L2.9-W1.6-P0.95-LS2.8-BLD201, D301
2USB_AConnector_USB:USB_A_Molex_67643_HorizontalJ301, J302
10Resistor_SMD:R_0603_1608MetricR501
10.1Capacitor_SMD:C_0805_2012MetricC243
10.1uCapacitor_SMD:C_0805_2012MetricC414
11Resistor_SMD:R_0603_1608MetricR209
1100nResistor_SMD:R_Array_Concave_4x0603CN401
1100nCapacitor_SMD:C_0805_2012MetricC416
1100n 50VCapacitor_SMD:C_0603_1608MetricCBOOT301
1105kResistor_SMD:R_0603_1608MetricR406
110KResistor_SMD:R_0603_1608MetricR510
110kResistor_SMD:R_Array_Convex_4x0603RN401
110uInductor_SMD:L_6.3x6.3_H3L401
110u 50VCapacitor_SMD:C_0805_2012MetricCin301
1137kResistor_SMD:R_0603_1608MetricR215
1150kResistor_SMD:R_0603_1608MetricR218
115kResistor_SMD:R_0603_1608MetricR515
115pCapacitor_SMD:C_0603_1608MetricC221
116.5kResistor_SMD:R_0603_1608MetricR513
116MHzCrystal:Crystal_SMD_EuroQuartz_MT-4Pin_3.2x2.5mmY401
11800pCapacitor_SMD:C_0603_1608MetricC217
11uResistor_SMD:R_0603_1608MetricC314
12.2Resistor_SMD:R_0603_1608MetricR205
12.2u 20AInductor_SMD:L_Chilisin_BMRF00131360L201
1200kResistor_SMD:R_0603_1608MetricR311
120AFuse:Fuseholder_Cylinder-5x20mm_Schurter_0031_8201_Horizontal_OpenF102
122.1kResistor_SMD:R_0603_1608MetricR413
1220Resistor_SMD:R_0603_1608MetricR402
125mResistor_SMD:R_1206_3216MetricRsns301
127kResistor_SMD:R_0603_1608MetricR219
12mEasyEDA:R3920RSNS501
13.3uCapacitor_SMD:C_0805_2012MetricC205
1300kResistor_SMD:R_0603_1608MetricR512
130kResistor_SMD:R_0603_1608MetricR217
1330kResistor_SMD:R_0603_1608MetricR207
133nCapacitor_SMD:C_0603_1608MetricC215
133pCapacitor_SMD:C_0603_1608MetricC214
1383kResistor_SMD:R_0603_1608MetricR203
14.7nCapacitor_SMD:C_0805_2012MetricCCDC301

The 227 most common of 278 parts.

More from Angelussss/Ducker-Charger

1
  • 2 layers70.5 × 99 mmSensing Board, the printed circuit board in 3D

    Sensing Board

    Angelussss/Ducker-Charger

    an open source custom power bank

    7 parts20

Similar boards

  • 4 layers100 × 65 mmAmpere, the printed circuit board in 3D

    Ampere

    LtBrain/Ampere

    A variable benchtop power supply

    214 partsMIT
  • 4 layers106 × 100 mmPOE POWER, the printed circuit board in 3D

    POE POWER

    ssmo-oss/UMI-Power-distribution

    Three separate boards distribute a 12 V supply to the UMI system. D6 is the current prototype revision. It has not been physically qualified or approved for production.

    60 parts
  • 4 layers100 × 55 mmPMP41115, the printed circuit board in 3D

    PMP41115

    Tim4769/usb-c-pd31-epr-charger

    KiCad hardware, firmware artifacts, and validation notes for a bidirectional USB-C PD 3.1 EPR buck-boost charger targeting 240 W.

    158 parts
  • 4 layers107.2 × 83.8 mmPd test, the printed circuit board in 3D

    Pd test

    Yuan-Quan/pet-climate-control

    74 parts
  • 4 layers48 × 42 mmGimme danger, the printed circuit board in 3D

    Gimme danger

    EDA-bench/eda-bench

    Execution-based benchmark for open-book KiCad PCB reconstruction agents

    113 parts4
  • 2 layers100 × 120 mmDcc station, the printed circuit board in 3D

    Dcc station

    cc90202/DCC-esp32

    DCC command station for ESP32-C6 — NMRA-compliant model railroad controller in Rust

    82 parts12
  • 2 layers79.9 × 68.3 mmBoard v1.1, the printed circuit board in 3D

    Board v1.1

    stustanet/spacelock

    hackerspace lock

    117 parts1
  • 6 layers250.3 × 123.8 mmRGBMatrix, the printed circuit board in 3D

    RGBMatrix

    KuruczKende/RGBMatrix

    Links to components: Shift Register: https://www.lcsc.com/product-detail/C45333837.html Resistor document: https://www.lcsc.com/datasheet/C1731305.pdf RGB Leds…

    566 parts

Questions

How big is the Ducker Charger PCB?

It measures 66.4 × 163.6 mm and has 4 copper layers, 1.6 mm thick.

What parts does the Ducker Charger use?

278 parts, built around the TPS54302, BSC040N08NS5, AO3400A and AO4407A. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Ducker Charger KiCad files?

From the Angelussss/Ducker-Charger repository on GitHub, at the commit this page was made from: the board is PCB/Ducker-Charger/Ducker-Charger.kicad_pcb and its schematic PCB/Ducker-Charger/BMS.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Ducker Charger design in my own project?

Its repository states no licence, so its author keeps all rights: ask Angelussss before reusing the design.