BM Generator 3000

Test generator for battery cyclers.

Supported formats: Basytec, Neware, Digatron, JSON-LD.

Documentation: https://digibatt.github.io/bmgen

Examples: examples

Setup

The Python package is available on PyPI and can be installed using pip:

pip install bm-generator

The web version of the program can be started using the command:

bmgen-server

Installation from sources

The required dependencies and the package itself can also be installed from the sources using pip:

pip install -e .[dev]

A working installation of Python >= 3.10 and pip is required. The web version also requires npm. To build the modules for the web version and the documentation, the provided build script can be used:

./build.sh

Documentation

The documentation is built using the script

./build_docs.sh

Examples

This is a simple example that shows the basic structure of a program:

# import required functions and channel variables
from bmgen.function import *
from bmgen.channel import *

# set data recording interval
# registration format is only applied to BM programs
register(time=seconds(1), format=["my_custom_reg"])

# set safety limits
limit(V > 4.2, error(1))
limit(V < 2.5, error(1))
limit(I > 5, error(1))
limit(I < -5, error(1))

# specify test steps
charge(current=2.0, voltage=4.2, limits=[I < 0.2])
pause(hours=1)
discharge(current=1.5, limits=[V < 3.0])

To see the test programs that are generated, expand the sections below.

Web Interface

The easiest way to get started is using the web version by running the command:

bmgen-server

The web interface can be accessed at http://localhost:5000

CLI

The program can also be used as a command line tool:

bmgen

The only required argument is the filename of the Python program to be translated. A dash ( - ) can be used to read from standard input.

The following options are supported:

-t, --target

Set the target language. Available values are bm, neware, and basytec. The default value is bm.

-f, --format

Set the target format. The supported formats depend on the target:

BM:

• text (default): Plain text file that can be pasted into the Battery Manager
• table: HTML table resembling the Battery Manager interface for test programs

Neware:

• xml (default): XML file that can be opened in the Neware client
• table: HTML table resembling the Neware interface for test programs

Basytec:

• text (default): Plain text PLN file that can be opened in the Basytec program
• table: HTML table resembling the Basytec interface for test programs

-o, --out

Name of the output file. If this option is not provided, the output is written to the terminal.