树莓派Sense HAT红外遥控掌控板RGB灯：跨硬件平台信号解码与控制实践

1. 项目缘起：从“遥控灯”到“掌控互动”的硬件探索

几年前，我在一个创客工作坊里，看到几个中学生围着一块小小的板子，用手机App控制上面的LED灯带变换颜色。他们兴奋地讨论着，如何把家里的台灯也改成这样。那个场景让我印象深刻，也让我意识到，硬件编程的魅力就在于这种“看得见、摸得着”的即时反馈。今天要聊的这个项目，就是这种魅力的一个经典体现：用一块名为“掌控板”的国产开源硬件，结合树莓派上的Sense HAT扩展板，实现一个可以通过红外遥控器控制的智能灯。

听起来是不是有点像把电视遥控器对准台灯，然后按一下按钮灯就亮了？没错，核心逻辑就是这么直观。但这个项目的有趣之处远不止于此。它本质上是一个跨硬件平台的“信号翻译”与“指令执行”过程。我们用一个最普通的家用红外遥控器（比如电视、空调遥控器）发射信号，树莓派上的Sense HAT负责接收并解码这个信号，然后通过某种方式（比如网络或串口）将指令发送给另一块独立的“掌控板”，最终由掌控板点亮或控制其板载的RGB LED灯。这个过程串联起了红外通信、微控制器编程、网络通信（或串口通信）等多个知识点，是一个绝佳的综合性硬件入门项目。

为什么选择这个组合？对于初学者，尤其是教育领域的用户，树莓派+Sense HAT提供了强大的计算能力和丰富的传感器，但直接用它做简单的IO控制（如点灯）有时显得“大材小用”，且GPIO电压是3.3V，驱动能力有限。而掌控板则是一款专为教育和物联网入门设计的微控制器，它集成了RGB灯、麦克风、加速度计等，编程环境（如Mind+、mPython）对青少年极其友好，其IO口驱动能力也更强。将两者结合，既能利用树莓派处理复杂信号（如红外解码），又能发挥掌控板在互动灯光效果上的优势，实现“强强联合”。这个项目非常适合那些已经玩过Arduino或掌控板基础项目，想向树莓派和更复杂系统交互迈进的硬件爱好者、创客教师以及学生们。

2. 核心硬件解析：Sense HAT与掌控板的角色定位

在开始动手之前，我们必须先搞清楚手头的两块“主角”硬件各自擅长什么，以及它们在这个项目中如何分工。这就像组建一个团队，明确每个人的职责，协作才能顺畅。

2.1 树莓派与Sense HAT：信号接收与解码的“大脑”

树莓派在这个项目中扮演着“信息处理中心”的角色。它性能强大，可以运行完整的操作系统（如Raspbian/Debian），轻松处理来自各种外设的复杂数据。而我们实现遥控功能的关键，在于它上面插着的一块扩展板——Sense HAT。

Sense HAT是一块功能丰富的附加板，它集成了LED点阵屏、陀螺仪、加速度计、磁力计、温湿度及气压传感器。但对我们这个项目而言，最重要的一个常被忽略的功能是其红外接收和发射管。是的，Sense HAT板载了一个红外接收器（通常位于板子边缘），这意味着我们无需额外购买和焊接任何红外接收模块，就能直接接收来自遥控器的红外信号。这大大简化了硬件连接，是选择Sense HAT的核心原因之一。

树莓派系统（如Raspbian）通常已经包含了lirc（Linux Infrared Remote Control）驱动和软件包，它可以用来配置和读取红外信号。我们的任务就是配置lirc，让它能正确识别Sense HAT上的红外接收器，并解码我们遥控器发出的信号。每个遥控器的按键都对应一个独特的红外编码（通常是NEC、RC-5等协议），lirc的作用就是将这些闪烁的红外光脉冲翻译成我们可以理解的按键名称，比如“KEY_POWER”、“KEY_VOLUMEUP”等。

注意：不同版本的树莓派和Sense HAT，其红外接收器对应的GPIO引脚可能不同。对于较新的树莓派4B/5与Sense HAT，常见的映射是GPIO 18。这是后续软件配置中至关重要的一步，配置错了就无法收到信号。

2.2 掌控板：灯光效果的“执行者”

