Pakieciarka

Version 0.1.9 · free and open source (GPL 3)

An 18650 pack - worked out before you weld it

Pakieciarka (Polish for "pack maker") is a configurator for battery packs made of 18650 and 21700 cells. Choose a cell and a layout, such as 13S5P, and the program works out the voltages, currents and weight, picks the nickel strip, BMS and fuse, draws the connections of every cell, prints a welding template and writes G-code for a CNC spot welder.

For Linux (AppImage, .deb) and macOS (.dmg), and as a web page in the browser. The interface and the guide are in Polish for now. The results are approximate - you build your battery at your own risk.

Layout and connections of a 13S5P e-bike pack: cell groups, series and parallel strips, balance taps
Current version
0.1.9
Price
free
Licence
open source, GPL 3
Runs on
Linux, macOS and the browser
Cells
18650 and 21700, 20 models built in + your own
Language
Polish

What it does

From the calculator to the welder's program

A pack for a drill, a scooter, an e-bike or a home energy store starts with a few questions: how many cells, how to connect them, which strip, which BMS. Pakieciarka answers them in one window, and gives you a drawing for the workshop at the end.

01

Calculator

Voltages, capacity, energy, currents and resistance. Voltage drop, losses and run time under load, dimensions and weight, warnings.

02

Ready-made packs

From 1S2P to 20S6P: tools, scooters, e-bikes, energy storage. Or any SxP layout of your own.

03

Layout and connections

A grid or honeycomb, the polarity of every cell, strips on the top and the bottom, balance taps with their voltages and cell numbers.

04

Nickel strip

Which thickness and how many layers of strip for the series and parallel joints and the terminals - taking the material, width and the welder's limits into account.

05

BMS

A list of matching BMS boards (Daly, JBD, JK and your own), a wiring diagram with a fuse, a pin table for the balance plug and the connection order.

06

Heat map

How current flows through the pack: the hottest nickel strips, overloaded pieces of strip and the cells that work harder than the others.

07

1:1 PDF template

The top and bottom of the pack at 1:1 scale with a check ruler, a tap table and a checklist of strips for welding by hand.

08

Large packs from modules

Modules joined in series and in parallel: a diagram, the balance numbering of the whole pack and step-by-step assembly instructions.

09

G-code for the welder

A program for a CNC spot welder with FluidNC or GRBL: weld points, a Z axis with pressure, the bottom side after flipping, a dry-run mode.

10

Cell database

20 popular models with capacity, current, resistance and weight. Add, change, import and export your own cells.

11

My projects

Save with one shortcut, a project library, duplicating, and import and export to a JSON file.

12

On the desktop and in the browser

One program written in Rust runs on Linux, on macOS and as a web page. In the browser everything is computed on your side, not on a server.

Layout and connections: a 13S5P pack, series strips (orange) and parallel strips (grey), balance taps B1…B13

Layout and connections

See every cell and every strip

  • Cells in a grid or a honeycomb, groups snaking back and forth.
  • Each cell shows plus or minus, its cell number and group number, and cell no. 1 has a marker - like "pin 1" on a chip.
  • Parallel and series strips on the top and the bottom, in different colours.
  • Balance taps B0…BS with their voltages, at the points where you solder the wires.
  • The bottom view after turning the pack over sideways or towards you - exactly as you will see it on the bench.
The calculator: electrical values, work under load, mechanics, choice of parts and nickel strip

Calculator

All the numbers on one screen

As soon as you choose a cell and a layout, you see:

  • the nominal, maximum and minimum voltage, capacity, energy and maximum current,
  • work under load - the current per cell, voltage drop, heat losses and run time,
  • the dimensions and weight of the cell block and its energy density,
  • the choice of parts - BMS, charger, main fuse, wires and nickel strip with the allowed current for each kind of joint.
Heat map of a 14S10P pack: wires soldered at the start of the strips, so the cells next to the wires get more current

Heat map

Where the pack will get hot

The heat map works out how current flows through the whole pack: the resistance of every nickel strip, weld and cell, and where the main wire is soldered.

  • Nickel strips are coloured from blue to red - from the coolest to the hottest.
  • Cells are coloured by their current compared with the group average.
  • Under the drawing: the hottest strips with their current and the strip's allowed current - red means overload - and tips on what to improve.

