避坑指南：树莓派配置LIRC红外遥控最容易踩的5个坑（内核版本、设备节点、配置文件格式）

树莓派LIRC红外遥控配置深度避坑指南：从内核差异到配置文件玄学

第一次在树莓派上折腾红外遥控时，我对着闪烁的LED灯按了整整三小时遥控器，结果系统毫无反应。直到发现内核版本差异导致的驱动加载机制完全不同，才意识到网上80%的教程都是针对旧版内核的"过期攻略"。本文将用真实踩坑经历，帮你避开那些让开发者抓狂的LIRC配置陷阱。

1. 内核版本：新旧驱动架构的生死线

2019年Raspberry Pi OS内核升级到4.19时，红外驱动体系发生了根本性变革。旧版使用的lirc-rpi驱动在新内核中已被弃用，改用gpio-ir驱动模块。这个变化导致：

• 配置差异：

  # 旧内核(4.19前)配置 dtoverlay=lirc-rpi # 新内核(4.19+)配置 dtoverlay=gpio-ir,gpio_pin=17 dtoverlay=gpio-ir-tx,gpio_pin=18

• 典型症状：

  • 系统日志出现lirc_rpi: module not found错误
  • /dev/lirc*设备节点未生成
  • mode2命令返回No such file or directory

快速验证：执行uname -r查看内核版本，4.19及以上版本必须使用gpio-ir驱动

2. 设备节点迷宫：/dev/lirc0与/dev/lirc1的抉择

驱动加载成功后，开发者常被/dev下出现的多个设备节点搞懵。实际上：

关键配置点：

# /etc/lirc/lirc_options.conf 关键参数 driver = default device = /dev/lirc1 # 接收端通常选lirc1

曾有个项目因为误用lirc0导致按键信号时有时无，后来发现是解码环节被跳过导致的时序问题。

3. irrecord的隐藏陷阱：-f参数与配置文件生成

官方文档很少强调的一个事实：不加-f参数生成的配置文件90%会报错。这个参数控制着脉冲间隙(gap)的精确计算方式。

正确操作流程：

1. 获取原始模板：

   sudo irrecord -f -d /dev/lirc1 ~/remote.conf

2. 手动录入信号：

   mode2 -m -d /dev/lirc1 > raw_signal.txt

3. 提取关键段落：

   9100 4521 628 # 每个数值代表信号时间间隔(μs) 9820 4520 556 # 必须严格保持原始对齐格式

常见错误包括：

• 数值未右对齐
• 缺少begin/end语句块
• 混用空格和Tab缩进

4. lircd.conf格式强迫症：比Python缩进还严格

这个配置文件对格式的苛刻程度超乎想象，以下是血泪总结的黄金法则：

1. 数值对齐：

   name KEY_1 9100 4521 628 # 必须右对齐 9820 4520 556

2. 特殊字符处理：

   • 大于32767的数值会被视为特殊标记
   • 行末不允许有多余空格
   • 注释必须独占一行

3. 结构完整性：

   begin remote name mini_con flags RAW_CODES eps 30 aeps 100 gap 108106 begin raw_codes name KEY_1 9100 4521 628 end raw_codes end remote

调试技巧：使用sudo lircd -n -D 8可输出详细解析日志

5. 服务重启的暗坑：权限与缓存问题

即使配置完全正确，仍有30%的故障源于服务状态问题。必须掌握的完整重启流程：

# 完整服务重置流程 sudo systemctl stop lircd sudo rm /var/run/lirc/lircd.pid # 清除旧PID sudo systemctl start lircd sudo chmod 666 /dev/lirc* # 解决普通用户权限问题

典型故障现象：

• irw命令无输出但mode2正常
• 每次按键都出现重复信号
• 服务日志显示Permission denied

最后分享一个真实案例：某智能家居项目因为忘记给lircd服务添加GPIO组权限，导致凌晨三点还在debug。现在我的部署清单里永远多这一行：

sudo usermod -a -G gpio lirc