掌控板是一块基于ESP32的微控制器开发板。它体积小巧，但“五脏俱全”：板载1.44寸彩色LCD屏、麦克风、加速度计、地磁计、蜂鸣器，以及一圈12颗可编程的RGB LED灯（NeoPixel）。这些RGB LED灯正是我们这个项目的最终输出设备。我们可以通过编程，让这些灯显示任何颜色，实现呼吸、渐变、跑马灯等各种炫酷效果。

掌控板的编程环境（如Mind+图形化编程或mPython的Blockly/代码模式）对新手非常友好。它可以通过USB线直接与电脑连接进行编程和供电。在这个项目中，掌控板需要接收来自树莓派的指令。那么，指令如何传递呢？这里有两种主流方案：

1. 串口通信（UART）：通过USB数据线，将掌控板的串口与树莓派的USB口连接。树莓派上运行一个Python脚本，将解码后的红外指令通过串口发送给掌控板。掌控板端的程序持续监听串口，收到特定指令后执行相应的灯光操作。这种方式硬件连接简单（一根USB线），通信可靠，是初学者的首选。
2. Wi-Fi网络通信：掌控板的ESP32核心自带Wi-Fi功能。我们可以让掌控板连接本地Wi-Fi，树莓派和掌控板处于同一局域网内。树莓派作为服务器（Server）或客户端（Client），通过TCP或UDP协议向掌控板发送指令。这种方式无需物理连线，更加灵活，但需要配置网络，复杂度稍高。

对于首次尝试，我强烈推荐使用串口通信方案。它避开了网络配置可能带来的IP地址、端口、防火墙等问题，让调试过程更专注于核心逻辑。

3. 环境搭建与红外信号解码配置

硬件角色清晰后，我们进入实战环节。第一步是让树莓派能够“听懂”遥控器的话。

3.1 树莓派系统与基础准备

首先，确保你的树莓派已经安装了操作系统。Raspberry Pi OS（原Raspbian）是官方推荐的选择。使用树莓派官方的Imager工具烧录系统到SD卡是最稳妥的方式。系统启动后，建议先通过sudo apt update && sudo apt upgrade -y更新软件包列表和系统。

接下来，需要安装红外解码的核心软件包lirc：

sudo apt install lirc -y

安装完成后，我们需要配置系统，告诉它红外接收器连接在哪个GPIO引脚上，以及使用哪种驱动模式。

3.2 配置LIRC驱动与硬件映射

这是最关键且最容易出错的一步。我们需要修改两个配置文件。

首先，编辑/etc/lirc/lirc_options.conf文件：

sudo nano /etc/lirc/lirc_options.conf

找到driver和device这两行，将其修改为如下内容。这告诉lirc使用默认的devinput驱动，并从/dev/lirc0设备文件读取数据。

driver = default device = /dev/lirc0

接下来，我们需要配置硬件，指定红外设备对应的GPIO引脚。编辑/boot/config.txt文件：

sudo nano /boot/config.txt

在文件末尾添加以下一行。这里的gpio_in_pin=18指定了红外接收器的输入引脚。正如前面提到的，对于树莓派4B/5 + Sense HAT组合，GPIO 18是常见配置。如果你使用的是其他型号或遇到问题，可以尝试GPIO 17。

dtoverlay=gpio-ir,gpio_in_pin=18

保存并退出编辑器，然后重启树莓派以使配置生效：

sudo reboot

重启后，验证红外接收器是否被正确识别。运行以下命令：

ls /dev/lirc*

如果看到/dev/lirc0这个设备文件，恭喜你，硬件配置基本成功。

3.3 录制遥控器按键编码

现在，我们需要让lirc学习你的遥控器的“语言”。使用一个通用的电视或空调遥控器即可。

首先，停止lirc服务，并启动一个原始模式来接收信号：

sudo systemctl stop lircd mode2 -d /dev/lirc0

此时，用遥控器对准Sense HAT的红外接收器，按下任意键（比如音量+）。如果终端屏幕上开始快速滚动显示pulse和space后面跟着一串数字，说明红外信号已经被成功接收。按Ctrl+C退出。

接下来，使用irrecord工具来录制并生成一个属于你遥控器的配置文件。这个文件将每个按键的红外波形映射为一个按键名。

