把EmuELEC 4.3装进电视盒子其实没花多少时间真正让我半夜爬起来继续折腾的是那支乐视手柄LeWGP-201——蓝牙能连上系统也能识别但只要一碰按键就全乱套最后查到evremap才算是找到了病根。这篇文章就把整个安装过程、手柄配对、按键错乱的原因以及evremap的解决办法原原本本写出来给同样被LeWGP-201折腾过的朋友一个参考。无论你是刚接触EmuELEC的新手还是已经在某个游戏整合包上折腾过一轮的老玩家这篇内容都能帮你少走不少弯路。1. 折腾前的准备EmuELEC 4.3刷机与手柄连不上的第一道坎1.1 为什么翻出4.3这个老版本前几年我在一台老电视盒子上装EmuELEC当时最新的版本已经是5.x但试来试去发现老芯片的兼容性反而不如4.3。EmuELEC 4.3虽然发布有一段时间了但它对S905、S912这类主流盒子芯片支持非常成熟内置的驱动和输入管理工具也足够稳定尤其适合那些不追求新内核、只想好好打游戏的老盒子。很多人喜欢直接下载现成的emuelec游戏整合包但整合包往往为了体积和控制体验默认外设配置都是针对Xbox类手柄写的换上乐视手柄就很容易出问题。我最后选择4.3还有一个原因是它的输入子系统改动比新版少evremap相关的配置文件在网络上能找到的历史案例也更多。如果你手上的盒子不是太冷门4.3版本反而比新版更省心。当然如果你是新款盒子那直接装新版本问题也不大但下面的手柄配置思路同样适用。1.2 刷机镜像与U盘准备刷机的过程不算复杂重点是别选错设备树文件。先把EmuELEC 4.3的镜像下载下来用balenaEtcher烧录到一个USB 3.0的U盘里。烧录完成后U盘会被分成几个分区其中emuelec分区里有device_trees目录里面放着一大堆dtb文件。这一步很关键你要根据自己盒子的芯片型号和板子类型找到对应的dtb文件改成meson64_amlogic这样的名字放到指定位置否则开机可能会卡在logo或者完全没有显示输出。我第一次刷的时候就是忘了这一步开机后屏幕一直黑着后来对比网上教程才发现是dtb没选对。所以这里提醒一句买盒子或者刷机之前先查清楚自己芯片的具体型号比如S905M、S905X、S912同一个芯片还有不同板卡dtb不能乱用。U盘烧录好之后插上网线给盒子上电EmuELEC会自动扩容分区并完成首次启动这个过程大概两三分钟耐心等就行。1.3 手柄第一次连上却马上断开系统跑起来之后我在EmulationStation界面按Start键调出主菜单进系统设置找到蓝牙把乐视手柄LeWGP-201调成配对模式。这支手柄的配对方式是按住手柄正面的乐视Logo键同时按住Start键不放直到指示灯开始快速闪烁。按照包装盒上的说明这时候应该能在蓝牙列表里看到LeWGP-201选中配对。但问题来了列表里能看到设备选完配对屏幕上也提示连接成功可手柄的指示灯刚稳定下来没过几秒又回到配对状态或者干脆变成了按任何键都没反应。我一开始以为是手柄电池问题换了一副电池依旧如此。后来才发现EmuELEC的蓝牙服务在默认配置下会把这类安卓电视手柄识别成键盘设备而LeWGP-201在配对时上报的HID描述符又不算标准这才导致连上又断开。这时候千万别急着退货真正要解决的是系统层面的输入设备识别问题核心就是evremap。2. 故障现场手柄已被识别但按键完全错乱2.1 症状复现按A键却触发B键几经折腾手柄总算能稳定连上不会再秒断了但更大的问题来了在EmulationStation主界面我想往下选择游戏按下方向键光标有时候不动有时候一次跳两行按下A键想确认结果画面退到上一层B键反而变成了确认键。进了游戏之后更离谱角色会自己往左走跳跃键和攻击键完全对不上号按X键触发的是Y键L1和L2也交叉错乱。这种症状和按键失灵还不一样每个键都有反应只是“反应到了错误的按键上”。这说明手柄和系统之间的连接是通的问题出在按键事件码的翻译上。如果你也遇到类似情况先别急着重新配对其他手柄这大概率是系统的输入映射把LeWGP-201的按键码理解错了。2.2 用evtest确认原始事件码为了确认问题我通过SSH连上EmuELEC输入evtest系统会列出所有输入设备节点。找到名字里带有LeWGP-201的那个设备输入对应编号后屏幕上会开始实时打印手柄事件。这时候按手柄上的按键就能看到每个键触发的事件码。比如我按下手柄上的A键evtest里显示的是BTN_B按下B键显示的却是BTN_A。X键和Y键也反了肩键L1对应的事件码是BTN_TRIGGER_HAPPY2和标准的BTN_TL完全不一样。拿到这组原始事件码之后整个问题就清晰了LeWGP-201上报的键值和EmuELEC默认理解的键值不匹配需要在系统层面把它们“翻译”回来这正是evremap能做的事情。2.3 根源LeWGP-201的非标按键映射LeWGP-201是乐视电视生态下的蓝牙手柄它在设计时主要面向安卓电视游戏事件码的排列顺序和通用PC手柄有很大差别。通用手柄通常按照Xbox按键布局上报A键、B键、X键、Y键依次对应固定的HID usage。而LeWGP-201为了兼容自家的安卓系统采用了另一套排列导致在EmuELEC里被当成了“一个按键布局古怪的通用手柄”。查一下手柄的/proc/bus/input/devices能看到它的Vendor ID和Product ID但这种硬件ID其实并不是问题根源真正的根源是Linux内核的input子系统默认不会为它生成一套专门的映射表于是应用层拿到的事件码就成了“错的”。知道这一点之后解决思路就很直接写一个evremap规则把LeWGP-201上报的事件码重新映射成EmuELEC应用层期望的事件码。3. evremap到底改了什么按键重映射原理与配置解读3.1 evremap解决的是哪一层的问题简单说evremap运行在内核输入子系统和应用程序之间它监听手柄设备/dev/input/eventX上报的原始按键事件根据配置文件中定义的规则把某个按键事件替换成另一个按键事件然后通过一个虚拟的输入设备再重新上报给上层系统。这样做的好处是EmulationStation和里面的游戏核心不需要做任何改动它们看到的仍然是一个“按键完全正确”的标准手柄。类比一下evremap就像是在手柄和模拟器之间站了一个翻译官。手柄说“我按了BTN_A”但这个翻译官知道系统上层需要的是BTN_B于是他把这句话改写成“BTN_B”再传进去。这样翻译完之后模拟器不再需要关心手柄本身长什么样只管按标准按键处理就行。3.2 LeWGP-201的按键错位根源在配置evremap之前我们最好把LeWGP-201的事件码和标准预期值做一张对照表这样配置起来一目了然。我根据evtest的实际输出整理过一份大概是这样手柄按键上报事件码预期事件码ABTN_BBTN_ABBTN_ABTN_BXBTN_YBTN_XYBTN_XBTN_YL1BTN_TRIGGER_HAPPY2BTN_TLR1BTN_TRIGGER_HAPPY1BTN_TRL2BTN_TRIGGER_HAPPY4BTN_TL2R2BTN_TRIGGER_HAPPY3BTN_TR2SelectBTN_SELECTBTN_SELECTStartBTN_STARTBTN_START这个表格没有列出摇杆和十字键因为十字键上报的通常是ABS_HAT0X/Y方向值本身没有错乱摇杆因为用的是绝对值坐标一般也不需要重映射。真正错乱的就是上面这些按键尤其是AB和XY的互换以及肩键被识别成了BTN_TRIGGER_HAPPYx。值得注意的是手柄的硬件版本、固件批次不同上报的事件码也可能有区别。所以不要照抄网上任何人的映射表一定要用evtest在自己设备上测一遍。3.3 一份针对LeWGP-201的配置模板EmuELEC 4.3内置了evremap配置文件路径在/storage/.config/evremap/evremap.yml。以我手头这个版本为例它的配置结构是YAML格式设备匹配需要指定Vendor和Product然后map列表负责按键映射。我给LeWGP-201写的配置如下devices: - name: LeWGP-201 vendor: 0x0e8f product: 0x0003 map: - from: BTN_A to: BTN_B - from: BTN_B to: BTN_A - from: BTN_X to: BTN_Y - from: BTN_Y to: BTN_X - from: BTN_TRIGGER_HAPPY1 to: BTN_TR - from: BTN_TRIGGER_HAPPY2 to: BTN_TL - from: BTN_TRIGGER_HAPPY3 to: BTN_TR2 - from: BTN_TRIGGER_HAPPY4 to: BTN_TL2需要说明的是Vendor和Product要以/proc/bus/input/devices里实际看到的值为准不同批次的LeWGP-201可能会不一样。from是手柄上报的原始事件码to是希望上层收到的事件码。配置里没有必要把所有按键都写一遍比如Select和Start本身是正确的就完全可以忽略。如果你拿到的evremap版本配置格式不是这样比如用的是evremap.conf且每一行是原事件码目标事件码的写法也不用慌核心思路不变把实际上报的错误码改成预期码即可。打开配置文件看一下注释和示例立刻就能理解。4. 配置落地的完整步骤与验证方法4.1 通过SSH进入EmuELEC要修改evremap配置最方便的方式是SSH登录盒子。在EmuELEC的系统设置里找到网络看到IP地址然后在电脑上打开终端ssh root192.168.1.100如果不知道SSH账号密码EmuELEC 4.3的默认账号是root默认密码是emuelec没改过的话直接输入就行。登录成功后先备份一下原配置文件这是一个好习惯后面万一改错还能快速还原cp /storage/.config/evremap/evremap.yml /storage/.config/evremap/evremap.yml.bak接着用nano打开配置文件nano /storage/.config/evremap/evremap.yml4.2 修改evremap配置文件把上一步准备好的映射规则粘进去注意YAML的缩进不要把from和to的层级弄错。保存退出之后重启evremap服务让配置生效systemctl restart evremap如果系统提示服务不存在可以试试直接重启EmuELEC或者查看一下服务名是不是evremap.service。在我这个4.3版本上服务名就是evremap用systemctl status evremap能看到状态为active (running)即可。4.3 重启服务并验证按键配置生效后再次运行evtest重新选择LeWGP-201对应的设备节点按一遍所有按键。这时候的输出应该已经变成了修正后的事件码比如按手柄的A键输出的是BTN_A按B键输出的是BTN_B。这说明evremap已经在中间做了翻译。接下来回到EmulationStation测试方向键和ABXY确认光标移动和确认、返回都正常。建议再进到一款街机模拟器或者FC模拟器里实际跑一下因为个别游戏核心会另外读取自己的按键映射如果游戏里还是错乱需要去核心的输入设置里重新绑一遍按键这是另一个层面的映射问题与evremap无关。如果你发现配置改了但按键完全没有变化优先检查三件事第一设备匹配是否生效Vendor/Product是不是填错了第二配置文件有没有语法错误可以用python3 -c import yaml; yaml.safe_load(open(/storage/.config/evremap/evremap.yml))来检查第三evremap服务有没有真正加载新配置改完配置后必须重启服务。5. 绕不开的坑热插拔、蓝牙断连与多手柄共存5.1 蓝牙断连重启后映射失效evremap配置好之后用的第一天很好第二天开机手柄能连上但按键又乱了。排查了一圈发现手柄休眠后重新连接设备名从LeWGP-201变成了LeWGP-201_1或者蓝牙重新配对后Vendor/Product没变但设备事件节点变成了event5。evremap默认会扫描所有设备如果它匹配的是设备名而不是VID/PID就可能在重连后匹配失败。解决方法是尽量在devices里用Vendor和Product来匹配而不是设备名。脚本里已经写了vendor和product实际使用中发现对多数蓝牙手柄都有效。如果发现重连后配置又不生效了可以先重新插拔一次手柄的蓝牙再systemctl restart evremap大部分时候能恢复。5.2 多手柄共存时确认event节点如果你像我一样除了乐视手柄还会插一个USB手柄备用那么/dev/input/eventX的编号会随着插拔顺序变化。有时候evremap把USB手柄当成LeWGP-201来映射导致USB手柄按键也乱了。要避免这种情况最好的办法是给evremap配置里加上更精确的设备路径匹配比如用/dev/input/by-id或者/dev/input/by-path下固定链接。EmuELEC 4.3的evremap配置文件支持指定evdev路径你可以先用ls -l /dev/input/by-id/找到LeWGP-201对应的固定路径然后把它写进配置。这样无论插拔顺序怎么变evremap都能锁定到这支蓝牙手柄上。当然如果只是日常自己玩不经常换手柄这一步可以跳过但知道了以后排查起来会轻松不少。5.3 整合包里的evremap配置不一定适用网上流传的“EmuELEC游戏整合包”里很多都自带了一套evremap配置默认映射通常是为Xbox手柄或者北通手柄准备的。你下载整合包后直接接乐视手柄按键乱其实是正常的因为配置文件的映射表和LeWGP-201的原始事件码完全对不上。遇到这种情况别急着把整个evremap配置删掉建议先备份整合包原配置然后再加入针对LeWGP-201的映射规则。整合包里的配置往往还包含其他设备的映射直接删除可能导致别的外设失灵。你只需要在其中追加设备的映射段优先级高于默认映射就可以。按照这套流程下来我手头这支LeWGP-201在EmuELEC 4.3上已经从“按键完全没法用”变成了“日常玩街机、FC、SFC都很顺手”。如果你是第一次调evremap建议耐心把evtest输出对照一遍再写映射别怕麻烦这一步值得做扎实。整合包虽然方便但外设兼容这种事终究还是得自己动手调一次才最可靠。
