Control 10-segment mini battery displays on a Raspberry Pi
RPi Mini Battery Display
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.
The rpi-mini-battery-display library is written to run on a Raspberry Pi. It has been tested on Raspbian Buster (10) with Python 3.7.
If you don't have pip, install it first with:
sudo apt install python3-pip
This library uses the RPi.GPIO library to communicate with the TM1651 chip. The default user
pi in Raspbian has already the right permissions for GPIO access. If you want to use the library as another user, the user needs to be in the
gpio group to have the right permissions. This can be done with:
sudo adduser <username> gpio
sudo pip3 install rpi-mini-battery-display
The mini battery display should be connected like this to the Raspberry Pi's GPIO header:
|Mini Battery Display||Raspberry Pi|
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.
You can use the
rpi-mini-battery-display program to set the level of the battery display from 0 to 7 or to let it show the CPU percentage as a level from 0 (less than 12.5%) to 7 (more than 87.5%):
usage: rpi-mini-battery-display [-h] [-c CLOCK_PIN] [-d DATA_PIN] [-b BRIGHTNESS] (-l LEVEL | -p) Control a 10 LED mini battery display with TM1651 chip 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) -l LEVEL, --level LEVEL Set battery level (range: 0-7) -p, --processor Show CPU percentage
- 0.2.0 (2020-01-27): Added option to show the CPU percentage
- 0.1.0 (2020-01-26): Initial version
- 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, I already played with it but haven't implemented the necessary method yet).
- 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.
This project is provided by Koen Vervloesem as open source software with the MIT license. See the LICENSE file for more information.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size rpi_mini_battery_display-0.2.0-py3-none-any.whl (6.8 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size rpi-mini-battery-display-0.2.0.tar.gz (5.3 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for rpi_mini_battery_display-0.2.0-py3-none-any.whl
Hashes for rpi-mini-battery-display-0.2.0.tar.gz