irrecord -d /dev/lirc0 ~/lircd.conf

按照屏幕提示操作：

1. 它会先让你按一些随机键，用于分析你遥控器的载波频率。
2. 然后，提示你输入一个按键名称（例如KEY_POWER），你按下遥控器上想被命名为“KEY_POWER”的键（比如电源键）。
3. 重复第二步，录制其他按键，如KEY_VOLUMEUP,KEY_VOLUMEDOWN,KEY_CHANNELUP,KEY_CHANNELDOWN等。建议至少录制4-5个键，用于后续控制灯光的不同模式。
4. 录制完成后，按回车结束。

现在，你的家目录下会生成一个lircd.conf文件。将其复制到lirc的系统配置目录，并重启lirc服务：

sudo cp ~/lircd.conf /etc/lirc/lircd.conf.d/ sudo systemctl start lircd sudo systemctl enable lircd

3.4 测试红外解码

服务启动后，我们可以进行测试。运行irw命令：

irw

此时，再次用遥控器对准Sense HAT按下你录制过的按键。在irw终端里，你应该能看到实时的输出，例如：

0000000000ff00dd KEY_VOLUMEUP MyRemote

这表示，lirc已经成功将红外信号解码，并识别出你按下的是“MyRemote”这个遥控器（配置文件中定义的名称）的“KEY_VOLUMEUP”键。至此，树莓派端的红外解码环境全部搭建完成。

4. 掌控板端程序：灯光控制逻辑的实现

树莓派已经能“听懂”指令了，现在我们需要让掌控板“执行”指令。我们采用串口通信方案，因此需要编写掌控板的程序，让其监听串口，并根据收到的字符串命令改变RGB灯的状态。

这里以掌控板常用的mPython（或Mind+）编程环境为例。其核心逻辑非常简单：初始化串口和RGB灯，然后在主循环中不断检查串口是否有数据到来，如果有，就读取并解析。

下面是一个示例代码框架（基于mPython的代码模式）：

# 导入必要的模块 from mpython import * import time # 初始化硬件 # 假设我们使用板载的NeoPixel RGB灯环，有12颗灯 import neopixel np = neopixel.NeoPixel(Pin(Pin.P15), n=12, bpp=3, timing=1) # 初始化串口，波特率设置为9600（需与树莓派发送端一致） uart = machine.UART(1, tx=Pin(Pin.P1), rx=Pin(Pin.P0), baudrate=9600) # 定义一些灯光模式函数 def light_on(color=(255, 255, 255)): # 默认白色全亮 for i in range(12): np[i] = color np.write() def light_off(): for i in range(12): np[i] = (0, 0, 0) np.write() def breathe_effect(color=(0, 100, 255)): # 呼吸灯效果 # ... 呼吸灯实现代码 ... pass def rainbow_cycle(): # 彩虹循环效果 # ... 彩虹灯实现代码 ... pass # 主循环 while True: if uart.any(): # 检查串口是否有数据 command = uart.read().decode('utf-8').strip() # 读取并解码数据 print("Received:", command) # 在掌控板串口监视器打印，用于调试 # 根据接收到的命令执行相应操作 if command == "ON": light_on() elif command == "OFF": light_off() elif command == "BLUE": light_on((0, 0, 255)) elif command == "GREEN": light_on((0, 255, 0)) elif command == "BREATHE": # 注意：呼吸灯效果是持续的，需要特殊处理循环 breathe_effect() elif command == "RAINBOW": rainbow_cycle() # ... 可以添加更多命令 ... time.sleep(0.05) # 短暂延时，避免CPU占用过高

将这段代码通过USB线烧录到掌控板中。烧录完成后，掌控板就会开始运行，并等待来自串口的指令。

实操心得：在编写掌控板程序时，务必注意字符串匹配的精确性。树莓派发送的字符串是"ON\n"（带换行符）还是"ON"？在掌控板端读取后，使用.strip()方法去除首尾空白字符（包括换行符\n）是一个好习惯，可以避免因格式不一致导致的命令无法识别。另外，复杂的灯光效果（如呼吸、彩虹）是动画，需要在一个循环内不断更新LED状态。在实现时，要小心不要让这个效果循环阻塞主循环，导致无法接收新的串口命令。一种简单的做法是使用状态机，收到“BREATHE”命令后，设置一个全局状态标志，在主循环中根据这个标志来执行呼吸灯的一帧更新。

