Skip to main content

Control 10-segment mini battery displays on a Raspberry Pi

Project description

RPi Mini Battery Display

Continous Integration PyPI package version Python versions GitHub license

Library and command-line program to control 10-segment mini battery displays based on the TM1651 chip, such as the ones from Open-Smart, on a Raspberry Pi.

System requirements

The rpi-mini-battery-display library is written to run on a Raspberry Pi. It uses the RPi.GPIO library to communicate with the TM1651 chip and is tested on Python 3.6 and higher.

Installation

sudo pip3 install rpi-mini-battery-display

Connections

The mini battery display should be connected like this to the Raspberry Pi's GPIO header:

Mini Battery Display Raspberry Pi
CLK BCM24
DIO BCM23
VCC 5 V
GND GND

See pinout.xyz for the Raspberry Pi GPIO pinout.

The CLK and DIO pin can be connected to other pins on the Raspberry Pi, but these are the default values used by the code. If you change the connections, you have to supply the other pin values as parameters to the software.

Usage

usage: rpi-mini-battery-display [-h] [-c CLOCK_PIN] [-d DATA_PIN]
                                [-b BRIGHTNESS]
                                level

Control a 10 LED mini battery display with TM1651 chip

positional arguments:
  level                 Battery level (range: 0-7)

optional arguments:
  -h, --help            show this help message and exit
  -c CLOCK_PIN, --clock-pin CLOCK_PIN
                        Clock pin in BCM notation (default: 24, range: 0-27)
  -d DATA_PIN, --data-pin DATA_PIN
                        Data pin in BCM notation (default: 23, range: 0-27)
  -b BRIGHTNESS, --brightness BRIGHTNESS
                        Brightness (default: 2, range: 0-7)

Changelog

  • 0.0.1 (2020-01-26): Initial version

TODO

  • Code refactoring, as this project currently is a rather direct Python port of the original C++/Arduino code that came with the mini battery display I bought on AliExpress.
  • Individually address the LED segments instead of only using them as a LED bar (fairly trivial to implement).
  • Add static typing with mypy.
  • Support other versions of the mini battery displays based on the TM1651 chip, for instance the 5-segment one.
  • Support other mini battery displays, such as the Grove LED Bar, which uses the MY9221 chip.

License

This project is provided by Koen Vervloesem as open source software with the MIT license. See the LICENSE file for more information.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for rpi-mini-battery-display, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size rpi_mini_battery_display-0.1.0-py3-none-any.whl (6.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size rpi-mini-battery-display-0.1.0.tar.gz (4.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page