Plasma：LED序列

Plasma是一个LED/Light序列套件，旨在将多种LED串/板类型和接口标准化，以提供一次编写、任意运行的照明代码API。

Plasma还包括plasmad，这是一个用于使用PNG图像提供动画帧的序列灯光的系統守护进程。

兼容产品

Plasma最初是为了提供一种简单的方式来序列化灯光和交换Pimoroni Plasma套件中的模式而编写的。

• https://shop.pimoroni.com/products/picade-plasma-kit-illuminated-arcade-buttons
• https://shop.pimoroni.com/products/player-x-usb-games-controller-pcb
• https://shop.pimoroni.com/products/blinkt
• https://shop.pimoroni.com/products/unicorn-hat
• https://shop.pimoroni.com/products/unicorn-phat

安装

完整安装（推荐）

我们创建了一个简单的安装脚本，它将安装所有预选条件，并使您的Plasma Arcade Button Lights以最少的努力启动和运行。要运行它，请在Raspberry Pi桌面上打开终端，您可以在菜单 -> 附件 -> 终端中找到它，如下所示

在新的终端窗口中，键入以下命令（请检查是否有误）并遵循屏幕上的说明

curl https://get.pimoroni.com/plasma | bash

如果您选择下载示例，您可以在 /home/pi/Pimoroni/plasma/ 中找到它们。

手动安装

sudo pip3 install plasmalights

使用Plasma守护进程

要安装Plasma守护进程，您应克隆此存储库，导航到“daemon”目录并运行安装程序

git clone https://github.com/pimoroni/plasma
cd plasma/daemon
sudo ./install

注意：如果您正在使用Picade Player X，您应该编辑daemon/etc/systemd/system/plasma.service，并将输出设备选项从-o GPIO:15:14更改为-o SERIAL:/dev/ttyACM0。如果您正在使用Unicorn HAT或pHAT，则应使用-o WS281X:WS2812:18:0。

如果您在Picade HAT上使用GPIO，您可以使用-o GPIO:<data>:<clock>相应地调整引脚，其中data和clock是有效的BCM引脚。如果您使用旧的Plasma/Hack头，您可能需要根据您的连接方式将-o GPIO:15:14更改为-o GPIO:14:15。

Plasma守护进程安装程序将两个程序安装到您的Raspberry Pi上。plasma自身以及一个名为plasmactl的工具，您可以使用它来安装和切换灯光效果。Plasma作为系统服务运行。

plasmactl命令

• plasmactl 255 0 0 - 将Plasma灯光设置为R，G，B颜色。在这种情况下为红色。
• plasmactl <pattern> - 将Plasma灯光设置为图案图像
• plasmactl fps <fps> - 更改Plasma效果的帧率（默认为30，较低的FPS=较低的CPU使用率）
• plasmactl --list - 列出所有可用的图案
• sudo plasmactl --install <pattern> - 安装新图案，其中<pattern>是24位PNG图像文件的文件名

开发

如果您想贡献或喜欢坐在最新代码的边缘，您应该克隆此存储库，cd到库目录，然后运行

sudo python3 setup.py install

文档和支持

• 指南和教程 - https://learn.pimoroni.com/plasma
• 功能参考 - http://docs.pimoroni.com/plasma/
• 寻求帮助 - http://forums.pimoroni.com/c/support

变更日志

2.0.2

• 通过Plasma矩阵传递亮度值到底层LED驱动程序

2.0.1

• 新的auto()可以直接接受配置文件路径（用于Plasma守护进程）
• 新的Matrix和Core现在在set_sequence中接受列表和字典类型的序列
• 新的Matrix配置支持一个“启用”选项，用于轻松切换配置
• 错误修正Matrix在尝试删除非必需选项时捕获KeyError

2.0.0

• 移植到Python >=3.7，弃用Python 2.7支持
• 重大的重构和重构
• 配置文件支持配置LED类型/关系
• 支持WS382X
• APA102支持Chip-Select
• PlasmaMatrix用于组合多个输出设备

1.0.0

• API重构，使用plasma.legacy用于旧API
• 支持Picade Player X的USB

0.0.1

• 初始发布