新手必看：Piano LED Visualizer的树莓派安装与配置教程

【免费下载链接】Piano-LED-Visualizer Piano LED Visualizer: Connect an LED strip to your Raspberry Pi and create an immersive visual experience for your piano playing 项目地址: https://gitcode.com/gh_mirrors/pi/Piano-LED-Visualizer

Piano LED Visualizer是一款能让你的钢琴演奏焕发全新视觉体验的开源项目，通过将LED灯带连接到树莓派，为你的弹奏创造沉浸式的光影效果。本教程将带你快速完成从系统准备到LED灯效调试的全过程，即使是没有编程经验的新手也能轻松上手。

📋 准备工作：你需要这些材料

开始安装前，请确保准备好以下硬件和软件：

• 树莓派（推荐Raspberry Pi Zero或更高型号）
• 兼容的LED灯带（如WS2812B）
• 8GB及以上容量的microSD卡
• 钢琴MIDI接口（USB或蓝牙）
• 电脑（用于烧录系统和SSH连接）
• 杜邦线、电源适配器等基础电子元件

🔧 系统安装：3步完成树莓派初始化

1. 烧录操作系统

使用Raspberry Pi Imager工具将Raspberry Pi OS Lite写入SD卡：

1. 选择操作系统为「Raspberry Pi OS Lite」
2. 点击齿轮图标设置高级选项：
   • 主机名：pianoledvisualizer.local
   • 启用SSH
   • 创建用户：plv，密码：visualizer
   • 配置WiFi（可选）
3. 写入完成后将SD卡插入树莓派并启动

2. 连接树莓派

通过SSH连接树莓派（需在同一网络）：

ssh plv@pianoledvisualizer.local

密码输入visualizer即可登录

3. 一键安装脚本（推荐）

执行官方自动安装脚本，自动完成依赖配置：

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/onlaj/Piano-LED-Visualizer/master/autoinstall.sh)"

⚠️ 若自动安装失败，请参考手动安装指南完成步骤

🛠️ 硬件连接：LED灯带安装指南

接线示意图

图中展示了钢琴键盘上LED灯带的安装位置及接线方式，黄色箭头标注了SENSE_COVER、VCC、DATA和GND的连接点

连接步骤

1. 将LED灯带的数据引脚（DATA）连接到树莓派的SPI接口（GPIO10）
2. 电源引脚（VCC）连接5V电源，接地引脚（GND）连接树莓派GND
3. 若使用琴盖检测功能，需安装Reed-Switch并连接到SENSE_COVER引脚

⚙️ 基础配置：通过配置文件自定义效果

核心配置文件位于config/default_settings.xml，可修改以下关键参数：

LED基本设置

<brightness_percent>50</brightness_percent>  <!-- 亮度（0-100） -->
<fadingspeed>1000</fadingspeed>              <!-- 渐隐速度（值越大越慢） -->
<color_mode>Single</color_mode>               <!-- 颜色模式：Single/Rainbow/Multicolor -->

颜色模式配置

• 单色模式：设置RGB值

  <red>255</red>
  <green>255</green>
  <blue>255</blue>
  

• 彩虹模式：调整色彩范围和偏移

  <rainbow_colormap>matplotlib_rainbow</rainbow_colormap>
  <rainbow_scale>100</rainbow_scale>
  

🎹 启动与测试：让LED随音乐跳动

手动启动程序

cd /home/Piano-LED-Visualizer
sudo python3 visualizer.py

设置开机自启

已通过安装脚本自动配置系统服务，如需修改可编辑：

sudo nano /lib/systemd/system/visualizer.service

常见参数调整：

• 旋转屏幕：--rotatescreen true
• 不同显示屏：--display 1in3（适用于WaveShare 1.3英寸屏）

📱 高级功能：Web界面控制

项目内置Web管理界面，在浏览器中访问树莓派IP即可：

• 调整LED颜色和动画效果
• 管理MIDI文件（Songs/目录）
• 配置端口和连接方式
• 创建灯光序列（config/sequences.xml）

❓ 常见问题解决

1. LED灯带不亮

• 检查SPI接口是否启用：sudo raspi-config nonint do_spi 0
• 确认接线顺序：DATA→GPIO10，VCC→5V，GND→GND

2. MIDI无响应

• 在Web界面的「端口设置」中选择正确的输入源
• 蓝牙连接需配对设备并选择「RPI Bluetooth」模式

3. 效果卡顿

• 降低LED数量（修改配置文件中的<led_count>）
• 减少动画复杂度（降低<pulse_animation_speed>）

🎨 自定义效果：探索更多可能性

• 色彩方案：尝试Colormaps/目录中的预设，如cmasher_neon.sRGB.data
• 动画脚本：修改lib/led_animations.py实现自定义动画
• 学习模式：启用LearnMIDI功能（lib/learnmidi.py）跟随指示灯练习

通过本教程，你已经掌握了Piano LED Visualizer的基本安装和配置方法。现在就发挥创意，打造属于你的钢琴光影舞台吧！如有更多疑问，可查阅项目文档或加入社区讨论。

【免费下载链接】Piano-LED-Visualizer Piano LED Visualizer: Connect an LED strip to your Raspberry Pi and create an immersive visual experience for your piano playing 项目地址: https://gitcode.com/gh_mirrors/pi/Piano-LED-Visualizer