An example from the guide: in a 14S10P pack with the wires at the start of the strips, the first strip of the terminal carries over 50 A. With the wires in the middle of the strips, the load is much more even.

BMS: wiring diagram of a 5S2P pack with a fuse, the balance plug pin table and the connection order

BMS

The balance lead right the first time

A mistake with the balance plug can destroy a BMS board. Pakieciarka shows:

  • a list of BMS boards that fit the pack - Daly, JBD, JK or your own,
  • a wiring diagram of B−, P− and C− with a fuse and a temperature sensor,
  • a pin table for the plug with the nominal and fully charged voltage on every pin,
  • the connection order step by step - with voltage checks before you plug it in.

The table and the diagram also go into the PDF.

G-code: motion and weld trigger settings, a preview of the path in machine coordinates and the program text

CNC spot welder

A program for the welder straight from the drawing

Have a spot welder on a CNC frame? Pakieciarka turns the drawing of the pack into a program:

  • weld triggering from ready templates for FluidNC and GRBL, or your own,
  • a Z axis with pressure and times before and after the pulse,
  • weld points per terminal, their distance from the centre and the rotation of the pattern,
  • the bottom side after flipping the pack, "nearest neighbour" or snake order,
  • a dry-run mode without triggering, and pauses every given number of cells.

The preview shows the head's path, and the summary the number of welds and the estimated time.

Screenshots

See every screen

Click a screenshot to enlarge it. The interface is in Polish.

Layout and connections - top view
Layout and connections - top view
Cells in a honeycomb
Cells in a honeycomb
Calculator and choice of parts
Calculator and choice of parts
Heat map - current flow in the pack
Heat map - current flow in the pack
BMS boards that fit the pack
BMS boards that fit the pack
BMS wiring diagram and balance plug
BMS wiring diagram and balance plug
A large pack built from modules
A large pack built from modules
G-code for a CNC spot welder
G-code for a CNC spot welder
PDF - top of the pack at 1:1 scale
PDF - top of the pack at 1:1 scale
Cell database - built-in and your own
Cell database - built-in and your own

Important

The program helps, but it is no substitute for common sense

Lithium cells shorted by a piece of nickel or a tool can catch fire, and a voltage above 60 V DC is dangerous to life. Pakieciarka's results come from simplified models and rules of thumb - check them against the datasheets of the cells, the BMS and the strip.

Work on a non-flammable surface, balance the cell voltages before connecting them in parallel, measure the taps before connecting the BMS, and run the G-code first in dry-run mode, without cells. The program is free and comes without any warranty - you use it at your own risk.

Installation

Download and run

Ready packages are on the releases page. On the first start the program shows a disclaimer to accept.

Recommended

Linux - AppImage

One file that runs without installing, on any distribution. Download Pakieciarka-…-x86_64.AppImage and run it:

chmod +x Pakieciarka-*-x86_64.AppImage
./Pakieciarka-*-x86_64.AppImage

Debian 13, Ubuntu 24.04 and newer - .deb package

The program goes into the applications menu and is available as the pakieciarka command.

sudo apt install ./pakieciarka_*_amd64.deb

macOS - .dmg

Open Pakieciarka-…-macos.dmg and drag the program into Applications. It runs on Macs with Apple Silicon and Intel (macOS 11+).

The program has no Apple certificate, so the first time open it with the right mouse button: Open → Open.

In the browser - Docker

Pakieciarka as a web page on a home server. The calculations run in the browser, and projects stay in its storage.

git clone https://github.com/cyryllo/Pakieciarka.git
cd Pakieciarka
docker compose up -d --build

The page will be at http://localhost:8080.

The program keeps projects and your own cells in ~/.local/share/pakieciarka - they stay through updates and uninstalling. All features are described step by step in the user guide (in Polish).

What next

Plans

Pakieciarka is young (version 0.1), but it already does everything you need from design to welding. Planned:

  • sending G-code straight to the welder with FluidNC or GRBL over a serial port, with jogging, homing and a test weld,
  • printing large packs at 1:1 on several A4 sheets,
  • editing the cell layout by hand - shapes to fit a particular case.

Report bugs and ideas on GitHub.

Building a pack? Work it out first

Pakieciarka is free and open source. Download it, choose a cell and a layout, print the template - and report your workshop experience on GitHub, in English or Polish.

Screenshots: Cyryl Sochacki, from the Pakieciarka repository (GPL 3), on example projects. The program's interface is in Polish.