5. 树莓派桥接程序：解码指令与串口发送

现在，我们有了能听懂的树莓派和能执行的掌控板，缺一个“翻译官”——运行在树莓派上的Python桥接程序。这个程序的工作流程是：监听lirc解码后的按键事件，将不同的按键映射为不同的字符串命令，然后通过串口发送给掌控板。

首先，确保树莓派上安装了Python的串口库pyserial：

pip3 install pyserial

然后，创建一个Python脚本，例如ir_controller.py：

#!/usr/bin/env python3 import serial import time import subprocess import select # 配置掌控板连接的串口设备名和波特率 # 树莓派上，掌控板通过USB连接通常会映射为 /dev/ttyACM0 或 /dev/ttyUSB0 # 可以通过 `ls /dev/ttyA*` 或 `ls /dev/ttyU*` 插入掌控板前后对比确认 SERIAL_PORT = '/dev/ttyACM0' BAUD_RATE = 9600 # 初始化串口连接 try: ser = serial.Serial(SERIAL_PORT, BAUD_RATE, timeout=1) time.sleep(2) # 等待串口稳定，对于某些设备很重要 print(f"Connected to {SERIAL_PORT} at {BAUD_RATE} baud.") except serial.SerialException as e: print(f"Error opening serial port {SERIAL_PORT}: {e}") exit(1) # 定义一个函数，用于向掌控板发送命令 def send_command(cmd): if ser.is_open: message = cmd + '\n' # 添加换行符作为命令结束标志 ser.write(message.encode('utf-8')) print(f"Sent: {cmd}") else: print("Serial port is not open.") # 使用subprocess打开irw命令，并实时读取其输出 # irw会持续输出按键信息 proc = subprocess.Popen(['irw'], stdout=subprocess.PIPE, text=True) print("Listening for IR commands. Press Ctrl+C to exit.") try: # 使用select来非阻塞地读取irw的输出 while True: # 检查irw进程是否有输出可读 readable, _, _ = select.select([proc.stdout], [], [], 0.1) if proc.stdout in readable: line = proc.stdout.readline() if line: # irw输出格式: "0000000000ff00dd KEY_VOLUMEUP MyRemote" parts = line.strip().split() if len(parts) >= 3: key_name = parts[1] remote_name = parts[2] # 根据按键名称映射到我们要发送的命令 # 这里的映射关系需要和你之前irrecord录制的按键名对应 command_map = { 'KEY_POWER': 'OFF', # 电源键关灯 'KEY_VOLUMEUP': 'ON', # 音量+开灯（白色） 'KEY_VOLUMEDOWN': 'BLUE', # 音量-蓝色 'KEY_CHANNELUP': 'GREEN', # 频道+绿色 'KEY_CHANNELDOWN': 'BREATHE', # 频道-呼吸灯 'KEY_MUTE': 'RAINBOW', # 静音键彩虹灯 } if key_name in command_map: send_command(command_map[key_name]) else: print(f"Unmapped key: {key_name}") time.sleep(0.01) # 短暂休眠，降低CPU占用 except KeyboardInterrupt: print("\nExiting...") finally: proc.terminate() if ser.is_open: ser.close() print("Serial port closed.")

代码关键点解析：

1. 串口设备名：/dev/ttyACM0是ESP32/掌控板类设备在Linux下的常见串口名。如果连接后找不到，尝试/dev/ttyUSB0。使用ls /dev/tty*命令查看。
2. 波特率：必须与掌控板程序中设置的baudrate=9600完全一致。
3. 命令映射：command_map字典是核心，它定义了遥控器上哪个按键（key_name）对应发送给掌控板的哪个字符串命令。你需要根据自己irrecord时定义的按键名来修改这个字典。
4. irw进程监听：脚本没有直接调用lirc的Python库，而是通过subprocess启动irw命令并捕获其输出。这是一种简单可靠的方法，避免了处理lirc套接字或驱动细节的复杂性。
5. 添加换行符：cmd + '\n'确保命令以换行符结尾，方便掌控板端的readline()或strip()处理。

