Skip to content

四道坎与一块像素 ​

链路全通了,实弹地打字,屏幕上什么字都没有。咱们原本以为只差临门一脚,结果这一脚踢过去,连着踢出了四道坎,偏偏一道咬着一道。咱们挨个说,每道坎都留了现场与证据,每案的收尾都干净。

头一道坎是编号的事。USB 的端点地址 0x81,高位记的是方向,低位记的是端点一号,咱们给它的编号按直觉写了二:零号是控制端点,到了一号加一,怎么算都顺理成章。偏偏错了。xHCI 里的编号叫 DCI,设备上下文的索引,它的算法是端点号乘二加方向位,双向的控制端点占一号,之后的每个方向各占一个号,所以端点一号的 IN 是三。这个号错了一个,四处跟着全错:门铃写的目标、Add 掩码里的位、槽位上下文里报的上下文个数、端点上下文落在输入上下文的哪一段,哪个都跑不了。怎么定位的:咱们把运行中机器的内存影像抓下来,对着控制器写进去的上下文逐字看,错座一目了然。这一案还顺手解开了另一桩悬案,咱们放在下半段说。

第二道坎是完成通告的事。普通传输的 TRB 上有一个中断完成位,咱们没置。不置它的话,控制器把数据搬完就算完了,事件环上一个字都不落了,咱们的排空排到天亮也排不出东西。协议本来就这么写,控制器的行为没脾气可挑:你要回执,就在单子上勾选回执的那一栏。第三道坎是事件里的长度。传输完成事件的低二十四位,咱们的第一版当成实际搬运的长度拿来就用,差点把键盘报告算成了零。它是残余量:咱们提交了八字节,事件里说的是还剩几字节没搬,实际搬了多少,要用提交的减残余的。字段的名字与直觉相反,协议字段的语义要查的是规范原文,字面是猜不得的。第四道坎是回调的重新武装。咱们的回调是一次性的,触发了就自解除,这是分层与回调那一章立的设计。可补环的那一笔是新提交,新提交要配一个新的回调,咱们补了环没补武装,第二份报告落地,空座偏偏不响。修法在分层与回调那一章说过了一半,这里补全:报告消费完了,才谈得上重新武装回调的活,回调重新武装好了,才补下一笔的环,三步一步踩着一步地走。

四道坎过完了,键盘链在咱们自己的实弹里终于全数通过。可这里要讲这一卷最不好意思的一件事,咱们把它原原本本记下。当时为了人眼看键盘打字,咱们手跑了一台带窗口的机器,屏幕上见到了目录清单,咱们高高兴兴记了一笔:打字实弹通过。后来复核的时候越看越不对:手跑的机器,启动盘被咱们错挂成了数据盘,那一次的内核压根没起来,屏幕上的那些行,是挂载失败之后内核的 panic 报文,咱们把日志行当成了敲字的回显。更早的一段时间里,送键的桥也有过一桩:按键事件根本没送到任何键盘设备上,PS/2 的队列与 USB 的挂起传输双空,咱们盯着一动不动的屏幕猜了半天路由。而头一道坎的错座,又给这两桩各添过一层迷雾:事件进了 USB,座子配错了,应的人没有,看上去就跟事件没进门的一模一样。

三层迷雾剥完了,咱们立了一条方法论:比修任何一道坎都值钱,实弹的验证里,串口的证据在前,屏幕的热闹在后。控制台的回显本来就一字不落地镜像到串口,收证据认的是串口,仗的是它自己会说话。像素判读是自找的弯路,咱们绕了它,后头的人不用再绕。方法论立住了,证据重打:完整 USB 参数的机器,普通与检查的两个镜像各来一遍,送键的桥连着输入,串口里清清楚楚地看到 ls 三个字符回显出来、内核答一句找不到这个命令、提示符完完整整回来,连着打了,引号分号长串的 echo 三轮,三轮全过了。一动一静的两个 hello 也照旧问好,那是跑别人的程序那一卷立下的开机问候回归件。到了这一步,键盘的字真真切切从 USB 线上流进了行规程,四道坎的卷宗合上,乌龙的检讨也写进了验收。下一章咱们收卷。

r35_gui_fin-8-gdda97be · dda97be · 2026-10-31