1. 项目概述为什么用红外遥控树莓派手边有个闲置的电视遥控器或者想给树莓派项目加个复古又实用的遥控功能用红外遥控器控制树莓派听起来像是极客的玩具但实际上它是一个打通物理世界与数字世界交互的经典入门项目。红外遥控技术成熟、成本低廉几乎家家户户都有现成的遥控器。通过这个项目你可以让树莓派听懂你家电视、空调、机顶盒遥控器的“语言”实现用遥控器开关灯、控制媒体播放、启动脚本甚至作为智能家居的中枢遥控器。核心原理并不复杂一个几块钱的红外接收头如VS1838B连接到树莓派的GPIO引脚上负责接收红外信号树莓派上运行一个叫做LIRCLinux Infrared Remote Control的软件套件负责解码这些信号并将其映射为系统命令或自定义脚本。网络上相关的教程不少但很多只停留在“能跑通”的层面对于信号解码原理、环境干扰处理、多协议兼容以及如何稳定集成到系统服务中往往语焉不详。我折腾过好几次从信号收不到、按键响应混乱到最终实现稳定、低延迟的遥控积累了不少实战经验。这篇文章我就带你从硬件连接到软件配置再到深度优化和排错完整走一遍这个流程目标是让你做出的红外遥控功能既可靠又好用。2. 硬件准备与连接选对元件连对线硬件部分是整个项目的地基如果这里出问题后面的软件调试会变得异常痛苦。我们的目标是搭建一个稳定可靠的红外信号接收电路。2.1 核心元件选择与作用你需要准备以下硬件树莓派任何型号均可Zero 2W, 3B, 4B, 5等确保系统已安装推荐Raspberry Pi OS或Ubuntu Server。红外接收头这是关键。强烈推荐使用VS1838B或TSOP38238这类一体化接收模块。它们内部集成了光电二极管、前置放大器、带通滤波器和解调电路。简单说它只接收特定频率通常是38kHz的红外信号并直接输出干净的数字波形给树莓派省去了你外接复杂滤波电路的麻烦。注意它有三个引脚VCC电源接3.3V、GND地、OUT信号输出。杜邦线若干用于连接。红外遥控器任意一个电视、空调、DVD的都行。最好准备两个不同品牌的方便测试协议兼容性。注意务必确认红外接收头的工作电压。绝大多数通用接收头如VS1838B是3.3V/5V兼容的但为了与树莓派GPIO的3.3V电平完美匹配避免损坏树莓派请统一使用3.3V供电。直接从树莓派的3.3V引脚如物理引脚1或17取电。2.2 电路连接详解连接非常简单但顺序和细节决定成败。我建议按照以下步骤操作断电操作在连接任何线路前请关闭树莓派电源。带电插拔是损坏GPIO的头号杀手。识别引脚使用pinout命令或在网上搜索你的树莓派型号的GPIO引脚图。我们以最通用的BCM编号为例进行连接。连接电路红外接收头VCC-树莓派物理引脚1 (3.3V电源)。红外接收头GND-树莓派物理引脚6 (GND)。红外接收头OUT-树莓派物理引脚12 (BCM GPIO18)。选择GPIO18是因为它在历史上与硬件PWM关联但对我们接收信号而言任何可用的GPIO都可以。我习惯用GPIO18或GPIO17避开一些有特殊默认功能的引脚如GPIO2、GPIO3的I2C。连接好后实物看起来就是接收头通过三根杜邦线“趴”在树莓派的GPIO排针上。确保连接牢固没有松动或短路的风险。你可以用胶带或热熔胶稍微固定一下。2.3 硬件连接验证与初步测试上电前再次检查VCC是不是3.3VGND有没有接反OUT线是否连接正确树莓派上电后我们可以做一个简单的物理验证打开手机摄像头大部分手机摄像头能捕捉到红外光用遥控器对着手机摄像头按按钮你应该能看到遥控器的红外发射管在摄像头画面中发出白紫色的光。这说明遥控器是好的。然后将红外接收头的数据线OUT对准遥控器按下一个按钮。此时接收头的输出引脚电压会剧烈变化。虽然我们肉眼看不到但用逻辑分析仪或示波器能看到一串脉冲。没有这些设备也没关系我们接下来用软件来“看”。3. 软件配置安装与配置LIRCLIRC是Linux下处理红外信号的标准工具它包含驱动、解码器和应用层工具。我们的工作就是配置它让它能识别我们的硬件并解码信号。3.1 系统更新与LIRC安装首先通过SSH或直接接上屏幕键盘登录到你的树莓派。开始前先更新软件包列表sudo apt update sudo apt upgrade -y接下来安装LIRC软件包。在较新的树莓派OS基于Debian Bullseye或Bookworm中lirc包可能已被拆分为lirc和lircd。最稳妥的方式是安装以下包sudo apt install lirc liblirc-client-dev -y这个命令会安装LIRC的核心守护进程lircd、配置工具以及一些客户端库。3.2 配置系统以启用LIRC内核模块这是最关键且最容易出错的一步。我们需要告诉系统将我们连接的红外接收器通过GPIO作为一个输入设备。旧方法已过时很多老教程会让你修改/etc/modules和/boot/config.txt手动加载lirc_rpi模块。这种方法在新版内核和系统中可能失效或导致冲突。新方法推荐使用设备树Device Tree覆盖和系统服务。我们通过创建或修改配置文件来定义硬件。编辑LIRC硬件配置文件sudo nano /etc/lirc/lirc_options.conf找到driver和device这两行修改为driver default device /dev/lirc0这告诉LIRC使用默认驱动并指定设备节点。配置硬件映射关键步骤我们需要创建一个硬件配置文件定义使用哪个GPIO引脚。创建文件sudo nano /etc/lirc/hardware.conf如果文件不存在就新建并填入以下内容。请根据你的实际连接修改gpio_in参数如果你接在BCM GPIO18物理引脚12配置如下LIRCD_ARGS--uinput LOAD_MODULEStrue DRIVERdefault DEVICE/dev/lirc0 MODULESlirc_dev LIRCD_CONF LIRCMD_CONF GPIO_IN18 GPIO_OUT17 # 如果你后续要做红外发射可以设置接收可先不管重要提示GPIO_IN的值是BCM编号不是物理引脚号。BCM GPIO18对应的就是BCM编号18。启用并启动LIRC服务sudo systemctl enable lircd.service sudo systemctl start lircd.service检查服务状态确保它是活跃的activesudo systemctl status lircd.service如果看到错误大概率是硬件配置有问题。可以查看详细日志sudo journalctl -u lircd.service -f3.3 测试红外信号接收服务运行后我们可以测试是否能收到信号。使用ir-ctl工具较新系统推荐或传统的mode2工具。使用ir-ctl测试ir-ctl --device/dev/lirc0 --receive然后对着红外接收头按遥控器按钮。你应该能看到屏幕上输出一串脉冲和空格的时间数据单位通常是微秒。类似pulse 9024 space 4450 pulse 576 space 1679 ...如果能看到有规律的数据流恭喜你硬件和基础驱动配置成功了按CtrlC退出。如果ir-ctl不可用可以使用传统的mode2mode2 -d /dev/lirc0同样按遥控器应该能看到space和pulse数据。如果没有任何输出请检查遥控器是否有电是否对准了接收头接收头连接是否正确LIRC服务是否在运行/dev/lirc0设备是否存在ls /dev/lirc*4. 解码与录制红外信号让树莓派“认识”你的遥控器收到原始信号只是第一步我们需要让LIRC理解这些信号代表哪个按键。这个过程就是“学习”或“解码”。4.1 使用ir-ctl或irrecord录制按键我们需要为你的遥控器创建一个配置文件.lircd.conf其中定义了每个按键对应的红外编码。方法一使用ir-ctl录制推荐更简单ir-ctl可以自动分析并尝试识别协议。首先尝试让它自动识别ir-ctl --device/dev/lirc0 --receive --decode按几下遥控器按键看它能否输出类似NEC 0x10EF00FF这样的协议名和编码。如果能说明它自动识别了你可以直接用这个信息。但为了获得更可靠的配置我们手动录制一个按键映射文件。录制一个新配置例如给遥控器起名叫MY_REMOTEir-ctl --device/dev/lirc0 --receive --learn/etc/lirc/lircd.conf.d/my_remote.lircd.conf按照屏幕提示操作。通常它会让你按下一个按键比如电源键多次以获取稳定的信号。录制完一个键后你可以按Enter继续录制下一个键或者按CtrlC退出。注意ir-ctl的--learn参数可能一次只学习一个协议框架对于多个按键有时需要手动编辑配置文件。方法二使用irrecord录制传统更手动如果ir-ctl学习不顺利可以使用irrecord它提供了更手动的引导流程。irrecord -d /dev/lirc0 -f ~/my_remote.lircd.conf-f指定输出文件路径。程序会先引导你录制一些随机按键来分析信号特征用于区分信号起始和结束然后让你依次录制每个按键并为其命名如KEY_POWER,KEY_VOLUMEUP。请严格按照提示操作按键时间间隔要均匀。实操心得录制环境很重要确保在光线稳定、没有强烈日光灯或其它红外源如取暖器干扰的环境下进行。录制时遥控器距离接收头10-20厘米为宜不要太近也不要太远。对于不常见的遥控器irrecord的成功率可能更高因为它不依赖预定义的协议库。4.2 理解与编辑LIRC配置文件无论用哪种方法最终你都会得到一个.lircd.conf文件。用文本编辑器打开看看sudo nano /etc/lirc/lircd.conf.d/my_remote.lircd.conf内容大致如下begin remote name MY_REMOTE flags RAW_CODES|CONST_LENGTH eps 30 aeps 100 gap 200000 begin raw_codes name KEY_POWER 9024 4450 576 1679 ... name KEY_VOLUMEUP 9020 4455 580 1680 ... end raw_codes end remotename: 遥控器名称。raw_codes: 里面是每个按键对应的原始时间序列脉冲-空格-脉冲...。数字代表时间单位是微秒µs。如果你录制了多个按键它们都会列在begin raw_codes和end raw_codes之间。4.3 加载新配置并测试解码配置文件准备好后需要重启LIRC服务来加载它sudo systemctl restart lircd.service现在使用ir-ctl或irsend来测试解码是否成功测试解码ir-ctl --device/dev/lirc0 --receive --decode按下你录制过的按键如电源键这次你应该能看到输出的不是原始时间而是类似MY_REMOTE KEY_POWER的解码结果。这表明LIRC已经能正确识别你的遥控器按键了列出可用的遥控器和按键irsend LIST MY_REMOTE 这条命令会列出MY_REMOTE遥控器下所有已录制的按键名。至此树莓派已经“学会”了你的遥控器。下一步就是让这些按键触发实际的操作。5. 映射红外按键到系统动作从信号到命令让树莓派识别按键只是第一步我们的终极目标是让按键去执行命令比如打开一个程序、调节音量、或者控制GPIO引脚。5.1 配置LIRC的运行时映射~/.lircrcLIRC提供了一个用户级的映射文件~/.lircrc每个用户独立。当lircd解码出一个按键后会检查这个文件执行对应的命令。在用户主目录下创建或编辑这个文件nano ~/.lircrc文件内容遵循特定的语法。一个基本的配置块如下begin remote MY_REMOTE button KEY_POWER prog irexec config sudo shutdown -h now endremote: 指定遥控器名称必须和.lircd.conf文件里的name一致。button: 指定按键名称必须和配置文件里的name一致。prog: 指定处理此事件的程序。我们常用irexec来执行shell命令。config: 当该按键被按下时要执行的命令。可以是任何有效的shell命令。你可以为多个按键创建多个这样的begin和end块。更复杂的例子用同一个按键控制音乐播放器的播放/暂停。begin remote MY_REMOTE button KEY_PLAYPAUSE prog irexec config dbus-send --print-reply --destorg.mpris.MediaPlayer2.spotify /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.PlayPause 2/dev/null || playerctl play-pause end这个命令先尝试通过DBus控制Spotify如果失败则回退到通用的playerctl工具。5.2 使用irexec守护进程执行命令~/.lircrc文件需要由irexec程序来读取和执行。我们需要启动irexec服务。首先确保irexec已安装sudo apt install irexec -y然后创建系统服务文件以便自动启动对于用户级配置也可以直接运行但作为服务更稳定sudo nano /etc/systemd/system/irexec.service填入以下内容注意将User改为你的实际用户名如pi[Unit] DescriptionIR Exec Afterlircd.service Requireslircd.service [Service] Typesimple Userpi EnvironmentHOME/home/pi ExecStart/usr/bin/irexec /home/pi/.lircrc Restarton-failure [Install] WantedBymulti-user.target启用并启动irexec服务sudo systemctl daemon-reload sudo systemctl enable irexec.service sudo systemctl start irexec.service sudo systemctl status irexec.service现在按下遥控器上配置好的按键如KEY_POWER树莓派应该会执行关机命令请谨慎测试可以先换成echo Hello /tmp/test.txt这样的安全命令来验证。5.3 进阶映射使用Python脚本进行精细控制irexec适合执行简单命令但对于需要复杂逻辑、状态判断或与Python程序交互的控制编写一个Python脚本是更好的选择。LIRC可以通过Python的lirc客户端库来接收信号。首先安装Python的LIRC客户端库sudo apt install python3-pip pip3 install python-lirc-client然后创建一个Python脚本例如ir_controller.py#!/usr/bin/env python3 import lirc import subprocess import RPi.GPIO as GPIO import time # 初始化LIRC使用默认的socket路径 client lirc.Client() # 设置GPIO例如用KEY_UP控制一个LED LED_PIN 23 GPIO.setmode(GPIO.BCM) GPIO.setup(LED_PIN, GPIO.OUT) led_state False try: print(等待红外信号...) while True: # 阻塞等待信号timeoutNone表示一直等 code client.next_code() if code: button code[0] # code是一个列表第一个元素是按键名 print(f收到按键: {button}) if button KEY_POWER: print(执行关机...) subprocess.run([sudo, shutdown, -h, now]) elif button KEY_UP: led_state not led_state GPIO.output(LED_PIN, led_state) print(fLED状态: {开 if led_state else 关}) elif button KEY_PLAY: subprocess.run([playerctl, play]) # 可以添加更多按键处理逻辑... time.sleep(0.01) # 短暂休眠降低CPU占用 except KeyboardInterrupt: print(\n程序退出) finally: GPIO.cleanup()你需要修改~/.lircrc文件将prog指向一个自定义名称然后在LIRC的全局配置中关联这个名称和你的Python脚本。更简单的方法是不使用irexec而是让Python脚本直接连接LIRC的socket。上面的例子使用的python-lirc-client库就是这么做的。你只需要确保lircd服务在运行然后直接运行这个Python脚本即可。这样~/.lircrc文件就不再需要了所有逻辑都在Python脚本里。这种方法灵活性极高你可以轻松集成GPIO控制、传感器读取、网络请求等任何功能。6. 红外发射功能扩展让树莓派变身万能遥控器既然能接收自然也能发射。给树莓派接上一个红外发射二极管需串联一个约100Ω的限流电阻它就能模拟遥控器信号控制电视、空调、音响等设备。这相当于把树莓派打造成一个万能遥控器或者智能家居的红外指令中枢。6.1 发射硬件连接你需要红外发射二极管普通5mm红外发射管即可。限流电阻约100-200欧姆防止电流过大烧坏树莓派GPIO或二极管。NPN三极管如2N2222或MOSFET可选但推荐因为树莓派GPIO引脚驱动能力有限~16mA直接驱动红外二极管可能亮度不足或影响信号质量。使用三极管进行电流放大是更可靠的做法。推荐连接电路使用NPN三极管树莓派GPIO引脚如BCM GPIO17物理引脚11 - 电阻1kΩ - 三极管基极(B)。树莓派3.3V引脚 - 红外发射二极管正极 - 红外发射二极管负极 - 三极管集电极(C)。三极管发射极(E) - 树莓派GND。在红外二极管两端再并联一个反向的1N4148开关二极管用于保护防止反向感应电压。这个电路是一个简单的共发射极开关电路。当GPIO输出高电平时三极管导通电流流过红外二极管使其发光。GPIO按照LIRC生成的38kHz载波频率快速开关红外管就发射出被调制的红外信号。6.2 配置LIRC支持发射首先确保在之前的/etc/lirc/hardware.conf中设置了GPIO_OUT例如我们之前设为17。如果没有请加上并重启lircd服务。然后你需要一个包含目标设备红外编码的配置文件。如果你已经有一个设备的.lircd.conf文件比如你之前录制的电视遥控器它通常也包含了发射所需的编码数据。如果没有你需要找到对应的配置文件。LIRC项目官网和某些社区提供了大量现成的配置文件irdb。假设我们有一个名为TV_SONY.lircd.conf的配置文件放在/etc/lirc/lircd.conf.d/目录下。重启lircd服务加载它。6.3 使用irsend发送红外命令irsend是LIRC配套的命令行发送工具。基本用法如下列出已加载的遥控器irsend LIST 发送一次按键信号模拟按下电视的电源键irsend SEND_ONCE TV_SONY KEY_POWERSEND_ONCE表示发送一次按键命令。还有SEND_START开始持续发送如长按音量键和SEND_STOP停止发送。发送多次irsend SEND_START TV_SONY KEY_VOLUMEUP sleep 2 # 持续“按住”音量加2秒 irsend SEND_STOP TV_SONY KEY_VOLUMEUP测试将红外发射管对准你的电视运行发送电源命令。如果配置正确电视应该会响应开关机。6.4 集成到自动化脚本中将irsend命令写入Shell脚本或Python脚本你就可以实现复杂的自动化场景。例如一个“观影模式”脚本可以同时打开投影仪、降下幕布、打开功放并设置到正确输入源。#!/bin/bash # home_theater_mode.sh irsend SEND_ONCE PROJECTOR KEY_POWER sleep 5 irsend SEND_ONCE SCREEN KEY_DOWN sleep 2 irsend SEND_ONCE AMPLIFIER KEY_POWER sleep 3 irsend SEND_ONCE AMPLIFIER KEY_INPUT_HDMI1 echo “家庭影院模式已启动”然后你可以将这个脚本映射到遥控器的一个快捷键上或者通过网页界面、手机App来触发。7. 常见问题排查与性能优化在实际操作中你几乎一定会遇到一些问题。这里汇总了我踩过的坑和解决方案。7.1 信号接收不稳定或无信号症状ir-ctl --receive或mode2无输出或输出杂乱无章。排查步骤供电检查确认红外接收头VCC接的是3.3V不是5V。5V可能导致工作不稳定甚至损坏。引脚检查再三确认OUT线连接到了正确的GPIO引脚BCM编号并且没有接错到5V或其它特殊功能引脚上。环境干扰远离强烈的光源特别是日光灯和太阳光它们都含有丰富的红外光谱会干扰接收。尝试在较暗环境下测试。距离与角度遥控器对准接收头距离10-50厘米。红外接收头有一定的指向性不要角度太偏。遥控器电池换新电池试试。LIRC服务状态确保lircd.service正在运行并且没有报错。检查sudo journalctl -u lircd -f的输出。设备权限确保当前用户有读写/dev/lirc0的权限。通常lirc用户组有权限你可以将你的用户加入lirc组sudo usermod -a -G lirc $USER然后注销重新登录生效。内核模块冲突有些摄像头模块或其它驱动可能占用了GPIO。确保没有其它服务如pigpiod、wiringPi的独占访问在冲突。可以尝试在/boot/config.txt中禁用一些不用的接口如摄像头camera_auto_detect0但这不是首选方法。7.2 按键解码错误或重复触发症状按一次键系统识别出多次按下或者按A键触发B键的动作。排查与解决配置文件错误检查.lircd.conf文件中的原始编码数据是否准确。可以重新录制有问题的按键。协议不匹配LIRC可能错误判断了协议。在录制时如果ir-ctl --decode能显示协议名如NEC、RC-5可以在配置文件中使用protocol字段而非raw_codes通常更稳定。对于raw_codes可以调整eps误差允许范围和aeps头部误差参数。增大这些值可以增加容错但过大可能导致误触发。信号反射周围光滑表面如玻璃、金属反射红外线可能导致接收头收到多个相同信号。改变接收头位置或方向。去抖动处理在~/.lircrc或你的自定义脚本中可以加入简单的去抖动逻辑。例如在Python脚本中记录上次收到有效信号的时间如果两次信号间隔小于200毫秒则忽略后者。irexec重复执行确保没有多个irexec进程在运行。systemctl status irexec检查并用pkill irexec结束多余进程后再启动服务。7.3 发射信号设备不响应症状irsend命令执行成功但被控设备如电视无反应。排查步骤电路与极性检查红外发射二极管极性是否接反长脚为正。检查三极管或MOSFET的连接是否正确。发射管对准发射管需要直接对准被控设备的红外接收窗距离在几米内中间无遮挡。载波频率绝大多数设备使用38kHz载波但有些空调或特殊设备可能使用36kHz、40kHz等。确认你的发射电路能否产生正确的载波。LIRC默认使用GPIO的硬件PWM如果可用或软件模拟来生成38kHz。确保hardware.conf中GPIO_OUT设置正确。信号强度串联的限流电阻值太小会增大电流可能烧坏元件太大则信号弱。100-200Ω是常用范围。使用三极管放大电路能显著增强信号。配置文件确认发射使用的.lircd.conf文件确实包含正确的、可被设备识别的编码。有时从网络下载的配置文件可能不匹配你的设备型号。最好用自己的遥控器录制一份作为发射配置。测试接收用另一个红外接收头或手机摄像头靠近树莓派的发射管当发送信号时观察接收头是否有输出或者手机摄像头里能否看到发射管微亮。这是验证发射电路是否工作的好方法。7.4 性能优化与稳定性提升使用硬件PWM引脚对于红外发射使用支持硬件PWM的GPIO引脚如BCM GPIO12、13、18可以获得更精确、更稳定的38kHz载波减少CPU占用。在hardware.conf中将GPIO_OUT设置为这类引脚。优化LIRC配置对于接收如果遇到CPU占用率高可以尝试调整/etc/lirc/lirc_options.conf中的sample_rate参数但非必要勿动。编写稳健的服务脚本将你的Python控制脚本封装成systemd服务设置自动重启Restarton-failure并做好日志记录可以确保遥控功能在树莓派重启后依然可用并且在脚本崩溃后自动恢复。防止冲突如果你的树莓派还运行着其他可能占用GPIO的服务如Home Assistant的GPIO集成、自己写的其他Python GPIO脚本要确保它们使用的GPIO引脚不冲突并且最好使用相同的GPIO库如RPi.GPIO以避免底层冲突。红外遥控是一个看似简单但细节丰富的项目它涉及硬件连接、驱动配置、信号编解码和系统集成。成功实现后你可以将其作为智能家居的遥控入口或者为你的树莓派机器人、媒体中心添加一个便捷的物理控制界面。最重要的是通过这个过程你深入理解了Linux设备驱动、中断处理和服务管理的一个生动案例。
树莓派红外遥控实战：从硬件连接到LIRC配置与Python控制
1. 项目概述为什么用红外遥控树莓派手边有个闲置的电视遥控器或者想给树莓派项目加个复古又实用的遥控功能用红外遥控器控制树莓派听起来像是极客的玩具但实际上它是一个打通物理世界与数字世界交互的经典入门项目。红外遥控技术成熟、成本低廉几乎家家户户都有现成的遥控器。通过这个项目你可以让树莓派听懂你家电视、空调、机顶盒遥控器的“语言”实现用遥控器开关灯、控制媒体播放、启动脚本甚至作为智能家居的中枢遥控器。核心原理并不复杂一个几块钱的红外接收头如VS1838B连接到树莓派的GPIO引脚上负责接收红外信号树莓派上运行一个叫做LIRCLinux Infrared Remote Control的软件套件负责解码这些信号并将其映射为系统命令或自定义脚本。网络上相关的教程不少但很多只停留在“能跑通”的层面对于信号解码原理、环境干扰处理、多协议兼容以及如何稳定集成到系统服务中往往语焉不详。我折腾过好几次从信号收不到、按键响应混乱到最终实现稳定、低延迟的遥控积累了不少实战经验。这篇文章我就带你从硬件连接到软件配置再到深度优化和排错完整走一遍这个流程目标是让你做出的红外遥控功能既可靠又好用。2. 硬件准备与连接选对元件连对线硬件部分是整个项目的地基如果这里出问题后面的软件调试会变得异常痛苦。我们的目标是搭建一个稳定可靠的红外信号接收电路。2.1 核心元件选择与作用你需要准备以下硬件树莓派任何型号均可Zero 2W, 3B, 4B, 5等确保系统已安装推荐Raspberry Pi OS或Ubuntu Server。红外接收头这是关键。强烈推荐使用VS1838B或TSOP38238这类一体化接收模块。它们内部集成了光电二极管、前置放大器、带通滤波器和解调电路。简单说它只接收特定频率通常是38kHz的红外信号并直接输出干净的数字波形给树莓派省去了你外接复杂滤波电路的麻烦。注意它有三个引脚VCC电源接3.3V、GND地、OUT信号输出。杜邦线若干用于连接。红外遥控器任意一个电视、空调、DVD的都行。最好准备两个不同品牌的方便测试协议兼容性。注意务必确认红外接收头的工作电压。绝大多数通用接收头如VS1838B是3.3V/5V兼容的但为了与树莓派GPIO的3.3V电平完美匹配避免损坏树莓派请统一使用3.3V供电。直接从树莓派的3.3V引脚如物理引脚1或17取电。2.2 电路连接详解连接非常简单但顺序和细节决定成败。我建议按照以下步骤操作断电操作在连接任何线路前请关闭树莓派电源。带电插拔是损坏GPIO的头号杀手。识别引脚使用pinout命令或在网上搜索你的树莓派型号的GPIO引脚图。我们以最通用的BCM编号为例进行连接。连接电路红外接收头VCC-树莓派物理引脚1 (3.3V电源)。红外接收头GND-树莓派物理引脚6 (GND)。红外接收头OUT-树莓派物理引脚12 (BCM GPIO18)。选择GPIO18是因为它在历史上与硬件PWM关联但对我们接收信号而言任何可用的GPIO都可以。我习惯用GPIO18或GPIO17避开一些有特殊默认功能的引脚如GPIO2、GPIO3的I2C。连接好后实物看起来就是接收头通过三根杜邦线“趴”在树莓派的GPIO排针上。确保连接牢固没有松动或短路的风险。你可以用胶带或热熔胶稍微固定一下。2.3 硬件连接验证与初步测试上电前再次检查VCC是不是3.3VGND有没有接反OUT线是否连接正确树莓派上电后我们可以做一个简单的物理验证打开手机摄像头大部分手机摄像头能捕捉到红外光用遥控器对着手机摄像头按按钮你应该能看到遥控器的红外发射管在摄像头画面中发出白紫色的光。这说明遥控器是好的。然后将红外接收头的数据线OUT对准遥控器按下一个按钮。此时接收头的输出引脚电压会剧烈变化。虽然我们肉眼看不到但用逻辑分析仪或示波器能看到一串脉冲。没有这些设备也没关系我们接下来用软件来“看”。3. 软件配置安装与配置LIRCLIRC是Linux下处理红外信号的标准工具它包含驱动、解码器和应用层工具。我们的工作就是配置它让它能识别我们的硬件并解码信号。3.1 系统更新与LIRC安装首先通过SSH或直接接上屏幕键盘登录到你的树莓派。开始前先更新软件包列表sudo apt update sudo apt upgrade -y接下来安装LIRC软件包。在较新的树莓派OS基于Debian Bullseye或Bookworm中lirc包可能已被拆分为lirc和lircd。最稳妥的方式是安装以下包sudo apt install lirc liblirc-client-dev -y这个命令会安装LIRC的核心守护进程lircd、配置工具以及一些客户端库。3.2 配置系统以启用LIRC内核模块这是最关键且最容易出错的一步。我们需要告诉系统将我们连接的红外接收器通过GPIO作为一个输入设备。旧方法已过时很多老教程会让你修改/etc/modules和/boot/config.txt手动加载lirc_rpi模块。这种方法在新版内核和系统中可能失效或导致冲突。新方法推荐使用设备树Device Tree覆盖和系统服务。我们通过创建或修改配置文件来定义硬件。编辑LIRC硬件配置文件sudo nano /etc/lirc/lirc_options.conf找到driver和device这两行修改为driver default device /dev/lirc0这告诉LIRC使用默认驱动并指定设备节点。配置硬件映射关键步骤我们需要创建一个硬件配置文件定义使用哪个GPIO引脚。创建文件sudo nano /etc/lirc/hardware.conf如果文件不存在就新建并填入以下内容。请根据你的实际连接修改gpio_in参数如果你接在BCM GPIO18物理引脚12配置如下LIRCD_ARGS--uinput LOAD_MODULEStrue DRIVERdefault DEVICE/dev/lirc0 MODULESlirc_dev LIRCD_CONF LIRCMD_CONF GPIO_IN18 GPIO_OUT17 # 如果你后续要做红外发射可以设置接收可先不管重要提示GPIO_IN的值是BCM编号不是物理引脚号。BCM GPIO18对应的就是BCM编号18。启用并启动LIRC服务sudo systemctl enable lircd.service sudo systemctl start lircd.service检查服务状态确保它是活跃的activesudo systemctl status lircd.service如果看到错误大概率是硬件配置有问题。可以查看详细日志sudo journalctl -u lircd.service -f3.3 测试红外信号接收服务运行后我们可以测试是否能收到信号。使用ir-ctl工具较新系统推荐或传统的mode2工具。使用ir-ctl测试ir-ctl --device/dev/lirc0 --receive然后对着红外接收头按遥控器按钮。你应该能看到屏幕上输出一串脉冲和空格的时间数据单位通常是微秒。类似pulse 9024 space 4450 pulse 576 space 1679 ...如果能看到有规律的数据流恭喜你硬件和基础驱动配置成功了按CtrlC退出。如果ir-ctl不可用可以使用传统的mode2mode2 -d /dev/lirc0同样按遥控器应该能看到space和pulse数据。如果没有任何输出请检查遥控器是否有电是否对准了接收头接收头连接是否正确LIRC服务是否在运行/dev/lirc0设备是否存在ls /dev/lirc*4. 解码与录制红外信号让树莓派“认识”你的遥控器收到原始信号只是第一步我们需要让LIRC理解这些信号代表哪个按键。这个过程就是“学习”或“解码”。4.1 使用ir-ctl或irrecord录制按键我们需要为你的遥控器创建一个配置文件.lircd.conf其中定义了每个按键对应的红外编码。方法一使用ir-ctl录制推荐更简单ir-ctl可以自动分析并尝试识别协议。首先尝试让它自动识别ir-ctl --device/dev/lirc0 --receive --decode按几下遥控器按键看它能否输出类似NEC 0x10EF00FF这样的协议名和编码。如果能说明它自动识别了你可以直接用这个信息。但为了获得更可靠的配置我们手动录制一个按键映射文件。录制一个新配置例如给遥控器起名叫MY_REMOTEir-ctl --device/dev/lirc0 --receive --learn/etc/lirc/lircd.conf.d/my_remote.lircd.conf按照屏幕提示操作。通常它会让你按下一个按键比如电源键多次以获取稳定的信号。录制完一个键后你可以按Enter继续录制下一个键或者按CtrlC退出。注意ir-ctl的--learn参数可能一次只学习一个协议框架对于多个按键有时需要手动编辑配置文件。方法二使用irrecord录制传统更手动如果ir-ctl学习不顺利可以使用irrecord它提供了更手动的引导流程。irrecord -d /dev/lirc0 -f ~/my_remote.lircd.conf-f指定输出文件路径。程序会先引导你录制一些随机按键来分析信号特征用于区分信号起始和结束然后让你依次录制每个按键并为其命名如KEY_POWER,KEY_VOLUMEUP。请严格按照提示操作按键时间间隔要均匀。实操心得录制环境很重要确保在光线稳定、没有强烈日光灯或其它红外源如取暖器干扰的环境下进行。录制时遥控器距离接收头10-20厘米为宜不要太近也不要太远。对于不常见的遥控器irrecord的成功率可能更高因为它不依赖预定义的协议库。4.2 理解与编辑LIRC配置文件无论用哪种方法最终你都会得到一个.lircd.conf文件。用文本编辑器打开看看sudo nano /etc/lirc/lircd.conf.d/my_remote.lircd.conf内容大致如下begin remote name MY_REMOTE flags RAW_CODES|CONST_LENGTH eps 30 aeps 100 gap 200000 begin raw_codes name KEY_POWER 9024 4450 576 1679 ... name KEY_VOLUMEUP 9020 4455 580 1680 ... end raw_codes end remotename: 遥控器名称。raw_codes: 里面是每个按键对应的原始时间序列脉冲-空格-脉冲...。数字代表时间单位是微秒µs。如果你录制了多个按键它们都会列在begin raw_codes和end raw_codes之间。4.3 加载新配置并测试解码配置文件准备好后需要重启LIRC服务来加载它sudo systemctl restart lircd.service现在使用ir-ctl或irsend来测试解码是否成功测试解码ir-ctl --device/dev/lirc0 --receive --decode按下你录制过的按键如电源键这次你应该能看到输出的不是原始时间而是类似MY_REMOTE KEY_POWER的解码结果。这表明LIRC已经能正确识别你的遥控器按键了列出可用的遥控器和按键irsend LIST MY_REMOTE 这条命令会列出MY_REMOTE遥控器下所有已录制的按键名。至此树莓派已经“学会”了你的遥控器。下一步就是让这些按键触发实际的操作。5. 映射红外按键到系统动作从信号到命令让树莓派识别按键只是第一步我们的终极目标是让按键去执行命令比如打开一个程序、调节音量、或者控制GPIO引脚。5.1 配置LIRC的运行时映射~/.lircrcLIRC提供了一个用户级的映射文件~/.lircrc每个用户独立。当lircd解码出一个按键后会检查这个文件执行对应的命令。在用户主目录下创建或编辑这个文件nano ~/.lircrc文件内容遵循特定的语法。一个基本的配置块如下begin remote MY_REMOTE button KEY_POWER prog irexec config sudo shutdown -h now endremote: 指定遥控器名称必须和.lircd.conf文件里的name一致。button: 指定按键名称必须和配置文件里的name一致。prog: 指定处理此事件的程序。我们常用irexec来执行shell命令。config: 当该按键被按下时要执行的命令。可以是任何有效的shell命令。你可以为多个按键创建多个这样的begin和end块。更复杂的例子用同一个按键控制音乐播放器的播放/暂停。begin remote MY_REMOTE button KEY_PLAYPAUSE prog irexec config dbus-send --print-reply --destorg.mpris.MediaPlayer2.spotify /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.PlayPause 2/dev/null || playerctl play-pause end这个命令先尝试通过DBus控制Spotify如果失败则回退到通用的playerctl工具。5.2 使用irexec守护进程执行命令~/.lircrc文件需要由irexec程序来读取和执行。我们需要启动irexec服务。首先确保irexec已安装sudo apt install irexec -y然后创建系统服务文件以便自动启动对于用户级配置也可以直接运行但作为服务更稳定sudo nano /etc/systemd/system/irexec.service填入以下内容注意将User改为你的实际用户名如pi[Unit] DescriptionIR Exec Afterlircd.service Requireslircd.service [Service] Typesimple Userpi EnvironmentHOME/home/pi ExecStart/usr/bin/irexec /home/pi/.lircrc Restarton-failure [Install] WantedBymulti-user.target启用并启动irexec服务sudo systemctl daemon-reload sudo systemctl enable irexec.service sudo systemctl start irexec.service sudo systemctl status irexec.service现在按下遥控器上配置好的按键如KEY_POWER树莓派应该会执行关机命令请谨慎测试可以先换成echo Hello /tmp/test.txt这样的安全命令来验证。5.3 进阶映射使用Python脚本进行精细控制irexec适合执行简单命令但对于需要复杂逻辑、状态判断或与Python程序交互的控制编写一个Python脚本是更好的选择。LIRC可以通过Python的lirc客户端库来接收信号。首先安装Python的LIRC客户端库sudo apt install python3-pip pip3 install python-lirc-client然后创建一个Python脚本例如ir_controller.py#!/usr/bin/env python3 import lirc import subprocess import RPi.GPIO as GPIO import time # 初始化LIRC使用默认的socket路径 client lirc.Client() # 设置GPIO例如用KEY_UP控制一个LED LED_PIN 23 GPIO.setmode(GPIO.BCM) GPIO.setup(LED_PIN, GPIO.OUT) led_state False try: print(等待红外信号...) while True: # 阻塞等待信号timeoutNone表示一直等 code client.next_code() if code: button code[0] # code是一个列表第一个元素是按键名 print(f收到按键: {button}) if button KEY_POWER: print(执行关机...) subprocess.run([sudo, shutdown, -h, now]) elif button KEY_UP: led_state not led_state GPIO.output(LED_PIN, led_state) print(fLED状态: {开 if led_state else 关}) elif button KEY_PLAY: subprocess.run([playerctl, play]) # 可以添加更多按键处理逻辑... time.sleep(0.01) # 短暂休眠降低CPU占用 except KeyboardInterrupt: print(\n程序退出) finally: GPIO.cleanup()你需要修改~/.lircrc文件将prog指向一个自定义名称然后在LIRC的全局配置中关联这个名称和你的Python脚本。更简单的方法是不使用irexec而是让Python脚本直接连接LIRC的socket。上面的例子使用的python-lirc-client库就是这么做的。你只需要确保lircd服务在运行然后直接运行这个Python脚本即可。这样~/.lircrc文件就不再需要了所有逻辑都在Python脚本里。这种方法灵活性极高你可以轻松集成GPIO控制、传感器读取、网络请求等任何功能。6. 红外发射功能扩展让树莓派变身万能遥控器既然能接收自然也能发射。给树莓派接上一个红外发射二极管需串联一个约100Ω的限流电阻它就能模拟遥控器信号控制电视、空调、音响等设备。这相当于把树莓派打造成一个万能遥控器或者智能家居的红外指令中枢。6.1 发射硬件连接你需要红外发射二极管普通5mm红外发射管即可。限流电阻约100-200欧姆防止电流过大烧坏树莓派GPIO或二极管。NPN三极管如2N2222或MOSFET可选但推荐因为树莓派GPIO引脚驱动能力有限~16mA直接驱动红外二极管可能亮度不足或影响信号质量。使用三极管进行电流放大是更可靠的做法。推荐连接电路使用NPN三极管树莓派GPIO引脚如BCM GPIO17物理引脚11 - 电阻1kΩ - 三极管基极(B)。树莓派3.3V引脚 - 红外发射二极管正极 - 红外发射二极管负极 - 三极管集电极(C)。三极管发射极(E) - 树莓派GND。在红外二极管两端再并联一个反向的1N4148开关二极管用于保护防止反向感应电压。这个电路是一个简单的共发射极开关电路。当GPIO输出高电平时三极管导通电流流过红外二极管使其发光。GPIO按照LIRC生成的38kHz载波频率快速开关红外管就发射出被调制的红外信号。6.2 配置LIRC支持发射首先确保在之前的/etc/lirc/hardware.conf中设置了GPIO_OUT例如我们之前设为17。如果没有请加上并重启lircd服务。然后你需要一个包含目标设备红外编码的配置文件。如果你已经有一个设备的.lircd.conf文件比如你之前录制的电视遥控器它通常也包含了发射所需的编码数据。如果没有你需要找到对应的配置文件。LIRC项目官网和某些社区提供了大量现成的配置文件irdb。假设我们有一个名为TV_SONY.lircd.conf的配置文件放在/etc/lirc/lircd.conf.d/目录下。重启lircd服务加载它。6.3 使用irsend发送红外命令irsend是LIRC配套的命令行发送工具。基本用法如下列出已加载的遥控器irsend LIST 发送一次按键信号模拟按下电视的电源键irsend SEND_ONCE TV_SONY KEY_POWERSEND_ONCE表示发送一次按键命令。还有SEND_START开始持续发送如长按音量键和SEND_STOP停止发送。发送多次irsend SEND_START TV_SONY KEY_VOLUMEUP sleep 2 # 持续“按住”音量加2秒 irsend SEND_STOP TV_SONY KEY_VOLUMEUP测试将红外发射管对准你的电视运行发送电源命令。如果配置正确电视应该会响应开关机。6.4 集成到自动化脚本中将irsend命令写入Shell脚本或Python脚本你就可以实现复杂的自动化场景。例如一个“观影模式”脚本可以同时打开投影仪、降下幕布、打开功放并设置到正确输入源。#!/bin/bash # home_theater_mode.sh irsend SEND_ONCE PROJECTOR KEY_POWER sleep 5 irsend SEND_ONCE SCREEN KEY_DOWN sleep 2 irsend SEND_ONCE AMPLIFIER KEY_POWER sleep 3 irsend SEND_ONCE AMPLIFIER KEY_INPUT_HDMI1 echo “家庭影院模式已启动”然后你可以将这个脚本映射到遥控器的一个快捷键上或者通过网页界面、手机App来触发。7. 常见问题排查与性能优化在实际操作中你几乎一定会遇到一些问题。这里汇总了我踩过的坑和解决方案。7.1 信号接收不稳定或无信号症状ir-ctl --receive或mode2无输出或输出杂乱无章。排查步骤供电检查确认红外接收头VCC接的是3.3V不是5V。5V可能导致工作不稳定甚至损坏。引脚检查再三确认OUT线连接到了正确的GPIO引脚BCM编号并且没有接错到5V或其它特殊功能引脚上。环境干扰远离强烈的光源特别是日光灯和太阳光它们都含有丰富的红外光谱会干扰接收。尝试在较暗环境下测试。距离与角度遥控器对准接收头距离10-50厘米。红外接收头有一定的指向性不要角度太偏。遥控器电池换新电池试试。LIRC服务状态确保lircd.service正在运行并且没有报错。检查sudo journalctl -u lircd -f的输出。设备权限确保当前用户有读写/dev/lirc0的权限。通常lirc用户组有权限你可以将你的用户加入lirc组sudo usermod -a -G lirc $USER然后注销重新登录生效。内核模块冲突有些摄像头模块或其它驱动可能占用了GPIO。确保没有其它服务如pigpiod、wiringPi的独占访问在冲突。可以尝试在/boot/config.txt中禁用一些不用的接口如摄像头camera_auto_detect0但这不是首选方法。7.2 按键解码错误或重复触发症状按一次键系统识别出多次按下或者按A键触发B键的动作。排查与解决配置文件错误检查.lircd.conf文件中的原始编码数据是否准确。可以重新录制有问题的按键。协议不匹配LIRC可能错误判断了协议。在录制时如果ir-ctl --decode能显示协议名如NEC、RC-5可以在配置文件中使用protocol字段而非raw_codes通常更稳定。对于raw_codes可以调整eps误差允许范围和aeps头部误差参数。增大这些值可以增加容错但过大可能导致误触发。信号反射周围光滑表面如玻璃、金属反射红外线可能导致接收头收到多个相同信号。改变接收头位置或方向。去抖动处理在~/.lircrc或你的自定义脚本中可以加入简单的去抖动逻辑。例如在Python脚本中记录上次收到有效信号的时间如果两次信号间隔小于200毫秒则忽略后者。irexec重复执行确保没有多个irexec进程在运行。systemctl status irexec检查并用pkill irexec结束多余进程后再启动服务。7.3 发射信号设备不响应症状irsend命令执行成功但被控设备如电视无反应。排查步骤电路与极性检查红外发射二极管极性是否接反长脚为正。检查三极管或MOSFET的连接是否正确。发射管对准发射管需要直接对准被控设备的红外接收窗距离在几米内中间无遮挡。载波频率绝大多数设备使用38kHz载波但有些空调或特殊设备可能使用36kHz、40kHz等。确认你的发射电路能否产生正确的载波。LIRC默认使用GPIO的硬件PWM如果可用或软件模拟来生成38kHz。确保hardware.conf中GPIO_OUT设置正确。信号强度串联的限流电阻值太小会增大电流可能烧坏元件太大则信号弱。100-200Ω是常用范围。使用三极管放大电路能显著增强信号。配置文件确认发射使用的.lircd.conf文件确实包含正确的、可被设备识别的编码。有时从网络下载的配置文件可能不匹配你的设备型号。最好用自己的遥控器录制一份作为发射配置。测试接收用另一个红外接收头或手机摄像头靠近树莓派的发射管当发送信号时观察接收头是否有输出或者手机摄像头里能否看到发射管微亮。这是验证发射电路是否工作的好方法。7.4 性能优化与稳定性提升使用硬件PWM引脚对于红外发射使用支持硬件PWM的GPIO引脚如BCM GPIO12、13、18可以获得更精确、更稳定的38kHz载波减少CPU占用。在hardware.conf中将GPIO_OUT设置为这类引脚。优化LIRC配置对于接收如果遇到CPU占用率高可以尝试调整/etc/lirc/lirc_options.conf中的sample_rate参数但非必要勿动。编写稳健的服务脚本将你的Python控制脚本封装成systemd服务设置自动重启Restarton-failure并做好日志记录可以确保遥控功能在树莓派重启后依然可用并且在脚本崩溃后自动恢复。防止冲突如果你的树莓派还运行着其他可能占用GPIO的服务如Home Assistant的GPIO集成、自己写的其他Python GPIO脚本要确保它们使用的GPIO引脚不冲突并且最好使用相同的GPIO库如RPi.GPIO以避免底层冲突。红外遥控是一个看似简单但细节丰富的项目它涉及硬件连接、驱动配置、信号编解码和系统集成。成功实现后你可以将其作为智能家居的遥控入口或者为你的树莓派机器人、媒体中心添加一个便捷的物理控制界面。最重要的是通过这个过程你深入理解了Linux设备驱动、中断处理和服务管理的一个生动案例。
