RPi Mini Battery Display

用于在Raspberry Pi上控制基于TM1651芯片的10段式迷你电池显示器（如Open-Smart的产品）的库和命令行程序。

系统要求

rpi-mini-battery-display库是为在Raspberry Pi上运行而编写的。它已在Raspbian Buster (10)和Python 3.7上进行了测试。

如果您没有pip，请先使用以下命令安装它：

sudo apt install python3-pip

此库使用RPi.GPIO库与TM1651芯片通信。Raspbian中的默认用户pi已经拥有GPIO访问的权限。如果您想以其他用户身份使用库，该用户需要属于gpio组以获得正确的权限。这可以通过以下方式完成：

sudo adduser $USER gpio

安装

sudo pip3 install rpi-mini-battery-display

连接

迷你电池显示器应按照以下方式连接到Raspberry Pi的GPIO引脚

请参阅 pinout.xyz 以获取 Raspberry Pi GPIO 引脚图。

CLK 和 DIO 引脚可以连接到 Raspberry Pi 的其他引脚，但这些是代码使用的默认值。如果您更改了连接，您必须将其他引脚值作为参数提供给软件。

用法

您可以使用 rpi-mini-battery-display 程序将电池显示级别设置为 0 到 7，或者将其设置为显示 CPU 百分比，从 0（小于 12.5%）到 7（大于 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

用例

这些显示器在您希望在 Raspberry Pi 上以低成本显示状态的情况下非常有用。例如，我正在使用它们来显示我的六节点集群中每个 Raspberry Pi 的 CPU 负载。

这实际上是我开发 rpi-mini-battery-display 库的动机。

变更日志

• 0.3.0 (2020-02-28)：将代码重构为更符合 Python 风格，而不是 C++/Arduino 风格。
• 0.2.0 (2020-01-27)：添加显示 CPU 百分比的选项。
• 0.1.0 (2020-01-26)：初始版本。

待办事项

• 单独处理 LED 段，而不仅仅是将它们用作 LED 条（相当简单，我已经尝试过，但尚未实现必要的方法）。
• 添加切换 LED 条方向的选项。
• 使用 mypy 添加静态类型。
• 支持基于 TM1651 芯片的迷你电池显示器的其他版本，例如 5 段式。
• 支持其他迷你电池显示器，例如使用 MY9221 芯片的 Grove LED 条。

开发者注意

• TM1651 是 Titan Micro Electronics 系列的 LED 驱动控制芯片之一。该制造商的其他流行类似芯片还包括 TM1637 和 TM1640。
• TM1651 英文数据表

许可

该项目由 Koen Vervloesem 提供，作为开源软件，使用 MIT 许可。有关更多信息，请参阅 LICENSE 文件。