给脚本添加执行权限并运行：

chmod +x ir_controller.py python3 ir_controller.py

现在，用遥控器对准Sense HAT按下你映射过的按键（如音量+），你应该能在树莓派终端看到“Sent: ON”的提示，同时掌控板上的RGB灯应被点亮成白色。

6. 项目优化与扩展思路

当基础功能跑通后，我们可以从稳定性、用户体验和功能扩展几个层面来优化这个项目。

6.1 稳定性提升与错误处理

最初的脚本在异常处理上比较薄弱。在实际部署中，我们需要考虑更多：

• 串口重连机制：掌控板可能意外重启或USB接触不良。可以在脚本中添加一个检测循环，如果串口断开，尝试每隔几秒重新连接，直到恢复。
• irw进程守护：irw进程有时会意外结束。可以用一个while True外层循环，如果发现proc.poll()不为None（表示进程已终止），就重新启动subprocess.Popen。
• 去抖动处理：红外遥控按下时可能发送多个重复信号。可以在代码中记录上一次有效按键的时间，如果两次相同按键的间隔小于某个阈值（如200毫秒），则忽略后续信号，防止一次按下触发多次动作。

6.2 从串口到Wi-Fi：实现无线控制

摆脱USB线的束缚会让项目更整洁。我们可以修改方案，让树莓派和掌控板通过Wi-Fi通信。

掌控板端（Wi-Fi客户端 + TCP Server）：

1. 编写掌控板程序，使其启动后连接家庭Wi-Fi。
2. 在掌控板上创建一个TCP服务器，监听某个端口（如8888）。
3. 主循环中接受来自树莓派的TCP连接，并读取数据，解析命令控制灯光。

树莓派端（TCP Client）：

1. 在之前的Python桥接脚本中，将serial.Serial部分替换为socket.socket。
2. 脚本启动后，尝试连接到掌控板的IP地址和端口。
3. 收到红外指令后，通过TCP Socket发送命令字符串。

这种方式下，掌控板需要有一个固定的局域网IP，或者使用mDNS（如掌控板.local）来访问。虽然设置稍复杂，但实现了真正的无线遥控，项目适用范围更广。

6.3 功能扩展：更多传感器与交互

Sense HAT和掌控板都拥有丰富的传感器，这为项目扩展提供了无限可能：

• 环境感应灯：利用Sense HAT上的温湿度、气压传感器。树莓派程序可以定时读取环境数据，当温度超过阈值时，通过串口发送命令让掌控板的灯光变为“警示”的红色；湿度高时变为蓝色等。
• 姿态控制灯：利用Sense HAT或掌控板自带的加速度计。编写程序，当检测到板子被倾斜或晃动时，改变灯光颜色或模式。例如，向左倾斜变冷色调，向右倾斜变暖色调。
• 灯光效果序列：定义更复杂的命令，如“MODE1”触发一组预设的灯光动画序列，而不仅仅是单一颜色。
• 集成语音控制：在树莓派上安装语音识别库（如Snowboy或Vosk），结合USB麦克风。实现“打开灯”、“变成蓝色”等语音指令，与红外遥控并存，形成多模态交互。

6.4 部署为系统服务

为了让项目开机自启动，我们可以将树莓派的Python桥接脚本设置为系统服务。

创建一个服务文件/etc/systemd/system/ir-light-controller.service：

[Unit] Description=IR Remote Controlled Light Service After=multi-user.target lircd.service Wants=lircd.service [Service] Type=simple User=pi ExecStart=/usr/bin/python3 /home/pi/ir_controller.py Restart=on-failure RestartSec=5s [Install] WantedBy=multi-user.target

然后启用并启动服务：

sudo systemctl daemon-reload sudo systemctl enable ir-light-controller.service sudo systemctl start ir-light-controller.service

这样，每次树莓派启动后，遥控灯服务就会自动在后台运行，无需手动登录执行脚本。

通过以上步骤，一个由红外遥控器控制、基于Sense HAT和掌控板的互动灯项目就从概念变成了现实。它不仅是一个有趣的玩具，更是一个涵盖了嵌入式Linux配置、外设驱动、串口通信、多硬件平台协作的微型系统工程样本。